📚 TOC

📚 Table of Contents

Welcome! This page is your guide to the most relevant posts and documentation for the @fizzwiz/sorted library.
Whether you're just getting started or diving into advanced topics, this is your map.

🚀 Getting Started

  • Welcome
    What to expect, who it’s for, and how the posts are organized.

  • Quick Start
    How to install the library and write your first sorted collections.

  • Introduction
    A deeper look at the motivation, design philosophy, and goals of the library.

  • Contribute & Feedback
    Share your thoughts, report issues, or get involved in shaping the project.

📄 API Overview

🧬 The core Package

Foundational abstractions for collecting and sorting items.

  • 👨‍👩‍👧‍👦 The Collection Class
    Abstract definition of a general collection.

  • 🧍🧍‍♂️🧍‍♀️ The Queue Class
    Abstract interface for sorted collections.

🧑‍🤝‍🧑👫👭👬 The queue Package

Concrete queues for collecting, grouping, and ordering items.

🧠 Concepts & Patterns

🎯 Practical Examples

Coming soon — stay tuned!

📣 Releases & Updates

📌 This page will be updated regularly — bookmark it to stay oriented as the project grows!

Happy coding! 🙂
— @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