synstate 3.0.0 → 3.0.2

package/dist/utils/collect-to-array.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"collect-to-array.mjs","sources":["../../src/utils/collect-to-array.mts"],"sourcesContent":["import { type Observable } from '../core/index.mjs';\n\nexport const collectToArray = <A,>(\n  observable: Observable<A>,\n): Promise<readonly A[]> =>\n  new Promise<readonly A[]>((resolve) => {\n    const mut_buffer: A[] = [];\n\n    observable.subscribe(\n      (value) => {\n        mut_buffer.push(value);\n      },\n      () => {\n        resolve(mut_buffer);\n      },\n    );\n  });\n"],"names":[],"mappings":"AAEO,MAAM,iBAAiB,CAC5B,UAAA,KAEA,IAAI,OAAA,CAAsB,CAAC,OAAA,KAAY;AACrC,EAAA,MAAM,aAAkB,EAAC;AAEzB,EAAA,UAAA,CAAW,SAAA;AAAA,IACT,CAAC,KAAA,KAAU;AACT,MAAA,UAAA,CAAW,KAAK,KAAK,CAAA;AAAA,IACvB,CAAA;AAAA,IACA,MAAM;AACJ,MAAA,OAAA,CAAQ,UAAU,CAAA;AAAA,IACpB;AAAA,GACF;AACF,CAAC;;;;"}
+{"version":3,"file":"collect-to-array.mjs","sourceRoot":"","sources":["../../src/utils/collect-to-array.mts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,UAAyB,EACF,EAAE,CACzB,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,EAAE;IACpC,MAAM,UAAU,GAAQ,EAAE,CAAC;IAE3B,UAAU,CAAC,SAAS,CAClB,CAAC,KAAK,EAAE,EAAE;QACR,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,EACD,GAAG,EAAE;QACH,OAAO,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/utils/create-boolean-state.mjs

@@ -1,25 +1,50 @@
 import { createState } from './create-state.mjs';
 
-const createBooleanState = (initialState) => {
-  const [state, setState, { updateState, resetState, getSnapshot }] = createState(initialState);
-  return [
-    state,
-    {
-      setTrue: () => {
-        setState(true);
-      },
-      setFalse: () => {
-        setState(false);
-      },
-      toggle: () => updateState((s) => !s),
-      setState,
-      updateState,
-      resetState,
-      getSnapshot,
-      initialState
-    }
-  ];
-};
 
-export { createBooleanState };
-//# sourceMappingURL=create-boolean-state.mjs.map
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const createBooleanState = (initialState) => {
+    const [state, setState, { updateState, resetState, getSnapshot }] = createState(initialState);
+    return [
+        state,
+        {
+            setTrue: () => {
+                setState(true);
+            },
+            setFalse: () => {
+                setState(false);
+            },
+            toggle: () => updateState((s) => !s),
+            setState,
+            updateState,
+            resetState,
+            getSnapshot,
+            initialState,
+        },
+    ];
+};
+//# sourceMappingURL=create-boolean-state.mjs.map

package/dist/utils/create-boolean-state.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-boolean-state.mjs","sources":["../../src/utils/create-boolean-state.mts"],"sourcesContent":["import { type InitializedObservable } from '../core/index.mjs';\nimport { createState } from './create-state.mjs';\n\n/**\n * Creates a reactive boolean state with convenient methods for boolean operations.\n * Extends `createState` with boolean-specific helpers like `toggle`, `setTrue`, and `setFalse`.\n *\n * @param initialState - The initial boolean value\n * @returns A 2-element tuple: `[state, { setTrue, setFalse, toggle, setState, updateState, resetState, getSnapshot, initialState }]`\n *\n * @example\n * ```ts\n * import type * as React from 'react';\n * import { createBooleanState } from 'synstate';\n * import { useObservableValue } from 'synstate-react-hooks';\n *\n *     // Menu drawer open/close state.\n *     // setTrue and setFalse can be passed directly as callbacks\n *     // — no need to create wrapper functions like `() => setState(true)`.\n *     const [menuOpen$, { setTrue: openMenu, setFalse: closeMenu }] =\n *       createBooleanState(false);\n *\n *     const SampleComponent = (): React.JSX.Element => (\n *       <MenuDrawer\n *         open={useObservableValue(menuOpen$)}\n *         onClose={closeMenu}\n *         onOpen={openMenu}\n *       />\n *     );\n * ```\n */\n\nexport const createBooleanState = (\n  initialState: boolean,\n): readonly [\n  state: InitializedObservable<boolean>,\n  utils: Readonly<{\n    setTrue: () => void;\n    setFalse: () => void;\n    setState: (next: boolean) => boolean;\n    toggle: () => boolean;\n    updateState: (updateFn: (prev: boolean) => boolean) => boolean;\n    resetState: () => boolean;\n    getSnapshot: () => boolean;\n    initialState: boolean;\n  }>,\n] => {\n  const [state, setState, { updateState, resetState, getSnapshot }] =\n    createState(initialState);\n\n  return [\n    state,\n    {\n      setTrue: () => {\n        setState(true);\n      },\n      setFalse: () => {\n        setState(false);\n      },\n      toggle: () => updateState((s) => !s),\n      setState,\n      updateState,\n      resetState,\n      getSnapshot,\n      initialState,\n    },\n  ] as const;\n};\n"],"names":[],"mappings":";;AAgCO,MAAM,kBAAA,GAAqB,CAChC,YAAA,KAaG;AACH,EAAA,MAAM,CAAC,KAAA,EAAO,QAAA,EAAU,EAAE,WAAA,EAAa,YAAY,WAAA,EAAa,CAAA,GAC9D,WAAA,CAAY,YAAY,CAAA;AAE1B,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA;AAAA,MACE,SAAS,MAAM;AACb,QAAA,QAAA,CAAS,IAAI,CAAA;AAAA,MACf,CAAA;AAAA,MACA,UAAU,MAAM;AACd,QAAA,QAAA,CAAS,KAAK,CAAA;AAAA,MAChB,CAAA;AAAA,MACA,QAAQ,MAAM,WAAA,CAAY,CAAC,CAAA,KAAM,CAAC,CAAC,CAAA;AAAA,MACnC,QAAA;AAAA,MACA,WAAA;AAAA,MACA,UAAA;AAAA,MACA,WAAA;AAAA,MACA;AAAA;AACF,GACF;AACF;;;;"}
+{"version":3,"file":"create-boolean-state.mjs","sourceRoot":"","sources":["../../src/utils/create-boolean-state.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,YAAqB,EAarB,EAAE;IACF,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,GAC/D,WAAW,CAAC,YAAY,CAAC,CAAC;IAE5B,OAAO;QACL,KAAK;QACL;YACE,OAAO,EAAE,GAAG,EAAE;gBACZ,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YACD,QAAQ,EAAE,GAAG,EAAE;gBACb,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YACpC,QAAQ;YACR,WAAW;YACX,UAAU;YACV,WAAW;YACX,YAAY;SACb;KACO,CAAC;AACb,CAAC,CAAC"}

package/dist/utils/create-event-emitter.mjs

@@ -1,21 +1,69 @@
-import 'ts-data-forge';
-import '../core/utils/id-maker.mjs';
-import { source } from '../core/create/source.mjs';
-
-const createEventEmitter = () => {
-  const src$ = source();
-  const emitter = () => {
-    src$.next(void 0);
-  };
-  return [src$, emitter];
-};
-const createValueEmitter = () => {
-  const src$ = source();
-  const emitter = (value) => {
-    src$.next(value);
-  };
-  return [src$, emitter];
+import { source } from '../core/index.mjs';
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const createEventEmitter = () => {
+    const src$ = source();
+    const emitter = () => {
+        src$.next(undefined);
+    };
+    return [src$, emitter];
 };
 
-export { createEventEmitter, createValueEmitter };
-//# sourceMappingURL=create-event-emitter.mjs.map
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const createValueEmitter = () => {
+    const src$ = source();
+    const emitter = (value) => {
+        src$.next(value);
+    };
+    return [src$, emitter];
+};
+//# sourceMappingURL=create-event-emitter.mjs.map

package/dist/utils/create-event-emitter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-event-emitter.mjs","sources":["../../src/utils/create-event-emitter.mts"],"sourcesContent":["import { source, type Observable } from '../core/index.mjs';\n\n/**\n * Creates an event emitter for void events (events without payload).\n * Returns a tuple of [observable, emitter function].\n *\n * @returns A tuple containing the observable and the emitter function\n *\n * @example\n * ```ts\n * const [click$, emitClick] = createEventEmitter();\n *\n * const mut_clickCount = { value: 0 };\n *\n * click$.subscribe(() => {\n *   mut_clickCount.value += 1;\n * });\n *\n * emitClick(); // logs: Clicked!\n *\n * assert.deepStrictEqual(mut_clickCount.value, 1);\n *\n * emitClick();\n *\n * emitClick();\n *\n * assert.deepStrictEqual(mut_clickCount.value, 3);\n * ```\n */\nexport const createEventEmitter = (): readonly [\n  Observable<void>,\n  () => void,\n] => {\n  const src$ = source<undefined>();\n\n  const emitter = (): void => {\n    src$.next(undefined);\n  };\n\n  return [src$, emitter];\n};\n\n/**\n * Creates an event emitter with typed payload.\n * Returns a tuple of [observable, emitter function].\n *\n * @template A - The type of the event payload\n * @returns A tuple containing the observable and the emitter function\n *\n * @example\n * ```ts\n * const [message$, emitMessage] = createValueEmitter<string>();\n *\n * const messageHistory: string[] = [];\n *\n * message$.subscribe((msg) => {\n *   messageHistory.push(msg);\n * });\n *\n * emitMessage('Hello'); // logs: Hello\n *\n * assert.deepStrictEqual(messageHistory, ['Hello']);\n *\n * emitMessage('World');\n *\n * assert.deepStrictEqual(messageHistory, ['Hello', 'World']);\n * ```\n */\nexport const createValueEmitter = <A,>(): readonly [\n  Observable<A>,\n  (value: A) => void,\n] => {\n  const src$ = source<A>();\n\n  const emitter = (value: A): void => {\n    src$.next(value);\n  };\n\n  return [src$, emitter];\n};\n"],"names":[],"mappings":";;;;AA6BO,MAAM,qBAAqB,MAG7B;AACH,EAAA,MAAM,OAAO,MAAA,EAAkB;AAE/B,EAAA,MAAM,UAAU,MAAY;AAC1B,IAAA,IAAA,CAAK,KAAK,MAAS,CAAA;AAAA,EACrB,CAAA;AAEA,EAAA,OAAO,CAAC,MAAM,OAAO,CAAA;AACvB;AA4BO,MAAM,qBAAqB,MAG7B;AACH,EAAA,MAAM,OAAO,MAAA,EAAU;AAEvB,EAAA,MAAM,OAAA,GAAU,CAAC,KAAA,KAAmB;AAClC,IAAA,IAAA,CAAK,KAAK,KAAK,CAAA;AAAA,EACjB,CAAA;AAEA,EAAA,OAAO,CAAC,MAAM,OAAO,CAAA;AACvB;;;;"}
+{"version":3,"file":"create-event-emitter.mjs","sourceRoot":"","sources":["../../src/utils/create-event-emitter.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmB,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAGhC,EAAE;IACF,MAAM,IAAI,GAAG,MAAM,EAAa,CAAC;IAEjC,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAGhC,EAAE;IACF,MAAM,IAAI,GAAG,MAAM,EAAK,CAAC;IAEzB,MAAM,OAAO,GAAG,CAAC,KAAQ,EAAQ,EAAE;QACjC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzB,CAAC,CAAC"}

package/dist/utils/create-reducer.mjs

@@ -1,17 +1,55 @@
-import 'ts-data-forge';
-import '../core/utils/id-maker.mjs';
-import { source } from '../core/create/source.mjs';
-
-const createReducer = (reducer, initialState) => {
-  const state = source(initialState);
-  const dispatch = (action) => {
-    const nextState = reducer(state.getSnapshot().value, action);
-    state.next(nextState);
-    return nextState;
-  };
-  const getSnapshot = () => state.getSnapshot().value;
-  return [state, dispatch, { getSnapshot, initialState }];
-};
+import { source } from '../core/index.mjs';
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
-export { createReducer };
-//# sourceMappingURL=create-reducer.mjs.map
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const createReducer = (reducer, initialState) => {
+    const state = source(initialState);
+    const dispatch = (action) => {
+        const nextState = reducer(state.getSnapshot().value, action);
+        state.next(nextState);
+        return nextState;
+    };
+    const getSnapshot = () => state.getSnapshot().value;
+    return [state, dispatch, { getSnapshot, initialState }];
+};
+//# sourceMappingURL=create-reducer.mjs.map

package/dist/utils/create-reducer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-reducer.mjs","sources":["../../src/utils/create-reducer.mts"],"sourcesContent":["import { type Reducer } from 'ts-type-forge';\nimport { source, type InitializedObservable } from '../core/index.mjs';\n\n/**\n * Creates a reducer-based state management container following the Redux pattern.\n * Actions are dispatched to update the state according to the reducer function.\n *\n * @template S - The type of the state\n * @template A - The type of actions\n * @param reducer - A pure function that takes current state and action, returns new state\n * @param initialState - The initial value of the state\n * @returns A 3-element tuple: `[state, dispatch, { getSnapshot, initialState }]`\n *\n * @example\n * ```ts\n * const [state, dispatch] = createReducer(\n *   (s, action: Readonly<{ type: 'increment' } | { type: 'decrement' }>) => {\n *     switch (action.type) {\n *       case 'increment':\n *         return s + 1;\n *       case 'decrement':\n *         return s - 1;\n *     }\n *   },\n *   0,\n * );\n *\n * const stateHistory: number[] = [];\n *\n * state.subscribe((value: number) => {\n *   stateHistory.push(value);\n * });\n *\n * assert.deepStrictEqual(stateHistory, [0]);\n *\n * dispatch({ type: 'increment' }); // logs: 1\n *\n * assert.deepStrictEqual(stateHistory, [0, 1]);\n *\n * dispatch({ type: 'increment' });\n *\n * dispatch({ type: 'decrement' });\n *\n * assert.deepStrictEqual(stateHistory, [0, 1, 2, 1]);\n * ```\n */\nexport const createReducer = <S, A>(\n  reducer: Reducer<S, A>,\n  initialState: S,\n): readonly [\n  state: InitializedObservable<S>,\n  dispatch: (action: A) => S,\n  utils: Readonly<{\n    getSnapshot: () => S;\n    initialState: S;\n  }>,\n] => {\n  const state = source<S>(initialState);\n\n  const dispatch = (action: A): S => {\n    const nextState = reducer(state.getSnapshot().value, action);\n\n    state.next(nextState);\n\n    return nextState;\n  };\n\n  const getSnapshot = (): S => state.getSnapshot().value;\n\n  return [state, dispatch, { getSnapshot, initialState }] as const;\n};\n"],"names":[],"mappings":";;;;AA8CO,MAAM,aAAA,GAAgB,CAC3B,OAAA,EACA,YAAA,KAQG;AACH,EAAA,MAAM,KAAA,GAAQ,OAAU,YAAY,CAAA;AAEpC,EAAA,MAAM,QAAA,GAAW,CAAC,MAAA,KAAiB;AACjC,IAAA,MAAM,YAAY,OAAA,CAAQ,KAAA,CAAM,WAAA,EAAY,CAAE,OAAO,MAAM,CAAA;AAE3D,IAAA,KAAA,CAAM,KAAK,SAAS,CAAA;AAEpB,IAAA,OAAO,SAAA;AAAA,EACT,CAAA;AAEA,EAAA,MAAM,WAAA,GAAc,MAAS,KAAA,CAAM,WAAA,EAAY,CAAE,KAAA;AAEjD,EAAA,OAAO,CAAC,KAAA,EAAO,QAAA,EAAU,EAAE,WAAA,EAAa,cAAc,CAAA;AACxD;;;;"}
+{"version":3,"file":"create-reducer.mjs","sourceRoot":"","sources":["../../src/utils/create-reducer.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAA8B,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,OAAsB,EACtB,YAAe,EAQf,EAAE;IACF,MAAM,KAAK,GAAG,MAAM,CAAI,YAAY,CAAC,CAAC;IAEtC,MAAM,QAAQ,GAAG,CAAC,MAAS,EAAK,EAAE;QAChC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAE7D,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEtB,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC;IAEvD,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAU,CAAC;AACnE,CAAC,CAAC"}

package/dist/utils/create-state.mjs

@@ -1,32 +1,59 @@
 import { createReducer } from './create-reducer.mjs';
-
 const reducer = (state, action) => {
-  switch (action.type) {
-    case "set":
-      return action.nextState;
-    case "update":
-      return action.updateFn(state);
-  }
-};
-const createState = (initialState) => {
-  const [state, dispatch, { getSnapshot }] = createReducer(
-    reducer,
-    initialState
-  );
-  const updateState = (updateFn) => dispatch({ type: "update", updateFn });
-  const setState = (nextState) => dispatch({ type: "set", nextState });
-  const resetState = () => dispatch({ type: "set", nextState: initialState });
-  return [
-    state,
-    setState,
-    {
-      updateState,
-      resetState,
-      getSnapshot,
-      initialState
+    switch (action.type) {
+        case 'set':
+            return action.nextState;
+        case 'update':
+            return action.updateFn(state);
     }
-  ];
 };
 
-export { createState };
-//# sourceMappingURL=create-state.mjs.map
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const createState = (initialState) => {
+    const [state, dispatch, { getSnapshot }] = createReducer(reducer, initialState);
+    const updateState = (updateFn) => dispatch({ type: 'update', updateFn });
+    const setState = (nextState) => dispatch({ type: 'set', nextState });
+    const resetState = () => dispatch({ type: 'set', nextState: initialState });
+    return [
+        state,
+        setState,
+        {
+            updateState,
+            resetState,
+            getSnapshot,
+            initialState,
+        },
+    ];
+};
+//# sourceMappingURL=create-state.mjs.map

package/dist/utils/create-state.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-state.mjs","sources":["../../src/utils/create-state.mts"],"sourcesContent":["import { type InitializedObservable } from '../core/index.mjs';\nimport { createReducer } from './create-reducer.mjs';\n\ntype Action<S> = Readonly<\n  | {\n      type: 'set';\n      nextState: S;\n    }\n  | {\n      type: 'update';\n      updateFn: (a: S) => S;\n    }\n>;\n\nconst reducer = <S,>(state: S, action: Action<S>): S => {\n  switch (action.type) {\n    case 'set':\n      return action.nextState;\n\n    case 'update':\n      return action.updateFn(state);\n  }\n};\n\n/**\n * Creates a reactive state container with getter and setter methods.\n * Provides a simple state management solution with observable state.\n *\n * @template S - The type of the state\n * @param initialState - The initial value of the state\n * @returns A 3-element tuple: `[state, setState, { updateState, resetState, getSnapshot, initialState }]`\n *\n * @example\n * ```ts\n * const [state, setState, { updateState, resetState }] = createState(0);\n *\n * const stateHistory: number[] = [];\n *\n * state.subscribe((value: number) => {\n *   stateHistory.push(value);\n * });\n *\n * assert.deepStrictEqual(stateHistory, [0]);\n *\n * setState(10); // logs: 10\n *\n * assert.deepStrictEqual(stateHistory, [0, 10]);\n *\n * updateState((prev: number) => prev + 1); // logs: 11\n *\n * assert.deepStrictEqual(stateHistory, [0, 10, 11]);\n *\n * resetState(); // logs: 0\n *\n * assert.deepStrictEqual(stateHistory, [0, 10, 11, 0]);\n * ```\n */\nexport const createState = <S,>(\n  initialState: S,\n): readonly [\n  state: InitializedObservable<S>,\n  setState: (v: S) => S,\n  utils: Readonly<{\n    updateState: (updateFn: (prev: S) => S) => S;\n    resetState: () => S;\n    getSnapshot: () => S;\n    initialState: S;\n  }>,\n] => {\n  const [state, dispatch, { getSnapshot }] = createReducer<S, Action<S>>(\n    reducer,\n    initialState,\n  );\n\n  const updateState = (updateFn: (prev: S) => S): S =>\n    dispatch({ type: 'update', updateFn });\n\n  const setState = (nextState: S): S => dispatch({ type: 'set', nextState });\n\n  const resetState = (): S =>\n    dispatch({ type: 'set', nextState: initialState });\n\n  return [\n    state,\n    setState,\n    {\n      updateState,\n      resetState,\n      getSnapshot,\n      initialState,\n    },\n  ] as const;\n};\n"],"names":[],"mappings":";;AAcA,MAAM,OAAA,GAAU,CAAK,KAAA,EAAU,MAAA,KAAyB;AACtD,EAAA,QAAQ,OAAO,IAAA;AAAM,IACnB,KAAK,KAAA;AACH,MAAA,OAAO,MAAA,CAAO,SAAA;AAAA,IAEhB,KAAK,QAAA;AACH,MAAA,OAAO,MAAA,CAAO,SAAS,KAAK,CAAA;AAAA;AAElC,CAAA;AAmCO,MAAM,WAAA,GAAc,CACzB,YAAA,KAUG;AACH,EAAA,MAAM,CAAC,KAAA,EAAO,QAAA,EAAU,EAAE,WAAA,EAAa,CAAA,GAAI,aAAA;AAAA,IACzC,OAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,MAAM,WAAA,GAAc,CAAC,QAAA,KACnB,QAAA,CAAS,EAAE,IAAA,EAAM,QAAA,EAAU,UAAU,CAAA;AAEvC,EAAA,MAAM,QAAA,GAAW,CAAC,SAAA,KAAoB,QAAA,CAAS,EAAE,IAAA,EAAM,KAAA,EAAO,WAAW,CAAA;AAEzE,EAAA,MAAM,UAAA,GAAa,MACjB,QAAA,CAAS,EAAE,MAAM,KAAA,EAAO,SAAA,EAAW,cAAc,CAAA;AAEnD,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,QAAA;AAAA,IACA;AAAA,MACE,WAAA;AAAA,MACA,UAAA;AAAA,MACA,WAAA;AAAA,MACA;AAAA;AACF,GACF;AACF;;;;"}
+{"version":3,"file":"create-state.mjs","sourceRoot":"","sources":["../../src/utils/create-state.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAarD,MAAM,OAAO,GAAG,CAAK,KAAQ,EAAE,MAAiB,EAAK,EAAE;IACrD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,SAAS,CAAC;QAE1B,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,YAAe,EAUf,EAAE;IACF,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,GAAG,aAAa,CACtD,OAAO,EACP,YAAY,CACb,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,QAAwB,EAAK,EAAE,CAClD,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,CAAC,SAAY,EAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAE3E,MAAM,UAAU,GAAG,GAAM,EAAE,CACzB,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;IAErD,OAAO;QACL,KAAK;QACL,QAAQ;QACR;YACE,WAAW;YACX,UAAU;YACV,WAAW;YACX,YAAY;SACb;KACO,CAAC;AACb,CAAC,CAAC"}

package/dist/utils/index.mjs

@@ -1,6 +1,6 @@
-export { collectToArray } from './collect-to-array.mjs';
-export { createBooleanState } from './create-boolean-state.mjs';
-export { createEventEmitter, createValueEmitter } from './create-event-emitter.mjs';
-export { createReducer } from './create-reducer.mjs';
-export { createState } from './create-state.mjs';
-//# sourceMappingURL=index.mjs.map
+export * from './collect-to-array.mjs';
+export * from './create-boolean-state.mjs';
+export * from './create-event-emitter.mjs';
+export * from './create-reducer.mjs';
+export * from './create-state.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/utils/index.mts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synstate",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Type-safe State Management Library for TypeScript/JavaScript",
   "repository": {
     "type": "git",
@@ -29,30 +29,31 @@
     "LICENSE"
   ],
   "dependencies": {
-    "ts-data-forge": "^14.5.0",
+    "ts-data-forge": "^14.7.0",
+    "ts-std-forge": "^0.5.0",
     "ts-type-forge": "^9.2.2"
   },
   "devDependencies": {
     "@reduxjs/toolkit": "2.12.0",
+    "@sumi-lang/cli": "0.0.1",
     "@types/react": "19.2.18",
     "@vitest/browser-playwright": "4.1.11",
-    "argparse": "3.0.0",
-    "eslint-config-typed": "5.10.0",
-    "eslint-plugin-ts-data-forge": "0.5.1",
-    "eslint-plugin-ts-fortress": "1.0.5",
-    "eslint-plugin-ts-type-forge": "0.7.1",
-    "jotai": "2.20.2",
+    "argparse": "3.0.1",
+    "eslint-config-typed": "5.11.6",
+    "eslint-plugin-ts-data-forge": "0.7.3",
+    "eslint-plugin-ts-fortress": "1.2.2",
+    "eslint-plugin-ts-type-forge": "0.8.3",
+    "jotai": "2.20.3",
     "mobx": "7.0.3",
     "playwright": "1.62.1",
     "prettier": "3.9.6",
     "prettier-plugin-organize-imports": "4.3.0",
     "prettier-plugin-packagejson": "3.0.2",
     "react": "19.2.8",
-    "rollup": "4.62.4",
     "rxjs": "7.8.2",
-    "synstate-react-hooks": "3.0.0",
-    "synstate-react-hooks-compat": "3.0.0",
-    "ts-repo-utils": "10.3.2",
+    "synstate-react-hooks": "3.0.2",
+    "synstate-react-hooks-compat": "3.0.2",
+    "ts-repo-utils": "10.6.1",
     "valtio": "2.3.2",
     "zustand": "5.0.15"
   },
@@ -83,6 +84,7 @@
     "gi:src": "tsx --tsconfig ../../tools/configs/tsconfig.tsx.json ../../libs/ts-repo-utils/src/cmd/gen-index-ts.mts ./src --index-ext .mts --export-ext .mjs --target-ext .mts --target-ext .tsx --exclude entry-point.mts --exclude \"core/base/**\" --exclude \"core/utils/**\"",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
+    "sumi:check": "tsx --tsconfig ../../tools/configs/tsconfig.tsx.json ../../languages/sumi/cli/src/cmd/sumi.mts check ./tsconfig.sumi.json",
     "test": "pnpm run z:vitest:node run",
     "test:browser": "pnpm run z:vitest --project='Browser' run",
     "test:cov": "pnpm run z:vitest:node run --coverage",

package/src/core/base/create-child-observable.mts

@@ -1,4 +1,5 @@
 import { Arr, type Optional, type Some } from 'ts-data-forge';
+import { panic } from 'ts-std-forge';
 import { type MutableSet } from 'ts-type-forge';
 import {
   isChildObservable,
@@ -270,7 +271,11 @@ const detectCircularDependency = (
 
   for (const parent of parents) {
     if (hasCircularDependencyFrom(parent, mut_visited, mut_inPath)) {
-      throw new Error(
+      // A programming error (invariant violation), not a recoverable
+      // failure. `panic` marks the error it throws, so the `Result` /
+      // `AsyncResult` boundaries rethrow it rather than turning an invariant
+      // violation into an `Err` a caller might handle (Sumi D-48 / D-53).
+      panic(
         'Circular dependency detected in observable graph: a child observable cannot be its own ancestor.',
       );
     }

package/src/core/base/create-observable-base.mts

@@ -1,4 +1,5 @@
 import { Arr, Optional } from 'ts-data-forge';
+import { unreachable } from 'ts-std-forge';
 import {
   type MutableMap,
   type MutableSet,
@@ -254,7 +255,13 @@ export const createTryUpdateNotImplemented = (): ((
 ) => void) => tryUpdateNotImplemented;
 
 const tryUpdateNotImplemented = (_updateToken: UpdateToken): void => {
-  throw new Error('not implemented');
+  // Not `todo()`: nothing here is waiting to be written. This is the base
+  // default of what was a base-class method, and every observable that can
+  // receive a parent update supplies its own `tryUpdate`; an observable with
+  // no parents never gets one. Reaching this is the invariant breaking, which
+  // is what `unreachable` says (Sumi D-48). There is no `never` value to
+  // hand it — the fact of the call is the error.
+  unreachable();
 };
 
 type AssembleObservableArgs<

package/src/core/types/observable-family.mts

@@ -61,10 +61,15 @@ export type ScanOperatorObservable<A, B> = InitializedSyncChildObservable<
 
 // SyncChildObservable
 
+// The helpers stay in a namespace so their names do not crowd the module
+// scope. A namespace holding only types is erasable, so it passes
+// `erasableSyntaxOnly` (TS1294); the `expectType` assertions are call
+// statements, which is why they sit below it rather than beside the types
+// they check.
 namespace SynStateInternals {
   type Cast<A> = A extends NonEmptyUnknownList ? A : never;
 
-  type EveryInitialized<OS extends NonEmptyTuple<Observable<unknown>>> =
+  export type EveryInitialized<OS extends NonEmptyTuple<Observable<unknown>>> =
     OS extends NonEmptyTuple<InitializedObservable<unknown>> ? true : false;
 
   type IsInitialized<O> = readonly [O] extends readonly [
@@ -84,41 +89,9 @@ namespace SynStateInternals {
     // union distribution
     LogicalValue<OS extends OS ? IsInitialized<OS> : never>;
 
-  type SomeInitialized<OS extends NonEmptyTuple<Observable<unknown>>> =
+  export type SomeInitialized<OS extends NonEmptyTuple<Observable<unknown>>> =
     SomeInitializedImpl<OS[number]>;
 
-  expectType<EveryInitialized<readonly [Observable<1>]>, false>('=');
-
-  expectType<EveryInitialized<readonly [InitializedObservable<1>]>, true>('=');
-
-  expectType<
-    EveryInitialized<
-      readonly [InitializedObservable<1>, InitializedObservable<2>]
-    >,
-    true
-  >('=');
-
-  expectType<
-    EveryInitialized<readonly [Observable<1>, InitializedObservable<2>]>,
-    false
-  >('=');
-
-  expectType<SomeInitialized<readonly [Observable<1>]>, false>('=');
-
-  expectType<SomeInitialized<readonly [InitializedObservable<1>]>, true>('=');
-
-  expectType<
-    SomeInitialized<
-      readonly [InitializedObservable<1>, InitializedObservable<2>]
-    >,
-    true
-  >('=');
-
-  expectType<
-    SomeInitialized<readonly [Observable<1>, InitializedObservable<2>]>,
-    true
-  >('=');
-
   type InitializedCombineObservableImpl<A extends NonEmptyUnknownList> =
     InitializedSyncChildObservable<A, A>;
 
@@ -159,6 +132,52 @@ namespace SynStateInternals {
       : MergeObservableImpl<Unwrap<OS>>;
 }
 
+expectType<SynStateInternals.EveryInitialized<readonly [Observable<1>]>, false>(
+  '=',
+);
+
+expectType<
+  SynStateInternals.EveryInitialized<readonly [InitializedObservable<1>]>,
+  true
+>('=');
+
+expectType<
+  SynStateInternals.EveryInitialized<
+    readonly [InitializedObservable<1>, InitializedObservable<2>]
+  >,
+  true
+>('=');
+
+expectType<
+  SynStateInternals.EveryInitialized<
+    readonly [Observable<1>, InitializedObservable<2>]
+  >,
+  false
+>('=');
+
+expectType<SynStateInternals.SomeInitialized<readonly [Observable<1>]>, false>(
+  '=',
+);
+
+expectType<
+  SynStateInternals.SomeInitialized<readonly [InitializedObservable<1>]>,
+  true
+>('=');
+
+expectType<
+  SynStateInternals.SomeInitialized<
+    readonly [InitializedObservable<1>, InitializedObservable<2>]
+  >,
+  true
+>('=');
+
+expectType<
+  SynStateInternals.SomeInitialized<
+    readonly [Observable<1>, InitializedObservable<2>]
+  >,
+  true
+>('=');
+
 export type CombineObservable<A extends NonEmptyUnknownList> =
   SynStateInternals.CombineObservableImpl<A>;
 

package/src/core/types/timer.mts

@@ -1,2 +1,11 @@
-// Timer types for Node.js/Browser compatibility
-export type TimerId = ReturnType<typeof setTimeout>;
+/**
+ * Timer handle for Node.js / browser compatibility.
+ *
+ * Defined by what `clearTimeout` accepts rather than by what `setTimeout`
+ * returns. The two are not the same type under the strict standard library:
+ * `setTimeout` there returns `{} | null`, which `clearTimeout`'s
+ * `number | undefined` parameter rejects. Every use of this type here is a
+ * handle on its way to `clearTimeout` / `clearInterval`, so the consumer's
+ * side is the one that has to fit.
+ */
+export type TimerId = NonNullable<Parameters<typeof clearTimeout>[0]>;