@veams/status-quo 0.1.0 → 1.1.0

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

@@ -1,6 +1,6 @@
 import { lastValueFrom, Subject, take } from 'rxjs';
-import { StateHandler } from '../state-handler.js';
-class TestStateHandler extends StateHandler {
+import { ObservableStateHandler } from '../observable-state-handler.js';
+class TestObservableStateHandler extends ObservableStateHandler {
     constructor(withDevTools) {
         super({
             initialState: {
@@ -8,16 +8,15 @@ class TestStateHandler extends StateHandler {
                 test2: 'testValue2',
             },
             ...(withDevTools && {
-                devTools: {
-                    enabled: true,
-                    namespace: 'TestStateHandler',
+                options: {
+                    devTools: {
+                        enabled: true,
+                        namespace: 'TestObservableStateHandler',
+                    },
                 },
             }),
         });
     }
-    getObservable() {
-        return this.getStateAsObservable();
-    }
     getActions() {
         return {
             testAction: () => {
@@ -26,10 +25,10 @@ class TestStateHandler extends StateHandler {
         };
     }
 }
-describe('State Handler', () => {
+describe('Observable State Handler', () => {
     let stateHandler;
     beforeEach(() => {
-        stateHandler = new TestStateHandler();
+        stateHandler = new TestObservableStateHandler();
     });
     it('should provide initial state', () => {
         expect(stateHandler.getInitialState()).toStrictEqual({
@@ -49,7 +48,7 @@ describe('State Handler', () => {
             test2: 'testValue2',
         };
         stateHandler.setState(expected);
-        const state = await lastValueFrom(stateHandler.getObservable().pipe(take(1)));
+        const state = await lastValueFrom(stateHandler.getStateAsObservable().pipe(take(1)));
         expect(state).toStrictEqual(expected);
         expect(stateHandler.getState()).toStrictEqual(expected);
     });
@@ -66,7 +65,7 @@ describe('State Handler', () => {
     });
     it('should only call subscriber when object state has changed', async () => {
         const spy = jest.fn();
-        stateHandler.getObservable().subscribe(spy);
+        const unsubscribe = stateHandler.subscribe(spy);
         stateHandler.setState({
             test: 'test',
         });
@@ -79,7 +78,8 @@ describe('State Handler', () => {
         stateHandler.setState({
             test: 'test2',
         });
-        expect(spy).toHaveBeenCalledTimes(3); // 1. testValue (Initial value), 2. test (first setter), 3. test2 (second setter)
+        unsubscribe();
+        expect(spy).toHaveBeenCalledTimes(2); // 1. test (first setter), 2. test2 (second setter)
     });
 });
-//# sourceMappingURL=state-handler.spec.js.map
+//# sourceMappingURL=observable-state-handler.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observable-state-handler.spec.js","sourceRoot":"","sources":["../../../src/store/__tests__/observable-state-handler.spec.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,78 @@
+import { SignalStateHandler } from '../signal-state-handler.js';
+class TestSignalStateHandler extends SignalStateHandler {
+    constructor(withDevTools) {
+        super({
+            initialState: {
+                test: 'testValue',
+                test2: 'testValue2',
+            },
+            ...(withDevTools && {
+                options: {
+                    devTools: {
+                        enabled: true,
+                        namespace: 'TestSignalStateHandler',
+                    },
+                },
+            }),
+        });
+    }
+    getActions() {
+        return {
+            testAction: () => {
+                this.setState({ test: 'newValue' });
+            },
+        };
+    }
+}
+describe('Signal State Handler', () => {
+    let stateHandler;
+    beforeEach(() => {
+        stateHandler = new TestSignalStateHandler();
+    });
+    it('should provide initial state', () => {
+        expect(stateHandler.getInitialState()).toStrictEqual({
+            test: 'testValue',
+            test2: 'testValue2',
+        });
+    });
+    it('should provide current state', () => {
+        expect(stateHandler.getState()).toStrictEqual({
+            test: 'testValue',
+            test2: 'testValue2',
+        });
+    });
+    it('should support state changing via setter and merge state object on first level', () => {
+        const expected = {
+            test: 'change',
+            test2: 'testValue2',
+        };
+        stateHandler.setState(expected);
+        expect(stateHandler.getState()).toStrictEqual(expected);
+    });
+    it('should support additional subscriptions handling', () => {
+        const spy = jest.fn();
+        const subscription = { unsubscribe: spy };
+        stateHandler.subscriptions = [subscription];
+        stateHandler.destroy();
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should only call subscriber when object state has changed', () => {
+        const spy = jest.fn();
+        const unsubscribe = stateHandler.subscribe(spy);
+        stateHandler.setState({
+            test: 'test',
+        });
+        stateHandler.setState({
+            test: 'test2',
+        });
+        stateHandler.setState({
+            test: 'test2',
+        });
+        stateHandler.setState({
+            test: 'test2',
+        });
+        unsubscribe();
+        expect(spy).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=signal-state-handler.spec.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,30 @@
+import type { StateSubscriptionHandler } from '../types/types.js';
+import type { DevTools } from './dev-tools.js';
+type DevToolsOptions = {
+    enabled?: boolean;
+    namespace: string;
+};
+export declare abstract class BaseStateHandler<S, A> implements StateSubscriptionHandler<S, A> {
+    protected readonly initialState: S;
+    protected devTools: DevTools | null;
+    subscriptions: Array<{
+        unsubscribe: () => void;
+    }>;
+    protected constructor(initialState: S);
+    protected initDevTools(devToolsOptions?: DevToolsOptions): void;
+    getInitialState(): S;
+    getState(): S;
+    getSnapshot(): S;
+    setState(newState: Partial<S>, actionName?: string): void;
+    destroy(): void;
+    protected abstract getStateValue(): S;
+    protected abstract setStateValue(nextState: S): void;
+    protected bindSubscribable<T>(service: {
+        subscribe: (listener: (value: T) => void) => () => void;
+        getSnapshot?: () => T;
+    }, onChange: (value: T) => void): void;
+    abstract subscribe(listener: () => void): () => void;
+    abstract getActions(): A;
+    private handleDevToolsEvents;
+}
+export {};

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

@@ -0,0 +1,84 @@
+import { withDevTools } from './dev-tools.js';
+const defaultDevToolsOptions = { enabled: false, namespace: 'Store' };
+const devToolsFeatures = {
+    pause: true,
+    lock: true,
+    persist: false,
+    export: true,
+    import: 'custom',
+    jump: true,
+    skip: true,
+    reorder: true,
+    dispatch: false,
+    test: false,
+};
+export class BaseStateHandler {
+    initialState;
+    devTools = null;
+    subscriptions = [];
+    constructor(initialState) {
+        this.initialState = initialState;
+    }
+    initDevTools(devToolsOptions) {
+        const mergedOptions = {
+            ...defaultDevToolsOptions,
+            ...devToolsOptions,
+        };
+        if (!mergedOptions.enabled) {
+            this.devTools = null;
+            return;
+        }
+        this.devTools = withDevTools(this.initialState, {
+            name: mergedOptions.namespace,
+            instanceId: mergedOptions.namespace.toLowerCase().replaceAll(' ', '-'),
+            actionCreators: this.getActions(),
+            features: devToolsFeatures,
+        });
+        this.devTools?.subscribe(this.handleDevToolsEvents);
+    }
+    getInitialState() {
+        return this.initialState;
+    }
+    getState() {
+        return this.getStateValue();
+    }
+    getSnapshot() {
+        return this.getState();
+    }
+    setState(newState, actionName = 'change') {
+        const nextState = { ...this.getState(), ...newState };
+        this.setStateValue(nextState);
+        this.devTools?.send(actionName, nextState);
+    }
+    destroy() {
+        this.subscriptions.forEach((subscription) => subscription.unsubscribe());
+    }
+    bindSubscribable(service, onChange) {
+        const unsubscribe = service.subscribe(onChange);
+        this.subscriptions = [...(this.subscriptions ?? []), { unsubscribe }];
+        if (service.getSnapshot)
+            onChange(service.getSnapshot());
+    }
+    handleDevToolsEvents = (message) => {
+        if (message.type !== 'DISPATCH') {
+            return;
+        }
+        switch (message.payload.type) {
+            case 'RESET':
+                this.setStateValue(this.getInitialState());
+                this.devTools?.init(this.getInitialState());
+                break;
+            case 'COMMIT':
+                this.setStateValue(this.getState());
+                this.devTools?.init(this.getState());
+                break;
+            case 'JUMP_TO_STATE':
+            case 'JUMP_TO_ACTION':
+                this.setStateValue(JSON.parse(message.state));
+                break;
+            default:
+                break;
+        }
+    };
+}
+//# sourceMappingURL=base-state-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-state-handler.js","sourceRoot":"","sources":["../../src/store/base-state-handler.ts"],"names":[],"mappings":"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"}

package/dist/store/index.d.ts

@@ -1,3 +1,5 @@
-export { StateHandler } from './state-handler.js';
+export { BaseStateHandler } from './base-state-handler.js';
+export { ObservableStateHandler } from './observable-state-handler.js';
+export { SignalStateHandler } from './signal-state-handler.js';
 export type { StateSingleton } from './state-singleton.js';
 export { makeStateSingleton } from './state-singleton.js';

package/dist/store/index.js

@@ -1,3 +1,5 @@
-export { StateHandler } from './state-handler.js';
+export { BaseStateHandler } from './base-state-handler.js';
+export { ObservableStateHandler } from './observable-state-handler.js';
+export { SignalStateHandler } from './signal-state-handler.js';
 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,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}
+{"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"}

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

@@ -0,0 +1,26 @@
+import { BehaviorSubject } from 'rxjs';
+import { BaseStateHandler } from './base-state-handler.js';
+import type { Observable } from 'rxjs';
+type ObservableStateHandlerProps<S> = {
+    initialState: S;
+    options?: {
+        devTools?: {
+            enabled?: boolean;
+            namespace: string;
+        };
+    };
+};
+type StateObservableOptions = {
+    useDistinctUntilChanged?: boolean;
+};
+export declare abstract class ObservableStateHandler<S, A> extends BaseStateHandler<S, A> {
+    private readonly state$;
+    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>;
+    getObservableItem(key: keyof S): Observable<S[keyof S]>;
+    subscribe(listener: () => void): () => void;
+}
+export {};

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

@@ -0,0 +1,55 @@
+import { BehaviorSubject, distinctUntilKeyChanged, map, pipe, distinctUntilChanged } 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(),
+};
+export class ObservableStateHandler extends BaseStateHandler {
+    state$;
+    constructor({ initialState, options }) {
+        super(initialState);
+        this.state$ = new BehaviorSubject(initialState);
+        this.initDevTools(options?.devTools);
+    }
+    getStateValue() {
+        return this.state$.getValue();
+    }
+    setStateValue(nextState) {
+        this.state$.next(nextState);
+    }
+    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$);
+    }
+    getObservableItem(key) {
+        return this.getStateItemAsObservable(key);
+    }
+    subscribe(listener) {
+        let initialized = false;
+        const subscription = this.getStateAsObservable().subscribe(() => {
+            if (!initialized) {
+                initialized = true;
+                return;
+            }
+            listener();
+        });
+        return () => subscription.unsubscribe();
+    }
+}
+//# sourceMappingURL=observable-state-handler.js.map

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

@@ -0,0 +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,iBAAiB,CAAC,GAAY;QAC5B,OAAO,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC5C,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

@@ -0,0 +1,25 @@
+import { BaseStateHandler } from './base-state-handler.js';
+import type { Signal } from '@preact/signals-core';
+type SignalStateHandlerProps<S> = {
+    initialState: S;
+    options?: {
+        devTools?: {
+            enabled?: boolean;
+            namespace: string;
+        };
+        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;
+    protected constructor({ initialState, options }: SignalStateHandlerProps<S>);
+    getSignal(): Signal<S>;
+    subscribe(listener: Listener): () => void;
+    protected getStateValue(): S;
+    protected setStateValue(nextState: S): void;
+    private notify;
+}
+export {};

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

@@ -0,0 +1,49 @@
+import { signal } from '@preact/signals-core';
+import { BaseStateHandler } from './base-state-handler.js';
+const defaultOptions = {
+    useDistinctUntilChanged: true,
+};
+function isEqualAsJson(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+export class SignalStateHandler extends BaseStateHandler {
+    state;
+    listeners = new Map();
+    useDistinctUntilChanged;
+    constructor({ initialState, options = defaultOptions }) {
+        super(initialState);
+        const mergedOptions = {
+            ...defaultOptions,
+            ...options,
+        };
+        this.state = signal(initialState);
+        this.useDistinctUntilChanged = mergedOptions.useDistinctUntilChanged ?? true;
+        this.initDevTools(options?.devTools);
+    }
+    getSignal() {
+        return this.state;
+    }
+    subscribe(listener) {
+        this.listeners.set(listener, this.state.value);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    getStateValue() {
+        return this.state.value;
+    }
+    setStateValue(nextState) {
+        this.state.value = nextState;
+        this.notify(nextState);
+    }
+    notify(nextState) {
+        for (const [listener, lastSnapshot] of this.listeners.entries()) {
+            if (this.useDistinctUntilChanged && isEqualAsJson(nextState, lastSnapshot)) {
+                continue;
+            }
+            this.listeners.set(listener, nextState);
+            listener();
+        }
+    }
+}
+//# sourceMappingURL=signal-state-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signal-state-handler.js","sourceRoot":"","sources":["../../src/store/signal-state-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAiB3D,MAAM,cAAc,GAAG;IACrB,uBAAuB,EAAE,IAAI;CAC9B,CAAC;AAEF,SAAS,aAAa,CAAC,CAAU,EAAE,CAAU;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,OAAgB,kBAAyB,SAAQ,gBAAsB;IAC1D,KAAK,CAAY;IACjB,SAAS,GAAG,IAAI,GAAG,EAAe,CAAC;IACnC,uBAAuB,CAAU;IAElD,YAAsB,EAAE,YAAY,EAAE,OAAO,GAAG,cAAc,EAA8B;QAC1F,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,MAAM,aAAa,GAAG;YACpB,GAAG,cAAc;YACjB,GAAG,OAAO;SACX,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,MAAM,CAAI,YAAY,CAAC,CAAC;QACrC,IAAI,CAAC,uBAAuB,GAAG,aAAa,CAAC,uBAAuB,IAAI,IAAI,CAAC;QAC7E,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,SAAS,CAAC,QAAkB;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE/C,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAES,aAAa;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAES,aAAa,CAAC,SAAY;QAClC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,SAAY;QACzB,KAAK,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YAChE,IAAI,IAAI,CAAC,uBAAuB,IAAI,aAAa,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC;gBAC3E,SAAS;YACX,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACxC,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;CACF"}

package/dist/types/types.d.ts

@@ -1,6 +1,6 @@
-import type { Observable } from 'rxjs';
 export interface StateSubscriptionHandler<V, A> {
-    getObservable: () => Observable<V>;
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => V;
     destroy: () => void;
     getInitialState: () => V;
     getActions: () => A;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veams/status-quo",
-  "version": "0.1.0",
+  "version": "1.1.0",
   "description": "The manager to rule states in frontend.",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -40,6 +40,9 @@
     "lint": "pnpm run lint:ts",
     "lint:ts": "eslint --fix \"src/**/*.{tsx,ts}\" --config ./.eslintrc.cjs",
     "start": "npm-run-all --parallel watch:**",
+    "playground": "vite --config playground/vite.config.ts",
+    "docs:build": "vite build --config playground/vite.config.ts",
+    "docs:preview": "vite preview --config playground/vite.config.ts",
     "watch:bundle:ts": "npm run bundle:ts -- -w",
     "watch:generate:types": "npm run generate:types -- --watch",
     "test": "cross-env NODE_ENV=test jest --config jest.config.cjs",
@@ -47,26 +50,34 @@
     "release": "npm run build && release-it"
   },
   "peerDependencies": {
+    "@preact/signals-core": ">=1.0.0",
     "react": ">=18.0.0",
     "rxjs": ">=7.5.4"
   },
   "devDependencies": {
+    "@preact/signals-core": "^1.13.0",
+    "@types/prismjs": "^1.26.4",
+    "@types/react-dom": "^19.0.0",
     "@types/jest": "30.0.0",
-    "@types/node": "24.0.13",
-    "@types/react": "19.1.8",
-    "cross-env": "7.0.3",
+    "@types/node": "25.2.3",
+    "@types/react": "19.2.14",
+    "@vitejs/plugin-react": "^5.0.0",
+    "cross-env": "10.1.0",
     "eslint": "8.55.0",
-    "jest": "30.0.4",
-    "jest-environment-jsdom": "30.0.4",
+    "jest": "30.2.0",
+    "jest-environment-jsdom": "30.2.0",
     "npm-run-all": "4.1.5",
-    "prettier": "3.6.2",
-    "react": "19.1.0",
+    "prettier": "3.8.1",
+    "prismjs": "^1.29.0",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
     "rxjs": "7.8.2",
     "tslib": "2.8.1",
-    "typescript": "5.8.3",
+    "typescript": "5.9.3",
+    "vite": "^5.0.0",
     "@swc/jest": "0.2.39",
-    "@swc/core": "1.12.11",
-    "release-it": "19.0.3"
+    "@swc/core": "1.15.11",
+    "release-it": "19.2.4"
   },
   "keywords": [
     "State Management"

package/playground/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Status Quo Playground</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>