@motionscript/charts 0.1.1-alpha.0 → 0.1.1-alpha.1

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

@@ -1,25 +1,19 @@
-import { Graphics2D, Text, Types, clamp, component2d, fillOps, shadowOps, strokeOps, textOps, } from "@motionscript/sdk";
-import { fresh } from "../kit/entries.js";
+import { Graphics2D, Text, Types, clamp, component2d, fillOps, } from "@motionscript/sdk";
+import { boundText } from "../kit/cartesian.js";
+import { asParts, fresh } from "../kit/entries.js";
 import { frameEase } from "../kit/motion.js";
 import { loadPaints } from "../kit/paints.js";
 import { formatMarker } from "../kit/shared.js";
-import { DEFAULT_BAR_CHART_THEME } from "./shared.js";
-/** 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;
-/**
- * Column `i`'s dimming: the category spotlight, then the series switch. Captions
- * read this because they are child nodes, which a `render` guard would leave on
- * screen over a series that is not there.
- */
+import { inkOn } from "./shared.js";
+/** A figure inside a bar needs this much room around it, in multiples of the type size. */
+const INSIDE_ROOM = 0.6;
+/** Bar `i`'s dimming: the category spotlight, then the series switch. */
 function dimAt(s, index) {
     if (!s.enabled)
         return 0;
     return clamp(s.dims[index] ?? 1, 0, 1);
 }
+/** Bar `i`'s two ends as grown so far, along the value axis. */
 function endsAt(s, index) {
     const bar = s.bars[index];
     if (!bar)
@@ -27,90 +21,87 @@ function endsAt(s, index) {
     const g = clamp(s.growth, 0, 1);
     return { base: s.baseline + (bar.from - s.baseline) * g, end: s.baseline + (bar.to - s.baseline) * g };
 }
-function valueSize(s) {
-    const size = s.valueStyle.fontSize;
-    return typeof size === "number" ? size : VALUE_SIZE;
-}
-function insideAt(s, index) {
-    const bar = s.bars[index];
-    return bar !== undefined && Math.abs(bar.from - s.baseline) > 0.5;
-}
-/** Column `i`'s figure, or `""` where there is no room. Blanking rather than dropping the node keeps captions index-aligned, so a rescale into more room prints again. */
-function captionAt(s, index) {
-    const bar = s.bars[index];
-    if (!bar || bar.value === 0)
-        return "";
-    // An interior segment prints inside itself and must hold a line of type; a grouped column prints past its end.
-    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);
+function sizeOf(style) {
+    return typeof style.fontSize === "number" ? style.fontSize : 24;
 }
-function captionY(s, index) {
+/** Where bar `i`'s figure sits along the value axis: past its end, or in its middle. */
+function captionAlong(s, index, extent) {
     const ends = endsAt(s, index);
     if (!ends)
         return 0;
-    if (insideAt(s, index))
+    if (s.values === "inside")
         return (ends.base + ends.end) / 2;
-    // Text is centred on `y`: clear the end by the gap plus half a line, on the side the column reached.
     const direction = ends.end >= ends.base ? 1 : -1;
-    return ends.end + direction * (VALUE_GAP + valueSize(s) / 2);
+    return ends.end + direction * (sizeOf(s.valueStyle) * 0.4 + extent / 2);
+}
+/** Whether bar `i` has room for a figure `extent` long inside it. */
+function fitsInside(s, index, extent, across) {
+    const bar = s.bars[index];
+    const ends = endsAt(s, index);
+    if (!bar || !ends)
+        return false;
+    const room = sizeOf(s.valueStyle) * INSIDE_ROOM;
+    return Math.abs(ends.end - ends.base) >= extent + room && bar.thickness >= across;
 }
 /**
- * One series of a {@link BarChart}: its column in every category plus the
- * printed figures. A node per series, like `ChartLine`, so `showSeries` and
+ * One series of a {@link BarChart}: its bar in every category plus the printed
+ * figures. A node per series, like `ChartLine`, so `showSeries` and
  * `spotlightSeries` mean the same on both: enable the node or tween its opacity.
  * Positions come from the parent, which owns the slot arithmetic.
- *
- * The figures are {@link Text} children, so they take the theme's type style,
- * are measured by layout, and hide with the series.
  */
 export const ChartBars = component2d({
     key: "chartBars",
     state: {
         bars: fresh(() => []),
-        /** Pixel y of value 0, where every column grows from. */
+        /** Pixel position of value 0 along the value axis, where every bar grows from. */
         baseline: 0,
+        /** Bars grow along x from a category column rather than along y from a row. */
+        horizontal: false,
         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,
+        cornerRadius: 8,
         /**
-         * Rise of every column in `[0, 1]` about the baseline, not each column's own
-         * base: every segment travels by the same factor, so a stack stays flush
-         * mid-animation and a negative column grows down.
+         * Rise of every bar in `[0, 1]` about the baseline, not each bar's own base:
+         * every segment travels by the same factor, so a stack stays flush
+         * mid-animation and a negative bar grows the other way.
          */
         growth: 1,
-        /** Per-column opacity by row index, how the category spotlight reaches one column. Missing reads as 1. */
+        /** Per-bar opacity by row index, how the category spotlight reaches one bar. Missing reads as 1. */
         dims: fresh(() => []),
-        showValues: false,
-        valueStyle: Types.custom(DEFAULT_BAR_CHART_THEME.valueStyle),
-        /** The wholesale switch behind `showSeries`/`hideSeries`; off skips the columns and their figures. */
+        /** Read as built: whether each bar prints its figure, and where. */
+        values: Types.custom("none"),
+        valueStyle: Types.custom({ fontSize: 24, fill: "white" }),
+        /** The wholesale switch behind `showSeries`/`hideSeries`; off skips the bars and their figures. */
         enabled: true,
     },
     // A node made of its figures would otherwise hug them.
     defaults: { width: "fill", height: "fill" },
-    // One caption per column, built once (the row count is fixed at construction)
-    // and bound to the live geometry so it travels with its column.
+    // One figure per bar, built once (the row count is fixed at construction)
+    // and bound to the live geometry so it travels with its bar.
     children: (state) => {
-        if (!state.showValues)
+        if (state.values === "none")
             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),
+        return asParts(state.bars.map((_, i) => {
+            const caption = new Text({
+                ...boundText(() => ({ ...state.valueStyle, ...(state.values === "inside" && { fill: inkOn(state.fill) }) })),
+                text: () => state.bars[i]?.caption ?? "",
+                x: () => (state.horizontal ? captionAlong(state, i, caption.layoutBounds.width) : (state.bars[i]?.center ?? 0)),
+                y: () => (state.horizontal ? (state.bars[i]?.center ?? 0) : captionAlong(state, i, caption.layoutBounds.height)),
+                opacity: () => {
+                    const box = caption.layoutBounds;
+                    const along = state.horizontal ? box.width : box.height;
+                    const across = state.horizontal ? box.height : box.width;
+                    if (state.values === "inside" && !fitsInside(state, i, along, across))
+                        return 0;
+                    // A figure past the end rises in with its bar's last stretch.
+                    return dimAt(state, i) * clamp((state.growth - 0.6) / 0.4, 0, 1);
+                },
+            });
+            return caption;
         }));
     },
-    // The stroke and shadow sit past the conventional slots, so they are named here.
-    load: (loader, state) => loadPaints(loader, { fills: [state.fill], shadows: [state.barShadow], strokes: [state.barStroke] }),
+    load: (loader, state) => loadPaints(loader, { fills: [state.fill] }),
     commands: {
-        /** Raise every column from the baseline (`growth` 0 to 1). The resting state is the finished one; the chart arms it back to 0. */
+        /** Raise every bar from the baseline (`growth` 0 to 1). The resting state is the finished one; the chart arms it back to 0. */
         enter: (timeline) => {
             const ease = frameEase(timeline);
             return timeline.animate((t) => ({ growth: ease(t) }));
@@ -121,33 +112,33 @@ export const ChartBars = component2d({
             for (let i = 0; i < state.bars.length; i++) {
                 const bar = state.bars[i];
                 const ends = endsAt(state, i);
-                if (!ends || bar.width <= 0)
+                if (!ends || bar.thickness <= 0)
                     continue;
-                const height = Math.abs(ends.end - ends.base);
-                if (height <= 0)
+                // A segment inside a stack reaches a pixel under the next, so no seam of background shows between them.
+                const seam = bar.round ? 0 : 1;
+                const length = Math.abs(ends.end - ends.base) + seam;
+                if (length <= seam)
                     continue;
-                const radius = bar.round ? Math.min(state.cornerRadius, height) : 0;
-                // One `Graphics2D` per column: opacity belongs to the command list, and the spotlight dims single columns.
-                const g = new Graphics2D();
-                const rect = g.rect({
-                    x: bar.x,
-                    y: (ends.base + ends.end) / 2,
-                    width: bar.width,
-                    height,
-                    // Corner keys are visual (y-up): a column reaching up rounds `top*`, one reaching down `bottom*`. Only the far end rounds.
-                    cornerRadius: radius > 0
-                        ? ends.end >= ends.base
-                            ? { topLeft: radius, topRight: radius, bottomLeft: 0, bottomRight: 0 }
-                            : { bottomLeft: radius, bottomRight: radius, topLeft: 0, topRight: 0 }
-                        : 0,
-                });
-                rect.shadow(state.barShadow);
-                rect.fill(state.fill);
-                rect.stroke(state.barStroke);
+                const radius = bar.round ? Math.max(0, Math.min(state.cornerRadius, length, bar.thickness / 2)) : 0;
+                const forward = ends.end >= ends.base;
+                const mid = (ends.base + ends.end) / 2 + (forward ? seam : -seam) / 2;
+                // Corner keys are visual (y-up): only the far end rounds.
+                const far = state.horizontal
+                    ? (forward ? { topRight: radius, bottomRight: radius, topLeft: 0, bottomLeft: 0 } : { topLeft: radius, bottomLeft: radius, topRight: 0, bottomRight: 0 })
+                    : (forward ? { topLeft: radius, topRight: radius, bottomLeft: 0, bottomRight: 0 } : { bottomLeft: radius, bottomRight: radius, topLeft: 0, topRight: 0 });
+                // One `Graphics2D` per bar: opacity belongs to the command list, and the spotlight dims single bars.
+                const g = new Graphics2D().rect(state.horizontal
+                    ? { x: mid, y: bar.center, width: length, height: bar.thickness, cornerRadius: radius > 0 ? far : 0 }
+                    : { x: bar.center, y: mid, width: bar.thickness, height: length, cornerRadius: radius > 0 ? far : 0 });
+                g.fill(state.fill);
                 ctx.draw(g.opacity(dimAt(state, i)));
             }
         }
         ctx.children();
     },
 });
+/** A figure as the bar prints it when the chart gives no caption. */
+export function barCaption(value) {
+    return value === 0 ? "" : formatMarker(value);
+}
 //# 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  Graphics2D,\n  Text,\n  Types,\n  clamp,\n  component2d,\n  fillOps,\n  shadowOps,\n  strokeOps,\n  textOps,\n  type Fill,\n  type FillResolved,\n  type NodeOf,\n  // Named so this component's emitted type reaches `Node2D` and its props through the sdk, not core.\n  type Node2D as _Node2D,\n  type Node2DProps as _Node2DProps,\n  type Shadow,\n  type ShadowResolved,\n  type Stroke,\n  type StrokeResolved,\n  type TextStyle,\n} from \"@motionscript/sdk\"\n\nimport { fresh } from \"../kit/entries\"\nimport { frameEase } from \"../kit/motion\"\nimport { loadPaints } from \"../kit/paints\"\nimport { formatMarker } from \"../kit/shared\"\nimport { DEFAULT_BAR_CHART_THEME } from \"./shared\"\n\n/**\n * One drawn column in the plot's centred pixel space (origin at the centre,\n * y-up), mapped by the parent {@link BarChart}. `from`/`to` are the two ends\n * rather than a base and a height, like {@link BarSpan}: one shape fits grouped,\n * stacked and negative.\n */\nexport interface BarGeometry {\n  /** Centre x. */\n  x: number\n  width: number\n  /** Pixel y of the base: the baseline when grouped, the running stack top when stacked. */\n  from: number\n  /** Pixel y of the far end at full growth. */\n  to: number\n  /** Whether the far end takes the corner radius (the stack's cap). */\n  round: boolean\n  /** The value plotted, for the printed figure. */\n  value: number\n  /** The printed figure, written as the value axis writes its ticks; absent, the bare marker reading of `value`. */\n  caption?: string\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\ninterface Columns {\n  readonly bars: readonly BarGeometry[]\n  readonly baseline: number\n  readonly growth: number\n  readonly dims: readonly number[]\n  readonly enabled: boolean\n  readonly valueStyle: TextStyle\n}\n\n/**\n * Column `i`'s dimming: the category spotlight, then the series switch. Captions\n * read this because they are child nodes, which a `render` guard would leave on\n * screen over a series that is not there.\n */\nfunction dimAt(s: Columns, index: number): number {\n  if (!s.enabled) return 0\n  return clamp(s.dims[index] ?? 1, 0, 1)\n}\n\nfunction endsAt(s: Columns, index: number): { base: number; end: number } | null {\n  const bar = s.bars[index]\n  if (!bar) return null\n  const g = clamp(s.growth, 0, 1)\n  return { base: s.baseline + (bar.from - s.baseline) * g, end: s.baseline + (bar.to - s.baseline) * g }\n}\n\nfunction valueSize(s: Columns): number {\n  const size = s.valueStyle.fontSize\n  return typeof size === \"number\" ? size : VALUE_SIZE\n}\n\nfunction insideAt(s: Columns, index: number): boolean {\n  const bar = s.bars[index]\n  return bar !== undefined && Math.abs(bar.from - s.baseline) > 0.5\n}\n\n/** Column `i`'s figure, or `\"\"` where there is no room. Blanking rather than dropping the node keeps captions index-aligned, so a rescale into more room prints again. */\nfunction captionAt(s: Columns, index: number): string {\n  const bar = s.bars[index]\n  if (!bar || bar.value === 0) return \"\"\n  // An interior segment prints inside itself and must hold a line of type; a grouped column prints past its end.\n  if (insideAt(s, index)) {\n    const ends = endsAt(s, index)\n    if (!ends) return \"\"\n    if (Math.abs(ends.end - ends.base) < valueSize(s) * VALUE_FIT) return \"\"\n  }\n  return bar.caption ?? formatMarker(bar.value)\n}\n\nfunction captionY(s: Columns, index: number): number {\n  const ends = endsAt(s, index)\n  if (!ends) return 0\n  if (insideAt(s, index)) return (ends.base + ends.end) / 2\n  // Text is centred on `y`: clear the end by the gap plus half a line, on the side the column reached.\n  const direction = ends.end >= ends.base ? 1 : -1\n  return ends.end + direction * (VALUE_GAP + valueSize(s) / 2)\n}\n\n/**\n * One series of a {@link BarChart}: its column in every category plus the\n * printed figures. A node per series, like `ChartLine`, so `showSeries` and\n * `spotlightSeries` mean the same on both: enable the node or tween its opacity.\n * Positions come from the parent, which owns the slot arithmetic.\n *\n * The figures are {@link Text} children, so they take the theme's type style,\n * are measured by layout, and hide with the series.\n */\nexport const ChartBars = component2d({\n  key: \"chartBars\",\n  state: {\n    bars: fresh<BarGeometry[]>(() => []),\n    /** Pixel y of value 0, where every column grows from. */\n    baseline: 0,\n    fill: Types.custom<Fill, FillResolved[]>([], { resolve: fillOps.resolve, lerp: fillOps.lerp }),\n    barStroke: Types.custom<Stroke, StrokeResolved[]>(DEFAULT_BAR_CHART_THEME.bar.stroke, { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),\n    barShadow: Types.custom<Shadow, ShadowResolved[]>(DEFAULT_BAR_CHART_THEME.bar.shadow, { resolve: shadowOps.resolve, lerp: shadowOps.lerp }),\n    cornerRadius: DEFAULT_BAR_CHART_THEME.bar.cornerRadius,\n    /**\n     * Rise of every column in `[0, 1]` about the baseline, not each column's own\n     * base: every segment travels by the same factor, so a stack stays flush\n     * mid-animation and a negative column grows down.\n     */\n    growth: 1,\n    /** Per-column opacity by row index, how the category spotlight reaches one column. Missing reads as 1. */\n    dims: fresh<number[]>(() => []),\n    showValues: false,\n    valueStyle: Types.custom<TextStyle>(DEFAULT_BAR_CHART_THEME.valueStyle),\n    /** The wholesale switch behind `showSeries`/`hideSeries`; off skips the columns and their figures. */\n    enabled: true,\n  },\n  // A node made of its figures would otherwise hug them.\n  defaults: { width: \"fill\", height: \"fill\" },\n  // One caption per column, built once (the row count is fixed at construction)\n  // and bound to the live geometry so it travels with its column.\n  children: (state) => {\n    if (!state.showValues) return []\n    return state.bars.map((_, i) =>\n      Text({\n        ...textOps.styleProps(state.valueStyle),\n        text: () => captionAt(state, i),\n        x: () => state.bars[i]?.x ?? 0,\n        y: () => captionY(state, i),\n        opacity: () => dimAt(state, i),\n      })\n    )\n  },\n  // The stroke and shadow sit past the conventional slots, so they are named here.\n  load: (loader, state) =>\n    loadPaints(loader, { fills: [state.fill], shadows: [state.barShadow], strokes: [state.barStroke] }),\n  commands: {\n    /** Raise every column from the baseline (`growth` 0 to 1). The resting state is the finished one; the chart arms it back to 0. */\n    enter: (timeline) => {\n      const ease = frameEase(timeline)\n      return timeline.animate((t) => ({ growth: ease(t) }))\n    },\n  },\n  render: (ctx, state) => {\n    if (state.enabled) {\n      for (let i = 0; i < state.bars.length; i++) {\n        const bar = state.bars[i]\n        const ends = endsAt(state, 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(state.cornerRadius, height) : 0\n        // One `Graphics2D` per column: opacity belongs to the command list, and the spotlight dims single columns.\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          // Corner keys are visual (y-up): a column reaching up rounds `top*`, one reaching down `bottom*`. Only the far end rounds.\n          cornerRadius:\n            radius > 0\n              ? ends.end >= ends.base\n                ? { topLeft: radius, topRight: radius, bottomLeft: 0, bottomRight: 0 }\n                : { bottomLeft: radius, bottomRight: radius, topLeft: 0, topRight: 0 }\n              : 0,\n        })\n        rect.shadow(state.barShadow)\n        rect.fill(state.fill)\n        rect.stroke(state.barStroke)\n        ctx.draw(g.opacity(dimAt(state, i)))\n      }\n    }\n    ctx.children()\n  },\n})\n\nexport type ChartBars = NodeOf<typeof ChartBars>\n"]}
+{"version":3,"file":"chart-bars.js","sourceRoot":"","sources":["../../src/bar-chart/chart-bars.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,IAAI,EACJ,KAAK,EACL,KAAK,EACL,WAAW,EACX,OAAO,GAQR,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAsBhC,2FAA2F;AAC3F,MAAM,WAAW,GAAG,GAAG,CAAA;AAavB,yEAAyE;AACzE,SAAS,KAAK,CAAC,CAAO,EAAE,KAAa;IACnC,IAAI,CAAC,CAAC,CAAC,OAAO;QAAE,OAAO,CAAC,CAAA;IACxB,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AACxC,CAAC;AAED,gEAAgE;AAChE,SAAS,MAAM,CAAC,CAAO,EAAE,KAAa;IACpC,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzB,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/B,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAA;AACxG,CAAC;AAED,SAAS,MAAM,CAAC,KAAgB;IAC9B,OAAO,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;AACjE,CAAC;AAED,wFAAwF;AACxF,SAAS,YAAY,CAAC,CAAO,EAAE,KAAa,EAAE,MAAc;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IAC7B,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAA;IACnB,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAChD,OAAO,IAAI,CAAC,GAAG,GAAG,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC,CAAA;AACzE,CAAC;AAED,qEAAqE;AACrE,SAAS,UAAU,CAAC,CAAO,EAAE,KAAa,EAAE,MAAc,EAAE,MAAc;IACxE,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IAC7B,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,WAAW,CAAA;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,SAAS,IAAI,MAAM,CAAA;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;IACnC,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,KAAK,CAAgB,GAAG,EAAE,CAAC,EAAE,CAAC;QACpC,kFAAkF;QAClF,QAAQ,EAAE,CAAC;QACX,+EAA+E;QAC/E,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAuB,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAC9F,YAAY,EAAE,CAAC;QACf;;;;WAIG;QACH,MAAM,EAAE,CAAC;QACT,oGAAoG;QACpG,IAAI,EAAE,KAAK,CAAW,GAAG,EAAE,CAAC,EAAE,CAAC;QAC/B,oEAAoE;QACpE,MAAM,EAAE,KAAK,CAAC,MAAM,CAA4B,MAAM,CAAC;QACvD,UAAU,EAAE,KAAK,CAAC,MAAM,CAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACpE,mGAAmG;QACnG,OAAO,EAAE,IAAI;KACd;IACD,uDAAuD;IACvD,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAC3C,0EAA0E;IAC1E,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QAClB,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,EAAE,CAAA;QACtC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrC,MAAM,OAAO,GAAW,IAAI,IAAI,CAAC;gBAC/B,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC5G,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE;gBACxC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;gBAC/G,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBAChH,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAA;oBAChC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA;oBACvD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAA;oBACxD,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC;wBAAE,OAAO,CAAC,CAAA;oBAC/E,8DAA8D;oBAC9D,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;gBAClE,CAAC;aACF,CAAsB,CAAA;YACvB,OAAO,OAAO,CAAA;QAChB,CAAC,CAAC,CAAC,CAAA;IACL,CAAC;IACD,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IACpE,QAAQ,EAAE;QACR,+HAA+H;QAC/H,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE;YAClB,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;YAChC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACvD,CAAC;KACF;IACD,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACrB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;gBACzB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;gBAC7B,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,SAAS,IAAI,CAAC;oBAAE,SAAQ;gBACzC,wGAAwG;gBACxG,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;gBACpD,IAAI,MAAM,IAAI,IAAI;oBAAE,SAAQ;gBAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBACnG,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAA;gBACrC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACrE,0DAA0D;gBAC1D,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU;oBAC1B,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;oBACzJ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAA;gBAC3J,qGAAqG;gBACrG,MAAM,CAAC,GAAG,IAAI,UAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;oBAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;oBACrG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;gBACxG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAClB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;QACD,GAAG,CAAC,QAAQ,EAAE,CAAA;IAChB,CAAC;CACF,CAAC,CAAA;AAIF,qEAAqE;AACrE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;AAC/C,CAAC","sourcesContent":["import {\n  Graphics2D,\n  Text,\n  Types,\n  clamp,\n  component2d,\n  fillOps,\n  type Fill,\n  type FillResolved,\n  type NodeOf,\n  // Named so this component's emitted type reaches `Node2D` and its props through the sdk, not core.\n  type Node2D,\n  type Node2DProps as _Node2DProps,\n  type TextStyle,\n} from \"@motionscript/sdk\"\n\nimport { boundText } from \"../kit/cartesian\"\nimport { asParts, fresh } from \"../kit/entries\"\nimport { frameEase } from \"../kit/motion\"\nimport { loadPaints } from \"../kit/paints\"\nimport { formatMarker } from \"../kit/shared\"\nimport { inkOn } from \"./shared\"\n\n/**\n * One drawn bar in the plot's centred pixel space (origin at the centre, y-up),\n * mapped by the parent {@link BarChart}: `center` and `thickness` across the\n * category slot, `from` and `to` along the value axis (y for a column, x for a\n * horizontal bar). Two ends rather than a base and a length, like `BarSpan`:\n * one shape fits grouped, stacked and negative.\n */\nexport interface BarGeometry {\n  center: number\n  thickness: number\n  /** The base: the baseline when grouped, the running stack end when stacked. */\n  from: number\n  /** The far end at full growth. */\n  to: number\n  /** Whether the far end takes the corner radius (the stack's last segment on its side). */\n  round: boolean\n  /** The figure printed by the bar; empty for none. */\n  caption: string\n}\n\n/** A figure inside a bar needs this much room around it, in multiples of the type size. */\nconst INSIDE_ROOM = 0.6\n\ninterface Bars {\n  readonly bars: readonly BarGeometry[]\n  readonly baseline: number\n  readonly horizontal: boolean\n  readonly growth: number\n  readonly dims: readonly number[]\n  readonly enabled: boolean\n  readonly values: \"none\" | \"end\" | \"inside\"\n  readonly valueStyle: TextStyle\n}\n\n/** Bar `i`'s dimming: the category spotlight, then the series switch. */\nfunction dimAt(s: Bars, index: number): number {\n  if (!s.enabled) return 0\n  return clamp(s.dims[index] ?? 1, 0, 1)\n}\n\n/** Bar `i`'s two ends as grown so far, along the value axis. */\nfunction endsAt(s: Bars, index: number): { base: number; end: number } | null {\n  const bar = s.bars[index]\n  if (!bar) return null\n  const g = clamp(s.growth, 0, 1)\n  return { base: s.baseline + (bar.from - s.baseline) * g, end: s.baseline + (bar.to - s.baseline) * g }\n}\n\nfunction sizeOf(style: TextStyle): number {\n  return typeof style.fontSize === \"number\" ? style.fontSize : 24\n}\n\n/** Where bar `i`'s figure sits along the value axis: past its end, or in its middle. */\nfunction captionAlong(s: Bars, index: number, extent: number): number {\n  const ends = endsAt(s, index)\n  if (!ends) return 0\n  if (s.values === \"inside\") return (ends.base + ends.end) / 2\n  const direction = ends.end >= ends.base ? 1 : -1\n  return ends.end + direction * (sizeOf(s.valueStyle) * 0.4 + extent / 2)\n}\n\n/** Whether bar `i` has room for a figure `extent` long inside it. */\nfunction fitsInside(s: Bars, index: number, extent: number, across: number): boolean {\n  const bar = s.bars[index]\n  const ends = endsAt(s, index)\n  if (!bar || !ends) return false\n  const room = sizeOf(s.valueStyle) * INSIDE_ROOM\n  return Math.abs(ends.end - ends.base) >= extent + room && bar.thickness >= across\n}\n\n/**\n * One series of a {@link BarChart}: its bar in every category plus the printed\n * figures. A node per series, like `ChartLine`, so `showSeries` and\n * `spotlightSeries` mean the same on both: enable the node or tween its opacity.\n * Positions come from the parent, which owns the slot arithmetic.\n */\nexport const ChartBars = component2d({\n  key: \"chartBars\",\n  state: {\n    bars: fresh<BarGeometry[]>(() => []),\n    /** Pixel position of value 0 along the value axis, where every bar grows from. */\n    baseline: 0,\n    /** Bars grow along x from a category column rather than along y from a row. */\n    horizontal: false,\n    fill: Types.custom<Fill, FillResolved[]>([], { resolve: fillOps.resolve, lerp: fillOps.lerp }),\n    cornerRadius: 8,\n    /**\n     * Rise of every bar in `[0, 1]` about the baseline, not each bar's own base:\n     * every segment travels by the same factor, so a stack stays flush\n     * mid-animation and a negative bar grows the other way.\n     */\n    growth: 1,\n    /** Per-bar opacity by row index, how the category spotlight reaches one bar. Missing reads as 1. */\n    dims: fresh<number[]>(() => []),\n    /** Read as built: whether each bar prints its figure, and where. */\n    values: Types.custom<\"none\" | \"end\" | \"inside\">(\"none\"),\n    valueStyle: Types.custom<TextStyle>({ fontSize: 24, fill: \"white\" }),\n    /** The wholesale switch behind `showSeries`/`hideSeries`; off skips the bars and their figures. */\n    enabled: true,\n  },\n  // A node made of its figures would otherwise hug them.\n  defaults: { width: \"fill\", height: \"fill\" },\n  // One figure per bar, built once (the row count is fixed at construction)\n  // and bound to the live geometry so it travels with its bar.\n  children: (state) => {\n    if (state.values === \"none\") return []\n    return asParts(state.bars.map((_, i) => {\n      const caption: Node2D = new Text({\n        ...boundText(() => ({ ...state.valueStyle, ...(state.values === \"inside\" && { fill: inkOn(state.fill) }) })),\n        text: () => state.bars[i]?.caption ?? \"\",\n        x: () => (state.horizontal ? captionAlong(state, i, caption.layoutBounds.width) : (state.bars[i]?.center ?? 0)),\n        y: () => (state.horizontal ? (state.bars[i]?.center ?? 0) : captionAlong(state, i, caption.layoutBounds.height)),\n        opacity: () => {\n          const box = caption.layoutBounds\n          const along = state.horizontal ? box.width : box.height\n          const across = state.horizontal ? box.height : box.width\n          if (state.values === \"inside\" && !fitsInside(state, i, along, across)) return 0\n          // A figure past the end rises in with its bar's last stretch.\n          return dimAt(state, i) * clamp((state.growth - 0.6) / 0.4, 0, 1)\n        },\n      }) as unknown as Node2D\n      return caption\n    }))\n  },\n  load: (loader, state) => loadPaints(loader, { fills: [state.fill] }),\n  commands: {\n    /** Raise every bar from the baseline (`growth` 0 to 1). The resting state is the finished one; the chart arms it back to 0. */\n    enter: (timeline) => {\n      const ease = frameEase(timeline)\n      return timeline.animate((t) => ({ growth: ease(t) }))\n    },\n  },\n  render: (ctx, state) => {\n    if (state.enabled) {\n      for (let i = 0; i < state.bars.length; i++) {\n        const bar = state.bars[i]\n        const ends = endsAt(state, i)\n        if (!ends || bar.thickness <= 0) continue\n        // A segment inside a stack reaches a pixel under the next, so no seam of background shows between them.\n        const seam = bar.round ? 0 : 1\n        const length = Math.abs(ends.end - ends.base) + seam\n        if (length <= seam) continue\n        const radius = bar.round ? Math.max(0, Math.min(state.cornerRadius, length, bar.thickness / 2)) : 0\n        const forward = ends.end >= ends.base\n        const mid = (ends.base + ends.end) / 2 + (forward ? seam : -seam) / 2\n        // Corner keys are visual (y-up): only the far end rounds.\n        const far = state.horizontal\n          ? (forward ? { topRight: radius, bottomRight: radius, topLeft: 0, bottomLeft: 0 } : { topLeft: radius, bottomLeft: radius, topRight: 0, bottomRight: 0 })\n          : (forward ? { topLeft: radius, topRight: radius, bottomLeft: 0, bottomRight: 0 } : { bottomLeft: radius, bottomRight: radius, topLeft: 0, topRight: 0 })\n        // One `Graphics2D` per bar: opacity belongs to the command list, and the spotlight dims single bars.\n        const g = new Graphics2D().rect(state.horizontal\n          ? { x: mid, y: bar.center, width: length, height: bar.thickness, cornerRadius: radius > 0 ? far : 0 }\n          : { x: bar.center, y: mid, width: bar.thickness, height: length, cornerRadius: radius > 0 ? far : 0 })\n        g.fill(state.fill)\n        ctx.draw(g.opacity(dimAt(state, i)))\n      }\n    }\n    ctx.children()\n  },\n})\n\nexport type ChartBars = NodeOf<typeof ChartBars>\n\n/** A figure as the bar prints it when the chart gives no caption. */\nexport function barCaption(value: number): string {\n  return value === 0 ? \"\" : formatMarker(value)\n}\n"]}

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

@@ -1,8 +1,8 @@
 export { BarChart, barChartDomain } from "./bar-chart.js";
-export type { BarChartDomain, BarChartValues } from "./bar-chart.js";
+export type { BarChartDomain, BarChartStyle, BarChartValues } from "./bar-chart.js";
 export { ChartBars } from "./chart-bars.js";
 export type { BarGeometry } 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";
-export type { BarChartConfig, BarChartTheme, BarSeries, BarSpan, BarStyleConfig, } from "./shared.js";
+export { CategoryAxis, slotCentre } from "./category-axis.js";
+export { BAR_LABELS, BAR_MARKS, barCategories, barSpans, barValueExtent, inkOn, resolveBarScale, } from "./shared.js";
+export type { BarOrientation, BarSeries, BarSpan, BarStack, } from "./shared.js";
 //# sourceMappingURL=index.d.ts.map

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,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACtD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,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,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,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,QAAQ,EACR,cAAc,EACd,KAAK,EACL,eAAe,GAChB,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,cAAc,EACd,SAAS,EACT,OAAO,EACP,QAAQ,GACT,MAAM,UAAU,CAAA"}

package/dist/bar-chart/index.js

@@ -1,5 +1,5 @@
 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";
+export { CategoryAxis, slotCentre } from "./category-axis.js";
+export { BAR_LABELS, BAR_MARKS, barCategories, barSpans, barValueExtent, inkOn, resolveBarScale, } from "./shared.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bar-chart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,UAAU,CAAA","sourcesContent":["export { BarChart, barChartDomain } from \"./bar-chart\"\nexport type { BarChartDomain, BarChartValues } from \"./bar-chart\"\nexport { ChartBars } from \"./chart-bars\"\nexport type { BarGeometry } from \"./chart-bars\"\nexport { CategoryAxis } from \"./category-axis\"\nexport {\n  DEFAULT_BAR_CHART_THEME,\n  barCategories,\n  barSpans,\n  barValueExtent,\n  lerpBarChartTheme,\n  resolveBarChartTheme,\n  resolveBarFill,\n  resolveBarScale,\n  stackCapIndex,\n} from \"./shared\"\nexport type {\n  BarChartConfig,\n  BarChartTheme,\n  BarSeries,\n  BarSpan,\n  BarStyleConfig,\n} from \"./shared\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bar-chart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,QAAQ,EACR,cAAc,EACd,KAAK,EACL,eAAe,GAChB,MAAM,UAAU,CAAA","sourcesContent":["export { BarChart, barChartDomain } from \"./bar-chart\"\nexport type { BarChartDomain, BarChartStyle, BarChartValues } from \"./bar-chart\"\nexport { ChartBars } from \"./chart-bars\"\nexport type { BarGeometry } from \"./chart-bars\"\nexport { CategoryAxis, slotCentre } from \"./category-axis\"\nexport {\n  BAR_LABELS,\n  BAR_MARKS,\n  barCategories,\n  barSpans,\n  barValueExtent,\n  inkOn,\n  resolveBarScale,\n} from \"./shared\"\nexport type {\n  BarOrientation,\n  BarSeries,\n  BarSpan,\n  BarStack,\n} from \"./shared\"\n"]}

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

@@ -1,83 +1,54 @@
-import { type DataRecord, type Fill, type Shadow, type Stroke, type TextStyle } from "@motionscript/sdk";
-import { type AxisConfig, type ChartSeries, type LegendConfig, type LegendTheme, type PlotAreaConfig, type Range } from "../kit/shared.js";
+import { type DataRecord, type Fill } from "@motionscript/sdk";
+import { type ChartSeries, type Range } from "../kit/shared.js";
 /** One bar per row, beside its siblings in the category slot or stacked on them: {@link ChartSeries} under the name for what it draws here. */
 export type BarSeries = ChartSeries;
+/** How the series share a category: side by side, stacked, or stacked as shares of 100. */
+export type BarStack = "none" | "stacked" | "percent";
+/** Which way the bars grow: up from a category row, or right from a category column. */
+export type BarOrientation = "vertical" | "horizontal";
 /**
- * One bar's span in data units. A span rather than a height because both modes
- * fit it, and a negative value just runs the other way with no special case.
+ * One bar's span in data units. A span rather than a height because every mode
+ * fits it, and a negative value just runs the other way with no special case.
  */
 export interface BarSpan {
-    /** Where the base sits: 0 when grouped, the running total below when stacked. */
+    /** Where the base sits: 0 apart, the running total below (or above, for a negative) when stacked. */
     from: number;
     to: number;
-    /** `to - from`, kept for the figure printed on the bar. */
+    /** `to - from`. */
     value: number;
+    /** Whether it ends its stack on its side of zero, so its far end is rounded. */
+    outer: boolean;
 }
 /**
- * One row's spans, in series order. Stacking is a running sum in listed order,
- * so series 0 sits on the baseline. A zero value still yields a degenerate span,
- * keeping the list index-aligned with the series.
+ * One row's spans, in series order. Stacking keeps a running sum on each side
+ * of zero, so a negative value stacks downward from the baseline rather than
+ * eating into the positives. In `percent` each value is its share of the row's
+ * total magnitude. A zero value still yields a degenerate span, keeping the list
+ * index-aligned with the series. `weights` scale each series' contribution.
  */
-export declare function barSpans(row: DataRecord, series: BarSeries[], stacked: boolean): BarSpan[];
-/**
- * The series ending a row's stack, which gets the rounded cap; `-1` when the row
- * is all zero. It is the last non-zero series, so a zero one does not take the
- * cap and leave the segment below square.
- */
-export declare function stackCapIndex(row: DataRecord, series: BarSeries[]): number;
+export declare function barSpans(row: DataRecord, series: readonly BarSeries[], stack: BarStack, weights?: readonly number[]): BarSpan[];
 export declare function barCategories(data: DataRecord[], field: string): string[];
 /**
  * The `[min, max]` of everything drawn, zero always included: a scale starting
- * at 40 draws a column three times its neighbour for a 10% difference. A cropped
+ * at 40 draws a bar three times its neighbour for a 10% difference. A cropped
  * axis takes an explicit range.
  */
-export declare function barValueExtent(data: DataRecord[], series: BarSeries[], stacked: boolean): Range;
-/** The explicit `range`, else the data's extent nudged to tidy bounds; `divisions` (one fewer than the marker count) makes the drawn ticks land on them. */
-export declare function resolveBarScale(data: DataRecord[], series: BarSeries[], stacked: boolean, range: Range | undefined, divisions: number): Range;
-/** How the columns are drawn and the slot divided. */
-export interface BarStyleConfig {
-    /** Radius in px of a column's far-end corners; an interior stacked segment stays square. */
-    cornerRadius: number;
-    /** Fraction of the category slot the bars fill, `[0, 1]`; the rest separates groups. */
-    slotFill: number;
-    /** Gap in px between grouped bars within a slot; ignored when stacked. */
-    groupGap: number;
-    stroke: Stroke;
-    shadow: Shadow;
-}
-/** A {@link BarChart}'s full, resolved visual theme. */
-export interface BarChartConfig {
-    /** Cycled by series index; a series' own `fill` replaces its entry outright. */
-    seriesFills: Fill[];
-    bar: BarStyleConfig;
-    /** The category axis. */
-    xAxis: AxisConfig;
-    /** The value axis. */
-    yAxis: AxisConfig;
-    plotArea: PlotAreaConfig;
-    legend: LegendConfig;
-    /** The figure printed on each column. */
-    valueStyle: TextStyle;
-    /** How far everything outside a spotlit series or category fades. */
-    spotlight: {
-        dimOpacity: number;
-    };
-}
-/** The author's partial theme, deep-merged onto {@link DEFAULT_BAR_CHART_THEME}. */
-export type BarChartTheme = {
-    seriesFills?: Fill[];
-    bar?: Partial<BarStyleConfig>;
-    xAxis?: Partial<AxisConfig>;
-    yAxis?: Partial<AxisConfig>;
-    plotArea?: Partial<PlotAreaConfig>;
-    legend?: LegendTheme;
-    valueStyle?: TextStyle;
-    spotlight?: Partial<BarChartConfig["spotlight"]>;
+export declare function barValueExtent(data: DataRecord[], series: readonly BarSeries[], stack: BarStack, weights?: readonly number[]): Range;
+/** The explicit `range`, else the data's extent nudged to tidy bounds (a percent stack reads to 100); `divisions` (one fewer than the marker count) makes the drawn ticks land on them. */
+export declare function resolveBarScale(data: DataRecord[], series: readonly BarSeries[], stack: BarStack, range: Range | undefined, divisions: number, weights?: readonly number[]): Range;
+/** Black or white, whichever reads on `fill`: a figure printed inside a bar. */
+export declare function inkOn(fill: Fill): string;
+/** A bar chart's own look: how round and how wide the bars are. */
+export declare const BAR_MARKS: {
+    /** Radius of each bar's far corners; a stacked segment inside the stack stays square. */
+    barRadius: import("@motionscript/sdk").Type<number, number, false>;
+    /** How much of its category slot a bar group fills, the rest spacing the groups. */
+    barWidth: import("@motionscript/sdk").Type<number, number, false>;
+    /** Space between the bars of one group, side by side. */
+    barGap: import("@motionscript/sdk").Type<number, number, false>;
+};
+export declare const BAR_LABELS: {
+    /** Read as the chart is built: each bar's value past its end, inside it, or none. */
+    values: import("@motionscript/sdk").Type<"end" | "inside" | "none", "end" | "inside" | "none", false>;
 };
-export declare const DEFAULT_BAR_CHART_THEME: BarChartConfig;
-/** The `theme` entry's resolve: merges a partial {@link BarChartTheme} onto `previous` (first resolution: the default). */
-export declare function resolveBarChartTheme(theme: BarChartTheme | undefined, previous?: BarChartConfig): BarChartConfig;
-export declare function lerpBarChartTheme(from: BarChartConfig, to: BarChartConfig, t: number): BarChartConfig;
-/** Series `index`'s own `fill`, else the palette's entry. */
-export declare function resolveBarFill(palette: Fill[], series: BarSeries, index: number): Fill;
 //# sourceMappingURL=shared.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/bar-chart/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,MAAM,EAEX,KAAK,MAAM,EAEX,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAkBL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,KAAK,EACX,MAAM,eAAe,CAAA;AAEtB,+IAA+I;AAC/I,MAAM,MAAM,SAAS,GAAG,WAAW,CAAA;AAEnC;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,EAAE,OAAO,GACf,OAAO,EAAE,CASX;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAM1E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAAE,EAClB,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,EAAE,OAAO,GACf,KAAK,CAUP;AAED,4JAA4J;AAC5J,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAAE,EAClB,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,SAAS,EAAE,MAAM,GAChB,KAAK,CAMP;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,4FAA4F;IAC5F,YAAY,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAA;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,WAAW,EAAE,IAAI,EAAE,CAAA;IACnB,GAAG,EAAE,cAAc,CAAA;IACnB,yBAAyB;IACzB,KAAK,EAAE,UAAU,CAAA;IACjB,sBAAsB;IACtB,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,EAAE,cAAc,CAAA;IACxB,MAAM,EAAE,YAAY,CAAA;IACpB,yCAAyC;IACzC,UAAU,EAAE,SAAS,CAAA;IACrB,qEAAqE;IACrE,SAAS,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAClC;AAED,oFAAoF;AACpF,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,IAAI,EAAE,CAAA;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAA;CACjD,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,cAyBrC,CAAA;AAqCD,2HAA2H;AAC3H,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,QAAQ,CAAC,EAAE,cAAc,GACxB,cAAc,CAchB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,cAAc,EAClB,CAAC,EAAE,MAAM,GACR,cAAc,CAiBhB;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAC5B,OAAO,EAAE,IAAI,EAAE,EACf,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAIN"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/bar-chart/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE9E,OAAO,EAAwB,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAA;AAElF,+IAA+I;AAC/I,MAAM,MAAM,SAAS,GAAG,WAAW,CAAA;AAEnC,2FAA2F;AAC3F,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;AAErD,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,YAAY,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,OAAO,EAAE,CA6BnI;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAUpI;AAED,2LAA2L;AAC3L,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAAE,EAClB,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAC1B,KAAK,CAKP;AAED,gFAAgF;AAChF,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQxC;AAED,mEAAmE;AACnE,eAAO,MAAM,SAAS;IACpB,yFAAyF;;IAEzF,oFAAoF;;IAEpF,yDAAyD;;CAE1D,CAAA;AAED,eAAO,MAAM,UAAU;IACrB,qFAAqF;;CAEtF,CAAA"}