@motionscript/charts 0.1.0 → 0.1.1-alpha.0

package/dist/pie-chart/pie-legend.js

@@ -1,24 +1,13 @@
-import { Flow, Paint, Rect, Shapes, Text, Types, component2d, textOps, } from "@motionscript/sdk";
+import { Flow, Paint, Rect, Shapes, Text, Types, clamp, component2d, textOps, } from "@motionscript/sdk";
 import { fresh } from "../kit/entries.js";
 import { armed, arrival, arrivalOf, arrivalsEntry, beats, frameEase } from "../kit/motion.js";
-import { DEFAULT_LEGEND, clampUnit, } from "../kit/shared.js";
-/** How far an entry starts to the right of its slot when it enters, in px. */
+import { DEFAULT_LEGEND } from "../kit/shared.js";
 const SLIDE = 16;
 /**
- * The legend of a {@link PieChart}: a **vertical-flow column** of entries, one per
- * slice, each pairing the slice's caption with its colour swatch.
- *
- * A column rather than the cartesian charts' row, because it sits *beside* the
- * ring rather than beneath the plot — a pie is as tall as it is wide, so the
- * space it leaves over is a vertical strip. It is otherwise the same entry: the
- * swatch carries the colour, the caption reads in the legend's neutral ink, and
- * both take the shared {@link LegendConfig}.
- *
- * There is no show/hide here. A pie's marks are its *rows*, and a row that
- * shouldn't be in the chart shouldn't be in the table — removing one would
- * silently re-cut every other wedge's share, which is a different chart rather
- * than the same chart with something hidden. Selection is what a pie has
- * instead, and it arrives through {@link PieLegendProps.dims}.
+ * The legend of a {@link PieChart}: a column (it sits beside the ring, in the
+ * vertical strip it leaves) of caption-and-swatch entries, one per slice. No
+ * show/hide: removing a row would re-cut every other wedge's share. Selection
+ * arrives through `dims`.
  */
 export const PieLegend = component2d({
     key: "pieLegend",
@@ -26,13 +15,14 @@ export const PieLegend = component2d({
         ...Paint.state,
         ...Flow.state,
         ...Shapes.corners,
+        /** One entry per slice, in ring order. */
         slices: fresh(() => []),
         legend: Types.custom(DEFAULT_LEGEND),
+        /** Per-slice opacity multiplier, the signal that dims the ring, so an entry fades in step with its wedge. Missing reads as 1. */
         dims: fresh(() => []),
         arrivals: arrivalsEntry(),
     },
-    // A column, for the reason `ChartLegend` gives for its row: a `Rect` given no
-    // flow lays its children out `freeform`, every caption on top of the last.
+    // The flow must be stated: a `Rect` with none lays children out `freeform`, every caption on top of the last.
     defaults: {
         flow: "vertical",
         align: "centerLeft",
@@ -41,17 +31,14 @@ export const PieLegend = component2d({
         gap: (state) => state.legend.itemGap / 3,
         padding: (state) => state.legend.padding,
     },
-    // One entry per slice, ordered top → bottom. The selection dim rides a wrapper
-    // rather than the entry itself, so the entrance can animate the entry's own
-    // opacity without the two fighting over one value — opacity multiplies down
-    // the tree, which is exactly the composition wanted here.
+    // The selection dim rides a wrapper, so the entrance animates the entry's own opacity without the two fighting over one value.
     children: (state) => {
         const marker = state.legend.markerStyle;
         return state.slices.map((_, index) => Rect({
             width: "hug",
             height: "hug",
             flow: "freeform",
-            opacity: () => clampUnit(state.dims[index] ?? 1),
+            opacity: () => clamp(state.dims[index] ?? 1, 0, 1),
             children: [
                 Rect({
                     flow: "horizontal",
@@ -81,28 +68,16 @@ export const PieLegend = component2d({
     },
     commands: {
         ...Paint.commands,
-        /**
-         * Every entry at its pre-entrance state, shifted right and transparent: what
-         * a chart shows ahead of this legend's own beat in its entrance, since
-         * `enter` arms the entries only on its first frame.
-         */
+        /** Every entry shifted right and transparent: what a chart shows ahead of this legend's beat, since `enter` arms only on its first frame. */
         arm: (timeline, state) => timeline.animate(() => ({ arrivals: armed([...state.slices.keys()], { opacity: 0, shift: SLIDE }) })),
-        /**
-         * Slide + fade every entry in from the right, staggered top-to-bottom. Its
-         * first frame arms them all: shifted right and transparent.
-         *
-         * The timeline's duration is the **whole** entrance: the stagger is carved
-         * out of it rather than added on top, so the command takes exactly the time
-         * the timeline laid out for it.
-         */
+        /** Slide and fade entries in from the right, top to bottom. The duration is the whole entrance, the stagger carved out of it. */
         enter: (timeline, state) => {
             const count = state.slices.length;
             if (count === 0)
                 return timeline.wait(timeline.duration);
             const from = { opacity: 0, shift: SLIDE };
             const arm = timeline.animate(() => ({ arrivals: armed([...state.slices.keys()], from) }));
-            // Each gap is a fifth of an entry's own move, the rhythm the axes use;
-            // solved for from the budget rather than added to it.
+            // Each gap is a fifth of an entry's move, the axes' rhythm, solved from the budget.
             const per = timeline.duration / (1 + Math.max(0, count - 1) / 5);
             const step = per / 5;
             const ease = frameEase(timeline);

package/dist/pie-chart/pie-legend.js.map

@@ -1 +1 @@
-{"version":3,"file":"pie-legend.js","sourceRoot":"","sources":["../../src/pie-chart/pie-legend.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Flow,\n  Paint,\n  Rect,\n  Shapes,\n  Text,\n  Types,\n  component2d,\n  textOps,\n  type NodeOf,\n  type RectProps,\n  // Named so the column's emitted type reaches the Rect surface it spreads through the sdk, not core.\n  type Alignment as _Alignment,\n  type CornerRadiusResolved as _CornerRadiusResolved,\n  type CornerStyleResolved as _CornerStyleResolved,\n  type Fill as _Fill,\n  type FillResolved as _FillResolved,\n  type FlowMode as _FlowMode,\n  type FlowResolved as _FlowResolved,\n  type GapSize as _GapSize,\n  type Node2D as _Node2D,\n  type Node2DProps as _Node2DProps,\n  type RectCornerRadius as _RectCornerRadius,\n  type RectCornerStyle as _RectCornerStyle,\n  type Shadow as _Shadow,\n  type ShadowResolved as _ShadowResolved,\n  type Stroke as _Stroke,\n  type StrokeResolved as _StrokeResolved,\n  type Vector2 as _Vector2,\n} from \"@motionscript/sdk\"\n\nimport { fresh } from \"../kit/entries\"\nimport { armed, arrival, arrivalOf, arrivalsEntry, beats, frameEase, type Arrival } from \"../kit/motion\"\nimport {\n  DEFAULT_LEGEND,\n  clampUnit,\n  type LegendConfig,\n} from \"../kit/shared\"\nimport type { PieSlice } from \"./shared\"\n\nexport interface PieLegendProps extends RectProps {\n  /** One entry per slice, in ring order. */\n  slices: PieSlice[]\n  /** Padding, caption style, gaps, and swatch geometry — see {@link LegendConfig}. */\n  legend: LegendConfig\n  /**\n   * Per-slice opacity multiplier, by index — the same signal that dims the ring,\n   * so an entry fades in step with the wedge it names. Missing entries read as 1.\n   */\n  dims: number[]\n}\n\n/** How far an entry starts to the right of its slot when it enters, in px. */\nconst SLIDE = 16\n\n/**\n * The legend of a {@link PieChart}: a **vertical-flow column** of entries, one per\n * slice, each pairing the slice's caption with its colour swatch.\n *\n * A column rather than the cartesian charts' row, because it sits *beside* the\n * ring rather than beneath the plot — a pie is as tall as it is wide, so the\n * space it leaves over is a vertical strip. It is otherwise the same entry: the\n * swatch carries the colour, the caption reads in the legend's neutral ink, and\n * both take the shared {@link LegendConfig}.\n *\n * There is no show/hide here. A pie's marks are its *rows*, and a row that\n * shouldn't be in the chart shouldn't be in the table — removing one would\n * silently re-cut every other wedge's share, which is a different chart rather\n * than the same chart with something hidden. Selection is what a pie has\n * instead, and it arrives through {@link PieLegendProps.dims}.\n */\nexport const PieLegend = component2d({\n  key: \"pieLegend\",\n  state: {\n    ...Paint.state,\n    ...Flow.state,\n    ...Shapes.corners,\n    slices: fresh<PieSlice[]>(() => []),\n    legend: Types.custom<LegendConfig>(DEFAULT_LEGEND),\n    dims: fresh<number[]>(() => []),\n    arrivals: arrivalsEntry(),\n  },\n  // A column, for the reason `ChartLegend` gives for its row: a `Rect` given no\n  // flow lays its children out `freeform`, every caption on top of the last.\n  defaults: {\n    flow: \"vertical\",\n    align: \"centerLeft\",\n    width: \"hug\",\n    height: \"hug\",\n    gap: (state) => state.legend.itemGap / 3,\n    padding: (state) => state.legend.padding,\n  },\n  // One entry per slice, ordered top → bottom. The selection dim rides a wrapper\n  // rather than the entry itself, so the entrance can animate the entry's own\n  // opacity without the two fighting over one value — opacity multiplies down\n  // the tree, which is exactly the composition wanted here.\n  children: (state) => {\n    const marker = state.legend.markerStyle\n    return state.slices.map((_, index) =>\n      Rect({\n        width: \"hug\",\n        height: \"hug\",\n        flow: \"freeform\",\n        opacity: () => clampUnit(state.dims[index] ?? 1),\n        children: [\n          Rect({\n            flow: \"horizontal\",\n            gap: 12,\n            align: \"center\",\n            width: \"hug\",\n            height: \"hug\",\n            opacity: () => arrivalOf(state.arrivals, index).opacity,\n            x: () => arrivalOf(state.arrivals, index).shift,\n            children: [\n              Rect({\n                width: marker.height,\n                height: marker.height,\n                cornerRadius: marker.borderRadius,\n                fill: () => state.slices[index]?.fill ?? \"white\",\n                stroke: marker.stroke,\n                shadow: marker.shadow,\n              }),\n              Text({\n                ...textOps.styleProps(state.legend.textStyle),\n                text: () => state.slices[index]?.category ?? \"\",\n              }),\n            ],\n          }),\n        ],\n      })\n    )\n  },\n  commands: {\n    ...Paint.commands,\n    /**\n     * Every entry at its pre-entrance state, shifted right and transparent: what\n     * a chart shows ahead of this legend's own beat in its entrance, since\n     * `enter` arms the entries only on its first frame.\n     */\n    arm: (timeline, state) =>\n      timeline.animate(() => ({ arrivals: armed([...state.slices.keys()], { opacity: 0, shift: SLIDE }) })),\n    /**\n     * Slide + fade every entry in from the right, staggered top-to-bottom. Its\n     * first frame arms them all: shifted right and transparent.\n     *\n     * The timeline's duration is the **whole** entrance: the stagger is carved\n     * out of it rather than added on top, so the command takes exactly the time\n     * the timeline laid out for it.\n     */\n    enter: (timeline, state) => {\n      const count = state.slices.length\n      if (count === 0) return timeline.wait(timeline.duration)\n      const from: Arrival = { opacity: 0, shift: SLIDE }\n      const arm = timeline.animate(() => ({ arrivals: armed([...state.slices.keys()], from) }))\n      // Each gap is a fifth of an entry's own move, the rhythm the axes use;\n      // solved for from the budget rather than added to it.\n      const per = timeline.duration / (1 + Math.max(0, count - 1) / 5)\n      const step = per / 5\n      const ease = frameEase(timeline)\n      const entries = state.slices.map((_, i) => ({ at: i * step, duration: per, piece: arrival(timeline, i, from, ease) }))\n      return timeline.together([arm, beats(timeline, entries)])\n    },\n  },\n  measure: (measurer, state, children) => Flow.measure(measurer, state, children, Paint.inset(state)),\n  layout: (box, state, children) => Flow.layout(box, state, children, Paint.inset(state)),\n  render: (ctx, state) => Paint.draw(ctx, state, Shapes.rect(ctx.size, state)),\n})\n\nexport type PieLegend = NodeOf<typeof PieLegend>\n"]}
+{"version":3,"file":"pie-legend.js","sourceRoot":"","sources":["../../src/pie-chart/pie-legend.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Flow,\n  Paint,\n  Rect,\n  Shapes,\n  Text,\n  Types,\n  clamp,\n  component2d,\n  textOps,\n  type NodeOf,\n  // Named so the column's emitted type reaches the Rect surface it spreads through the sdk, not core.\n  type Alignment as _Alignment,\n  type CornerRadiusResolved as _CornerRadiusResolved,\n  type CornerStyleResolved as _CornerStyleResolved,\n  type Fill as _Fill,\n  type FillResolved as _FillResolved,\n  type FlowMode as _FlowMode,\n  type FlowResolved as _FlowResolved,\n  type GapSize as _GapSize,\n  type Node2D as _Node2D,\n  type Node2DProps as _Node2DProps,\n  type RectCornerRadius as _RectCornerRadius,\n  type RectCornerStyle as _RectCornerStyle,\n  type Shadow as _Shadow,\n  type ShadowResolved as _ShadowResolved,\n  type Stroke as _Stroke,\n  type StrokeResolved as _StrokeResolved,\n  type Vector2 as _Vector2,\n} from \"@motionscript/sdk\"\n\nimport { fresh } from \"../kit/entries\"\nimport { armed, arrival, arrivalOf, arrivalsEntry, beats, frameEase, type Arrival } from \"../kit/motion\"\nimport { DEFAULT_LEGEND, type LegendConfig } from \"../kit/shared\"\nimport type { PieSlice } from \"./shared\"\n\nconst SLIDE = 16\n\n/**\n * The legend of a {@link PieChart}: a column (it sits beside the ring, in the\n * vertical strip it leaves) of caption-and-swatch entries, one per slice. No\n * show/hide: removing a row would re-cut every other wedge's share. Selection\n * arrives through `dims`.\n */\nexport const PieLegend = component2d({\n  key: \"pieLegend\",\n  state: {\n    ...Paint.state,\n    ...Flow.state,\n    ...Shapes.corners,\n    /** One entry per slice, in ring order. */\n    slices: fresh<PieSlice[]>(() => []),\n    legend: Types.custom<LegendConfig>(DEFAULT_LEGEND),\n    /** Per-slice opacity multiplier, the signal that dims the ring, so an entry fades in step with its wedge. Missing reads as 1. */\n    dims: fresh<number[]>(() => []),\n    arrivals: arrivalsEntry(),\n  },\n  // The flow must be stated: a `Rect` with none lays children out `freeform`, every caption on top of the last.\n  defaults: {\n    flow: \"vertical\",\n    align: \"centerLeft\",\n    width: \"hug\",\n    height: \"hug\",\n    gap: (state) => state.legend.itemGap / 3,\n    padding: (state) => state.legend.padding,\n  },\n  // The selection dim rides a wrapper, so the entrance animates the entry's own opacity without the two fighting over one value.\n  children: (state) => {\n    const marker = state.legend.markerStyle\n    return state.slices.map((_, index) =>\n      Rect({\n        width: \"hug\",\n        height: \"hug\",\n        flow: \"freeform\",\n        opacity: () => clamp(state.dims[index] ?? 1, 0, 1),\n        children: [\n          Rect({\n            flow: \"horizontal\",\n            gap: 12,\n            align: \"center\",\n            width: \"hug\",\n            height: \"hug\",\n            opacity: () => arrivalOf(state.arrivals, index).opacity,\n            x: () => arrivalOf(state.arrivals, index).shift,\n            children: [\n              Rect({\n                width: marker.height,\n                height: marker.height,\n                cornerRadius: marker.borderRadius,\n                fill: () => state.slices[index]?.fill ?? \"white\",\n                stroke: marker.stroke,\n                shadow: marker.shadow,\n              }),\n              Text({\n                ...textOps.styleProps(state.legend.textStyle),\n                text: () => state.slices[index]?.category ?? \"\",\n              }),\n            ],\n          }),\n        ],\n      })\n    )\n  },\n  commands: {\n    ...Paint.commands,\n    /** Every entry shifted right and transparent: what a chart shows ahead of this legend's beat, since `enter` arms only on its first frame. */\n    arm: (timeline, state) =>\n      timeline.animate(() => ({ arrivals: armed([...state.slices.keys()], { opacity: 0, shift: SLIDE }) })),\n    /** Slide and fade entries in from the right, top to bottom. The duration is the whole entrance, the stagger carved out of it. */\n    enter: (timeline, state) => {\n      const count = state.slices.length\n      if (count === 0) return timeline.wait(timeline.duration)\n      const from: Arrival = { opacity: 0, shift: SLIDE }\n      const arm = timeline.animate(() => ({ arrivals: armed([...state.slices.keys()], from) }))\n      // Each gap is a fifth of an entry's move, the axes' rhythm, solved from the budget.\n      const per = timeline.duration / (1 + Math.max(0, count - 1) / 5)\n      const step = per / 5\n      const ease = frameEase(timeline)\n      const entries = state.slices.map((_, i) => ({ at: i * step, duration: per, piece: arrival(timeline, i, from, ease) }))\n      return timeline.together([arm, beats(timeline, entries)])\n    },\n  },\n  measure: (measurer, state, children) => Flow.measure(measurer, state, children, Paint.inset(state)),\n  layout: (box, state, children) => Flow.layout(box, state, children, Paint.inset(state)),\n  render: (ctx, state) => Paint.draw(ctx, state, Shapes.rect(ctx.size, state)),\n})\n\nexport type PieLegend = NodeOf<typeof PieLegend>\n"]}

package/dist/pie-chart/pie-ring.d.ts

@@ -1,69 +1,14 @@
-import { type FillResolved, type NodeOf, type Node2D, type Node2DProps, type Vector2 } from "@motionscript/sdk";
+import { type FillResolved, type NodeOf, type Node2D, type Node2DProps as _Node2DProps, type Vector2 } from "@motionscript/sdk";
 import { type CenterConfig, type LabelConfig, type PieArc, type PieLabelMode, type PieLabelPlacement, type PieSlice, type RingConfig } from "./shared.js";
-export interface PieRingProps extends Node2DProps {
-    /** One entry per slice: its `category`, `value` and `fill`. */
-    slices: PieSlice[];
-    /** Ring geometry and paint — gap, hole, start angle, selection growth. */
-    ring: RingConfig;
-    /** How the labels are set, and the leader lines that point at them. */
-    label: LabelConfig;
-    /**
-     * How the hole's summary is set.
-     *
-     * Named `centerStyle` rather than `center` because every node already has a
-     * `center` — the anchor its position is measured from.
-     */
-    centerStyle: CenterConfig;
-    /** What the labels say, or `"none"` to drop them entirely. */
-    labelMode: PieLabelMode;
-    /** Where the labels sit: inside their wedge, outside on a leader, or nowhere. */
-    labelPlacement: PieLabelPlacement;
-    /**
-     * Sweep of the ring in `[0, 1]`: 0 draws nothing, 1 the full circle. The
-     * wedges grow around clockwise from the ring's `startAngle` as this rises.
-     */
-    growth: number;
-    /**
-     * Fade of the leader lines and labels in `[0, 1]`, held separate from
-     * {@link growth} so they arrive *after* the ring has swept in.
-     */
-    labelReveal: number;
-    /**
-     * How far each slice is currently pushed out of the ring, `0`–`1` per index.
-     * Owned by the chart, so the ring and the legend read one signal.
-     */
-    pops: number[];
-    /** Opacity everything *unselected* falls back to while any slice is selected. */
-    dimOpacity: number;
-    /**
-     * Text set in the middle of the ring's hole — the largest uninterrupted area
-     * the chart owns, and on a donut otherwise empty. A one-line summary there
-     * routinely does more work than the whole ring around it. Empty (the default)
-     * leaves the hole clear; ignored when there is no hole.
-     */
-    centerLabel: string;
-    /** Smaller second line under {@link centerLabel}. Empty (the default) drops it. */
-    centerCaption: string;
-    /**
-     * Fade of the hole's summary in `[0, 1]`. Its own signal, untouched by the
-     * ring's entrance — a hole label is usually a *conclusion*, so a scene that
-     * wants it to land on a later beat sets this to 0 and calls
-     * `PieChart.revealCenter` when it gets there.
-     */
-    centerReveal: number;
-}
-/** Where one slice's label sits and the polyline that points at it. */
 interface LabelPlacement {
-    /** Index of the slice. */
     index: number;
-    /** Which side of the ring the label sits on: +1 right, −1 left. */
+    /** +1 right, -1 left. */
     side: 1 | -1;
-    /** Leader polyline: wedge edge → elbow → label. */
+    /** Wedge edge, elbow, label. */
     leader: Vector2[];
-    /** Point the label's inner edge is pinned to. */
+    /** Where the label's inner edge is pinned. */
     text: Vector2;
 }
-/** What the ring's geometry reads off its entries. */
 interface RingState {
     readonly slices: PieSlice[];
     readonly ring: RingConfig;
@@ -76,12 +21,7 @@ interface RingState {
     readonly centerLabel: string;
     readonly centerCaption: string;
 }
-/**
- * The ring's geometry for one box: every radius, gutter and label position,
- * derived from the entries and the size the ring was laid out at, and asked
- * afresh wherever it is read — the drawing, and the labels' bound positions
- * and sizes alike, so the two cannot disagree.
- */
+/** Every radius, gutter and label position for one box, derived afresh wherever read so the drawing and the labels' bound positions cannot disagree. */
 export declare class RingGeometry {
     private readonly s;
     private readonly box;
@@ -89,164 +29,64 @@ export declare class RingGeometry {
         readonly width: number;
         readonly height: number;
     });
-    /** The drawn slices' angular spans, re-read every frame so a value tween re-cuts them. */
+    /** Re-read every frame so a value tween re-cuts them. */
     get arcs(): PieArc[];
-    /** Whether any slice is labelled on a leader — the only thing that costs a gutter. */
+    /** Leader labels are the only thing that costs a gutter. */
     get hasLeaderLabels(): boolean;
     /**
-     * How wide a horizontal label centred in slice `arc`'s band can run before it
-     * leaves the wedge, in px.
-     *
-     * Two things bound it, and which one binds depends entirely on where the wedge
-     * sits. Stepping sideways from the label's centre moves you *radially* by
-     * `dx·sin(mid)` and *tangentially* by `dx·cos(mid)`, so a wedge at 3 o'clock is
-     * limited by the band's thickness (its label runs straight across the band)
-     * while a wedge at 12 o'clock is limited by its own arc (its label runs along
-     * the band, which is much roomier). Taking the smaller of the two is what stops
-     * a label overflowing the ring on one chart and being pointlessly shrunk on the
-     * next.
-     *
-     * Measured off the *unpopped* radius, so a slice growing out of the ring
-     * doesn't resize its own text mid-animation.
+     * Px a horizontal label centred in `arc`'s band can run before leaving the
+     * wedge: bound by the band's thickness near 3 o'clock, by its arc near 12.
+     * Measured off the unpopped radius, so a slice growing out of the ring does not
+     * resize its own text mid-animation.
      */
     insideRoom(arc: PieArc): number;
     /** Widest line, in glyphs at the leading line's size, an inside label runs to. */
     insideGlyphs(arc: PieArc): number;
-    /**
-     * Font size of an inside label's leading line: what the theme asked for,
-     * shrunk if that wouldn't fit inside its wedge. **One size across every inside
-     * label** — the smallest any of them needs — because labels at mismatched
-     * sizes read as a mistake rather than as emphasis.
-     *
-     * So the theme's `insideStyle.fontSize` is an upper bound, not a promise: ask
-     * for the size the chart wants and the ring keeps it legal.
-     */
+    /** The theme's `insideStyle.fontSize` shrunk to fit, an upper bound. One size across every inside label (the smallest any needs): mismatched sizes read as a mistake. */
     get insideFont(): number;
-    /**
-     * Font size of the hole's summary: the configured size, capped so it still
-     * fits across the hole. The cap matters because the hole's radius derives from
-     * the box, so a chart that reflows smaller would otherwise push its summary out
-     * through the ring.
-     */
+    /** The configured size capped to fit across the hole, which derives from the box: a smaller reflow would otherwise push the summary through the ring. */
     get centerFont(): number;
-    /** Rim radius of a fully selected slice as a multiple of the ring's, clamped sane. */
+    /** Rim radius of a fully selected slice as a multiple of the ring's. */
     get growFactor(): number;
-    /** How far past the ring's rim a fully selected slice reaches, in px. */
     get maxPop(): number;
-    /** Height of one **leader** label block, in px — the unit those columns are spaced by. */
+    /** Height of one leader label block, the unit the columns are spaced by. Inside labels cost no vertical reserve. */
     get labelRowHeight(): number;
-    /** Widest line, in glyphs, that a leader label for slice `index` can run to. */
+    /** Widest line in glyphs a leader label for slice `index` runs to. */
     captionGlyphs(index: number): number;
-    /**
-     * Horizontal room reserved on each side for the leaders and their labels, in
-     * px — measured **per side**, from the slices that actually leader out that
-     * way. A ring whose labels are all inside reserves nothing and draws bigger.
-     *
-     * Excludes the ring's own selection-growth allowance, which scales with the
-     * radius and so is divided out in {@link outerRadius} instead.
-     */
+    /** Room reserved per side for leaders and labels, from the slices that leader out that way. Excludes selection growth, which scales with the radius and is divided out in {@link outerRadius}. */
     get labelGutters(): {
         left: number;
         right: number;
     };
-    /**
-     * How far the ring's centre sits from the node's, in px. Zero while the
-     * gutters match; when the labels all fall one way it slides the ring into the
-     * empty half so the ring-plus-labels group stays centred in the box instead of
-     * the ring sitting dead centre with a bald patch beside it.
-     */
+    /** Slides the ring into the empty half when labels all fall one way, keeping the ring-plus-labels group centred. */
     get centerX(): number;
-    /**
-     * Radius of the ring's outer edge, fitted to whatever the label gutters leave.
-     * A fully selected slice reaches `radius × growFactor`, so the room has to
-     * cover that — hence the divisor, which keeps even the grown slice inside the
-     * box (and holds the ring the same size whether or not anything is selected).
-     */
+    /** Fitted to what the gutters leave. The divisor keeps a fully selected slice (`radius * growFactor`) inside the box, and the ring one size whether or not anything is selected. */
     get outerRadius(): number;
-    /** Radius of the hole in the middle: a fraction of the outer radius, or explicit px. */
     get holeRadius(): number;
-    /** Radius of the circle every leader elbows on, clear of even a popped-out slice. */
+    /** The circle every leader elbows on, clear of even a popped-out slice. */
     get elbowRadius(): number;
-    /** How far slice `index` is currently pushed out, in `[0, 1]`. */
     popOf(index: number): number;
-    /** Radius of slice `index`'s outer edge, its selection growth included. */
     anchorRadius(index: number): number;
-    /**
-     * Radius an inside label sits at on slice `index`: halfway across the band on a
-     * donut, and further out than halfway on a solid pie, where "halfway" would
-     * crowd the point every wedge converges on. Rides the slice's own pop, so an
-     * inside label travels out with the wedge it belongs to.
-     */
+    /** Halfway across the band on a donut, further out on a solid pie, where halfway would crowd the point the wedges converge on. Rides the slice's pop. */
     bandMidRadius(index: number): number;
-    /** The point slice `index`'s inside label is centred on. */
     insideAnchor(index: number): Vector2;
-    /**
-     * How selected the ring is overall, in `[0, 1]` — the most-grown slice. Rides
-     * the same tween the pops do, so the dim below arrives with the growth rather
-     * than needing an animation of its own.
-     */
+    /** The most-grown slice, so the dim in {@link sliceOpacity} rides the pops' tween. */
     get selectionStrength(): number;
-    /**
-     * Opacity slice `index` (and its leader and label) is drawn at: full while
-     * nothing is selected, falling toward `dimOpacity` in proportion to how
-     * selected the *rest* of the ring is. A slice that's selected itself stays at
-     * full — the two factors cancel.
-     */
+    /** Opacity of slice `index` with its leader and label. */
     sliceOpacity(index: number): number;
-    /** Slice `index`'s share of the ring as its label reads it, off the live values. */
     percentText(index: number): string;
-    /**
-     * Where every leader label sits and how its leader gets there. Labels are split
-     * into a right and a left column by their slice's bisector, each column is
-     * spread so nothing overlaps (and nothing leaves the box), and each leader is
-     * then built as wedge edge → elbow → label. The elbow rides the leader circle at
-     * the label's *settled* y, which keeps the final run horizontal and the whole
-     * polyline outside the ring however far the label was nudged.
-     */
+    /** Labels split into left and right columns by their slice's bisector, each spread so nothing overlaps or leaves the box, then a leader built to each. */
     placements(): LabelPlacement[];
-    /** This frame's placement for slice `index`, or `undefined` if it isn't leadered. */
     placementFor(index: number): LabelPlacement | undefined;
 }
-/** Each slice's fill, resolved. */
 export declare function ringFills(slices: readonly PieSlice[]): FillResolved[][];
 /**
- * The ring itself: one wedge per {@link PieSlice}, sized by its share of the
- * total, swept clockwise from the theme's `startAngle` with a `gap` of clear
- * space between neighbours — a *constant-width* channel, the same at the hole as
- * at the rim (see {@link wedgePath}). A **selected** slice reaches further out
- * while its hole edge stays put — so it reads as that band swelling out of the
- * ring rather than breaking off it — and the rest of the ring dims behind it,
- * leaders and labels included.
- *
- * This is the only part of the chart family that draws a path: the wedges are
- * filled {@link PathBuilder} polygons approximating each arc, and the leaders are
- * stroked polylines — both in the node's centred, y-up space, so neither depends
- * on SVG arc-sweep conventions. The **labels are real {@link Text} nodes**
- * (stacked in a hug vertical flow and pinned by their inner edge), so no
- * glyph-width guesswork decides where a caption starts.
- *
- * ### Label placement
- * Each label sits either **inside** its wedge or **outside** on a leader.
- *
- * An inside label is centred on its slice's band and leads with the number, the
- * caption set small underneath — inside a wedge the reader already knows which
- * slice they're on, so the magnitude is the thing being read. It costs no gutter
- * and no eye round-trip, so a ring labelled that way draws considerably bigger in
- * the same box.
- *
- * A leader label sits outside on the end of a polyline that lifts off its wedge,
- * elbows, and runs horizontally into the text. Labels are split into a left and a
- * right column by which way their slice's bisector points, and each column is
- * de-conflicted independently (see {@link relaxLabels}): a label takes the spot
- * nearest its wedge that still clears its neighbour, and the column is squeezed
- * to fit the node's height rather than spilling out of it. The elbow then rides on
- * a circle just outside the ring **at the label's settled y**, so the run into the
- * text is always horizontal and a nudged label never drags its leader back across
- * the ring.
- *
- * Only the sides that actually carry a leader reserve a gutter, and the ring's
- * centre slides into whatever the other side left over — so a ring whose slices
- * all leader one way doesn't leave a bald patch on the other.
+ * The ring: one wedge per {@link PieSlice} swept clockwise from `startAngle`,
+ * with a constant-width `gap` (see {@link wedgePath}). A selected slice swells
+ * out while its hole edge stays put, and the rest dims, leaders and labels
+ * included. The only path-drawing part of the chart family; labels are real
+ * {@link Text} nodes, so no glyph-width guesswork places a caption. Only the
+ * sides that carry a leader reserve a gutter, and the ring slides into the rest.
  */
 export declare const PieRing: import("@motionscript/sdk").Component<"pieRing", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
     readonly slices: import("@motionscript/sdk").Type<PieSlice[], PieSlice[], false>;
@@ -255,30 +95,42 @@ export declare const PieRing: import("@motionscript/sdk").Component<"pieRing", i
     readonly centerStyle: import("@motionscript/sdk").Type<CenterConfig, CenterConfig, false>;
     readonly labelMode: import("@motionscript/sdk").Type<PieLabelMode, PieLabelMode, false>;
     readonly labelPlacement: import("@motionscript/sdk").Type<PieLabelPlacement, PieLabelPlacement, false>;
+    /** Sweep `[0, 1]`: the wedges grow clockwise from `startAngle` as it rises. */
     readonly growth: 1;
+    /** Fade of leaders and labels, separate from `growth` so they arrive after the sweep. */
     readonly labelReveal: 1;
+    /** Per-slice pop `[0, 1]`, owned by the chart so the ring and legend read one signal. */
     readonly pops: import("@motionscript/sdk").Type<number[], number[], false>;
+    /** Opacity everything unselected falls back to while any slice is selected. */
     readonly dimOpacity: number;
+    /** Empty leaves the hole clear; ignored when there is no hole. */
     readonly centerLabel: "";
     readonly centerCaption: "";
+    /** The hole's summary fade, untouched by the entrance: a scene that wants the conclusion on a later beat sets 0 and calls `revealCenter`. */
     readonly centerReveal: 1;
 }>, {
     readonly sweep: unknown;
     readonly revealLabels: unknown;
     readonly revealCenter: unknown;
-}, null, Node2D<Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+}, null, Node2D<_Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
     readonly slices: import("@motionscript/sdk").Type<PieSlice[], PieSlice[], false>;
     readonly ring: import("@motionscript/sdk").Type<RingConfig, RingConfig, false>;
     readonly label: import("@motionscript/sdk").Type<LabelConfig, LabelConfig, false>;
     readonly centerStyle: import("@motionscript/sdk").Type<CenterConfig, CenterConfig, false>;
     readonly labelMode: import("@motionscript/sdk").Type<PieLabelMode, PieLabelMode, false>;
     readonly labelPlacement: import("@motionscript/sdk").Type<PieLabelPlacement, PieLabelPlacement, false>;
+    /** Sweep `[0, 1]`: the wedges grow clockwise from `startAngle` as it rises. */
     readonly growth: 1;
+    /** Fade of leaders and labels, separate from `growth` so they arrive after the sweep. */
     readonly labelReveal: 1;
+    /** Per-slice pop `[0, 1]`, owned by the chart so the ring and legend read one signal. */
     readonly pops: import("@motionscript/sdk").Type<number[], number[], false>;
+    /** Opacity everything unselected falls back to while any slice is selected. */
     readonly dimOpacity: number;
+    /** Empty leaves the hole clear; ignored when there is no hole. */
     readonly centerLabel: "";
     readonly centerCaption: "";
+    /** The hole's summary fade, untouched by the entrance: a scene that wants the conclusion on a later beat sets 0 and calls `revealCenter`. */
     readonly centerReveal: 1;
 }>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
     readonly slices: import("@motionscript/sdk").Type<PieSlice[], PieSlice[], false>;
@@ -287,18 +139,24 @@ export declare const PieRing: import("@motionscript/sdk").Component<"pieRing", i
     readonly centerStyle: import("@motionscript/sdk").Type<CenterConfig, CenterConfig, false>;
     readonly labelMode: import("@motionscript/sdk").Type<PieLabelMode, PieLabelMode, false>;
     readonly labelPlacement: import("@motionscript/sdk").Type<PieLabelPlacement, PieLabelPlacement, false>;
+    /** Sweep `[0, 1]`: the wedges grow clockwise from `startAngle` as it rises. */
     readonly growth: 1;
+    /** Fade of leaders and labels, separate from `growth` so they arrive after the sweep. */
     readonly labelReveal: 1;
+    /** Per-slice pop `[0, 1]`, owned by the chart so the ring and legend read one signal. */
     readonly pops: import("@motionscript/sdk").Type<number[], number[], false>;
+    /** Opacity everything unselected falls back to while any slice is selected. */
     readonly dimOpacity: number;
+    /** Empty leaves the hole clear; ignored when there is no hole. */
     readonly centerLabel: "";
     readonly centerCaption: "";
+    /** The hole's summary fade, untouched by the entrance: a scene that wants the conclusion on a later beat sets 0 and calls `revealCenter`. */
     readonly centerReveal: 1;
 }>, {
     readonly sweep: unknown;
     readonly revealLabels: unknown;
     readonly revealCenter: unknown;
-}, Node2D<Node2DProps>>>>;
+}, Node2D<_Node2DProps>>>>;
 export type PieRing = NodeOf<typeof PieRing>;
 export {};
 //# sourceMappingURL=pie-ring.d.ts.map

package/dist/pie-chart/pie-ring.d.ts.map

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