@pond-ts/react 0.4.3 → 0.5.1

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,48 @@
+import type { AggregateMap, AggregateReducer, DurationInput, LiveSource, NormalizedValueForKind, ScalarKind, SeriesSchema, ValueColumnsForSchema } from 'pond-ts';
+import { type SnapshotSource, type UseSnapshotOptions } from './useSnapshot.js';
+/**
+ * Narrowed per-entry output for `useCurrent`. Derives each field's value
+ * type from the source column kind and the reducer name so callers don't
+ * have to `as`-cast. Numeric reducers (`'sum'`, `'avg'`, `'count'`) emit
+ * `number`; `'unique'` and `` `top${number}` `` emit
+ * `ReadonlyArray<ScalarValue>`; other reducers (including custom
+ * functions) fall back to the source column kind.
+ */
+type CurrentResult<S extends SeriesSchema, Mapping> = {
+    [K in keyof Mapping & string]: NormalizedValueForKind<K extends ValueColumnsForSchema<S>[number]['name'] ? Mapping[K] extends 'sum' | 'avg' | 'count' ? 'number' : Mapping[K] extends 'unique' | `top${number}` ? 'array' : CurrentColumnKind<S, K> : ScalarKind> | undefined;
+};
+type CurrentColumnKind<S extends SeriesSchema, K extends string> = Extract<ValueColumnsForSchema<S>[number], {
+    name: K;
+}> extends {
+    kind: infer Kind extends ScalarKind;
+} ? Kind : ScalarKind;
+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.
+ *
+ * ```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 an empty-result object (every mapped field set to the
+ * reducer's empty-bucket value) while the source has no events — the
+ * shape of the return is stable regardless of source state, so
+ * destructuring is always safe.
+ */
+export declare function useCurrent<S extends SeriesSchema, const Mapping extends AggregateMap<S>>(source: SnapshotSource<S> | LiveSource<S> | null, mapping: Mapping, options?: UseCurrentOptions): CurrentResult<S, Mapping>;
+export type _UseCurrentReducerHint = AggregateReducer;
+export {};
+//# 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,gBAAgB,EAEhB,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,UAAU,EACV,YAAY,EACZ,qBAAqB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;GAOG;AACH,KAAK,aAAa,CAAC,CAAC,SAAS,YAAY,EAAE,OAAO,IAAI;KACnD,CAAC,IAAI,MAAM,OAAO,GAAG,MAAM,GACxB,sBAAsB,CACpB,CAAC,SAAS,qBAAqB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAC9C,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,OAAO,GACxC,QAAQ,GACR,OAAO,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,MAAM,MAAM,EAAE,GAC1C,OAAO,GACP,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC3B,UAAU,CACf,GACD,SAAS;CACd,CAAC;AAEF,KAAK,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,IAC7D,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,SAAS;IAC7D,IAAI,EAAE,MAAM,IAAI,SAAS,UAAU,CAAC;CACrC,GACG,IAAI,GACJ,UAAU,CAAC;AAEjB,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;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,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAuB3B;AAKD,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAC"}

package/dist/useCurrent.js

@@ -0,0 +1,37 @@
+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.
+ *
+ * ```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 an empty-result object (every mapped field set to the
+ * reducer's empty-bucket value) while the source has no events — the
+ * shape of the return is stable regardless of source state, so
+ * destructuring is always 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;AAYhC,OAAO,EACL,WAAW,GAGZ,MAAM,kBAAkB,CAAC;AAwC1B;;;;;;;;;;;;;;;;;GAiBG;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,GAA4C,EAAE,CAAC;YAC1D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YAC/D,OAAO,KAAkC,CAAC;QAC5C,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,CAClB,OAMC,CACsC,CAAC;IAC5C,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.4.3",
+  "version": "0.5.1",
   "description": "React hooks for pond-ts live time series",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
     "test:runtime": "vitest run"
   },
   "dependencies": {
-    "pond-ts": "^0.4.0"
+    "pond-ts": "^0.5.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"