@pond-ts/react 0.60.0 → 0.61.0

package/API.md

@@ -421,6 +421,7 @@ Series shapes (same file): `ChartSeries`, `BandSeries`, `BoxSeries`,
 | `CandleVariant` / `ColorBy`                | OHLC mark shape / colouring strategy                                                                  | `packages/charts/src/ohlc.ts`             |
 | `AxisFormat` / `CursorFormat`              | Tick and cursor-readout formatting (d3 specifier or fn)                                               | `packages/charts/src/format.ts`           |
 | `AxisTransform`                            | Monotonic `to`/`from` pair for derived-unit x-axis relabeling                                         | `packages/charts/src/derivedTicks.ts`     |
+| `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`      |
 | `Orientation`                              | Bar growth direction                                                                                  | `packages/charts/src/bars.ts`             |
 
 ---

package/CHANGELOG.md

@@ -8,7 +8,8 @@ The `@pond-ts` packages — `pond-ts`, `@pond-ts/react`, `@pond-ts/charts`,
 under a single `v*` 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/pond-ts/pond/compare/v0.60.0...HEAD
+[Unreleased]: https://github.com/pond-ts/pond/compare/v0.61.0...HEAD
+[0.61.0]: https://github.com/pond-ts/pond/compare/v0.60.0...v0.61.0
 [0.60.0]: https://github.com/pond-ts/pond/compare/v0.59.0...v0.60.0
 [0.59.0]: https://github.com/pond-ts/pond/compare/v0.58.0...v0.59.0
 [0.58.0]: https://github.com/pond-ts/pond/compare/v0.57.0...v0.58.0
@@ -63,6 +64,47 @@ include new features and type-level changes; patch bumps are strictly additive.
 
 ## [Unreleased]
 
+## [0.61.0] — 2026-08-16
+
+### Added
+
+- `@pond-ts/charts`: **`onMouseEvent` on `<XAxis>` and `<YAxis>`** — mouse
+  events on an axis strip, carrying the **axis value under the pointer** (the
+  part a consumer can't compute, since the scale lives inside the container).
+  One handler takes every mouse event on the strip (`click`, `dblclick`,
+  `contextmenu`, `mousedown`/`mouseup`, `mousemove`, `mouseenter`/`mouseleave`)
+  — switch on `event.type`. The payload (`AxisMouseEvent`, exported) carries
+  the raw React event, `axis: 'x' | 'y'`, the axis's `id` (a `<YAxis>` has one;
+  an `<XAxis>` does not), the inverted `value`, and the `label` that axis would
+  print there — the **category name** on a category axis, whose scale inverts
+  to the nearest band centre. Nothing is attached when the prop is omitted, so
+  an axis that doesn't opt in pays nothing for the move events. Axis strips now
+  also carry `data-axis="x"` / `data-axis="y"` + `data-axis-id` hooks, so a
+  consumer can style one (`[data-axis='x'] { cursor: pointer }`) despite the
+  axes taking no `className`.
+
+### Fixed
+
+- `@pond-ts/charts`: the category x-axis label fit now **measures** rendered
+  label widths (offscreen-canvas `measureText` in the axis font, with a
+  per-glyph estimate fallback for SSR/test DOMs) instead of estimating by
+  character count — labels wider than their band (e.g. `SYMBOL-VENUE-TYPE`
+  keys) no longer overprint into a smear. The fit measures against the scale's
+  real band pitch (so a `maxBandWidth`-packed axis thins correctly), keeps a
+  minimum clear gap between drawn labels, truncates from the **middle**
+  (`EDGE01…EQT`) so a shared prefix or a shared tail stays distinguishable,
+  and draws **no** labels at a degenerate (collapsed / pre-layout) width
+  rather than overprinting every label at x ≈ 0. Filed from the SPARC
+  migration ([PND-CATFIT]).
+
+  **Heads-up on a deliberate visual change:** an axis whose labels previously
+  packed edge-to-edge at a borderline pitch (label within a couple of px of
+  its band) now **thins to every 2nd label** instead — clear separation
+  outranks per-band labelling at the margin. On a dense dashboard axis this
+  can read as "half the labels disappeared"; it is the fit working as
+  intended, not data loss — every band still draws its mark, and the cursor
+  readout still names every category.
+
 ## [0.60.0] — 2026-08-13
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pond-ts/react",
-  "version": "0.60.0",
+  "version": "0.61.0",
   "description": "React hooks for pond-ts live time series",
   "license": "MIT",
   "repository": {
@@ -34,7 +34,7 @@
     "test:runtime": "vitest run"
   },
   "peerDependencies": {
-    "pond-ts": "^0.60.0",
+    "pond-ts": "^0.61.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {