@motionscript/charts 0.1.0 → 0.1.1-alpha.0

package/dist/line-chart/shared.d.ts

@@ -1,78 +1,40 @@
-/**
- * Types and pure helpers specific to the {@link LineChart} family: the traced
- * polylines, the spotlit region they dim outside of, and the theme those two
- * add to the shared chart vocabulary.
- *
- * Everything a bar or a pie chart would want too — what a series is, how an axis
- * is scaled and formatted, the theme leaf resolvers, the legend and plot-panel
- * branches — lives in `../kit/shared.ts` and is imported here. What's
- * left below is what only a line chart has: points sorted along an x column,
- * a region clipped out of a polyline, and the `region` branch of the theme.
- *
- * Kept renderer-agnostic (no `Node` imports) so every part shares one
- * scale/format/palette/theme vocabulary, and so a host's own inspector
- * mapping can build a partial {@link ChartTheme} without
- * pulling the components in.
- */
-import { type DataRecord, type Fill, type Stroke } from "@motionscript/sdk";
+import { type DataRecord, type Fill, type Stroke, type Vector2 } from "@motionscript/sdk";
 import { type AxisConfig, type ChartSeries, type LegendConfig, type LegendTheme, type PlotAreaConfig, type Range } from "../kit/shared.js";
 import type { XScale } from "./x-scale.js";
-/**
- * One series in a {@link LineChart}: a polyline traced through the values in one
- * column of the chart's `data`, drawn in `fill` (or the theme's `seriesStyles`
- * palette when omitted) and captioned by `label` in the legend.
- *
- * The family-wide {@link ChartSeries} under a name that says what it draws here;
- * the chart's own `xField` prop names the column carrying the shared x values,
- * so every series is read off the same rows — one row per sample, one column per
- * series.
- */
+/** One polyline of a {@link LineChart}: {@link ChartSeries} under the name for what it draws here. */
 export type LineSeries = ChartSeries;
 /**
- * A rectangular slice of the plot, in **data units** — the author-facing input
- * to {@link LineChart.spotlightRegion} / {@link LineChart.zoomTo}.
- *
- * Either axis may be omitted, and that's the point: `{ x: [60, 100] }` is a
- * vertical band spanning the full height, `{ y: [8, 10] }` a horizontal band
- * spanning the full width, and both together a box. A reversed range is read
- * the same as the forward one — a region is a span, not a direction.
+ * A rectangular slice of the plot in data units, the input to `spotlightRegion`
+ * and `zoomTo`. Either axis may be omitted: `{ x: [60, 100] }` is a full-height
+ * band. A reversed range reads the same as a forward one.
  */
 export interface PlotRegion {
-    /** Horizontal span in x-axis data units. Omit to span the full plot width. */
+    /** Omit to span the full plot width. */
     x?: Range;
-    /** Vertical span in y-axis data units. Omit to span the full plot height. */
+    /** Omit to span the full plot height. */
     y?: Range;
 }
 /**
- * A {@link PlotRegion} resolved into the plot's **centred pixel space** (origin
- * at the plot centre, y-up) — the same local frame the series points live in,
- * so a line can be clipped against it directly.
- *
- * `xBounded`/`yBounded` carry which axes the author actually constrained: an
- * unbounded axis has its edges pinned to the plot's own and draws no rule.
+ * A {@link PlotRegion} in the plot's centred pixel space (origin at the centre,
+ * y-up), the frame the series points live in. An axis the author left unbounded
+ * has its edges pinned to the plot's own and draws no rule.
  */
 export interface RegionBox {
     left: number;
     right: number;
     bottom: number;
     top: number;
-    /** The author gave an x range — the left/right edges are real data bounds. */
     xBounded: boolean;
-    /** The author gave a y range — the bottom/top edges are real data bounds. */
     yBounded: boolean;
 }
-/** The empty box, used as the "no region" resting value. */
+/** The "no region" resting value. */
 export declare const EMPTY_REGION_BOX: RegionBox;
-/** Is `box` a real, non-degenerate region — i.e. is there anything to spotlight? */
+/** Whether `box` is non-degenerate, so there is something to spotlight. */
 export declare function hasRegion(box: RegionBox): boolean;
 /**
- * Resolve a {@link PlotRegion} against the plot's pixel box and the chart's
- * scales. `plot` is the plot rectangle in centred pixel space, and
- * `xScale`/`yScale` the data ranges those edges span.
- *
- * An omitted axis takes the plot's own edges, so the region spans it. A given
- * axis is clamped to the plot, so a range running off the scale still produces
- * a box inside the panel.
+ * Resolve a {@link PlotRegion} against the plot rectangle (centred pixel space)
+ * and the data ranges its edges span. An omitted axis takes the plot's own
+ * edges; a given one is clamped to the plot.
  */
 export declare function resolveRegionBox(region: PlotRegion | null | undefined, plot: {
     left: number;
@@ -80,51 +42,33 @@ export declare function resolveRegionBox(region: PlotRegion | null | undefined,
     bottom: number;
     top: number;
 }, xScale: Range, yScale: Range): RegionBox;
-/** A bare `{x, y}` — declared locally so this module stays free of node imports. */
-interface Vector2Like {
-    x: number;
-    y: number;
-}
 /**
- * The parts of `points` that fall **inside** `box`, as a list of contiguous
- * sub-polylines — the geometry behind the region spotlight: a series is drawn
- * dimmed in full, then these runs are re-drawn over it at full strength.
- *
- * Segments are clipped against the box rather than filtered by endpoint, so a
- * line entering the region mid-segment is cut exactly on the boundary.
- */
-export declare function clipPolylineToBox(points: Vector2Like[], box: RegionBox): Vector2Like[][];
-/**
- * How a spotlit {@link PlotRegion} is drawn — the dashed rules on its bounded
- * edges, the wash filling it, and how far the series fade outside it.
+ * The parts of `points` inside `box`, as contiguous sub-polylines: a series is
+ * drawn dimmed in full, then these runs are re-drawn at full strength. Segments
+ * are clipped, not filtered by endpoint, so a line entering mid-segment is cut
+ * exactly on the boundary.
  */
+export declare function clipPolylineToBox(points: Vector2[], box: RegionBox): Vector2[][];
+/** How a spotlit {@link PlotRegion} is drawn: rules on its bounded edges, a wash, and how far series fade outside it. */
 export interface RegionConfig {
-    /** The dashed rule marking each bounded edge. */
+    /** Marks each bounded edge. */
     stroke: Stroke;
-    /** Wash filling the region, drawn under the series lines. */
+    /** Drawn under the series lines. */
     fill: Fill;
-    /** Opacity the stretch of every series *outside* the region fades to. */
+    /** Opacity the stretch of every series outside the region fades to. */
     dimOpacity: number;
 }
 /** A {@link LineChart}'s full, resolved visual theme. */
 export interface ChartConfig {
-    /**
-     * Default per-series line stroke, cycled by series index (`i % length`). A
-     * series' own `fill`, when set, overrides just the colour.
-     */
+    /** Cycled by series index; a series' own `fill` overrides just the colour. */
     seriesStyles: Stroke[];
     xAxis: AxisConfig;
     yAxis: AxisConfig;
-    /** The plot panel: border, fill, and drop shadow. */
     plotArea: PlotAreaConfig;
     legend: LegendConfig;
-    /** The spotlit-region annotation — see {@link RegionConfig}. */
     region: RegionConfig;
 }
-/**
- * Author-facing partial theme, passed as {@link LineChart}'s `theme` prop —
- * every branch optional and deep-merged onto {@link DEFAULT_CHART_THEME}.
- */
+/** The author's partial theme, deep-merged onto {@link DEFAULT_CHART_THEME}. */
 export type ChartTheme = {
     seriesStyles?: Stroke[];
     xAxis?: Partial<AxisConfig>;
@@ -133,39 +77,21 @@ export type ChartTheme = {
     legend?: LegendTheme;
     region?: Partial<RegionConfig>;
 };
-/** The chart's out-of-the-box look. */
 export declare const DEFAULT_CHART_THEME: ChartConfig;
-/**
- * {@link LineChart}'s `theme` entry's resolve: merges the author's partial
- * {@link ChartTheme} onto `previous` (falling back to
- * {@link DEFAULT_CHART_THEME} on first resolution), fully resolving every leaf.
- */
+/** The `theme` entry's resolve: merges a partial {@link ChartTheme} onto `previous` (first resolution: the default). */
 export declare function resolveChartTheme(theme: ChartTheme | undefined, previous?: ChartConfig): ChartConfig;
-/** {@link LineChart}'s `theme` entry's lerp — leaf by leaf. */
 export declare function lerpChartTheme(from: ChartConfig, to: ChartConfig, t: number): ChartConfig;
 /**
- * Resolve one series' `[x, y]` points out of the chart's rows: each row's
- * position on the {@link XScale} paired with its own `field` column, sorted
- * along x so the polyline traces left-to-right whatever order the rows arrived
- * in.
- *
- * A row missing its y column contributes a 0 rather than a gap — these charts
- * draw continuous lines, so dropping the point would silently bridge the hole.
- *
- * Takes the resolved scale rather than the column *name*, because what a row's x
- * is depends on what kind of column it came out of: a number, an instant, or a
- * place in the file. See `x-scale.ts`.
+ * One series' `[x, y]` points, sorted along x so the polyline traces left to
+ * right. A row missing its y contributes 0 rather than a gap, since dropping it
+ * would silently bridge the hole.
  */
 export declare function seriesPoints(data: DataRecord[], x: XScale, series: LineSeries): [x: number, y: number][];
-/** Min/max across every series' column, the fallback when unset. */
 export declare function yExtent(data: DataRecord[], series: LineSeries[]): Range;
 /**
- * Effective vertical scale: the explicit `range`, else the data's y extent
- * nudged out to tidy step bounds so markers read as round numbers.
- *
- * `divisions` is how many segments the auto-range is stepped into (one fewer
- * than a marker count) — it only shapes the tidy step when `range` is omitted.
+ * The explicit `range`, else the data's y extent nudged out to tidy step bounds.
+ * `divisions` (one fewer than the marker count) only shapes the step when
+ * `range` is omitted.
  */
 export declare function resolveYScale(data: DataRecord[], series: LineSeries[], range: Range | undefined, divisions: number): Range;
-export {};
 //# sourceMappingURL=shared.d.ts.map

package/dist/line-chart/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/line-chart/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/line-chart/shared.ts"],"names":[],"mappings":"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"}

package/dist/line-chart/shared.js

@@ -1,22 +1,7 @@
-/**
- * Types and pure helpers specific to the {@link LineChart} family: the traced
- * polylines, the spotlit region they dim outside of, and the theme those two
- * add to the shared chart vocabulary.
- *
- * Everything a bar or a pie chart would want too — what a series is, how an axis
- * is scaled and formatted, the theme leaf resolvers, the legend and plot-panel
- * branches — lives in `../kit/shared.ts` and is imported here. What's
- * left below is what only a line chart has: points sorted along an x column,
- * a region clipped out of a polyline, and the `region` branch of the theme.
- *
- * Kept renderer-agnostic (no `Node` imports) so every part shares one
- * scale/format/palette/theme vocabulary, and so a host's own inspector
- * mapping can build a partial {@link ChartTheme} without
- * pulling the components in.
- */
 import { Fills, fillOps, lerpNumber, strokeOps, } from "@motionscript/sdk";
-import { CHART_PALETTE, DEFAULT_LEGEND, DEFAULT_PLOT_AREA, DEFAULT_SERIES_STROKES, DEFAULT_X_AXIS, DEFAULT_Y_AXIS, SPOTLIGHT_DIM, lerpAxisConfig, lerpLegendConfig, lerpPlotArea, lerpSeriesStrokes, niceStep, num, resolveAxisConfig, resolveLegendConfig, resolvePlotArea, resolveSeriesStrokes, } from "../kit/shared.js";
-/** The empty box, used as the "no region" resting value. */
+import { niceStep } from "@motionscript/sdk/component";
+import { CHART_PALETTE, DEFAULT_LEGEND, DEFAULT_PLOT_AREA, DEFAULT_SERIES_STROKES, DEFAULT_X_AXIS, DEFAULT_Y_AXIS, SPOTLIGHT_DIM, lerpAxisConfig, lerpLegendConfig, lerpPlotArea, lerpSeriesStrokes, num, resolveAxisConfig, resolveLegendConfig, resolvePlotArea, resolveSeriesStrokes, } from "../kit/shared.js";
+/** The "no region" resting value. */
 export const EMPTY_REGION_BOX = {
     left: 0,
     right: 0,
@@ -25,18 +10,14 @@ export const EMPTY_REGION_BOX = {
     xBounded: false,
     yBounded: false,
 };
-/** Is `box` a real, non-degenerate region — i.e. is there anything to spotlight? */
+/** Whether `box` is non-degenerate, so there is something to spotlight. */
 export function hasRegion(box) {
     return box.right > box.left && box.top > box.bottom;
 }
 /**
- * Resolve a {@link PlotRegion} against the plot's pixel box and the chart's
- * scales. `plot` is the plot rectangle in centred pixel space, and
- * `xScale`/`yScale` the data ranges those edges span.
- *
- * An omitted axis takes the plot's own edges, so the region spans it. A given
- * axis is clamped to the plot, so a range running off the scale still produces
- * a box inside the panel.
+ * Resolve a {@link PlotRegion} against the plot rectangle (centred pixel space)
+ * and the data ranges its edges span. An omitted axis takes the plot's own
+ * edges; a given one is clamped to the plot.
  */
 export function resolveRegionBox(region, plot, xScale, yScale) {
     if (!region || (region.x === undefined && region.y === undefined)) {
@@ -59,12 +40,10 @@ export function resolveRegionBox(region, plot, xScale, yScale) {
     return { left, right, bottom, top, xBounded, yBounded };
 }
 /**
- * The parts of `points` that fall **inside** `box`, as a list of contiguous
- * sub-polylines — the geometry behind the region spotlight: a series is drawn
- * dimmed in full, then these runs are re-drawn over it at full strength.
- *
- * Segments are clipped against the box rather than filtered by endpoint, so a
- * line entering the region mid-segment is cut exactly on the boundary.
+ * The parts of `points` inside `box`, as contiguous sub-polylines: a series is
+ * drawn dimmed in full, then these runs are re-drawn at full strength. Segments
+ * are clipped, not filtered by endpoint, so a line entering mid-segment is cut
+ * exactly on the boundary.
  */
 export function clipPolylineToBox(points, box) {
     if (points.length < 2 || !hasRegion(box))
@@ -74,15 +53,14 @@ export function clipPolylineToBox(points, box) {
     for (let i = 1; i < points.length; i++) {
         const seg = clipSegment(points[i - 1], points[i], box);
         if (!seg) {
-            // Segment misses the box entirely — close whatever run was open.
+            // Misses the box: close the open run.
             if (run.length >= 2)
                 runs.push(run);
             run = [];
             continue;
         }
         const [a, b] = seg;
-        // Continue the open run when this clipped segment starts where the last one
-        // ended; otherwise the line left the box and came back, which is a new run.
+        // Continues the open run if it starts where the last ended; otherwise the line left and came back.
         if (run.length > 0 && samePoint(run[run.length - 1], a))
             run.push(b);
         else {
@@ -99,16 +77,13 @@ export function clipPolylineToBox(points, box) {
 function samePoint(a, b) {
     return Math.abs(a.x - b.x) < 0.5 && Math.abs(a.y - b.y) < 0.5;
 }
-/**
- * Liang–Barsky clip of one segment against the axis-aligned `box`. Returns the
- * surviving `[start, end]`, or `null` when the segment lies wholly outside.
- */
+/** Liang-Barsky clip of one segment against `box`: the surviving `[start, end]`, or `null` when wholly outside. */
 function clipSegment(a, b, box) {
     const dx = b.x - a.x;
     const dy = b.y - a.y;
     let t0 = 0;
     let t1 = 1;
-    // Each edge as (p, q): the segment survives where p·t <= q.
+    // Each edge as (p, q): the segment survives where p*t <= q.
     const edges = [
         [-dx, a.x - box.left],
         [dx, box.right - a.x],
@@ -117,7 +92,7 @@ function clipSegment(a, b, box) {
     ];
     for (const [p, q] of edges) {
         if (p === 0) {
-            // Parallel to this edge: outside it means the whole segment is out.
+            // Parallel to this edge: outside it, the whole segment is out.
             if (q < 0)
                 return null;
             continue;
@@ -141,12 +116,7 @@ function clipSegment(a, b, box) {
         { x: a.x + t1 * dx, y: a.y + t1 * dy },
     ];
 }
-/**
- * The legend of a line chart: the shared one, with a small rounded-square
- * swatch in place of the wide chip. A bar's or a wedge's swatch stands in for
- * an area of paint and is drawn like one; a line's stands in for a colour, and
- * a square reads as the sample it is.
- */
+/** The shared legend with a small square swatch: a line's swatch stands for a colour, where a bar's or wedge's stands for an area of paint. */
 const LINE_CHART_LEGEND = {
     ...DEFAULT_LEGEND,
     markerStyle: {
@@ -156,7 +126,6 @@ const LINE_CHART_LEGEND = {
         borderRadius: 6,
     },
 };
-/** The chart's out-of-the-box look. */
 export const DEFAULT_CHART_THEME = {
     seriesStyles: DEFAULT_SERIES_STROKES,
     xAxis: DEFAULT_X_AXIS,
@@ -164,16 +133,13 @@ export const DEFAULT_CHART_THEME = {
     plotArea: DEFAULT_PLOT_AREA,
     legend: LINE_CHART_LEGEND,
     region: {
-        // Brighter than the grid and dashed, so the boundary reads as a call-out
-        // rather than another axis line; `butt` caps keep the dash lengths exact.
+        // Brighter and dashed so it reads as a call-out, not an axis line; `butt` caps keep dash lengths exact.
         stroke: {
             weight: 3,
             fill: CHART_PALETTE.regionColor,
             dash: [14, 12],
             cap: "butt",
         },
-        // A wash barely above the panel — enough to tint the band, not enough to
-        // mute the series drawn over it.
         fill: Fills.color(CHART_PALETTE.regionColor, { opacity: 0.08 }),
         dimOpacity: SPOTLIGHT_DIM,
     },
@@ -192,11 +158,7 @@ function lerpRegionConfig(from, to, t) {
         dimOpacity: lerpNumber(from.dimOpacity, to.dimOpacity, t),
     };
 }
-/**
- * {@link LineChart}'s `theme` entry's resolve: merges the author's partial
- * {@link ChartTheme} onto `previous` (falling back to
- * {@link DEFAULT_CHART_THEME} on first resolution), fully resolving every leaf.
- */
+/** The `theme` entry's resolve: merges a partial {@link ChartTheme} onto `previous` (first resolution: the default). */
 export function resolveChartTheme(theme, previous) {
     const base = previous ?? DEFAULT_CHART_THEME;
     return {
@@ -208,7 +170,6 @@ export function resolveChartTheme(theme, previous) {
         region: resolveRegionConfig(theme?.region, base.region),
     };
 }
-/** {@link LineChart}'s `theme` entry's lerp — leaf by leaf. */
 export function lerpChartTheme(from, to, t) {
     return {
         seriesStyles: lerpSeriesStrokes(from.seriesStyles, to.seriesStyles, t),
@@ -219,26 +180,16 @@ export function lerpChartTheme(from, to, t) {
         region: lerpRegionConfig(from.region, to.region, t),
     };
 }
-// ---- Scales --------------------------------------------------------------
 /**
- * Resolve one series' `[x, y]` points out of the chart's rows: each row's
- * position on the {@link XScale} paired with its own `field` column, sorted
- * along x so the polyline traces left-to-right whatever order the rows arrived
- * in.
- *
- * A row missing its y column contributes a 0 rather than a gap — these charts
- * draw continuous lines, so dropping the point would silently bridge the hole.
- *
- * Takes the resolved scale rather than the column *name*, because what a row's x
- * is depends on what kind of column it came out of: a number, an instant, or a
- * place in the file. See `x-scale.ts`.
+ * One series' `[x, y]` points, sorted along x so the polyline traces left to
+ * right. A row missing its y contributes 0 rather than a gap, since dropping it
+ * would silently bridge the hole.
  */
 export function seriesPoints(data, x, series) {
     return data
         .map((row, i) => [x.at(i), num(row, series.field)])
         .sort((a, b) => a[0] - b[0]);
 }
-/** Min/max across every series' column, the fallback when unset. */
 export function yExtent(data, series) {
     let lo = Infinity;
     let hi = -Infinity;
@@ -253,11 +204,9 @@ export function yExtent(data, series) {
     return lo <= hi ? [lo, hi] : [0, 1];
 }
 /**
- * Effective vertical scale: the explicit `range`, else the data's y extent
- * nudged out to tidy step bounds so markers read as round numbers.
- *
- * `divisions` is how many segments the auto-range is stepped into (one fewer
- * than a marker count) — it only shapes the tidy step when `range` is omitted.
+ * The explicit `range`, else the data's y extent nudged out to tidy step bounds.
+ * `divisions` (one fewer than the marker count) only shapes the step when
+ * `range` is omitted.
  */
 export function resolveYScale(data, series, range, divisions) {
     if (range)
@@ -270,11 +219,9 @@ export function resolveYScale(data, series, range, divisions) {
     return [Math.floor(lo / step) * step, Math.ceil(hi / step) * step];
 }
 /**
- * The scale for data that never moves. A zero-width scale puts every tick on the
- * same value and the line on the plot's floor, so it is widened to a few steps
- * either side of the value (the step sized to its magnitude, so `5` gets
- * `[3, 7]` and `5000` gets `[3000, 7000]`), or to `[0, 1]` for all zeros, as for
- * no data at all.
+ * The scale for constant data. A zero-width scale would put every tick on one
+ * value and the line on the floor, so it widens by a step sized to the
+ * magnitude (`5` gets `[3, 7]`), or `[0, 1]` for zero.
  */
 function constantScale(value, segments) {
     if (value === 0)

package/dist/line-chart/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/line-chart/shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Types and pure helpers specific to the {@link LineChart} family: the traced\n * polylines, the spotlit region they dim outside of, and the theme those two\n * add to the shared chart vocabulary.\n *\n * Everything a bar or a pie chart would want too — what a series is, how an axis\n * is scaled and formatted, the theme leaf resolvers, the legend and plot-panel\n * branches — lives in `../kit/shared.ts` and is imported here. What's\n * left below is what only a line chart has: points sorted along an x column,\n * a region clipped out of a polyline, and the `region` branch of the theme.\n *\n * Kept renderer-agnostic (no `Node` imports) so every part shares one\n * scale/format/palette/theme vocabulary, and so a host's own inspector\n * mapping can build a partial {@link ChartTheme} without\n * pulling the components in.\n */\n\nimport {\n  Fills,\n  fillOps,\n  lerpNumber,\n  strokeOps,\n  type DataRecord,\n  type Fill,\n  type FillResolved,\n  type Stroke,\n  type StrokeResolved,\n} from \"@motionscript/sdk\"\n\nimport {\n  CHART_PALETTE,\n  DEFAULT_LEGEND,\n  DEFAULT_PLOT_AREA,\n  DEFAULT_SERIES_STROKES,\n  DEFAULT_X_AXIS,\n  DEFAULT_Y_AXIS,\n  SPOTLIGHT_DIM,\n  lerpAxisConfig,\n  lerpLegendConfig,\n  lerpPlotArea,\n  lerpSeriesStrokes,\n  niceStep,\n  num,\n  resolveAxisConfig,\n  resolveLegendConfig,\n  resolvePlotArea,\n  resolveSeriesStrokes,\n  type AxisConfig,\n  type ChartSeries,\n  type LegendConfig,\n  type LegendTheme,\n  type PlotAreaConfig,\n  type Range,\n} from \"../kit/shared\"\nimport type { XScale } from \"./x-scale\"\n\n/**\n * One series in a {@link LineChart}: a polyline traced through the values in one\n * column of the chart's `data`, drawn in `fill` (or the theme's `seriesStyles`\n * palette when omitted) and captioned by `label` in the legend.\n *\n * The family-wide {@link ChartSeries} under a name that says what it draws here;\n * the chart's own `xField` prop names the column carrying the shared x values,\n * so every series is read off the same rows — one row per sample, one column per\n * series.\n */\nexport type LineSeries = ChartSeries\n\n// ---- Plot regions -------------------------------------------------------\n\n/**\n * A rectangular slice of the plot, in **data units** — the author-facing input\n * to {@link LineChart.spotlightRegion} / {@link LineChart.zoomTo}.\n *\n * Either axis may be omitted, and that's the point: `{ x: [60, 100] }` is a\n * vertical band spanning the full height, `{ y: [8, 10] }` a horizontal band\n * spanning the full width, and both together a box. A reversed range is read\n * the same as the forward one — a region is a span, not a direction.\n */\nexport interface PlotRegion {\n  /** Horizontal span in x-axis data units. Omit to span the full plot width. */\n  x?: Range\n  /** Vertical span in y-axis data units. Omit to span the full plot height. */\n  y?: Range\n}\n\n/**\n * A {@link PlotRegion} resolved into the plot's **centred pixel space** (origin\n * at the plot centre, y-up) — the same local frame the series points live in,\n * so a line can be clipped against it directly.\n *\n * `xBounded`/`yBounded` carry which axes the author actually constrained: an\n * unbounded axis has its edges pinned to the plot's own and draws no rule.\n */\nexport interface RegionBox {\n  left: number\n  right: number\n  bottom: number\n  top: number\n  /** The author gave an x range — the left/right edges are real data bounds. */\n  xBounded: boolean\n  /** The author gave a y range — the bottom/top edges are real data bounds. */\n  yBounded: boolean\n}\n\n/** The empty box, used as the \"no region\" resting value. */\nexport const EMPTY_REGION_BOX: RegionBox = {\n  left: 0,\n  right: 0,\n  bottom: 0,\n  top: 0,\n  xBounded: false,\n  yBounded: false,\n}\n\n/** Is `box` a real, non-degenerate region — i.e. is there anything to spotlight? */\nexport function hasRegion(box: RegionBox): boolean {\n  return box.right > box.left && box.top > box.bottom\n}\n\n/**\n * Resolve a {@link PlotRegion} against the plot's pixel box and the chart's\n * scales. `plot` is the plot rectangle in centred pixel space, and\n * `xScale`/`yScale` the data ranges those edges span.\n *\n * An omitted axis takes the plot's own edges, so the region spans it. A given\n * axis is clamped to the plot, so a range running off the scale still produces\n * a box inside the panel.\n */\nexport function resolveRegionBox(\n  region: PlotRegion | null | undefined,\n  plot: { left: number; right: number; bottom: number; top: number },\n  xScale: Range,\n  yScale: Range\n): RegionBox {\n  if (!region || (region.x === undefined && region.y === undefined)) {\n    return EMPTY_REGION_BOX\n  }\n\n  const span = (\n    range: Range | undefined,\n    [min, max]: Range,\n    lo: number,\n    hi: number\n  ): [number, number, boolean] => {\n    if (range === undefined || max <= min) return [lo, hi, false]\n    const a = Math.min(range[0], range[1])\n    const b = Math.max(range[0], range[1])\n    const toPx = (v: number) => lo + ((v - min) / (max - min)) * (hi - lo)\n    return [\n      Math.max(lo, Math.min(hi, toPx(a))),\n      Math.max(lo, Math.min(hi, toPx(b))),\n      true,\n    ]\n  }\n\n  const [left, right, xBounded] = span(region.x, xScale, plot.left, plot.right)\n  const [bottom, top, yBounded] = span(region.y, yScale, plot.bottom, plot.top)\n  return { left, right, bottom, top, xBounded, yBounded }\n}\n\n/** A bare `{x, y}` — declared locally so this module stays free of node imports. */\ninterface Vector2Like {\n  x: number\n  y: number\n}\n\n/**\n * The parts of `points` that fall **inside** `box`, as a list of contiguous\n * sub-polylines — the geometry behind the region spotlight: a series is drawn\n * dimmed in full, then these runs are re-drawn over it at full strength.\n *\n * Segments are clipped against the box rather than filtered by endpoint, so a\n * line entering the region mid-segment is cut exactly on the boundary.\n */\nexport function clipPolylineToBox(\n  points: Vector2Like[],\n  box: RegionBox\n): Vector2Like[][] {\n  if (points.length < 2 || !hasRegion(box)) return []\n\n  const runs: Vector2Like[][] = []\n  let run: Vector2Like[] = []\n\n  for (let i = 1; i < points.length; i++) {\n    const seg = clipSegment(points[i - 1], points[i], box)\n    if (!seg) {\n      // Segment misses the box entirely — close whatever run was open.\n      if (run.length >= 2) runs.push(run)\n      run = []\n      continue\n    }\n    const [a, b] = seg\n    // Continue the open run when this clipped segment starts where the last one\n    // ended; otherwise the line left the box and came back, which is a new run.\n    if (run.length > 0 && samePoint(run[run.length - 1], a)) run.push(b)\n    else {\n      if (run.length >= 2) runs.push(run)\n      run = [a, b]\n    }\n  }\n  if (run.length >= 2) runs.push(run)\n  return runs\n}\n\n/** Points within half a pixel are the same point, for run-joining purposes. */\nfunction samePoint(a: Vector2Like, b: Vector2Like): boolean {\n  return Math.abs(a.x - b.x) < 0.5 && Math.abs(a.y - b.y) < 0.5\n}\n\n/**\n * Liang–Barsky clip of one segment against the axis-aligned `box`. Returns the\n * surviving `[start, end]`, or `null` when the segment lies wholly outside.\n */\nfunction clipSegment(\n  a: Vector2Like,\n  b: Vector2Like,\n  box: RegionBox\n): [Vector2Like, Vector2Like] | null {\n  const dx = b.x - a.x\n  const dy = b.y - a.y\n  let t0 = 0\n  let t1 = 1\n\n  // Each edge as (p, q): the segment survives where p·t <= q.\n  const edges: [number, number][] = [\n    [-dx, a.x - box.left],\n    [dx, box.right - a.x],\n    [-dy, a.y - box.bottom],\n    [dy, box.top - a.y],\n  ]\n  for (const [p, q] of edges) {\n    if (p === 0) {\n      // Parallel to this edge: outside it means the whole segment is out.\n      if (q < 0) return null\n      continue\n    }\n    const r = q / p\n    if (p < 0) {\n      if (r > t1) return null\n      if (r > t0) t0 = r\n    } else {\n      if (r < t0) return null\n      if (r < t1) t1 = r\n    }\n  }\n  return [\n    { x: a.x + t0 * dx, y: a.y + t0 * dy },\n    { x: a.x + t1 * dx, y: a.y + t1 * dy },\n  ]\n}\n\n// ---- Theme ---------------------------------------------------------------\n\n/**\n * How a spotlit {@link PlotRegion} is drawn — the dashed rules on its bounded\n * edges, the wash filling it, and how far the series fade outside it.\n */\nexport interface RegionConfig {\n  /** The dashed rule marking each bounded edge. */\n  stroke: Stroke\n  /** Wash filling the region, drawn under the series lines. */\n  fill: Fill\n  /** Opacity the stretch of every series *outside* the region fades to. */\n  dimOpacity: number\n}\n\n/** A {@link LineChart}'s full, resolved visual theme. */\nexport interface ChartConfig {\n  /**\n   * Default per-series line stroke, cycled by series index (`i % length`). A\n   * series' own `fill`, when set, overrides just the colour.\n   */\n  seriesStyles: Stroke[]\n  xAxis: AxisConfig\n  yAxis: AxisConfig\n  /** The plot panel: border, fill, and drop shadow. */\n  plotArea: PlotAreaConfig\n  legend: LegendConfig\n  /** The spotlit-region annotation — see {@link RegionConfig}. */\n  region: RegionConfig\n}\n\n/**\n * Author-facing partial theme, passed as {@link LineChart}'s `theme` prop —\n * every branch optional and deep-merged onto {@link DEFAULT_CHART_THEME}.\n */\nexport type ChartTheme = {\n  seriesStyles?: Stroke[]\n  xAxis?: Partial<AxisConfig>\n  yAxis?: Partial<AxisConfig>\n  plotArea?: Partial<PlotAreaConfig>\n  legend?: LegendTheme\n  region?: Partial<RegionConfig>\n}\n\n/**\n * The legend of a line chart: the shared one, with a small rounded-square\n * swatch in place of the wide chip. A bar's or a wedge's swatch stands in for\n * an area of paint and is drawn like one; a line's stands in for a colour, and\n * a square reads as the sample it is.\n */\nconst LINE_CHART_LEGEND: LegendConfig = {\n  ...DEFAULT_LEGEND,\n  markerStyle: {\n    ...DEFAULT_LEGEND.markerStyle,\n    width: 20,\n    height: 20,\n    borderRadius: 6,\n  },\n}\n\n/** The chart's out-of-the-box look. */\nexport const DEFAULT_CHART_THEME: ChartConfig = {\n  seriesStyles: DEFAULT_SERIES_STROKES,\n  xAxis: DEFAULT_X_AXIS,\n  yAxis: DEFAULT_Y_AXIS,\n  plotArea: DEFAULT_PLOT_AREA,\n  legend: LINE_CHART_LEGEND,\n  region: {\n    // Brighter than the grid and dashed, so the boundary reads as a call-out\n    // rather than another axis line; `butt` caps keep the dash lengths exact.\n    stroke: {\n      weight: 3,\n      fill: CHART_PALETTE.regionColor,\n      dash: [14, 12],\n      cap: \"butt\",\n    },\n    // A wash barely above the panel — enough to tint the band, not enough to\n    // mute the series drawn over it.\n    fill: Fills.color(CHART_PALETTE.regionColor, { opacity: 0.08 }),\n    dimOpacity: SPOTLIGHT_DIM,\n  },\n}\n\nfunction resolveRegionConfig(\n  region: Partial<RegionConfig> | undefined,\n  previous: RegionConfig\n): RegionConfig {\n  return {\n    stroke: strokeOps.resolve(region?.stroke ?? previous.stroke),\n    fill: fillOps.resolve(region?.fill ?? previous.fill),\n    dimOpacity: region?.dimOpacity ?? previous.dimOpacity,\n  }\n}\n\nfunction lerpRegionConfig(\n  from: RegionConfig,\n  to: RegionConfig,\n  t: number\n): RegionConfig {\n  return {\n    stroke: strokeOps.lerp(\n      from.stroke as StrokeResolved[],\n      to.stroke as StrokeResolved[],\n      t\n    ),\n    fill: fillOps.lerp(\n      from.fill as FillResolved[],\n      to.fill as FillResolved[],\n      t\n    ),\n    dimOpacity: lerpNumber(from.dimOpacity, to.dimOpacity, t),\n  }\n}\n\n/**\n * {@link LineChart}'s `theme` entry's resolve: merges the author's partial\n * {@link ChartTheme} onto `previous` (falling back to\n * {@link DEFAULT_CHART_THEME} on first resolution), fully resolving every leaf.\n */\nexport function resolveChartTheme(\n  theme: ChartTheme | undefined,\n  previous?: ChartConfig\n): ChartConfig {\n  const base = previous ?? DEFAULT_CHART_THEME\n  return {\n    seriesStyles: resolveSeriesStrokes(theme?.seriesStyles, base.seriesStyles),\n    xAxis: resolveAxisConfig(theme?.xAxis, base.xAxis),\n    yAxis: resolveAxisConfig(theme?.yAxis, base.yAxis),\n    plotArea: resolvePlotArea(theme?.plotArea, base.plotArea),\n    legend: resolveLegendConfig(theme?.legend, base.legend),\n    region: resolveRegionConfig(theme?.region, base.region),\n  }\n}\n\n/** {@link LineChart}'s `theme` entry's lerp — leaf by leaf. */\nexport function lerpChartTheme(\n  from: ChartConfig,\n  to: ChartConfig,\n  t: number\n): ChartConfig {\n  return {\n    seriesStyles: lerpSeriesStrokes(from.seriesStyles, to.seriesStyles, t),\n    xAxis: lerpAxisConfig(from.xAxis, to.xAxis, t),\n    yAxis: lerpAxisConfig(from.yAxis, to.yAxis, t),\n    plotArea: lerpPlotArea(from.plotArea, to.plotArea, t),\n    legend: lerpLegendConfig(from.legend, to.legend, t),\n    region: lerpRegionConfig(from.region, to.region, t),\n  }\n}\n\n// ---- Scales --------------------------------------------------------------\n\n/**\n * Resolve one series' `[x, y]` points out of the chart's rows: each row's\n * position on the {@link XScale} paired with its own `field` column, sorted\n * along x so the polyline traces left-to-right whatever order the rows arrived\n * in.\n *\n * A row missing its y column contributes a 0 rather than a gap — these charts\n * draw continuous lines, so dropping the point would silently bridge the hole.\n *\n * Takes the resolved scale rather than the column *name*, because what a row's x\n * is depends on what kind of column it came out of: a number, an instant, or a\n * place in the file. See `x-scale.ts`.\n */\nexport function seriesPoints(\n  data: DataRecord[],\n  x: XScale,\n  series: LineSeries\n): [x: number, y: number][] {\n  return data\n    .map((row, i): [number, number] => [x.at(i), num(row, series.field)])\n    .sort((a, b) => a[0] - b[0])\n}\n\n/** Min/max across every series' column, the fallback when unset. */\nexport function yExtent(data: DataRecord[], series: LineSeries[]): Range {\n  let lo = Infinity\n  let hi = -Infinity\n  for (const row of data)\n    for (const s of series) {\n      const v = num(row, s.field)\n      if (v < lo) lo = v\n      if (v > hi) hi = v\n    }\n  return lo <= hi ? [lo, hi] : [0, 1]\n}\n\n/**\n * Effective vertical scale: the explicit `range`, else the data's y extent\n * nudged out to tidy step bounds so markers read as round numbers.\n *\n * `divisions` is how many segments the auto-range is stepped into (one fewer\n * than a marker count) — it only shapes the tidy step when `range` is omitted.\n */\nexport function resolveYScale(\n  data: DataRecord[],\n  series: LineSeries[],\n  range: Range | undefined,\n  divisions: number\n): Range {\n  if (range) return range\n  const [lo, hi] = yExtent(data, series)\n  const segments = Math.max(1, Math.round(divisions))\n  if (hi === lo) return constantScale(lo, segments)\n  const step = niceStep((hi - lo) / segments)\n  return [Math.floor(lo / step) * step, Math.ceil(hi / step) * step]\n}\n\n/**\n * The scale for data that never moves. A zero-width scale puts every tick on the\n * same value and the line on the plot's floor, so it is widened to a few steps\n * either side of the value (the step sized to its magnitude, so `5` gets\n * `[3, 7]` and `5000` gets `[3000, 7000]`), or to `[0, 1]` for all zeros, as for\n * no data at all.\n */\nfunction constantScale(value: number, segments: number): Range {\n  if (value === 0) return [0, 1]\n  const step = niceStep(Math.abs(value) / segments)\n  return [value - step, value + step]\n}\n"]}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/line-chart/shared.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Fills,\n  fillOps,\n  lerpNumber,\n  strokeOps,\n  type DataRecord,\n  type Fill,\n  type FillResolved,\n  type Stroke,\n  type StrokeResolved,\n  type Vector2,\n} from \"@motionscript/sdk\"\nimport { niceStep } from \"@motionscript/sdk/component\"\n\nimport {\n  CHART_PALETTE,\n  DEFAULT_LEGEND,\n  DEFAULT_PLOT_AREA,\n  DEFAULT_SERIES_STROKES,\n  DEFAULT_X_AXIS,\n  DEFAULT_Y_AXIS,\n  SPOTLIGHT_DIM,\n  lerpAxisConfig,\n  lerpLegendConfig,\n  lerpPlotArea,\n  lerpSeriesStrokes,\n  num,\n  resolveAxisConfig,\n  resolveLegendConfig,\n  resolvePlotArea,\n  resolveSeriesStrokes,\n  type AxisConfig,\n  type ChartSeries,\n  type LegendConfig,\n  type LegendTheme,\n  type PlotAreaConfig,\n  type Range,\n} from \"../kit/shared\"\nimport type { XScale } from \"./x-scale\"\n\n/** One polyline of a {@link LineChart}: {@link ChartSeries} under the name for what it draws here. */\nexport type LineSeries = ChartSeries\n\n/**\n * A rectangular slice of the plot in data units, the input to `spotlightRegion`\n * and `zoomTo`. Either axis may be omitted: `{ x: [60, 100] }` is a full-height\n * band. A reversed range reads the same as a forward one.\n */\nexport interface PlotRegion {\n  /** Omit to span the full plot width. */\n  x?: Range\n  /** Omit to span the full plot height. */\n  y?: Range\n}\n\n/**\n * A {@link PlotRegion} in the plot's centred pixel space (origin at the centre,\n * y-up), the frame the series points live in. An axis the author left unbounded\n * has its edges pinned to the plot's own and draws no rule.\n */\nexport interface RegionBox {\n  left: number\n  right: number\n  bottom: number\n  top: number\n  xBounded: boolean\n  yBounded: boolean\n}\n\n/** The \"no region\" resting value. */\nexport const EMPTY_REGION_BOX: RegionBox = {\n  left: 0,\n  right: 0,\n  bottom: 0,\n  top: 0,\n  xBounded: false,\n  yBounded: false,\n}\n\n/** Whether `box` is non-degenerate, so there is something to spotlight. */\nexport function hasRegion(box: RegionBox): boolean {\n  return box.right > box.left && box.top > box.bottom\n}\n\n/**\n * Resolve a {@link PlotRegion} against the plot rectangle (centred pixel space)\n * and the data ranges its edges span. An omitted axis takes the plot's own\n * edges; a given one is clamped to the plot.\n */\nexport function resolveRegionBox(\n  region: PlotRegion | null | undefined,\n  plot: { left: number; right: number; bottom: number; top: number },\n  xScale: Range,\n  yScale: Range\n): RegionBox {\n  if (!region || (region.x === undefined && region.y === undefined)) {\n    return EMPTY_REGION_BOX\n  }\n\n  const span = (\n    range: Range | undefined,\n    [min, max]: Range,\n    lo: number,\n    hi: number\n  ): [number, number, boolean] => {\n    if (range === undefined || max <= min) return [lo, hi, false]\n    const a = Math.min(range[0], range[1])\n    const b = Math.max(range[0], range[1])\n    const toPx = (v: number) => lo + ((v - min) / (max - min)) * (hi - lo)\n    return [\n      Math.max(lo, Math.min(hi, toPx(a))),\n      Math.max(lo, Math.min(hi, toPx(b))),\n      true,\n    ]\n  }\n\n  const [left, right, xBounded] = span(region.x, xScale, plot.left, plot.right)\n  const [bottom, top, yBounded] = span(region.y, yScale, plot.bottom, plot.top)\n  return { left, right, bottom, top, xBounded, yBounded }\n}\n\n/**\n * The parts of `points` inside `box`, as contiguous sub-polylines: a series is\n * drawn dimmed in full, then these runs are re-drawn at full strength. Segments\n * are clipped, not filtered by endpoint, so a line entering mid-segment is cut\n * exactly on the boundary.\n */\nexport function clipPolylineToBox(\n  points: Vector2[],\n  box: RegionBox\n): Vector2[][] {\n  if (points.length < 2 || !hasRegion(box)) return []\n\n  const runs: Vector2[][] = []\n  let run: Vector2[] = []\n\n  for (let i = 1; i < points.length; i++) {\n    const seg = clipSegment(points[i - 1], points[i], box)\n    if (!seg) {\n      // Misses the box: close the open run.\n      if (run.length >= 2) runs.push(run)\n      run = []\n      continue\n    }\n    const [a, b] = seg\n    // Continues the open run if it starts where the last ended; otherwise the line left and came back.\n    if (run.length > 0 && samePoint(run[run.length - 1], a)) run.push(b)\n    else {\n      if (run.length >= 2) runs.push(run)\n      run = [a, b]\n    }\n  }\n  if (run.length >= 2) runs.push(run)\n  return runs\n}\n\n/** Points within half a pixel are the same point, for run-joining purposes. */\nfunction samePoint(a: Vector2, b: Vector2): boolean {\n  return Math.abs(a.x - b.x) < 0.5 && Math.abs(a.y - b.y) < 0.5\n}\n\n/** Liang-Barsky clip of one segment against `box`: the surviving `[start, end]`, or `null` when wholly outside. */\nfunction clipSegment(\n  a: Vector2,\n  b: Vector2,\n  box: RegionBox\n): [Vector2, Vector2] | null {\n  const dx = b.x - a.x\n  const dy = b.y - a.y\n  let t0 = 0\n  let t1 = 1\n\n  // Each edge as (p, q): the segment survives where p*t <= q.\n  const edges: [number, number][] = [\n    [-dx, a.x - box.left],\n    [dx, box.right - a.x],\n    [-dy, a.y - box.bottom],\n    [dy, box.top - a.y],\n  ]\n  for (const [p, q] of edges) {\n    if (p === 0) {\n      // Parallel to this edge: outside it, the whole segment is out.\n      if (q < 0) return null\n      continue\n    }\n    const r = q / p\n    if (p < 0) {\n      if (r > t1) return null\n      if (r > t0) t0 = r\n    } else {\n      if (r < t0) return null\n      if (r < t1) t1 = r\n    }\n  }\n  return [\n    { x: a.x + t0 * dx, y: a.y + t0 * dy },\n    { x: a.x + t1 * dx, y: a.y + t1 * dy },\n  ]\n}\n\n/** How a spotlit {@link PlotRegion} is drawn: rules on its bounded edges, a wash, and how far series fade outside it. */\nexport interface RegionConfig {\n  /** Marks each bounded edge. */\n  stroke: Stroke\n  /** Drawn under the series lines. */\n  fill: Fill\n  /** Opacity the stretch of every series outside the region fades to. */\n  dimOpacity: number\n}\n\n/** A {@link LineChart}'s full, resolved visual theme. */\nexport interface ChartConfig {\n  /** Cycled by series index; a series' own `fill` overrides just the colour. */\n  seriesStyles: Stroke[]\n  xAxis: AxisConfig\n  yAxis: AxisConfig\n  plotArea: PlotAreaConfig\n  legend: LegendConfig\n  region: RegionConfig\n}\n\n/** The author's partial theme, deep-merged onto {@link DEFAULT_CHART_THEME}. */\nexport type ChartTheme = {\n  seriesStyles?: Stroke[]\n  xAxis?: Partial<AxisConfig>\n  yAxis?: Partial<AxisConfig>\n  plotArea?: Partial<PlotAreaConfig>\n  legend?: LegendTheme\n  region?: Partial<RegionConfig>\n}\n\n/** The shared legend with a small square swatch: a line's swatch stands for a colour, where a bar's or wedge's stands for an area of paint. */\nconst LINE_CHART_LEGEND: LegendConfig = {\n  ...DEFAULT_LEGEND,\n  markerStyle: {\n    ...DEFAULT_LEGEND.markerStyle,\n    width: 20,\n    height: 20,\n    borderRadius: 6,\n  },\n}\n\nexport const DEFAULT_CHART_THEME: ChartConfig = {\n  seriesStyles: DEFAULT_SERIES_STROKES,\n  xAxis: DEFAULT_X_AXIS,\n  yAxis: DEFAULT_Y_AXIS,\n  plotArea: DEFAULT_PLOT_AREA,\n  legend: LINE_CHART_LEGEND,\n  region: {\n    // Brighter and dashed so it reads as a call-out, not an axis line; `butt` caps keep dash lengths exact.\n    stroke: {\n      weight: 3,\n      fill: CHART_PALETTE.regionColor,\n      dash: [14, 12],\n      cap: \"butt\",\n    },\n    fill: Fills.color(CHART_PALETTE.regionColor, { opacity: 0.08 }),\n    dimOpacity: SPOTLIGHT_DIM,\n  },\n}\n\nfunction resolveRegionConfig(\n  region: Partial<RegionConfig> | undefined,\n  previous: RegionConfig\n): RegionConfig {\n  return {\n    stroke: strokeOps.resolve(region?.stroke ?? previous.stroke),\n    fill: fillOps.resolve(region?.fill ?? previous.fill),\n    dimOpacity: region?.dimOpacity ?? previous.dimOpacity,\n  }\n}\n\nfunction lerpRegionConfig(\n  from: RegionConfig,\n  to: RegionConfig,\n  t: number\n): RegionConfig {\n  return {\n    stroke: strokeOps.lerp(\n      from.stroke as StrokeResolved[],\n      to.stroke as StrokeResolved[],\n      t\n    ),\n    fill: fillOps.lerp(\n      from.fill as FillResolved[],\n      to.fill as FillResolved[],\n      t\n    ),\n    dimOpacity: lerpNumber(from.dimOpacity, to.dimOpacity, t),\n  }\n}\n\n/** The `theme` entry's resolve: merges a partial {@link ChartTheme} onto `previous` (first resolution: the default). */\nexport function resolveChartTheme(\n  theme: ChartTheme | undefined,\n  previous?: ChartConfig\n): ChartConfig {\n  const base = previous ?? DEFAULT_CHART_THEME\n  return {\n    seriesStyles: resolveSeriesStrokes(theme?.seriesStyles, base.seriesStyles),\n    xAxis: resolveAxisConfig(theme?.xAxis, base.xAxis),\n    yAxis: resolveAxisConfig(theme?.yAxis, base.yAxis),\n    plotArea: resolvePlotArea(theme?.plotArea, base.plotArea),\n    legend: resolveLegendConfig(theme?.legend, base.legend),\n    region: resolveRegionConfig(theme?.region, base.region),\n  }\n}\n\nexport function lerpChartTheme(\n  from: ChartConfig,\n  to: ChartConfig,\n  t: number\n): ChartConfig {\n  return {\n    seriesStyles: lerpSeriesStrokes(from.seriesStyles, to.seriesStyles, t),\n    xAxis: lerpAxisConfig(from.xAxis, to.xAxis, t),\n    yAxis: lerpAxisConfig(from.yAxis, to.yAxis, t),\n    plotArea: lerpPlotArea(from.plotArea, to.plotArea, t),\n    legend: lerpLegendConfig(from.legend, to.legend, t),\n    region: lerpRegionConfig(from.region, to.region, t),\n  }\n}\n\n/**\n * One series' `[x, y]` points, sorted along x so the polyline traces left to\n * right. A row missing its y contributes 0 rather than a gap, since dropping it\n * would silently bridge the hole.\n */\nexport function seriesPoints(\n  data: DataRecord[],\n  x: XScale,\n  series: LineSeries\n): [x: number, y: number][] {\n  return data\n    .map((row, i): [number, number] => [x.at(i), num(row, series.field)])\n    .sort((a, b) => a[0] - b[0])\n}\n\nexport function yExtent(data: DataRecord[], series: LineSeries[]): Range {\n  let lo = Infinity\n  let hi = -Infinity\n  for (const row of data)\n    for (const s of series) {\n      const v = num(row, s.field)\n      if (v < lo) lo = v\n      if (v > hi) hi = v\n    }\n  return lo <= hi ? [lo, hi] : [0, 1]\n}\n\n/**\n * The explicit `range`, else the data's y extent nudged out to tidy step bounds.\n * `divisions` (one fewer than the marker count) only shapes the step when\n * `range` is omitted.\n */\nexport function resolveYScale(\n  data: DataRecord[],\n  series: LineSeries[],\n  range: Range | undefined,\n  divisions: number\n): Range {\n  if (range) return range\n  const [lo, hi] = yExtent(data, series)\n  const segments = Math.max(1, Math.round(divisions))\n  if (hi === lo) return constantScale(lo, segments)\n  const step = niceStep((hi - lo) / segments)\n  return [Math.floor(lo / step) * step, Math.ceil(hi / step) * step]\n}\n\n/**\n * The scale for constant data. A zero-width scale would put every tick on one\n * value and the line on the floor, so it widens by a step sized to the\n * magnitude (`5` gets `[3, 7]`), or `[0, 1]` for zero.\n */\nfunction constantScale(value: number, segments: number): Range {\n  if (value === 0) return [0, 1]\n  const step = niceStep(Math.abs(value) / segments)\n  return [value - step, value + step]\n}\n"]}