synstate 4.0.0 → 4.1.0

package/README.md

@@ -24,7 +24,7 @@
 - 🎯 **Simple State Management**: Easy-to-use `createState` and `createReducer` similar to React useState/useReducer for global state
 - ⚡ **High Performance**: Optimized for fast state updates and minimal re-renders
 - 🎨 **Type-Safe**: Full TypeScript support with precise type inference
-- 🚀 **Lightweight**: <!-- bundle-size:synstate -->~6 kB min+gzip<!-- /bundle-size:synstate --> with two external runtime dependencies ([ts-data-forge](https://www.npmjs.com/package/ts-data-forge) and [ts-std-forge](https://www.npmjs.com/package/ts-std-forge), and the first depends on the second)
+- 🚀 **Lightweight**: <!-- bundle-size:synstate -->~6.1 kB min+gzip<!-- /bundle-size:synstate --> with two external runtime dependencies ([ts-data-forge](https://www.npmjs.com/package/ts-data-forge) and [ts-std-forge](https://www.npmjs.com/package/ts-std-forge), and the first depends on the second)
 - 🌐 **Framework Agnostic**: Works with React, Vue, Svelte, or vanilla JavaScript
 - 🔄 **Reactive Updates**: Automatic propagation of state changes to all subscribers
 - 📡 **Event System**: Built-in `createValueEmitter`, `createEventEmitter` for event-driven architecture

package/dist/core/create/empty.d.mts

@@ -0,0 +1,32 @@
+import type { RootObservable } from '../types/index.mjs';
+/**
+ * Creates an Observable that holds no value and is already completed, so it
+ * never passes anything on (almost equivalent to RxJS `EMPTY`). Useful inside
+ * `switchMap` for the branch that should follow nothing, where a `source()`
+ * would offer a `next` that nothing calls.
+ *
+ * @template A - The type of the values it would carry
+ * @returns An Observable with no value that is already completed
+ *
+ * @example
+ * ```ts
+ * const nothing$ = empty<number>();
+ *
+ * const valueHistory: number[] = [];
+ *
+ * nothing$.subscribe(
+ *   (value) => {
+ *     valueHistory.push(value);
+ *   },
+ *   () => {
+ *     // onComplete — called immediately since empty() completes right away
+ *   },
+ * );
+ *
+ * assert.deepStrictEqual(valueHistory, []);
+ *
+ * assert.strictEqual(nothing$.isCompleted, true);
+ * ```
+ */
+export declare const empty: <A>() => RootObservable<A>;
+//# sourceMappingURL=empty.d.mts.map

package/dist/core/create/empty.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.d.mts","sourceRoot":"","sources":["../../../src/core/create/empty.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,OAAM,cAAc,CAAC,CAAC,CAQ5C,CAAC"}

package/dist/core/create/empty.mjs

@@ -0,0 +1,39 @@
+import { Optional } from 'ts-data-forge';
+import { RootObservableClass } from '../class/index.mjs';
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const empty = () => {
+    const obs = new RootObservableClass({
+        initialValue: Optional.none,
+    });
+    obs.complete();
+    return obs;
+};
+//# sourceMappingURL=empty.mjs.map

package/dist/core/create/empty.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.mjs","sourceRoot":"","sources":["../../../src/core/create/empty.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,GAA0B,EAAE;IAC/C,MAAM,GAAG,GAAG,IAAI,mBAAmB,CAAI;QACrC,YAAY,EAAE,QAAQ,CAAC,IAAI;KAC5B,CAAC,CAAC;IAEH,GAAG,CAAC,QAAQ,EAAE,CAAC;IAEf,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}

package/dist/core/create/index.d.mts

@@ -1,4 +1,5 @@
 export * from './counter.mjs';
+export * from './empty.mjs';
 export * from './from-abortable-promise.mjs';
 export * from './from-promise.mjs';
 export * from './from-subscribable.mjs';

package/dist/core/create/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/core/create/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/core/create/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/core/create/index.mjs

@@ -1,4 +1,5 @@
 export * from './counter.mjs';
+export * from './empty.mjs';
 export * from './from-abortable-promise.mjs';
 export * from './from-promise.mjs';
 export * from './from-subscribable.mjs';

package/dist/core/create/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/core/create/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/core/create/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synstate",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Type-safe State Management Library for TypeScript/JavaScript",
   "repository": {
     "type": "git",
@@ -29,20 +29,20 @@
     "LICENSE"
   ],
   "dependencies": {
-    "ts-data-forge": "^14.8.0",
-    "ts-std-forge": "^0.5.1",
+    "ts-data-forge": "^14.9.0",
+    "ts-std-forge": "^0.5.2",
     "ts-type-forge": "^9.2.2"
   },
   "devDependencies": {
     "@reduxjs/toolkit": "2.13.0",
-    "@sumi-lang/cli": "0.0.6",
+    "@sumi-lang/cli": "0.0.7",
     "@types/react": "19.3.0",
     "@vitest/browser-playwright": "5.0.3",
     "argparse": "3.0.2",
     "eslint-config-typed": "5.19.0",
-    "eslint-plugin-ts-data-forge": "0.9.0",
-    "eslint-plugin-ts-fortress": "1.3.4",
-    "eslint-plugin-ts-type-forge": "0.8.9",
+    "eslint-plugin-ts-data-forge": "0.10.0",
+    "eslint-plugin-ts-fortress": "1.3.5",
+    "eslint-plugin-ts-type-forge": "0.8.10",
     "jotai": "3.0.1",
     "mobx": "7.0.6",
     "playwright": "1.64.0",
@@ -51,8 +51,8 @@
     "prettier-plugin-packagejson": "3.0.2",
     "react": "19.3.0",
     "rxjs": "7.8.2",
-    "synstate-react-hooks": "4.0.0",
-    "synstate-react-hooks-compat": "4.0.0",
+    "synstate-react-hooks": "4.1.0",
+    "synstate-react-hooks-compat": "4.1.0",
     "ts-repo-utils": "10.7.1",
     "valtio": "2.3.2",
     "zustand": "5.0.15"

package/src/core/create/empty.mts

@@ -0,0 +1,42 @@
+import { Optional } from 'ts-data-forge';
+import { RootObservableClass } from '../class/index.mjs';
+import type { RootObservable } from '../types/index.mjs';
+
+/**
+ * Creates an Observable that holds no value and is already completed, so it
+ * never passes anything on (almost equivalent to RxJS `EMPTY`). Useful inside
+ * `switchMap` for the branch that should follow nothing, where a `source()`
+ * would offer a `next` that nothing calls.
+ *
+ * @template A - The type of the values it would carry
+ * @returns An Observable with no value that is already completed
+ *
+ * @example
+ * ```ts
+ * const nothing$ = empty<number>();
+ *
+ * const valueHistory: number[] = [];
+ *
+ * nothing$.subscribe(
+ *   (value) => {
+ *     valueHistory.push(value);
+ *   },
+ *   () => {
+ *     // onComplete — called immediately since empty() completes right away
+ *   },
+ * );
+ *
+ * assert.deepStrictEqual(valueHistory, []);
+ *
+ * assert.strictEqual(nothing$.isCompleted, true);
+ * ```
+ */
+export const empty = <A,>(): RootObservable<A> => {
+  const obs = new RootObservableClass<A>({
+    initialValue: Optional.none,
+  });
+
+  obs.complete();
+
+  return obs;
+};

package/src/core/create/empty.test.mts

@@ -0,0 +1,65 @@
+import { Arr, Optional } from 'ts-data-forge';
+import { createState } from '../../utils/index.mjs';
+import { switchMap } from '../operators/index.mjs';
+import { empty } from './empty.mjs';
+
+describe(empty, () => {
+  test('holds no value and is already completed', () => {
+    const nothing$ = empty<number>();
+
+    assert.isTrue(nothing$.isCompleted);
+
+    assert.isTrue(Optional.isNone(nothing$.getSnapshot()));
+  });
+
+  test('passes nothing on to a subscriber, and completes it at once', () => {
+    const nothing$ = empty<number>();
+
+    const mut_seen: number[] = [];
+
+    const mut_completed = { value: false };
+
+    nothing$.subscribe(
+      (value) => {
+        mut_seen.push(value);
+      },
+      () => {
+        mut_completed.value = true;
+      },
+    );
+
+    assert.deepStrictEqual(mut_seen, []);
+
+    assert.isTrue(mut_completed.value);
+  });
+
+  test('switched to, it passes nothing on, and switchMap goes on', () => {
+    const [on$, setOn] = createState(true);
+
+    const [count$, setCount] = createState(0);
+
+    const followed$ = on$.pipe(
+      switchMap((isOn) => (isOn ? count$ : empty<number>())),
+    );
+
+    const mut_seen: number[] = [];
+
+    followed$.subscribe((value) => {
+      mut_seen.push(value);
+    });
+
+    setOn(false);
+
+    const seenBefore = Arr.length(mut_seen);
+
+    setCount(1);
+
+    assert.strictEqual(Arr.length(mut_seen), seenBefore);
+
+    setOn(true);
+
+    assert.deepStrictEqual(Arr.last(mut_seen), Optional.some(1));
+
+    assert.isFalse(followed$.isCompleted);
+  });
+});

package/src/core/create/index.mts

@@ -1,4 +1,5 @@
 export * from './counter.mjs';
+export * from './empty.mjs';
 export * from './from-abortable-promise.mjs';
 export * from './from-promise.mjs';
 export * from './from-subscribable.mjs';