@pond-ts/react 0.5.0 → 0.5.2

package/dist/index.d.ts

@@ -5,5 +5,6 @@ export { useWindow } from './useWindow.js';
 export { useDerived } from './useDerived.js';
 export { useLiveQuery } from './useLiveQuery.js';
 export { useLatest } from './useLatest.js';
+export { useCurrent, type UseCurrentOptions } from './useCurrent.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,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"}
+{"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,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -6,5 +6,6 @@ export { useWindow } from './useWindow.js';
 export { useDerived } from './useDerived.js';
 export { useLiveQuery } from './useLiveQuery.js';
 export { useLatest } from './useLatest.js';
+export { useCurrent } from './useCurrent.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,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"}
+{"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,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/useCurrent.d.ts

@@ -0,0 +1,31 @@
+import type { AggregateMap, DurationInput, LiveSource, ReduceResult, SeriesSchema } from 'pond-ts';
+import { type SnapshotSource, type UseSnapshotOptions } from './useSnapshot.js';
+export interface UseCurrentOptions extends UseSnapshotOptions {
+    /**
+     * Trailing window to evaluate the mapping over, expressed as a
+     * `DurationInput` (e.g. `'30s'`, `'5m'`, or a number of milliseconds).
+     * When omitted, the full snapshot is used.
+     */
+    tail?: DurationInput;
+}
+/**
+ * Subscribe to a live source and return the current value of a reducer
+ * mapping, updated on a throttle. Equivalent to
+ * `useSnapshot(src).tail(tail).reduce(mapping)` but with one subscription,
+ * one memo, and narrow per-entry types inherited from
+ * `TimeSeries.reduce`.
+ *
+ * ```ts
+ * const current = useCurrent(live, { cpu: 'avg', host: 'unique' });
+ * //   ^ { cpu: number | undefined;
+ * //       host: ReadonlyArray<ScalarValue> | undefined }
+ *
+ * const recent = useCurrent(live, { cpu: 'p95' }, { tail: '30s' });
+ * ```
+ *
+ * Returns a stable-shape object while the source has no events (every
+ * mapped field is `undefined`), so destructuring on first render is
+ * safe.
+ */
+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

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

package/dist/useCurrent.js

@@ -0,0 +1,38 @@
+import { useMemo } from 'react';
+import { useSnapshot, } from './useSnapshot.js';
+/**
+ * Subscribe to a live source and return the current value of a reducer
+ * mapping, updated on a throttle. Equivalent to
+ * `useSnapshot(src).tail(tail).reduce(mapping)` but with one subscription,
+ * one memo, and narrow per-entry types inherited from
+ * `TimeSeries.reduce`.
+ *
+ * ```ts
+ * const current = useCurrent(live, { cpu: 'avg', host: 'unique' });
+ * //   ^ { cpu: number | undefined;
+ * //       host: ReadonlyArray<ScalarValue> | undefined }
+ *
+ * const recent = useCurrent(live, { cpu: 'p95' }, { tail: '30s' });
+ * ```
+ *
+ * Returns a stable-shape object while the source has no events (every
+ * mapped field is `undefined`), so destructuring on first render is
+ * safe.
+ */
+export function useCurrent(source, mapping, options) {
+    const snap = useSnapshot(source, options);
+    const tailOpt = options?.tail;
+    return useMemo(() => {
+        if (!snap) {
+            // Stable empty-shape result so destructuring never explodes on
+            // first render.
+            const empty = {};
+            for (const key of Object.keys(mapping))
+                empty[key] = undefined;
+            return empty;
+        }
+        const scoped = tailOpt !== undefined ? snap.tail(tailOpt) : snap;
+        return scoped.reduce(mapping);
+    }, [snap, tailOpt, mapping]);
+}
+//# sourceMappingURL=useCurrent.js.map

package/dist/useCurrent.js.map

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

package/package.json

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