@veams/status-quo 1.7.0 → 1.8.0

package/.turbo/turbo-test.log

@@ -1,15 +1,115 @@
-
-> @veams/status-quo@1.5.1 test
-> cross-env NODE_ENV=test jest --config jest.config.cjs
-
-PASS src/react/hooks/__tests__/state-selector.spec.tsx
-PASS src/react/hooks/__tests__/state-provider.spec.tsx
-PASS src/react/hooks/__tests__/state-singleton.spec.tsx
-PASS src/store/__tests__/observable-state-handler.spec.ts
-PASS src/store/__tests__/signal-state-handler.spec.ts
-
-Test Suites: 5 passed, 5 total
-Tests:       40 passed, 40 total
-Snapshots:   0 total
-Time:        1.703 s
-Ran all test suites.
+
+
+> @veams/status-quo@1.7.0 test
+> cross-env NODE_ENV=test jest --config jest.config.cjs
+
+Determining test suites to run...[?2026h
+
+Test Suites: 0 of 6 total
+Tests:       0 total
+Snapshots:   0 total
+Time:        0 s, estimated 2 s[?2026l[?2026h
+ RUNS  src/react/hooks/__tests__/state-singleton.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-selector.spec.tsx
+ RUNS  src/store/__tests__/native-state-handler.spec.ts
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+ RUNS  src/store/__tests__/observable-state-handler.spec.ts
+ RUNS  src/store/__tests__/signal-state-handler.spec.ts
+
+Test Suites: 0 of 6 total
+Tests:       0 total
+Snapshots:   0 total
+Time:        0 s, estimated 2 s[?2026l[?2026h
+
+ RUNS  src/react/hooks/__tests__/state-singleton.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-selector.spec.tsx
+ RUNS  src/store/__tests__/native-state-handler.spec.ts
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+ RUNS  src/store/__tests__/observable-state-handler.spec.ts
+ RUNS  src/store/__tests__/signal-state-handler.spec.ts
+
+Test Suites: 0 of 6 total
+Tests:       0 total
+Snapshots:   0 total
+Time:        0 s, estimated 2 s[?2026l[?2026h
+ RUNS  src/react/hooks/__tests__/state-singleton.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-selector.spec.tsx
+ RUNS  src/store/__tests__/native-state-handler.spec.ts
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+ RUNS  src/store/__tests__/observable-state-handler.spec.ts
+ RUNS  src/store/__tests__/signal-state-handler.spec.ts
+
+Test Suites: 0 of 6 total
+Tests:       0 total
+Snapshots:   0 total
+Time:        0 s, estimated 2 s[?2026l[?2026h
+
+ RUNS  src/react/hooks/__tests__/state-singleton.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-selector.spec.tsx
+ RUNS  src/store/__tests__/native-state-handler.spec.ts
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+ RUNS  src/store/__tests__/observable-state-handler.spec.ts
+ RUNS  src/store/__tests__/signal-state-handler.spec.ts
+
+Test Suites: 0 of 6 total
+Tests:       0 total
+Snapshots:   0 total
+Time:        0 s, estimated 2 s[?2026l[?2026h
+ RUNS  src/react/hooks/__tests__/state-singleton.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-selector.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+ RUNS  src/store/__tests__/observable-state-handler.spec.ts
+
+Test Suites: 2 passed, 2 of 6 total
+Tests:       19 passed, 19 total
+Snapshots:   0 total
+Time:        0 s, estimated 2 s[?2026l[?2026h
+
+ RUNS  src/react/hooks/__tests__/state-singleton.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-selector.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+ RUNS  src/store/__tests__/observable-state-handler.spec.ts
+
+Test Suites: 2 passed, 2 of 6 total
+Tests:       19 passed, 19 total
+Snapshots:   0 total
+Time:        0 s, estimated 2 s[?2026l[?2026h
+
+ RUNS  src/react/hooks/__tests__/state-singleton.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-selector.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+ RUNS  src/store/__tests__/observable-state-handler.spec.ts
+
+Test Suites: 2 passed, 2 of 6 total
+Tests:       19 passed, 19 total
+Snapshots:   0 total
+Time:        0 s, estimated 2 s[?2026l[?2026h
+
+ RUNS  src/react/hooks/__tests__/state-singleton.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-selector.spec.tsx
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+ RUNS  src/store/__tests__/observable-state-handler.spec.ts
+
+Test Suites: 2 passed, 2 of 6 total
+Tests:       19 passed, 19 total
+Snapshots:   0 total
+Time:        0 s, estimated 2 s[?2026l[?2026h
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+
+Test Suites: 5 passed, 5 of 6 total
+Tests:       49 passed, 49 total
+Snapshots:   0 total
+Time:        1 s, estimated 2 s[?2026l[?2026h
+
+ RUNS  src/react/hooks/__tests__/state-provider.spec.tsx
+
+Test Suites: 5 passed, 5 of 6 total
+Tests:       49 passed, 49 total
+Snapshots:   0 total
+Time:        1 s, estimated 2 s[?2026l[?2026h
+Test Suites: 6 passed, 6 total
+Tests:       50 passed, 50 total
+Snapshots:   0 total
+Time:        1.152 s, estimated 2 s
+Ran all test suites.
+[?2026h[?2026l⠙

package/CHANGELOG.md

@@ -7,11 +7,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ## [Unreleased]
 
 ### Added
+- `NativeStateHandler` for zero-dependency state management using plain JavaScript.
 - `StateProvider` for sharing one handler instance across a scoped React subtree.
 - `useProvidedStateHandler()`, `useProvidedStateActions()`, and `useProvidedStateSubscription()` for provider-scoped composition.
 - `setupStatusQuo({ devTools: { enabled } })` for global Redux DevTools defaults.
 
 ### Changed
+- The library is now **zero-dependency** when only `NativeStateHandler` is used (`rxjs` and `@preact/signals-core` are peer dependencies).
 - React-specific exports now live under `@veams/status-quo/react`.
 - `options.devTools.namespace` is now optional and falls back to the handler class name.
 - `ObservableStateHandler#getObservable(options?)` is now the canonical API for the full state stream.

package/README.md

@@ -28,7 +28,9 @@ This README summarizes the package API. The full routed documentation lives in V
 
 ## Overview
 
-StatusQuo is a small, framework-agnostic state layer that focuses on explicit lifecycle, clear action APIs, and a minimal subscription surface. It ships two handler implementations with the same public interface: RxJS-backed observables and signals-backed stores.
+StatusQuo is a small, framework-agnostic state layer that focuses on explicit lifecycle, clear action APIs, and a minimal subscription surface. It ships three handler implementations with the same public interface: **Native** (zero-dependency), **RxJS-backed** (observables), and **Signals-backed** (stores).
+
+When using the `NativeStateHandler`, the library is **completely zero-dependency**.
 
 ## Philosophy
 
@@ -47,13 +49,17 @@ Live docs:
 Install:
 
 ```bash
-npm install @veams/status-quo rxjs @preact/signals-core
+# Minimal installation (Native only)
+npm install @veams/status-quo
+
+# Optional engines
+npm install rxjs @preact/signals-core
 ```
 
 Create a store and use it in a component:
 
 ```ts
-import { ObservableStateHandler } from '@veams/status-quo';
+import { NativeStateHandler } from '@veams/status-quo';
 import { useStateFactory } from '@veams/status-quo/react';
 
 type CounterState = { count: number };
@@ -63,7 +69,7 @@ type CounterActions = {
   decrease: () => void;
 };
 
-class CounterStore extends ObservableStateHandler<CounterState, CounterActions> {
+class CounterStore extends NativeStateHandler<CounterState, CounterActions> {
   constructor() {
     super({ initialState: { count: 0 } });
   }
@@ -97,12 +103,13 @@ setupStatusQuo({
 
 ## Handlers
 
-StatusQuo provides two handler implementations with the same public interface:
+StatusQuo provides three handler implementations with the same public interface:
 
+- `NativeStateHandler` (**Zero dependency**, plain JS)
 - `ObservableStateHandler` (RxJS-backed)
 - `SignalStateHandler` (Signals-backed)
 
-Both are built on `BaseStateHandler`, which provides the shared lifecycle and devtools support.
+All are built on `BaseStateHandler`, which provides the shared lifecycle and devtools support.
 
 ## Hooks
 
@@ -489,7 +496,7 @@ const [name] = useStateSingleton(UserSingleton, (state) => state.user.name);
 
 ## Devtools
 
-Status Quo supports the Redux DevTools browser extension on both `ObservableStateHandler` and `SignalStateHandler`.
+Status Quo supports the Redux DevTools browser extension on `NativeStateHandler`, `ObservableStateHandler`, and `SignalStateHandler`.
 
 Turn it on globally:
 
@@ -587,6 +594,43 @@ Protected helpers:
   - If `selector` is omitted, identity selection is used.
   - `onChange` is only called when selected value changes according to `isEqual` (default `Object.is`).
 
+### `NativeStateHandler<S, A>`
+
+**Zero-dependency**, plain JS handler. Extends `BaseStateHandler`.
+
+Constructor:
+
+```ts
+protected constructor({
+  initialState,
+  options
+}: {
+  initialState: S;
+  options?: {
+    devTools?: { enabled?: boolean; namespace?: string };
+    distinct?: {
+      enabled?: boolean;
+      comparator?: (previous: S, next: S) => boolean;
+    };
+    useDistinctUntilChanged?: boolean;
+  };
+})
+```
+
+Public methods:
+
+- `subscribe(listener: () => void): () => void`
+- `subscribe(listener: (value: S) => void): () => void`
+
+Notes:
+- The handler uses plain JS and a `Set` for listener management.
+- Zero external dependencies.
+- Distinct behavior defaults to enabled.
+- Configure it globally via `setupStatusQuo` or per handler via `options.distinct`.
+- Devtools can be enabled globally via `setupStatusQuo({ devTools: { enabled: true } })` or overridden per handler via `options.devTools`.
+- `subscribe` fires immediately with the current snapshot and then on subsequent changes.
+- Subscribers receive the next state snapshot as a callback argument.
+
 ### `ObservableStateHandler<S, A>`
 
 RxJS-backed handler. Extends `BaseStateHandler`.

package/dist/config/status-quo-config.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Global configuration and utility functions for Status Quo state management.
+ */
 export type DistinctComparator<T = unknown> = (previous: T, next: T) => boolean;
 export type DistinctOptions<T = unknown> = {
     enabled?: boolean;
@@ -25,10 +28,28 @@ type ResolvedStatusQuoConfig = {
     devTools: ResolvedDevToolsOptions;
     distinct: ResolvedDistinctOptions;
 };
+/**
+ * Global setup function to configure Status Quo.
+ */
 export declare function setupStatusQuo<T = unknown>(config?: StatusQuoConfig<T>): void;
+/**
+ * Resolves the final distinct options for a specific state handler.
+ * Combines global configuration with handler-specific overrides.
+ */
 export declare function resolveDistinctOptions<T>(options?: DistinctOptions<T>, useDistinctUntilChanged?: boolean): ResolvedDistinctOptions<T>;
+/**
+ * Resolves the final DevTools options for a specific state handler.
+ * Combines global configuration with handler-specific overrides.
+ */
 export declare function resolveDevToolsOptions(options?: DevToolsOptions): ResolvedDevToolsOptions;
+/**
+ * Returns a copy of the current global configuration.
+ */
 export declare function getStatusQuoConfig(): ResolvedStatusQuoConfig;
-/** @internal testing helper */
+/**
+ * Resets the Status Quo configuration to its default values.
+ * Useful for ensuring test isolation in unit tests.
+ * @internal testing helper
+ */
 export declare function resetStatusQuoForTests(): void;
 export {};

package/dist/config/status-quo-config.js

@@ -1,49 +1,89 @@
+/**
+ * Global configuration and utility functions for Status Quo state management.
+ */
+/**
+ * Default comparator function that uses referential equality (Object.is)
+ * and falls back to JSON stringification for structural equality.
+ */
 function distinctAsJson(previous, next) {
+    // Fast path for referential equality.
     if (Object.is(previous, next)) {
         return true;
     }
+    // Structural comparison using JSON stringification as a fallback.
     try {
         return JSON.stringify(previous) === JSON.stringify(next);
     }
     catch {
+        // If stringification fails, assume they are not equal.
         return false;
     }
 }
+/**
+ * Creates the default Status Quo configuration.
+ */
 function createDefaultStatusQuoConfig() {
     return {
+        // DevTools integration is disabled by default.
         devTools: {
             enabled: false,
         },
+        // Distinct emission is enabled by default with JSON-based structural equality.
         distinct: {
             enabled: true,
             comparator: distinctAsJson,
         },
     };
 }
+// Global configuration instance, initialized with defaults.
 let statusQuoConfig = createDefaultStatusQuoConfig();
+/**
+ * Global setup function to configure Status Quo.
+ */
 export function setupStatusQuo(config = {}) {
+    // Merge the provided configuration with the current global config.
     statusQuoConfig = {
+        // Update global DevTools status.
         devTools: {
             enabled: config.devTools?.enabled ?? false,
         },
+        // Update global distinct emission status and comparator.
         distinct: {
             enabled: config.distinct?.enabled ?? true,
             comparator: (config.distinct?.comparator ?? distinctAsJson),
         },
     };
 }
-export function resolveDistinctOptions(options, useDistinctUntilChanged) {
+/**
+ * Resolves the final distinct options for a specific state handler.
+ * Combines global configuration with handler-specific overrides.
+ */
+export function resolveDistinctOptions(
+// Handler-specific distinct options.
+options, 
+// Boolean flag often used to override or determine enabled status.
+useDistinctUntilChanged) {
     return {
+        // Determine the enabled status for distinct emissions.
         enabled: options?.enabled ?? useDistinctUntilChanged ?? statusQuoConfig.distinct.enabled,
+        // Determine the comparator function to use.
         comparator: (options?.comparator ??
             statusQuoConfig.distinct.comparator),
     };
 }
+/**
+ * Resolves the final DevTools options for a specific state handler.
+ * Combines global configuration with handler-specific overrides.
+ */
 export function resolveDevToolsOptions(options) {
     return {
+        // Determine the enabled status for DevTools integration.
         enabled: options?.enabled ?? statusQuoConfig.devTools.enabled,
     };
 }
+/**
+ * Returns a copy of the current global configuration.
+ */
 export function getStatusQuoConfig() {
     return {
         devTools: {
@@ -55,7 +95,11 @@ export function getStatusQuoConfig() {
         },
     };
 }
-/** @internal testing helper */
+/**
+ * Resets the Status Quo configuration to its default values.
+ * Useful for ensuring test isolation in unit tests.
+ * @internal testing helper
+ */
 export function resetStatusQuoForTests() {
     statusQuoConfig = createDefaultStatusQuoConfig();
 }

package/dist/config/status-quo-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"status-quo-config.js","sourceRoot":"","sources":["../../src/config/status-quo-config.ts"],"names":[],"mappings":"AAmCA,SAAS,cAAc,CAAC,QAAiB,EAAE,IAAa;IACtD,IAAI,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B;IACnC,OAAO;QACL,QAAQ,EAAE;YACR,OAAO,EAAE,KAAK;SACf;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,cAAc;SAC3B;KACF,CAAC;AACJ,CAAC;AAED,IAAI,eAAe,GAAG,4BAA4B,EAAE,CAAC;AAErD,MAAM,UAAU,cAAc,CAAc,SAA6B,EAAE;IACzE,eAAe,GAAG;QAChB,QAAQ,EAAE;YACR,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,KAAK;SAC3C;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI;YACzC,UAAU,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,IAAI,cAAc,CAAuB;SAClF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAA4B,EAC5B,uBAAiC;IAEjC,OAAO;QACL,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,uBAAuB,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO;QACxF,UAAU,EAAE,CAAC,OAAO,EAAE,UAAU;YAC9B,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAyB;IAC9D,OAAO;QACL,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO;KAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAE;YACR,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,OAAO;SAC1C;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,OAAO;YACzC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC,UAAU;SAChD;KACyB,CAAC;AAC/B,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,sBAAsB;IACpC,eAAe,GAAG,4BAA4B,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"status-quo-config.js","sourceRoot":"","sources":["../../src/config/status-quo-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyDH;;;GAGG;AACH,SAAS,cAAc,CAAC,QAAiB,EAAE,IAAa;IACtD,sCAAsC;IACtC,IAAI,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,4BAA4B;IACnC,OAAO;QACL,+CAA+C;QAC/C,QAAQ,EAAE;YACR,OAAO,EAAE,KAAK;SACf;QACD,+EAA+E;QAC/E,QAAQ,EAAE;YACR,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,cAAc;SAC3B;KACF,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,IAAI,eAAe,GAAG,4BAA4B,EAAE,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAc,SAA6B,EAAE;IACzE,mEAAmE;IACnE,eAAe,GAAG;QAChB,iCAAiC;QACjC,QAAQ,EAAE;YACR,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,KAAK;SAC3C;QACD,yDAAyD;QACzD,QAAQ,EAAE;YACR,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI;YACzC,UAAU,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,IAAI,cAAc,CAAuB;SAClF;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;AACpC,qCAAqC;AACrC,OAA4B;AAC5B,mEAAmE;AACnE,uBAAiC;IAEjC,OAAO;QACL,uDAAuD;QACvD,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,uBAAuB,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO;QACxF,4CAA4C;QAC5C,UAAU,EAAE,CAAC,OAAO,EAAE,UAAU;YAC9B,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAyB;IAC9D,OAAO;QACL,yDAAyD;QACzD,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO;KAC9D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAE;YACR,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,OAAO;SAC1C;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,OAAO;YACzC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC,UAAU;SAChD;KACyB,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,eAAe,GAAG,4BAA4B,EAAE,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,17 @@
+/**
+ * Main entry point for the Status Quo state management library.
+ * Exports core functionality for both store and React integration.
+ */
 import { setupStatusQuo } from './config/status-quo-config.js';
-import { BaseStateHandler, makeStateSingleton, ObservableStateHandler, SignalStateHandler } from './store';
+import { BaseStateHandler, makeStateSingleton, NativeStateHandler, ObservableStateHandler, SignalStateHandler } from './store';
 import type { DevToolsOptions, GlobalDevToolsOptions, DistinctComparator, DistinctOptions, StatusQuoConfig } from './config/status-quo-config.js';
 import type { StateSingleton, StateSingletonOptions } from './store';
 import type { StateSubscriptionHandler } from './types/types.js';
-export { BaseStateHandler, makeStateSingleton, ObservableStateHandler, setupStatusQuo, SignalStateHandler, };
+/**
+ * Core state management functions and classes.
+ */
+export { BaseStateHandler, makeStateSingleton, NativeStateHandler, ObservableStateHandler, setupStatusQuo, SignalStateHandler, };
+/**
+ * Type definitions for public API.
+ */
 export type { DevToolsOptions, GlobalDevToolsOptions, DistinctComparator, DistinctOptions, StateSingleton, StateSingletonOptions, StateSubscriptionHandler, StatusQuoConfig, };

package/dist/index.js

@@ -1,4 +1,24 @@
+/**
+ * Main entry point for the Status Quo state management library.
+ * Exports core functionality for both store and React integration.
+ */
+// Import internal setup functions and core state handlers.
 import { setupStatusQuo } from './config/status-quo-config.js';
-import { BaseStateHandler, makeStateSingleton, ObservableStateHandler, SignalStateHandler, } from './store';
-export { BaseStateHandler, makeStateSingleton, ObservableStateHandler, setupStatusQuo, SignalStateHandler, };
+import { BaseStateHandler, makeStateSingleton, NativeStateHandler, ObservableStateHandler, SignalStateHandler, } from './store';
+/**
+ * Core state management functions and classes.
+ */
+export { 
+// Abstract base class for all state handlers.
+BaseStateHandler, 
+// Factory function for creating singleton state handlers.
+makeStateSingleton, 
+// Lightweight state handler using plain JavaScript.
+NativeStateHandler, 
+// State handler powered by RxJS BehaviorSubjects.
+ObservableStateHandler, 
+// Global configuration function for Status Quo.
+setupStatusQuo, 
+// State handler powered by Preact Signals.
+SignalStateHandler, };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAYjB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,kBAAkB,GACnB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2DAA2D;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAajB;;GAEG;AACH,OAAO;AACL,8CAA8C;AAC9C,gBAAgB;AAChB,0DAA0D;AAC1D,kBAAkB;AAClB,oDAAoD;AACpD,kBAAkB;AAClB,kDAAkD;AAClD,sBAAsB;AACtB,gDAAgD;AAChD,cAAc;AACd,2CAA2C;AAC3C,kBAAkB,GACnB,CAAC"}

package/dist/react/hooks/__tests__/state-provider.spec.js

@@ -1,6 +1,6 @@
 import React, { act } from 'react';
 import { createRoot } from 'react-dom/client';
-import { StateProvider, useProvidedStateActions, useProvidedStateHandler, useProvidedStateSubscription, } from '../state-provider.js';
+import { StateProvider, useProvidedStateActions, useProvidedStateHandler, useProvidedStateSubscription, } from '../index.js';
 class TestStateHandler {
     initialState;
     state;
@@ -172,7 +172,7 @@ describe('StateProvider', () => {
             act(() => {
                 root.render(React.createElement(MissingProviderConsumer, null));
             });
-        }).toThrow('No StateProvider instance found in the current React tree.');
+        }).toThrow('useProvidedStateHandler must be used within a StateProvider');
         consoleErrorSpy.mockRestore();
     });
 });

package/dist/react/hooks/__tests__/state-provider.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-provider.spec.js","sourceRoot":"","sources":["../../../../src/react/hooks/__tests__/state-provider.spec.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"state-provider.spec.js","sourceRoot":"","sources":["../../../../src/react/hooks/__tests__/state-provider.spec.tsx"],"names":[],"mappings":"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"}

package/dist/react/hooks/index.d.ts

@@ -1,6 +1,9 @@
-export { useStateActions } from './state-actions.js';
+/**
+ * Export available hooks for React components.
+ */
+export { useProvidedStateActions, useStateActions } from './state-actions.js';
 export { useStateFactory } from './state-factory.js';
 export { useStateHandler } from './state-handler.js';
-export { StateProvider, useProvidedStateActions, useProvidedStateHandler, useProvidedStateSubscription, } from './state-provider.js';
+export { StateProvider, useProvidedStateHandler } from './state-provider.js';
 export { useStateSingleton } from './state-singleton.js';
-export { useStateSubscription } from './state-subscription.js';
+export { useProvidedStateSubscription, useStateSubscription } from './state-subscription.js';

package/dist/react/hooks/index.js

@@ -1,7 +1,16 @@
-export { useStateActions } from './state-actions.js';
+/**
+ * Export available hooks for React components.
+ */
+// Export hook to access the actions of a state handler.
+export { useProvidedStateActions, useStateActions } from './state-actions.js';
+// Export hook to create and manage a state handler within a component.
 export { useStateFactory } from './state-factory.js';
+// Export hook to manage a state handler's lifecycle within a component's reference.
 export { useStateHandler } from './state-handler.js';
-export { StateProvider, useProvidedStateActions, useProvidedStateHandler, useProvidedStateSubscription, } from './state-provider.js';
+// Export hook and component to use a state handler through React Context.
+export { StateProvider, useProvidedStateHandler } from './state-provider.js';
+// Export hook to use a singleton state handler.
 export { useStateSingleton } from './state-singleton.js';
-export { useStateSubscription } from './state-subscription.js';
+// Export hook to subscribe to a state handler and receive its state updates.
+export { useProvidedStateSubscription, useStateSubscription } from './state-subscription.js';
 //# sourceMappingURL=index.js.map

package/dist/react/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wDAAwD;AACxD,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC9E,uEAAuE;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,oFAAoF;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,0EAA0E;AAC1E,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,gDAAgD;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,6EAA6E;AAC7E,OAAO,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/react/hooks/state-actions.d.ts

@@ -1,2 +1,10 @@
 import type { StateSubscriptionHandler } from '../../types/types.js';
-export declare function useStateActions<V, A>(stateSubscriptionHandler: StateSubscriptionHandler<V, A>): A;
+/**
+ * Returns the actions of a state handler instance.
+ * memoized based on the state handler instance itself.
+ */
+export declare function useStateActions<V, A>(stateHandler: StateSubscriptionHandler<V, A>): A;
+/**
+ * Returns the actions of the state handler provided by the nearest StateProvider.
+ */
+export declare function useProvidedStateActions<V, A>(): A;

package/dist/react/hooks/state-actions.js

@@ -1,5 +1,24 @@
+/**
+ * Utility hook for accessing actions from a state handler instance.
+ */
 import { useMemo } from 'react';
-export function useStateActions(stateSubscriptionHandler) {
-    return useMemo(() => stateSubscriptionHandler.getActions(), [stateSubscriptionHandler]);
+import { useProvidedStateHandler } from './state-provider.js';
+/**
+ * Returns the actions of a state handler instance.
+ * memoized based on the state handler instance itself.
+ */
+export function useStateActions(stateHandler) {
+    // Access and memoize the actions from the state handler.
+    // This ensures the action object remains referentially stable as long as the state handler is the same.
+    const actions = useMemo(() => stateHandler.getActions(), [stateHandler]);
+    // Return the set of actions.
+    return actions;
+}
+/**
+ * Returns the actions of the state handler provided by the nearest StateProvider.
+ */
+export function useProvidedStateActions() {
+    const stateHandler = useProvidedStateHandler();
+    return useStateActions(stateHandler);
 }
 //# sourceMappingURL=state-actions.js.map

package/dist/react/hooks/state-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-actions.js","sourceRoot":"","sources":["../../../src/react/hooks/state-actions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAIhC,MAAM,UAAU,eAAe,CAAO,wBAAwD;IAC5F,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,wBAAwB,CAAC,UAAU,EAAE,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC;AAC1F,CAAC"}
+{"version":3,"file":"state-actions.js","sourceRoot":"","sources":["../../../src/react/hooks/state-actions.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAGhC,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAO,YAA4C;IAChF,yDAAyD;IACzD,wGAAwG;IACxG,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEzE,6BAA6B;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,YAAY,GAAG,uBAAuB,EAAQ,CAAC;IACrD,OAAO,eAAe,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC"}

package/dist/react/hooks/state-factory.d.ts

@@ -1,6 +1,13 @@
 import type { StateSubscriptionHandler } from '../../types/types.js';
+/**
+ * Type signatures for selector and equality functions.
+ */
 type StateSelector<State, SelectedState> = (state: State) => SelectedState;
 type EqualityFn<SelectedState> = (current: SelectedState, next: SelectedState) => boolean;
+/**
+ * Factory hook to create and subscribe to a state handler.
+ * Manages the handler instance using useStateHandler and its subscription with useStateSubscription.
+ */
 export declare function useStateFactory<V, A, P extends unknown[]>(stateFactoryFunction: (...args: P) => StateSubscriptionHandler<V, A>, params?: P): [V, A];
 export declare function useStateFactory<V, A, P extends unknown[], Sel>(stateFactoryFunction: (...args: P) => StateSubscriptionHandler<V, A>, selector: StateSelector<V, Sel>, params?: P): [Sel, A];
 export declare function useStateFactory<V, A, P extends unknown[], Sel>(stateFactoryFunction: (...args: P) => StateSubscriptionHandler<V, A>, selector: StateSelector<V, Sel>, isEqual?: EqualityFn<Sel>, params?: P): [Sel, A];