@motionscript/charts 0.1.0 → 0.1.1-alpha.1

package/dist/line-chart/index.js

@@ -1,19 +1,6 @@
-/**
- * The line chart: a cartesian plot with a traced polyline, spotlit regions and
- * a staggered entrance.
- *
- * {@link LineChart} composes the parts below plus the shared ones in the kit
- * (the plot panel, the value axis, the legend); each part is exported too, so
- * another node type can reuse one on its own.
- *
- * These files are what a copy of the line chart takes (`registry.json`). Everything they reach for
- * that is *not* here comes from the kit and stays a dependency — see
- * `../engine.ts` for why that line is where it is.
- */
 export { LineChart, lineChartDomains } from "./line-chart.js";
 export { ChartRegion } from "./chart-region.js";
-export { ChartLine } from "./chart-line.js";
-export { HorizontalAxis } from "./horizontal-axis.js";
-export { DEFAULT_CHART_THEME, EMPTY_REGION_BOX, clipPolylineToBox, hasRegion, lerpChartTheme, resolveChartTheme, resolveRegionBox, resolveYScale, seriesPoints, yExtent, } from "./shared.js";
-export { formatInstant, parseInstant, resolveXScale } from "./x-scale.js";
+export { ChartArea, ChartLine, areaFill, traceX } from "./chart-line.js";
+export { EMPTY_REGION_BOX, LINE_LABELS, LINE_MARKS, clipPolygonToBox, clipPolylineToBox, curvePoints, cutAt, hasRegion, resolveRegionBox, resolveYScale, seriesPoints, stackExtent, stackSeries, yExtent, } from "./shared.js";
+export { EVERY_SAMPLE, formatInstant, parseInstant, resolveXScale } from "./x-scale.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/line-chart/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,OAAO,GACR,MAAM,UAAU,CAAA;AASjB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA","sourcesContent":["/**\n * The line chart: a cartesian plot with a traced polyline, spotlit regions and\n * a staggered entrance.\n *\n * {@link LineChart} composes the parts below plus the shared ones in the kit\n * (the plot panel, the value axis, the legend); each part is exported too, so\n * another node type can reuse one on its own.\n *\n * These files are what a copy of the line chart takes (`registry.json`). Everything they reach for\n * that is *not* here comes from the kit and stays a dependency — see\n * `../engine.ts` for why that line is where it is.\n */\nexport { LineChart, lineChartDomains } from \"./line-chart\"\nexport type { LineChartDomains, LineChartProps, LineChartValues } from \"./line-chart\"\nexport { ChartRegion } from \"./chart-region\"\nexport { ChartLine } from \"./chart-line\"\nexport { HorizontalAxis } from \"./horizontal-axis\"\nexport {\n  DEFAULT_CHART_THEME,\n  EMPTY_REGION_BOX,\n  clipPolylineToBox,\n  hasRegion,\n  lerpChartTheme,\n  resolveChartTheme,\n  resolveRegionBox,\n  resolveYScale,\n  seriesPoints,\n  yExtent,\n} from \"./shared\"\nexport type {\n  ChartConfig,\n  ChartTheme,\n  LineSeries,\n  PlotRegion,\n  RegionBox,\n  RegionConfig,\n} from \"./shared\"\nexport { formatInstant, parseInstant, resolveXScale } from \"./x-scale\"\nexport type { XScale, XScaleKind } from \"./x-scale\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/line-chart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,KAAK,EACL,SAAS,EAET,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,EACX,OAAO,GACR,MAAM,UAAU,CAAA;AASjB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA","sourcesContent":["export { LineChart, lineChartDomains } from \"./line-chart\"\nexport type { LineChartDomains, LineChartStyle, LineChartValues } from \"./line-chart\"\nexport { ChartRegion } from \"./chart-region\"\nexport { ChartArea, ChartLine, areaFill, traceX } from \"./chart-line\"\nexport {\n  EMPTY_REGION_BOX,\n  LINE_LABELS,\n  LINE_MARKS,\n  clipPolygonToBox,\n  clipPolylineToBox,\n  curvePoints,\n  cutAt,\n  hasRegion,\n\n  resolveRegionBox,\n  resolveYScale,\n  seriesPoints,\n  stackExtent,\n  stackSeries,\n  yExtent,\n} from \"./shared\"\nexport type {\n  LineCurve,\n  LineSeries,\n  LineStack,\n  PlotRegion,\n  RegionBox,\n  StackedSeries,\n} from \"./shared\"\nexport { EVERY_SAMPLE, formatInstant, parseInstant, resolveXScale } from \"./x-scale\"\nexport type { XScale, XScaleKind } from \"./x-scale\"\n"]}

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

@@ -1,110 +1,168 @@
-import { type DataRecord, type NodeOf, type Node2D, type Node2DProps } from "@motionscript/sdk";
-import { type AxisDomainConfig, type Range } from "../kit/shared.js";
-import { type ChartConfig, type ChartTheme, type LineSeries, type PlotRegion } from "./shared.js";
-export interface LineChartProps extends Node2DProps {
-    /** One row per sample — a plain record of field name to value. */
-    data: DataRecord[];
-    /**
-     * Key into each row for its x value, shared by every series. Named `xField`
-     * rather than `x` because every node already has an `x` — its position.
-     */
-    xField: string;
-    /** One polyline per entry: which field it plots, its legend `label`, its `fill`. */
-    series: LineSeries[];
-    /** X-axis data domain: caption, scale range, and tick placement. */
-    xAxis?: AxisDomainConfig;
-    /** Y-axis data domain: caption, scale range, and tick placement. */
-    yAxis?: AxisDomainConfig;
-    /**
-     * A slice of the plot to spotlight, in **data units**. Dashed rules mark the
-     * bounded edges and every series fades outside the box — see
-     * `spotlightRegion`, which animates the same thing. `null` (the default) is no
-     * region.
-     */
-    region?: PlotRegion | null;
-    /**
-     * The chart's visual theme — series palette, axis text/grid/gutters, plot
-     * panel paint, and legend styling. Every branch is optional and deep-merged
-     * onto {@link DEFAULT_CHART_THEME}, so pass only what you want to override.
-     */
-    theme?: ChartTheme;
-    /** Whether the legend row below the plot is drawn at all. */
-    showLegend?: boolean;
-}
+import { type DataRecord, type NodeOf, type OutOf, type Node2D, type Node2DProps as _Node2DProps, type Fill as _Fill, type FillResolved as _FillResolved, type Stroke as _Stroke, type StrokeResolved as _StrokeResolved, type StyleInput as _StyleInput, type StyleValues as _StyleValues } from "@motionscript/sdk";
+import { type AxisDomainConfig, type ResolvedAxisDomain } from "../kit/shared.js";
+import { type LineSeries, type LineStack, type PlotRegion } from "./shared.js";
+declare const LINE_STYLE: import("@motionscript/sdk").Type<_StyleInput<{
+    legend: import("@motionscript/sdk").Type<"right" | "top" | "bottom" | "none", "right" | "top" | "bottom" | "none", false>;
+    swatch: import("@motionscript/sdk").Type<"square" | "circle" | "line", "square" | "circle" | "line", false>;
+} & {
+    horizontalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+    verticalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+    axisStroke: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+    showXAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    showYAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+} & {
+    fontFamily: import("@motionscript/sdk").Type<string, string, false>;
+    fontSize: import("@motionscript/sdk").Type<number, number, false>;
+    fontWeight: import("@motionscript/sdk").Type<number, number, false>;
+} & {
+    palette: import("@motionscript/sdk").Type<_Fill[], _FillResolved[][], false>;
+    foreground: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    muted: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    background: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+} & {
+    strokeWidth: import("@motionscript/sdk").Type<number, number, false>;
+    curve: import("@motionscript/sdk").Type<"step" | "linear" | "smooth", "step" | "linear" | "smooth", false>;
+    dots: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    dotSize: import("@motionscript/sdk").Type<number, number, false>;
+    area: import("@motionscript/sdk").Type<"none" | "solid" | "gradient", "none" | "solid" | "gradient", false>;
+    areaOpacity: import("@motionscript/sdk").Type<number, number, false>;
+} & {
+    values: import("@motionscript/sdk").Type<"none" | "above" | "below", "none" | "above" | "below", false>;
+}>, _StyleValues<{
+    legend: import("@motionscript/sdk").Type<"right" | "top" | "bottom" | "none", "right" | "top" | "bottom" | "none", false>;
+    swatch: import("@motionscript/sdk").Type<"square" | "circle" | "line", "square" | "circle" | "line", false>;
+} & {
+    horizontalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+    verticalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+    axisStroke: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+    showXAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    showYAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+} & {
+    fontFamily: import("@motionscript/sdk").Type<string, string, false>;
+    fontSize: import("@motionscript/sdk").Type<number, number, false>;
+    fontWeight: import("@motionscript/sdk").Type<number, number, false>;
+} & {
+    palette: import("@motionscript/sdk").Type<_Fill[], _FillResolved[][], false>;
+    foreground: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    muted: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    background: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+} & {
+    strokeWidth: import("@motionscript/sdk").Type<number, number, false>;
+    curve: import("@motionscript/sdk").Type<"step" | "linear" | "smooth", "step" | "linear" | "smooth", false>;
+    dots: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    dotSize: import("@motionscript/sdk").Type<number, number, false>;
+    area: import("@motionscript/sdk").Type<"none" | "solid" | "gradient", "none" | "solid" | "gradient", false>;
+    areaOpacity: import("@motionscript/sdk").Type<number, number, false>;
+} & {
+    values: import("@motionscript/sdk").Type<"none" | "above" | "below", "none" | "above" | "below", false>;
+}>, false>;
+/** A line chart's resolved style. */
+export type LineChartStyle = OutOf<typeof LINE_STYLE>;
 /** Both axes' domains with their ranges and ticks resolved. */
 export interface LineChartDomains {
-    readonly x: AxisDomainConfig & {
-        readonly range: Range;
-        readonly ticks: number[];
-    };
-    readonly y: AxisDomainConfig & {
-        readonly range: Range;
-        readonly ticks: number[];
-    };
+    readonly x: ResolvedAxisDomain;
+    readonly y: ResolvedAxisDomain;
 }
 /** What a line chart plots, as its entries hold it. */
 export interface LineChartValues {
     readonly data: DataRecord[];
     readonly xField: string;
     readonly series: LineSeries[];
+    readonly stack: LineStack;
     readonly xAxis: AxisDomainConfig;
     readonly yAxis: AxisDomainConfig;
+    /** Each series' share of a stack, `1` when missing. */
+    readonly weights?: readonly number[];
+    /** An area must reach its baseline, so a chart with areas keeps zero on the scale. */
+    readonly style?: {
+        readonly area: string;
+    };
 }
-/** Both axes as a line chart draws them now, an auto range or tick row read back as itself. */
+/** Both axes as drawn now. */
 export declare function lineChartDomains(s: LineChartValues): LineChartDomains;
 /**
- * A multi-series line chart, composed from five independent parts rather than
- * one monolithic draw:
- *
- * - {@link ChartCanvas} — the plot panel with a two-way grid, under everything.
- * - {@link VerticalAxis} / {@link HorizontalAxis} — columns/rows of real text
- *   markers that stagger in, each carrying its own axis caption.
- * - {@link ChartRegion} — the optional call-out marking a spotlit slice of the
- *   plot: dashed rules on its bounded edges, and every series faded outside it.
- * - {@link ChartLine} (one per series) — the traced polylines over the canvas.
- * - {@link ChartLegend} — a row of entries below the chart, one per series.
- *
- * Every part reads the chart's entries through bindings, and the lines, the
- * region and the grid all map against the plot panel's own laid-out box, so
- * points land exactly on their markers and the chart re-flows if its box
- * changes.
- *
- * **Resting state is the finished chart**: an editor paints a node's Initial
- * state on a paused canvas. `enter` arms every part on its first frame.
+ * A multi-series line or area chart composed of {@link ChartCanvas}, the value
+ * and x axes, {@link ChartRegion}, a {@link ChartArea} and a {@link ChartLine}
+ * per series, and {@link ChartLegend}. Every part reads the chart's entries
+ * through bindings and maps against the plot panel's own laid-out box.
  *
- * Past the entrance, `showSeries`/`hideSeries`/`spotlightSeries` pick out a
- * *series*, `spotlightRegion` marks a *slice of the plot* without changing the
- * scale, and `zoomTo` rescales the axes so a slice fills the plot. A spotlit
- * region resolves against the live scales, so it travels with a zoom. A `to` of
- * an axis `range` or `ticks` tweens from the domain as drawn (see
- * {@link lerpAxisEntry}), so an auto axis rescales continuously.
+ * Resting state is the finished chart; `enter` arms every part on its first
+ * frame. A `to` of an axis `range` or `ticks` tweens from the domain as drawn
+ * (see {@link lerpAxisEntry}), so an auto axis rescales continuously.
  */
 export declare const LineChart: import("@motionscript/sdk").Component<"lineChart", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
     readonly data: import("@motionscript/sdk").Type<DataRecord[], DataRecord[], false>;
     readonly xField: "";
     readonly series: import("@motionscript/sdk").Type<import("../index.js").ChartSeries[], import("../index.js").ChartSeries[], false>;
+    /** `stacked`: each series sits on the sum of those before it; `percent`: every row reads as shares of 100. */
+    readonly stack: import("@motionscript/sdk").Type<"none" | "percent" | "stacked", "none" | "percent" | "stacked", false>;
     readonly xAxis: import("@motionscript/sdk").Type<AxisDomainConfig, AxisDomainConfig, false>;
     readonly yAxis: import("@motionscript/sdk").Type<AxisDomainConfig, AxisDomainConfig, false>;
-    readonly theme: import("@motionscript/sdk").Type<ChartTheme, ChartConfig, false>;
-    /**
-     * The spotlit slice of the plot in data units, or `null` for none. The box
-     * snaps; the animation is {@link regionReveal} drawing the rules on.
-     */
+    readonly style: import("@motionscript/sdk").Type<_StyleInput<{
+        legend: import("@motionscript/sdk").Type<"right" | "top" | "bottom" | "none", "right" | "top" | "bottom" | "none", false>;
+        swatch: import("@motionscript/sdk").Type<"square" | "circle" | "line", "square" | "circle" | "line", false>;
+    } & {
+        horizontalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        verticalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        axisStroke: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        showXAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        showYAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    } & {
+        fontFamily: import("@motionscript/sdk").Type<string, string, false>;
+        fontSize: import("@motionscript/sdk").Type<number, number, false>;
+        fontWeight: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        palette: import("@motionscript/sdk").Type<_Fill[], _FillResolved[][], false>;
+        foreground: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        muted: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        background: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    } & {
+        strokeWidth: import("@motionscript/sdk").Type<number, number, false>;
+        curve: import("@motionscript/sdk").Type<"step" | "linear" | "smooth", "step" | "linear" | "smooth", false>;
+        dots: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        dotSize: import("@motionscript/sdk").Type<number, number, false>;
+        area: import("@motionscript/sdk").Type<"none" | "solid" | "gradient", "none" | "solid" | "gradient", false>;
+        areaOpacity: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        values: import("@motionscript/sdk").Type<"none" | "above" | "below", "none" | "above" | "below", false>;
+    }>, _StyleValues<{
+        legend: import("@motionscript/sdk").Type<"right" | "top" | "bottom" | "none", "right" | "top" | "bottom" | "none", false>;
+        swatch: import("@motionscript/sdk").Type<"square" | "circle" | "line", "square" | "circle" | "line", false>;
+    } & {
+        horizontalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        verticalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        axisStroke: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        showXAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        showYAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    } & {
+        fontFamily: import("@motionscript/sdk").Type<string, string, false>;
+        fontSize: import("@motionscript/sdk").Type<number, number, false>;
+        fontWeight: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        palette: import("@motionscript/sdk").Type<_Fill[], _FillResolved[][], false>;
+        foreground: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        muted: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        background: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    } & {
+        strokeWidth: import("@motionscript/sdk").Type<number, number, false>;
+        curve: import("@motionscript/sdk").Type<"step" | "linear" | "smooth", "step" | "linear" | "smooth", false>;
+        dots: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        dotSize: import("@motionscript/sdk").Type<number, number, false>;
+        area: import("@motionscript/sdk").Type<"none" | "solid" | "gradient", "none" | "solid" | "gradient", false>;
+        areaOpacity: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        values: import("@motionscript/sdk").Type<"none" | "above" | "below", "none" | "above" | "below", false>;
+    }>, false>;
+    /** The spotlit slice in data units, or `null`. The box snaps; {@link regionReveal} animates it. */
     readonly region: import("@motionscript/sdk").Type<PlotRegion | null, PlotRegion | null, false>;
-    /**
-     * How far the `region` call-out is drawn in, `[0, 1]`: the rules grow out and
-     * the wash fades up as it climbs, while every line's out-of-region stretch
-     * fades to the theme's `region.dimOpacity`.
-     */
+    /** How far the `region` call-out is drawn in, `[0, 1]`: rules grow, wash fades up, out-of-region stretches fade. */
     readonly regionReveal: 0;
-    /** Read as the chart is built: the legend is a part the chart builds or doesn't. */
-    readonly showLegend: import("@motionscript/sdk").Type<boolean, boolean, false>;
-    /**
-     * The domain `zoomTo` first left, so `resetZoom` restores the chart as it
-     * stood, auto-derived ticks included. Cleared by `resetZoom`, so the next zoom
-     * remembers wherever the chart rests then.
-     */
+    /** The domain `zoomTo` first left, so `resetZoom` restores it, auto-derived ticks included. */
     readonly home: import("@motionscript/sdk").Type<LineChartDomains | null, LineChartDomains | null, false>;
+    /** Each series' share of a stack, seeded from `enabled`: a weight rather than a switch, so a hidden series sinks out. */
+    readonly weights: import("@motionscript/sdk").Type<number[], number[], false>;
+    /** Whether the plot clips its marks, from a zoom's first frame until a reset lands. */
+    readonly clipped: import("@motionscript/sdk").Type<boolean, boolean, true>;
 }>, {
     readonly enter: {};
     readonly spotlightRegion: {
@@ -124,58 +182,152 @@ export declare const LineChart: import("@motionscript/sdk").Component<"lineChart
     readonly spotlightSeries: {
         readonly seriesIndex: import("@motionscript/sdk").Type<number, number, false>;
     };
-}, readonly [], Node2D<Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+}, readonly [], Node2D<_Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
     readonly data: import("@motionscript/sdk").Type<DataRecord[], DataRecord[], false>;
     readonly xField: "";
     readonly series: import("@motionscript/sdk").Type<import("../index.js").ChartSeries[], import("../index.js").ChartSeries[], false>;
+    /** `stacked`: each series sits on the sum of those before it; `percent`: every row reads as shares of 100. */
+    readonly stack: import("@motionscript/sdk").Type<"none" | "percent" | "stacked", "none" | "percent" | "stacked", false>;
     readonly xAxis: import("@motionscript/sdk").Type<AxisDomainConfig, AxisDomainConfig, false>;
     readonly yAxis: import("@motionscript/sdk").Type<AxisDomainConfig, AxisDomainConfig, false>;
-    readonly theme: import("@motionscript/sdk").Type<ChartTheme, ChartConfig, false>;
-    /**
-     * The spotlit slice of the plot in data units, or `null` for none. The box
-     * snaps; the animation is {@link regionReveal} drawing the rules on.
-     */
+    readonly style: import("@motionscript/sdk").Type<_StyleInput<{
+        legend: import("@motionscript/sdk").Type<"right" | "top" | "bottom" | "none", "right" | "top" | "bottom" | "none", false>;
+        swatch: import("@motionscript/sdk").Type<"square" | "circle" | "line", "square" | "circle" | "line", false>;
+    } & {
+        horizontalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        verticalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        axisStroke: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        showXAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        showYAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    } & {
+        fontFamily: import("@motionscript/sdk").Type<string, string, false>;
+        fontSize: import("@motionscript/sdk").Type<number, number, false>;
+        fontWeight: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        palette: import("@motionscript/sdk").Type<_Fill[], _FillResolved[][], false>;
+        foreground: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        muted: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        background: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    } & {
+        strokeWidth: import("@motionscript/sdk").Type<number, number, false>;
+        curve: import("@motionscript/sdk").Type<"step" | "linear" | "smooth", "step" | "linear" | "smooth", false>;
+        dots: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        dotSize: import("@motionscript/sdk").Type<number, number, false>;
+        area: import("@motionscript/sdk").Type<"none" | "solid" | "gradient", "none" | "solid" | "gradient", false>;
+        areaOpacity: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        values: import("@motionscript/sdk").Type<"none" | "above" | "below", "none" | "above" | "below", false>;
+    }>, _StyleValues<{
+        legend: import("@motionscript/sdk").Type<"right" | "top" | "bottom" | "none", "right" | "top" | "bottom" | "none", false>;
+        swatch: import("@motionscript/sdk").Type<"square" | "circle" | "line", "square" | "circle" | "line", false>;
+    } & {
+        horizontalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        verticalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        axisStroke: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        showXAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        showYAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    } & {
+        fontFamily: import("@motionscript/sdk").Type<string, string, false>;
+        fontSize: import("@motionscript/sdk").Type<number, number, false>;
+        fontWeight: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        palette: import("@motionscript/sdk").Type<_Fill[], _FillResolved[][], false>;
+        foreground: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        muted: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        background: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    } & {
+        strokeWidth: import("@motionscript/sdk").Type<number, number, false>;
+        curve: import("@motionscript/sdk").Type<"step" | "linear" | "smooth", "step" | "linear" | "smooth", false>;
+        dots: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        dotSize: import("@motionscript/sdk").Type<number, number, false>;
+        area: import("@motionscript/sdk").Type<"none" | "solid" | "gradient", "none" | "solid" | "gradient", false>;
+        areaOpacity: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        values: import("@motionscript/sdk").Type<"none" | "above" | "below", "none" | "above" | "below", false>;
+    }>, false>;
+    /** The spotlit slice in data units, or `null`. The box snaps; {@link regionReveal} animates it. */
     readonly region: import("@motionscript/sdk").Type<PlotRegion | null, PlotRegion | null, false>;
-    /**
-     * How far the `region` call-out is drawn in, `[0, 1]`: the rules grow out and
-     * the wash fades up as it climbs, while every line's out-of-region stretch
-     * fades to the theme's `region.dimOpacity`.
-     */
+    /** How far the `region` call-out is drawn in, `[0, 1]`: rules grow, wash fades up, out-of-region stretches fade. */
     readonly regionReveal: 0;
-    /** Read as the chart is built: the legend is a part the chart builds or doesn't. */
-    readonly showLegend: import("@motionscript/sdk").Type<boolean, boolean, false>;
-    /**
-     * The domain `zoomTo` first left, so `resetZoom` restores the chart as it
-     * stood, auto-derived ticks included. Cleared by `resetZoom`, so the next zoom
-     * remembers wherever the chart rests then.
-     */
+    /** The domain `zoomTo` first left, so `resetZoom` restores it, auto-derived ticks included. */
     readonly home: import("@motionscript/sdk").Type<LineChartDomains | null, LineChartDomains | null, false>;
+    /** Each series' share of a stack, seeded from `enabled`: a weight rather than a switch, so a hidden series sinks out. */
+    readonly weights: import("@motionscript/sdk").Type<number[], number[], false>;
+    /** Whether the plot clips its marks, from a zoom's first frame until a reset lands. */
+    readonly clipped: import("@motionscript/sdk").Type<boolean, boolean, true>;
 }>, readonly [], import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
     readonly data: import("@motionscript/sdk").Type<DataRecord[], DataRecord[], false>;
     readonly xField: "";
     readonly series: import("@motionscript/sdk").Type<import("../index.js").ChartSeries[], import("../index.js").ChartSeries[], false>;
+    /** `stacked`: each series sits on the sum of those before it; `percent`: every row reads as shares of 100. */
+    readonly stack: import("@motionscript/sdk").Type<"none" | "percent" | "stacked", "none" | "percent" | "stacked", false>;
     readonly xAxis: import("@motionscript/sdk").Type<AxisDomainConfig, AxisDomainConfig, false>;
     readonly yAxis: import("@motionscript/sdk").Type<AxisDomainConfig, AxisDomainConfig, false>;
-    readonly theme: import("@motionscript/sdk").Type<ChartTheme, ChartConfig, false>;
-    /**
-     * The spotlit slice of the plot in data units, or `null` for none. The box
-     * snaps; the animation is {@link regionReveal} drawing the rules on.
-     */
+    readonly style: import("@motionscript/sdk").Type<_StyleInput<{
+        legend: import("@motionscript/sdk").Type<"right" | "top" | "bottom" | "none", "right" | "top" | "bottom" | "none", false>;
+        swatch: import("@motionscript/sdk").Type<"square" | "circle" | "line", "square" | "circle" | "line", false>;
+    } & {
+        horizontalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        verticalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        axisStroke: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        showXAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        showYAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    } & {
+        fontFamily: import("@motionscript/sdk").Type<string, string, false>;
+        fontSize: import("@motionscript/sdk").Type<number, number, false>;
+        fontWeight: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        palette: import("@motionscript/sdk").Type<_Fill[], _FillResolved[][], false>;
+        foreground: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        muted: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        background: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    } & {
+        strokeWidth: import("@motionscript/sdk").Type<number, number, false>;
+        curve: import("@motionscript/sdk").Type<"step" | "linear" | "smooth", "step" | "linear" | "smooth", false>;
+        dots: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        dotSize: import("@motionscript/sdk").Type<number, number, false>;
+        area: import("@motionscript/sdk").Type<"none" | "solid" | "gradient", "none" | "solid" | "gradient", false>;
+        areaOpacity: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        values: import("@motionscript/sdk").Type<"none" | "above" | "below", "none" | "above" | "below", false>;
+    }>, _StyleValues<{
+        legend: import("@motionscript/sdk").Type<"right" | "top" | "bottom" | "none", "right" | "top" | "bottom" | "none", false>;
+        swatch: import("@motionscript/sdk").Type<"square" | "circle" | "line", "square" | "circle" | "line", false>;
+    } & {
+        horizontalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        verticalGrid: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        axisStroke: import("@motionscript/sdk").Type<_Stroke, _StrokeResolved[], false>;
+        showXAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        showYAxis: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    } & {
+        fontFamily: import("@motionscript/sdk").Type<string, string, false>;
+        fontSize: import("@motionscript/sdk").Type<number, number, false>;
+        fontWeight: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        palette: import("@motionscript/sdk").Type<_Fill[], _FillResolved[][], false>;
+        foreground: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        muted: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+        background: import("@motionscript/sdk").Type<_Fill, _FillResolved[], false>;
+    } & {
+        strokeWidth: import("@motionscript/sdk").Type<number, number, false>;
+        curve: import("@motionscript/sdk").Type<"step" | "linear" | "smooth", "step" | "linear" | "smooth", false>;
+        dots: import("@motionscript/sdk").Type<boolean, boolean, false>;
+        dotSize: import("@motionscript/sdk").Type<number, number, false>;
+        area: import("@motionscript/sdk").Type<"none" | "solid" | "gradient", "none" | "solid" | "gradient", false>;
+        areaOpacity: import("@motionscript/sdk").Type<number, number, false>;
+    } & {
+        values: import("@motionscript/sdk").Type<"none" | "above" | "below", "none" | "above" | "below", false>;
+    }>, false>;
+    /** The spotlit slice in data units, or `null`. The box snaps; {@link regionReveal} animates it. */
     readonly region: import("@motionscript/sdk").Type<PlotRegion | null, PlotRegion | null, false>;
-    /**
-     * How far the `region` call-out is drawn in, `[0, 1]`: the rules grow out and
-     * the wash fades up as it climbs, while every line's out-of-region stretch
-     * fades to the theme's `region.dimOpacity`.
-     */
+    /** How far the `region` call-out is drawn in, `[0, 1]`: rules grow, wash fades up, out-of-region stretches fade. */
     readonly regionReveal: 0;
-    /** Read as the chart is built: the legend is a part the chart builds or doesn't. */
-    readonly showLegend: import("@motionscript/sdk").Type<boolean, boolean, false>;
-    /**
-     * The domain `zoomTo` first left, so `resetZoom` restores the chart as it
-     * stood, auto-derived ticks included. Cleared by `resetZoom`, so the next zoom
-     * remembers wherever the chart rests then.
-     */
+    /** The domain `zoomTo` first left, so `resetZoom` restores it, auto-derived ticks included. */
     readonly home: import("@motionscript/sdk").Type<LineChartDomains | null, LineChartDomains | null, false>;
+    /** Each series' share of a stack, seeded from `enabled`: a weight rather than a switch, so a hidden series sinks out. */
+    readonly weights: import("@motionscript/sdk").Type<number[], number[], false>;
+    /** Whether the plot clips its marks, from a zoom's first frame until a reset lands. */
+    readonly clipped: import("@motionscript/sdk").Type<boolean, boolean, true>;
 }>, {
     readonly enter: {};
     readonly spotlightRegion: {
@@ -195,6 +347,7 @@ export declare const LineChart: import("@motionscript/sdk").Component<"lineChart
     readonly spotlightSeries: {
         readonly seriesIndex: import("@motionscript/sdk").Type<number, number, false>;
     };
-}, Node2D<Node2DProps>>>>;
+}, Node2D<_Node2DProps>>>>;
 export type LineChart = NodeOf<typeof LineChart>;
+export {};
 //# sourceMappingURL=line-chart.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"line-chart.d.ts","sourceRoot":"","sources":["../../src/line-chart/line-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EAEf,KAAK,MAAM,EAEX,KAAK,MAAM,EACX,KAAK,WAAW,EAIjB,MAAM,mBAAmB,CAAA;AAU1B,OAAO,EAWL,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACX,MAAM,eAAe,CAAA;AAItB,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EAEhB,MAAM,UAAU,CAAA;AAGjB,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,kEAAkE;IAClE,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,oFAAoF;IACpF,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,oEAAoE;IACpE,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,gBAAgB,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAClF,QAAQ,CAAC,CAAC,EAAE,gBAAgB,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CACnF;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CACjC;AA4ED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAYrE;AAoGD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,SAAS;;;;;;;IASlB;;;OAGG;;IAEH;;;;OAIG;;IAEH,oFAAoF;;IAEpF;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAjBH;;;OAGG;;IAEH;;;;OAIG;;IAEH,oFAAoF;;IAEpF;;;;OAIG;;;;;;;;;IAjBH;;;OAGG;;IAEH;;;;OAIG;;IAEH,oFAAoF;;IAEpF;;;;OAIG;;;;;;;;;;;;;;;;;;;;;yBA4PL,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"line-chart.d.ts","sourceRoot":"","sources":["../../src/line-chart/line-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,KAAK,EAEV,KAAK,MAAM,EACX,KAAK,WAAW,IAAI,YAAY,EAChC,KAAK,IAAI,IAAI,KAAK,EAClB,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,cAAc,IAAI,eAAe,EAEtC,KAAK,UAAU,IAAI,WAAW,EAC9B,KAAK,WAAW,IAAI,YAAY,EAEjC,MAAM,mBAAmB,CAAA;AAS1B,OAAO,EAWL,KAAK,gBAAgB,EAErB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAA;AAgBtB,OAAO,EAML,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EAGhB,MAAM,UAAU,CAAA;AAGjB,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAIf,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAErD,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,kBAAkB,CAAA;IAC9B,QAAQ,CAAC,CAAC,EAAE,kBAAkB,CAAA;CAC/B;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,sFAAsF;IACtF,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3C;AA2DD,8BAA8B;AAC9B,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAUrE;AA+ID;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;;;;IAOlB,8GAA8G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK9G,mGAAmG;;IAEnG,oHAAoH;;IAEpH,+FAA+F;;IAE/F,yHAAyH;;IAEzH,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;;IAbvF,8GAA8G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK9G,mGAAmG;;IAEnG,oHAAoH;;IAEpH,+FAA+F;;IAE/F,yHAAyH;;IAEzH,uFAAuF;;;;;;IAbvF,8GAA8G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK9G,mGAAmG;;IAEnG,oHAAoH;;IAEpH,+FAA+F;;IAE/F,yHAAyH;;IAEzH,uFAAuF;;;;;;;;;;;;;;;;;;;;;0BAwTzF,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAA"}