pond-ts 0.45.0 → 0.47.0

package/CHANGELOG.md

@@ -8,7 +8,9 @@ The `@pond-ts` packages — `pond-ts`, `@pond-ts/react`, `@pond-ts/charts`,
 tag, so this file covers them all. 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.45.0...HEAD
+[Unreleased]: https://github.com/pond-ts/pond/compare/v0.47.0...HEAD
+[0.47.0]: https://github.com/pond-ts/pond/compare/v0.46.0...v0.47.0
+[0.46.0]: https://github.com/pjm17971/pond-ts/compare/v0.45.0...v0.46.0
 [0.45.0]: https://github.com/pjm17971/pond-ts/compare/v0.44.1...v0.45.0
 [0.44.1]: https://github.com/pjm17971/pond-ts/compare/v0.44.0...v0.44.1
 [0.44.0]: https://github.com/pjm17971/pond-ts/compare/v0.43.0...v0.44.0
@@ -44,6 +46,151 @@ and type-level changes; patch bumps are strictly additive.
 
 ## [Unreleased]
 
+## [0.47.0] — 2026-07-17
+
+### Added
+
+- **charts:** `<ChartContainer>` gains **`grid`** (default `true`) and
+  **`sessionDividers`** (`'labeled' | 'all' | 'none'`, default `'none'`).
+  On a calendar (time) axis the vertical gridlines are the **full grain
+  populations** — every day / month / aligned clock instant in view, not just
+  the thinned instants the labels chose (the labels decorate the grid; they
+  don't define it). Each grain fades as a unit by its **calendar density**
+  (nominal gap-free spacing: full ≥ 15 px, gone ≤ 5 px, quadratic), so
+  zooming out dissolves the fine grain into the coarser one — a map-style
+  hierarchical grid with no pop when the label algorithm switches rung — and
+  collapsing weekends draws _fewer_ day lines at the _same_ strength, not
+  wider-spaced lines that jump to full opacity. Session dividers are opt-in
+  emphasis over that grid, and draw only at true collapse **seams** —
+  boundaries that removed time actually precedes, not every session roll
+  (`'all'` = every seam, the TradingView separator look, crowding lines
+  fading out; `'labeled'` = only seams the axis also labels) — so a
+  `grid={false}` plot is actually clean by default and a contiguous-sessions
+  calendar seams only where days were excised. `TradingTimeScale` gains
+  **`gridLevels(minGapPx)`** (the nested per-grain populations + nominal
+  spacing behind it). In `'all'` mode, crowding session-divider lines fade on
+  a quadratic ramp (full ≥ 28 px apart, gone ≤ 6 px) so zooming out dissolves
+  them to a clean plot rather than a permanent gray wash.
+- **charts:** `<TimeAxis>` / `<XAxis>` gain a **`dateStyle`** prop
+  (`'flat' | 'stacked'`). `'flat'` — the new default — lays the date context
+  out on a **single row** the TradingView way: each tick that opens a coarser
+  calendar period is relabelled **inline** to it (the month at a month turn,
+  the year at a year turn, the date at a day turn under an intraday grain),
+  every other tick a terse label (`5`, `Feb`, `14:00`). `'stacked'` is the
+  two-row layout: a terse top row (the grain's bare unit) over a segmented
+  **band** row of the next-coarser period — **day** bands under intraday
+  ticks, **month** bands under day ticks, **year** bands under month/quarter
+  ticks — each a left-aligned label with a divider at its turn, **zebra-shaded**
+  by the band's calendar parity (pan/zoom-stable). The turn tick up top is
+  emphasized and joins its divider as one continuous boundary line; the partial
+  left band pins its label at the plot edge. Themeable via **`theme.axis.band`**
+  (`fill` — the shaded cell, "could be a background color"; `divider`; `label`).
+  `TradingTimeScale` gains `flatFormat(count)` (the flat single-row lookup),
+  `baseFormat(count)` (the terse stacked top row), and `bands(count)` (the band
+  segments); non-tick instants — the cursor readout — still read a full
+  timestamp.
+  The **window edge is never ticked** unless it is a genuine grain anchor (a
+  true session open, or an instant exactly on the grain — a midnight at day
+  grain, a month start at month grain): a mid-period edge tick sat pinned at
+  x=0 relabelling itself as the window panned (a sticky `8` at half-spacing, a
+  `15:23` under an hour grain) — misleading, and not something TradingView
+  draws. The first real calendar anchor now leads the axis.
+
+### Changed
+
+- **Docs hosting.** The documentation site has moved from GitHub Pages
+  (`pjm17971.github.io/pond-ts`) to Cloudflare Pages under the custom domain
+  **<https://pond-ts.org>**. Storybook now deploys as its own project served at
+  `pond-ts.org/storybook/` (via a small routing Worker, `workers/router/`),
+  rather than nested into the docs build. Doc links in the README are repointed;
+  the deploy workflow keeps the same `v*`-tag gate. See `MIGRATION.md`.
+- **charts:** the time axis now renders the **flat** single-row date style by
+  default (previously the two-row stacked layout). Every time chart — trading
+  or plain continuous, auto-rendered or explicit `<TimeAxis>` — picks this up.
+  Pass `dateStyle="stacked"` to keep the old two-row look. (An explicit
+  `format` / container `timeFormat`, a `transform`, or explicit `ticks` opt out
+  of both styles as before.)
+- **charts:** the time-axis tick ladder's sub-month density now thins each
+  month in **session-index space** — the reverse-engineered TradingView
+  algorithm, validated label-for-label against its output on the 2026 NYSE
+  calendar. Marks sit an equal number of _bars_ apart, so on a collapsed
+  trading axis they are **evenly spaced in pixels**, with no weekend snapping:
+  a month opening on a weekend anchors on its first session. Two regimes per
+  month: at dense zooms, a **uniform anchored stride** (the month's first
+  session, then every k-th, truncated so the gap to the next month label
+  stays ≥ the stride — the slack lands at the month end); at coarse zooms
+  (≤ 3 marks per month, where a truncated stride would leave a hole of up to
+  ~2 strides before the month label and each ±1 stride change would crawl the
+  labels), a **balanced division** — mid-month, then thirds — whose marks
+  hold still across every zoom that maps to the same density. Month / year
+  starts stay pinned at every zoom; pans never reshuffle marks (indices are
+  queried per full calendar month, never per window); a stub live-edge month
+  earns proportionally fewer marks. Without a calendar provider the same
+  scheme runs in day-of-month space. Replaces the old day → weekly ~7×
+  density cliff; the separate Monday-anchored week grain was removed — the
+  session-stride band covers everything between every-session and month
+  grain.
+
+### Fixed
+
+- **charts:** a multi-session time axis near the tick cap can no longer come
+  back lopsided — with several sessions each gaining a phase tick while the
+  span estimate sat within a few ticks of the cap, clock-rung enumeration hit
+  its internal bail and the truncated tick array was returned, leaving the
+  final sessions with no ticks at all. The enumeration budget now covers the
+  estimate's per-session undercount (`cap + opens.length + slack`) so
+  enumeration completes, and a still-truncated result is rejected in favor of
+  a coarser rung instead of being returned. (Follow-up to the v0.46.0
+  sliding-window grain-stability fix, flagged in its release spot-check.)
+
+## [0.46.0] — 2026-07-14
+
+### Changed
+
+- **charts:** the boundary (second-row) axis label's **context** now pins to
+  the plot's left edge instead of riding the first tick: it shows the period
+  the _domain start_ is in, and a crossing label sliding toward the edge
+  pushes it off (the sticky-header behavior). On a live sliding window the
+  old first-tick anchoring made `Jan 01` hop tick-to-tick as ticks scrolled
+  out; pinned, it stays put until the period actually changes. Crossing
+  labels (day/year turns) still ride their ticks — including a first tick
+  whose period differs from the domain start's. `TradingTimeScale` gains
+  `boundaryContext(count)`; `tickBoundaries` now labels crossings only.
+
+### Fixed
+
+- **charts:** a live (sliding-window) time axis no longer flickers between two
+  tick grains: the clock-rung choice now derives from the window's live span
+  (constant while sliding) instead of the enumerated anchor count, which
+  oscillates ±1 with the window's phase and flipped the grain for single
+  frames whenever it sat exactly at the width-derived cap.
+
+### Added
+
+- **charts:** **dual x-axes** — two tick layouts on one shared scale. A second
+  `<XAxis>` stacks by declaration order (above/below the plot, either side,
+  same side twice); the new **`transform`** prop (`{ to, from }`, exported
+  `AxisTransform`) relabels an axis into a derived unit: strike ↔ moneyness on
+  a top axis, or a nonlinear BS-delta strip under a std-moneyness chart. Ticks
+  are nice derived-unit values chosen by a pixel-aware multi-resolution fill
+  (1-2-5 steps, coarsest first, admitted where they keep room), so a span the
+  transform compresses gets coarse ticks and a stretched span picks up finer
+  ones — and a label-honesty filter drops any tick whose formatted label would
+  lie about its position. Gridlines stay on the container's primary ticks; the
+  cursor pill on a transformed axis reads in the derived unit. Stories under
+  `Charts/Axes/DualX`. Each `<XAxis>` **and `<YAxis>`** also takes a
+  per-instance **`color`** (labels, tick marks, rule, title) — the lever that
+  distinguishes stacked x strips (a blue delta strip under a grey primary) and
+  colours a y axis to match its series (the dual-axis convention).
+
+### Fixed
+
+- **charts:** annotation label chips now clip to the plot: a marker whose pole
+  pans off-plot no longer leaves its chip floating in the axis gutter, and a
+  partially visible region's chip clamps to the plot's left edge (culled only
+  when the region is entirely out of view). The lines/fills were already
+  SVG-clipped — only the DOM chips escaped.
+
 ## [0.45.0] — 2026-07-14
 
 ### Added
@@ -92,7 +239,7 @@ and type-level changes; patch bumps are strictly additive.
   values while **keeping the row count** — mirroring `rolling`'s `minSamples`,
   the one warm-up convention studies use so a smoothed line aligns on its
   source's time axis. (The existing `warmup` option is unchanged — it still
-  *drops* the head rows; `minSamples` is the length-preserving counterpart.)
+  _drops_ the head rows; `minSamples` is the length-preserving counterpart.)
 - **core:** `TimeSeries.rolling` accepts a **count-based** window —
   `rolling({ count: N }, mapping, opts?)` reduces the last / next / centered
   `N` _rows_ (bars) by position instead of a time span. Unlike a duration

package/README.md

@@ -180,21 +180,21 @@ npm run build && node packages/core/bench/vs-pondjs.cjs
 
 ## Documentation
 
-The full guide is at **<https://pjm17971.github.io/pond-ts/>**.
+The full guide is at **<https://pond-ts.org/>**.
 
-- **[Start here](https://pjm17971.github.io/pond-ts/docs/)**
+- **[Start here](https://pond-ts.org/docs/)**
   — five-minute walkthrough with batch, live, and React examples.
-- **[Concepts](https://pjm17971.github.io/pond-ts/docs/start-here/concepts)**
+- **[Concepts](https://pond-ts.org/docs/start-here/concepts)**
   — temporal keys, sequences, windowing, partitioning, triggers, late
   data.
-- **[Transforms reference](https://pjm17971.github.io/pond-ts/docs/pond-ts/transforms/queries)**
+- **[Transforms reference](https://pond-ts.org/docs/pond-ts/transforms/queries)**
   — every batch operator (queries, aggregation, alignment, rolling,
   smoothing, sampling, cleaning, reshape, anomaly detection).
-- **[Live reference](https://pjm17971.github.io/pond-ts/docs/pond-ts/live/live-series)**
+- **[Live reference](https://pond-ts.org/docs/pond-ts/live/live-series)**
   — `LiveSeries`, live transforms, triggering.
-- **[How-to guides](https://pjm17971.github.io/pond-ts/docs/how-to-guides)**
+- **[How-to guides](https://pond-ts.org/docs/how-to-guides)**
   — building a dashboard, ingesting messy data.
-- **[API reference (auto-generated)](https://pjm17971.github.io/pond-ts/generated-api/core/)**
+- **[API reference (auto-generated)](https://pond-ts.org/generated-api/core/)**
   — TypeDoc output, every public class and method.
 - **[CHANGELOG](./CHANGELOG.md)** — what shipped in each release.
 

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "pond-ts",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "description": "TypeScript-first time series primitives",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pjm17971/pond-ts.git",
+    "url": "git+https://github.com/pond-ts/pond.git",
     "directory": "packages/core"
   },
   "type": "module",