@pond-ts/react 0.17.1 → 0.19.0

package/CHANGELOG.md

@@ -7,10 +7,156 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 file covers both packages. Pre-1.0: minor bumps may include new features and
 type-level changes; patch bumps are strictly additive.
 
-[Unreleased]: https://github.com/pjm17971/pond-ts/compare/v0.17.1...HEAD
+[Unreleased]: https://github.com/pjm17971/pond-ts/compare/v0.19.0...HEAD
+[0.19.0]: https://github.com/pjm17971/pond-ts/compare/v0.18.0...v0.19.0
+[0.18.0]: https://github.com/pjm17971/pond-ts/compare/v0.17.1...v0.18.0
 
 ## [Unreleased]
 
+## [0.19.0] — 2026-06-02
+
+Adds an **experimental column-read surface to the live side** — read typed
+columns straight off a `LiveView` without materializing a `TimeSeries`
+snapshot — driven by the dashboard experiment's per-tick memo cost. Plus a
+`useTimeSeries` schema-inference fix. The live column surface is
+**experimental and expected to keep moving in 0.19.x**.
+
+### Added
+
+- **`LiveView` column-read surface (experimental).** Read columns directly
+  off a windowed live view, the column-API counterpart to the batch
+  `TimeSeries` surface ([#179](https://github.com/pjm17971/pond-ts/pull/179)):
+  - `liveView.column(name)` — a numeric value column gathered from the view's
+    current events (string / array columns are a compile error; read those as
+    scalars or snapshot via `toTimeSeries()`).
+  - `liveView.keyColumn()` — the time axis (`TimeKeyColumn`; time-keyed views
+    only, enforced at compile time).
+  - `liveView.partitionBy(col).toMap(fn)` — a walk-now per-partition read
+    returning `Map<string, R>`, mirroring `TimeSeries.partitionBy().toMap()`
+    but without per-partition `TimeSeries` construction. Distinct from
+    `LiveSeries.partitionBy` (which is subscription-oriented). Throws on a
+    missing / key partition column rather than silently merging.
+  - `LiveColumnGroup` — the per-partition view passed to the `toMap` callback.
+- **`@pond-ts/react`: `useLiveVersion(source, { throttle })` (experimental)**
+  — a `useSyncExternalStore`-based change signal that bumps on append **and**
+  eviction, so a component can read columns off a live view each render
+  without manufacturing a `TimeSeries` snapshot. Closes the
+  render-before-subscribe gap; throttling bounds only the React notification
+  ([#179](https://github.com/pjm17971/pond-ts/pull/179)).
+
+### Changed
+
+- **`useTimeSeries` collapsed to a single generic** `<S extends SeriesSchema>`
+  so the schema infers from `input.schema`. The prior two-generic signature
+  lost `S` through the input-wrapper generic and resolved
+  `result.column('cpu')` to `never`; the accepted input type is unchanged, so
+  this is an inference fix — but a caller passing two explicit type arguments
+  must drop the second ([#176](https://github.com/pjm17971/pond-ts/pull/176)).
+
+## [0.18.0] — 2026-05-30
+
+This release graduates the **Phase 4.7 columnar substrate** from
+framework-internal (shipped piecemeal to `main` since v0.17.1) to a
+user-visible **public column API**, plus a column-native live buffer that
+fixes a high-partition-count OOM. Everything is additive except one
+documented breaking change (interval label kinds) and one documented
+behavior change (chunked-backed `pushMany` commit semantics). Pre-1.0: the
+column API is expected to keep moving toward its eventual shape.
+
+### Added
+
+- **Public column API (Phase 4.7 step 8).** A column-centric extraction
+  surface on `TimeSeries`, for high-throughput and charting consumers that
+  want typed-array access instead of per-`Event` iteration. Additive — every
+  existing row / `Event` API is unchanged.
+  - `series.column(name)` returns a schema-narrowed typed column view, with
+    public re-exports of the `Float64Column` / `BooleanColumn` /
+    `StringColumn` / `KeyColumn` (time / timeRange / interval) variants
+    ([#154](https://github.com/pjm17971/pond-ts/pull/154),
+    [#155](https://github.com/pjm17971/pond-ts/pull/155)).
+  - `Float64Column`: scalar reductions (`min` / `max` / `sum` / `mean` /
+    `count` / …) and `scan`
+    ([#155](https://github.com/pjm17971/pond-ts/pull/155)); `bin(...)` for
+    histogram / downsample bucketing
+    ([#156](https://github.com/pjm17971/pond-ts/pull/156)); and
+    `toFloat64Array()` for a storage-agnostic gather into a dense array
+    ([#165](https://github.com/pjm17971/pond-ts/pull/165)).
+  - `KeyColumn.at(i)` and `.slice(start, end)`
+    ([#159](https://github.com/pjm17971/pond-ts/pull/159)).
+- **Columnar substrate (Phase 4.7 step 1, framework layer).** All
+  eight sub-steps (1a–1h) shipped to main as PRs #132 / #133 /
+  #134 / #135 / #136 / #147 / #148 / #149. See `PLAN.md` and
+  [`packages/core/src/columnar/README.md`](packages/core/src/columnar/README.md)
+  for the full inventory. Framework-internal — surfaced behind the existing
+  `TimeSeries` API at step 2 (below) and the public column API at step 8
+  (above).
+
+### Changed
+
+- **Chunked columnar live backing for strict time-keyed `LiveSeries`**
+  ([#170](https://github.com/pjm17971/pond-ts/pull/170)). A top-level
+  `LiveSeries` with `ordering: 'strict'` and a time key now backs its
+  retained window with batch-granular columnar chunks instead of an
+  `Event[]` window — each `pushMany` validates straight into typed columns,
+  retaining **zero `Event` objects** (~4.7× less retained heap in-pond; the
+  high-partition-count OOM fix). Two consequences:
+  - **`pushMany` commit semantics** on the chunked path: the batch is
+    appended atomically _before_ any `'event'` fires, so a listener observes
+    the full post-batch `length` (not a row-by-row `1, 2, 3`), and a listener
+    that throws mid-batch leaves the whole batch committed. The per-row
+    `Event[]` backing (`reorder` / `drop` / interval-keyed /
+    internally-created series) keeps per-row commit. Listener _values_ and
+    `event → batch → evict` ordering are unchanged.
+  - **`LiveReduce` eviction** resolves by event identity (primary) with a
+    FIFO-frontier fallback for the chunked backing's materialized evictions —
+    correct for both `reorder` and the chunked backing. `min` / `max` /
+    `first` / `last` / `samples` over a `reorder` source **with retention**
+    remain a documented limitation (see `LiveReduce` JSDoc and PLAN
+    "Deferred") — pre-existing, not introduced here.
+- **Internal, behavior-preserving performance work.** Column-native intake
+  bypasses per-row `Event` allocation at `TimeSeries` construction
+  ([#151](https://github.com/pjm17971/pond-ts/pull/151)); numeric reducers
+  (`min` / `max` / `sum` / `avg` / …) compute over typed-array columns where
+  available, with NaN parity preserved
+  ([#153](https://github.com/pjm17971/pond-ts/pull/153)); the live storage
+  strategy was extracted behind an internal interface
+  ([#168](https://github.com/pjm17971/pond-ts/pull/168)).
+
+### Changed (BREAKING)
+
+- **Interval-keyed series must use one label type throughout**
+  ([#150](https://github.com/pjm17971/pond-ts/pull/150)). Pre-2a,
+  TimeSeries silently tolerated mixed-kind interval labels —
+  rows with `value: 'row-1'` (string) and `value: 2` (number) could
+  coexist in a single series because events were stored as a raw
+  array with no per-column type alignment. The columnar substrate
+  introduced at Phase 4.7 enforces one label kind per column via
+  `IntervalKeyColumn`, so mixed-kind labels now throw at series
+  construction with a row-pointed error message.
+  - **Affected:** Any series built via `new TimeSeries(...)`,
+    `TimeSeries.fromJSON(...)`, `TimeSeries.fromEvents(...)`, or
+    any transform that produces interval-keyed events, where the
+    `value` field of `IntervalInput` rows or `Interval` keys
+    mixes `string` and `number` types.
+  - **Migration:** Choose one label kind for the whole series.
+    Numeric labels can be stringified at intake (`String(label)`)
+    if the downstream consumer accepts string equality; string
+    labels parseable as integers can be converted to numbers at
+    intake. The error message names the first offending row so
+    the offending data is easy to find.
+  - **Rationale:** Aligns the row-API contract with the columnar
+    substrate's per-column kind discipline (matching Polars /
+    Arrow / Parquet). The previous behavior produced type-broken
+    events that worked only because TimeSeries didn't enforce
+    per-column alignment; downstream columnar operators (the
+    upcoming reducer adaptation in steps 3+) require it.
+  - **Affected types:** `IntervalValue` remains `string | number`
+    per the `Interval` class contract. The runtime restriction
+    is at the **series** level (all intervals within one series
+    must share a kind), not the per-interval level. Type-level
+    narrowing of `IntervalKeyedSchema<S>` over label kind is a
+    follow-up deferred to a later sub-step.
+
 ## [0.17.1] — 2026-05-11
 
 Bug fix: `live.partitionBy()` now default-inherits `ordering`,

package/README.md

@@ -1,7 +1,7 @@
 # pond-ts
 
 **Highly optimised, fully typed Timeseries library for TypeScript**
- 
+
 Schema-driven events, composable batch transforms, push-based streaming
 ingest, multi-entity partitioning, and an optional React integration —
 all strict TypeScript end to end, all immutable.
@@ -31,6 +31,11 @@ npm install @pond-ts/react          # React hooks (optional)
   single node.js instance.)
 - **Triggers** — for control of rolling emission cadences. Synchronised
   partitioned rolling fires across partitions on every boundary.
+- **Typed column extraction** — `series.column('cpu')` returns a
+  schema-narrowed typed column with single-pass reductions
+  (`min`/`max`/`sum`/`mean`/`stdev`/`median`/`percentile`/`minMax`),
+  index downsampling (`bin`), and a zero-copy `toFloat64Array()` for
+  canvas / WebGL draw loops — no per-event allocation on the hot path.
 - **No legacy baggage**
 
 ## Quick start: batch

package/dist/index.d.ts

@@ -7,5 +7,6 @@ export { useLiveQuery } from './useLiveQuery.js';
 export { useLatest } from './useLatest.js';
 export { useCurrent, type UseCurrentOptions } from './useCurrent.js';
 export { useEventRate } from './useEventRate.js';
+export { useLiveVersion, type UseLiveVersionOptions, } from './useLiveVersion.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,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,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;AACjD,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -8,5 +8,6 @@ export { useLiveQuery } from './useLiveQuery.js';
 export { useLatest } from './useLatest.js';
 export { useCurrent } from './useCurrent.js';
 export { useEventRate } from './useEventRate.js';
+export { useLiveVersion, } from './useLiveVersion.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,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,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;AACjD,OAAO,EACL,cAAc,GAEf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/useLiveVersion.d.ts

@@ -0,0 +1,41 @@
+import type { LiveSource, SeriesSchema } from 'pond-ts';
+export interface UseLiveVersionOptions {
+    /**
+     * Minimum interval between React notifications, in ms. The version
+     * counter bumps *immediately* on every source change (no buffering);
+     * `throttle` only bounds how often React is told to re-render.
+     * `0` notifies synchronously per change. Default 100.
+     */
+    throttle?: number;
+}
+/**
+ * The React change signal for reading columns off a live source without
+ * manufacturing a `TimeSeries` snapshot (§A pull/read, experimental).
+ *
+ * `LiveSeries` / `LiveView` mutate in place, so a `useMemo([liveView])`
+ * keyed on the view never re-runs. This hook gives React a
+ * monotonically-increasing version that changes (at most once per
+ * `throttle`) whenever the source mutates — the missing invalidation
+ * trigger. Read columns straight off the live view, keyed on the
+ * returned version:
+ *
+ * ```tsx
+ * const view = useMemo(() => live.window('5m'), [live]);
+ * const v = useLiveVersion(view, { throttle: 200 });
+ * const series = useMemo(
+ *   () => view.partitionBy('host').toMap((g) => ({
+ *     ts: g.keyColumn().begin,
+ *     cpu: g.column('cpu').toFloat64Array(),
+ *   })),
+ *   [view, v],
+ * );
+ * ```
+ *
+ * Tracks **both** append (`'event'`) and eviction (`'evict'`, on sources
+ * that emit it — e.g. `clear()` / retention prune), and advances the
+ * revision on subscribe so a change between render and the subscribe
+ * effect is still picked up (the `useSyncExternalStore` post-subscribe
+ * re-read). Experimental (0.19.0) — surface may change in 0.19.x.
+ */
+export declare function useLiveVersion<S extends SeriesSchema>(source: LiveSource<S>, options?: UseLiveVersionOptions): number;
+//# sourceMappingURL=useLiveVersion.d.ts.map

package/dist/useLiveVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveVersion.d.ts","sourceRoot":"","sources":["../src/useLiveVersion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AASxD,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,YAAY,EACnD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,CA4ER"}

package/dist/useLiveVersion.js

@@ -0,0 +1,104 @@
+import { useMemo, useSyncExternalStore } from 'react';
+// The capability marker pond-ts stamps on evict-emitting sources
+// (`LiveSeries`, `LiveView`). It's a registered symbol
+// (`Symbol.for('pond-ts:emitsEvict')` in pond-ts), so reconstructing it
+// here yields the identical symbol — no import needed. The
+// `clear-evicts-without-event` test guards against key drift.
+const EMITS_EVICT = Symbol.for('pond-ts:emitsEvict');
+/**
+ * The React change signal for reading columns off a live source without
+ * manufacturing a `TimeSeries` snapshot (§A pull/read, experimental).
+ *
+ * `LiveSeries` / `LiveView` mutate in place, so a `useMemo([liveView])`
+ * keyed on the view never re-runs. This hook gives React a
+ * monotonically-increasing version that changes (at most once per
+ * `throttle`) whenever the source mutates — the missing invalidation
+ * trigger. Read columns straight off the live view, keyed on the
+ * returned version:
+ *
+ * ```tsx
+ * const view = useMemo(() => live.window('5m'), [live]);
+ * const v = useLiveVersion(view, { throttle: 200 });
+ * const series = useMemo(
+ *   () => view.partitionBy('host').toMap((g) => ({
+ *     ts: g.keyColumn().begin,
+ *     cpu: g.column('cpu').toFloat64Array(),
+ *   })),
+ *   [view, v],
+ * );
+ * ```
+ *
+ * Tracks **both** append (`'event'`) and eviction (`'evict'`, on sources
+ * that emit it — e.g. `clear()` / retention prune), and advances the
+ * revision on subscribe so a change between render and the subscribe
+ * effect is still picked up (the `useSyncExternalStore` post-subscribe
+ * re-read). Experimental (0.19.0) — surface may change in 0.19.x.
+ */
+export function useLiveVersion(source, options) {
+    const throttleMs = options?.throttle ?? 100;
+    const store = useMemo(() => {
+        let version = 0; // bumped on every observed source mutation
+        let committed = 0; // last version React has been notified about
+        let timer = null;
+        let unsubSource = null;
+        const listeners = new Set();
+        const flush = () => {
+            timer = null;
+            committed = version;
+            for (const l of listeners)
+                l();
+        };
+        const onChange = () => {
+            version += 1;
+            if (throttleMs <= 0) {
+                flush();
+            }
+            else if (timer === null) {
+                timer = setTimeout(flush, throttleMs);
+            }
+        };
+        return {
+            subscribe(cb) {
+                listeners.add(cb);
+                if (unsubSource === null) {
+                    const unsubEvent = source.on('event', onChange);
+                    // Also track eviction (clear / retention prune) on sources that
+                    // emit it — otherwise a `clear()` with no following append leaves
+                    // a column reader stale.
+                    let unsubEvict;
+                    if (EMITS_EVICT in source) {
+                        unsubEvict = source.on('evict', onChange);
+                    }
+                    unsubSource = () => {
+                        unsubEvent();
+                        unsubEvict?.();
+                    };
+                }
+                // Close the render-before-subscribe gap: a mutation between render
+                // and this effect fires no observed callback, so advance the
+                // revision now. useSyncExternalStore re-reads getSnapshot after
+                // subscribe; the bumped value forces one re-render that re-reads
+                // the (now-current) view.
+                version += 1;
+                committed = version;
+                return () => {
+                    listeners.delete(cb);
+                    if (listeners.size === 0) {
+                        unsubSource?.();
+                        unsubSource = null;
+                        if (timer !== null) {
+                            clearTimeout(timer);
+                            timer = null;
+                        }
+                    }
+                };
+            },
+            // Stable between notifications — only advances at flush / subscribe,
+            // exactly when React is told. (Returning the live `version` would
+            // violate the getSnapshot contract.)
+            getSnapshot: () => committed,
+        };
+    }, [source, throttleMs]);
+    return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+}
+//# sourceMappingURL=useLiveVersion.js.map

package/dist/useLiveVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveVersion.js","sourceRoot":"","sources":["../src/useLiveVersion.ts"],"names":[],"mappings":"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"}

package/dist/useTimeSeries.d.ts

@@ -1,5 +1,5 @@
 import { TimeSeries } from 'pond-ts';
-import type { SeriesSchema } from 'pond-ts';
+import type { SeriesSchema, TimeSeriesJsonInput, TimeZoneOptions } from 'pond-ts';
 /**
  * Memoized `TimeSeries.fromJSON(...)` for static or fetched data.
  *
@@ -7,6 +7,19 @@ import type { SeriesSchema } from 'pond-ts';
  * 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.
+ *
+ * The schema generic `S` is inferred directly from `input.schema` (a plain
+ * structural position), so an `as const` schema narrows the returned
+ * `TimeSeries<S>` fully — `result.column('cpu')` resolves to `Float64Column`,
+ * `result.at(i)!.get('cpu')` to `number | undefined`, etc. An earlier
+ * two-generic `<S, I extends Parameters<...>[0]>` shape lost `S` through the
+ * input-wrapper generic and collapsed schema-narrowed accessors to `never`
+ * (the loose `.get(string)` path masked it); the column API surfaced it. The
+ * accepted input type is unchanged — `Parameters<fromJSON<S>>[0]` already
+ * resolved to `TimeSeriesJsonInput<S> & { parse? }` — so this is purely an
+ * inference fix, not a surface change.
  */
-export declare function useTimeSeries<S extends SeriesSchema, I extends Parameters<typeof TimeSeries.fromJSON<S>>[0]>(input: I, key?: string): TimeSeries<S>;
+export declare function useTimeSeries<S extends SeriesSchema>(input: TimeSeriesJsonInput<S> & {
+    parse?: TimeZoneOptions;
+}, key?: string): TimeSeries<S>;
 //# sourceMappingURL=useTimeSeries.d.ts.map

package/dist/useTimeSeries.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"useTimeSeries.d.ts","sourceRoot":"","sources":["../src/useTimeSeries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAClD,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,eAAe,CAAA;CAAE,EAC3D,GAAG,CAAC,EAAE,MAAM,GACX,UAAU,CAAC,CAAC,CAAC,CAKf"}

package/dist/useTimeSeries.js

@@ -7,6 +7,17 @@ import { TimeSeries } from 'pond-ts';
  * 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.
+ *
+ * The schema generic `S` is inferred directly from `input.schema` (a plain
+ * structural position), so an `as const` schema narrows the returned
+ * `TimeSeries<S>` fully — `result.column('cpu')` resolves to `Float64Column`,
+ * `result.at(i)!.get('cpu')` to `number | undefined`, etc. An earlier
+ * two-generic `<S, I extends Parameters<...>[0]>` shape lost `S` through the
+ * input-wrapper generic and collapsed schema-narrowed accessors to `never`
+ * (the loose `.get(string)` path masked it); the column API surfaced it. The
+ * accepted input type is unchanged — `Parameters<fromJSON<S>>[0]` already
+ * resolved to `TimeSeriesJsonInput<S> & { parse? }` — so this is purely an
+ * inference fix, not a surface change.
  */
 export function useTimeSeries(input, key) {
     // eslint-disable-next-line react-hooks/exhaustive-deps

package/dist/useTimeSeries.js.map

@@ -1 +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"}
+{"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;AAOrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAC3B,KAA2D,EAC3D,GAAY;IAEZ,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pond-ts/react",
-  "version": "0.17.1",
+  "version": "0.19.0",
   "description": "React hooks for pond-ts live time series",
   "license": "MIT",
   "repository": {
@@ -27,11 +27,12 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "prepack": "cp ../../README.md ./README.md && cp ../../LICENSE ./LICENSE && cp ../../CHANGELOG.md ./CHANGELOG.md && npm run build",
-    "test": "vitest run",
+    "test": "npm run test:type && npm run test:runtime",
+    "test:type": "tsc -p tsconfig.types.json",
     "test:runtime": "vitest run"
   },
   "peerDependencies": {
-    "pond-ts": "^0.17.0",
+    "pond-ts": "^0.19.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {