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

package/dist/bar-chart/chart-bars.d.ts

@@ -1,5 +1,4 @@
-import { type AssetScope, Node2D, type Command, type CommandArgs, type Fill, type NodeConfig, type Node2DProps, type RenderContext2D, type Shadow, type Stroke, type TextStyle } from "@motionscript/sdk";
-import type { MarkerLabel } from "../kit/vertical-axis.js";
+import { type Fill, type FillResolved, type NodeOf, type Node2D as _Node2D, type Node2DProps, type Shadow, type ShadowResolved, type Stroke, type StrokeResolved, type TextStyle } from "@motionscript/sdk";
 /**
  * One drawn column, already mapped into the plot's **centred pixel space**
  * (origin at the plot centre, y-up) by the parent {@link BarChart}.
@@ -15,12 +14,18 @@ export interface BarGeometry {
     width: number;
     /** Pixel y of the column's base — the baseline when grouped, the running stack top when stacked. */
     from: number;
-    /** Pixel y of its far end, at full {@link ChartBars.growth}. */
+    /** Pixel y of its far end, at full {@link ChartBarsProps.growth}. */
     to: number;
     /** Whether the far end takes the theme's corner radius (the stack's cap). */
     round: boolean;
     /** The value this column plots, for the figure printed on it. */
     value: number;
+    /**
+     * The figure printed on it, written as the chart's value axis writes its
+     * ticks, so the two cannot disagree. Absent, the bare marker reading of
+     * {@link value}.
+     */
+    caption?: string;
 }
 export interface ChartBarsProps extends Node2DProps {
     /** This series' columns, one per row of the chart's data. */
@@ -79,71 +84,32 @@ export interface ChartBarsProps extends Node2DProps {
  * and ride the node's own opacity — which is why hiding the series takes its
  * figures with it for free.
  */
-export declare class ChartBars extends Node2D<ChartBarsProps> {
-    bars: BarGeometry[];
-    baseline: number;
-    fill: Fill;
-    barStroke: Stroke;
-    barShadow: Shadow;
-    cornerRadius: number;
-    growth: number;
-    dims: number[];
-    showValues: boolean;
-    valueStyle: TextStyle;
-    enabled: boolean;
-    /**
-     * How a column's figure is written down — the same seam the two axes carry,
-     * so a chart's value axis and the numbers printed on its bars can't end up
-     * saying `$1,200` in one place and `1200` in the other.
-     */
-    labelFor: MarkerLabel;
-    constructor(props?: NodeConfig<ChartBars, ChartBarsProps>);
-    /**
-     * How far column `i` is dimmed — the chart's category spotlight, and the
-     * series switch on top of it.
-     *
-     * The captions read this rather than being hidden by `renderSelf`'s guard:
-     * they are real child nodes, so a `return` in the draw pass would leave them
-     * on screen over a series that isn't there.
-     */
-    private dimAt;
-    /** The two ends of column `i` at the current {@link growth}. */
-    private endsAt;
-    /** The type size the figures are set at, guarding the autofit/unset cases. */
-    private get valueSize();
-    /**
-     * The figure printed on column `i`, or `""` where there is no room for it.
-     *
-     * Blanking the text rather than dropping the node keeps the caption list
-     * index-aligned with the columns, so a chart that rescales into more room
-     * simply starts printing again.
-     */
-    private captionAt;
-    /** Whether column `i`'s figure sits inside the column (a stacked segment) or past its end. */
-    private insideAt;
-    /** Where column `i`'s figure sits, in the node's centred y-up space. */
-    private captionY;
-    /**
-     * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the
-     * paint props it carries — see {@link declarePaints}. The column stroke and
-     * shadow are named past the conventional slots, so they are passed explicitly.
-     */
-    declareAssets(assets: AssetScope): void;
-    protected renderSelf(ctx: RenderContext2D): void;
-    /**
-     * Raise every column from the baseline by tweening {@link growth} `0 → 1`.
-     *
-     * The mirror of `ChartLine.enter`: same signature, same contract that the
-     * resting state is the finished one, so the chart arms this back to 0 before
-     * animating rather than the node hiding itself at construction.
-     */
-    enter(args: CommandArgs<Record<string, never>> & {
-        duration: number;
-    }): Command<ChartBarsGrowth>;
-}
-/** The one signal {@link ChartBars.enter} moves. */
-type ChartBarsGrowth = {
-    growth: number;
-};
-export {};
+export declare const ChartBars: import("@motionscript/sdk").Component<"chartBars", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly bars: import("@motionscript/sdk").Type<BarGeometry[], BarGeometry[], false>;
+    readonly baseline: 0;
+    readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+    readonly barStroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    readonly barShadow: import("@motionscript/sdk").Type<Shadow, ShadowResolved[], false>;
+    readonly cornerRadius: number;
+    readonly growth: 1;
+    readonly dims: import("@motionscript/sdk").Type<number[], number[], false>;
+    readonly showValues: false;
+    readonly valueStyle: import("@motionscript/sdk").Type<TextStyle, TextStyle, false>;
+    readonly enabled: true;
+}>, {
+    readonly enter: unknown;
+}, null, _Node2D<Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly bars: import("@motionscript/sdk").Type<BarGeometry[], BarGeometry[], false>;
+    readonly baseline: 0;
+    readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+    readonly barStroke: import("@motionscript/sdk").Type<Stroke, StrokeResolved[], false>;
+    readonly barShadow: import("@motionscript/sdk").Type<Shadow, ShadowResolved[], false>;
+    readonly cornerRadius: number;
+    readonly growth: 1;
+    readonly dims: import("@motionscript/sdk").Type<number[], number[], false>;
+    readonly showValues: false;
+    readonly valueStyle: import("@motionscript/sdk").Type<TextStyle, TextStyle, false>;
+    readonly enabled: true;
+}>, null>>;
+export type ChartBars = NodeOf<typeof ChartBars>;
 //# sourceMappingURL=chart-bars.d.ts.map

package/dist/bar-chart/chart-bars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-bars.d.ts","sourceRoot":"","sources":["../../src/bar-chart/chart-bars.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAEf,MAAM,EAQN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,MAAM,EAEX,KAAK,MAAM,EAEX,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAA;IACT,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,oGAAoG;IACpG,IAAI,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAA;IACV,6EAA6E;IAC7E,KAAK,EAAE,OAAO,CAAA;IACd,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;CACd;AASD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,6DAA6D;IAC7D,IAAI,EAAE,WAAW,EAAE,CAAA;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,mFAAmF;IACnF,IAAI,EAAE,IAAI,CAAA;IACV,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAA;IACnB,oCAAoC;IACpC,UAAU,EAAE,SAAS,CAAA;IACrB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAU,SAAQ,MAAM,CAAC,cAAc,CAAC;IACO,IAAI,EAAE,WAAW,EAAE,CAAA;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAM1C,IAAI,EAAE,IAAI,CAAA;IAMV,SAAS,EAAE,MAAM,CAAA;IAMjB,SAAS,EAAE,MAAM,CAAA;IAEjB,YAAY,EAAE,MAAM,CAAA;IACM,MAAM,EAAE,MAAM,CAAA;IACK,IAAI,EAAE,MAAM,EAAE,CAAA;IAC7B,UAAU,EAAE,OAAO,CAAA;IAEjD,UAAU,EAAE,SAAS,CAAA;IACQ,OAAO,EAAE,OAAO,CAAA;IAErD;;;;OAIG;IACH,QAAQ,EAAE,WAAW,CAAe;gBAExB,KAAK,CAAC,EAAE,UAAU,CAAC,SAAS,EAAE,cAAc,CAAC;IAoBzD;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK;IAKb,gEAAgE;IAChE,OAAO,CAAC,MAAM;IASd,8EAA8E;IAC9E,OAAO,KAAK,SAAS,GAGpB;IAED;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAcjB,8FAA8F;IAC9F,OAAO,CAAC,QAAQ;IAKhB,wEAAwE;IACxE,OAAO,CAAC,QAAQ;IAUhB;;;;OAIG;IACM,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAQhD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAsChD;;;;;;OAMG;IAEH,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAKjG;AAED,oDAAoD;AACpD,KAAK,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA"}
+{"version":3,"file":"chart-bars.d.ts","sourceRoot":"","sources":["../../src/bar-chart/chart-bars.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,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,EACnB,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAA;AAQ1B;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAA;IACT,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,oGAAoG;IACpG,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAA;IACV,6EAA6E;IAC7E,KAAK,EAAE,OAAO,CAAA;IACd,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AASD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,6DAA6D;IAC7D,IAAI,EAAE,WAAW,EAAE,CAAA;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,mFAAmF;IACnF,IAAI,EAAE,IAAI,CAAA;IACV,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAA;IACnB,oCAAoC;IACpC,UAAU,EAAE,SAAS,CAAA;IACrB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AA6ED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;UAwFpB,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAA"}

package/dist/bar-chart/chart-bars.js

@@ -1,19 +1,81 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { command, Graphics2D, Node2D, Text, easeOut, fillOps, shadowOps, strokeOps, property, textOps, } from "@motionscript/sdk";
+import { Graphics2D, Text, Types, component2d, fillOps, shadowOps, strokeOps, textOps, } from "@motionscript/sdk";
+import { fresh } from "../kit/entries.js";
+import { frameEase } from "../kit/motion.js";
+import { loadPaints } from "../kit/paints.js";
 import { clampUnit, formatMarker } from "../kit/shared.js";
 import { DEFAULT_BAR_CHART_THEME } from "./shared.js";
-import { declarePaints } from "@motionscript/sdk/component";
 /** Gap between a grouped column's end and the figure printed over it, in px. */
 const VALUE_GAP = 10;
 /** A segment shorter than this many multiples of the type size prints no figure. */
 const VALUE_FIT = 1.6;
 /** Fallback type size when the theme's value style leaves it unset or autofit. */
 const VALUE_SIZE = 24;
+/**
+ * How far column `i` is dimmed — the chart's category spotlight, and the series
+ * switch on top of it.
+ *
+ * The captions read this rather than being hidden by `render`'s guard: they are
+ * real child nodes, so a `return` in the draw would leave them on screen over a
+ * series that isn't there.
+ */
+function dimAt(s, index) {
+    if (!s.enabled)
+        return 0;
+    return clampUnit(s.dims[index] ?? 1);
+}
+/** The two ends of column `i` at the current growth. */
+function endsAt(s, index) {
+    const bar = s.bars[index];
+    if (!bar)
+        return null;
+    const g = clampUnit(s.growth);
+    return { base: s.baseline + (bar.from - s.baseline) * g, end: s.baseline + (bar.to - s.baseline) * g };
+}
+/** The type size the figures are set at, guarding the autofit/unset cases. */
+function valueSize(s) {
+    const size = s.valueStyle.fontSize;
+    return typeof size === "number" ? size : VALUE_SIZE;
+}
+/** Whether column `i`'s figure sits inside the column (a stacked segment) or past its end. */
+function insideAt(s, index) {
+    const bar = s.bars[index];
+    return bar !== undefined && Math.abs(bar.from - s.baseline) > 0.5;
+}
+/**
+ * The figure printed on column `i`, or `""` where there is no room for it.
+ *
+ * Blanking the text rather than dropping the node keeps the caption list
+ * index-aligned with the columns, so a chart that rescales into more room simply
+ * starts printing again.
+ */
+function captionAt(s, index) {
+    const bar = s.bars[index];
+    if (!bar || bar.value === 0)
+        return "";
+    // An interior segment prints inside itself, so it has to be tall enough to
+    // hold a line of type; a grouped column prints in the headroom above its end,
+    // where the only constraint is the plot's own top.
+    if (insideAt(s, index)) {
+        const ends = endsAt(s, index);
+        if (!ends)
+            return "";
+        if (Math.abs(ends.end - ends.base) < valueSize(s) * VALUE_FIT)
+            return "";
+    }
+    return bar.caption ?? formatMarker(bar.value);
+}
+/** Where column `i`'s figure sits, in the node's centred y-up space. */
+function captionY(s, index) {
+    const ends = endsAt(s, index);
+    if (!ends)
+        return 0;
+    if (insideAt(s, index))
+        return (ends.base + ends.end) / 2;
+    // Text is centred on its `y`, so clear the column's end by the gap plus half a
+    // line — on whichever side of the baseline the column actually reached.
+    const direction = ends.end >= ends.base ? 1 : -1;
+    return ends.end + direction * (VALUE_GAP + valueSize(s) / 2);
+}
 /**
  * One **series** of a {@link BarChart}, drawn as one command list: its column in
  * every category, plus the figures printed on them.
@@ -30,207 +92,91 @@ const VALUE_SIZE = 24;
  * and ride the node's own opacity — which is why hiding the series takes its
  * figures with it for free.
  */
-export class ChartBars extends Node2D {
-    /**
-     * How a column's figure is written down — the same seam the two axes carry,
-     * so a chart's value axis and the numbers printed on its bars can't end up
-     * saying `$1,200` in one place and `1200` in the other.
-     */
-    labelFor = formatMarker;
-    constructor(props) {
-        super(props);
-        // One caption per column, built once (the row count is fixed at
-        // construction, like an axis's marker count) and bound to the live geometry
-        // so it travels with its column as the chart grows, rescales or reflows.
-        if (!this.showValues)
-            return;
-        for (let i = 0; i < this.bars.length; i++) {
-            this.add(new Text({
-                ...textOps.styleProps(this.valueStyle),
-                text: () => this.captionAt(i),
-                x: () => this.bars[i]?.x ?? 0,
-                y: () => this.captionY(i),
-                opacity: () => this.dimAt(i),
-            }));
+export const ChartBars = component2d({
+    key: "chartBars",
+    state: {
+        bars: fresh(() => []),
+        baseline: 0,
+        fill: Types.custom([], { resolve: fillOps.resolve, lerp: fillOps.lerp }),
+        barStroke: Types.custom(DEFAULT_BAR_CHART_THEME.bar.stroke, { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),
+        barShadow: Types.custom(DEFAULT_BAR_CHART_THEME.bar.shadow, { resolve: shadowOps.resolve, lerp: shadowOps.lerp }),
+        cornerRadius: DEFAULT_BAR_CHART_THEME.bar.cornerRadius,
+        growth: 1,
+        dims: fresh(() => []),
+        showValues: false,
+        valueStyle: Types.custom(DEFAULT_BAR_CHART_THEME.valueStyle),
+        enabled: true,
+    },
+    // A plain node filled its parent; one made of its figures would hug them.
+    defaults: { width: "fill", height: "fill" },
+    // One caption per column, built once (the row count is fixed at construction,
+    // like an axis's marker count) and bound to the live geometry so it travels
+    // with its column as the chart grows, rescales or reflows.
+    children: (state) => {
+        if (!state.showValues)
+            return [];
+        return state.bars.map((_, i) => Text({
+            ...textOps.styleProps(state.valueStyle),
+            text: () => captionAt(state, i),
+            x: () => state.bars[i]?.x ?? 0,
+            y: () => captionY(state, i),
+            opacity: () => dimAt(state, i),
+        }));
+    },
+    // The column stroke and shadow are named past the conventional slots, so they are named here.
+    load: (loader, state) => loadPaints(loader, { fills: [state.fill], shadows: [state.barShadow], strokes: [state.barStroke] }),
+    commands: {
+        /**
+         * Raise every column from the baseline by tweening `growth` `0 → 1`.
+         *
+         * The mirror of `ChartLine.enter`: same contract that the resting state is
+         * the finished one, so the chart arms this back to 0 before animating rather
+         * than the node hiding itself at construction. No priming to 0 first: the
+         * value at `t` is a function of `t`, so a repeat call re-raises by definition.
+         */
+        enter: (timeline) => {
+            const ease = frameEase(timeline);
+            return timeline.animate((t) => ({ growth: ease(t) }));
+        },
+    },
+    render: (ctx, state) => {
+        if (state.enabled) {
+            for (let i = 0; i < state.bars.length; i++) {
+                const bar = state.bars[i];
+                const ends = endsAt(state, i);
+                if (!ends || bar.width <= 0)
+                    continue;
+                const height = Math.abs(ends.end - ends.base);
+                if (height <= 0)
+                    continue;
+                const radius = bar.round ? Math.min(state.cornerRadius, height) : 0;
+                // A column per `Graphics2D` rather than one list for the series: the
+                // category spotlight dims individual columns, and opacity is a property
+                // of the command list rather than of a shape within it.
+                const g = new Graphics2D();
+                const rect = g.rect({
+                    x: bar.x,
+                    y: (ends.base + ends.end) / 2,
+                    width: bar.width,
+                    height,
+                    // This node's space is y-up, but the renderer's corner-radius keys are
+                    // labelled in canvas y-down space — so a column reaching *up* rounds
+                    // through the `bottom*` keys, and one reaching down through the `top*`
+                    // ones. Only the far end rounds, which is what makes a stack read as a
+                    // single capped column.
+                    cornerRadius: radius > 0
+                        ? ends.end >= ends.base
+                            ? { bottomLeft: radius, bottomRight: radius, topLeft: 0, topRight: 0 }
+                            : { topLeft: radius, topRight: radius, bottomLeft: 0, bottomRight: 0 }
+                        : 0,
+                });
+                rect.shadow(state.barShadow);
+                rect.fill(state.fill);
+                rect.stroke(state.barStroke);
+                ctx.draw(g.opacity(dimAt(state, i)));
+            }
         }
-    }
-    /**
-     * How far column `i` is dimmed — the chart's category spotlight, and the
-     * series switch on top of it.
-     *
-     * The captions read this rather than being hidden by `renderSelf`'s guard:
-     * they are real child nodes, so a `return` in the draw pass would leave them
-     * on screen over a series that isn't there.
-     */
-    dimAt(index) {
-        if (!this.enabled)
-            return 0;
-        return clampUnit(this.dims[index] ?? 1);
-    }
-    /** The two ends of column `i` at the current {@link growth}. */
-    endsAt(index) {
-        const bar = this.bars[index];
-        if (!bar)
-            return null;
-        const g = clampUnit(this.growth);
-        const base = this.baseline + (bar.from - this.baseline) * g;
-        const end = this.baseline + (bar.to - this.baseline) * g;
-        return { base, end };
-    }
-    /** The type size the figures are set at, guarding the autofit/unset cases. */
-    get valueSize() {
-        const size = this.valueStyle.fontSize;
-        return typeof size === "number" ? size : VALUE_SIZE;
-    }
-    /**
-     * The figure printed on column `i`, or `""` where there is no room for it.
-     *
-     * Blanking the text rather than dropping the node keeps the caption list
-     * index-aligned with the columns, so a chart that rescales into more room
-     * simply starts printing again.
-     */
-    captionAt(index) {
-        const bar = this.bars[index];
-        if (!bar || bar.value === 0)
-            return "";
-        // An interior segment prints inside itself, so it has to be tall enough to
-        // hold a line of type; a grouped column prints in the headroom above its
-        // end, where the only constraint is the plot's own top.
-        if (this.insideAt(index)) {
-            const ends = this.endsAt(index);
-            if (!ends)
-                return "";
-            if (Math.abs(ends.end - ends.base) < this.valueSize * VALUE_FIT)
-                return "";
-        }
-        return this.labelFor(bar.value);
-    }
-    /** Whether column `i`'s figure sits inside the column (a stacked segment) or past its end. */
-    insideAt(index) {
-        const bar = this.bars[index];
-        return bar !== undefined && Math.abs(bar.from - this.baseline) > 0.5;
-    }
-    /** Where column `i`'s figure sits, in the node's centred y-up space. */
-    captionY(index) {
-        const ends = this.endsAt(index);
-        if (!ends)
-            return 0;
-        if (this.insideAt(index))
-            return (ends.base + ends.end) / 2;
-        // Text is centred on its `y`, so clear the column's end by the gap plus half
-        // a line — on whichever side of the baseline the column actually reached.
-        const direction = ends.end >= ends.base ? 1 : -1;
-        return ends.end + direction * (VALUE_GAP + this.valueSize / 2);
-    }
-    /**
-     * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the
-     * paint props it carries — see {@link declarePaints}. The column stroke and
-     * shadow are named past the conventional slots, so they are passed explicitly.
-     */
-    declareAssets(assets) {
-        super.declareAssets(assets);
-        declarePaints(this, assets, {
-            fills: this.barShadow.map((shadow) => shadow.fill),
-            strokes: [this.barStroke],
-        });
-    }
-    renderSelf(ctx) {
-        if (!this.enabled)
-            return;
-        for (let i = 0; i < this.bars.length; i++) {
-            const bar = this.bars[i];
-            const ends = this.endsAt(i);
-            if (!ends || bar.width <= 0)
-                continue;
-            const height = Math.abs(ends.end - ends.base);
-            if (height <= 0)
-                continue;
-            const radius = bar.round ? Math.min(this.cornerRadius, height) : 0;
-            // A column per `Graphics2D` rather than one list for the series: the
-            // category spotlight dims individual columns, and opacity is a property
-            // of the command list rather than of a shape within it.
-            const g = new Graphics2D();
-            const rect = g.rect({
-                x: bar.x,
-                y: (ends.base + ends.end) / 2,
-                width: bar.width,
-                height,
-                // This node's space is y-up, but the renderer's corner-radius keys are
-                // labelled in canvas y-down space — so a column reaching *up* rounds
-                // through the `bottom*` keys, and one reaching down through the `top*`
-                // ones. Only the far end rounds, which is what makes a stack read as a
-                // single capped column.
-                cornerRadius: radius > 0
-                    ? ends.end >= ends.base
-                        ? { bottomLeft: radius, bottomRight: radius, topLeft: 0, topRight: 0 }
-                        : { topLeft: radius, topRight: radius, bottomLeft: 0, bottomRight: 0 }
-                    : 0,
-            });
-            rect.shadow(this.barShadow);
-            rect.fill(this.fill);
-            rect.stroke(this.barStroke);
-            ctx.draw(g.opacity(this.dimAt(i)));
-        }
-    }
-    /**
-     * Raise every column from the baseline by tweening {@link growth} `0 → 1`.
-     *
-     * The mirror of `ChartLine.enter`: same signature, same contract that the
-     * resting state is the finished one, so the chart arms this back to 0 before
-     * animating rather than the node hiding itself at construction.
-     */
-    enter(args) {
-        // No priming to 0 first: the value at `t` is a function of `t`, so a repeat
-        // call re-raises by definition rather than by having reset something.
-        return this.command((t) => ({ growth: t }), args.duration, args.easing ?? easeOut());
-    }
-}
-__decorate([
-    property({ default: () => [] })
-], ChartBars.prototype, "bars", void 0);
-__decorate([
-    property({ default: 0 })
-], ChartBars.prototype, "baseline", void 0);
-__decorate([
-    property({
-        default: [],
-        mapper: fillOps.resolve,
-        tween: fillOps.lerp,
-    })
-], ChartBars.prototype, "fill", void 0);
-__decorate([
-    property({
-        default: DEFAULT_BAR_CHART_THEME.bar.stroke,
-        mapper: strokeOps.resolve,
-        tween: strokeOps.lerp,
-    })
-], ChartBars.prototype, "barStroke", void 0);
-__decorate([
-    property({
-        default: DEFAULT_BAR_CHART_THEME.bar.shadow,
-        mapper: shadowOps.resolve,
-        tween: shadowOps.lerp,
-    })
-], ChartBars.prototype, "barShadow", void 0);
-__decorate([
-    property({ default: DEFAULT_BAR_CHART_THEME.bar.cornerRadius })
-], ChartBars.prototype, "cornerRadius", void 0);
-__decorate([
-    property({ default: 1 })
-], ChartBars.prototype, "growth", void 0);
-__decorate([
-    property({ default: () => [] })
-], ChartBars.prototype, "dims", void 0);
-__decorate([
-    property({ default: false })
-], ChartBars.prototype, "showValues", void 0);
-__decorate([
-    property({ default: DEFAULT_BAR_CHART_THEME.valueStyle })
-], ChartBars.prototype, "valueStyle", void 0);
-__decorate([
-    property({ default: true })
-], ChartBars.prototype, "enabled", void 0);
-__decorate([
-    command()
-], ChartBars.prototype, "enter", null);
+        ctx.children();
+    },
+});
 //# sourceMappingURL=chart-bars.js.map

package/dist/bar-chart/chart-bars.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-bars.js","sourceRoot":"","sources":["../../src/bar-chart/chart-bars.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  command,\n  type AssetScope,\n  Graphics2D,\n  Node2D,\n  Text,\n  easeOut,\n  fillOps,\n  shadowOps,\n  strokeOps,\n  property,\n  textOps,\n  type Command,\n  type CommandArgs,\n  type Fill,\n  type NodeConfig,\n  type Node2DProps,\n  type RenderContext2D,\n  type Shadow,\n  type ShadowResolved,\n  type Stroke,\n  type StrokeResolved,\n  type TextStyle,\n} from \"@motionscript/sdk\"\n\nimport { clampUnit, formatMarker } from \"../kit/shared\"\nimport type { MarkerLabel } from \"../kit/vertical-axis\"\nimport { DEFAULT_BAR_CHART_THEME } from \"./shared\"\nimport { declarePaints } from \"@motionscript/sdk/component\"\n\n/**\n * One drawn column, already mapped into the plot's **centred pixel space**\n * (origin at the plot centre, y-up) by the parent {@link BarChart}.\n *\n * `from`/`to` are the two ends of the column rather than a base and a height,\n * for the same reason {@link BarSpan} is a span: it is the one shape that fits a\n * grouped bar, a stacked segment and a negative value without a special case.\n */\nexport interface BarGeometry {\n  /** Centre x of the column. */\n  x: number\n  /** Column width in px. */\n  width: number\n  /** Pixel y of the column's base — the baseline when grouped, the running stack top when stacked. */\n  from: number\n  /** Pixel y of its far end, at full {@link ChartBars.growth}. */\n  to: number\n  /** Whether the far end takes the theme's corner radius (the stack's cap). */\n  round: boolean\n  /** The value this column plots, for the figure printed on it. */\n  value: number\n}\n\n/** Gap between a grouped column's end and the figure printed over it, in px. */\nconst VALUE_GAP = 10\n/** A segment shorter than this many multiples of the type size prints no figure. */\nconst VALUE_FIT = 1.6\n/** Fallback type size when the theme's value style leaves it unset or autofit. */\nconst VALUE_SIZE = 24\n\nexport interface ChartBarsProps extends Node2DProps {\n  /** This series' columns, one per row of the chart's data. */\n  bars: BarGeometry[]\n  /** Pixel y of value 0 — where every column grows *from*. */\n  baseline: number\n  /** Column paint — this series' own, or the theme palette's entry for its index. */\n  fill: Fill\n  /** Optional outline on every column. */\n  barStroke: Stroke\n  /** Optional drop shadow on every column. */\n  barShadow: Shadow\n  /** Radius of the far-end corners, in px. */\n  cornerRadius: number\n  /**\n   * Rise of every column in `[0, 1]`, measured **about the baseline**: 0\n   * collapses them all onto it, 1 draws them at full length.\n   *\n   * Scaling about the baseline rather than about each column's own base is what\n   * keeps a stack flush mid-animation — every segment's base and end travel by\n   * the same factor, so the segments stay stacked instead of the upper ones\n   * floating above the still-growing lower ones. It also means a negative\n   * column grows *down* out of the same signal.\n   */\n  growth: number\n  /**\n   * Per-column opacity multiplier, by row index — how the chart's category\n   * spotlight reaches a single column without touching the series it belongs\n   * to. Missing entries read as 1.\n   */\n  dims: number[]\n  /** Whether the figure each column plots is printed on it. */\n  showValues: boolean\n  /** Type style for those figures. */\n  valueStyle: TextStyle\n  /**\n   * Whether this series draws at all — the wholesale switch behind\n   * `BarChart.showSeries`/`hideSeries`, alongside the slot weight that animates\n   * the reflow. Off skips the columns *and* their figures.\n   */\n  enabled: boolean\n}\n\n/**\n * One **series** of a {@link BarChart}, drawn as one command list: its column in\n * every category, plus the figures printed on them.\n *\n * A node per series rather than a node per bar, deliberately — it is the same\n * unit `ChartLine` is, which is what lets `showSeries`/`hideSeries`/\n * `spotlightSeries` mean exactly the same thing on a bar chart as on a line\n * chart: enable the node, or tween its opacity. The columns' *positions* come\n * from the parent (it owns the slot arithmetic both modes share), so this part\n * only has to know how to draw a span and grow it.\n *\n * The figures are real {@link Text} children rather than glyphs in the command\n * list, so they take the theme's type style, are measured by the layout engine,\n * and ride the node's own opacity — which is why hiding the series takes its\n * figures with it for free.\n */\nexport class ChartBars extends Node2D<ChartBarsProps> {\n  @property({ default: () => [] as BarGeometry[] }) declare bars: BarGeometry[]\n  @property({ default: 0 }) declare baseline: number\n  @property({\n    default: [],\n    mapper: fillOps.resolve,\n    tween: fillOps.lerp,\n  })\n  declare fill: Fill\n  @property({\n    default: DEFAULT_BAR_CHART_THEME.bar.stroke,\n    mapper: strokeOps.resolve,\n    tween: strokeOps.lerp,\n  })\n  declare barStroke: Stroke\n  @property({\n    default: DEFAULT_BAR_CHART_THEME.bar.shadow,\n    mapper: shadowOps.resolve,\n    tween: shadowOps.lerp,\n  })\n  declare barShadow: Shadow\n  @property({ default: DEFAULT_BAR_CHART_THEME.bar.cornerRadius })\n  declare cornerRadius: number\n  @property({ default: 1 }) declare growth: number\n  @property({ default: () => [] as number[] }) declare dims: number[]\n  @property({ default: false }) declare showValues: boolean\n  @property({ default: DEFAULT_BAR_CHART_THEME.valueStyle })\n  declare valueStyle: TextStyle\n  @property({ default: true }) declare enabled: boolean\n\n  /**\n   * How a column's figure is written down — the same seam the two axes carry,\n   * so a chart's value axis and the numbers printed on its bars can't end up\n   * saying `$1,200` in one place and `1200` in the other.\n   */\n  labelFor: MarkerLabel = formatMarker\n\n  constructor(props?: NodeConfig<ChartBars, ChartBarsProps>) {\n    super(props)\n\n    // One caption per column, built once (the row count is fixed at\n    // construction, like an axis's marker count) and bound to the live geometry\n    // so it travels with its column as the chart grows, rescales or reflows.\n    if (!this.showValues) return\n    for (let i = 0; i < this.bars.length; i++) {\n      this.add(\n        new Text({\n          ...textOps.styleProps(this.valueStyle),\n          text: () => this.captionAt(i),\n          x: () => this.bars[i]?.x ?? 0,\n          y: () => this.captionY(i),\n          opacity: () => this.dimAt(i),\n        })\n      )\n    }\n  }\n\n  /**\n   * How far column `i` is dimmed — the chart's category spotlight, and the\n   * series switch on top of it.\n   *\n   * The captions read this rather than being hidden by `renderSelf`'s guard:\n   * they are real child nodes, so a `return` in the draw pass would leave them\n   * on screen over a series that isn't there.\n   */\n  private dimAt(index: number): number {\n    if (!this.enabled) return 0\n    return clampUnit(this.dims[index] ?? 1)\n  }\n\n  /** The two ends of column `i` at the current {@link growth}. */\n  private endsAt(index: number): { base: number; end: number } | null {\n    const bar = this.bars[index]\n    if (!bar) return null\n    const g = clampUnit(this.growth)\n    const base = this.baseline + (bar.from - this.baseline) * g\n    const end = this.baseline + (bar.to - this.baseline) * g\n    return { base, end }\n  }\n\n  /** The type size the figures are set at, guarding the autofit/unset cases. */\n  private get valueSize(): number {\n    const size = this.valueStyle.fontSize\n    return typeof size === \"number\" ? size : VALUE_SIZE\n  }\n\n  /**\n   * The figure printed on column `i`, or `\"\"` where there is no room for it.\n   *\n   * Blanking the text rather than dropping the node keeps the caption list\n   * index-aligned with the columns, so a chart that rescales into more room\n   * simply starts printing again.\n   */\n  private captionAt(index: number): string {\n    const bar = this.bars[index]\n    if (!bar || bar.value === 0) return \"\"\n    // An interior segment prints inside itself, so it has to be tall enough to\n    // hold a line of type; a grouped column prints in the headroom above its\n    // end, where the only constraint is the plot's own top.\n    if (this.insideAt(index)) {\n      const ends = this.endsAt(index)\n      if (!ends) return \"\"\n      if (Math.abs(ends.end - ends.base) < this.valueSize * VALUE_FIT) return \"\"\n    }\n    return this.labelFor(bar.value)\n  }\n\n  /** Whether column `i`'s figure sits inside the column (a stacked segment) or past its end. */\n  private insideAt(index: number): boolean {\n    const bar = this.bars[index]\n    return bar !== undefined && Math.abs(bar.from - this.baseline) > 0.5\n  }\n\n  /** Where column `i`'s figure sits, in the node's centred y-up space. */\n  private captionY(index: number): number {\n    const ends = this.endsAt(index)\n    if (!ends) return 0\n    if (this.insideAt(index)) return (ends.base + ends.end) / 2\n    // Text is centred on its `y`, so clear the column's end by the gap plus half\n    // a line — on whichever side of the baseline the column actually reached.\n    const direction = ends.end >= ends.base ? 1 : -1\n    return ends.end + direction * (VALUE_GAP + this.valueSize / 2)\n  }\n\n  /**\n   * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the\n   * paint props it carries — see {@link declarePaints}. The column stroke and\n   * shadow are named past the conventional slots, so they are passed explicitly.\n   */\n  override declareAssets(assets: AssetScope): void {\n    super.declareAssets(assets)\n    declarePaints(this, assets, {\n      fills: (this.barShadow as ShadowResolved[]).map((shadow) => shadow.fill),\n      strokes: [this.barStroke as StrokeResolved[]],\n    })\n  }\n\n  protected renderSelf(ctx: RenderContext2D): void {\n    if (!this.enabled) return\n    for (let i = 0; i < this.bars.length; i++) {\n      const bar = this.bars[i]\n      const ends = this.endsAt(i)\n      if (!ends || bar.width <= 0) continue\n      const height = Math.abs(ends.end - ends.base)\n      if (height <= 0) continue\n\n      const radius = bar.round ? Math.min(this.cornerRadius, height) : 0\n      // A column per `Graphics2D` rather than one list for the series: the\n      // category spotlight dims individual columns, and opacity is a property\n      // of the command list rather than of a shape within it.\n      const g = new Graphics2D()\n      const rect = g.rect({\n        x: bar.x,\n        y: (ends.base + ends.end) / 2,\n        width: bar.width,\n        height,\n        // This node's space is y-up, but the renderer's corner-radius keys are\n        // labelled in canvas y-down space — so a column reaching *up* rounds\n        // through the `bottom*` keys, and one reaching down through the `top*`\n        // ones. Only the far end rounds, which is what makes a stack read as a\n        // single capped column.\n        cornerRadius:\n          radius > 0\n            ? ends.end >= ends.base\n              ? { bottomLeft: radius, bottomRight: radius, topLeft: 0, topRight: 0 }\n              : { topLeft: radius, topRight: radius, bottomLeft: 0, bottomRight: 0 }\n            : 0,\n      })\n      rect.shadow(this.barShadow)\n      rect.fill(this.fill)\n      rect.stroke(this.barStroke)\n      ctx.draw(g.opacity(this.dimAt(i)))\n    }\n  }\n\n  /**\n   * Raise every column from the baseline by tweening {@link growth} `0 → 1`.\n   *\n   * The mirror of `ChartLine.enter`: same signature, same contract that the\n   * resting state is the finished one, so the chart arms this back to 0 before\n   * animating rather than the node hiding itself at construction.\n   */\n  @command()\n  enter(args: CommandArgs<Record<string, never>> & { duration: number }): Command<ChartBarsGrowth> {\n    // No priming to 0 first: the value at `t` is a function of `t`, so a repeat\n    // call re-raises by definition rather than by having reset something.\n    return this.command<ChartBarsGrowth>((t) => ({ growth: t }), args.duration, args.easing ?? easeOut())\n  }\n}\n\n/** The one signal {@link ChartBars.enter} moves. */\ntype ChartBarsGrowth = { growth: number }\n"]}
+{"version":3,"file":"chart-bars.js","sourceRoot":"","sources":["../../src/bar-chart/chart-bars.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Graphics2D,\r\n  Text,\r\n  Types,\r\n  component2d,\r\n  fillOps,\r\n  shadowOps,\r\n  strokeOps,\r\n  textOps,\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 Shadow,\r\n  type ShadowResolved,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n  type TextStyle,\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 { clampUnit, formatMarker } from \"../kit/shared\"\r\nimport { DEFAULT_BAR_CHART_THEME } from \"./shared\"\r\n\r\n/**\r\n * One drawn column, already mapped into the plot's **centred pixel space**\r\n * (origin at the plot centre, y-up) by the parent {@link BarChart}.\r\n *\r\n * `from`/`to` are the two ends of the column rather than a base and a height,\r\n * for the same reason {@link BarSpan} is a span: it is the one shape that fits a\r\n * grouped bar, a stacked segment and a negative value without a special case.\r\n */\r\nexport interface BarGeometry {\r\n  /** Centre x of the column. */\r\n  x: number\r\n  /** Column width in px. */\r\n  width: number\r\n  /** Pixel y of the column's base — the baseline when grouped, the running stack top when stacked. */\r\n  from: number\r\n  /** Pixel y of its far end, at full {@link ChartBarsProps.growth}. */\r\n  to: number\r\n  /** Whether the far end takes the theme's corner radius (the stack's cap). */\r\n  round: boolean\r\n  /** The value this column plots, for the figure printed on it. */\r\n  value: number\r\n  /**\r\n   * The figure printed on it, written as the chart's value axis writes its\r\n   * ticks, so the two cannot disagree. Absent, the bare marker reading of\r\n   * {@link value}.\r\n   */\r\n  caption?: string\r\n}\r\n\r\n/** Gap between a grouped column's end and the figure printed over it, in px. */\r\nconst VALUE_GAP = 10\r\n/** A segment shorter than this many multiples of the type size prints no figure. */\r\nconst VALUE_FIT = 1.6\r\n/** Fallback type size when the theme's value style leaves it unset or autofit. */\r\nconst VALUE_SIZE = 24\r\n\r\nexport interface ChartBarsProps extends Node2DProps {\r\n  /** This series' columns, one per row of the chart's data. */\r\n  bars: BarGeometry[]\r\n  /** Pixel y of value 0 — where every column grows *from*. */\r\n  baseline: number\r\n  /** Column paint — this series' own, or the theme palette's entry for its index. */\r\n  fill: Fill\r\n  /** Optional outline on every column. */\r\n  barStroke: Stroke\r\n  /** Optional drop shadow on every column. */\r\n  barShadow: Shadow\r\n  /** Radius of the far-end corners, in px. */\r\n  cornerRadius: number\r\n  /**\r\n   * Rise of every column in `[0, 1]`, measured **about the baseline**: 0\r\n   * collapses them all onto it, 1 draws them at full length.\r\n   *\r\n   * Scaling about the baseline rather than about each column's own base is what\r\n   * keeps a stack flush mid-animation — every segment's base and end travel by\r\n   * the same factor, so the segments stay stacked instead of the upper ones\r\n   * floating above the still-growing lower ones. It also means a negative\r\n   * column grows *down* out of the same signal.\r\n   */\r\n  growth: number\r\n  /**\r\n   * Per-column opacity multiplier, by row index — how the chart's category\r\n   * spotlight reaches a single column without touching the series it belongs\r\n   * to. Missing entries read as 1.\r\n   */\r\n  dims: number[]\r\n  /** Whether the figure each column plots is printed on it. */\r\n  showValues: boolean\r\n  /** Type style for those figures. */\r\n  valueStyle: TextStyle\r\n  /**\r\n   * Whether this series draws at all — the wholesale switch behind\r\n   * `BarChart.showSeries`/`hideSeries`, alongside the slot weight that animates\r\n   * the reflow. Off skips the columns *and* their figures.\r\n   */\r\n  enabled: boolean\r\n}\r\n\r\n/** What the column geometry reads. */\r\ninterface Columns {\r\n  readonly bars: readonly BarGeometry[]\r\n  readonly baseline: number\r\n  readonly growth: number\r\n  readonly dims: readonly number[]\r\n  readonly enabled: boolean\r\n  readonly valueStyle: TextStyle\r\n}\r\n\r\n/**\r\n * How far column `i` is dimmed — the chart's category spotlight, and the series\r\n * switch on top of it.\r\n *\r\n * The captions read this rather than being hidden by `render`'s guard: they are\r\n * real child nodes, so a `return` in the draw would leave them on screen over a\r\n * series that isn't there.\r\n */\r\nfunction dimAt(s: Columns, index: number): number {\r\n  if (!s.enabled) return 0\r\n  return clampUnit(s.dims[index] ?? 1)\r\n}\r\n\r\n/** The two ends of column `i` at the current growth. */\r\nfunction endsAt(s: Columns, index: number): { base: number; end: number } | null {\r\n  const bar = s.bars[index]\r\n  if (!bar) return null\r\n  const g = clampUnit(s.growth)\r\n  return { base: s.baseline + (bar.from - s.baseline) * g, end: s.baseline + (bar.to - s.baseline) * g }\r\n}\r\n\r\n/** The type size the figures are set at, guarding the autofit/unset cases. */\r\nfunction valueSize(s: Columns): number {\r\n  const size = s.valueStyle.fontSize\r\n  return typeof size === \"number\" ? size : VALUE_SIZE\r\n}\r\n\r\n/** Whether column `i`'s figure sits inside the column (a stacked segment) or past its end. */\r\nfunction insideAt(s: Columns, index: number): boolean {\r\n  const bar = s.bars[index]\r\n  return bar !== undefined && Math.abs(bar.from - s.baseline) > 0.5\r\n}\r\n\r\n/**\r\n * The figure printed on column `i`, or `\"\"` where there is no room for it.\r\n *\r\n * Blanking the text rather than dropping the node keeps the caption list\r\n * index-aligned with the columns, so a chart that rescales into more room simply\r\n * starts printing again.\r\n */\r\nfunction captionAt(s: Columns, index: number): string {\r\n  const bar = s.bars[index]\r\n  if (!bar || bar.value === 0) return \"\"\r\n  // An interior segment prints inside itself, so it has to be tall enough to\r\n  // hold a line of type; a grouped column prints in the headroom above its end,\r\n  // where the only constraint is the plot's own top.\r\n  if (insideAt(s, index)) {\r\n    const ends = endsAt(s, index)\r\n    if (!ends) return \"\"\r\n    if (Math.abs(ends.end - ends.base) < valueSize(s) * VALUE_FIT) return \"\"\r\n  }\r\n  return bar.caption ?? formatMarker(bar.value)\r\n}\r\n\r\n/** Where column `i`'s figure sits, in the node's centred y-up space. */\r\nfunction captionY(s: Columns, index: number): number {\r\n  const ends = endsAt(s, index)\r\n  if (!ends) return 0\r\n  if (insideAt(s, index)) return (ends.base + ends.end) / 2\r\n  // Text is centred on its `y`, so clear the column's end by the gap plus half a\r\n  // line — on whichever side of the baseline the column actually reached.\r\n  const direction = ends.end >= ends.base ? 1 : -1\r\n  return ends.end + direction * (VALUE_GAP + valueSize(s) / 2)\r\n}\r\n\r\n/**\r\n * One **series** of a {@link BarChart}, drawn as one command list: its column in\r\n * every category, plus the figures printed on them.\r\n *\r\n * A node per series rather than a node per bar, deliberately — it is the same\r\n * unit `ChartLine` is, which is what lets `showSeries`/`hideSeries`/\r\n * `spotlightSeries` mean exactly the same thing on a bar chart as on a line\r\n * chart: enable the node, or tween its opacity. The columns' *positions* come\r\n * from the parent (it owns the slot arithmetic both modes share), so this part\r\n * only has to know how to draw a span and grow it.\r\n *\r\n * The figures are real {@link Text} children rather than glyphs in the command\r\n * list, so they take the theme's type style, are measured by the layout engine,\r\n * and ride the node's own opacity — which is why hiding the series takes its\r\n * figures with it for free.\r\n */\r\nexport const ChartBars = component2d({\r\n  key: \"chartBars\",\r\n  state: {\r\n    bars: fresh<BarGeometry[]>(() => []),\r\n    baseline: 0,\r\n    fill: Types.custom<Fill, FillResolved[]>([], { resolve: fillOps.resolve, lerp: fillOps.lerp }),\r\n    barStroke: Types.custom<Stroke, StrokeResolved[]>(DEFAULT_BAR_CHART_THEME.bar.stroke, { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),\r\n    barShadow: Types.custom<Shadow, ShadowResolved[]>(DEFAULT_BAR_CHART_THEME.bar.shadow, { resolve: shadowOps.resolve, lerp: shadowOps.lerp }),\r\n    cornerRadius: DEFAULT_BAR_CHART_THEME.bar.cornerRadius,\r\n    growth: 1,\r\n    dims: fresh<number[]>(() => []),\r\n    showValues: false,\r\n    valueStyle: Types.custom<TextStyle>(DEFAULT_BAR_CHART_THEME.valueStyle),\r\n    enabled: true,\r\n  },\r\n  // A plain node filled its parent; one made of its figures would hug them.\r\n  defaults: { width: \"fill\", height: \"fill\" },\r\n  // One caption per column, built once (the row count is fixed at construction,\r\n  // like an axis's marker count) and bound to the live geometry so it travels\r\n  // with its column as the chart grows, rescales or reflows.\r\n  children: (state) => {\r\n    if (!state.showValues) return []\r\n    return state.bars.map((_, i) =>\r\n      Text({\r\n        ...textOps.styleProps(state.valueStyle),\r\n        text: () => captionAt(state, i),\r\n        x: () => state.bars[i]?.x ?? 0,\r\n        y: () => captionY(state, i),\r\n        opacity: () => dimAt(state, i),\r\n      })\r\n    )\r\n  },\r\n  // The column stroke and shadow are named past the conventional slots, so they are named here.\r\n  load: (loader, state) =>\r\n    loadPaints(loader, { fills: [state.fill], shadows: [state.barShadow], strokes: [state.barStroke] }),\r\n  commands: {\r\n    /**\r\n     * Raise every column from the baseline by tweening `growth` `0 → 1`.\r\n     *\r\n     * The mirror of `ChartLine.enter`: same contract that the resting state is\r\n     * the finished one, so the chart arms this back to 0 before animating rather\r\n     * than the node hiding itself at construction. No priming to 0 first: the\r\n     * value at `t` is a function of `t`, so a repeat call re-raises by definition.\r\n     */\r\n    enter: (timeline) => {\r\n      const ease = frameEase(timeline)\r\n      return timeline.animate((t) => ({ growth: ease(t) }))\r\n    },\r\n  },\r\n  render: (ctx, state) => {\r\n    if (state.enabled) {\r\n      for (let i = 0; i < state.bars.length; i++) {\r\n        const bar = state.bars[i]\r\n        const ends = endsAt(state, i)\r\n        if (!ends || bar.width <= 0) continue\r\n        const height = Math.abs(ends.end - ends.base)\r\n        if (height <= 0) continue\r\n\r\n        const radius = bar.round ? Math.min(state.cornerRadius, height) : 0\r\n        // A column per `Graphics2D` rather than one list for the series: the\r\n        // category spotlight dims individual columns, and opacity is a property\r\n        // of the command list rather than of a shape within it.\r\n        const g = new Graphics2D()\r\n        const rect = g.rect({\r\n          x: bar.x,\r\n          y: (ends.base + ends.end) / 2,\r\n          width: bar.width,\r\n          height,\r\n          // This node's space is y-up, but the renderer's corner-radius keys are\r\n          // labelled in canvas y-down space — so a column reaching *up* rounds\r\n          // through the `bottom*` keys, and one reaching down through the `top*`\r\n          // ones. Only the far end rounds, which is what makes a stack read as a\r\n          // single capped column.\r\n          cornerRadius:\r\n            radius > 0\r\n              ? ends.end >= ends.base\r\n                ? { bottomLeft: radius, bottomRight: radius, topLeft: 0, topRight: 0 }\r\n                : { topLeft: radius, topRight: radius, bottomLeft: 0, bottomRight: 0 }\r\n              : 0,\r\n        })\r\n        rect.shadow(state.barShadow)\r\n        rect.fill(state.fill)\r\n        rect.stroke(state.barStroke)\r\n        ctx.draw(g.opacity(dimAt(state, i)))\r\n      }\r\n    }\r\n    ctx.children()\r\n  },\r\n})\r\n\r\nexport type ChartBars = NodeOf<typeof ChartBars>\r\n"]}

package/dist/bar-chart/index.d.ts

@@ -5,8 +5,8 @@
  * which is what lets a scene swap one for the other without re-theming — and
  * brings its own category axis, since a band scale is not a continuous one.
  */
-export { BarChart } from "./bar-chart.js";
-export type { BarChartProps } from "./bar-chart.js";
+export { BarChart, barChartDomain } from "./bar-chart.js";
+export type { BarChartDomain, BarChartProps, BarChartValues } from "./bar-chart.js";
 export { ChartBars } from "./chart-bars.js";
 export type { BarGeometry, ChartBarsProps } from "./chart-bars.js";
 export { CategoryAxis } from "./category-axis.js";

package/dist/bar-chart/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bar-chart/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,OAAO,EACP,cAAc,GACf,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bar-chart/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACtD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,OAAO,EACP,cAAc,GACf,MAAM,UAAU,CAAA"}

package/dist/bar-chart/index.js

@@ -5,7 +5,7 @@
  * which is what lets a scene swap one for the other without re-theming — and
  * brings its own category axis, since a band scale is not a continuous one.
  */
-export { BarChart } from "./bar-chart.js";
+export { BarChart, barChartDomain } from "./bar-chart.js";
 export { ChartBars } from "./chart-bars.js";
 export { CategoryAxis } from "./category-axis.js";
 export { DEFAULT_BAR_CHART_THEME, barCategories, barSpans, barValueExtent, lerpBarChartTheme, resolveBarChartTheme, resolveBarFill, resolveBarScale, stackCapIndex, } from "./shared.js";