🏠 Intro

🏠 Introduction to @fizzwiz/sorted

This library introduces Sorted Collections and a powerful representation-based approach to equivalence among collected objects.

📌 A Familiar Problem

The importance of sorted collections is often underestimated. JavaScript, for example, doesn’t provide them out of the box.
Yet sorting objects is key — both in advanced problem solving and everyday computations.

🎯 The Search-and-Select Pattern

Sorting candidate solutions naturally leads to a unifying concept we call the Search-and-Select Pattern — a powerful strategy for solving a wide range of optimization problems.

In this pattern:

  • A search space is modeled by the What class.
  • A search is expressed as an iteration via the Each class.
    (Both Each and What come from the companion library @fizzwiz/fluent)
  • A priority queue manages the order of exploration.

We’ll explore this pattern more deeply in future articles — see, for instance:
👉 The Search-and-Select Pattern

🧠 A Library That Matches Your Thinking

While designed with powerful patterns in mind, Queues in this library are useful even outside of that context.
They offer a fluent, natural syntax for expressing complex logic with:

  • Well-defined queues
  • Custom equivalence among objects

📝 Documentation and More

  • 📘 Auto-generated API reference: GitHub Pages
  • 📚 Conceptual walkthroughs and real-world examples: Right here on this blog.

“Sorting is Solving.”
— @fizzwiz ✨


Comments

Post a Comment

Popular posts from this blog

🧠 Contemplating a True Set

🧠 Equivalence in JavaScript: Contemplating a True Set In JavaScript,   equivalence   behaves differently depending on whether you're working with primitive or non-primitive types. For   primitives —such as numbers, booleans, strings, and symbols—equivalence is determined by comparing actual values. If two variables hold the same value, they are considered equivalent. However, for   objects and arrays , equivalence is   by reference . Two arrays   [0]   and   [0]   are not considered equal because they are separate instances, even though they contain identical content. 🔬 Snippet 1: Equivalence by Value and by Reference new Set ([ 0 , 0 ]); // => Set { 0 } new Set ([[ 0 ], [ 0 ]]); // => Set { [0], [0] } JavaScript’s   Set   treats the two   0   values as equivalent but considers   [0]   and   [0]   as distinct because they are different object instances. This reveals JavaScript’s mini...
Read more

🧱 v0.0.0-dev.1 — First Brick

🧱 v0.0.0-dev.1 — First Brick We’re excited to announce the   first prerelease   of   @fizzwiz/sorted :   v0.0.0-dev.1   — the   First Brick   in what aims to become a foundational library for   priority-aware collections   and   custom equivalence models . This release introduces the core building blocks: 🔧 Core Abstractions Collection   – a base interface for iterable containers Queue   – an extension for prioritizing and structuring exploration 📦 Concrete Implementations ArrayQueue   – a simple queue based on insertion order SortedArray   – a comparator-based queue maintaining sorted state These implementations offer different   notions of equivalence   — by insertion order or by comparator — laying the groundwork for more powerful models based on   representation functions , coming soon. 🧪 This is a   prerelease , but it’s ready to explore. Your early feedback will help guide the evolution o...
Read more