pond-ts 0.46.0 → 0.48.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.46.0...HEAD
+[Unreleased]: https://github.com/pond-ts/pond/compare/v0.48.0...HEAD
+[0.48.0]: https://github.com/pond-ts/pond/compare/v0.47.0...v0.48.0
+[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
@@ -45,13 +47,138 @@ and type-level changes; patch bumps are strictly additive.
 
 ## [Unreleased]
 
+## [0.48.0] — 2026-07-17
+
+### Added
+
+- **charts:** `<ChartContainer>` gains **`cursorFormat`** — an independent
+  format for the **cursor / marker readout** (the crosshair time pill, marker
+  axis indicators, annotation auto-labels), separate from the tick-label
+  `timeFormat` / `format`. Unlike `timeFormat` (which _owns the labels_ and so
+  opts the axis out of the `dateStyle` ladder by design), `cursorFormat` shapes
+  only the readout and **keeps the flat / stacked date style** — resolving the
+  "one knob, two concerns" bind where the only way to fix the pill was to give
+  up the styled axis. A d3 specifier **string** formats uniformly; a
+  **function** `(epochMs, { grain, defaultText }) => string` is handed the
+  axis's resolved coarse **`TimeGrain`** (`year` … `second`) and the
+  grain-aware default text, so it can branch on zoom and pass the default
+  through — no re-deriving the grain from the range. New public types
+  **`CursorFormat`** / **`TimeGrain`**; `TradingTimeScale` gains
+  `readoutFormat(count)` and `grain(count)`.
+
+### Fixed
+
+- **charts:** the cursor / marker time readout now formats at the axis's
+  **own grain** by default instead of d3's multi-scale default — a
+  day-or-coarser axis reads a **date** (`Sep 14, 2026`), a sub-day axis reads
+  date + clock. Fixes the 0.47.0 flat-axis regression where a daily bar at a
+  foreign-timezone midnight rendered as a bare time-of-day (`02 AM`) in the
+  crosshair pill (Tidal F-charts-7). Tick labels are unchanged.
+
+## [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
+  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
@@ -141,7 +268,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.46.0",
+  "version": "0.48.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",