@veams/status-quo 1.6.0 → 1.8.0

package/dist/store/base-state-handler.js

@@ -1,90 +1,153 @@
+/**
+ * Import internal configuration and utility functions.
+ */
 import { resolveDevToolsOptions } from '../config/status-quo-config.js';
 import { createSelectorCache, selectWithCache } from '../utils/selector-cache.js';
 import { withDevTools } from './dev-tools.js';
+/**
+ * Configuration for Redux DevTools features enabled in this handler.
+ */
 const devToolsFeatures = {
-    pause: true,
-    lock: true,
-    persist: false,
-    export: true,
-    import: 'custom',
-    jump: true,
-    skip: true,
-    reorder: true,
-    dispatch: false,
-    test: false,
+    pause: true, // Allow pausing the recording of actions.
+    lock: true, // Allow locking the state.
+    persist: false, // Do not persist state across reloads by default.
+    export: true, // Allow exporting the state/actions.
+    import: 'custom', // Use custom import logic.
+    jump: true, // Allow jumping to specific states.
+    skip: true, // Allow skipping specific actions.
+    reorder: true, // Allow reordering actions.
+    dispatch: false, // Do not allow dispatching actions from DevTools.
+    test: false, // Do not generate tests.
 };
+/**
+ * Abstract base class for all state handlers in the system.
+ * Implements core logic for initialization, DevTools integration, and subscriptions.
+ */
 export class BaseStateHandler {
+    // Stores the initial state passed during construction.
     initialState;
+    // Holds the Redux DevTools instance if enabled.
     devTools = null;
+    // Keeps track of active subscriptions to allow for cleanup.
     subscriptions = [];
+    /**
+     * Initializes the handler with the given initial state.
+     */
     constructor(initialState) {
         this.initialState = initialState;
     }
+    /**
+     * Sets up Redux DevTools integration based on the provided options.
+     */
     initDevTools(devToolsOptions) {
+        // Resolve the final DevTools configuration.
         const resolvedOptions = resolveDevToolsOptions(devToolsOptions);
+        // If DevTools is disabled, stop here.
         if (!resolvedOptions.enabled) {
             this.devTools = null;
             return;
         }
+        // Determine the namespace for the DevTools instance.
         const namespace = devToolsOptions?.namespace ?? this.getDevToolsNamespace();
+        // Connect to the Redux DevTools extension.
         this.devTools = withDevTools(this.initialState, {
             name: namespace,
             instanceId: namespace.toLowerCase().replaceAll(' ', '-'),
             actionCreators: this.getActions(),
             features: devToolsFeatures,
         });
+        // Subscribe to events coming from the DevTools extension (e.g., time travel).
         this.devTools?.subscribe(this.handleDevToolsEvents);
     }
+    /**
+     * Returns the initial state of the handler.
+     */
     getInitialState() {
         return this.initialState;
     }
+    /**
+     * Returns the current state.
+     */
     getState() {
         return this.getStateValue();
     }
+    /**
+     * Alias for getState, often used by React's useSyncExternalStore.
+     */
     getSnapshot() {
         return this.getState();
     }
+    /**
+     * Updates the state by merging the partial new state into the current one.
+     * Also sends the update to DevTools if enabled.
+     */
     setState(newState, actionName = 'change') {
+        // Merge current state with the new partial state.
         const nextState = { ...this.getState(), ...newState };
+        // Update the underlying state value (implemented by subclasses).
         this.setStateValue(nextState);
+        // Notify DevTools of the state change.
         this.devTools?.send(actionName, nextState);
     }
+    /**
+     * Cleans up all active subscriptions when the handler is destroyed.
+     */
     destroy() {
+        // Execute the unsubscribe function for each tracked subscription.
         this.subscriptions.forEach((subscription) => subscription.unsubscribe());
     }
+    /**
+     * Returns a default namespace for DevTools based on the class name.
+     */
     getDevToolsNamespace() {
         return this.constructor.name || 'Store';
     }
     bindSubscribable(service, onChange, selector, isEqual = Object.is) {
+        // Default to identity selector if none is provided.
         const selectorFn = (selector ?? ((value) => value));
+        // Create a cache for selector results to avoid unnecessary updates.
         const selectorCache = createSelectorCache();
+        // Flag to track if we received an initial value synchronously during subscription.
         let receivedSyncValue = false;
+        // Internal function to handle value changes from the external source.
         const notifySelectedValue = (value) => {
             receivedSyncValue = true;
+            // Extract the selected value and check if it has actually changed.
             const { value: nextSelection, hasChanged } = selectWithCache(selectorCache, value, selectorFn, isEqual);
+            // Only trigger the callback if the selected value changed.
             if (!hasChanged) {
                 return;
             }
             onChange(nextSelection);
         };
+        // Subscribe to the external source.
         const unsubscribe = service.subscribe(notifySelectedValue);
+        // Track the subscription for later cleanup.
         this.subscriptions = [...(this.subscriptions ?? []), { unsubscribe }];
+        // If the source has a getSnapshot method and we haven't received a value yet, pull it manually.
         if (service.getSnapshot && !receivedSyncValue)
             notifySelectedValue(service.getSnapshot());
     }
+    /**
+     * Handles messages dispatched from the Redux DevTools extension.
+     */
     handleDevToolsEvents = (message) => {
+        // We only care about DISPATCH type messages (e.g., reset, jump).
         if (message.type !== 'DISPATCH') {
             return;
         }
         switch (message.payload.type) {
+            // Revert state to the initial state.
             case 'RESET':
                 this.setStateValue(this.getInitialState());
                 this.devTools?.init(this.getInitialState());
                 break;
+            // Commit the current state in DevTools.
             case 'COMMIT':
                 this.setStateValue(this.getState());
                 this.devTools?.init(this.getState());
                 break;
+            // Handle time travel actions.
             case 'JUMP_TO_STATE':
             case 'JUMP_TO_ACTION':
                 this.setStateValue(JSON.parse(message.state));

package/dist/store/base-state-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-state-handler.js","sourceRoot":"","sources":["../../src/store/base-state-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-state-handler.js","sourceRoot":"","sources":["../../src/store/base-state-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoB9C;;GAEG;AACH,MAAM,gBAAgB,GAAG;IACvB,KAAK,EAAE,IAAI,EAAE,0CAA0C;IACvD,IAAI,EAAE,IAAI,EAAE,2BAA2B;IACvC,OAAO,EAAE,KAAK,EAAE,kDAAkD;IAClE,MAAM,EAAE,IAAI,EAAE,qCAAqC;IACnD,MAAM,EAAE,QAAQ,EAAE,2BAA2B;IAC7C,IAAI,EAAE,IAAI,EAAE,oCAAoC;IAChD,IAAI,EAAE,IAAI,EAAE,mCAAmC;IAC/C,OAAO,EAAE,IAAI,EAAE,4BAA4B;IAC3C,QAAQ,EAAE,KAAK,EAAE,kDAAkD;IACnE,IAAI,EAAE,KAAK,EAAE,yBAAyB;CAC9B,CAAC;AAEX;;;GAGG;AACH,MAAM,OAAgB,gBAAgB;IACpC,uDAAuD;IACpC,YAAY,CAAI;IACnC,gDAAgD;IACtC,QAAQ,GAAoB,IAAI,CAAC;IAE3C,4DAA4D;IAC5D,aAAa,GAAuC,EAAE,CAAC;IAEvD;;OAEG;IACH,YAAsB,YAAe;QACnC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;OAEG;IACO,YAAY,CAAC,eAAiC;QACtD,4CAA4C;QAC5C,MAAM,eAAe,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;QAEhE,sCAAsC;QACtC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO;QACT,CAAC;QAED,qDAAqD;QACrD,MAAM,SAAS,GAAG,eAAe,EAAE,SAAS,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5E,2CAA2C;QAC3C,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE;YAC9C,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;YACxD,cAAc,EAAE,IAAI,CAAC,UAAU,EAAE;YACjC,QAAQ,EAAE,gBAAgB;SAC3B,CAAC,CAAC;QAEH,8EAA8E;QAC9E,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,QAAoB,EAAE,UAAU,GAAG,QAAQ;QAClD,kDAAkD;QAClD,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtD,iEAAiE;QACjE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9B,uCAAuC;QACvC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,kEAAkE;QAClE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3E,CAAC;IAMD;;OAEG;IACO,oBAAoB;QAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,OAAO,CAAC;IAC1C,CAAC;IAaS,gBAAgB,CACxB,OAAwB,EACxB,QAA8B,EAC9B,QAA2B,EAC3B,UAA2B,MAAM,CAAC,EAAE;QAEpC,oDAAoD;QACpD,MAAM,UAAU,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAQ,EAAE,EAAE,CAAC,KAAuB,CAAC,CAAC,CAAC;QACzE,oEAAoE;QACpE,MAAM,aAAa,GAAG,mBAAmB,EAAO,CAAC;QACjD,mFAAmF;QACnF,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAE9B,sEAAsE;QACtE,MAAM,mBAAmB,GAAG,CAAC,KAAQ,EAAE,EAAE;YACvC,iBAAiB,GAAG,IAAI,CAAC;YACzB,mEAAmE;YACnE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,eAAe,CAC1D,aAAa,EACb,KAAK,EACL,UAAU,EACV,OAAO,CACR,CAAC;YAEF,2DAA2D;YAC3D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,aAAa,CAAC,CAAC;QAC1B,CAAC,CAAC;QAEF,oCAAoC;QACpC,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC3D,4CAA4C;QAC5C,IAAI,CAAC,aAAa,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QAEtE,gGAAgG;QAChG,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,iBAAiB;YAAE,mBAAmB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5F,CAAC;IAOD;;OAEG;IACK,oBAAoB,GAAG,CAAC,OAAuB,EAAE,EAAE;QACzD,iEAAiE;QACjE,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,QAAQ,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC7B,qCAAqC;YACrC,KAAK,OAAO;gBACV,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;gBAC3C,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;gBAC5C,MAAM;YAER,wCAAwC;YACxC,KAAK,QAAQ;gBACX,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACpC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACrC,MAAM;YAER,8BAA8B;YAC9B,KAAK,eAAe,CAAC;YACrB,KAAK,gBAAgB;gBACnB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAM,CAAC,CAAC;gBACnD,MAAM;YAER;gBACE,MAAM;QACV,CAAC;IACH,CAAC,CAAC;CACH"}

package/dist/store/dev-tools.d.ts

@@ -1,23 +1,48 @@
-declare global {
-    interface Window {
-        __REDUX_DEVTOOLS_EXTENSION__?: {
-            connect: (opts: Record<string, unknown>) => DevTools;
-        };
-    }
-}
-export type MessagePayload = {
+/**
+ * Redux DevTools extension types and constants.
+ */
+/**
+ * Interface for messages dispatched from the Redux DevTools extension.
+ */
+export interface MessagePayload {
     type: string;
     payload: {
         type: string;
-        actionId: number;
+        stateIndex?: number;
+        id?: string;
     };
     state: string;
-    id: string;
-    source: '@devtools-extension';
-};
-export type DevTools = {
-    init: (state: unknown) => void;
+}
+/**
+ * Interface for the Redux DevTools instance returned by the extension.
+ */
+export interface DevTools {
     send: (action: string, state: unknown) => void;
-    subscribe: (cb: (message: MessagePayload) => void) => void;
-};
-export declare function withDevTools<S>(initialState: S, options?: {}): DevTools | null;
+    subscribe: (listener: (message: MessagePayload) => void) => () => void;
+    init: (state: unknown) => void;
+}
+/**
+ * Interface for Redux DevTools connection options.
+ */
+export interface DevToolsConnectionOptions {
+    name?: string;
+    instanceId?: string;
+    actionCreators?: unknown;
+    features?: {
+        pause?: boolean;
+        lock?: boolean;
+        persist?: boolean;
+        export?: boolean | 'custom';
+        import?: boolean | 'custom';
+        jump?: boolean;
+        skip?: boolean;
+        reorder?: boolean;
+        dispatch?: boolean;
+        test?: boolean;
+    };
+}
+/**
+ * Connects the state handler to the Redux DevTools browser extension.
+ * Returns a DevTools object to communicate with the extension.
+ */
+export declare function withDevTools(initialState: unknown, options: DevToolsConnectionOptions): DevTools | null;

package/dist/store/dev-tools.js

@@ -1,13 +1,29 @@
-export function withDevTools(initialState, options = {}) {
-    if (typeof window === 'undefined') {
+/**
+ * Redux DevTools extension types and constants.
+ */
+/**
+ * Connects the state handler to the Redux DevTools browser extension.
+ * Returns a DevTools object to communicate with the extension.
+ */
+export function withDevTools(initialState, options) {
+    // Check if the Redux DevTools extension is available in the browser.
+    const extension = globalThis?.__REDUX_DEVTOOLS_EXTENSION__;
+    // If the extension is not found, we cannot connect.
+    if (!extension) {
         return null;
     }
-    if (!window.__REDUX_DEVTOOLS_EXTENSION__) {
-        console.error('Status Quo :: Devtools Extension is not installed!');
-        return null;
-    }
-    const devTools = window.__REDUX_DEVTOOLS_EXTENSION__.connect(options);
+    // Connect to the extension and get an instance.
+    const devTools = extension.connect(options);
+    // Initialize the DevTools instance with the initial state.
     devTools.init(initialState);
-    return devTools;
+    // Return an interface to interact with the extension.
+    return {
+        // Send a new action and state to the DevTools.
+        send: (action, state) => devTools.send(action, state),
+        // Subscribe to events coming from the DevTools.
+        subscribe: (listener) => devTools.subscribe(listener),
+        // Re-initialize the state in the extension.
+        init: (state) => devTools.init(state),
+    };
 }
 //# sourceMappingURL=dev-tools.js.map

package/dist/store/dev-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-tools.js","sourceRoot":"","sources":["../../src/store/dev-tools.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,YAAY,CAAI,YAAe,EAAE,OAAO,GAAG,EAAE;IAC3D,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,IAAI,CAAC,MAAM,CAAC,4BAA4B,EAAE,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,MAAM,QAAQ,GAAG,MAAM,CAAC,4BAA4B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAG5B,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"dev-tools.js","sourceRoot":"","sources":["../../src/store/dev-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0DH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,YAAqB,EAAE,OAAkC;IACpF,qEAAqE;IACrE,MAAM,SAAS,GAAI,UAAkB,EAAE,4BAA4B,CAAC;IAEpE,oDAAoD;IACpD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAE5B,sDAAsD;IACtD,OAAO;QACL,+CAA+C;QAC/C,IAAI,EAAE,CAAC,MAAc,EAAE,KAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;QACtE,gDAAgD;QAChD,SAAS,EAAE,CAAC,QAA2C,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC;QACxF,4CAA4C;QAC5C,IAAI,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/store/index.d.ts

@@ -1,5 +1,12 @@
+/**
+ * Export core state handler classes and factory functions.
+ */
 export { BaseStateHandler } from './base-state-handler.js';
+export { NativeStateHandler } from './native-state-handler.js';
 export { ObservableStateHandler } from './observable-state-handler.js';
 export { SignalStateHandler } from './signal-state-handler.js';
+/**
+ * Export singleton related types and factory function.
+ */
 export type { StateSingleton, StateSingletonOptions } from './state-singleton.js';
 export { makeStateSingleton } from './state-singleton.js';

package/dist/store/index.js

@@ -1,5 +1,14 @@
+/**
+ * Export core state handler classes and factory functions.
+ */
+// Export the abstract base class for all state handlers.
 export { BaseStateHandler } from './base-state-handler.js';
+// Export the lightweight state handler using plain JavaScript.
+export { NativeStateHandler } from './native-state-handler.js';
+// Export the state handler powered by RxJS BehaviorSubjects.
 export { ObservableStateHandler } from './observable-state-handler.js';
+// Export the state handler powered by Preact Signals.
 export { SignalStateHandler } from './signal-state-handler.js';
+// Export the factory function to create singleton state handler instances.
 export { makeStateSingleton } from './state-singleton.js';
 //# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yDAAyD;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,+DAA+D;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,6DAA6D;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,sDAAsD;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,2EAA2E;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/store/native-state-handler.d.ts

@@ -0,0 +1,44 @@
+import { BaseStateHandler } from './base-state-handler.js';
+/**
+ * Import necessary types for DevTools and distinct update options.
+ */
+import type { DevToolsOptions, DistinctOptions } from '../config/status-quo-config.js';
+/**
+ * Props for configuring the NativeStateHandler instance.
+ */
+type NativeStateHandlerProps<S> = {
+    initialState: S;
+    options?: {
+        devTools?: DevToolsOptions;
+        distinct?: DistinctOptions<S>;
+        useDistinctUntilChanged?: boolean;
+    };
+};
+/**
+ * NativeStateHandler: A lightweight state handler using plain JavaScript.
+ * Ideal for minimizing dependencies when neither RxJS nor Signals are required.
+ */
+export declare abstract class NativeStateHandler<S, A> extends BaseStateHandler<S, A> {
+    private state;
+    private readonly listeners;
+    private readonly distinctOptions;
+    /**
+     * Initializes the native state handler with given state and configuration.
+     */
+    protected constructor({ initialState, options }: NativeStateHandlerProps<S>);
+    /**
+     * Internal implementation of getting the state value.
+     */
+    protected getStateValue(): S;
+    /**
+     * Internal implementation of updating the state value.
+     */
+    protected setStateValue(nextState: S): void;
+    /**
+     * Subscribes a listener function to state changes.
+     * Overloaded to handle both void and state-receiving listeners.
+     */
+    subscribe(listener: () => void): () => void;
+    subscribe(listener: (value: S) => void): () => void;
+}
+export {};

package/dist/store/native-state-handler.js

@@ -0,0 +1,62 @@
+/**
+ * Import internal configuration and the abstract base state handler.
+ */
+import { resolveDistinctOptions } from '../config/status-quo-config.js';
+import { BaseStateHandler } from './base-state-handler.js';
+/**
+ * NativeStateHandler: A lightweight state handler using plain JavaScript.
+ * Ideal for minimizing dependencies when neither RxJS nor Signals are required.
+ */
+export class NativeStateHandler extends BaseStateHandler {
+    // The actual state value stored in memory.
+    state;
+    // A collection of active listeners to notify when the state changes.
+    listeners = new Set();
+    // Configuration to determine if and how state changes should trigger notifications.
+    distinctOptions;
+    /**
+     * Initializes the native state handler with given state and configuration.
+     */
+    constructor({ initialState, options }) {
+        // Pass the initial state to the base handler.
+        super(initialState);
+        // Set the initial internal state.
+        this.state = initialState;
+        // Resolve the final distinct options based on provided configuration.
+        this.distinctOptions = resolveDistinctOptions(options?.distinct, options?.useDistinctUntilChanged);
+        // Initialize Redux DevTools integration.
+        this.initDevTools(options?.devTools);
+    }
+    /**
+     * Internal implementation of getting the state value.
+     */
+    getStateValue() {
+        return this.state;
+    }
+    /**
+     * Internal implementation of updating the state value.
+     */
+    setStateValue(nextState) {
+        // Store the previous state to compare against the new state.
+        const previousState = this.state;
+        // Update the internal state storage.
+        this.state = nextState;
+        // If distinct mode is enabled and the state hasn't effectively changed, stop here.
+        if (this.distinctOptions.enabled && this.distinctOptions.comparator(previousState, nextState)) {
+            return;
+        }
+        // Notify all active listeners of the state update.
+        this.listeners.forEach((listener) => listener(nextState));
+    }
+    subscribe(listener) {
+        // Register the listener to the active set.
+        this.listeners.add(listener);
+        // Call the listener immediately with the current state to ensure initial consistency.
+        listener(this.state);
+        // Return an unsubscribe function to remove the listener from the set.
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+}
+//# sourceMappingURL=native-state-handler.js.map

package/dist/store/native-state-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-state-handler.js","sourceRoot":"","sources":["../../src/store/native-state-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAqB3D;;;GAGG;AACH,MAAM,OAAgB,kBAAyB,SAAQ,gBAAsB;IAC3E,2CAA2C;IACnC,KAAK,CAAI;IACjB,qEAAqE;IACpD,SAAS,GAA4B,IAAI,GAAG,EAAE,CAAC;IAChE,oFAAoF;IACnE,eAAe,CAA+C;IAE/E;;OAEG;IACH,YAAsB,EAAE,YAAY,EAAE,OAAO,EAA8B;QACzE,8CAA8C;QAC9C,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,kCAAkC;QAClC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1B,sEAAsE;QACtE,IAAI,CAAC,eAAe,GAAG,sBAAsB,CAC3C,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,uBAAuB,CACjC,CAAC;QACF,yCAAyC;QACzC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACO,aAAa;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,SAAY;QAClC,6DAA6D;QAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC;QACjC,qCAAqC;QACrC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QAEvB,mFAAmF;QACnF,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,IAAI,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,CAAC;YAC9F,OAAO;QACT,CAAC;QAED,mDAAmD;QACnD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5D,CAAC;IAQD,SAAS,CAAC,QAA4B;QACpC,2CAA2C;QAC3C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7B,sFAAsF;QACtF,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAErB,sEAAsE;QACtE,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;CACF"}

package/dist/store/observable-state-handler.d.ts

@@ -1,6 +1,12 @@
 import { BaseStateHandler } from './base-state-handler.js';
+/**
+ * Import necessary types for DevTools, distinct update options, and RxJS Observable.
+ */
 import type { DevToolsOptions, DistinctOptions } from '../config/status-quo-config.js';
 import type { Observable } from 'rxjs';
+/**
+ * Props for configuring the ObservableStateHandler instance.
+ */
 type ObservableStateHandlerProps<S> = {
     initialState: S;
     options?: {
@@ -9,17 +15,45 @@ type ObservableStateHandlerProps<S> = {
         useDistinctUntilChanged?: boolean;
     };
 };
+/**
+ * Options for configuring state-related observables.
+ */
 type StateObservableOptions = {
     useDistinctUntilChanged?: boolean;
 };
+/**
+ * ObservableStateHandler: A state handler built on top of RxJS BehaviorSubject.
+ * Provides powerful reactive patterns and integration with RxJS pipelines.
+ */
 export declare abstract class ObservableStateHandler<S, A> extends BaseStateHandler<S, A> {
     private readonly state$;
     private readonly distinctOptions;
+    /**
+     * Initializes the observable state handler with given state and configuration.
+     */
     protected constructor({ initialState, options }: ObservableStateHandlerProps<S>);
+    /**
+     * Internal implementation of getting the state value via BehaviorSubject.
+     */
     protected getStateValue(): S;
+    /**
+     * Internal implementation of updating the state value via BehaviorSubject.
+     */
     protected setStateValue(nextState: S): void;
+    /**
+     * Returns an observable tracking a specific key within the state object.
+     * Only emits when the value of the specified key actually changes.
+     */
     getObservableItem<K extends keyof S>(key: K): Observable<S[K]>;
+    /**
+     * Returns an observable tracking the entire state object.
+     * Can be configured to emit only when the state object effectively changes.
+     */
     getObservable(options?: StateObservableOptions): Observable<S>;
+    /**
+     * Subscribes a listener function to state changes via the internal observable.
+     * Overloaded to handle both void and state-receiving listeners.
+     */
     subscribe(listener: () => void): () => void;
     subscribe(listener: (value: S) => void): () => void;
 }

package/dist/store/observable-state-handler.js

@@ -1,37 +1,81 @@
+/**
+ * Import RxJS components for reactive state handling.
+ */
 import { BehaviorSubject, distinctUntilChanged, distinctUntilKeyChanged, map } from 'rxjs';
+/**
+ * Import internal configuration and the abstract base state handler.
+ */
 import { resolveDistinctOptions } from '../config/status-quo-config.js';
 import { BaseStateHandler } from './base-state-handler.js';
+/**
+ * ObservableStateHandler: A state handler built on top of RxJS BehaviorSubject.
+ * Provides powerful reactive patterns and integration with RxJS pipelines.
+ */
 export class ObservableStateHandler extends BaseStateHandler {
+    // Internal BehaviorSubject to manage the state and provide current values to new subscribers.
     state$;
+    // Configuration to determine if and how state changes should trigger notifications.
     distinctOptions;
+    /**
+     * Initializes the observable state handler with given state and configuration.
+     */
     constructor({ initialState, options }) {
+        // Pass the initial state to the base handler.
         super(initialState);
+        // Initialize the internal BehaviorSubject with the initial state.
         this.state$ = new BehaviorSubject(initialState);
+        // Resolve the final distinct options based on provided configuration.
         this.distinctOptions = resolveDistinctOptions(options?.distinct, options?.useDistinctUntilChanged);
+        // Initialize Redux DevTools integration.
         this.initDevTools(options?.devTools);
     }
+    /**
+     * Internal implementation of getting the state value via BehaviorSubject.
+     */
     getStateValue() {
         return this.state$.getValue();
     }
+    /**
+     * Internal implementation of updating the state value via BehaviorSubject.
+     */
     setStateValue(nextState) {
+        // Notify the subject and all its subscribers of the new state.
         this.state$.next(nextState);
     }
+    /**
+     * Returns an observable tracking a specific key within the state object.
+     * Only emits when the value of the specified key actually changes.
+     */
     getObservableItem(key) {
-        return this.state$.pipe(distinctUntilKeyChanged(key), map((state) => state[key]));
+        return this.state$.pipe(
+        // Ensure we only emit if the value associated with the key has changed.
+        distinctUntilKeyChanged(key), 
+        // Transform the state object into the specific key value.
+        map((state) => state[key]));
     }
+    /**
+     * Returns an observable tracking the entire state object.
+     * Can be configured to emit only when the state object effectively changes.
+     */
     getObservable(options = {}) {
+        // Determine whether distinct emissions are enabled.
         const useDistinctUntilChanged = options.useDistinctUntilChanged ?? this.distinctOptions.enabled;
+        // If distinct emissions are not enabled, return the subject as-is.
         if (!useDistinctUntilChanged) {
             return this.state$;
         }
+        // Apply the distinctUntilChanged operator to filter out redundant updates.
         return this.state$.pipe(distinctUntilChanged((previous, next) => {
+            // Use the resolved comparator to compare the previous and next states.
             return this.distinctOptions.comparator(previous, next);
         }));
     }
     subscribe(listener) {
+        // Subscribe to the state observable and call the listener on each emission.
         const subscription = this.getObservable().subscribe((nextState) => {
             listener(nextState);
         });
+        // Return an unsubscribe function to properly clean up the RxJS subscription.
         return () => subscription.unsubscribe();
     }
 }

package/dist/store/observable-state-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"observable-state-handler.js","sourceRoot":"","sources":["../../src/store/observable-state-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgB3D,MAAM,OAAgB,sBAA6B,SAAQ,gBAAsB;IAC9D,MAAM,CAAqB;IAC3B,eAAe,CAA+C;IAE/E,YAAsB,EAAE,YAAY,EAAE,OAAO,EAAkC;QAC7E,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAI,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,eAAe,GAAG,sBAAsB,CAC3C,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,uBAAuB,CACjC,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAES,aAAa;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAES,aAAa,CAAC,SAAY;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,iBAAiB,CAAoB,GAAM;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,uBAAuB,CAAC,GAAG,CAAC,EAC5B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAC3B,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,UAAkC,EAAE;QAChD,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;QAEhG,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,oBAAoB,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;YACtC,OAAO,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAID,SAAS,CAAC,QAA4B;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YAChE,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"observable-state-handler.js","sourceRoot":"","sources":["../../src/store/observable-state-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE3F;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA2B3D;;;GAGG;AACH,MAAM,OAAgB,sBAA6B,SAAQ,gBAAsB;IAC/E,8FAA8F;IAC7E,MAAM,CAAqB;IAC5C,oFAAoF;IACnE,eAAe,CAA+C;IAE/E;;OAEG;IACH,YAAsB,EAAE,YAAY,EAAE,OAAO,EAAkC;QAC7E,8CAA8C;QAC9C,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,kEAAkE;QAClE,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAI,YAAY,CAAC,CAAC;QACnD,sEAAsE;QACtE,IAAI,CAAC,eAAe,GAAG,sBAAsB,CAC3C,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,uBAAuB,CACjC,CAAC;QACF,yCAAyC;QACzC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACO,aAAa;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,SAAY;QAClC,+DAA+D;QAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAoB,GAAM;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI;QACrB,wEAAwE;QACxE,uBAAuB,CAAC,GAAG,CAAC;QAC5B,0DAA0D;QAC1D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAC3B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,UAAkC,EAAE;QAChD,oDAAoD;QACpD,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;QAEhG,mEAAmE;QACnE,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,2EAA2E;QAC3E,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,oBAAoB,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;YACtC,uEAAuE;YACvE,OAAO,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAQD,SAAS,CAAC,QAA4B;QACpC,4EAA4E;QAC5E,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YAChE,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,6EAA6E;QAC7E,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dist/store/signal-state-handler.d.ts

@@ -1,6 +1,12 @@
 import { BaseStateHandler } from './base-state-handler.js';
+/**
+ * Import necessary types for DevTools, distinct update options, and Preact Signals.
+ */
 import type { DevToolsOptions, DistinctOptions } from '../config/status-quo-config.js';
 import type { Signal } from '@preact/signals-core';
+/**
+ * Props for configuring the SignalStateHandler instance.
+ */
 type SignalStateHandlerProps<S> = {
     initialState: S;
     options?: {
@@ -9,14 +15,34 @@ type SignalStateHandlerProps<S> = {
         useDistinctUntilChanged?: boolean;
     };
 };
+/**
+ * SignalStateHandler: A state handler built on top of Preact Signals.
+ * Provides fine-grained reactivity and efficient state updates.
+ */
 export declare abstract class SignalStateHandler<S, A> extends BaseStateHandler<S, A> {
     private readonly state;
     private readonly distinctOptions;
+    /**
+     * Initializes the signal state handler with given state and configuration.
+     */
     protected constructor({ initialState, options }: SignalStateHandlerProps<S>);
+    /**
+     * Returns the underlying signal for external use (e.g., in reactive templates).
+     */
     getSignal(): Signal<S>;
+    /**
+     * Subscribes a listener function to state changes via the internal signal.
+     * Overloaded to handle both void and state-receiving listeners.
+     */
     subscribe(listener: () => void): () => void;
     subscribe(listener: (value: S) => void): () => void;
+    /**
+     * Internal implementation of getting the state value via the Signal's value property.
+     */
     protected getStateValue(): S;
+    /**
+     * Internal implementation of updating the state value via the Signal's value property.
+     */
     protected setStateValue(nextState: S): void;
 }
 export {};