@pond-ts/react 0.4.1

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// @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 { useWindow } from './useWindow.js';
+export { useDerived } from './useDerived.js';
+export { takeSnapshot } from './takeSnapshot.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/takeSnapshot.d.ts

@@ -0,0 +1,11 @@
+import { TimeSeries } from 'pond-ts';
+import type { LiveSource, SeriesSchema } from 'pond-ts';
+/**
+ * Build a `TimeSeries` snapshot from any `LiveSource`.
+ *
+ * Checks for dedicated snapshot methods first (`toTimeSeries`, `snapshot`),
+ * then falls back to iterating `at()` + `length` for sources like
+ * `LiveRollingAggregation` that lack a built-in snapshot.
+ */
+export declare function takeSnapshot<S extends SeriesSchema>(source: LiveSource<S>): TimeSeries<S> | null;
+//# sourceMappingURL=takeSnapshot.d.ts.map

package/dist/takeSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"takeSnapshot.d.ts","sourceRoot":"","sources":["../src/takeSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EACjD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAuCtB"}

package/dist/takeSnapshot.js

@@ -0,0 +1,43 @@
+import { TimeSeries } from 'pond-ts';
+/**
+ * Build a `TimeSeries` snapshot from any `LiveSource`.
+ *
+ * Checks for dedicated snapshot methods first (`toTimeSeries`, `snapshot`),
+ * then falls back to iterating `at()` + `length` for sources like
+ * `LiveRollingAggregation` that lack a built-in snapshot.
+ */
+export function takeSnapshot(source) {
+    if (source.length === 0)
+        return null;
+    // LiveSeries, LiveView
+    if ('toTimeSeries' in source &&
+        typeof source.toTimeSeries === 'function') {
+        return source.toTimeSeries();
+    }
+    // LiveAggregation
+    if ('snapshot' in source &&
+        typeof source.snapshot === 'function') {
+        return source.snapshot();
+    }
+    // Fallback: reconstruct rows from LiveSource interface
+    const schema = source.schema;
+    const rows = [];
+    for (let i = 0; i < source.length; i++) {
+        const event = source.at(i);
+        if (!event)
+            continue;
+        const row = [event.key()];
+        for (let col = 1; col < schema.length; col++) {
+            row.push(event.get(schema[col].name));
+        }
+        rows.push(row);
+    }
+    if (rows.length === 0)
+        return null;
+    return new TimeSeries({
+        name: source.name,
+        schema,
+        rows: rows,
+    });
+}
+//# sourceMappingURL=takeSnapshot.js.map

package/dist/takeSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"takeSnapshot.js","sourceRoot":"","sources":["../src/takeSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAqB;IAErB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,uBAAuB;IACvB,IACE,cAAc,IAAI,MAAM;QACxB,OAAQ,MAAkC,CAAC,YAAY,KAAK,UAAU,EACtE,CAAC;QACD,OAAQ,MAAuD,CAAC,YAAY,EAAE,CAAC;IACjF,CAAC;IAED,kBAAkB;IAClB,IACE,UAAU,IAAI,MAAM;QACpB,OAAQ,MAAkC,CAAC,QAAQ,KAAK,UAAU,EAClE,CAAC;QACD,OAAQ,MAAmD,CAAC,QAAQ,EAAE,CAAC;IACzE,CAAC;IAED,uDAAuD;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,GAAG,GAAc,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACrC,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAE,MAAM,CAAC,GAAG,CAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,OAAO,IAAI,UAAU,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM;QACN,IAAI,EAAE,IAAW;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/useDerived.d.ts

@@ -0,0 +1,19 @@
+import type { TimeSeries, SeriesSchema } from 'pond-ts';
+/**
+ * Apply a batch transform to a `TimeSeries` snapshot, recomputing only when
+ * the input snapshot changes.
+ *
+ * The `transform` function should be referentially stable (wrap in
+ * `useCallback` if it captures changing dependencies). Returns `null` when the
+ * input snapshot is `null`.
+ *
+ * @example
+ * ```ts
+ * const [, snapshot] = useLiveSeries(opts);
+ * const smoothed = useDerived(snapshot, (s) =>
+ *   s.smooth('cpu', 'ema', { alpha: 0.2 }),
+ * );
+ * ```
+ */
+export declare function useDerived<S extends SeriesSchema, R>(series: TimeSeries<S> | null, transform: (series: TimeSeries<S>) => R): R | null;
+//# sourceMappingURL=useDerived.d.ts.map

package/dist/useDerived.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDerived.d.ts","sourceRoot":"","sources":["../src/useDerived.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,EAClD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,EAC5B,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GACtC,CAAC,GAAG,IAAI,CAMV"}

package/dist/useDerived.js

@@ -0,0 +1,26 @@
+import { useMemo } from 'react';
+/**
+ * Apply a batch transform to a `TimeSeries` snapshot, recomputing only when
+ * the input snapshot changes.
+ *
+ * The `transform` function should be referentially stable (wrap in
+ * `useCallback` if it captures changing dependencies). Returns `null` when the
+ * input snapshot is `null`.
+ *
+ * @example
+ * ```ts
+ * const [, snapshot] = useLiveSeries(opts);
+ * const smoothed = useDerived(snapshot, (s) =>
+ *   s.smooth('cpu', 'ema', { alpha: 0.2 }),
+ * );
+ * ```
+ */
+export function useDerived(series, transform) {
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    return useMemo(() => {
+        if (series === null)
+            return null;
+        return transform(series);
+    }, [series, transform]);
+}
+//# sourceMappingURL=useDerived.js.map

package/dist/useDerived.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDerived.js","sourceRoot":"","sources":["../src/useDerived.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAGhC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CACxB,MAA4B,EAC5B,SAAuC;IAEvC,uDAAuD;IACvD,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1B,CAAC"}

package/dist/useLiveSeries.d.ts

@@ -0,0 +1,17 @@
+import { LiveSeries } from 'pond-ts';
+import type { LiveSeriesOptions, SeriesSchema, TimeSeries } from 'pond-ts';
+import { type UseSnapshotOptions } from './useSnapshot.js';
+/**
+ * Create and own a `LiveSeries` for the component's lifetime.
+ *
+ * Returns `[live, snapshot]`:
+ * - `live` — a stable `LiveSeries` ref. Push events into it from effects or
+ *   callbacks (e.g. WebSocket `onmessage`).
+ * - `snapshot` — a throttled `TimeSeries` that updates when new events arrive.
+ *   `null` when the series is empty.
+ *
+ * The `LiveSeries` is created once on mount. Changing `options` after mount has
+ * no effect — pass stable options (literal or top-level constant).
+ */
+export declare function useLiveSeries<S extends SeriesSchema>(options: LiveSeriesOptions<S>, hookOptions?: UseSnapshotOptions): [LiveSeries<S>, TimeSeries<S> | null];
+//# sourceMappingURL=useLiveSeries.d.ts.map

package/dist/useLiveSeries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveSeries.d.ts","sourceRoot":"","sources":["../src/useLiveSeries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAClD,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC7B,WAAW,CAAC,EAAE,kBAAkB,GAC/B,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAUvC"}

package/dist/useLiveSeries.js

@@ -0,0 +1,25 @@
+import { useRef } from 'react';
+import { LiveSeries } from 'pond-ts';
+import { useSnapshot } from './useSnapshot.js';
+/**
+ * Create and own a `LiveSeries` for the component's lifetime.
+ *
+ * Returns `[live, snapshot]`:
+ * - `live` — a stable `LiveSeries` ref. Push events into it from effects or
+ *   callbacks (e.g. WebSocket `onmessage`).
+ * - `snapshot` — a throttled `TimeSeries` that updates when new events arrive.
+ *   `null` when the series is empty.
+ *
+ * The `LiveSeries` is created once on mount. Changing `options` after mount has
+ * no effect — pass stable options (literal or top-level constant).
+ */
+export function useLiveSeries(options, hookOptions) {
+    // Create the LiveSeries once and keep it for the component lifetime.
+    const liveRef = useRef(undefined);
+    if (liveRef.current === undefined) {
+        liveRef.current = new LiveSeries(options);
+    }
+    const snapshot = useSnapshot(liveRef.current, hookOptions);
+    return [liveRef.current, snapshot];
+}
+//# sourceMappingURL=useLiveSeries.js.map

package/dist/useLiveSeries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveSeries.js","sourceRoot":"","sources":["../src/useLiveSeries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,OAA6B,EAC7B,WAAgC;IAEhC,qEAAqE;IACrE,MAAM,OAAO,GAAG,MAAM,CAA4B,SAAS,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAE3D,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/useSnapshot.d.ts

@@ -0,0 +1,14 @@
+import type { LiveSource, SeriesSchema } from 'pond-ts';
+import type { TimeSeries } from 'pond-ts';
+export interface UseSnapshotOptions {
+    /** Minimum milliseconds between snapshot rebuilds. Default 100. Set to 0 for immediate. */
+    throttle?: number;
+}
+/**
+ * Subscribe to any `LiveSource` 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.
+ */
+export declare function useSnapshot<S extends SeriesSchema>(source: LiveSource<S>, options?: UseSnapshotOptions): TimeSeries<S> | null;
+//# sourceMappingURL=useSnapshot.d.ts.map

package/dist/useSnapshot.d.ts.map

@@ -0,0 +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"}

package/dist/useSnapshot.js

@@ -0,0 +1,43 @@
+import { useEffect, useRef, useState } from 'react';
+import { takeSnapshot } from './takeSnapshot.js';
+/**
+ * Subscribe to any `LiveSource` 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.
+ */
+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 sourceRef = useRef(source);
+    sourceRef.current = source;
+    useEffect(() => {
+        // Re-snapshot on source change
+        setSnapshot(takeSnapshot(source));
+        let timer = null;
+        let pending = false;
+        const flush = () => {
+            timer = null;
+            pending = false;
+            setSnapshot(takeSnapshot(sourceRef.current));
+        };
+        const unsub = source.on('event', () => {
+            if (throttleMs === 0) {
+                setSnapshot(takeSnapshot(sourceRef.current));
+                return;
+            }
+            if (!pending) {
+                pending = true;
+                timer = setTimeout(flush, throttleMs);
+            }
+        });
+        return () => {
+            unsub();
+            if (timer !== null)
+                clearTimeout(timer);
+        };
+    }, [source, throttleMs]);
+    return snapshot;
+}
+//# sourceMappingURL=useSnapshot.js.map

package/dist/useSnapshot.js.map

@@ -0,0 +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"}

package/dist/useTimeSeries.d.ts

@@ -0,0 +1,12 @@
+import { TimeSeries } from 'pond-ts';
+import type { SeriesSchema } from 'pond-ts';
+/**
+ * Memoized `TimeSeries.fromJSON(...)` for static or fetched data.
+ *
+ * Re-parses only when `key` changes. If no `key` is provided, the input is
+ * serialized via `JSON.stringify` as the cache key — fine for small to
+ * moderate payloads. For large datasets, pass an explicit `key` (e.g. a fetch
+ * URL or ETag) to avoid the serialization cost.
+ */
+export declare function useTimeSeries<S extends SeriesSchema, I extends Parameters<typeof TimeSeries.fromJSON<S>>[0]>(input: I, key?: string): TimeSeries<S>;
+//# sourceMappingURL=useTimeSeries.d.ts.map

package/dist/useTimeSeries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimeSeries.d.ts","sourceRoot":"","sources":["../src/useTimeSeries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,CAAC,SAAS,YAAY,EACtB,CAAC,SAAS,UAAU,CAAC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACtD,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAKvC"}

package/dist/useTimeSeries.js

@@ -0,0 +1,17 @@
+import { useMemo } from 'react';
+import { TimeSeries } from 'pond-ts';
+/**
+ * Memoized `TimeSeries.fromJSON(...)` for static or fetched data.
+ *
+ * Re-parses only when `key` changes. If no `key` is provided, the input is
+ * serialized via `JSON.stringify` as the cache key — fine for small to
+ * moderate payloads. For large datasets, pass an explicit `key` (e.g. a fetch
+ * URL or ETag) to avoid the serialization cost.
+ */
+export function useTimeSeries(input, key) {
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    const cacheKey = key ?? JSON.stringify(input);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    return useMemo(() => TimeSeries.fromJSON(input), [cacheKey]);
+}
+//# sourceMappingURL=useTimeSeries.js.map

package/dist/useTimeSeries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimeSeries.js","sourceRoot":"","sources":["../src/useTimeSeries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAG3B,KAAQ,EAAE,GAAY;IACtB,uDAAuD;IACvD,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9C,uDAAuD;IACvD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAI,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/useWindow.d.ts

@@ -0,0 +1,16 @@
+import type { LiveSource, SeriesSchema, TimeSeries } from 'pond-ts';
+import type { RollingWindow } from 'pond-ts';
+import { type UseSnapshotOptions } from './useSnapshot.js';
+/** A `LiveSource` that supports `.window()` — `LiveSeries`, `LiveView`, accumulators. */
+type Windowable<S extends SeriesSchema> = LiveSource<S> & {
+    window(size: RollingWindow): 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.
+ * Returns `null` when the window is empty.
+ */
+export declare function useWindow<S extends SeriesSchema>(source: Windowable<S>, size: RollingWindow, options?: UseSnapshotOptions): TimeSeries<S> | null;
+export {};
+//# sourceMappingURL=useWindow.d.ts.map

package/dist/useWindow.d.ts.map

@@ -0,0 +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"}

package/dist/useWindow.js

@@ -0,0 +1,20 @@
+import { useEffect, useMemo } 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.
+ * Returns `null` when the window is empty.
+ */
+export function useWindow(source, size, options) {
+    const view = useMemo(() => source.window(size), [source, size]);
+    useEffect(() => {
+        return () => {
+            if ('dispose' in view && typeof view.dispose === 'function') {
+                view.dispose();
+            }
+        };
+    }, [view]);
+    return useSnapshot(view, options);
+}
+//# sourceMappingURL=useWindow.js.map

package/dist/useWindow.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@pond-ts/react",
+  "version": "0.4.1",
+  "description": "React hooks for pond-ts live time series",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pjm17971/pond-ts.git",
+    "directory": "packages/react"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:runtime": "vitest run"
+  },
+  "dependencies": {
+    "pond-ts": "^0.4.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.2.3",
+    "happy-dom": "^20.9.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.2.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  }
+}