synstate-dom 0.3.0 → 0.4.0

package/dist/constant/derive.d.mts

@@ -6,7 +6,8 @@ import type { Bindable, BindableValue } from './bindable.mjs';
  * When every input is a constant, `fn` runs once and the result is a constant:
  * a static part of the view never enters the graph. Otherwise the constants
  * become `just` and the views are turned into observables, and the result is
- * `combine(...).pipe(map(...))`.
+ * synstate's `derive` over them: one observable, which passes on a result only
+ * when it is not `Object.is` the one it holds.
  */
 export declare const derive: <const BS extends NonEmptyTuple<Bindable<unknown>>, R>(bindables: BS, fn: (...values: BindableValues<BS>) => R) => Bindable<R>;
 /** The value types of a tuple of {@link Bindable}s, position by position. */

package/dist/constant/derive.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"derive.d.mts","sourceRoot":"","sources":["../../src/constant/derive.mts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG9D;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,aAC9D,EAAE,MACT,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,KACvC,QAAQ,CAAC,CAAC,CAmBZ,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,cAAc,CAAC,EAAE,SAAS,SAAS,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC;KAC5E,CAAC,IAAI,MAAM,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC,CAAC"}
+{"version":3,"file":"derive.d.mts","sourceRoot":"","sources":["../../src/constant/derive.mts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG9D;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,aAC9D,EAAE,MACT,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,KACvC,QAAQ,CAAC,CAAC,CAkBZ,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,cAAc,CAAC,EAAE,SAAS,SAAS,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC;KAC5E,CAAC,IAAI,MAAM,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC,CAAC"}

package/dist/constant/derive.mjs

@@ -1,4 +1,4 @@
-import { combine, isObservable, map, } from 'synstate';
+import { derive as deriveObservable, isObservable, } from 'synstate';
 import { Arr } from 'ts-data-forge';
 import { asConstant, isView } from '../internal/index.mjs';
 import { toObservable } from './to-observable.mjs';
@@ -10,19 +10,19 @@ import { toObservable } from './to-observable.mjs';
 
 
 
+
 export const derive = (bindables, fn) => {
 
 
 
 
-    const apply = (values) => 
 
-    fn(...values);
+    const project = fn;
     if (Arr.every(bindables, isConstant)) {
-        return asConstant(apply(bindables));
+        return asConstant(project(...bindables));
     }
     const observables = Arr.map(bindables, toObservable);
-    return combine(observables).pipe(map(apply));
+    return deriveObservable(observables, project);
 };
 const isConstant = (bindable) => !isView(bindable) && !isObservable(bindable);
 //# sourceMappingURL=derive.mjs.map

package/dist/constant/derive.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"derive.mjs","sourceRoot":"","sources":["../../src/constant/derive.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,YAAY,EACZ,GAAG,GAEJ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,SAAa,EACb,EAAwC,EAC3B,EAAE;IACf,0EAA0E;IAC1E,2EAA2E;IAC3E,wEAAwE;IACxE,oDAAoD;IACpD,MAAM,KAAK,GAAG,CAAC,MAA0B,EAAK,EAAE;IAC9C,iFAAiF;IACjF,EAAE,CAAC,GAAI,MAA6B,CAAC,CAAC;IAExC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,WAAW,GAAkD,GAAG,CAAC,GAAG,CACxE,SAAS,EACT,YAAY,CACb,CAAC;IAEF,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC;AAOF,MAAM,UAAU,GAAG,CAAC,QAA2B,EAAW,EAAE,CAC1D,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"derive.mjs","sourceRoot":"","sources":["../../src/constant/derive.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,gBAAgB,EAC1B,YAAY,GAEb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,SAAa,EACb,EAAwC,EAC3B,EAAE;IACf,oEAAoE;IACpE,wEAAwE;IACxE,wEAAwE;IACxE,oCAAoC;IACpC,iFAAiF;IACjF,MAAM,OAAO,GAAG,EAA0C,CAAC;IAE3D,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,WAAW,GAAkD,GAAG,CAAC,GAAG,CACxE,SAAS,EACT,YAAY,CACb,CAAC;IAEF,OAAO,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC,CAAC;AAOF,MAAM,UAAU,GAAG,CAAC,QAA2B,EAAW,EAAE,CAC1D,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synstate-dom",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Compiler-free fine-grained UI library that binds synstate observables directly to the DOM",
   "repository": {
     "type": "git",
@@ -44,24 +44,24 @@
   },
   "devDependencies": {
     "@vitest/browser-playwright": "5.0.5",
-    "eslint-config-typed": "5.19.2",
-    "eslint-plugin-ts-data-forge": "0.10.3",
-    "eslint-plugin-ts-fortress": "1.3.8",
-    "eslint-plugin-ts-type-forge": "0.8.13",
+    "eslint-config-typed": "5.20.1",
+    "eslint-plugin-ts-data-forge": "0.10.4",
+    "eslint-plugin-ts-fortress": "1.3.9",
+    "eslint-plugin-ts-type-forge": "0.8.14",
     "playwright": "1.64.1",
     "prettier": "3.9.10",
     "prettier-plugin-organize-imports": "4.3.0",
     "prettier-plugin-packagejson": "3.0.2",
-    "synstate": "6.0.0",
+    "synstate": "6.1.0",
     "ts-data-forge": "14.10.0",
     "ts-repo-utils": "10.7.1"
   },
   "peerDependencies": {
-    "synstate": ">=6.0.0",
+    "synstate": ">=6.1.0",
     "ts-data-forge": ">=14.10.0"
   },
   "engines": {
-    "node": ">=22.22.2",
+    "node": ">=22.23.4",
     "pnpm": ">=9.0.0"
   },
   "publishConfig": {

package/src/constant/derive.mts

@@ -1,7 +1,6 @@
 import {
-  combine,
+  derive as deriveObservable,
   isObservable,
-  map,
   type InitializedObservable,
 } from 'synstate';
 import { Arr } from 'ts-data-forge';
@@ -16,22 +15,22 @@ import { toObservable } from './to-observable.mjs';
  * When every input is a constant, `fn` runs once and the result is a constant:
  * a static part of the view never enters the graph. Otherwise the constants
  * become `just` and the views are turned into observables, and the result is
- * `combine(...).pipe(map(...))`.
+ * synstate's `derive` over them: one observable, which passes on a result only
+ * when it is not `Object.is` the one it holds.
  */
 export const derive = <const BS extends NonEmptyTuple<Bindable<unknown>>, R>(
   bindables: BS,
   fn: (...values: BindableValues<BS>) => R,
 ): Bindable<R> => {
-  // `values` holds, position by position, the value of each of `bindables`:
-  // the constants themselves, or what `combine` emits for their observables.
-  // The checker cannot follow a position through `Arr.map` and `combine`,
-  // which carry one element type for the whole tuple.
-  const apply = (values: readonly unknown[]): R =>
-    // eslint-disable-next-line total-functions/no-unsafe-type-assertion -- see above
-    fn(...(values as BindableValues<BS>));
+  // `fn` is called with the value of each of `bindables`, position by
+  // position: the constants themselves, or their observables' values. The
+  // checker cannot follow a position through `Arr.map`, which carries one
+  // element type for the whole tuple.
+  // eslint-disable-next-line total-functions/no-unsafe-type-assertion -- see above
+  const project = fn as (...values: readonly unknown[]) => R;
 
   if (Arr.every(bindables, isConstant)) {
-    return asConstant(apply(bindables));
+    return asConstant(project(...bindables));
   }
 
   const observables: NonEmptyTuple<InitializedObservable<unknown>> = Arr.map(
@@ -39,7 +38,7 @@ export const derive = <const BS extends NonEmptyTuple<Bindable<unknown>>, R>(
     toObservable,
   );
 
-  return combine(observables).pipe(map(apply));
+  return deriveObservable(observables, project);
 };
 
 /** The value types of a tuple of {@link Bindable}s, position by position. */

package/src/constant/derive.test.mts

@@ -1,4 +1,4 @@
-import { createState, isObservable } from 'synstate';
+import { createState, isChildObservable, isObservable } from 'synstate';
 import { expectType } from 'ts-data-forge';
 import type { Bindable } from './bindable.mjs';
 import { constant } from './constant.mjs';
@@ -61,4 +61,28 @@ describe(derive, () => {
 
     assert.strictEqual(result$.getSnapshot().value, '2-B');
   });
+
+  test('observables give one observable, whose parents are the inputs', () => {
+    const [a$, setA] = createState(1);
+
+    const [b$] = createState(2);
+
+    const fn = vi.fn((a: number, b: number) => a + b);
+
+    const result = derive([a$, b$], fn);
+
+    const result$ = toObservable(result);
+
+    assert.isTrue(isChildObservable(result$));
+
+    if (isChildObservable(result$)) {
+      assert.deepStrictEqual(result$.parents, [a$, b$]);
+    }
+
+    setA(2);
+
+    assert.strictEqual(result$.getSnapshot().value, 4);
+
+    expect(fn).toHaveBeenCalledTimes(2);
+  });
 });