@veams/status-quo 1.2.0 → 1.3.1

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.3.0] - 2026-02-25
+
+### Added
+- `setupStatusQuo(config)` runtime setup for global distinct update behavior.
+
+### Changed
+- Handler distinct comparison now supports global defaults (`setupStatusQuo`) with per-handler override precedence.
+
 ## [1.2.0] - 2026-02-25
 
 ### Added
@@ -70,5 +78,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
   - From: `super({ initialState, devTools: { ... } })`
   - To: `super({ initialState, options: { devTools: { ... } } })`
 
+[1.3.0]: https://github.com/Veams/status-quo/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/Veams/status-quo/compare/v1.0.0...v1.2.0
 [1.0.0]: https://github.com/Veams/status-quo/releases/tag/v1.0.0

package/README.md

@@ -77,6 +77,19 @@ class CounterStore extends ObservableStateHandler<CounterState, CounterActions>
 const [state, actions] = useStateFactory(() => new CounterStore(), []);
 ```
 
+Optional global setup (e.g. with a custom deep-equality comparator):
+
+```ts
+import equal from 'fast-deep-equal';
+import { setupStatusQuo } from '@veams/status-quo';
+
+setupStatusQuo({
+  distinct: {
+    comparator: equal,
+  },
+});
+```
+
 ## Handlers
 
 StatusQuo provides two handler implementations with the same public interface:
@@ -192,6 +205,31 @@ class AppSignalStore extends SignalStateHandler<AppState, AppActions> {
 
 This section documents the primary public API with behavior notes and usage examples.
 
+### `setupStatusQuo(config?)`
+
+Sets global runtime defaults for distinct update behavior.
+Per-handler options still override the global setup.
+
+```ts
+type StatusQuoConfig = {
+  distinct?: {
+    enabled?: boolean; // default: true
+    comparator?: (previous: unknown, next: unknown) => boolean; // default: JSON compare
+  };
+};
+```
+
+```ts
+import equal from 'fast-deep-equal';
+import { setupStatusQuo } from '@veams/status-quo';
+
+setupStatusQuo({
+  distinct: {
+    comparator: equal,
+  },
+});
+```
+
 ### `useStateHandler(factory, params?)`
 
 Creates one handler instance per component mount and returns it.
@@ -397,6 +435,11 @@ protected constructor({
   initialState: S;
   options?: {
     devTools?: { enabled?: boolean; namespace: string };
+    distinct?: {
+      enabled?: boolean;
+      comparator?: (previous: S, next: S) => boolean;
+    };
+    useDistinctUntilChanged?: boolean; // optional override
   };
 })
 ```
@@ -409,7 +452,8 @@ Public methods:
 - `subscribe(listener: () => void): () => void`
 
 Notes:
-- The observable stream uses `distinctUntilChanged` by default (JSON compare).
+- The observable stream uses `distinctUntilChanged` by default.
+- Distinct behavior can be configured globally via `setupStatusQuo` or per handler via `options.distinct`.
 - `subscribe` does not fire for the initial value; it only fires on subsequent changes.
 
 ### `SignalStateHandler<S, A>`
@@ -426,6 +470,10 @@ protected constructor({
   initialState: S;
   options?: {
     devTools?: { enabled?: boolean; namespace: string };
+    distinct?: {
+      enabled?: boolean;
+      comparator?: (previous: S, next: S) => boolean;
+    };
     useDistinctUntilChanged?: boolean;
   };
 })
@@ -437,7 +485,22 @@ Public methods:
 - `subscribe(listener: () => void): () => void`
 
 Notes:
-- `useDistinctUntilChanged` defaults to `true` (JSON compare).
+- Distinct behavior defaults to enabled.
+- Configure it globally via `setupStatusQuo` or per handler via `options.distinct`.
+- `useDistinctUntilChanged` remains available as a shorthand enable/disable override.
+
+### `setupStatusQuo`
+
+```ts
+type StatusQuoConfig = {
+  distinct?: {
+    enabled?: boolean;
+    comparator?: (previous: unknown, next: unknown) => boolean;
+  };
+};
+
+function setupStatusQuo(config?: StatusQuoConfig): void
+```
 
 ### `makeStateSingleton`
 

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

@@ -0,0 +1,21 @@
+export type DistinctComparator<T = unknown> = (previous: T, next: T) => boolean;
+export type DistinctOptions<T = unknown> = {
+    enabled?: boolean;
+    comparator?: DistinctComparator<T>;
+};
+export type StatusQuoConfig<T = unknown> = {
+    distinct?: DistinctOptions<T>;
+};
+type ResolvedDistinctOptions<T = unknown> = {
+    enabled: boolean;
+    comparator: DistinctComparator<T>;
+};
+type ResolvedStatusQuoConfig = {
+    distinct: ResolvedDistinctOptions;
+};
+export declare function setupStatusQuo<T = unknown>(config?: StatusQuoConfig<T>): void;
+export declare function resolveDistinctOptions<T>(options?: DistinctOptions<T>, useDistinctUntilChanged?: boolean): ResolvedDistinctOptions<T>;
+export declare function getStatusQuoConfig(): ResolvedStatusQuoConfig;
+/** @internal testing helper */
+export declare function resetStatusQuoForTests(): void;
+export {};

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

@@ -0,0 +1,48 @@
+function distinctAsJson(previous, next) {
+    if (Object.is(previous, next)) {
+        return true;
+    }
+    try {
+        return JSON.stringify(previous) === JSON.stringify(next);
+    }
+    catch {
+        return false;
+    }
+}
+function createDefaultStatusQuoConfig() {
+    return {
+        distinct: {
+            enabled: true,
+            comparator: distinctAsJson,
+        },
+    };
+}
+let statusQuoConfig = createDefaultStatusQuoConfig();
+export function setupStatusQuo(config = {}) {
+    statusQuoConfig = {
+        distinct: {
+            enabled: config.distinct?.enabled ?? true,
+            comparator: (config.distinct?.comparator ?? distinctAsJson),
+        },
+    };
+}
+export function resolveDistinctOptions(options, useDistinctUntilChanged) {
+    return {
+        enabled: options?.enabled ?? useDistinctUntilChanged ?? statusQuoConfig.distinct.enabled,
+        comparator: (options?.comparator ??
+            statusQuoConfig.distinct.comparator),
+    };
+}
+export function getStatusQuoConfig() {
+    return {
+        distinct: {
+            enabled: statusQuoConfig.distinct.enabled,
+            comparator: statusQuoConfig.distinct.comparator,
+        },
+    };
+}
+/** @internal testing helper */
+export function resetStatusQuoForTests() {
+    statusQuoConfig = createDefaultStatusQuoConfig();
+}
+//# sourceMappingURL=status-quo-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status-quo-config.js","sourceRoot":"","sources":["../../src/config/status-quo-config.ts"],"names":[],"mappings":"AAoBA,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,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,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,CAA0B;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,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"}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-import { useStateActions, useStateFactory, useStateHandler, useStateSingleton, useStateSubscription } from './hooks/index.js';
-import { BaseStateHandler, makeStateSingleton, ObservableStateHandler, SignalStateHandler } from './store/index.js';
-import type { StateSingleton, StateSingletonOptions } from './store/index.js';
+import { useStateActions, useStateFactory, useStateHandler, useStateSingleton, useStateSubscription } from './hooks';
+import { BaseStateHandler, makeStateSingleton, ObservableStateHandler, SignalStateHandler } from './store';
+import { setupStatusQuo } from './config/status-quo-config.js';
+import type { 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, SignalStateHandler, useStateActions, useStateFactory, useStateHandler, useStateSingleton, useStateSubscription, };
-export type { StateSingleton, StateSingletonOptions, StateSubscriptionHandler };
+export { BaseStateHandler, makeStateSingleton, ObservableStateHandler, SignalStateHandler, setupStatusQuo, useStateActions, useStateFactory, useStateHandler, useStateSingleton, useStateSubscription, };
+export type { DistinctComparator, DistinctOptions, StateSingleton, StateSingletonOptions, StateSubscriptionHandler, StatusQuoConfig, };

package/dist/index.js

@@ -1,4 +1,5 @@
-import { useStateActions, useStateFactory, useStateHandler, useStateSingleton, useStateSubscription, } from './hooks/index.js';
-import { BaseStateHandler, makeStateSingleton, ObservableStateHandler, SignalStateHandler, } from './store/index.js';
-export { BaseStateHandler, makeStateSingleton, ObservableStateHandler, SignalStateHandler, useStateActions, useStateFactory, useStateHandler, useStateSingleton, useStateSubscription, };
+import { useStateActions, useStateFactory, useStateHandler, useStateSingleton, useStateSubscription, } from './hooks';
+import { BaseStateHandler, makeStateSingleton, ObservableStateHandler, SignalStateHandler, } from './store';
+import { setupStatusQuo } from './config/status-quo-config.js';
+export { BaseStateHandler, makeStateSingleton, ObservableStateHandler, SignalStateHandler, setupStatusQuo, useStateActions, useStateFactory, useStateHandler, useStateSingleton, useStateSubscription, };
 //# 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,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAM/D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,CAAC"}

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

@@ -1,20 +1,27 @@
 import { lastValueFrom, Subject, take } from 'rxjs';
+import { resetStatusQuoForTests, setupStatusQuo } from '../../config/status-quo-config.js';
 import { ObservableStateHandler } from '../observable-state-handler.js';
 class TestObservableStateHandler extends ObservableStateHandler {
-    constructor(withDevTools) {
+    constructor({ withDevTools, distinct, useDistinctUntilChanged } = {}) {
         super({
             initialState: {
                 test: 'testValue',
                 test2: 'testValue2',
             },
-            ...(withDevTools && {
-                options: {
+            options: {
+                ...(withDevTools && {
                     devTools: {
                         enabled: true,
                         namespace: 'TestObservableStateHandler',
                     },
-                },
-            }),
+                }),
+                ...(distinct && {
+                    distinct,
+                }),
+                ...(typeof useDistinctUntilChanged === 'boolean' && {
+                    useDistinctUntilChanged,
+                }),
+            },
         });
     }
     getActions() {
@@ -28,8 +35,12 @@ class TestObservableStateHandler extends ObservableStateHandler {
 describe('Observable State Handler', () => {
     let stateHandler;
     beforeEach(() => {
+        resetStatusQuoForTests();
         stateHandler = new TestObservableStateHandler();
     });
+    afterEach(() => {
+        resetStatusQuoForTests();
+    });
     it('should provide initial state', () => {
         expect(stateHandler.getInitialState()).toStrictEqual({
             test: 'testValue',
@@ -85,5 +96,53 @@ describe('Observable State Handler', () => {
         unsubscribe();
         expect(spy).toHaveBeenCalledTimes(2); // 1. test (first setter), 2. test2 (second setter)
     });
+    it('should respect global distinct setup when disabled', () => {
+        setupStatusQuo({
+            distinct: {
+                enabled: false,
+            },
+        });
+        const handler = new TestObservableStateHandler();
+        const spy = jest.fn();
+        const unsubscribe = handler.subscribe(spy);
+        handler.setState({ test: 'same' });
+        handler.setState({ test: 'same' });
+        unsubscribe();
+        expect(spy).toHaveBeenCalledTimes(2);
+    });
+    it('should respect global custom distinct comparator from setupStatusQuo', () => {
+        setupStatusQuo({
+            distinct: {
+                comparator: (previous, next) => {
+                    return previous.test === next.test;
+                },
+            },
+        });
+        const handler = new TestObservableStateHandler();
+        const spy = jest.fn();
+        const unsubscribe = handler.subscribe(spy);
+        handler.setState({ test2: 'newValue2' });
+        handler.setState({ test: 'newValue' });
+        unsubscribe();
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should prefer per-handler distinct options over global setup', () => {
+        setupStatusQuo({
+            distinct: {
+                enabled: false,
+            },
+        });
+        const handler = new TestObservableStateHandler({
+            distinct: {
+                enabled: true,
+            },
+        });
+        const spy = jest.fn();
+        const unsubscribe = handler.subscribe(spy);
+        handler.setState({ test: 'same' });
+        handler.setState({ test: 'same' });
+        unsubscribe();
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
 });
 //# sourceMappingURL=observable-state-handler.spec.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"observable-state-handler.spec.js","sourceRoot":"","sources":["../../../src/store/__tests__/observable-state-handler.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,MAAM,0BAA2B,SAAQ,sBAGxC;IACC,YAAY,YAAsB;QAChC,KAAK,CAAC;YACJ,YAAY,EAAE;gBACZ,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,YAAY;aACpB;YACD,GAAG,CAAC,YAAY,IAAI;gBAClB,OAAO,EAAE;oBACP,QAAQ,EAAE;wBACR,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,4BAA4B;qBACxC;iBACF;aACF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,OAAO;YACL,UAAU,EAAE,GAAG,EAAE;gBACf,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YACtC,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAI,YAAwC,CAAC;IAE7C,UAAU,CAAC,GAAG,EAAE;QACd,YAAY,GAAG,IAAI,0BAA0B,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC;YACnD,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,aAAa,CAAC;YAC5C,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;QAC9F,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,YAAY;SACpB,CAAC;QAEF,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEhC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,oBAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAErF,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,aAAa,GAAG,IAAI,OAAO,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,YAAY,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAElD,YAAY,CAAC,aAAa,GAAG,CAAC,YAAY,CAAC,CAAC;QAE5C,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,YAAY,CAAC,OAAO,EAAE,CAAC;QAEvB,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,eAAe,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9F,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAEtB,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAChD,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QAEH,WAAW,EAAE,CAAC;QAEd,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,mDAAmD;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"observable-state-handler.spec.js","sourceRoot":"","sources":["../../../src/store/__tests__/observable-state-handler.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEpD,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAWxE,MAAM,0BAA2B,SAAQ,sBAA8C;IACrF,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,uBAAuB,KAAmC,EAAE;QAChG,KAAK,CAAC;YACJ,YAAY,EAAE;gBACZ,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,YAAY;aACpB;YACD,OAAO,EAAE;gBACP,GAAG,CAAC,YAAY,IAAI;oBAClB,QAAQ,EAAE;wBACR,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,4BAA4B;qBACxC;iBACF,CAAC;gBACF,GAAG,CAAC,QAAQ,IAAI;oBACd,QAAQ;iBACT,CAAC;gBACF,GAAG,CAAC,OAAO,uBAAuB,KAAK,SAAS,IAAI;oBAClD,uBAAuB;iBACxB,CAAC;aACH;SACF,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,OAAO;YACL,UAAU,EAAE,GAAG,EAAE;gBACf,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YACtC,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAI,YAAwC,CAAC;IAE7C,UAAU,CAAC,GAAG,EAAE;QACd,sBAAsB,EAAE,CAAC;QACzB,YAAY,GAAG,IAAI,0BAA0B,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,sBAAsB,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC;YACnD,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,aAAa,CAAC;YAC5C,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;QAC9F,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,YAAY;SACpB,CAAC;QAEF,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEhC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,oBAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAErF,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,aAAa,GAAG,IAAI,OAAO,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,YAAY,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAElD,YAAY,CAAC,aAAa,GAAG,CAAC,YAAY,CAAC,CAAC;QAE5C,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,YAAY,CAAC,OAAO,EAAE,CAAC;QAEvB,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,eAAe,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9F,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAEtB,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAChD,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QAEH,WAAW,EAAE,CAAC;QAEd,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,mDAAmD;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,cAAc,CAAC;YACb,QAAQ,EAAE;gBACR,OAAO,EAAE,KAAK;aACf;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,0BAA0B,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAE3C,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnC,WAAW,EAAE,CAAC;QAEd,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,cAAc,CAAC;YACb,QAAQ,EAAE;gBACR,UAAU,EAAE,CAAC,QAAmB,EAAE,IAAe,EAAE,EAAE;oBACnD,OAAO,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC;gBACrC,CAAC;aACF;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,0BAA0B,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAE3C,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAEvC,WAAW,EAAE,CAAC;QAEd,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,cAAc,CAAC;YACb,QAAQ,EAAE;gBACR,OAAO,EAAE,KAAK;aACf;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,0BAA0B,CAAC;YAC7C,QAAQ,EAAE;gBACR,OAAO,EAAE,IAAI;aACd;SACF,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAE3C,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnC,WAAW,EAAE,CAAC;QAEd,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/store/__tests__/signal-state-handler.spec.js

@@ -1,19 +1,27 @@
+import { resetStatusQuoForTests, setupStatusQuo } from '../../config/status-quo-config.js';
 import { SignalStateHandler } from '../signal-state-handler.js';
+import { makeStateSingleton } from '../state-singleton.js';
 class TestSignalStateHandler extends SignalStateHandler {
-    constructor(withDevTools) {
+    constructor({ withDevTools, distinct, useDistinctUntilChanged } = {}) {
         super({
             initialState: {
                 test: 'testValue',
                 test2: 'testValue2',
             },
-            ...(withDevTools && {
-                options: {
+            options: {
+                ...(withDevTools && {
                     devTools: {
                         enabled: true,
                         namespace: 'TestSignalStateHandler',
                     },
-                },
-            }),
+                }),
+                ...(distinct && {
+                    distinct,
+                }),
+                ...(typeof useDistinctUntilChanged === 'boolean' && {
+                    useDistinctUntilChanged,
+                }),
+            },
         });
     }
     getActions() {
@@ -24,11 +32,53 @@ class TestSignalStateHandler extends SignalStateHandler {
         };
     }
 }
+class CounterSignalStateHandler extends SignalStateHandler {
+    constructor(initialCount = 0) {
+        super({
+            initialState: {
+                count: initialCount,
+            },
+        });
+    }
+    getActions() {
+        return {
+            increase: () => {
+                this.setState({ count: this.getState().count + 1 }, 'increase');
+            },
+        };
+    }
+}
+class CounterSignalBridgeStateHandler extends SignalStateHandler {
+    constructor(counterSingleton, onCounterSync) {
+        super({
+            initialState: {
+                count: 0,
+            },
+        });
+        const counterStateHandler = counterSingleton.getInstance();
+        this.bindSubscribable({
+            subscribe: (listener) => counterStateHandler.subscribe(() => listener(counterStateHandler.getSnapshot())),
+            getSnapshot: () => counterStateHandler.getSnapshot(),
+        }, (nextCounterState) => {
+            onCounterSync(nextCounterState);
+            this.setState({ count: nextCounterState.count }, 'sync-counter');
+        });
+    }
+    getActions() {
+        return {
+            noop: () => undefined,
+        };
+    }
+}
 describe('Signal State Handler', () => {
     let stateHandler;
     beforeEach(() => {
+        resetStatusQuoForTests();
         stateHandler = new TestSignalStateHandler();
     });
+    afterEach(() => {
+        resetStatusQuoForTests();
+    });
     it('should provide initial state', () => {
         expect(stateHandler.getInitialState()).toStrictEqual({
             test: 'testValue',
@@ -74,5 +124,69 @@ describe('Signal State Handler', () => {
         unsubscribe();
         expect(spy).toHaveBeenCalledTimes(2);
     });
+    it('should respect global distinct setup when disabled', () => {
+        setupStatusQuo({
+            distinct: {
+                enabled: false,
+            },
+        });
+        const handler = new TestSignalStateHandler();
+        const spy = jest.fn();
+        const unsubscribe = handler.subscribe(spy);
+        handler.setState({ test: 'same' });
+        handler.setState({ test: 'same' });
+        unsubscribe();
+        expect(spy).toHaveBeenCalledTimes(2);
+    });
+    it('should respect global custom distinct comparator from setupStatusQuo', () => {
+        setupStatusQuo({
+            distinct: {
+                comparator: (previous, next) => {
+                    return previous.test === next.test;
+                },
+            },
+        });
+        const handler = new TestSignalStateHandler();
+        const spy = jest.fn();
+        const unsubscribe = handler.subscribe(spy);
+        handler.setState({ test2: 'newValue2' });
+        handler.setState({ test: 'newValue' });
+        unsubscribe();
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should prefer per-handler distinct options over global setup', () => {
+        setupStatusQuo({
+            distinct: {
+                enabled: false,
+            },
+        });
+        const handler = new TestSignalStateHandler({
+            distinct: {
+                enabled: true,
+            },
+        });
+        const spy = jest.fn();
+        const unsubscribe = handler.subscribe(spy);
+        handler.setState({ test: 'same' });
+        handler.setState({ test: 'same' });
+        unsubscribe();
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should notify another signal state handler for each singleton counter update', () => {
+        const counterSingleton = makeStateSingleton(() => new CounterSignalStateHandler(0), {
+            destroyOnNoConsumers: false,
+        });
+        const syncSpy = jest.fn();
+        const bridgeStateHandler = new CounterSignalBridgeStateHandler(counterSingleton, syncSpy);
+        const counterStateHandler = counterSingleton.getInstance();
+        counterStateHandler.getActions().increase();
+        counterStateHandler.getActions().increase();
+        expect(syncSpy).toHaveBeenCalledTimes(3);
+        expect(syncSpy).toHaveBeenNthCalledWith(1, { count: 0 });
+        expect(syncSpy).toHaveBeenNthCalledWith(2, { count: 1 });
+        expect(syncSpy).toHaveBeenNthCalledWith(3, { count: 2 });
+        expect(bridgeStateHandler.getState()).toStrictEqual({ count: 2 });
+        bridgeStateHandler.destroy();
+    });
 });
 //# sourceMappingURL=signal-state-handler.spec.js.map

package/dist/store/__tests__/signal-state-handler.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"signal-state-handler.spec.js","sourceRoot":"","sources":["../../../src/store/__tests__/signal-state-handler.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,sBAAuB,SAAQ,kBAGpC;IACC,YAAY,YAAsB;QAChC,KAAK,CAAC;YACJ,YAAY,EAAE;gBACZ,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,YAAY;aACpB;YACD,GAAG,CAAC,YAAY,IAAI;gBAClB,OAAO,EAAE;oBACP,QAAQ,EAAE;wBACR,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,wBAAwB;qBACpC;iBACF;aACF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,OAAO;YACL,UAAU,EAAE,GAAG,EAAE;gBACf,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YACtC,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,IAAI,YAAoC,CAAC;IAEzC,UAAU,CAAC,GAAG,EAAE;QACd,YAAY,GAAG,IAAI,sBAAsB,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC;YACnD,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,aAAa,CAAC;YAC5C,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,YAAY;SACpB,CAAC;QAEF,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEhC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,YAAY,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;QAE1C,YAAY,CAAC,aAAa,GAAG,CAAC,YAAY,CAAC,CAAC;QAE5C,YAAY,CAAC,OAAO,EAAE,CAAC;QAEvB,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAEhD,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,YAAY,CAAC,QAAQ,CAAC;YACpB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QAEH,WAAW,EAAE,CAAC;QAEd,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"signal-state-handler.spec.js","sourceRoot":"","sources":["../../../src/store/__tests__/signal-state-handler.spec.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,6 @@
-import { BehaviorSubject } from 'rxjs';
 import { BaseStateHandler } from './base-state-handler.js';
 import type { Observable } from 'rxjs';
+import type { DistinctOptions } from '../config/status-quo-config.js';
 type ObservableStateHandlerProps<S> = {
     initialState: S;
     options?: {
@@ -8,6 +8,8 @@ type ObservableStateHandlerProps<S> = {
             enabled?: boolean;
             namespace: string;
         };
+        distinct?: DistinctOptions<S>;
+        useDistinctUntilChanged?: boolean;
     };
 };
 type StateObservableOptions = {
@@ -15,11 +17,12 @@ type StateObservableOptions = {
 };
 export declare abstract class ObservableStateHandler<S, A> extends BaseStateHandler<S, A> {
     private readonly state$;
+    private readonly distinctOptions;
     protected constructor({ initialState, options }: ObservableStateHandlerProps<S>);
     protected getStateValue(): S;
     protected setStateValue(nextState: S): void;
     getStateItemAsObservable(key: keyof S): Observable<S[keyof S]>;
-    getStateAsObservable(options?: StateObservableOptions): BehaviorSubject<S>;
+    getStateAsObservable(options?: StateObservableOptions): Observable<S>;
     getObservable(key: keyof S): Observable<S[keyof S]>;
     /** @deprecated Use getObservable instead. */
     getObservableItem(key: keyof S): Observable<S[keyof S]>;

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

@@ -1,18 +1,13 @@
-import { BehaviorSubject, distinctUntilKeyChanged, map, pipe, distinctUntilChanged } from 'rxjs';
+import { BehaviorSubject, distinctUntilChanged, distinctUntilKeyChanged, map } from 'rxjs';
 import { BaseStateHandler } from './base-state-handler.js';
-function distinctUntilChangedAsJson() {
-    return pipe(distinctUntilChanged((a, b) => {
-        return JSON.stringify(a) === JSON.stringify(b);
-    }));
-}
-const pipeMap = {
-    useDistinctUntilChanged: distinctUntilChangedAsJson(),
-};
+import { resolveDistinctOptions } from '../config/status-quo-config.js';
 export class ObservableStateHandler extends BaseStateHandler {
     state$;
+    distinctOptions;
     constructor({ initialState, options }) {
         super(initialState);
         this.state$ = new BehaviorSubject(initialState);
+        this.distinctOptions = resolveDistinctOptions(options?.distinct, options?.useDistinctUntilChanged);
         this.initDevTools(options?.devTools);
     }
     getStateValue() {
@@ -24,18 +19,14 @@ export class ObservableStateHandler extends BaseStateHandler {
     getStateItemAsObservable(key) {
         return this.state$.pipe(distinctUntilKeyChanged(key), map((state) => state[key]));
     }
-    getStateAsObservable(options = {
-        useDistinctUntilChanged: true,
-    }) {
-        // Unfortunately we cannot add pipe operators conditionally in an easy manner.
-        // That's why we use a simple object to attach operators to a new state observable via reduce().
-        // This way we can easily extend our default operators map.
-        return Object.keys(options)
-            .filter((optionKey) => options[optionKey] === true)
-            .map((enabledOptions) => pipeMap[enabledOptions])
-            .reduce((stateObservable$, operator) => {
-            return stateObservable$.pipe(operator);
-        }, this.state$);
+    getStateAsObservable(options = {}) {
+        const useDistinctUntilChanged = options.useDistinctUntilChanged ?? this.distinctOptions.enabled;
+        if (!useDistinctUntilChanged) {
+            return this.state$;
+        }
+        return this.state$.pipe(distinctUntilChanged((previous, next) => {
+            return this.distinctOptions.comparator(previous, next);
+        }));
     }
     getObservable(key) {
         return this.getStateItemAsObservable(key);

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,uBAAuB,EAAE,GAAG,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,MAAM,CAAC;AAEjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgB3D,SAAS,0BAA0B;IACjC,OAAO,IAAI,CACT,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAG;IACd,uBAAuB,EAAE,0BAA0B,EAAE;CACtD,CAAC;AAEF,MAAM,OAAgB,sBAA6B,SAAQ,gBAAsB;IAC9D,MAAM,CAAqB;IAE5C,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,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,wBAAwB,CAAC,GAAY;QACnC,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,oBAAoB,CAClB,UAAkC;QAChC,uBAAuB,EAAE,IAAI;KAC9B;QAED,8EAA8E;QAC9E,gGAAgG;QAChG,2DAA2D;QAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;aACxB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,SAAyC,CAAC,KAAK,IAAI,CAAC;aAClF,GAAG,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,cAA8C,CAAC,CAAC;aAChF,MAAM,CAAC,CAAC,gBAAgB,EAAE,QAAQ,EAAE,EAAE;YACrC,OAAO,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAuB,CAAC;QAC/D,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAED,aAAa,CAAC,GAAY;QACxB,OAAO,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,6CAA6C;IAC7C,iBAAiB,CAAC,GAAY;QAC5B,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,QAAoB;QAC5B,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;YAC9D,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,QAAQ,EAAE,CAAC;QACb,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,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAmBxE,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,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;QACnG,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,wBAAwB,CAAC,GAAY;QACnC,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,oBAAoB,CAAC,UAAkC,EAAE;QACvD,MAAM,uBAAuB,GAC3B,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;QAElE,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,CACc,CAAC;IACrB,CAAC;IAED,aAAa,CAAC,GAAY;QACxB,OAAO,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,6CAA6C;IAC7C,iBAAiB,CAAC,GAAY;QAC5B,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,QAAoB;QAC5B,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;YAC9D,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;CACF"}

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

@@ -1,5 +1,6 @@
 import { BaseStateHandler } from './base-state-handler.js';
 import type { Signal } from '@preact/signals-core';
+import type { DistinctOptions } from '../config/status-quo-config.js';
 type SignalStateHandlerProps<S> = {
     initialState: S;
     options?: {
@@ -7,19 +8,18 @@ type SignalStateHandlerProps<S> = {
             enabled?: boolean;
             namespace: string;
         };
+        distinct?: DistinctOptions<S>;
         useDistinctUntilChanged?: boolean;
     };
 };
 type Listener = () => void;
 export declare abstract class SignalStateHandler<S, A> extends BaseStateHandler<S, A> {
     private readonly state;
-    private readonly listeners;
-    private readonly useDistinctUntilChanged;
+    private readonly distinctOptions;
     protected constructor({ initialState, options }: SignalStateHandlerProps<S>);
     getSignal(): Signal<S>;
     subscribe(listener: Listener): () => void;
     protected getStateValue(): S;
     protected setStateValue(nextState: S): void;
-    private notify;
 }
 export {};