@pond-ts/react 0.5.5 → 0.5.6

package/dist/useCurrent.d.ts

@@ -26,6 +26,13 @@ export interface UseCurrentOptions extends UseSnapshotOptions {
  * Returns a stable-shape object while the source has no events (every
  * mapped field is `undefined`), so destructuring on first render is
  * safe.
+ *
+ * **Reference stability**: when a new event push leaves the reduce
+ * output structurally unchanged (same scalar values, same-length arrays
+ * with same elements), the previous result reference is returned
+ * unchanged. Downstream `useMemo([value])` and `useEffect([value])` only
+ * re-run when the value actually changes — no need for a manual
+ * `.slice()` or deep-compare equality helper at the call site.
  */
 export declare function useCurrent<S extends SeriesSchema, const Mapping extends AggregateMap<S>>(source: SnapshotSource<S> | LiveSource<S> | null, mapping: Mapping, options?: UseCurrentOptions): ReduceResult<S, Mapping>;
 //# sourceMappingURL=useCurrent.d.ts.map

package/dist/useCurrent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCurrent.d.ts","sourceRoot":"","sources":["../src/useCurrent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CACxB,CAAC,SAAS,YAAY,EACtB,KAAK,CAAC,OAAO,SAAS,YAAY,CAAC,CAAC,CAAC,EAErC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAe1B"}
+{"version":3,"file":"useCurrent.d.ts","sourceRoot":"","sources":["../src/useCurrent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAuED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CACxB,CAAC,SAAS,YAAY,EACtB,KAAK,CAAC,OAAO,SAAS,YAAY,CAAC,CAAC,CAAC,EAErC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CA8B1B"}

package/dist/useCurrent.js

@@ -1,5 +1,69 @@
-import { useMemo } from 'react';
+import { useMemo, useRef } from 'react';
 import { useSnapshot, } from './useSnapshot.js';
+/**
+ * Returns `true` if two array cells have identical length and
+ * elementwise-equal contents. Element types are always scalars (the
+ * reducer registry enforces this), so `===` per element is both
+ * correct and cheap for the sizes a dashboard produces.
+ */
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i += 1) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Field-level structural stabilization for a `useCurrent` result.
+ *
+ * Walks the next result keys and, for any field whose value is
+ * structurally equal to the previous render's value, reuses the
+ * previous reference. If every field reuses the previous reference
+ * AND the key set is unchanged, returns the previous top-level
+ * object as-is. Otherwise, returns a fresh object whose stable fields
+ * still carry their previous reference.
+ *
+ * Result: downstream `useMemo([current.host])` / `useEffect` keyed
+ * off a specific field only re-fire when that field changes — not
+ * when a sibling field changes, and not when a new event push leaves
+ * the aggregate unchanged.
+ */
+function stabilizeFields(prev, next) {
+    if (prev === null)
+        return next;
+    const prevKeys = Object.keys(prev);
+    const nextKeys = Object.keys(next);
+    if (prevKeys.length !== nextKeys.length)
+        return next;
+    const result = {};
+    let anyFieldChanged = false;
+    for (const key of nextKeys) {
+        if (!Object.prototype.hasOwnProperty.call(prev, key))
+            return next;
+        const prevValue = prev[key];
+        const nextValue = next[key];
+        if (prevValue === nextValue) {
+            result[key] = prevValue;
+            continue;
+        }
+        if (Array.isArray(prevValue) &&
+            Array.isArray(nextValue) &&
+            arraysEqual(prevValue, nextValue)) {
+            // Arrays with identical contents — reuse the previous reference
+            // so field-level dependency arrays stay stable.
+            result[key] = prevValue;
+            continue;
+        }
+        result[key] = nextValue;
+        anyFieldChanged = true;
+    }
+    // Every field reused the previous reference — return the original
+    // top-level object so the whole-result consumer (`useEffect([current])`)
+    // also stays stable.
+    return anyFieldChanged ? result : prev;
+}
 /**
  * Subscribe to a live source and return the current value of a reducer
  * mapping, updated on a throttle. Equivalent to
@@ -18,11 +82,19 @@ import { useSnapshot, } from './useSnapshot.js';
  * Returns a stable-shape object while the source has no events (every
  * mapped field is `undefined`), so destructuring on first render is
  * safe.
+ *
+ * **Reference stability**: when a new event push leaves the reduce
+ * output structurally unchanged (same scalar values, same-length arrays
+ * with same elements), the previous result reference is returned
+ * unchanged. Downstream `useMemo([value])` and `useEffect([value])` only
+ * re-run when the value actually changes — no need for a manual
+ * `.slice()` or deep-compare equality helper at the call site.
  */
 export function useCurrent(source, mapping, options) {
     const snap = useSnapshot(source, options);
     const tailOpt = options?.tail;
-    return useMemo(() => {
+    const previousResultRef = useRef(null);
+    const nextResult = useMemo(() => {
         if (!snap) {
             // Stable empty-shape result so destructuring never explodes on
             // first render.
@@ -34,5 +106,14 @@ export function useCurrent(source, mapping, options) {
         const scoped = tailOpt !== undefined ? snap.tail(tailOpt) : snap;
         return scoped.reduce(mapping);
     }, [snap, tailOpt, mapping]);
+    // Field-level structural stabilization. Every field whose value is
+    // unchanged reuses its previous reference; the top-level object
+    // reuses its reference when *all* fields are stable. Downstream
+    // `useMemo([current.host])` keyed off a specific field only re-runs
+    // when that field actually changes, and `useEffect([current])` keyed
+    // off the whole result only fires on true change.
+    const stabilized = stabilizeFields(previousResultRef.current, nextResult);
+    previousResultRef.current = stabilized;
+    return stabilized;
 }
 //# sourceMappingURL=useCurrent.js.map

package/dist/useCurrent.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCurrent.js","sourceRoot":"","sources":["../src/useCurrent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAQhC,OAAO,EACL,WAAW,GAGZ,MAAM,kBAAkB,CAAC;AAW1B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CAIxB,MAAgD,EAChD,OAAgB,EAChB,OAA2B;IAE3B,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,EAAE,IAAI,CAAC;IAE9B,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,+DAA+D;YAC/D,gBAAgB;YAChB,MAAM,KAAK,GAA4B,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YAC/D,OAAO,KAAiC,CAAC;QAC3C,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAA6B,CAAC;IAC5D,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"useCurrent.js","sourceRoot":"","sources":["../src/useCurrent.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pond-ts/react",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "React hooks for pond-ts live time series",
   "license": "MIT",
   "repository": {