📚 TOC

📚 Table of Contents

Welcome to your comprehensive guide for the 🍦 @fizzwiz/vanilla library! Whether you're just starting out or exploring advanced abstractions, this guide will help you navigate the documentation and resources with ease.

🚀 Getting Started

  • Welcome Overview, audience, and organizational principles behind the library.

  • Quick Start How to install and write your first meaningful code with @fizzwiz/vanilla.

  • Introduction The motivation, philosophy, and design goals shaping the library’s architecture.

  • Contribute & Feedback Ways to report issues, suggest improvements, or contribute to the project.

📄 API Overview

🧬 Core API: Semantics for Plain Objects

  • OptionStore Class Store and retrieve options by type, supporting prototype chain lookup.

  • ObjNavigator Class Navigate and manipulate nested JSON objects safely and intuitively.

🧠 Concepts & Patterns

🎯 Practical Examples

Coming soon — real-world usage to help you master the library.

📣 Releases & Updates

  • 📦 v0.0.0-dev.5 — Major Advancement
    Introducing contextual navigation, fine-grained coercion and validation, and flexible error handling with opts for safer and more expressive object management.

📌 This page will be updated regularly — bookmark it to stay current with project developments.

 

Comments

Post a Comment

Popular posts from this blog

🌐 Plain JavaScript Objects — the True Language of Distributed Systems

🌐 Plain JavaScript Objects — the True Language of Distributed Systems When designing distributed or asynchronous systems — systems that exchange data between independent nodes, peers, or services — we discover one powerful truth: The most universal data structure in JavaScript is the plain object. Whether you call it a   map ,   record , or   JSON structure , the plain object ( {} ) is the simplest, most portable form of state. It is naturally serializable, easy to merge, and readable across all programming environments. And yet, many developers instinctively reach for   classes and types   when defining system state — especially configuration or metadata. But in asynchronous workflows, this introduces unnecessary coupling and complexity. Let’s unpack why   plain, vanilla objects   are more valuable than class-based structures in distributed environments — and how a lightweight library like   @fizzwiz/vanilla   makes this philosophy practica...
Read more

🧱 v0.0.0-dev.1 — First Brick

🧱 v0.0.0-dev.1 — First Brick We’re thrilled to announce the   first prerelease   of   @fizzwiz/vanilla :   v0.0.0-dev.1   — the   First Brick   laying the foundation for a library dedicated to   providing lightweight semantics for working with plain JSON objects . This release unveils the core abstractions:   OptionStore   and   ObjNavigator . OptionStore:   Store and retrieve options by type, with automatic lookup along an instance’s prototype chain. ObjNavigator:   Navigate and manipulate nested objects safely and intuitively, supporting scoped navigation with   within()   and returning to the parent with   without() . 🧪 This is a   prerelease , intended for exploration and feedback. Your early experiences and suggestions will help shape the API and future features. "Let’s build clear, maintainable JSON semantics — together." —   @fizzwiz ✨
Read more

🍦 v0.0.0-dev.2 — Sweet Refinements

🍦 v0.0.0-dev.2 — Sweet Refinements We’re excited to release   v0.0.0-dev.2   of   @fizzwiz/vanilla , continuing to polish the foundation laid by the   First Brick   (v0.0.0-dev.1). This update focuses on   cleaning up inconsistencies and making the API smoother : Documentation & typos:   Fixed minor inconsistencies between the code and the docs, ensuring clarity and correctness. New alias:   The method   within()   now also responds to the shorter, more intuitive alias   with() , making scoped navigation even cleaner. 🧪 As with previous prereleases, this version is meant for exploration and feedback. Your suggestions help shape the library’s future features and usability. Next steps:   Experiment with the library, and let us know how it feels! 👉   🍦 —   @fizzwiz   ✨
Read more