@pond-ts/charts 0.34.1 → 0.35.0

package/CHANGELOG.md

@@ -8,7 +8,8 @@ The `@pond-ts` packages — `pond-ts`, `@pond-ts/react`, `@pond-ts/charts`, and
 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.34.1...HEAD
+[Unreleased]: https://github.com/pjm17971/pond-ts/compare/v0.35.0...HEAD
+[0.35.0]: https://github.com/pjm17971/pond-ts/compare/v0.34.1...v0.35.0
 [0.34.1]: https://github.com/pjm17971/pond-ts/compare/v0.34.0...v0.34.1
 [0.34.0]: https://github.com/pjm17971/pond-ts/compare/v0.33.0...v0.34.0
 [0.33.0]: https://github.com/pjm17971/pond-ts/compare/v0.32.0...v0.33.0
@@ -30,6 +31,23 @@ patch bumps are strictly additive.
 [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
 
+## [0.35.0] — 2026-07-02
+
+A `@pond-ts/charts` release: per-series line dash patterns. `pond-ts`,
+`@pond-ts/react`, and `@pond-ts/fit` carry no code changes — republished in
+lock-step (their `pond-ts` / `@pond-ts/react` peer ranges widen to `^0.35.0`).
+
+### Added
+
+- **Charts — per-series line dash (`LineStyle.dash`).** A theme's line style
+  accepts an optional `dash?: readonly number[]` — a px on/off pattern
+  (`[6, 4]` dashed, `[2, 3]` ≈ dotted; omit or `[]` = solid) applied to the
+  series stroke. Lets a theme set a **modeled / forecast** line (e.g. GARCH
+  vol) apart from an observed one at a glance. Distinct from a `GapMode`'s
+  inferred gap-bridge dashing (which marks *missing data*, not the whole
+  line). Additive: existing themes are unaffected; a solid line never touches
+  `setLineDash`. New `Charts/LineChart → LineStyles` story. (#313)
+
 ## [0.34.1] — 2026-07-01
 
 A `pond-ts` core patch: fixes a performance regression introduced in 0.34.0.

package/dist/line.js

@@ -69,7 +69,19 @@ export function drawLine(ctx, cs, xScale, yScale, style, curve = curveLinear, ga
     gen(ys);
     ctx.strokeStyle = style.color;
     ctx.lineWidth = style.width;
-    ctx.stroke();
+    // Per-series dash (a modeled/forecast line reads dashed). Applied only when
+    // set — a solid line never touches `setLineDash` — then reset to solid right
+    // after the stroke so it can't leak into the gap-bridge overlay below (which
+    // sets its own dash) or the next layer drawn on this context.
+    const dash = style.dash;
+    if (dash && dash.length > 0) {
+        ctx.setLineDash(dash.slice());
+        ctx.stroke();
+        ctx.setLineDash([]);
+    }
+    else {
+        ctx.stroke();
+    }
     // Overlay bridges for the inferred-gap modes. `dashed` / `step` are faint
     // dashed connectors (gapConnectorOpacity); only `fade` drops to the axis floor.
     if (gaps === 'dashed' || gaps === 'step' || gaps === 'fade') {

package/dist/theme.d.ts

@@ -138,6 +138,15 @@ export interface ChartTheme {
 export interface LineStyle {
     readonly color: string;
     readonly width: number;
+    /**
+     * Optional dash pattern — px on/off lengths (`[6, 4]` = 6 on, 4 off; `[2, 3]`
+     * ≈ dotted). Omit or `[]` for a solid stroke. This is the *series'* own style
+     * — distinct from a {@link GapMode}'s inferred faint gap-bridge dashing (that
+     * marks missing data; this marks the whole line). Use it to set a **modeled**
+     * series (a forecast / smoothed estimate, e.g. GARCH vol) apart from an
+     * observed one at a glance.
+     */
+    readonly dash?: readonly number[];
 }
 /** A resolved band style: fill colour + opacity (0–1) for the variance envelope. */
 export interface BandStyle {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pond-ts/charts",
-  "version": "0.34.1",
+  "version": "0.35.0",
   "private": false,
   "description": "Canvas-rendered, streaming-first time-series charts for pond-ts",
   "license": "MIT",
@@ -38,8 +38,8 @@
     "perf": "PERF_BENCH=1 playwright test perf.spec.ts --workers=1"
   },
   "peerDependencies": {
-    "@pond-ts/react": "^0.34.0",
-    "pond-ts": "^0.34.0",
+    "@pond-ts/react": "^0.35.0",
+    "pond-ts": "^0.35.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {