@pond-ts/react 0.4.2 → 0.4.3

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export { useLiveSeries } from './useLiveSeries.js';
 export { useTimeSeries } from './useTimeSeries.js';
-export { useSnapshot, type UseSnapshotOptions } from './useSnapshot.js';
+export { useSnapshot, type UseSnapshotOptions, type SnapshotSource, } from './useSnapshot.js';
 export { useWindow } from './useWindow.js';
 export { useDerived } from './useDerived.js';
+export { useLiveQuery } from './useLiveQuery.js';
+export { useLatest } from './useLatest.js';
 export { takeSnapshot } from './takeSnapshot.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,8 +1,10 @@
 // @pond-ts/react — React hooks for pond-ts live time series
 export { useLiveSeries } from './useLiveSeries.js';
 export { useTimeSeries } from './useTimeSeries.js';
-export { useSnapshot } from './useSnapshot.js';
+export { useSnapshot, } from './useSnapshot.js';
 export { useWindow } from './useWindow.js';
 export { useDerived } from './useDerived.js';
+export { useLiveQuery } from './useLiveQuery.js';
+export { useLatest } from './useLatest.js';
 export { takeSnapshot } from './takeSnapshot.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,WAAW,GAGZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/useLatest.d.ts

@@ -0,0 +1,19 @@
+import type { EventForSchema, LiveSource, SeriesSchema } from 'pond-ts';
+import type { SnapshotSource, UseSnapshotOptions } from './useSnapshot.js';
+/**
+ * Subscribe to a live source and return only the latest event.
+ *
+ * Many dashboard stats only need the most recent value — current CPU, latest
+ * count, last price. Building a full `TimeSeries` snapshot for a single event
+ * is wasteful. `useLatest` returns just the last event, throttled like
+ * `useSnapshot`:
+ *
+ * ```ts
+ * const latest = useLatest(live);
+ * // latest?.get('cpu')  → number
+ * ```
+ *
+ * Returns `null` when the source is empty or `null`.
+ */
+export declare function useLatest<S extends SeriesSchema>(source: SnapshotSource<S> | LiveSource<S> | null, options?: UseSnapshotOptions): EventForSchema<S> | null;
+//# sourceMappingURL=useLatest.d.ts.map

package/dist/useLatest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLatest.d.ts","sourceRoot":"","sources":["../src/useLatest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,YAAY,EAC9C,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,EAChD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAyD1B"}

package/dist/useLatest.js

@@ -0,0 +1,69 @@
+import { useEffect, useRef, useState } from 'react';
+/**
+ * Subscribe to a live source and return only the latest event.
+ *
+ * Many dashboard stats only need the most recent value — current CPU, latest
+ * count, last price. Building a full `TimeSeries` snapshot for a single event
+ * is wasteful. `useLatest` returns just the last event, throttled like
+ * `useSnapshot`:
+ *
+ * ```ts
+ * const latest = useLatest(live);
+ * // latest?.get('cpu')  → number
+ * ```
+ *
+ * Returns `null` when the source is empty or `null`.
+ */
+export function useLatest(source, options) {
+    const throttleMs = options?.throttle ?? 100;
+    const [latest, setLatest] = useState(() => {
+        if (!source || source.length === 0)
+            return null;
+        return source.at(source.length - 1);
+    });
+    const sourceRef = useRef(source);
+    sourceRef.current = source;
+    useEffect(() => {
+        if (!source) {
+            setLatest(null);
+            return;
+        }
+        // Re-read on source change
+        if (source.length > 0) {
+            setLatest(source.at(source.length - 1));
+        }
+        else {
+            setLatest(null);
+        }
+        let timer = null;
+        let pending = false;
+        const flush = () => {
+            timer = null;
+            pending = false;
+            const s = sourceRef.current;
+            if (s && s.length > 0) {
+                setLatest(s.at(s.length - 1));
+            }
+        };
+        const unsub = source.on('event', () => {
+            if (throttleMs === 0) {
+                const s = sourceRef.current;
+                if (s && s.length > 0) {
+                    setLatest(s.at(s.length - 1));
+                }
+                return;
+            }
+            if (!pending) {
+                pending = true;
+                timer = setTimeout(flush, throttleMs);
+            }
+        });
+        return () => {
+            unsub();
+            if (timer !== null)
+                clearTimeout(timer);
+        };
+    }, [source, throttleMs]);
+    return latest;
+}
+//# sourceMappingURL=useLatest.js.map

package/dist/useLatest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLatest.js","sourceRoot":"","sources":["../src/useLatest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIpD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CACvB,MAAgD,EAChD,OAA4B;IAE5B,MAAM,UAAU,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;IAE5C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAA2B,GAAG,EAAE;QAClE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,OAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAsB,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,2BAA2B;QAC3B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAsB,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,KAAK,GAAyC,IAAI,CAAC;QACvD,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,GAAG,KAAK,CAAC;YAChB,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAsB,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACpC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;gBAC5B,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtB,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAsB,CAAC,CAAC;gBACrD,CAAC;gBACD,OAAO;YACT,CAAC;YACD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/useLiveQuery.d.ts

@@ -0,0 +1,31 @@
+import type { LiveSource, SeriesSchema, TimeSeries } from 'pond-ts';
+import { type SnapshotSource, type UseSnapshotOptions } from './useSnapshot.js';
+/**
+ * Build a derived live view once, subscribe, and return both the view and a
+ * throttled snapshot — combining `useMemo` + `useSnapshot` in one call.
+ *
+ * Typical dashboard code creates 5–10 derived views (filters, aggregations,
+ * rolling windows). Without this hook each one needs a manual `useMemo` for
+ * stability plus a separate `useSnapshot` for subscription. `useLiveQuery`
+ * bundles that into a single call whose return shape matches `useLiveSeries`:
+ *
+ * ```ts
+ * const [, rollingSnap] = useLiveQuery(
+ *   () => live.rolling('1m', { cpu: 'avg' }),
+ *   [live],
+ *   { throttle: 200 },
+ * );
+ *
+ * const [highCpu, highCpuSnap] = useLiveQuery(
+ *   () => live.filter((e) => e.get('cpu') > 0.7),
+ *   [live],
+ * );
+ * ```
+ *
+ * @param build  Factory that creates the live view. Called once per `deps` change.
+ * @param deps   React dependency array — when any dep changes, the view is rebuilt.
+ * @param options  Snapshot throttle options (default 100 ms).
+ * @returns `[view, snapshot]` — the stable view and its throttled `TimeSeries`.
+ */
+export declare function useLiveQuery<T extends SnapshotSource<S> | LiveSource<S>, S extends SeriesSchema = T extends SnapshotSource<infer U> ? U : T extends LiveSource<infer V> ? V : SeriesSchema>(build: () => T, deps: readonly unknown[], options?: UseSnapshotOptions): [T, TimeSeries<S> | null];
+//# sourceMappingURL=useLiveQuery.d.ts.map

package/dist/useLiveQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveQuery.d.ts","sourceRoot":"","sources":["../src/useLiveQuery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAC1B,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAC3C,CAAC,SAAS,YAAY,GAAG,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,CAAC,GACtD,CAAC,GACD,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAC3B,CAAC,GACD,YAAY,EAElB,KAAK,EAAE,MAAM,CAAC,EACd,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAK3B"}

package/dist/useLiveQuery.js

@@ -0,0 +1,36 @@
+import { useMemo } from 'react';
+import { useSnapshot, } from './useSnapshot.js';
+/**
+ * Build a derived live view once, subscribe, and return both the view and a
+ * throttled snapshot — combining `useMemo` + `useSnapshot` in one call.
+ *
+ * Typical dashboard code creates 5–10 derived views (filters, aggregations,
+ * rolling windows). Without this hook each one needs a manual `useMemo` for
+ * stability plus a separate `useSnapshot` for subscription. `useLiveQuery`
+ * bundles that into a single call whose return shape matches `useLiveSeries`:
+ *
+ * ```ts
+ * const [, rollingSnap] = useLiveQuery(
+ *   () => live.rolling('1m', { cpu: 'avg' }),
+ *   [live],
+ *   { throttle: 200 },
+ * );
+ *
+ * const [highCpu, highCpuSnap] = useLiveQuery(
+ *   () => live.filter((e) => e.get('cpu') > 0.7),
+ *   [live],
+ * );
+ * ```
+ *
+ * @param build  Factory that creates the live view. Called once per `deps` change.
+ * @param deps   React dependency array — when any dep changes, the view is rebuilt.
+ * @param options  Snapshot throttle options (default 100 ms).
+ * @returns `[view, snapshot]` — the stable view and its throttled `TimeSeries`.
+ */
+export function useLiveQuery(build, deps, options) {
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    const view = useMemo(build, deps);
+    const snapshot = useSnapshot(view, options);
+    return [view, snapshot];
+}
+//# sourceMappingURL=useLiveQuery.js.map

package/dist/useLiveQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveQuery.js","sourceRoot":"","sources":["../src/useLiveQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EACL,WAAW,GAGZ,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,YAAY,CAQ1B,KAAc,EACd,IAAwB,EACxB,OAA4B;IAE5B,uDAAuD;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAyB,EAAE,OAAO,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC1B,CAAC"}

package/dist/useSnapshot.d.ts

@@ -5,10 +5,31 @@ export interface UseSnapshotOptions {
     throttle?: number;
 }
 /**
- * Subscribe to any `LiveSource` and return a throttled `TimeSeries` snapshot.
+ * Structural type covering all pond-ts live objects (`LiveSeries`, `LiveView`,
+ * `LiveAggregation`, `LiveRollingAggregation`).
+ *
+ * Using a structural type instead of the nominal `LiveSource<S>` avoids casts
+ * when passing `LiveAggregation` (whose output schema differs from its input
+ * type parameter).
+ */
+export type SnapshotSource<S extends SeriesSchema = SeriesSchema> = {
+    readonly name: string;
+    readonly schema: S;
+    readonly length: number;
+    at(index: number): unknown;
+    on(type: 'event', fn: (...args: any[]) => void): () => void;
+};
+/**
+ * Subscribe to any live source and return a throttled `TimeSeries` snapshot.
  *
  * The snapshot updates at most once per `throttle` interval (default 100 ms).
- * Returns `null` when the source is empty.
+ * Returns `null` when the source is empty or `null`.
+ *
+ * Accepts `LiveSource`, `LiveAggregation`, `LiveRollingAggregation`, or any
+ * object with a compatible shape — no casts needed.
+ *
+ * Accepts `null` as a source so hooks like `useWindow` can pass a
+ * not-yet-created source without violating the Rules of Hooks.
  */
-export declare function useSnapshot<S extends SeriesSchema>(source: LiveSource<S>, options?: UseSnapshotOptions): TimeSeries<S> | null;
+export declare function useSnapshot<S extends SeriesSchema>(source: SnapshotSource<S> | LiveSource<S> | null, options?: UseSnapshotOptions): TimeSeries<S> | null;
 //# sourceMappingURL=useSnapshot.d.ts.map

package/dist/useSnapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSnapshot.d.ts","sourceRoot":"","sources":["../src/useSnapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,YAAY,EAChD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAyCtB"}
+{"version":3,"file":"useSnapshot.d.ts","sourceRoot":"","sources":["../src/useSnapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,YAAY,EAChD,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,EAChD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAsDtB"}

package/dist/useSnapshot.js

@@ -1,18 +1,28 @@
 import { useEffect, useRef, useState } from 'react';
 import { takeSnapshot } from './takeSnapshot.js';
 /**
- * Subscribe to any `LiveSource` and return a throttled `TimeSeries` snapshot.
+ * Subscribe to any live source and return a throttled `TimeSeries` snapshot.
  *
  * The snapshot updates at most once per `throttle` interval (default 100 ms).
- * Returns `null` when the source is empty.
+ * Returns `null` when the source is empty or `null`.
+ *
+ * Accepts `LiveSource`, `LiveAggregation`, `LiveRollingAggregation`, or any
+ * object with a compatible shape — no casts needed.
+ *
+ * Accepts `null` as a source so hooks like `useWindow` can pass a
+ * not-yet-created source without violating the Rules of Hooks.
  */
 export function useSnapshot(source, options) {
     const throttleMs = options?.throttle ?? 100;
-    const [snapshot, setSnapshot] = useState(() => takeSnapshot(source));
-    // Track the latest source + throttle so the effect re-subscribes when they change.
+    const [snapshot, setSnapshot] = useState(() => source ? takeSnapshot(source) : null);
+    // Track the latest source so the flush callback always reads current state.
     const sourceRef = useRef(source);
     sourceRef.current = source;
     useEffect(() => {
+        if (!source) {
+            setSnapshot(null);
+            return;
+        }
         // Re-snapshot on source change
         setSnapshot(takeSnapshot(source));
         let timer = null;
@@ -20,11 +30,15 @@ export function useSnapshot(source, options) {
         const flush = () => {
             timer = null;
             pending = false;
-            setSnapshot(takeSnapshot(sourceRef.current));
+            if (sourceRef.current) {
+                setSnapshot(takeSnapshot(sourceRef.current));
+            }
         };
         const unsub = source.on('event', () => {
             if (throttleMs === 0) {
-                setSnapshot(takeSnapshot(sourceRef.current));
+                if (sourceRef.current) {
+                    setSnapshot(takeSnapshot(sourceRef.current));
+                }
                 return;
             }
             if (!pending) {

package/dist/useSnapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSnapshot.js","sourceRoot":"","sources":["../src/useSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,MAAqB,EACrB,OAA4B;IAE5B,MAAM,UAAU,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;IAC5C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAuB,GAAG,EAAE,CAClE,YAAY,CAAC,MAAM,CAAC,CACrB,CAAC;IAEF,mFAAmF;IACnF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,+BAA+B;QAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAElC,IAAI,KAAK,GAAyC,IAAI,CAAC;QACvD,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,GAAG,KAAK,CAAC;YAChB,WAAW,CAAC,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACpC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACrB,WAAW,CAAC,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC7C,OAAO;YACT,CAAC;YACD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzB,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"useSnapshot.js","sourceRoot":"","sources":["../src/useSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuBjD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,MAAgD,EAChD,OAA4B;IAE5B,MAAM,UAAU,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;IAC5C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAuB,GAAG,EAAE,CAClE,MAAM,CAAC,CAAC,CAAE,YAAY,CAAC,MAAuB,CAAmB,CAAC,CAAC,CAAC,IAAI,CACzE,CAAC;IAEF,4EAA4E;IAC5E,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,WAAW,CAAC,YAAY,CAAC,MAAuB,CAAkB,CAAC,CAAC;QAEpE,IAAI,KAAK,GAAyC,IAAI,CAAC;QACvD,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,GAAG,KAAK,CAAC;YAChB,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtB,WAAW,CACT,YAAY,CAAC,SAAS,CAAC,OAAwB,CAAkB,CAClE,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACpC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACrB,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;oBACtB,WAAW,CACT,YAAY,CAAC,SAAS,CAAC,OAAwB,CAAkB,CAClE,CAAC;gBACJ,CAAC;gBACD,OAAO;YACT,CAAC;YACD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzB,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/useWindow.d.ts

@@ -8,7 +8,8 @@ type Windowable<S extends SeriesSchema> = LiveSource<S> & {
 /**
  * Create a windowed view of a live source and return a throttled snapshot.
  *
- * The view is created once per `source`/`size` pair and disposed on cleanup.
+ * The view is created and disposed inside an effect, so it works correctly
+ * under React StrictMode's double-mount cycle.
  * Returns `null` when the window is empty.
  */
 export declare function useWindow<S extends SeriesSchema>(source: Windowable<S>, size: RollingWindow, options?: UseSnapshotOptions): TimeSeries<S> | null;

package/dist/useWindow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWindow.d.ts","sourceRoot":"","sources":["../src/useWindow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAExE,yFAAyF;AACzF,KAAK,UAAU,CAAC,CAAC,SAAS,YAAY,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG;IACxD,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,YAAY,EAC9C,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAYtB"}
+{"version":3,"file":"useWindow.d.ts","sourceRoot":"","sources":["../src/useWindow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAExE,yFAAyF;AACzF,KAAK,UAAU,CAAC,CAAC,SAAS,YAAY,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG;IACxD,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,YAAY,EAC9C,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAetB"}

package/dist/useWindow.js

@@ -1,20 +1,23 @@
-import { useEffect, useMemo } from 'react';
+import { useEffect, useState } from 'react';
 import { useSnapshot } from './useSnapshot.js';
 /**
  * Create a windowed view of a live source and return a throttled snapshot.
  *
- * The view is created once per `source`/`size` pair and disposed on cleanup.
+ * The view is created and disposed inside an effect, so it works correctly
+ * under React StrictMode's double-mount cycle.
  * Returns `null` when the window is empty.
  */
 export function useWindow(source, size, options) {
-    const view = useMemo(() => source.window(size), [source, size]);
+    const [view, setView] = useState(null);
     useEffect(() => {
+        const v = source.window(size);
+        setView(v);
         return () => {
-            if ('dispose' in view && typeof view.dispose === 'function') {
-                view.dispose();
+            if ('dispose' in v && typeof v.dispose === 'function') {
+                v.dispose();
             }
         };
-    }, [view]);
+    }, [source, size]);
     return useSnapshot(view, options);
 }
 //# sourceMappingURL=useWindow.js.map

package/dist/useWindow.js.map

@@ -1 +1 @@
-{"version":3,"file":"useWindow.js","sourceRoot":"","sources":["../src/useWindow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAG3C,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAC;AAOxE;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,MAAqB,EACrB,IAAmB,EACnB,OAA4B;IAE5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAEhE,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,SAAS,IAAI,IAAI,IAAI,OAAQ,IAAY,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBACpE,IAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"useWindow.js","sourceRoot":"","sources":["../src/useWindow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAC;AAOxE;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,MAAqB,EACrB,IAAmB,EACnB,OAA4B;IAE5B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAuB,IAAI,CAAC,CAAC;IAE7D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,CAAC,CAAC,CAAC,CAAC;QAEX,OAAO,GAAG,EAAE;YACV,IAAI,SAAS,IAAI,CAAC,IAAI,OAAQ,CAAS,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC9D,CAAS,CAAC,OAAO,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAEnB,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/package.json

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