@motionscript/charts 0.1.0-alpha.6 → 0.1.0-alpha.8

package/dist/browser/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionscript/charts",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "exports": {
     ".": "dist/browser/index.js",
     "./kit": "dist/browser/kit.js"

package/dist/kit/chart-border.d.ts

@@ -20,6 +20,8 @@ export declare const ChartBorder: import("@motionscript/sdk").Component<"chartBo
     readonly stroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
 }>, {}, null, _Node2D<Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
     readonly stroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
-}>, null>>;
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly stroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+}>, {}, _Node2D<Node2DProps>>>>;
 export type ChartBorder = NodeOf<typeof ChartBorder>;
 //# sourceMappingURL=chart-border.d.ts.map

package/dist/kit/chart-border.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-border.d.ts","sourceRoot":"","sources":["../../src/kit/chart-border.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,MAAM,EAEX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAK1B,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;UAatB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA"}
+{"version":3,"file":"chart-border.d.ts","sourceRoot":"","sources":["../../src/kit/chart-border.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,MAAM,EAEX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAK1B,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;;;+BAatB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA"}

package/dist/kit/chart-canvas.d.ts

@@ -53,6 +53,15 @@ export declare const ChartCanvas: import("@motionscript/sdk").Component<"chartCa
     readonly yMarkers: import("@motionscript/sdk").Type<number[], number[], false>;
     readonly xExtent: import("@motionscript/sdk").Type<Range, Range, false>;
     readonly yExtent: import("@motionscript/sdk").Type<Range, Range, false>;
-}>, null>>;
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+    readonly shadow: import("@motionscript/sdk").Type<Shadow, ShadowResolved[], false>;
+    readonly xGridStroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    readonly yGridStroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    readonly xMarkers: import("@motionscript/sdk").Type<number[], number[], false>;
+    readonly yMarkers: import("@motionscript/sdk").Type<number[], number[], false>;
+    readonly xExtent: import("@motionscript/sdk").Type<Range, Range, false>;
+    readonly yExtent: import("@motionscript/sdk").Type<Range, Range, false>;
+}>, {}, _Node2D<Node2DProps>>>>;
 export type ChartCanvas = NodeOf<typeof ChartCanvas>;
 //# sourceMappingURL=chart-canvas.d.ts.map

package/dist/kit/chart-canvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-canvas.d.ts","sourceRoot":"","sources":["../../src/kit/chart-canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,MAAM,EAEX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAIL,KAAK,KAAK,EACX,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,+CAA+C;IAC/C,IAAI,EAAE,IAAI,CAAA;IACV,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,mFAAmF;IACnF,OAAO,EAAE,KAAK,CAAA;IACd,iFAAiF;IACjF,OAAO,EAAE,KAAK,CAAA;CACf;AAKD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;UAoDtB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA"}
+{"version":3,"file":"chart-canvas.d.ts","sourceRoot":"","sources":["../../src/kit/chart-canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,MAAM,EAEX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAIL,KAAK,KAAK,EACX,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,+CAA+C;IAC/C,IAAI,EAAE,IAAI,CAAA;IACV,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,mFAAmF;IACnF,OAAO,EAAE,KAAK,CAAA;IACd,iFAAiF;IACjF,OAAO,EAAE,KAAK,CAAA;CACf;AAKD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAoDtB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA"}

package/dist/kit/chart-legend.d.ts

@@ -108,7 +108,54 @@ export declare const ChartLegend: import("@motionscript/sdk").Component<"chartLe
     readonly overlay: import("@motionscript/sdk").Attribute<Fill, _FillResolved[]>;
     readonly start: import("@motionscript/sdk").Type<number, number, false>;
     readonly end: import("@motionscript/sdk").Type<number, number, false>;
-}>, null>>;
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly series: import("@motionscript/sdk").Type<ChartSeries[], ChartSeries[], false>;
+    readonly swatches: import("@motionscript/sdk").Type<Fill[], Fill[], false>;
+    readonly legend: import("@motionscript/sdk").Type<LegendConfig, LegendConfig, false>;
+    /**
+     * How far each entry is shown, `0`–`1`. Drives its width, opacity and gap
+     * together, so `0` is an entry that takes no room and `1` is one at its
+     * natural size.
+     *
+     * This replaces adding and removing the entry from the row: a command is
+     * asked what it looks like at a time, and "is this node a child" is not a
+     * value a time can produce. Collapsed-but-present is the same picture reached
+     * by a route that *is* a function of `t`.
+     */
+    readonly reveal: import("@motionscript/sdk").Type<number[] | Readonly<Record<number, number>>, number[], false>;
+    readonly cornerRadius: import("@motionscript/sdk").Attribute<_RectCornerRadius, _CornerRadiusResolved>;
+    readonly cornerStyle: import("@motionscript/sdk").Attribute<_RectCornerStyle, _CornerStyleResolved>;
+    readonly flow: import("@motionscript/sdk").Type<_FlowMode, _FlowResolved, false>;
+    readonly gap: import("@motionscript/sdk").Type<_GapSize, _GapSize, false>;
+    readonly wrap: boolean;
+    readonly crossGap: import("@motionscript/sdk").Type<number | undefined, number | undefined, false>;
+    readonly columns: import("@motionscript/sdk").Type<number, number, false>;
+    readonly align: import("@motionscript/sdk").Attribute<_Alignment, _Vector2>;
+    readonly fill: import("@motionscript/sdk").Attribute<Fill, _FillResolved[]>;
+    readonly stroke: import("@motionscript/sdk").Attribute<_Stroke, _StrokeResolved[]>;
+    readonly shadow: import("@motionscript/sdk").Attribute<_Shadow, _ShadowResolved[]>;
+    readonly overlay: import("@motionscript/sdk").Attribute<Fill, _FillResolved[]>;
+    readonly start: import("@motionscript/sdk").Type<number, number, false>;
+    readonly end: import("@motionscript/sdk").Type<number, number, false>;
+}>, {
+    readonly showSeries: {
+        readonly index: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly hideSeries: {
+        readonly index: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly spotlightSeries: {
+        readonly index: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly fillTo: readonly ["fill"];
+    readonly strokeTo: readonly ["stroke"];
+    readonly shadowTo: readonly ["shadow"];
+    readonly overlayTo: readonly ["overlay"];
+    readonly progressTo: readonly ["start", "end"];
+    readonly flash: {
+        readonly portion: import("@motionscript/sdk").Type<number, number, false>;
+    };
+}, _Node2D<_Node2DProps>>>>;
 /** Whether series `index` is showing at all on `legend`. */
 export declare function legendShows(legend: {
     readonly reveal: readonly number[];

package/dist/kit/chart-legend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-legend.d.ts","sourceRoot":"","sources":["../../src/kit/chart-legend.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,IAAI,EACT,KAAK,MAAM,EACX,KAAK,SAAS,EAEd,KAAK,SAAS,IAAI,UAAU,EAC5B,KAAK,oBAAoB,IAAI,qBAAqB,EAClD,KAAK,mBAAmB,IAAI,oBAAoB,EAChD,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,QAAQ,IAAI,SAAS,EAC1B,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,OAAO,IAAI,QAAQ,EACxB,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,IAAI,YAAY,EAChC,KAAK,gBAAgB,IAAI,iBAAiB,EAC1C,KAAK,eAAe,IAAI,gBAAgB,EACxC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,cAAc,IAAI,eAAe,EACtC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,cAAc,IAAI,eAAe,EACtC,KAAK,OAAO,IAAI,QAAQ,EACzB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD;;;;;OAKG;IACH,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,EAAE,IAAI,EAAE,CAAA;IAChB,oFAAoF;IACpF,MAAM,EAAE,YAAY,CAAA;CACrB;AAsCD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW;;;;IAOpB;;;;;;;;;OASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IATH;;;;;;;;;OASG;;;;;;;;;;;;;;;;UAuFL,CAAA;AAWF,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAElG;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA"}
+{"version":3,"file":"chart-legend.d.ts","sourceRoot":"","sources":["../../src/kit/chart-legend.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,IAAI,EACT,KAAK,MAAM,EACX,KAAK,SAAS,EAEd,KAAK,SAAS,IAAI,UAAU,EAC5B,KAAK,oBAAoB,IAAI,qBAAqB,EAClD,KAAK,mBAAmB,IAAI,oBAAoB,EAChD,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,QAAQ,IAAI,SAAS,EAC1B,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,OAAO,IAAI,QAAQ,EACxB,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,IAAI,YAAY,EAChC,KAAK,gBAAgB,IAAI,iBAAiB,EAC1C,KAAK,eAAe,IAAI,gBAAgB,EACxC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,cAAc,IAAI,eAAe,EACtC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,cAAc,IAAI,eAAe,EACtC,KAAK,OAAO,IAAI,QAAQ,EACzB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD;;;;;OAKG;IACH,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,EAAE,IAAI,EAAE,CAAA;IAChB,oFAAoF;IACpF,MAAM,EAAE,YAAY,CAAA;CACrB;AAsCD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW;;;;IAOpB;;;;;;;;;OASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IATH;;;;;;;;;OASG;;;;;;;;;;;;;;;;;;;;IATH;;;;;;;;;OASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAuFL,CAAA;AAWF,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAElG;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA"}

package/dist/kit/vertical-axis.d.ts

@@ -69,6 +69,18 @@ export declare const VerticalAxis: import("@motionscript/sdk").Component<"vertic
     readonly axis: import("@motionscript/sdk").Type<AxisConfig, AxisConfig, false>;
     readonly label: "";
     readonly arrivals: import("@motionscript/sdk").Type<Readonly<Record<string, Arrival>>, Readonly<Record<string, Arrival>>, false>;
-}>, null>>;
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly range: import("@motionscript/sdk").Type<Range, Range, false>;
+    readonly markers: import("@motionscript/sdk").Type<number[], number[], false>;
+    readonly captions: import("@motionscript/sdk").Type<string[], string[], false>;
+    readonly axis: import("@motionscript/sdk").Type<AxisConfig, AxisConfig, false>;
+    readonly label: "";
+    readonly arrivals: import("@motionscript/sdk").Type<Readonly<Record<string, Arrival>>, Readonly<Record<string, Arrival>>, false>;
+}>, {
+    readonly enter: {
+        readonly stagger: import("@motionscript/sdk").Type<number | undefined, number | undefined, false>;
+        readonly slide: import("@motionscript/sdk").Type<number, number, false>;
+    };
+}, Node2D<Node2DProps>>>>;
 export type VerticalAxis = NodeOf<typeof VerticalAxis>;
 //# sourceMappingURL=vertical-axis.d.ts.map

package/dist/kit/vertical-axis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vertical-axis.d.ts","sourceRoot":"","sources":["../../src/kit/vertical-axis.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA8D,KAAK,OAAO,EAAE,MAAM,UAAU,CAAA;AACnG,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,4EAA4E;IAC5E,KAAK,EAAE,KAAK,CAAA;IACZ;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,oFAAoF;IACpF,IAAI,EAAE,UAAU,CAAA;IAChB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;CACd;AAKD,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;AAEnD,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrI;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;UAiHvB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,YAAY,CAAC,CAAA"}
+{"version":3,"file":"vertical-axis.d.ts","sourceRoot":"","sources":["../../src/kit/vertical-axis.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA8D,KAAK,OAAO,EAAE,MAAM,UAAU,CAAA;AACnG,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,4EAA4E;IAC5E,KAAK,EAAE,KAAK,CAAA;IACZ;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,oFAAoF;IACpF,IAAI,EAAE,UAAU,CAAA;IAChB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;CACd;AAKD,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;AAEnD,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrI;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAiHvB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,YAAY,CAAC,CAAA"}

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

@@ -1,65 +1,74 @@
-import { type NodeOf, type Node2D as _Node2D, type Node2DProps, type Stroke, type StrokeResolved, type Vector2 } from "@motionscript/sdk";
+import { type NodeOf, type Node2D as _Node2D, type Stroke, type StrokeResolved, type Vector2 } from "@motionscript/sdk";
 import { type RegionBox } from "./shared.js";
-export interface ChartLineProps extends Node2DProps {
-    /**
-     * The series polyline, already mapped into this node's local pixel space
-     * (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x.
-     */
-    points: Vector2[];
-    /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */
-    stroke: Stroke;
-    /**
-     * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left
-     * end to its right.
-     *
-     * Defaults to **1**, unlike the standalone chart this was ported from: in an
-     * editor a node's resting state is what the paused editor canvas paints, so a
-     * chart that only appeared once a command had run would edit blind. {@link
-     * ChartLine.enter} drives it from 0 regardless of where it rests, so the
-     * animation is unchanged.
-     */
-    progress: number;
-    /**
-     * Whether this line is drawn at all. `false` hides it outright — the switch
-     * the chart flips alongside its legend's per-series toggle.
-     */
-    enabled: boolean;
-    /**
-     * A slice of the plot to spotlight, in this node's own pixel space. When set
-     * to a real box, the stretches of the line *outside* it drop to
-     * {@link ChartLineProps.dimOpacity} while the stretches inside stay full.
-     */
-    spotlight: RegionBox;
-    /** Opacity the out-of-region stretches fade to. */
-    dimOpacity: number;
-}
 /**
  * A single series line of a {@link LineChart}: one rounded polyline traced
  * through pre-mapped pixel `points`, drawn as one {@link Graphics2D} command list.
  * Sized and positioned by the parent, which shares the plot's coordinate frame.
  *
- * Two signals drive it: {@link ChartLineProps.progress} traces the line in
+ * Two signals drive it: `progress` traces the line in
  * (animated by `enter`) and `enabled` shows or hides it wholesale.
  */
 export declare const ChartLine: import("@motionscript/sdk").Component<"chartLine", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** The series polyline, already mapped into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x. */
     readonly points: import("@motionscript/sdk").Type<Vector2[], Vector2[], false>;
+    /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */
     readonly stroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    /**
+     * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left
+     * end to its right. Defaults to 1, so the paused editor canvas paints the line;
+     * `enter` drives it from 0 regardless of where it rests.
+     */
     readonly progress: 1;
+    /** Whether this line is drawn at all: the switch the chart flips alongside its legend's per-series toggle. */
     readonly enabled: true;
+    /** A slice of the plot to spotlight, in this node's own pixel space: outside it the line drops to `dimOpacity`. */
     readonly spotlight: import("@motionscript/sdk").Type<RegionBox, RegionBox, false>;
+    /** Opacity the out-of-region stretches fade to. */
     readonly dimOpacity: 0.2;
 }>, {
     readonly enter: {
         readonly from: import("@motionscript/sdk").Type<number, number, false>;
         readonly to: import("@motionscript/sdk").Type<number, number, false>;
     };
-}, null, _Node2D<Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+}, null, _Node2D<import("@motionscript/core").Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** The series polyline, already mapped into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x. */
     readonly points: import("@motionscript/sdk").Type<Vector2[], Vector2[], false>;
+    /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */
     readonly stroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    /**
+     * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left
+     * end to its right. Defaults to 1, so the paused editor canvas paints the line;
+     * `enter` drives it from 0 regardless of where it rests.
+     */
+    readonly progress: 1;
+    /** Whether this line is drawn at all: the switch the chart flips alongside its legend's per-series toggle. */
+    readonly enabled: true;
+    /** A slice of the plot to spotlight, in this node's own pixel space: outside it the line drops to `dimOpacity`. */
+    readonly spotlight: import("@motionscript/sdk").Type<RegionBox, RegionBox, false>;
+    /** Opacity the out-of-region stretches fade to. */
+    readonly dimOpacity: 0.2;
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** The series polyline, already mapped into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x. */
+    readonly points: import("@motionscript/sdk").Type<Vector2[], Vector2[], false>;
+    /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */
+    readonly stroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    /**
+     * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left
+     * end to its right. Defaults to 1, so the paused editor canvas paints the line;
+     * `enter` drives it from 0 regardless of where it rests.
+     */
     readonly progress: 1;
+    /** Whether this line is drawn at all: the switch the chart flips alongside its legend's per-series toggle. */
     readonly enabled: true;
+    /** A slice of the plot to spotlight, in this node's own pixel space: outside it the line drops to `dimOpacity`. */
     readonly spotlight: import("@motionscript/sdk").Type<RegionBox, RegionBox, false>;
+    /** Opacity the out-of-region stretches fade to. */
     readonly dimOpacity: 0.2;
-}>, null>>;
+}>, {
+    readonly enter: {
+        readonly from: import("@motionscript/sdk").Type<number, number, false>;
+        readonly to: import("@motionscript/sdk").Type<number, number, false>;
+    };
+}, _Node2D<import("@motionscript/core").Node2DProps>>>>;
 export type ChartLine = NodeOf<typeof ChartLine>;
 //# sourceMappingURL=chart-line.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chart-line.d.ts","sourceRoot":"","sources":["../../src/line-chart/chart-line.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,MAAM,EAEX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,OAAO,EACb,MAAM,mBAAmB,CAAA;AAM1B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD;;;OAGG;IACH,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,SAAS,EAAE,SAAS,CAAA;IACpB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAA;CACnB;AAuCD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;UA0EpB,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"chart-line.d.ts","sourceRoot":"","sources":["../../src/line-chart/chart-line.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,MAAM,EAEX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,OAAO,EACb,MAAM,mBAAmB,CAAA;AAM1B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,UAAU,CAAA;AAuCjB;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;IAGlB,wJAAwJ;;IAExJ,+EAA+E;;IAE/E;;;;OAIG;;IAEH,8GAA8G;;IAE9G,mHAAmH;;IAEnH,mDAAmD;;;;;;;;IAdnD,wJAAwJ;;IAExJ,+EAA+E;;IAE/E;;;;OAIG;;IAEH,8GAA8G;;IAE9G,mHAAmH;;IAEnH,mDAAmD;;;IAdnD,wJAAwJ;;IAExJ,+EAA+E;;IAE/E;;;;OAIG;;IAEH,8GAA8G;;IAE9G,mHAAmH;;IAEnH,mDAAmD;;;;;;;uDAmErD,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAA"}

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

@@ -47,17 +47,27 @@ function tracePoints(pts, p) {
  * through pre-mapped pixel `points`, drawn as one {@link Graphics2D} command list.
  * Sized and positioned by the parent, which shares the plot's coordinate frame.
  *
- * Two signals drive it: {@link ChartLineProps.progress} traces the line in
+ * Two signals drive it: `progress` traces the line in
  * (animated by `enter`) and `enabled` shows or hides it wholesale.
  */
 export const ChartLine = component2d({
     key: "chartLine",
     state: {
+        /** The series polyline, already mapped into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x. */
         points: fresh(() => []),
+        /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */
         stroke: Types.custom([], { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),
+        /**
+         * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left
+         * end to its right. Defaults to 1, so the paused editor canvas paints the line;
+         * `enter` drives it from 0 regardless of where it rests.
+         */
         progress: 1,
+        /** Whether this line is drawn at all: the switch the chart flips alongside its legend's per-series toggle. */
         enabled: true,
+        /** A slice of the plot to spotlight, in this node's own pixel space: outside it the line drops to `dimOpacity`. */
         spotlight: fresh(() => EMPTY_REGION_BOX),
+        /** Opacity the out-of-region stretches fade to. */
         dimOpacity: SPOTLIGHT_DIM,
     },
     load: (loader, state) => loadPaints(loader, { strokes: [state.stroke] }),

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

@@ -1 +1 @@
-{"version":3,"file":"chart-line.js","sourceRoot":"","sources":["../../src/line-chart/chart-line.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Graphics2D,\r\n  Types,\r\n  component2d,\r\n  strokeOps,\r\n  type NodeOf,\r\n  // Named so this component's emitted type reaches `Node2D` through the sdk, not core.\r\n  type Node2D as _Node2D,\r\n  type Node2DProps,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n  type Vector2,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { fresh } from \"../kit/entries\"\r\nimport { frameEase } from \"../kit/motion\"\r\nimport { loadPaints } from \"../kit/paints\"\r\nimport { SPOTLIGHT_DIM } from \"../kit/shared\"\r\nimport {\r\n  EMPTY_REGION_BOX,\r\n  clipPolylineToBox,\r\n  hasRegion,\r\n  type RegionBox,\r\n} from \"./shared\"\r\n\r\nexport interface ChartLineProps extends Node2DProps {\r\n  /**\r\n   * The series polyline, already mapped into this node's local pixel space\r\n   * (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x.\r\n   */\r\n  points: Vector2[]\r\n  /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */\r\n  stroke: Stroke\r\n  /**\r\n   * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left\r\n   * end to its right.\r\n   *\r\n   * Defaults to **1**, unlike the standalone chart this was ported from: in an\r\n   * editor a node's resting state is what the paused editor canvas paints, so a\r\n   * chart that only appeared once a command had run would edit blind. {@link\r\n   * ChartLine.enter} drives it from 0 regardless of where it rests, so the\r\n   * animation is unchanged.\r\n   */\r\n  progress: number\r\n  /**\r\n   * Whether this line is drawn at all. `false` hides it outright — the switch\r\n   * the chart flips alongside its legend's per-series toggle.\r\n   */\r\n  enabled: boolean\r\n  /**\r\n   * A slice of the plot to spotlight, in this node's own pixel space. When set\r\n   * to a real box, the stretches of the line *outside* it drop to\r\n   * {@link ChartLineProps.dimOpacity} while the stretches inside stay full.\r\n   */\r\n  spotlight: RegionBox\r\n  /** Opacity the out-of-region stretches fade to. */\r\n  dimOpacity: number\r\n}\r\n\r\n/**\r\n * The prefix of `pts` revealed at fraction `p ∈ [0, 1]`, measuring the reveal\r\n * by *cumulative arc length* so the line traces at a steady pace regardless of\r\n * uneven point spacing. Returns the whole-point prefix plus one interpolated\r\n * point partway along the active segment.\r\n */\r\nfunction tracePoints(pts: Vector2[], p: number): Vector2[] {\r\n  if (p >= 1 || pts.length < 2) return pts\r\n  if (p <= 0) return []\r\n\r\n  const segLen: number[] = []\r\n  let total = 0\r\n  for (let i = 1; i < pts.length; i++) {\r\n    const d = Math.hypot(pts[i].x - pts[i - 1].x, pts[i].y - pts[i - 1].y)\r\n    segLen.push(d)\r\n    total += d\r\n  }\r\n  if (total === 0) return pts\r\n\r\n  let target = total * p\r\n  const out: Vector2[] = [pts[0]]\r\n  for (let i = 0; i < segLen.length; i++) {\r\n    if (target >= segLen[i]) {\r\n      out.push(pts[i + 1])\r\n      target -= segLen[i]\r\n    } else {\r\n      const t = segLen[i] === 0 ? 0 : target / segLen[i]\r\n      out.push({\r\n        x: pts[i].x + (pts[i + 1].x - pts[i].x) * t,\r\n        y: pts[i].y + (pts[i + 1].y - pts[i].y) * t,\r\n      })\r\n      break\r\n    }\r\n  }\r\n  return out\r\n}\r\n\r\n/**\r\n * A single series line of a {@link LineChart}: one rounded polyline traced\r\n * through pre-mapped pixel `points`, drawn as one {@link Graphics2D} command list.\r\n * Sized and positioned by the parent, which shares the plot's coordinate frame.\r\n *\r\n * Two signals drive it: {@link ChartLineProps.progress} traces the line in\r\n * (animated by `enter`) and `enabled` shows or hides it wholesale.\r\n */\r\nexport const ChartLine = component2d({\r\n  key: \"chartLine\",\r\n  state: {\r\n    points: fresh<Vector2[]>(() => []),\r\n    stroke: Types.custom<Stroke, StrokeResolved[]>([], { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),\r\n    progress: 1,\r\n    enabled: true,\r\n    spotlight: fresh<RegionBox>(() => EMPTY_REGION_BOX),\r\n    dimOpacity: SPOTLIGHT_DIM,\r\n  },\r\n  load: (loader, state) => loadPaints(loader, { strokes: [state.stroke] }),\r\n  commands: {\r\n    /**\r\n     * Trace the line from `from` to `to` over the command — by default in from\r\n     * its left end to its right. `showSeries` and `hideSeries` are the same\r\n     * motion in opposite directions, so both are this with their ends stated.\r\n     *\r\n     * `enabled` rides along in the same value rather than being set before or\r\n     * after the command: a line is drawable for every `t` the trace covers and\r\n     * undrawn outside it, which is what makes arriving at a time backwards show\r\n     * what arriving forwards does.\r\n     */\r\n    enter: {\r\n      args: { from: Types.number(0, { min: 0, max: 1 }), to: Types.number(1, { min: 0, max: 1 }) },\r\n      run: (timeline) => {\r\n        const { from, to } = timeline.args\r\n        const ease = frameEase(timeline)\r\n        return timeline.animate((t) => {\r\n          const progress = from + (to - from) * ease(t)\r\n          // Hidden only once it has fully retraced, so the last frame of a hide is\r\n          // the empty plot rather than a line that vanished a frame early.\r\n          return { progress, enabled: progress > 0 }\r\n        })\r\n      },\r\n    },\r\n  },\r\n  render: (ctx, state) => {\r\n    if (!state.enabled) return\r\n    const pts = state.points\r\n    if (pts.length < 2) return\r\n\r\n    const p = Math.max(0, Math.min(1, state.progress))\r\n    if (p <= 0) return\r\n\r\n    const drawn = tracePoints(pts, p)\r\n    if (drawn.length < 2) return\r\n    const stroke = state.stroke\r\n    const radius = (stroke[0]?.weight ?? 0) * 2 // round the joins\r\n\r\n    const box = state.spotlight\r\n    if (!hasRegion(box)) {\r\n      ctx.draw(new Graphics2D().line({ points: drawn, radius }).stroke(stroke))\r\n      return\r\n    }\r\n\r\n    // Spotlit: the whole line goes down to `dimOpacity`, then the stretches\r\n    // inside the region are re-drawn over it at full strength. Two passes rather\r\n    // than one dim + one bright *complementary* pair, so the bright run has\r\n    // continuous geometry through the region and its joins round the way an\r\n    // unspotlit line's do — and so the boundary lands exactly on the region edge.\r\n    ctx.draw(\r\n      new Graphics2D()\r\n        .line({ points: drawn, radius })\r\n        .stroke(stroke)\r\n        .opacity(Math.max(0, Math.min(1, state.dimOpacity)))\r\n    )\r\n\r\n    // One `draw` per run: shapes chained before a `stroke()` are combined into a\r\n    // single surface, and stroking a union of disjoint open paths doesn't paint\r\n    // — so a line that leaves the region and comes back would lose both halves.\r\n    for (const run of clipPolylineToBox(drawn, box)) {\r\n      ctx.draw(new Graphics2D().line({ points: run, radius }).stroke(stroke))\r\n    }\r\n  },\r\n})\r\n\r\nexport type ChartLine = NodeOf<typeof ChartLine>\r\n"]}
+{"version":3,"file":"chart-line.js","sourceRoot":"","sources":["../../src/line-chart/chart-line.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Graphics2D,\r\n  Types,\r\n  component2d,\r\n  strokeOps,\r\n  type NodeOf,\r\n  // Named so this component's emitted type reaches `Node2D` through the sdk, not core.\r\n  type Node2D as _Node2D,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n  type Vector2,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { fresh } from \"../kit/entries\"\r\nimport { frameEase } from \"../kit/motion\"\r\nimport { loadPaints } from \"../kit/paints\"\r\nimport { SPOTLIGHT_DIM } from \"../kit/shared\"\r\nimport {\r\n  EMPTY_REGION_BOX,\r\n  clipPolylineToBox,\r\n  hasRegion,\r\n  type RegionBox,\r\n} from \"./shared\"\r\n\r\n/**\r\n * The prefix of `pts` revealed at fraction `p ∈ [0, 1]`, measuring the reveal\r\n * by *cumulative arc length* so the line traces at a steady pace regardless of\r\n * uneven point spacing. Returns the whole-point prefix plus one interpolated\r\n * point partway along the active segment.\r\n */\r\nfunction tracePoints(pts: Vector2[], p: number): Vector2[] {\r\n  if (p >= 1 || pts.length < 2) return pts\r\n  if (p <= 0) return []\r\n\r\n  const segLen: number[] = []\r\n  let total = 0\r\n  for (let i = 1; i < pts.length; i++) {\r\n    const d = Math.hypot(pts[i].x - pts[i - 1].x, pts[i].y - pts[i - 1].y)\r\n    segLen.push(d)\r\n    total += d\r\n  }\r\n  if (total === 0) return pts\r\n\r\n  let target = total * p\r\n  const out: Vector2[] = [pts[0]]\r\n  for (let i = 0; i < segLen.length; i++) {\r\n    if (target >= segLen[i]) {\r\n      out.push(pts[i + 1])\r\n      target -= segLen[i]\r\n    } else {\r\n      const t = segLen[i] === 0 ? 0 : target / segLen[i]\r\n      out.push({\r\n        x: pts[i].x + (pts[i + 1].x - pts[i].x) * t,\r\n        y: pts[i].y + (pts[i + 1].y - pts[i].y) * t,\r\n      })\r\n      break\r\n    }\r\n  }\r\n  return out\r\n}\r\n\r\n/**\r\n * A single series line of a {@link LineChart}: one rounded polyline traced\r\n * through pre-mapped pixel `points`, drawn as one {@link Graphics2D} command list.\r\n * Sized and positioned by the parent, which shares the plot's coordinate frame.\r\n *\r\n * Two signals drive it: `progress` traces the line in\r\n * (animated by `enter`) and `enabled` shows or hides it wholesale.\r\n */\r\nexport const ChartLine = component2d({\r\n  key: \"chartLine\",\r\n  state: {\r\n    /** The series polyline, already mapped into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x. */\r\n    points: fresh<Vector2[]>(() => []),\r\n    /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */\r\n    stroke: Types.custom<Stroke, StrokeResolved[]>([], { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),\r\n    /**\r\n     * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left\r\n     * end to its right. Defaults to 1, so the paused editor canvas paints the line;\r\n     * `enter` drives it from 0 regardless of where it rests.\r\n     */\r\n    progress: 1,\r\n    /** Whether this line is drawn at all: the switch the chart flips alongside its legend's per-series toggle. */\r\n    enabled: true,\r\n    /** A slice of the plot to spotlight, in this node's own pixel space: outside it the line drops to `dimOpacity`. */\r\n    spotlight: fresh<RegionBox>(() => EMPTY_REGION_BOX),\r\n    /** Opacity the out-of-region stretches fade to. */\r\n    dimOpacity: SPOTLIGHT_DIM,\r\n  },\r\n  load: (loader, state) => loadPaints(loader, { strokes: [state.stroke] }),\r\n  commands: {\r\n    /**\r\n     * Trace the line from `from` to `to` over the command — by default in from\r\n     * its left end to its right. `showSeries` and `hideSeries` are the same\r\n     * motion in opposite directions, so both are this with their ends stated.\r\n     *\r\n     * `enabled` rides along in the same value rather than being set before or\r\n     * after the command: a line is drawable for every `t` the trace covers and\r\n     * undrawn outside it, which is what makes arriving at a time backwards show\r\n     * what arriving forwards does.\r\n     */\r\n    enter: {\r\n      args: { from: Types.number(0, { min: 0, max: 1 }), to: Types.number(1, { min: 0, max: 1 }) },\r\n      run: (timeline) => {\r\n        const { from, to } = timeline.args\r\n        const ease = frameEase(timeline)\r\n        return timeline.animate((t) => {\r\n          const progress = from + (to - from) * ease(t)\r\n          // Hidden only once it has fully retraced, so the last frame of a hide is\r\n          // the empty plot rather than a line that vanished a frame early.\r\n          return { progress, enabled: progress > 0 }\r\n        })\r\n      },\r\n    },\r\n  },\r\n  render: (ctx, state) => {\r\n    if (!state.enabled) return\r\n    const pts = state.points\r\n    if (pts.length < 2) return\r\n\r\n    const p = Math.max(0, Math.min(1, state.progress))\r\n    if (p <= 0) return\r\n\r\n    const drawn = tracePoints(pts, p)\r\n    if (drawn.length < 2) return\r\n    const stroke = state.stroke\r\n    const radius = (stroke[0]?.weight ?? 0) * 2 // round the joins\r\n\r\n    const box = state.spotlight\r\n    if (!hasRegion(box)) {\r\n      ctx.draw(new Graphics2D().line({ points: drawn, radius }).stroke(stroke))\r\n      return\r\n    }\r\n\r\n    // Spotlit: the whole line goes down to `dimOpacity`, then the stretches\r\n    // inside the region are re-drawn over it at full strength. Two passes rather\r\n    // than one dim + one bright *complementary* pair, so the bright run has\r\n    // continuous geometry through the region and its joins round the way an\r\n    // unspotlit line's do — and so the boundary lands exactly on the region edge.\r\n    ctx.draw(\r\n      new Graphics2D()\r\n        .line({ points: drawn, radius })\r\n        .stroke(stroke)\r\n        .opacity(Math.max(0, Math.min(1, state.dimOpacity)))\r\n    )\r\n\r\n    // One `draw` per run: shapes chained before a `stroke()` are combined into a\r\n    // single surface, and stroking a union of disjoint open paths doesn't paint\r\n    // — so a line that leaves the region and comes back would lose both halves.\r\n    for (const run of clipPolylineToBox(drawn, box)) {\r\n      ctx.draw(new Graphics2D().line({ points: run, radius }).stroke(stroke))\r\n    }\r\n  },\r\n})\r\n\r\nexport type ChartLine = NodeOf<typeof ChartLine>\r\n"]}

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

@@ -1,27 +1,9 @@
-import { type Fill, type FillResolved, type NodeOf, type Node2D as _Node2D, type Node2DProps, type Stroke, type StrokeResolved } from "@motionscript/sdk";
+import { type Fill, type FillResolved, type NodeOf, type Node2D as _Node2D, type Stroke, type StrokeResolved } from "@motionscript/sdk";
 import { type RegionBox } from "./shared.js";
-export interface ChartRegionProps extends Node2DProps {
-    /**
-     * The highlighted slice, already resolved into this node's local pixel space
-     * (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box
-     * draws nothing.
-     */
-    box: RegionBox;
-    /** Dashed rule marking each *bounded* edge of the box. */
-    stroke: Stroke;
-    /** Wash filling the box, under the series lines. */
-    fill: Fill;
-    /**
-     * Reveal of the annotation in `[0, 1]`: 0 hides it, 1 draws it fully. Driven
-     * by the chart's own `regionReveal`, so the rules and the series' dimming move
-     * as one.
-     */
-    reveal: number;
-}
 /**
  * The **region call-out** of a {@link LineChart}: a washed rectangle over the
  * plot with a dashed rule down each edge the author actually bounded. Sized and
- * positioned entirely from the pre-mapped {@link ChartRegionProps.box} rather
+ * positioned entirely from the pre-mapped `box` rather
  * than its own box — the region already carries the plot geometry.
  *
  * It draws only the *marking*; fading the series outside the region is
@@ -33,15 +15,32 @@ export interface ChartRegionProps extends Node2DProps {
  * bound — drawing dashes there would assert a limit the author didn't set.
  */
 export declare const ChartRegion: import("@motionscript/sdk").Component<"chartRegion", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** The highlighted slice, already resolved into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box draws nothing. */
+    readonly box: import("@motionscript/sdk").Type<RegionBox, RegionBox, false>;
+    /** Dashed rule marking each *bounded* edge of the box. */
+    readonly stroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    /** Wash filling the box, under the series lines. */
+    readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+    /** Reveal of the annotation in `[0, 1]`, driven by the chart's own `regionReveal` so the rules and the series' dimming move as one. */
+    readonly reveal: 0;
+}>, {}, null, _Node2D<import("@motionscript/core").Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** The highlighted slice, already resolved into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box draws nothing. */
     readonly box: import("@motionscript/sdk").Type<RegionBox, RegionBox, false>;
+    /** Dashed rule marking each *bounded* edge of the box. */
     readonly stroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    /** Wash filling the box, under the series lines. */
     readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+    /** Reveal of the annotation in `[0, 1]`, driven by the chart's own `regionReveal` so the rules and the series' dimming move as one. */
     readonly reveal: 0;
-}>, {}, null, _Node2D<Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** The highlighted slice, already resolved into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box draws nothing. */
     readonly box: import("@motionscript/sdk").Type<RegionBox, RegionBox, false>;
+    /** Dashed rule marking each *bounded* edge of the box. */
     readonly stroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    /** Wash filling the box, under the series lines. */
     readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+    /** Reveal of the annotation in `[0, 1]`, driven by the chart's own `regionReveal` so the rules and the series' dimming move as one. */
     readonly reveal: 0;
-}>, null>>;
+}>, {}, _Node2D<import("@motionscript/core").Node2DProps>>>>;
 export type ChartRegion = NodeOf<typeof ChartRegion>;
 //# sourceMappingURL=chart-region.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chart-region.d.ts","sourceRoot":"","sources":["../../src/line-chart/chart-region.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,MAAM,EAEX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;OAIG;IACH,GAAG,EAAE,SAAS,CAAA;IACd,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,IAAI,EAAE,IAAI,CAAA;IACV;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;UA6CtB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA"}
+{"version":3,"file":"chart-region.d.ts","sourceRoot":"","sources":["../../src/line-chart/chart-region.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,MAAM,EAEX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,UAAU,CAAA;AAEjB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW;IAGpB,2KAA2K;;IAE3K,0DAA0D;;IAE1D,oDAAoD;;IAEpD,uIAAuI;;;IANvI,2KAA2K;;IAE3K,0DAA0D;;IAE1D,oDAAoD;;IAEpD,uIAAuI;;;IANvI,2KAA2K;;IAE3K,0DAA0D;;IAE1D,oDAAoD;;IAEpD,uIAAuI;;4DAwCzI,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAA"}

package/dist/line-chart/chart-region.js

@@ -5,7 +5,7 @@ import { DEFAULT_CHART_THEME, EMPTY_REGION_BOX, hasRegion, } from "./shared.js";
 /**
  * The **region call-out** of a {@link LineChart}: a washed rectangle over the
  * plot with a dashed rule down each edge the author actually bounded. Sized and
- * positioned entirely from the pre-mapped {@link ChartRegionProps.box} rather
+ * positioned entirely from the pre-mapped `box` rather
  * than its own box — the region already carries the plot geometry.
  *
  * It draws only the *marking*; fading the series outside the region is
@@ -19,9 +19,13 @@ import { DEFAULT_CHART_THEME, EMPTY_REGION_BOX, hasRegion, } from "./shared.js";
 export const ChartRegion = component2d({
     key: "chartRegion",
     state: {
+        /** The highlighted slice, already resolved into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box draws nothing. */
         box: fresh(() => EMPTY_REGION_BOX),
+        /** Dashed rule marking each *bounded* edge of the box. */
         stroke: Types.custom(DEFAULT_CHART_THEME.region.stroke, { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),
+        /** Wash filling the box, under the series lines. */
         fill: Types.custom(DEFAULT_CHART_THEME.region.fill, { resolve: fillOps.resolve, lerp: fillOps.lerp }),
+        /** Reveal of the annotation in `[0, 1]`, driven by the chart's own `regionReveal` so the rules and the series' dimming move as one. */
         reveal: 0,
     },
     load: (loader, state) => loadPaints(loader, { fills: [state.fill], strokes: [state.stroke] }),

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

@@ -1 +1 @@
-{"version":3,"file":"chart-region.js","sourceRoot":"","sources":["../../src/line-chart/chart-region.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Graphics2D,\r\n  Types,\r\n  component2d,\r\n  fillOps,\r\n  strokeOps,\r\n  type Fill,\r\n  type FillResolved,\r\n  type NodeOf,\r\n  // Named so this component's emitted type reaches `Node2D` through the sdk, not core.\r\n  type Node2D as _Node2D,\r\n  type Node2DProps,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { fresh } from \"../kit/entries\"\r\nimport { loadPaints } from \"../kit/paints\"\r\nimport {\r\n  DEFAULT_CHART_THEME,\r\n  EMPTY_REGION_BOX,\r\n  hasRegion,\r\n  type RegionBox,\r\n} from \"./shared\"\r\n\r\nexport interface ChartRegionProps extends Node2DProps {\r\n  /**\r\n   * The highlighted slice, already resolved into this node's local pixel space\r\n   * (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box\r\n   * draws nothing.\r\n   */\r\n  box: RegionBox\r\n  /** Dashed rule marking each *bounded* edge of the box. */\r\n  stroke: Stroke\r\n  /** Wash filling the box, under the series lines. */\r\n  fill: Fill\r\n  /**\r\n   * Reveal of the annotation in `[0, 1]`: 0 hides it, 1 draws it fully. Driven\r\n   * by the chart's own `regionReveal`, so the rules and the series' dimming move\r\n   * as one.\r\n   */\r\n  reveal: number\r\n}\r\n\r\n/**\r\n * The **region call-out** of a {@link LineChart}: a washed rectangle over the\r\n * plot with a dashed rule down each edge the author actually bounded. Sized and\r\n * positioned entirely from the pre-mapped {@link ChartRegionProps.box} rather\r\n * than its own box — the region already carries the plot geometry.\r\n *\r\n * It draws only the *marking*; fading the series outside the region is\r\n * {@link ChartLine}'s job (it clips its own polyline against the same box), so\r\n * the two can't disagree about where the boundary is.\r\n *\r\n * Only bounded edges get a rule: a region given just an `x` range spans the full\r\n * plot height, so its top and bottom edges are the plot's own border, not a data\r\n * bound — drawing dashes there would assert a limit the author didn't set.\r\n */\r\nexport const ChartRegion = component2d({\r\n  key: \"chartRegion\",\r\n  state: {\r\n    box: fresh<RegionBox>(() => EMPTY_REGION_BOX),\r\n    stroke: Types.custom<Stroke, StrokeResolved[]>(DEFAULT_CHART_THEME.region.stroke, { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),\r\n    fill: Types.custom<Fill, FillResolved[]>(DEFAULT_CHART_THEME.region.fill, { resolve: fillOps.resolve, lerp: fillOps.lerp }),\r\n    reveal: 0,\r\n  },\r\n  load: (loader, state) => loadPaints(loader, { fills: [state.fill], strokes: [state.stroke] }),\r\n  render: (ctx, state) => {\r\n    const box = state.box\r\n    if (!hasRegion(box)) return\r\n\r\n    const r = Math.max(0, Math.min(1, state.reveal))\r\n    if (r <= 0) return\r\n\r\n    const width = box.right - box.left\r\n    const height = box.top - box.bottom\r\n    const cx = (box.left + box.right) / 2\r\n    const cy = (box.bottom + box.top) / 2\r\n\r\n    // Wash first, so the rules sit over their own tint.\r\n    if (state.fill.length > 0) {\r\n      ctx.draw(new Graphics2D().rect({ x: cx, y: cy, width, height }).fill(state.fill).opacity(r))\r\n    }\r\n\r\n    // One rule per bounded edge, growing from the region's centre outward as\r\n    // `reveal` climbs — the same \"trace it in\" beat as the series lines.\r\n    if (state.stroke.length === 0) return\r\n\r\n    // One `draw` per rule rather than four line ops under a single paint:\r\n    // shapes chained before a `stroke()` are combined into one surface, and\r\n    // stroking a union of disjoint open paths doesn't paint.\r\n    const rule = (points: { x: number; y: number }[]) =>\r\n      ctx.draw(new Graphics2D().line({ points }).stroke(state.stroke).opacity(r))\r\n\r\n    if (box.xBounded) {\r\n      const half = (height / 2) * r\r\n      for (const x of [box.left, box.right]) rule([{ x, y: cy - half }, { x, y: cy + half }])\r\n    }\r\n    if (box.yBounded) {\r\n      const half = (width / 2) * r\r\n      for (const y of [box.bottom, box.top]) rule([{ x: cx - half, y }, { x: cx + half, y }])\r\n    }\r\n  },\r\n})\r\n\r\nexport type ChartRegion = NodeOf<typeof ChartRegion>\r\n"]}
+{"version":3,"file":"chart-region.js","sourceRoot":"","sources":["../../src/line-chart/chart-region.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Graphics2D,\r\n  Types,\r\n  component2d,\r\n  fillOps,\r\n  strokeOps,\r\n  type Fill,\r\n  type FillResolved,\r\n  type NodeOf,\r\n  // Named so this component's emitted type reaches `Node2D` through the sdk, not core.\r\n  type Node2D as _Node2D,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { fresh } from \"../kit/entries\"\r\nimport { loadPaints } from \"../kit/paints\"\r\nimport {\r\n  DEFAULT_CHART_THEME,\r\n  EMPTY_REGION_BOX,\r\n  hasRegion,\r\n  type RegionBox,\r\n} from \"./shared\"\r\n\r\n/**\r\n * The **region call-out** of a {@link LineChart}: a washed rectangle over the\r\n * plot with a dashed rule down each edge the author actually bounded. Sized and\r\n * positioned entirely from the pre-mapped `box` rather\r\n * than its own box — the region already carries the plot geometry.\r\n *\r\n * It draws only the *marking*; fading the series outside the region is\r\n * {@link ChartLine}'s job (it clips its own polyline against the same box), so\r\n * the two can't disagree about where the boundary is.\r\n *\r\n * Only bounded edges get a rule: a region given just an `x` range spans the full\r\n * plot height, so its top and bottom edges are the plot's own border, not a data\r\n * bound — drawing dashes there would assert a limit the author didn't set.\r\n */\r\nexport const ChartRegion = component2d({\r\n  key: \"chartRegion\",\r\n  state: {\r\n    /** The highlighted slice, already resolved into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box draws nothing. */\r\n    box: fresh<RegionBox>(() => EMPTY_REGION_BOX),\r\n    /** Dashed rule marking each *bounded* edge of the box. */\r\n    stroke: Types.custom<Stroke, StrokeResolved[]>(DEFAULT_CHART_THEME.region.stroke, { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),\r\n    /** Wash filling the box, under the series lines. */\r\n    fill: Types.custom<Fill, FillResolved[]>(DEFAULT_CHART_THEME.region.fill, { resolve: fillOps.resolve, lerp: fillOps.lerp }),\r\n    /** Reveal of the annotation in `[0, 1]`, driven by the chart's own `regionReveal` so the rules and the series' dimming move as one. */\r\n    reveal: 0,\r\n  },\r\n  load: (loader, state) => loadPaints(loader, { fills: [state.fill], strokes: [state.stroke] }),\r\n  render: (ctx, state) => {\r\n    const box = state.box\r\n    if (!hasRegion(box)) return\r\n\r\n    const r = Math.max(0, Math.min(1, state.reveal))\r\n    if (r <= 0) return\r\n\r\n    const width = box.right - box.left\r\n    const height = box.top - box.bottom\r\n    const cx = (box.left + box.right) / 2\r\n    const cy = (box.bottom + box.top) / 2\r\n\r\n    // Wash first, so the rules sit over their own tint.\r\n    if (state.fill.length > 0) {\r\n      ctx.draw(new Graphics2D().rect({ x: cx, y: cy, width, height }).fill(state.fill).opacity(r))\r\n    }\r\n\r\n    // One rule per bounded edge, growing from the region's centre outward as\r\n    // `reveal` climbs — the same \"trace it in\" beat as the series lines.\r\n    if (state.stroke.length === 0) return\r\n\r\n    // One `draw` per rule rather than four line ops under a single paint:\r\n    // shapes chained before a `stroke()` are combined into one surface, and\r\n    // stroking a union of disjoint open paths doesn't paint.\r\n    const rule = (points: { x: number; y: number }[]) =>\r\n      ctx.draw(new Graphics2D().line({ points }).stroke(state.stroke).opacity(r))\r\n\r\n    if (box.xBounded) {\r\n      const half = (height / 2) * r\r\n      for (const x of [box.left, box.right]) rule([{ x, y: cy - half }, { x, y: cy + half }])\r\n    }\r\n    if (box.yBounded) {\r\n      const half = (width / 2) * r\r\n      for (const y of [box.bottom, box.top]) rule([{ x: cx - half, y }, { x: cx + half, y }])\r\n    }\r\n  },\r\n})\r\n\r\nexport type ChartRegion = NodeOf<typeof ChartRegion>\r\n"]}

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

@@ -1,27 +1,6 @@
-import { type NodeOf, type Node2D, type Node2DProps } from "@motionscript/sdk";
+import { type NodeOf, type Node2D } from "@motionscript/sdk";
 import { type Arrival } from "../kit/motion.js";
 import { type AxisConfig, type Range } from "../kit/shared.js";
-export interface HorizontalAxisProps extends Node2DProps {
-    /** `[min, max]` of the horizontal scale the markers are positioned within. */
-    range: Range;
-    /** Tick values (in data units) to draw along the axis. */
-    markers: number[];
-    /**
-     * How each marker is captioned, one per entry of `markers` and in its order.
-     * Empty (the default), or short, captions a marker with its bare numeric
-     * reading; a chart whose x column names months or categories writes those.
-     */
-    captions: string[];
-    /** Marker/caption text style, grid stroke, and gutters — see {@link AxisConfig}. */
-    axis: AxisConfig;
-    /**
-     * Caption drawn centred in the gutter beneath the marker row. Empty string
-     * (the default) hides it.
-     */
-    label: string;
-}
-/** How a tick value is captioned — see {@link HorizontalAxisProps.captions}. */
-export type MarkerLabel = (value: number) => string;
 /**
  * The horizontal axis of a {@link LineChart}: a **row of {@link Text} nodes**,
  * one per marker value, running left-to-right. Pure layout — the mirror of the
@@ -32,16 +11,25 @@ export type MarkerLabel = (value: number) => string;
  * `2026-03` sits three months along, not three slots along. That is what keeps
  * it distinct from a bar chart's bottom axis, which centres a caption on each
  * slot and has no scale at all — the two only look alike. What the values are
- * captioned *as* is the chart's to decide; see {@link HorizontalAxisProps.captions}.
+ * captioned *as* is the chart's to decide, in `captions`.
  *
  * `enter` staggers the markers in **left-to-right**: each starts lifted a
  * little above its slot and transparent, then fades and slides down into place.
  */
 export declare const HorizontalAxis: import("@motionscript/sdk").Component<"horizontalAxis", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** `[min, max]` of the horizontal scale the markers are positioned within. */
     readonly range: import("@motionscript/sdk").Type<Range, Range, false>;
+    /** Tick values (in data units) to draw along the axis. */
     readonly markers: import("@motionscript/sdk").Type<number[], number[], false>;
+    /**
+     * How each marker is captioned, one per entry of `markers` and in its order.
+     * Empty (the default), or short, captions a marker with its bare numeric
+     * reading; a chart whose x column names months or categories writes those.
+     */
     readonly captions: import("@motionscript/sdk").Type<string[], string[], false>;
+    /** Marker/caption text style, grid stroke, and gutters — see {@link AxisConfig}. */
     readonly axis: import("@motionscript/sdk").Type<AxisConfig, AxisConfig, false>;
+    /** Caption drawn centred in the gutter beneath the marker row; empty (the default) hides it. */
     readonly label: "";
     readonly arrivals: import("@motionscript/sdk").Type<Readonly<Record<string, Arrival>>, Readonly<Record<string, Arrival>>, false>;
 }>, {
@@ -49,13 +37,43 @@ export declare const HorizontalAxis: import("@motionscript/sdk").Component<"hori
         readonly stagger: import("@motionscript/sdk").Type<number | undefined, number | undefined, false>;
         readonly slide: import("@motionscript/sdk").Type<number, number, false>;
     };
-}, null, Node2D<Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+}, null, Node2D<import("@motionscript/core").Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** `[min, max]` of the horizontal scale the markers are positioned within. */
     readonly range: import("@motionscript/sdk").Type<Range, Range, false>;
+    /** Tick values (in data units) to draw along the axis. */
     readonly markers: import("@motionscript/sdk").Type<number[], number[], false>;
+    /**
+     * How each marker is captioned, one per entry of `markers` and in its order.
+     * Empty (the default), or short, captions a marker with its bare numeric
+     * reading; a chart whose x column names months or categories writes those.
+     */
+    readonly captions: import("@motionscript/sdk").Type<string[], string[], false>;
+    /** Marker/caption text style, grid stroke, and gutters — see {@link AxisConfig}. */
+    readonly axis: import("@motionscript/sdk").Type<AxisConfig, AxisConfig, false>;
+    /** Caption drawn centred in the gutter beneath the marker row; empty (the default) hides it. */
+    readonly label: "";
+    readonly arrivals: import("@motionscript/sdk").Type<Readonly<Record<string, Arrival>>, Readonly<Record<string, Arrival>>, false>;
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** `[min, max]` of the horizontal scale the markers are positioned within. */
+    readonly range: import("@motionscript/sdk").Type<Range, Range, false>;
+    /** Tick values (in data units) to draw along the axis. */
+    readonly markers: import("@motionscript/sdk").Type<number[], number[], false>;
+    /**
+     * How each marker is captioned, one per entry of `markers` and in its order.
+     * Empty (the default), or short, captions a marker with its bare numeric
+     * reading; a chart whose x column names months or categories writes those.
+     */
     readonly captions: import("@motionscript/sdk").Type<string[], string[], false>;
+    /** Marker/caption text style, grid stroke, and gutters — see {@link AxisConfig}. */
     readonly axis: import("@motionscript/sdk").Type<AxisConfig, AxisConfig, false>;
+    /** Caption drawn centred in the gutter beneath the marker row; empty (the default) hides it. */
     readonly label: "";
     readonly arrivals: import("@motionscript/sdk").Type<Readonly<Record<string, Arrival>>, Readonly<Record<string, Arrival>>, false>;
-}>, null>>;
+}>, {
+    readonly enter: {
+        readonly stagger: import("@motionscript/sdk").Type<number | undefined, number | undefined, false>;
+        readonly slide: import("@motionscript/sdk").Type<number, number, false>;
+    };
+}, Node2D<import("@motionscript/core").Node2DProps>>>>;
 export type HorizontalAxis = NodeOf<typeof HorizontalAxis>;
 //# sourceMappingURL=horizontal-axis.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"horizontal-axis.d.ts","sourceRoot":"","sources":["../../src/line-chart/horizontal-axis.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAA8D,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,8EAA8E;IAC9E,KAAK,EAAE,KAAK,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oFAAoF;IACpF,IAAI,EAAE,UAAU,CAAC;IACjB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;UAoGzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"horizontal-axis.d.ts","sourceRoot":"","sources":["../../src/line-chart/horizontal-axis.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,MAAM,EACX,KAAK,MAAM,EACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAA8D,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc;IAGvB,8EAA8E;;IAE9E,0DAA0D;;IAE1D;;;;OAIG;;IAEH,oFAAoF;;IAEpF,gGAAgG;;;;;;;;;IAZhG,8EAA8E;;IAE9E,0DAA0D;;IAE1D;;;;OAIG;;IAEH,oFAAoF;;IAEpF,gGAAgG;;;;IAZhG,8EAA8E;;IAE9E,0DAA0D;;IAE1D;;;;OAIG;;IAEH,oFAAoF;;IAEpF,gGAAgG;;;;;;;;sDA8FlG,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC"}