🏠 Intro

🏠 Introduction to @fizzwiz/vanilla

@fizzwiz/vanilla is a lightweight library that provides semantic helpers for working with plain JSON objects.

A vanilla object is simple, serializable, and flexible. This library allows you to manage nested data structures and type-based options safely and consistently, without introducing complex classes or frameworks.

Core Concepts

OptionStore

  • Stores options keyed by class names.
  • Retrieves options for instances by walking up the prototype chain.
  • Ideal for defining default configurations or behaviors per type hierarchy.

ObjNavigator

  • Navigate, get, and set nested values in JSON-like objects using dot-separated paths or arrays.
  • Automatically create missing intermediate objects when needed.
  • Use scoped navigation with within() and return to parent objects with without().
  • Clean up or refine data with delete() and select().
  • Explore structures declaratively with search().

Philosophy

  • Simplicity: Work with plain objects without introducing complex classes.
  • Safety: Avoid runtime errors when navigating nested structures.
  • Flexibility: Easily integrate with existing JSON data or API payloads.

By providing these two core helpers, @fizzwiz/vanilla brings structure and semantic meaning to vanilla objects while keeping your data fully JSON-compatible.

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 p...
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