@pond-ts/charts 0.68.0 → 0.69.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. package/AGENTS.md +12 -3
  2. package/API.md +79 -75
  3. package/CHANGELOG.md +81 -1
  4. package/README.md +4 -0
  5. package/dist/ChartContainer.d.ts +23 -0
  6. package/dist/ChartContainer.js +15 -4
  7. package/dist/XAxis.d.ts +13 -1
  8. package/dist/XAxis.js +35 -3
  9. package/dist/context.d.ts +14 -0
  10. package/dist/index.d.ts +2 -2
  11. package/dist/index.js +1 -1
  12. package/dist/tickLadder.d.ts +66 -20
  13. package/dist/tickLadder.js +178 -105
  14. package/dist/tradingTimeScale.d.ts +44 -3
  15. package/dist/tradingTimeScale.js +113 -38
  16. package/package.json +6 -4
package/AGENTS.md CHANGED
@@ -60,8 +60,9 @@ const s = TimeSeries.fromJSON({
60
60
  ```
61
61
 
62
62
  Time cells accept ms-since-epoch numbers, `Date`s, or ISO strings **with an
63
- offset** (`…Z`, `…+01:00`). A wall-clock string with no offset throws unless
64
- you pass `parse: { timeZone: 'America/New_York' }`.
63
+ offset** (`…Z`, `…+01:00`). A wall-clock string with no offset is read as
64
+ **UTC** unless you pass `parse: { timeZone: 'America/New_York' }` — it does
65
+ not throw, it silently shifts by the zone's offset.
65
66
 
66
67
  Other doors: `TimeSeries.fromPoints(points)` for wide `{ ts, a, b }` rows,
67
68
  `fromColumns` for struct-of-arrays / `Float64Array`, `fromArrow` for an Arrow
@@ -214,7 +215,8 @@ them; `import { STUDIES } from '@pond-ts/financial/catalog'` lists them at runti
214
215
  event); `align` puts rows on a grid without reducing.
215
216
  3. **`Sequence.every('1M')` for months.** Not fixed-length → use
216
217
  `Sequence.calendar('month', { timeZone })`.
217
- 4. **Wall-clock strings without a zone.** `'2025-01-01T09:00'` throws; add
218
+ 4. **Wall-clock strings without a zone.** `'2025-01-01T09:00'` is read as
219
+ UTC — no error, every instant shifted by your offset. Add
218
220
  `parse: { timeZone }` or use offset strings / ms numbers.
219
221
  5. **Unsorted rows.** The constructor throws and names the row; pass
220
222
  `sort: true` rather than sorting by hand.
@@ -227,6 +229,13 @@ them; `import { STUDIES } from '@pond-ts/financial/catalog'` lists them at runti
227
229
  9. **Reaching for a chart-library adapter first.** If the project uses React,
228
230
  `@pond-ts/charts` consumes the series with no adapter; `toPoints()` is the
229
231
  bridge for other libraries.
232
+ 10. **Aggregating in one zone and charting in another.** `Sequence.calendar`
233
+ defaults to **UTC**; a chart's time axis defaults to the **viewer's**
234
+ zone. Pass the same `timeZone` to both — `Sequence.calendar('day', {
235
+ timeZone })` and `<ChartContainer timeZone={timeZone}>` — and a bucket
236
+ edge and the tick that labels it are one instant. A
237
+ `TradingCalendar.fromRules` carries its zone; `calendar={cal}` renders in
238
+ it with no further wiring.
230
239
 
231
240
  ## Where to read next
232
241
 
package/API.md CHANGED
@@ -45,7 +45,7 @@ next door is the point.
45
45
  | `TimeSeries` | Immutable time-indexed collection, columnar storage | `packages/core/src/batch/time-series.ts` |
46
46
  | `ValueSeries` | Series keyed by a monotonic non-time value axis | `packages/core/src/batch/value-series.ts` |
47
47
  | `PartitionedTimeSeries` | Scoped view for per-partition stateful transforms; `<S, K, By>` — `By` is the partition column names, carried into `aggregate` / `rolling` result types | `packages/core/src/batch/partitioned-time-series.ts` |
48
- | `Sequence` | Infinite grid of time buckets (daily, hourly, every N) | `packages/core/src/sequence/sequence.ts` |
48
+ | `Sequence` | Infinite grid of time buckets: fixed-step (hourly, every N) or calendar (day/week/month/quarter/year in an IANA zone, default UTC) | `packages/core/src/sequence/sequence.ts` |
49
49
  | `BoundedSequence` | Finite ordered list of explicit interval buckets | `packages/core/src/sequence/bounded-sequence.ts` |
50
50
 
51
51
  Static constructors on `TimeSeries`: `fromJSON()` (row tuples/objects),
@@ -99,13 +99,14 @@ Value-axis wire types
99
99
 
100
100
  ### Temporal keys & events
101
101
 
102
- | Export | Purpose | Source |
103
- | ------------- | --------------------------------------------- | -------------------------------------- |
104
- | `Time` | Point-in-time event key | `packages/core/src/core/time.ts` |
105
- | `TimeRange` | Interval event key (start/end) | `packages/core/src/core/time-range.ts` |
106
- | `Interval` | Labeled time-interval event key | `packages/core/src/core/interval.ts` |
107
- | `Event` | Immutable event: temporal key + typed payload | `packages/core/src/core/event.ts` |
108
- | `toTimeRange` | Coerce temporal values to `TimeRange` | `packages/core/src/core/time-range.ts` |
102
+ | Export | Purpose | Source |
103
+ | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
104
+ | `Time` | Point-in-time event key | `packages/core/src/core/time.ts` |
105
+ | `TimeRange` | Interval event key (start/end) | `packages/core/src/core/time-range.ts` |
106
+ | `Interval` | Labeled time-interval event key | `packages/core/src/core/interval.ts` |
107
+ | `TimeZone` | IANA zone as a calendar: `startOf` / `next` / `parts` / `instant` / `offsetAt` / `abbreviation`; interned, transition-cached; what `Sequence.calendar` buckets with | `packages/core/src/core/time-zone.ts` |
108
+ | `Event` | Immutable event: temporal key + typed payload | `packages/core/src/core/event.ts` |
109
+ | `toTimeRange` | Coerce temporal values to `TimeRange` | `packages/core/src/core/time-range.ts` |
109
110
 
110
111
  ### TimeSeries methods (all in `packages/core/src/batch/time-series.ts`)
111
112
 
@@ -158,14 +159,14 @@ Deliberately small — the ordering-based slice of the algebra, no calendar ops
158
159
 
159
160
  ### Key exported types (batch)
160
161
 
161
- | Type group | Names | Source |
162
- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
163
- | Schema contract | `SeriesSchema`, `RowForSchema`, `EventForSchema`, `EventDataForSchema`, `EventKeyForSchema`, `TimeSeriesInput`, `TimeSeriesJsonInput` | `packages/core/src/schema/index.ts` |
164
- | Aggregation specs | `AggregateReducer`, `AggregateMap`, `AggregateOutputMap`, `AggregateSchema`, `BinReducerName`, `BinOutput` | `packages/core/src/schema/index.ts`, `packages/core/src/column.ts` |
165
- | Operation schemas | `RollingSchema`, `RollingAlignment`, `AlignSchema`, `DiffSchema`, `SmoothSchema`, `SmoothMethod`, `FillStrategy`, `FillMapping` | `packages/core/src/schema/index.ts` |
166
- | Column/data kinds | `Column`, `KeyColumn`, `ColumnKind`, `ScalarKind`, `ScalarValue`, `ColumnValue`, `ArrayValue`, `ValidityBitmap` | `packages/core/src/columnar/` |
167
- | JSON wire format | `JsonRowFormat`, `JsonRowForSchema`, `JsonObjectRowForSchema`, `JsonValueForKind`, `JsonTimestampInput`, `JsonTimeRangeInput`, `JsonIntervalInput` | `packages/core/src/schema/index.ts` |
168
- | Temporal utility | `TemporalLike`, `DurationInput`, `CalendarUnit`, `TimeZoneOptions`, `KeyLike`, `BatchSampleStrategy`, `SequenceSample`, `SequenceCoverage` | `packages/core/src/core/`, `packages/core/src/sequence/` |
162
+ | Type group | Names | Source |
163
+ | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
164
+ | Schema contract | `SeriesSchema`, `RowForSchema`, `EventForSchema`, `EventDataForSchema`, `EventKeyForSchema`, `TimeSeriesInput`, `TimeSeriesJsonInput` | `packages/core/src/schema/index.ts` |
165
+ | Aggregation specs | `AggregateReducer`, `AggregateMap`, `AggregateOutputMap`, `AggregateSchema`, `BinReducerName`, `BinOutput` | `packages/core/src/schema/index.ts`, `packages/core/src/column.ts` |
166
+ | Operation schemas | `RollingSchema`, `RollingAlignment`, `AlignSchema`, `DiffSchema`, `SmoothSchema`, `SmoothMethod`, `FillStrategy`, `FillMapping` | `packages/core/src/schema/index.ts` |
167
+ | Column/data kinds | `Column`, `KeyColumn`, `ColumnKind`, `ScalarKind`, `ScalarValue`, `ColumnValue`, `ArrayValue`, `ValidityBitmap` | `packages/core/src/columnar/` |
168
+ | JSON wire format | `JsonRowFormat`, `JsonRowForSchema`, `JsonObjectRowForSchema`, `JsonValueForKind`, `JsonTimestampInput`, `JsonTimeRangeInput`, `JsonIntervalInput` | `packages/core/src/schema/index.ts` |
169
+ | Temporal utility | `TemporalLike`, `DurationInput`, `CalendarUnit`, `TimeZoneOptions`, `Disambiguation`, `ZonedParts`, `ZonedPartsInput`, `StartOfOptions`, `KeyLike`, `BatchSampleStrategy`, `SequenceSample`, `SequenceCoverage` | `packages/core/src/core/`, `packages/core/src/sequence/` |
169
170
 
170
171
  The `pond-ts/types` subpath re-exports the schema-as-contract types with zero
171
172
  runtime (`packages/core/src/schema/public.ts`).
@@ -250,17 +251,17 @@ Types: `UseSnapshotOptions`, `SnapshotSource` (structural — covers
250
251
 
251
252
  ### Components — layout & axes
252
253
 
253
- | Component | Key props | Purpose | Source |
254
- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
255
- | `ChartContainer` | `width`, `range?`, `theme?`, `cursor?`, `panZoom?`, `xScale?`, `bounds?`, `showAxis?`, `calendar?`, `origin?`, `maxBandWidth?`/`bandAlign?`, `onTrackerChanged?`, `onDrawStats?` | Root: shared x-scale, interactions, annotations | `packages/charts/src/ChartContainer.tsx` |
256
- | `ChartRow` | `height`, `cursor?` (deprecated — mount a cursor in the row) | One stacked plot band; owns its y-axes | `packages/charts/src/ChartRow.tsx` |
257
- | `Layers` | children | Mandatory z-stack inside a row (back-to-front) | `packages/charts/src/Layers.tsx` |
258
- | `YAxis` | `id` (req), `side?`, `scale?` (`'linear'` \| `'log'` \| `'symlog'`), `linearWindow?`, `min?`/`max?`, `format?`, `width?`, `hide?` | Y-axis gutter; layers bind via their `axis` prop | `packages/charts/src/YAxis.tsx` |
259
- | `XAxis` | `side?`, `label?`, `format?`, `ticks?`, `transform?`, `dateStyle?` | Placeable x-axis strip; kind inferred from data | `packages/charts/src/XAxis.tsx` |
260
- | `TimeAxis` / `CategoryAxis` | (XAxis props) | Thin `XAxis` presets | `packages/charts/src/TimeAxis.tsx`, `CategoryAxis.tsx` |
261
- | `Canvas` | `width`, `height`, `draw` | Low-level DPR-aware canvas primitive | `packages/charts/src/Canvas.tsx` |
262
- | `Selector` | `enabled?` (default `true`), `selected?` (mark \| set), `hovered?`, `onSelect?`, `onHover?`, `children?` | Wraps its scope; mounting enables click-select and owns the state it drives (RFC A10) | `packages/charts/src/selectors.tsx` |
263
- | `MultiSelector` | `enabled?`, `selected?`, `hovered?`, `sequence?`, `onSelect?`, `onHover?`, `children?` | Sweep-select superset of `Selector`: drag sweeps marks, release reports `(hits, modifiers, spans)` — plural, one per swept layer (RFC A5.2) | `packages/charts/src/selectors.tsx` |
254
+ | Component | Key props | Purpose | Source |
255
+ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
256
+ | `ChartContainer` | `width`, `range?`, `theme?`, `cursor?`, `panZoom?`, `xScale?`, `bounds?`, `showAxis?`, `calendar?`, `timeZone?`, `origin?`, `maxBandWidth?`/`bandAlign?`, `onTrackerChanged?`, `onDrawStats?` | Root: shared x-scale, interactions, annotations; `timeZone` renders the time axis in an IANA zone (default: viewer-local; a `calendar.timeZone` supplies the default) | `packages/charts/src/ChartContainer.tsx` |
257
+ | `ChartRow` | `height`, `cursor?` (deprecated — mount a cursor in the row) | One stacked plot band; owns its y-axes | `packages/charts/src/ChartRow.tsx` |
258
+ | `Layers` | children | Mandatory z-stack inside a row (back-to-front) | `packages/charts/src/Layers.tsx` |
259
+ | `YAxis` | `id` (req), `side?`, `scale?` (`'linear'` \| `'log'` \| `'symlog'`), `linearWindow?`, `min?`/`max?`, `format?`, `width?`, `hide?` | Y-axis gutter; layers bind via their `axis` prop | `packages/charts/src/YAxis.tsx` |
260
+ | `XAxis` | `side?`, `label?`, `format?`, `ticks?`, `transform?`, `dateStyle?`, `timeZone?` (this strip in another IANA zone) | Placeable x-axis strip; kind inferred from data | `packages/charts/src/XAxis.tsx` |
261
+ | `TimeAxis` / `CategoryAxis` | (XAxis props) | Thin `XAxis` presets | `packages/charts/src/TimeAxis.tsx`, `CategoryAxis.tsx` |
262
+ | `Canvas` | `width`, `height`, `draw` | Low-level DPR-aware canvas primitive | `packages/charts/src/Canvas.tsx` |
263
+ | `Selector` | `enabled?` (default `true`), `selected?` (mark \| set), `hovered?`, `onSelect?`, `onHover?`, `children?` | Wraps its scope; mounting enables click-select and owns the state it drives (RFC A10) | `packages/charts/src/selectors.tsx` |
264
+ | `MultiSelector` | `enabled?`, `selected?`, `hovered?`, `sequence?`, `onSelect?`, `onHover?`, `children?` | Sweep-select superset of `Selector`: drag sweeps marks, release reports `(hits, modifiers, spans)` — plural, one per swept layer (RFC A5.2) | `packages/charts/src/selectors.tsx` |
264
265
 
265
266
  ### Components — draw layers
266
267
 
@@ -386,44 +387,47 @@ Series shapes (same file): `ChartSeries`, `BandSeries`, `BoxSeries`,
386
387
 
387
388
  ### Live values, scales & key types
388
389
 
389
- | Export | Purpose | Source |
390
- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------- | ----------------------------------------- |
391
- | `createLiveValue` / `LiveValue` | Imperative push channel for high-frequency indicator updates (isolated repaint) | `packages/charts/src/indicators.tsx` |
392
- | `scaleTradingTime` / `TradingTimeScale` | Discontinuous time scale collapsing closed-market gaps | `packages/charts/src/tradingTimeScale.ts` |
393
- | `DiscontinuityProvider` | Gap topology consumed by the trading-time scale | `packages/charts/src/tradingTimeScale.ts` |
394
- | `scaleBand` / `ScaleBand` | Ordinal slot scale for the category axis | `packages/charts/src/bandScale.ts` |
395
- | `GapMode` | `'none' \| 'empty' \| 'dashed' \| 'step' \| 'fade'` (Line/Area `gaps` prop) | `packages/charts/src/gaps.ts` |
396
- | `DecimateOption` | `<LineChart decimate>` — M4 viewport decimation (`bool \| { threshold }`) | `packages/charts/src/decimate.ts` |
397
- | `CursorMode` | `'none' \| 'line' \| 'point' \| 'inline' \| 'flag' \| 'crosshair' \| 'region'` | `packages/charts/src/context.ts` |
398
- | `TrackerInfo` / `TrackerSample` | Hover readout payload (`onTrackerChanged`) | `packages/charts/src/context.ts` |
399
- | `AnnotationKind` / `CreateSpec` | Annotation identity + draw-gesture payload (`onCreate`) | `packages/charts/src/context.ts` |
400
- | `SelectInfo` | Selection/hover payload (`Selector`/`MultiSelector` `onSelect`/`onHover`) | `packages/charts/src/context.ts` |
401
- | `SelectModifiers` | Keyboard modifiers on a click, 2nd arg to `onSelect` | `packages/charts/src/context.ts` |
402
- | `SelectorProps` | `<Selector>`'s props — `enabled?` / `selected?` / `hovered?` / `onSelect?` / `onHover?` / `children?` | `packages/charts/src/selectors.tsx` |
403
- | `MultiSelectorProps` | `<MultiSelector>`'s props — the above plus `sequence?`, with plural callbacks | `packages/charts/src/selectors.tsx` |
404
- | `RangeSpan` | `<RangeCursor onDragRelease>` payload — `{ x: [lo, hi], y? }` in axis units | `packages/charts/src/context.ts` |
405
- | `SpanSelection` | Range entry for `selected` — one layer's marks over `x`/`y`/`rows` (RFC A5.2) | `packages/charts/src/context.ts` |
406
- | `SelectionEntry` | One `selected` array entry: `SelectInfo \| SpanSelection` | `packages/charts/src/context.ts` |
407
- | `selectionContains` | Is a hit in a mixed selection? The same membership predicate the layers run | `packages/charts/src/span.ts` |
408
- | `sameMark` | Are two hits the same mark? Full identity (`id`, `mark`-or-`key`, `label`) | `packages/charts/src/span.ts` |
409
- | `isSpanSelection` | Entry discriminant — narrows a `SelectionEntry` to `SpanSelection` | `packages/charts/src/span.ts` |
410
- | `DrawStatsFrame` / `LayerDrawInfo` | Per-repaint draw-cost + decimation stats (`ChartContainer` `onDrawStats`) | `packages/charts/src/context.ts` |
411
- | `TimeGrain` | Coarse time unit for grain-aware formatting | `packages/charts/src/tickLadder.ts` |
412
- | `SwatchSpec` / `LegendItemInput` | Legend swatch vocabulary + explicit-rows input (`<Legend items>`) | `packages/charts/src/swatch.ts` |
413
- | `useChartLegend` | Headless legend hook: rows (items grouped by chart row) + `hover`/`select` verbs | `packages/charts/src/useChartLegend.ts` |
414
- | `ChartLegend` / `LegendRow` / `LegendItem` | The hook's return shape (`rows` group `items`; items carry `selected`/`hovered`) | `packages/charts/src/useChartLegend.ts` |
415
- | `useChartFrame` | Resolved plot geometry: plot rect, gutters, x scale, a row's y scales, band slot edges | `packages/charts/src/useChartFrame.ts` |
416
- | `ChartFrame` / `ChartFrameRow` | The hook's return shape — container x half, plus a row y half that is `null` outside a `<ChartRow>` | `packages/charts/src/useChartFrame.ts` |
417
- | `ChartBands` / `ChartBand` | Ordinal slot geometry on a category axis (`count`/`pitch`/`labels`/`at(i)`); `null` on time/value | `packages/charts/src/useChartFrame.ts` |
418
- | `ChartXScale` | The union the container's shared x scale resolves to (time / linear / trading / band / elapsed) | `packages/charts/src/context.ts` |
419
- | `LegendPlacement` | `'top-left' \| 'top-right' \| 'bottom-left' \| 'bottom-right'` | `packages/charts/src/Legend.tsx` |
420
- | `Curve` | Path interpolation: `'linear' \| 'monotone' \| 'natural' \| 'basis' \| 'step'` | `packages/charts/src/curve.ts` |
421
- | `RadiusEncoding` / `ColorEncoding` | Data-driven scatter size/colour | `packages/charts/src/encoding.ts` |
422
- | `CandleVariant` / `ColorBy` | OHLC mark shape / colouring strategy | `packages/charts/src/ohlc.ts` |
423
- | `AxisFormat` / `CursorFormat` | Tick and cursor-readout formatting (d3 specifier or fn) | `packages/charts/src/format.ts` |
424
- | `AxisTransform` | Monotonic `to`/`from` pair for derived-unit x-axis relabeling | `packages/charts/src/derivedTicks.ts` |
425
- | `AxisMouseEvent` / `AxisMouseHandler` | Axis `onMouseEvent` payload — the mouse event, the axis's `id`, and the value/label under the pointer | `packages/charts/src/axis-events.ts` |
426
- | `Orientation` | Bar growth direction | `packages/charts/src/bars.ts` |
390
+ | Export | Purpose | Source |
391
+ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- |
392
+ | `createLiveValue` / `LiveValue` | Imperative push channel for high-frequency indicator updates (isolated repaint) | `packages/charts/src/indicators.tsx` |
393
+ | `scaleTradingTime` / `TradingTimeScale` | Discontinuous time scale collapsing closed-market gaps; `scaleTradingTime(provider, { timeZone })` runs its tick ladder and labels in an IANA zone; `.withTimeZone(zone)` / `.timeZone()` re-derive the same mapping in another zone | `packages/charts/src/tradingTimeScale.ts` |
394
+ | `DiscontinuityProvider` | Gap topology consumed by the trading-time scale; optional `withTimeZone(zone)` for providers whose day anchors move with the zone | `packages/charts/src/tradingTimeScale.ts` |
395
+ | `identityProvider` | The gap-free provider a plain continuous time axis runs on; `identityProvider({ timeZone })` puts its day anchors on that zone's midnights | `packages/charts/src/tradingTimeScale.ts` |
396
+ | `TradingCalendarLike` | Structural shape of a trading calendar `ChartContainer calendar` accepts: `discontinuities({ spacing })` + optional `timeZone` (the axis default) | `packages/charts/src/tradingTimeScale.ts` |
397
+ | `ScaleTimeZoneOptions` | `{ timeZone? }` for `scaleTradingTime` / `identityProvider` | `packages/charts/src/tradingTimeScale.ts` |
398
+ | `scaleBand` / `ScaleBand` | Ordinal slot scale for the category axis | `packages/charts/src/bandScale.ts` |
399
+ | `GapMode` | `'none' \| 'empty' \| 'dashed' \| 'step' \| 'fade'` (Line/Area `gaps` prop) | `packages/charts/src/gaps.ts` |
400
+ | `DecimateOption` | `<LineChart decimate>` — M4 viewport decimation (`bool \| { threshold }`) | `packages/charts/src/decimate.ts` |
401
+ | `CursorMode` | `'none' \| 'line' \| 'point' \| 'inline' \| 'flag' \| 'crosshair' \| 'region'` | `packages/charts/src/context.ts` |
402
+ | `TrackerInfo` / `TrackerSample` | Hover readout payload (`onTrackerChanged`) | `packages/charts/src/context.ts` |
403
+ | `AnnotationKind` / `CreateSpec` | Annotation identity + draw-gesture payload (`onCreate`) | `packages/charts/src/context.ts` |
404
+ | `SelectInfo` | Selection/hover payload (`Selector`/`MultiSelector` `onSelect`/`onHover`) | `packages/charts/src/context.ts` |
405
+ | `SelectModifiers` | Keyboard modifiers on a click, 2nd arg to `onSelect` | `packages/charts/src/context.ts` |
406
+ | `SelectorProps` | `<Selector>`'s props — `enabled?` / `selected?` / `hovered?` / `onSelect?` / `onHover?` / `children?` | `packages/charts/src/selectors.tsx` |
407
+ | `MultiSelectorProps` | `<MultiSelector>`'s props — the above plus `sequence?`, with plural callbacks | `packages/charts/src/selectors.tsx` |
408
+ | `RangeSpan` | `<RangeCursor onDragRelease>` payload — `{ x: [lo, hi], y? }` in axis units | `packages/charts/src/context.ts` |
409
+ | `SpanSelection` | Range entry for `selected` — one layer's marks over `x`/`y`/`rows` (RFC A5.2) | `packages/charts/src/context.ts` |
410
+ | `SelectionEntry` | One `selected` array entry: `SelectInfo \| SpanSelection` | `packages/charts/src/context.ts` |
411
+ | `selectionContains` | Is a hit in a mixed selection? The same membership predicate the layers run | `packages/charts/src/span.ts` |
412
+ | `sameMark` | Are two hits the same mark? Full identity (`id`, `mark`-or-`key`, `label`) | `packages/charts/src/span.ts` |
413
+ | `isSpanSelection` | Entry discriminant — narrows a `SelectionEntry` to `SpanSelection` | `packages/charts/src/span.ts` |
414
+ | `DrawStatsFrame` / `LayerDrawInfo` | Per-repaint draw-cost + decimation stats (`ChartContainer` `onDrawStats`) | `packages/charts/src/context.ts` |
415
+ | `TimeGrain` | Coarse time unit for grain-aware formatting | `packages/charts/src/tickLadder.ts` |
416
+ | `SwatchSpec` / `LegendItemInput` | Legend swatch vocabulary + explicit-rows input (`<Legend items>`) | `packages/charts/src/swatch.ts` |
417
+ | `useChartLegend` | Headless legend hook: rows (items grouped by chart row) + `hover`/`select` verbs | `packages/charts/src/useChartLegend.ts` |
418
+ | `ChartLegend` / `LegendRow` / `LegendItem` | The hook's return shape (`rows` group `items`; items carry `selected`/`hovered`) | `packages/charts/src/useChartLegend.ts` |
419
+ | `useChartFrame` | Resolved plot geometry: plot rect, gutters, x scale, a row's y scales, band slot edges | `packages/charts/src/useChartFrame.ts` |
420
+ | `ChartFrame` / `ChartFrameRow` | The hook's return shape — container x half, plus a row y half that is `null` outside a `<ChartRow>` | `packages/charts/src/useChartFrame.ts` |
421
+ | `ChartBands` / `ChartBand` | Ordinal slot geometry on a category axis (`count`/`pitch`/`labels`/`at(i)`); `null` on time/value | `packages/charts/src/useChartFrame.ts` |
422
+ | `ChartXScale` | The union the container's shared x scale resolves to (time / linear / trading / band / elapsed) | `packages/charts/src/context.ts` |
423
+ | `LegendPlacement` | `'top-left' \| 'top-right' \| 'bottom-left' \| 'bottom-right'` | `packages/charts/src/Legend.tsx` |
424
+ | `Curve` | Path interpolation: `'linear' \| 'monotone' \| 'natural' \| 'basis' \| 'step'` | `packages/charts/src/curve.ts` |
425
+ | `RadiusEncoding` / `ColorEncoding` | Data-driven scatter size/colour | `packages/charts/src/encoding.ts` |
426
+ | `CandleVariant` / `ColorBy` | OHLC mark shape / colouring strategy | `packages/charts/src/ohlc.ts` |
427
+ | `AxisFormat` / `CursorFormat` | Tick and cursor-readout formatting (d3 specifier or fn) | `packages/charts/src/format.ts` |
428
+ | `AxisTransform` | Monotonic `to`/`from` pair for derived-unit x-axis relabeling | `packages/charts/src/derivedTicks.ts` |
429
+ | `AxisMouseEvent` / `AxisMouseHandler` | Axis `onMouseEvent` payload — the mouse event, the axis's `id`, and the value/label under the pointer | `packages/charts/src/axis-events.ts` |
430
+ | `Orientation` | Bar growth direction | `packages/charts/src/bars.ts` |
427
431
 
428
432
  ---
429
433
 
@@ -618,16 +622,16 @@ erased types. A separate subpath: importing it pulls in every study.
618
622
 
619
623
  ### Trading calendars & sessions
620
624
 
621
- | Export | Purpose | Source |
622
- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
623
- | `TradingCalendar` | Query API: `.sessions()`, `.sessionOn()`, `.isTradingDay()`, `.isOpen()`, `.sessionsInRange()`, `.sessionSequence()`, `.barSequence(period)`, `.tagSessions()`, `.discontinuities()` | `packages/financial/src/calendar/` |
624
- | `generateSessions` | `Session[]` from `SessionRules` over a date range (DST-correct) | `packages/financial/src/calendar/` |
625
- | `normalizeSessions` | Validate + sort an explicit session list | `packages/financial/src/calendar/` |
626
- | `identityDiscontinuity` / `segmentDiscontinuity` / `weekendSkip` | `DiscontinuityProvider`s for the trading-time axis | `packages/financial/src/calendar/` |
627
- | Types | `Session`, `SessionBreak`, `SessionRules`, `DateRange`, `InstantRange`, `TaggedSchema`, `LiveSegment`, `DiscontinuityProvider` | `packages/financial/src/calendar/` |
628
- | `SessionSource` / `SessionAnchorOptions` | The session-anchored studies' input: `TradingCalendar \| Session[]` (`sessions`), or a session-id column name (`session`), plus `stamped` | `packages/financial/src/contract/session-anchor.ts` |
629
- | `PIVOT_METHODS` / `PivotMethod` | The four pivot formula sets (`standard`, `fibonacci`, `woodie`, `camarilla`) | `packages/financial/src/kernels/pivot.ts` |
630
- | `PivotPointsSchema` / `CamarillaPivotPointsSchema` / `PivotPointsResult` | `pivotPoints`' method-dependent appended-schema types (7 columns, or 9 for Camarilla) | `packages/financial/src/studies/pivot-points.ts` |
625
+ | Export | Purpose | Source |
626
+ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
627
+ | `TradingCalendar` | `timeZone` (the exchange zone: `fromRules`' `rules.timeZone`, or `fromSessions(list, { timeZone })`) + query API: `.sessions()`, `.sessionOn()`, `.isTradingDay()`, `.isOpen()`, `.sessionsInRange()`, `.sessionSequence()`, `.barSequence(period)`, `.tagSessions()`, `.discontinuities()` | `packages/financial/src/calendar/` |
628
+ | `generateSessions` | `Session[]` from `SessionRules` over a date range (DST-correct) | `packages/financial/src/calendar/` |
629
+ | `normalizeSessions` | Validate + sort an explicit session list | `packages/financial/src/calendar/` |
630
+ | `identityDiscontinuity` / `segmentDiscontinuity` / `weekendSkip` | `DiscontinuityProvider`s for the trading-time axis | `packages/financial/src/calendar/` |
631
+ | Types | `Session`, `SessionBreak`, `SessionRules`, `DateRange`, `InstantRange`, `TaggedSchema`, `LiveSegment`, `DiscontinuityProvider` | `packages/financial/src/calendar/` |
632
+ | `SessionSource` / `SessionAnchorOptions` | The session-anchored studies' input: `TradingCalendar \| Session[]` (`sessions`), or a session-id column name (`session`), plus `stamped` | `packages/financial/src/contract/session-anchor.ts` |
633
+ | `PIVOT_METHODS` / `PivotMethod` | The four pivot formula sets (`standard`, `fibonacci`, `woodie`, `camarilla`) | `packages/financial/src/kernels/pivot.ts` |
634
+ | `PivotPointsSchema` / `CamarillaPivotPointsSchema` / `PivotPointsResult` | `pivotPoints`' method-dependent appended-schema types (7 columns, or 9 for Camarilla) | `packages/financial/src/studies/pivot-points.ts` |
631
635
 
632
636
  ### Contract & constants
633
637
 
package/CHANGELOG.md CHANGED
@@ -8,7 +8,8 @@ The `@pond-ts` packages — `pond-ts`, `@pond-ts/react`, `@pond-ts/charts`,
8
8
  under a single `v*` tag, so this file covers them all. Pre-1.0: minor bumps may
9
9
  include new features and type-level changes; patch bumps are strictly additive.
10
10
 
11
- [Unreleased]: https://github.com/pond-ts/pond/compare/v0.68.0...HEAD
11
+ [Unreleased]: https://github.com/pond-ts/pond/compare/v0.69.0...HEAD
12
+ [0.69.0]: https://github.com/pond-ts/pond/compare/v0.68.0...v0.69.0
12
13
  [0.68.0]: https://github.com/pond-ts/pond/compare/v0.67.0...v0.68.0
13
14
  [0.67.0]: https://github.com/pond-ts/pond/compare/v0.66.0...v0.67.0
14
15
  [0.66.0]: https://github.com/pond-ts/pond/compare/v0.65.0...v0.66.0
@@ -71,6 +72,85 @@ include new features and type-level changes; patch bumps are strictly additive.
71
72
 
72
73
  ## [Unreleased]
73
74
 
75
+ ## [0.69.0] — 2026-09-13
76
+
77
+ ### Added
78
+
79
+ - **`<ChartContainer timeZone>` — the time axis in any IANA zone
80
+ ([PND-TZAXIS]).** Day / week / month ticks land on that zone's midnights,
81
+ Mondays and month starts; labels, the stacked date bands, the hierarchical
82
+ grid, session dividers and every cursor / marker / annotation readout read
83
+ in it. **Omitted ⇒ the viewer's zone**, exactly as before. The d3 specifier
84
+ strings on `timeFormat` / `cursorFormat` are unchanged; `%Z` / `%z` now read
85
+ the zone's abbreviation / offset. Sub-day ticks align to the zone's wall
86
+ clock, so a 6 h grain reads 00 / 06 / 12 / 18 across a DST jump instead of
87
+ drifting by an hour until the next midnight. The resolved zone is on the
88
+ chart context as `timeZone`. Built on core's `TimeZone` ([PND-TZCAL]), so a
89
+ `Sequence.calendar('day', { timeZone })` bucket edge and the tick that
90
+ labels it are one instant — pinned by a cross-package test.
91
+ - **`<XAxis timeZone>` — a second strip in another zone.** Two time axes
92
+ over one shared mapping, each ticking and labelling (and pilling) in its
93
+ own zone: `<XAxis side="top" timeZone="America/New_York" />` above a
94
+ UTC container's own strip below. Backed by
95
+ `TradingTimeScale.withTimeZone(zone)` / `.timeZone()` and an optional
96
+ `DiscontinuityProvider.withTimeZone` (the identity provider re-derives its
97
+ day anchors; a trading calendar's session opens are zone-independent).
98
+ - **`TradingCalendarLike.timeZone?`** — a calendar that carries its exchange
99
+ zone supplies the axis default (`calendar={cal}` renders in exchange time
100
+ wherever it is viewed); an explicit `timeZone` prop wins.
101
+ - `scaleTradingTime(provider, { timeZone })` and
102
+ `identityProvider({ timeZone })` take the zone directly for consumers
103
+ building the scale themselves; `identityProvider`, `TradingCalendarLike`
104
+ and `ScaleTimeZoneOptions` are now exported. Internally the tick ladder
105
+ runs on a `TickCalendar` seam whose local implementation is the previous
106
+ `Date` arithmetic verbatim — the default path is unchanged.
107
+ - **`TradingCalendar.timeZone` ([PND-TZFIN]).** `@pond-ts/financial`'s
108
+ calendar keeps the zone its sessions were resolved in — `fromRules` carries
109
+ `rules.timeZone`, `fromSessions(list, { timeZone })` takes it — so
110
+ `<ChartContainer calendar={cal}>` renders the axis in exchange time with no
111
+ further wiring.
112
+ - `@pond-ts/charts` now depends on `d3-time-format` directly (it was already
113
+ a transitive dependency via `d3-scale`).
114
+ - **`TimeZone` — the zone-calendar primitive ([PND-TZCAL]).** `pond-ts`
115
+ exports `TimeZone.of(id)` (interned; also `TimeZone.UTC`,
116
+ `TimeZone.local()`) with `startOf(unit, t)`, `next(unit, t)`, `parts(t)`,
117
+ `instant(parts, { disambiguation })`, `offsetAt(t)` and
118
+ `abbreviation(t, { locale })`. Temporal underneath, but each zone caches its
119
+ offset transitions as it discovers them, so steady-state calls are integer
120
+ arithmetic: `startOf('day')` went from ~24 µs to ~23 ns per call, and a
121
+ three-year hourly series aggregated to `America/New_York` days from 38 ms
122
+ to 0.5 ms. `Sequence.calendar`, `TimeRange.fromCalendar` and
123
+ `Interval.fromCalendar` now bucket through it (no behaviour change; pinned
124
+ against Temporal on eight zones including southern-hemisphere DST, a
125
+ 30-minute DST shift, a +05:30 zone, a day with no midnight and Samoa's
126
+ skipped day). This is the primitive the charts' time axis will place and
127
+ label ticks with, so a bucket edge and the tick that labels it are one
128
+ instant. First task of the time-zone plan
129
+ (`docs/plans/PND_TIMEZONE_PLAN.md`).
130
+ - **`CalendarUnit` gains `'quarter'` and `'year'`** for
131
+ `Sequence.calendar`, `TimeRange.fromCalendar` and `Interval.fromCalendar`.
132
+
133
+ ### Changed
134
+
135
+ - **`Sequence.calendar` validates its inputs at construction.** An unknown
136
+ unit (`'hour'`) or zone (`'Nowhere'`) now throws `RangeError` immediately;
137
+ before, an unknown unit silently produced wrong buckets (the two unit
138
+ dispatchers fell through to different defaults — the 2026-06 audit's §6
139
+ finding) and an unknown zone failed only on first `bounded()`.
140
+
141
+ ### Fixed
142
+
143
+ - **`pond-ts`: two type-level corners of [PND-PARTCOL] (0.68.0) found by the Codex pass on #724.** (1) On a broad `TimeSeries<SeriesSchema>` with a _literal_ partition column, the injected `'first'` could not look up a kind and typed the column as `undefined`; `WithPartitionColumns` now takes the schema and leaves the mapping alone when the schema is broad, so the result type is exactly 0.67's. (2) `By` had no variance pin, so `PartitionedTimeSeries<S, K, 'host'>` accepted a view partitioned by `region` (and an untyped view could be narrowed to any column); a phantom contravariant member now rejects both while a specialised view still assigns to the legacy `PartitionedTimeSeries<S>` shape. Type tests cover both plus the `K`-survives-`smooth`/`baseline` claim. No runtime change.
144
+ - **Docs said a wall-clock string without `parse.timeZone` throws. It never
145
+ did** ([PND-TZDOCS]) — it is read as UTC, silently. `creating.mdx`, the
146
+ agent guide (`AGENTS.md`) and the decision table now say so and describe
147
+ how the shift shows up. The agent guide also gains the one time-zone rule:
148
+ pass the same `timeZone` to `Sequence.calendar` and `<ChartContainer>`.
149
+ The aggregation page cross-links `Sequence.calendar` for weekly / monthly
150
+ bars (issue #358 item 1, supersedes #359). The finance gallery's off-chart
151
+ readout takes the calendar's zone instead of hard-coding New York; the
152
+ Niño 3.4 heat map's year grain uses `Sequence.calendar('year')`.
153
+
74
154
  ## [0.68.0] — 2026-09-13
75
155
 
76
156
  ### Added
package/README.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # @pond-ts/charts
2
2
 
3
+ [![npm](https://img.shields.io/npm/v/@pond-ts/charts?label=%40pond-ts%2Fcharts)](https://www.npmjs.com/package/@pond-ts/charts)
4
+ [![CI](https://github.com/pond-ts/pond/actions/workflows/ci.yml/badge.svg)](https://github.com/pond-ts/pond/actions/workflows/ci.yml)
5
+ [![docs](https://img.shields.io/badge/docs-pond--ts.org-1f6feb)](https://pond-ts.org/docs/charts/)
6
+
3
7
  **React charts for [pond-ts](https://www.npmjs.com/package/pond-ts) time series.**
4
8
 
5
9
  A composable charting layer built directly on pond-ts series: a canvas data
package/dist/ChartContainer.d.ts CHANGED
@@ -192,6 +192,29 @@ export interface ChartContainerProps {
192
192
  * calendar reference (build it once, not inline in JSX).
193
193
  */
194
194
  calendar?: TradingCalendarLike;
195
+ /**
196
+ * The IANA **time zone the time axis renders in** — ticks land on that
197
+ * zone's midnights / Mondays / month starts, labels, grid, date bands,
198
+ * session dividers and every cursor / marker readout read in it.
199
+ * **Omitted ⇒ the viewer's own zone** (the runtime's), which is what every
200
+ * chart did before this prop existed; `'UTC'` or any id `Intl` knows
201
+ * (`'Europe/Berlin'`, `'Australia/Sydney'`, …) names one. A trading
202
+ * {@link calendar} that carries a `timeZone` (a `@pond-ts/financial`
203
+ * `TradingCalendar.fromRules`) supplies the default, so a NYSE chart reads
204
+ * New York time wherever it is viewed; an explicit prop still wins. The
205
+ * calendar's zone is used even when a low-level {@link discontinuities}
206
+ * provider overrides its gap topology — the calendar still says which
207
+ * exchange this is.
208
+ *
209
+ * Pair it with the aggregate that produced the data — the same primitive
210
+ * (`TimeZone`) places these ticks and cuts `Sequence.calendar` buckets, so
211
+ * `Sequence.calendar('day', { timeZone })` and `<ChartContainer timeZone>`
212
+ * given the same zone put a bucket edge and its tick on one instant.
213
+ * Function formatters (`timeFormat`, `cursorFormat`) still receive epoch ms;
214
+ * read the resolved zone from the chart context. An unknown id throws
215
+ * `RangeError`. Only affects a **time** axis.
216
+ */
217
+ timeZone?: string | undefined;
195
218
  /**
196
219
  * The trading axis **metric**, when a {@link calendar} is supplied
197
220
  * (trading-calendar RFC Q7). `'proportional'` (default) keeps time
package/dist/ChartContainer.js CHANGED
@@ -4,7 +4,7 @@ import { scaleLinear, scaleLog, scaleSymlog } from 'd3-scale';
4
4
  import { identityProvider, scaleTradingTime, } from './tradingTimeScale.js';
5
5
  import { scaleBand } from './bandScale.js';
6
6
  import { scaleElapsed } from './elapsed.js';
7
- import { Sequence } from 'pond-ts';
7
+ import { Sequence, TimeZone } from 'pond-ts';
8
8
  import { ContainerContext, CursorContext, } from './context.js';
9
9
  import { LegacyCursor, legacyCursorWarning, presetNameFor, warnOnDuplicateGestureOwners, } from './cursors.js';
10
10
  import { effectiveSelectorEntries, resolveControlledHovered, resolveControlledSelected, selectorEntryEqual, warnInertClick, } from './selectors.js';
@@ -198,7 +198,7 @@ function AutoSizeContainer(props) {
198
198
  * pass; a chart legitimately gated this long is not painting anyway. */
199
199
  const ZERO_SIZE_WARNING_MS = 600;
200
200
  /** {@link ChartContainer} with its width resolved to a concrete pixel number. */
201
- function ResolvedChartContainer({ range, categories: categoriesProp, maxBandWidth, bandAlign = 'start', width, height, rowGap = 0, showAxis = true, trackerPosition, onTrackerChanged, onDrawStats, panZoom = false, axisPanZoom = false, bounds, onTimeRangeChange, minDuration = 1, cursor: cursorProp, cursorSequence: cursorSequenceProp, onRegionSelect, regionSelectModifier, cursorTime: cursorTimeProp, crosshairSnap: crosshairSnapProp, editAnnotations = false, creating = null, onCreate, onSelectAnnotation, onHoverAnnotation, onEditAnnotation, snap = true, timeFormat, cursorFormat: cursorFormatProp, origin, theme, discontinuities, calendar, spacing, xScale: xScaleKind = 'linear', grid = true, sessionDividers = 'none', children, }) {
201
+ function ResolvedChartContainer({ range, categories: categoriesProp, maxBandWidth, bandAlign = 'start', width, height, rowGap = 0, showAxis = true, trackerPosition, onTrackerChanged, onDrawStats, panZoom = false, axisPanZoom = false, bounds, onTimeRangeChange, minDuration = 1, cursor: cursorProp, cursorSequence: cursorSequenceProp, onRegionSelect, regionSelectModifier, cursorTime: cursorTimeProp, crosshairSnap: crosshairSnapProp, editAnnotations = false, creating = null, onCreate, onSelectAnnotation, onHoverAnnotation, onEditAnnotation, snap = true, timeFormat, cursorFormat: cursorFormatProp, origin, theme, discontinuities, calendar, timeZone: timeZoneProp, spacing, xScale: xScaleKind = 'linear', grid = true, sessionDividers = 'none', children, }) {
202
202
  // ── Legacy cursor props (deprecated) ───────────────────────────────────────
203
203
  // The string surface keeps working for one minor: the resolved mode is
204
204
  // synthesized into the equivalent mounted preset below (`<LegacyCursor>`),
@@ -967,6 +967,13 @@ function ResolvedChartContainer({ range, categories: categoriesProp, maxBandWidt
967
967
  ? calendar.discontinuities(spacing ? { spacing } : undefined)
968
968
  : undefined, [resolvedKind, discontinuities, calendar, spacing]);
969
969
  const xDiscontinuities = resolvedKind === 'time' ? (discontinuities ?? calendarProvider) : undefined;
970
+ // The axis zone: the explicit prop, else the calendar's exchange zone, else
971
+ // runtime-local (`undefined`). Canonicalised through `TimeZone.of` so a bad
972
+ // id fails here, once, with its name, and so `'utc'` and `'UTC'` are one key.
973
+ const timeZone = useMemo(() => {
974
+ const id = timeZoneProp ?? calendar?.timeZone;
975
+ return id === undefined ? undefined : TimeZone.of(id).id;
976
+ }, [timeZoneProp, calendar]);
970
977
  // The shared x-side tick count — labels, x gridlines, session dividers, and
971
978
  // `formatTime` all pass this one value, so they derive from the same instants
972
979
  // (the alignment previously held by three hardcoded constants agreeing).
@@ -1147,7 +1154,7 @@ function ResolvedChartContainer({ range, categories: categoriesProp, maxBandWidt
1147
1154
  // sessions. Same tickFormat surface as scaleTime, so the readout is shared.
1148
1155
  // `xTickCount` reaches `tickFormat` too: the trading scale picks its anchor
1149
1156
  // grain from the count, so labels sit on the exact instants the ticks do.
1150
- const s = scaleTradingTime(xDiscontinuities)
1157
+ const s = scaleTradingTime(xDiscontinuities, { timeZone })
1151
1158
  .domain([d0, d1])
1152
1159
  .range([0, plotWidth]);
1153
1160
  if (elapsedOrigin !== undefined)
@@ -1164,7 +1171,7 @@ function ResolvedChartContainer({ range, categories: categoriesProp, maxBandWidt
1164
1171
  // never d3's mixed multi-scale default. Interactions stay on continuous
1165
1172
  // time math: the frame's `discontinuities` remains undefined, and identity
1166
1173
  // distance/offset are plain subtraction/addition anyway.
1167
- const s = scaleTradingTime(identityProvider())
1174
+ const s = scaleTradingTime(identityProvider({ timeZone }), { timeZone })
1168
1175
  .domain([d0, d1])
1169
1176
  .range([0, plotWidth]);
1170
1177
  if (elapsedOrigin !== undefined)
@@ -1187,6 +1194,7 @@ function ResolvedChartContainer({ range, categories: categoriesProp, maxBandWidt
1187
1194
  elapsedOrigin,
1188
1195
  xDiscontinuities,
1189
1196
  xTickCount,
1197
+ timeZone,
1190
1198
  ]);
1191
1199
  // The crosshair pixel (see resolveCursorX). A stored hoverX is a *plot* pixel;
1192
1200
  // if plotWidth changes mid-hover (a gutter reserving, or a width change) it's
@@ -1361,6 +1369,8 @@ function ResolvedChartContainer({ range, categories: categoriesProp, maxBandWidt
1361
1369
  onEditAnnotation,
1362
1370
  formatTime,
1363
1371
  formatReadout,
1372
+ timeZone,
1373
+ timeFormat,
1364
1374
  xFormatCustom: timeFormat !== undefined,
1365
1375
  xReadoutCustom: cursorFormat !== undefined,
1366
1376
  xTickCount,
@@ -1445,6 +1455,7 @@ function ResolvedChartContainer({ range, categories: categoriesProp, maxBandWidt
1445
1455
  onEditAnnotation,
1446
1456
  formatTime,
1447
1457
  formatReadout,
1458
+ timeZone,
1448
1459
  timeFormat,
1449
1460
  cursorFormat,
1450
1461
  xTickCount,
package/dist/XAxis.d.ts CHANGED
@@ -90,6 +90,18 @@ export interface XAxisProps {
90
90
  * measured fit (thin + middle-ellipsize) is what prevents collisions.
91
91
  */
92
92
  align?: 'auto' | 'center' | 'right';
93
+ /**
94
+ * Render **this strip** in an IANA zone other than the container's — the
95
+ * second axis of a two-zone pair (`<XAxis />` in the container's zone below
96
+ * the plot, `<XAxis side="top" timeZone="Asia/Tokyo" />` above it). Same
97
+ * pixel mapping, its own calendar: day ticks on *this* zone's midnights,
98
+ * labels, the date bands and this strip's cursor / marker pills reading in
99
+ * it. Time axis only; ignored under a `transform` or explicit `ticks`. A
100
+ * container `cursorFormat` still wins for the pill (it is its own channel);
101
+ * a container `timeFormat` string is re-resolved in this zone. Omit to
102
+ * follow the container's `timeZone` (or the viewer's zone).
103
+ */
104
+ timeZone?: string | undefined;
93
105
  /**
94
106
  * How a **time** axis lays out its date context (ignored on value / category
95
107
  * axes, and whenever a custom `format`, `transform`, or explicit `ticks`
@@ -140,6 +152,6 @@ export interface XAxisProps {
140
152
  * plot's own drag, including `bounds` / `minDuration` and the trading calendar.
141
153
  * A category axis has no continuous domain and stays inert.
142
154
  */
143
- export declare function XAxis({ format, label, side, height, ticks: customTicks, transform, color, align, dateStyle, onMouseEvent, }?: XAxisProps): import("react/jsx-runtime").JSX.Element;
155
+ export declare function XAxis({ format, label, side, height, ticks: customTicks, transform, color, align, dateStyle, timeZone, onMouseEvent, }?: XAxisProps): import("react/jsx-runtime").JSX.Element;
144
156
  export {};
145
157
  //# sourceMappingURL=XAxis.d.ts.map