synstate 0.1.1 → 1.0.0

package/dist/core/utils/id-maker.d.mts

@@ -1,5 +1,5 @@
-import { type ObservableId, type SubscriberId, type UpdaterSymbol } from '../types/index.mjs';
+import { type ObservableId, type SubscriberId, type UpdateToken } from '../types/index.mjs';
 export declare const issueObservableId: () => ObservableId;
 export declare const issueSubscriberId: () => SubscriberId;
-export declare const issueUpdaterSymbol: () => UpdaterSymbol;
+export declare const issueUpdateToken: () => UpdateToken;
 //# sourceMappingURL=id-maker.d.mts.map

package/dist/core/utils/id-maker.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"id-maker.d.mts","sourceRoot":"","sources":["../../../src/core/utils/id-maker.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAmB5B,eAAO,MAAM,iBAAiB,QAAO,YACL,CAAC;AAEjC,eAAO,MAAM,iBAAiB,QAAO,YACL,CAAC;AAEjC,eAAO,MAAM,kBAAkB,QAAO,aACL,CAAC"}
+{"version":3,"file":"id-maker.d.mts","sourceRoot":"","sources":["../../../src/core/utils/id-maker.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAmB5B,eAAO,MAAM,iBAAiB,QAAO,YACL,CAAC;AAEjC,eAAO,MAAM,iBAAiB,QAAO,YACL,CAAC;AAEjC,eAAO,MAAM,gBAAgB,QAAO,WACL,CAAC"}

package/dist/core/utils/id-maker.mjs

@@ -8,10 +8,10 @@ function* idMaker() {
 }
 const observableIdMaker = idMaker();
 const subscriberIdMaker = idMaker();
-const updaterSymbolMaker = idMaker();
+const updateTokenMaker = idMaker();
 const issueObservableId = () => observableIdMaker.next().value;
 const issueSubscriberId = () => subscriberIdMaker.next().value;
-const issueUpdaterSymbol = () => updaterSymbolMaker.next().value;
+const issueUpdateToken = () => updateTokenMaker.next().value;
 
-export { issueObservableId, issueSubscriberId, issueUpdaterSymbol };
+export { issueObservableId, issueSubscriberId, issueUpdateToken };
 //# sourceMappingURL=id-maker.mjs.map

package/dist/core/utils/id-maker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"id-maker.mjs","sources":["../../../src/core/utils/id-maker.mts"],"sourcesContent":[null],"names":[],"mappings":"AAMA,UAAU,OAAO,GAAA;IACf,IAAI,KAAK,GAAG,CAAC;IAEb,OAAO,IAAI,EAAE;;AAEX,QAAA,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAM;QAEnC,KAAK,IAAI,CAAC;IACZ;AACF;AAEA,MAAM,iBAAiB,GAAG,OAAO,EAAgB;AAEjD,MAAM,iBAAiB,GAAG,OAAO,EAAgB;AAEjD,MAAM,kBAAkB,GAAG,OAAO,EAAiB;AAE5C,MAAM,iBAAiB,GAAG,MAC/B,iBAAiB,CAAC,IAAI,EAAE,CAAC;AAEpB,MAAM,iBAAiB,GAAG,MAC/B,iBAAiB,CAAC,IAAI,EAAE,CAAC;AAEpB,MAAM,kBAAkB,GAAG,MAChC,kBAAkB,CAAC,IAAI,EAAE,CAAC;;;;"}
+{"version":3,"file":"id-maker.mjs","sources":["../../../src/core/utils/id-maker.mts"],"sourcesContent":[null],"names":[],"mappings":"AAMA,UAAU,OAAO,GAAA;IACf,IAAI,KAAK,GAAG,CAAC;IAEb,OAAO,IAAI,EAAE;;AAEX,QAAA,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAM;QAEnC,KAAK,IAAI,CAAC;IACZ;AACF;AAEA,MAAM,iBAAiB,GAAG,OAAO,EAAgB;AAEjD,MAAM,iBAAiB,GAAG,OAAO,EAAgB;AAEjD,MAAM,gBAAgB,GAAG,OAAO,EAAe;AAExC,MAAM,iBAAiB,GAAG,MAC/B,iBAAiB,CAAC,IAAI,EAAE,CAAC;AAEpB,MAAM,iBAAiB,GAAG,MAC/B,iBAAiB,CAAC,IAAI,EAAE,CAAC;AAEpB,MAAM,gBAAgB,GAAG,MAC9B,gBAAgB,CAAC,IAAI,EAAE,CAAC;;;;"}

package/dist/core/utils/index.mjs

@@ -1,4 +1,4 @@
-export { issueObservableId, issueSubscriberId, issueUpdaterSymbol } from './id-maker.mjs';
+export { issueObservableId, issueSubscriberId, issueUpdateToken } from './id-maker.mjs';
 export { maxDepth } from './max-depth.mjs';
 export { toSubscriber } from './observable-utils.mjs';
 export { binarySearch, halfInt } from './utils.mjs';

package/dist/entry-point.mjs

@@ -4,37 +4,46 @@ export { RootObservableClass } from './core/class/root-observable-class.mjs';
 export { combine, combineLatest } from './core/combine/combine.mjs';
 export { merge } from './core/combine/merge.mjs';
 export { zip } from './core/combine/zip.mjs';
-export { fromArray } from './core/create/from-array.mjs';
+export { counter } from './core/create/counter.mjs';
+export { fromAbortablePromise } from './core/create/from-abortable-promise.mjs';
 export { fromPromise } from './core/create/from-promise.mjs';
 export { fromSubscribable } from './core/create/from-subscribable.mjs';
-export { interval } from './core/create/interval.mjs';
-export { of } from './core/create/of.mjs';
-export { source, subject } from './core/create/source.mjs';
+export { just } from './core/create/just.mjs';
+export { source } from './core/create/source.mjs';
 export { timer } from './core/create/timer.mjs';
-export { auditTime } from './core/operators/audit-time.mjs';
-export { debounceTime } from './core/operators/debounce-time.mjs';
+export { audit } from './core/operators/audit.mjs';
+export { debounce } from './core/operators/debounce.mjs';
 export { filter } from './core/operators/filter.mjs';
-export { attachIndex, getKey, map, mapOptional, mapResultErr, mapResultOk, mapTo, mapWithIndex, pluck, unwrapOptional, unwrapResultErr, unwrapResultOk, withIndex } from './core/operators/map-with-index.mjs';
+export { map } from './core/operators/map.mjs';
 export { flatMap, mergeMap } from './core/operators/merge-map.mjs';
 export { pairwise } from './core/operators/pairwise.mjs';
 export { scan } from './core/operators/scan.mjs';
 export { distinctUntilChanged, skipIfNoChange } from './core/operators/skip-if-no-change.mjs';
 export { skipUntil } from './core/operators/skip-until.mjs';
-export { skip, skipWhile } from './core/operators/skip-while.mjs';
+export { skipWhile } from './core/operators/skip-while.mjs';
 export { switchMap } from './core/operators/switch-map.mjs';
 export { takeUntil } from './core/operators/take-until.mjs';
-export { take, takeWhile } from './core/operators/take-while.mjs';
-export { throttleTime } from './core/operators/throttle-time.mjs';
+export { takeWhile } from './core/operators/take-while.mjs';
+export { throttle } from './core/operators/throttle.mjs';
 export { withBuffered, withBufferedFrom } from './core/operators/with-buffered-from.mjs';
 export { withCurrentValueFrom, withLatestFrom } from './core/operators/with-current-value-from.mjs';
 export { withInitialValue } from './core/operators/with-initial-value.mjs';
+export { attachIndex, withIndex } from './core/predefined/operators/attach-index.mjs';
+export { mapOptional } from './core/predefined/operators/map-optional.mjs';
+export { mapResultErr } from './core/predefined/operators/map-result-err.mjs';
+export { mapResultOk } from './core/predefined/operators/map-result-ok.mjs';
+export { mapTo } from './core/predefined/operators/map-to.mjs';
+export { getKey, pluck } from './core/predefined/operators/pluck.mjs';
+export { skip } from './core/predefined/operators/skip.mjs';
+export { take } from './core/predefined/operators/take.mjs';
+export { unwrapOptional } from './core/predefined/operators/unwrap-optional.mjs';
+export { unwrapResultErr } from './core/predefined/operators/unwrap-result-err.mjs';
+export { unwrapResultOk } from './core/predefined/operators/unwrap-result-ok.mjs';
 import 'ts-data-forge';
 export { isChildObservable, isManagerObservable, isRootObservable } from './core/types/observable.mjs';
-export { issueObservableId, issueSubscriberId, issueUpdaterSymbol } from './core/utils/id-maker.mjs';
-export { maxDepth } from './core/utils/max-depth.mjs';
-export { toSubscriber } from './core/utils/observable-utils.mjs';
-export { binarySearch, halfInt } from './core/utils/utils.mjs';
+export { collectToArray } from './utils/collect-to-array.mjs';
+export { createBooleanState } from './utils/create-boolean-state.mjs';
 export { createEventEmitter, createValueEmitter } from './utils/create-event-emitter.mjs';
 export { createReducer } from './utils/create-reducer.mjs';
-export { createBooleanState, createState } from './utils/create-state.mjs';
+export { createState } from './utils/create-state.mjs';
 //# sourceMappingURL=entry-point.mjs.map

package/dist/entry-point.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"entry-point.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"entry-point.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/globals.d.mts

@@ -1,4 +1 @@
 /// <reference types="ts-type-forge" />
-
-// Timer types for Node.js/Browser compatibility
-type TimerId = ReturnType<typeof setTimeout>;

package/dist/index.mjs

@@ -4,37 +4,46 @@ export { RootObservableClass } from './core/class/root-observable-class.mjs';
 export { combine, combineLatest } from './core/combine/combine.mjs';
 export { merge } from './core/combine/merge.mjs';
 export { zip } from './core/combine/zip.mjs';
-export { fromArray } from './core/create/from-array.mjs';
+export { counter } from './core/create/counter.mjs';
+export { fromAbortablePromise } from './core/create/from-abortable-promise.mjs';
 export { fromPromise } from './core/create/from-promise.mjs';
 export { fromSubscribable } from './core/create/from-subscribable.mjs';
-export { interval } from './core/create/interval.mjs';
-export { of } from './core/create/of.mjs';
-export { source, subject } from './core/create/source.mjs';
+export { just } from './core/create/just.mjs';
+export { source } from './core/create/source.mjs';
 export { timer } from './core/create/timer.mjs';
-export { auditTime } from './core/operators/audit-time.mjs';
-export { debounceTime } from './core/operators/debounce-time.mjs';
+export { audit } from './core/operators/audit.mjs';
+export { debounce } from './core/operators/debounce.mjs';
 export { filter } from './core/operators/filter.mjs';
-export { attachIndex, getKey, map, mapOptional, mapResultErr, mapResultOk, mapTo, mapWithIndex, pluck, unwrapOptional, unwrapResultErr, unwrapResultOk, withIndex } from './core/operators/map-with-index.mjs';
+export { map } from './core/operators/map.mjs';
 export { flatMap, mergeMap } from './core/operators/merge-map.mjs';
 export { pairwise } from './core/operators/pairwise.mjs';
 export { scan } from './core/operators/scan.mjs';
 export { distinctUntilChanged, skipIfNoChange } from './core/operators/skip-if-no-change.mjs';
 export { skipUntil } from './core/operators/skip-until.mjs';
-export { skip, skipWhile } from './core/operators/skip-while.mjs';
+export { skipWhile } from './core/operators/skip-while.mjs';
 export { switchMap } from './core/operators/switch-map.mjs';
 export { takeUntil } from './core/operators/take-until.mjs';
-export { take, takeWhile } from './core/operators/take-while.mjs';
-export { throttleTime } from './core/operators/throttle-time.mjs';
+export { takeWhile } from './core/operators/take-while.mjs';
+export { throttle } from './core/operators/throttle.mjs';
 export { withBuffered, withBufferedFrom } from './core/operators/with-buffered-from.mjs';
 export { withCurrentValueFrom, withLatestFrom } from './core/operators/with-current-value-from.mjs';
 export { withInitialValue } from './core/operators/with-initial-value.mjs';
+export { attachIndex, withIndex } from './core/predefined/operators/attach-index.mjs';
+export { mapOptional } from './core/predefined/operators/map-optional.mjs';
+export { mapResultErr } from './core/predefined/operators/map-result-err.mjs';
+export { mapResultOk } from './core/predefined/operators/map-result-ok.mjs';
+export { mapTo } from './core/predefined/operators/map-to.mjs';
+export { getKey, pluck } from './core/predefined/operators/pluck.mjs';
+export { skip } from './core/predefined/operators/skip.mjs';
+export { take } from './core/predefined/operators/take.mjs';
+export { unwrapOptional } from './core/predefined/operators/unwrap-optional.mjs';
+export { unwrapResultErr } from './core/predefined/operators/unwrap-result-err.mjs';
+export { unwrapResultOk } from './core/predefined/operators/unwrap-result-ok.mjs';
 import 'ts-data-forge';
 export { isChildObservable, isManagerObservable, isRootObservable } from './core/types/observable.mjs';
-export { issueObservableId, issueSubscriberId, issueUpdaterSymbol } from './core/utils/id-maker.mjs';
-export { maxDepth } from './core/utils/max-depth.mjs';
-export { toSubscriber } from './core/utils/observable-utils.mjs';
-export { binarySearch, halfInt } from './core/utils/utils.mjs';
+export { collectToArray } from './utils/collect-to-array.mjs';
+export { createBooleanState } from './utils/create-boolean-state.mjs';
 export { createEventEmitter, createValueEmitter } from './utils/create-event-emitter.mjs';
 export { createReducer } from './utils/create-reducer.mjs';
-export { createBooleanState, createState } from './utils/create-state.mjs';
+export { createState } from './utils/create-state.mjs';
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/utils/collect-to-array.d.mts

@@ -0,0 +1,3 @@
+import { type Observable } from '../core/index.mjs';
+export declare const collectToArray: <A>(observable: Observable<A>) => Promise<readonly A[]>;
+//# sourceMappingURL=collect-to-array.d.mts.map

package/dist/utils/collect-to-array.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-to-array.d.mts","sourceRoot":"","sources":["../../src/utils/collect-to-array.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,cAAc,GAAI,CAAC,EAC9B,YAAY,UAAU,CAAC,CAAC,CAAC,KACxB,OAAO,CAAC,SAAS,CAAC,EAAE,CAYnB,CAAC"}

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

@@ -0,0 +1,11 @@
+const collectToArray = (observable) => new Promise((resolve) => {
+    const mut_buffer = [];
+    observable.subscribe((value) => {
+        mut_buffer.push(value);
+    }, () => {
+        resolve(mut_buffer);
+    });
+});
+
+export { collectToArray };
+//# sourceMappingURL=collect-to-array.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collect-to-array.mjs","sources":["../../src/utils/collect-to-array.mts"],"sourcesContent":[null],"names":[],"mappings":"AAEO,MAAM,cAAc,GAAG,CAC5B,UAAyB,KAEzB,IAAI,OAAO,CAAe,CAAC,OAAO,KAAI;IACpC,MAAM,UAAU,GAAQ,EAAE;AAE1B,IAAA,UAAU,CAAC,SAAS,CAClB,CAAC,KAAK,KAAI;AACR,QAAA,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;IACxB,CAAC,EACD,MAAK;QACH,OAAO,CAAC,UAAU,CAAC;AACrB,IAAA,CAAC,CACF;AACH,CAAC;;;;"}

package/dist/utils/create-boolean-state.d.mts

@@ -0,0 +1,40 @@
+import { type InitializedObservable } from '../core/index.mjs';
+/**
+ * Creates a reactive boolean state with convenient methods for boolean operations.
+ * Extends `createState` with boolean-specific helpers like `toggle`, `setTrue`, and `setFalse`.
+ *
+ * @param initialState - The initial boolean value
+ * @returns A 2-element tuple: `[state, { setTrue, setFalse, toggle, setState, updateState, resetState, getSnapshot, initialState }]`
+ *
+ * @example
+ * ```ts
+ * import type * as React from 'react';
+ * import { createBooleanState } from 'synstate';
+ * import { useObservableValue } from 'synstate-react-hooks';
+ *
+ *     // Menu drawer open/close state.
+ *     // setTrue and setFalse can be passed directly as callbacks
+ *     // — no need to create wrapper functions like `() => setState(true)`.
+ *     const [menuOpen$, { setTrue: openMenu, setFalse: closeMenu }] =
+ *       createBooleanState(false);
+ *
+ *     const SampleComponent = (): React.JSX.Element => (
+ *       <MenuDrawer
+ *         open={useObservableValue(menuOpen$)}
+ *         onClose={closeMenu}
+ *         onOpen={openMenu}
+ *       />
+ *     );
+ * ```
+ */
+export declare const createBooleanState: (initialState: boolean) => readonly [state: InitializedObservable<boolean>, Readonly<{
+    setTrue: () => void;
+    setFalse: () => void;
+    setState: (next: boolean) => boolean;
+    toggle: () => boolean;
+    updateState: (updateFn: (prev: boolean) => boolean) => boolean;
+    resetState: () => boolean;
+    getSnapshot: () => boolean;
+    initialState: boolean;
+}>];
+//# sourceMappingURL=create-boolean-state.d.mts.map

package/dist/utils/create-boolean-state.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-boolean-state.d.mts","sourceRoot":"","sources":["../../src/utils/create-boolean-state.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,eAAO,MAAM,kBAAkB,GAC7B,cAAc,OAAO,KACpB,SAAS,CACV,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,EACrC,QAAQ,CAAC;IACP,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACrC,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,KAAK,OAAO,CAAC;IAC/D,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC,CAsBH,CAAC"}

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

@@ -0,0 +1,53 @@
+import { createState } from './create-state.mjs';
+
+/**
+ * Creates a reactive boolean state with convenient methods for boolean operations.
+ * Extends `createState` with boolean-specific helpers like `toggle`, `setTrue`, and `setFalse`.
+ *
+ * @param initialState - The initial boolean value
+ * @returns A 2-element tuple: `[state, { setTrue, setFalse, toggle, setState, updateState, resetState, getSnapshot, initialState }]`
+ *
+ * @example
+ * ```ts
+ * import type * as React from 'react';
+ * import { createBooleanState } from 'synstate';
+ * import { useObservableValue } from 'synstate-react-hooks';
+ *
+ *     // Menu drawer open/close state.
+ *     // setTrue and setFalse can be passed directly as callbacks
+ *     // — no need to create wrapper functions like `() => setState(true)`.
+ *     const [menuOpen$, { setTrue: openMenu, setFalse: closeMenu }] =
+ *       createBooleanState(false);
+ *
+ *     const SampleComponent = (): React.JSX.Element => (
+ *       <MenuDrawer
+ *         open={useObservableValue(menuOpen$)}
+ *         onClose={closeMenu}
+ *         onOpen={openMenu}
+ *       />
+ *     );
+ * ```
+ */
+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

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-boolean-state.mjs","sources":["../../src/utils/create-boolean-state.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;AAEI,MAAM,kBAAkB,GAAG,CAChC,YAAqB,KAanB;AACF,IAAA,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,GAC/D,WAAW,CAAC,YAAY,CAAC;IAE3B,OAAO;QACL,KAAK;AACL,QAAA;YACE,OAAO,EAAE,MAAK;gBACZ,QAAQ,CAAC,IAAI,CAAC;YAChB,CAAC;YACD,QAAQ,EAAE,MAAK;gBACb,QAAQ,CAAC,KAAK,CAAC;YACjB,CAAC;AACD,YAAA,MAAM,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACpC,QAAQ;YACR,WAAW;YACX,UAAU;YACV,WAAW;YACX,YAAY;AACb,SAAA;KACO;AACZ;;;;"}

package/dist/utils/create-event-emitter.d.mts

@@ -38,19 +38,19 @@ export declare const createEventEmitter: () => readonly [Observable<void>, () =>
  * ```ts
  * const [message$, emitMessage] = createValueEmitter<string>();
  *
- * const mut_history: string[] = [];
+ * const messageHistory: string[] = [];
  *
  * message$.subscribe((msg) => {
- *   mut_history.push(msg);
+ *   messageHistory.push(msg);
  * });
  *
  * emitMessage('Hello'); // logs: Hello
  *
- * assert.deepStrictEqual(mut_history, ['Hello']);
+ * assert.deepStrictEqual(messageHistory, ['Hello']);
  *
  * emitMessage('World');
  *
- * assert.deepStrictEqual(mut_history, ['Hello', 'World']);
+ * assert.deepStrictEqual(messageHistory, ['Hello', 'World']);
  * ```
  */
 export declare const createValueEmitter: <A>() => readonly [Observable<A>, (value: A) => void];

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

@@ -48,19 +48,19 @@ const createEventEmitter = () => {
  * ```ts
  * const [message$, emitMessage] = createValueEmitter<string>();
  *
- * const mut_history: string[] = [];
+ * const messageHistory: string[] = [];
  *
  * message$.subscribe((msg) => {
- *   mut_history.push(msg);
+ *   messageHistory.push(msg);
  * });
  *
  * emitMessage('Hello'); // logs: Hello
  *
- * assert.deepStrictEqual(mut_history, ['Hello']);
+ * assert.deepStrictEqual(messageHistory, ['Hello']);
  *
  * emitMessage('World');
  *
- * assert.deepStrictEqual(mut_history, ['Hello', 'World']);
+ * assert.deepStrictEqual(messageHistory, ['Hello', 'World']);
  * ```
  */
 const createValueEmitter = () => {

package/dist/utils/create-reducer.d.mts

@@ -7,7 +7,7 @@ import { type InitializedObservable } from '../core/index.mjs';
  * @template A - The type of actions
  * @param reducer - A pure function that takes current state and action, returns new state
  * @param initialState - The initial value of the state
- * @returns An object containing the state observable, dispatch function, and snapshot getter
+ * @returns A 3-element tuple: `[state, dispatch, { getSnapshot, initialState }]`
  *
  * @example
  * ```ts
@@ -23,24 +23,27 @@ import { type InitializedObservable } from '../core/index.mjs';
  *   0,
  * );
  *
- * const mut_history: number[] = [];
+ * const stateHistory: number[] = [];
  *
  * state.subscribe((value: number) => {
- *   mut_history.push(value);
+ *   stateHistory.push(value);
  * });
  *
- * assert.deepStrictEqual(mut_history, [0]);
+ * assert.deepStrictEqual(stateHistory, [0]);
  *
  * dispatch({ type: 'increment' }); // logs: 1
  *
- * assert.deepStrictEqual(mut_history, [0, 1]);
+ * assert.deepStrictEqual(stateHistory, [0, 1]);
  *
  * dispatch({ type: 'increment' });
  *
  * dispatch({ type: 'decrement' });
  *
- * assert.deepStrictEqual(mut_history, [0, 1, 2, 1]);
+ * assert.deepStrictEqual(stateHistory, [0, 1, 2, 1]);
  * ```
  */
-export declare const createReducer: <S, A>(reducer: Reducer<S, A>, initialState: S) => readonly [state: InitializedObservable<S>, dispatch: (action: A) => S, getSnapshot: () => S];
+export declare const createReducer: <S, A>(reducer: Reducer<S, A>, initialState: S) => readonly [state: InitializedObservable<S>, dispatch: (action: A) => S, Readonly<{
+    getSnapshot: () => S;
+    initialState: S;
+}>];
 //# sourceMappingURL=create-reducer.d.mts.map

package/dist/utils/create-reducer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"create-reducer.d.mts","sourceRoot":"","sources":["../../src/utils/create-reducer.mts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAChC,SAAS,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,cAAc,CAAC,KACd,SAAS,CACV,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAC1B,WAAW,EAAE,MAAM,CAAC,CAerB,CAAC"}
+{"version":3,"file":"create-reducer.d.mts","sourceRoot":"","sources":["../../src/utils/create-reducer.mts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAChC,SAAS,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,cAAc,CAAC,KACd,SAAS,CACV,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAC1B,QAAQ,CAAC;IACP,WAAW,EAAE,MAAM,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,CAAC;CACjB,CAAC,CAeH,CAAC"}

package/dist/utils/create-reducer.mjs

@@ -11,7 +11,7 @@ import { source } from '../core/create/source.mjs';
  * @template A - The type of actions
  * @param reducer - A pure function that takes current state and action, returns new state
  * @param initialState - The initial value of the state
- * @returns An object containing the state observable, dispatch function, and snapshot getter
+ * @returns A 3-element tuple: `[state, dispatch, { getSnapshot, initialState }]`
  *
  * @example
  * ```ts
@@ -27,23 +27,23 @@ import { source } from '../core/create/source.mjs';
  *   0,
  * );
  *
- * const mut_history: number[] = [];
+ * const stateHistory: number[] = [];
  *
  * state.subscribe((value: number) => {
- *   mut_history.push(value);
+ *   stateHistory.push(value);
  * });
  *
- * assert.deepStrictEqual(mut_history, [0]);
+ * assert.deepStrictEqual(stateHistory, [0]);
  *
  * dispatch({ type: 'increment' }); // logs: 1
  *
- * assert.deepStrictEqual(mut_history, [0, 1]);
+ * assert.deepStrictEqual(stateHistory, [0, 1]);
  *
  * dispatch({ type: 'increment' });
  *
  * dispatch({ type: 'decrement' });
  *
- * assert.deepStrictEqual(mut_history, [0, 1, 2, 1]);
+ * assert.deepStrictEqual(stateHistory, [0, 1, 2, 1]);
  * ```
  */
 const createReducer = (reducer, initialState) => {
@@ -54,7 +54,7 @@ const createReducer = (reducer, initialState) => {
         return nextState;
     };
     const getSnapshot = () => state.getSnapshot().value;
-    return [state, dispatch, getSnapshot];
+    return [state, dispatch, { getSnapshot, initialState }];
 };
 
 export { createReducer };

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

@@ -1 +1 @@
-{"version":3,"file":"create-reducer.mjs","sources":["../../src/utils/create-reducer.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CG;MACU,aAAa,GAAG,CAC3B,OAAsB,EACtB,YAAe,KAKb;AACF,IAAA,MAAM,KAAK,GAAG,MAAM,CAAI,YAAY,CAAC;AAErC,IAAA,MAAM,QAAQ,GAAG,CAAC,MAAS,KAAO;AAChC,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;AAE5D,QAAA,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;AAErB,QAAA,OAAO,SAAS;AAClB,IAAA,CAAC;IAED,MAAM,WAAW,GAAG,MAAS,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK;AAEtD,IAAA,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAU;AAChD;;;;"}
+{"version":3,"file":"create-reducer.mjs","sources":["../../src/utils/create-reducer.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CG;MACU,aAAa,GAAG,CAC3B,OAAsB,EACtB,YAAe,KAQb;AACF,IAAA,MAAM,KAAK,GAAG,MAAM,CAAI,YAAY,CAAC;AAErC,IAAA,MAAM,QAAQ,GAAG,CAAC,MAAS,KAAO;AAChC,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;AAE5D,QAAA,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;AAErB,QAAA,OAAO,SAAS;AAClB,IAAA,CAAC;IAED,MAAM,WAAW,GAAG,MAAS,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK;IAEtD,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAU;AAClE;;;;"}

package/dist/utils/create-state.d.mts

@@ -5,77 +5,37 @@ import { type InitializedObservable } from '../core/index.mjs';
  *
  * @template S - The type of the state
  * @param initialState - The initial value of the state
- * @returns An object containing the state observable and methods to manipulate it
+ * @returns A 3-element tuple: `[state, setState, { updateState, resetState, getSnapshot, initialState }]`
  *
  * @example
  * ```ts
  * const [state, setState, { updateState, resetState }] = createState(0);
  *
- * const mut_history: number[] = [];
+ * const stateHistory: number[] = [];
  *
  * state.subscribe((value: number) => {
- *   mut_history.push(value);
+ *   stateHistory.push(value);
  * });
  *
- * assert.deepStrictEqual(mut_history, [0]);
+ * assert.deepStrictEqual(stateHistory, [0]);
  *
  * setState(10); // logs: 10
  *
- * assert.deepStrictEqual(mut_history, [0, 10]);
+ * assert.deepStrictEqual(stateHistory, [0, 10]);
  *
  * updateState((prev: number) => prev + 1); // logs: 11
  *
- * assert.deepStrictEqual(mut_history, [0, 10, 11]);
+ * assert.deepStrictEqual(stateHistory, [0, 10, 11]);
  *
  * resetState(); // logs: 0
  *
- * assert.deepStrictEqual(mut_history, [0, 10, 11, 0]);
+ * assert.deepStrictEqual(stateHistory, [0, 10, 11, 0]);
  * ```
  */
 export declare const createState: <S>(initialState: S) => readonly [state: InitializedObservable<S>, setState: (v: S) => S, Readonly<{
     updateState: (updateFn: (prev: S) => S) => S;
     resetState: () => S;
     getSnapshot: () => S;
-}>];
-/**
- * Creates a reactive boolean state with convenient methods for boolean operations.
- * Extends `createState` with boolean-specific helpers like `toggle`, `setTrue`, and `setFalse`.
- *
- * @param initialState - The initial boolean value
- * @returns An object with the state observable and boolean-specific methods
- *
- * @example
- * ```ts
- * const [state, { setTrue, toggle }] = createBooleanState(false);
- *
- * const mut_history: boolean[] = [];
- *
- * state.subscribe((value: boolean) => {
- *   mut_history.push(value);
- * });
- *
- * assert.deepStrictEqual(mut_history, [false]);
- *
- * setTrue(); // logs: true
- *
- * assert.deepStrictEqual(mut_history, [false, true]);
- *
- * toggle(); // logs: false
- *
- * assert.deepStrictEqual(mut_history, [false, true, false]);
- *
- * toggle(); // logs: true
- *
- * assert.deepStrictEqual(mut_history, [false, true, false, true]);
- * ```
- */
-export declare const createBooleanState: (initialState: boolean) => readonly [state: InitializedObservable<boolean>, Readonly<{
-    setTrue: () => void;
-    setFalse: () => void;
-    setState: (next: boolean) => boolean;
-    toggle: () => boolean;
-    updateState: (updateFn: (prev: boolean) => boolean) => boolean;
-    resetState: () => boolean;
-    getSnapshot: () => boolean;
+    initialState: S;
 }>];
 //# sourceMappingURL=create-state.d.mts.map

package/dist/utils/create-state.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"create-state.d.mts","sourceRoot":"","sources":["../../src/utils/create-state.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAwB/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAC3B,cAAc,CAAC,KACd,SAAS,CACV,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACrB,QAAQ,CAAC;IACP,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,CAAC;CACtB,CAAC,CAwBH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,kBAAkB,GAC7B,cAAc,OAAO,KACpB,SAAS,CACV,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,EACrC,QAAQ,CAAC;IACP,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACrC,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,KAAK,OAAO,CAAC;IAC/D,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B,CAAC,CAqBH,CAAC"}
+{"version":3,"file":"create-state.d.mts","sourceRoot":"","sources":["../../src/utils/create-state.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAwB/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAC3B,cAAc,CAAC,KACd,SAAS,CACV,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACrB,QAAQ,CAAC;IACP,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,CAAC;CACjB,CAAC,CAyBH,CAAC"}