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

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

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/pie-chart/shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Types and pure helpers specific to the {@link PieChart} family: how rows\r\n * become slices, how slices become arcs on a ring, where the labels around it\r\n * end up, and the theme all of that is drawn from.\r\n *\r\n * The one chart in the family that draws **one mark per row** rather than one\r\n * per column, which is why almost nothing about its geometry is shared: there is\r\n * no scale, no axis and no baseline, only a circle divided by share. What it\r\n * *does* share — the legend, the theme leaf resolvers, the palette, the\r\n * percentage format — comes from `../kit/shared.ts`.\r\n *\r\n * Kept renderer-agnostic (no `Node` imports) so a host's inspector mapping\r\n * can build a partial {@link PieChartTheme} without\r\n * pulling the node classes in.\r\n */\r\n\r\nimport {\r\n  lerpNumber,\r\n  shadowOps,\r\n  strokeOps,\r\n  textOps,\r\n  type DataRecord,\r\n  type Fill,\r\n  type Shadow,\r\n  type ShadowResolved,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n  type TextStyle,\r\n  type Vector2,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport {\r\n  CHART_PALETTE,\r\n  DEFAULT_LEGEND,\r\n  DEFAULT_SERIES_FILLS,\r\n  SPOTLIGHT_DIM,\r\n  lerpLegendConfig,\r\n  lerpSeriesFills,\r\n  num,\r\n  resolveLegendConfig,\r\n  resolveSeriesFills,\r\n  text,\r\n  type LegendConfig,\r\n  type LegendTheme,\r\n} from \"../kit/shared\"\r\n\r\n/**\r\n * One **resolved** slice of a {@link PieChart}: its caption, its magnitude, and\r\n * the paint its wedge and legend swatch take.\r\n *\r\n * This is what the ring and the legend consume, not what a scene authors: the\r\n * chart takes tabular `data` plus two field names and resolves it into these, so\r\n * the parts stay unaware of where a slice's caption, magnitude and paint came\r\n * from.\r\n */\r\nexport interface PieSlice {\r\n  /** Legend caption and label text for this slice. */\r\n  category: string\r\n  /** This slice's magnitude. Its wedge covers `value / (sum of all values)`. */\r\n  value: number\r\n  /** Wedge and swatch paint. */\r\n  fill: Fill\r\n}\r\n\r\n/**\r\n * Resolve tabular rows into slices: one per row, captioned by the `category`\r\n * column, sized by the `value` column, painted from `palette` by row order\r\n * (cycling when the palette is shorter than the data).\r\n *\r\n * Paint comes from the palette rather than from the rows because a pie draws one\r\n * mark per *row* — unlike the line and bar charts, where a colour belongs to a\r\n * series (a whole column) and rides on the series entry instead. Keeping it out\r\n * of the rows is what lets a pie be fed straight from a CSV of plain numbers.\r\n */\r\nexport function resolvePieSlices(\r\n  data: DataRecord[],\r\n  category: string,\r\n  value: string,\r\n  palette: Fill[]\r\n): PieSlice[] {\r\n  return data.map((row, i) => ({\r\n    category: text(row, category),\r\n    value: num(row, value),\r\n    fill:\r\n      palette.length > 0 ? palette[i % palette.length] : (\"white\" as Fill),\r\n  }))\r\n}\r\n\r\n/** What a {@link PieChart}'s labels say. */\r\nexport type PieLabelMode =\r\n  /**\r\n   * The category and its percentage, two lines. Their order flips with the\r\n   * placement: a **leader** label reads category over percentage, an **inside**\r\n   * label reads the percentage big over a small category caption — inside a\r\n   * wedge the reader already knows which slice they're on, so the magnitude is\r\n   * the thing being read.\r\n   */\r\n  | \"both\"\r\n  /** The category only. */\r\n  | \"category\"\r\n  /** The percentage only — the pick when a legend already names the categories. */\r\n  | \"percent\"\r\n  /** No labels and no leader lines at all. */\r\n  | \"none\"\r\n\r\n/**\r\n * Where a slice's label sits.\r\n *\r\n * `\"inside\"` drops the leader line entirely and centres the label in the wedge's\r\n * own band, which costs no gutter — so the ring draws bigger — and costs the eye\r\n * no round trip. `\"leader\"` is the classic treatment, and what a sliver too\r\n * narrow to hold text needs.\r\n */\r\nexport type PieLabelPlacement = \"inside\" | \"leader\" | \"none\"\r\n\r\n/** Degrees → radians. */\r\nexport const DEG = Math.PI / 180\r\n\r\n/** A slice's plotted value: negatives and non-finite values count as 0. */\r\nexport function sliceValue(slice: PieSlice): number {\r\n  return slice.value > 0 && Number.isFinite(slice.value) ? slice.value : 0\r\n}\r\n\r\n/** Sum of every slice's plotted value — the denominator every share is taken against. */\r\nexport function sliceTotal(slices: PieSlice[]): number {\r\n  let sum = 0\r\n  for (const slice of slices) sum += sliceValue(slice)\r\n  return sum\r\n}\r\n\r\n/**\r\n * The point at radius `r` and angle `a` on a ring centred on the origin, in the\r\n * node's centred, **y-up** space. Angles run **clockwise from 12 o'clock**:\r\n * `a = 0` points straight up (+y), and increasing `a` sweeps toward +x then −y.\r\n */\r\nexport function ringPoint(r: number, a: number): Vector2 {\r\n  return { x: r * Math.sin(a), y: r * Math.cos(a) }\r\n}\r\n\r\n/** One slice's resolved angular span on the ring. */\r\nexport interface PieArc {\r\n  /** Index of the slice in the source list. */\r\n  index: number\r\n  /** Start angle, radians clockwise from 12 o'clock. */\r\n  a0: number\r\n  /** End angle, radians clockwise from 12 o'clock. */\r\n  a1: number\r\n  /** Bisector angle — where this slice's label and pop-out point. */\r\n  mid: number\r\n  /** This slice's share of the total, in `[0, 1]`. */\r\n  fraction: number\r\n}\r\n\r\n/**\r\n * Resolve slices into per-slice arcs: each covers exactly its share of the\r\n * circle, walking clockwise from `startDegrees` (0 = 12 o'clock), with the arcs\r\n * abutting. Zero/negative slices are skipped entirely; an all-zero list yields\r\n * no arcs.\r\n *\r\n * Arcs are the *undivided* shares — the gap between neighbours is not carved out\r\n * here, because a fixed angular gap reads as a wedge: wide at the rim, pinched\r\n * shut at the hole. It's applied when the wedge is drawn instead, as a\r\n * constant-width inset off both ends of every arc, so a slice still covers its\r\n * true percentage of the circle.\r\n */\r\nexport function pieArcs(slices: PieSlice[], startDegrees: number): PieArc[] {\r\n  const total = sliceTotal(slices)\r\n  if (total <= 0) return []\r\n\r\n  const arcs: PieArc[] = []\r\n  let cursor = startDegrees * DEG\r\n  slices.forEach((slice, index) => {\r\n    const value = sliceValue(slice)\r\n    if (value <= 0) return\r\n    const fraction = value / total\r\n    const a0 = cursor\r\n    const a1 = a0 + fraction * Math.PI * 2\r\n    cursor = a1\r\n    arcs.push({ index, a0, a1, mid: (a0 + a1) / 2, fraction })\r\n  })\r\n  return arcs\r\n}\r\n\r\n/** A label competing for vertical space in one of the two label columns. */\r\nexport interface LabelSlot {\r\n  /** Where the label would sit if nothing else were in the way. */\r\n  ideal: number\r\n  /** Where it ends up once the column has been de-conflicted. Written by {@link relaxLabels}. */\r\n  y: number\r\n}\r\n\r\n/**\r\n * Spread one column of labels so no two overlap, keeping each as close to its\r\n * `ideal` y as possible and the whole column inside `[bottom, top]`.\r\n *\r\n * Two passes, the standard treatment. Walking top-to-bottom, each label takes\r\n * the highest slot at or below its ideal that still clears the label above it by\r\n * `minGap`; if that pushes the tail past `bottom`, a reverse pass lifts it back\r\n * up. When there are more labels than the column can hold, the reverse pass wins\r\n * and the crowding is shared evenly rather than dumped off the bottom edge.\r\n *\r\n * Mutates each slot's `y` and returns `slots` re-ordered top-to-bottom.\r\n */\r\nexport function relaxLabels<T extends LabelSlot>(\r\n  slots: T[],\r\n  minGap: number,\r\n  top: number,\r\n  bottom: number\r\n): T[] {\r\n  slots.sort((a, b) => b.ideal - a.ideal)\r\n\r\n  let ceiling = top\r\n  for (const slot of slots) {\r\n    slot.y = Math.min(slot.ideal, ceiling)\r\n    ceiling = slot.y - minGap\r\n  }\r\n\r\n  let floor = bottom\r\n  for (let i = slots.length - 1; i >= 0; i--) {\r\n    slots[i].y = Math.max(slots[i].y, floor)\r\n    floor = slots[i].y + minGap\r\n  }\r\n\r\n  return slots\r\n}\r\n\r\n// ---- Theme ---------------------------------------------------------------\r\n\r\n/** The ring's geometry and paint — everything about the wedges but their colour. */\r\nexport interface RingConfig {\r\n  /**\r\n   * Width of the channel between adjacent slices, in px, held constant all the\r\n   * way across the band — the same clearance at the hole as at the rim. (An\r\n   * angular gap would splay open toward the rim instead.)\r\n   */\r\n  gap: number\r\n  /**\r\n   * Radius of the hole punched through the middle. Below 1 it reads as a\r\n   * fraction of the ring's outer radius (`0.6` leaves a band 40% of the radius\r\n   * thick); 1 and up as an explicit pixel radius; `0` fills the middle in,\r\n   * drawing solid pie wedges.\r\n   */\r\n  holeRadius: number\r\n  /** Angle in degrees where the first slice begins, clockwise from 12 o'clock. */\r\n  startAngle: number\r\n  /**\r\n   * How far out a selected slice's rim reaches, as a **multiple of the ring's\r\n   * outer radius**. Being relative, the emphasis scales with the chart instead\r\n   * of shrinking on a big one and swamping a small one. Clamped to `[1, 1.6]`.\r\n   */\r\n  selectedGrow: number\r\n  /** Optional outline on every wedge. */\r\n  stroke: Stroke\r\n  /** Optional drop shadow on every wedge. */\r\n  shadow: Shadow\r\n}\r\n\r\n/** How the ring's labels are set, and the leader lines that point at them. */\r\nexport interface LabelConfig {\r\n  /** The category caption on a label. */\r\n  textStyle: TextStyle\r\n  /** The percentage on a label. */\r\n  percentStyle: TextStyle\r\n  /**\r\n   * Ink for a label set **inside** its wedge, both lines. Separate because an\r\n   * inside label sits on the wedge's own paint rather than on the background, so\r\n   * it usually wants the opposite end of the value range from everything else.\r\n   */\r\n  insideStyle: TextStyle\r\n  /** The leader line running from a wedge out to its label. */\r\n  leaderStroke: Stroke\r\n}\r\n\r\n/** The summary set in the ring's hole. */\r\nexport interface CenterConfig {\r\n  labelStyle: TextStyle\r\n  captionStyle: TextStyle\r\n}\r\n\r\n/** A {@link PieChart}'s full, resolved visual theme. */\r\nexport interface PieChartConfig {\r\n  /** Wedge and swatch paint, cycled by **row** index (`i % length`). */\r\n  sliceFills: Fill[]\r\n  ring: RingConfig\r\n  label: LabelConfig\r\n  center: CenterConfig\r\n  legend: LegendConfig\r\n  /** How far everything outside the selection fades while any slice is selected. */\r\n  spotlight: { dimOpacity: number }\r\n}\r\n\r\n/** Author-facing partial theme — every branch optional and deep-merged. */\r\nexport type PieChartTheme = {\r\n  sliceFills?: Fill[]\r\n  ring?: Partial<RingConfig>\r\n  label?: Partial<LabelConfig>\r\n  center?: Partial<CenterConfig>\r\n  legend?: LegendTheme\r\n  spotlight?: Partial<PieChartConfig[\"spotlight\"]>\r\n}\r\n\r\nconst LABEL_TEXT_STYLE: TextStyle = {\r\n  fontSize: 26,\r\n  fontWeight: 600,\r\n  textAlign: \"center\",\r\n  fill: CHART_PALETTE.markerColor,\r\n}\r\n\r\n/** The pie chart's out-of-the-box look. */\r\nexport const DEFAULT_PIE_CHART_THEME: PieChartConfig = {\r\n  sliceFills: DEFAULT_SERIES_FILLS,\r\n  ring: {\r\n    gap: 6,\r\n    // A donut rather than a solid pie by default: the hole is the largest\r\n    // uninterrupted area the chart owns and the one place a conclusion can be\r\n    // set. `0` here would give that away before anyone had asked for it.\r\n    holeRadius: 0.6,\r\n    startAngle: 0,\r\n    selectedGrow: 1.08,\r\n    stroke: [],\r\n    shadow: [],\r\n  },\r\n  label: {\r\n    textStyle: LABEL_TEXT_STYLE,\r\n    percentStyle: { ...LABEL_TEXT_STYLE, fontWeight: 700 },\r\n    // Inside labels sit on the wedge's paint, which is a mid-tone from the\r\n    // palette — so they lead with the panel colour rather than the axis ink.\r\n    insideStyle: { ...LABEL_TEXT_STYLE, fontWeight: 800, fill: \"#15130e\" },\r\n    leaderStroke: { weight: 2, fill: CHART_PALETTE.markerColor },\r\n  },\r\n  center: {\r\n    labelStyle: {\r\n      fontSize: 46,\r\n      fontWeight: 800,\r\n      textAlign: \"center\",\r\n      fill: CHART_PALETTE.markerColor,\r\n    },\r\n    captionStyle: {\r\n      fontSize: 22,\r\n      fontWeight: 500,\r\n      textAlign: \"center\",\r\n      fill: CHART_PALETTE.markerColor,\r\n    },\r\n  },\r\n  legend: DEFAULT_LEGEND,\r\n  spotlight: { dimOpacity: SPOTLIGHT_DIM },\r\n}\r\n\r\nfunction resolveRingConfig(\r\n  ring: Partial<RingConfig> | undefined,\r\n  previous: RingConfig\r\n): RingConfig {\r\n  return {\r\n    gap: ring?.gap ?? previous.gap,\r\n    holeRadius: ring?.holeRadius ?? previous.holeRadius,\r\n    startAngle: ring?.startAngle ?? previous.startAngle,\r\n    selectedGrow: ring?.selectedGrow ?? previous.selectedGrow,\r\n    stroke: strokeOps.resolve(ring?.stroke ?? previous.stroke),\r\n    shadow: shadowOps.resolve(ring?.shadow ?? previous.shadow),\r\n  }\r\n}\r\n\r\nfunction lerpRingConfig(\r\n  from: RingConfig,\r\n  to: RingConfig,\r\n  t: number\r\n): RingConfig {\r\n  return {\r\n    gap: lerpNumber(from.gap, to.gap, t),\r\n    holeRadius: lerpNumber(from.holeRadius, to.holeRadius, t),\r\n    startAngle: lerpNumber(from.startAngle, to.startAngle, t),\r\n    selectedGrow: lerpNumber(from.selectedGrow, to.selectedGrow, t),\r\n    stroke: strokeOps.lerp(\r\n      from.stroke as StrokeResolved[],\r\n      to.stroke as StrokeResolved[],\r\n      t\r\n    ),\r\n    shadow: shadowOps.lerp(\r\n      from.shadow as ShadowResolved[],\r\n      to.shadow as ShadowResolved[],\r\n      t\r\n    ),\r\n  }\r\n}\r\n\r\nfunction resolveLabelConfig(\r\n  label: Partial<LabelConfig> | undefined,\r\n  previous: LabelConfig\r\n): LabelConfig {\r\n  return {\r\n    textStyle: textOps.resolveStyle(label?.textStyle, previous.textStyle),\r\n    percentStyle: textOps.resolveStyle(\r\n      label?.percentStyle,\r\n      previous.percentStyle\r\n    ),\r\n    insideStyle: textOps.resolveStyle(label?.insideStyle, previous.insideStyle),\r\n    leaderStroke: strokeOps.resolve(\r\n      label?.leaderStroke ?? previous.leaderStroke\r\n    ),\r\n  }\r\n}\r\n\r\nfunction lerpLabelConfig(\r\n  from: LabelConfig,\r\n  to: LabelConfig,\r\n  t: number\r\n): LabelConfig {\r\n  return {\r\n    textStyle: textOps.lerpStyle(from.textStyle, to.textStyle, t),\r\n    percentStyle: textOps.lerpStyle(from.percentStyle, to.percentStyle, t),\r\n    insideStyle: textOps.lerpStyle(from.insideStyle, to.insideStyle, t),\r\n    leaderStroke: strokeOps.lerp(\r\n      from.leaderStroke as StrokeResolved[],\r\n      to.leaderStroke as StrokeResolved[],\r\n      t\r\n    ),\r\n  }\r\n}\r\n\r\nfunction resolveCenterConfig(\r\n  center: Partial<CenterConfig> | undefined,\r\n  previous: CenterConfig\r\n): CenterConfig {\r\n  return {\r\n    labelStyle: textOps.resolveStyle(center?.labelStyle, previous.labelStyle),\r\n    captionStyle: textOps.resolveStyle(\r\n      center?.captionStyle,\r\n      previous.captionStyle\r\n    ),\r\n  }\r\n}\r\n\r\nfunction lerpCenterConfig(\r\n  from: CenterConfig,\r\n  to: CenterConfig,\r\n  t: number\r\n): CenterConfig {\r\n  return {\r\n    labelStyle: textOps.lerpStyle(from.labelStyle, to.labelStyle, t),\r\n    captionStyle: textOps.lerpStyle(from.captionStyle, to.captionStyle, t),\r\n  }\r\n}\r\n\r\n/**\r\n * {@link PieChart}'s `theme` @property mapper: merges the author's partial\r\n * {@link PieChartTheme} onto `previous` (falling back to\r\n * {@link DEFAULT_PIE_CHART_THEME} on first resolution), fully resolving every\r\n * leaf so the tween below always has resolved data to interpolate.\r\n */\r\nexport function resolvePieChartTheme(\r\n  theme: PieChartTheme | undefined,\r\n  previous?: PieChartConfig\r\n): PieChartConfig {\r\n  const base = previous ?? DEFAULT_PIE_CHART_THEME\r\n  return {\r\n    sliceFills: resolveSeriesFills(theme?.sliceFills, base.sliceFills),\r\n    ring: resolveRingConfig(theme?.ring, base.ring),\r\n    label: resolveLabelConfig(theme?.label, base.label),\r\n    center: resolveCenterConfig(theme?.center, base.center),\r\n    legend: resolveLegendConfig(theme?.legend, base.legend),\r\n    spotlight: {\r\n      dimOpacity: theme?.spotlight?.dimOpacity ?? base.spotlight.dimOpacity,\r\n    },\r\n  }\r\n}\r\n\r\n/** {@link PieChart}'s `theme` @property tween — leaf by leaf. */\r\nexport function lerpPieChartTheme(\r\n  from: PieChartConfig,\r\n  to: PieChartConfig,\r\n  t: number\r\n): PieChartConfig {\r\n  return {\r\n    // A palette is a list of independent paints rather than one value, so it\r\n    // interpolates pairwise by index; one that grows or shrinks holds the longer\r\n    // side's tail, exactly as the cartesian charts' palettes do.\r\n    sliceFills: lerpSeriesFills(from.sliceFills, to.sliceFills, t),\r\n    ring: lerpRingConfig(from.ring, to.ring, t),\r\n    label: lerpLabelConfig(from.label, to.label, t),\r\n    center: lerpCenterConfig(from.center, to.center, t),\r\n    legend: lerpLegendConfig(from.legend, to.legend, t),\r\n    spotlight: {\r\n      dimOpacity: lerpNumber(\r\n        from.spotlight.dimOpacity,\r\n        to.spotlight.dimOpacity,\r\n        t\r\n      ),\r\n    },\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/pie-chart/shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Types and pure helpers specific to the {@link PieChart} family: how rows\r\n * become slices, how slices become arcs on a ring, where the labels around it\r\n * end up, and the theme all of that is drawn from.\r\n *\r\n * The one chart in the family that draws **one mark per row** rather than one\r\n * per column, which is why almost nothing about its geometry is shared: there is\r\n * no scale, no axis and no baseline, only a circle divided by share. What it\r\n * *does* share — the legend, the theme leaf resolvers, the palette, the\r\n * percentage format — comes from `../kit/shared.ts`.\r\n *\r\n * Kept renderer-agnostic (no `Node` imports) so a host's inspector mapping\r\n * can build a partial {@link PieChartTheme} without\r\n * pulling the node classes in.\r\n */\r\n\r\nimport {\r\n  lerpNumber,\r\n  shadowOps,\r\n  strokeOps,\r\n  textOps,\r\n  type DataRecord,\r\n  type Fill,\r\n  type Shadow,\r\n  type ShadowResolved,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n  type TextStyle,\r\n  type Vector2,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport {\r\n  CHART_PALETTE,\r\n  DEFAULT_LEGEND,\r\n  DEFAULT_SERIES_FILLS,\r\n  lerpLegendConfig,\r\n  lerpSeriesFills,\r\n  num,\r\n  resolveLegendConfig,\r\n  resolveSeriesFills,\r\n  text,\r\n  type LegendConfig,\r\n  type LegendTheme,\r\n} from \"../kit/shared\"\r\n\r\n/**\r\n * One **resolved** slice of a {@link PieChart}: its caption, its magnitude, and\r\n * the paint its wedge and legend swatch take.\r\n *\r\n * This is what the ring and the legend consume, not what a scene authors: the\r\n * chart takes tabular `data` plus two field names and resolves it into these, so\r\n * the parts stay unaware of where a slice's caption, magnitude and paint came\r\n * from.\r\n */\r\nexport interface PieSlice {\r\n  /** Legend caption and label text for this slice. */\r\n  category: string\r\n  /** This slice's magnitude. Its wedge covers `value / (sum of all values)`. */\r\n  value: number\r\n  /** Wedge and swatch paint. */\r\n  fill: Fill\r\n}\r\n\r\n/**\r\n * Resolve tabular rows into slices: one per row, captioned by the `category`\r\n * column, sized by the `value` column, painted from `palette` by row order\r\n * (cycling when the palette is shorter than the data).\r\n *\r\n * Paint comes from the palette rather than from the rows because a pie draws one\r\n * mark per *row* — unlike the line and bar charts, where a colour belongs to a\r\n * series (a whole column) and rides on the series entry instead. Keeping it out\r\n * of the rows is what lets a pie be fed straight from a CSV of plain numbers.\r\n */\r\nexport function resolvePieSlices(\r\n  data: DataRecord[],\r\n  category: string,\r\n  value: string,\r\n  palette: Fill[]\r\n): PieSlice[] {\r\n  return data.map((row, i) => ({\r\n    category: text(row, category),\r\n    value: num(row, value),\r\n    fill:\r\n      palette.length > 0 ? palette[i % palette.length] : (\"white\" as Fill),\r\n  }))\r\n}\r\n\r\n/** What a {@link PieChart}'s labels say. */\r\nexport type PieLabelMode =\r\n  /**\r\n   * The category and its percentage, two lines. Their order flips with the\r\n   * placement: a **leader** label reads category over percentage, an **inside**\r\n   * label reads the percentage big over a small category caption — inside a\r\n   * wedge the reader already knows which slice they're on, so the magnitude is\r\n   * the thing being read.\r\n   */\r\n  | \"both\"\r\n  /** The category only. */\r\n  | \"category\"\r\n  /** The percentage only — the pick when a legend already names the categories. */\r\n  | \"percent\"\r\n  /** No labels and no leader lines at all. */\r\n  | \"none\"\r\n\r\n/**\r\n * Where a slice's label sits.\r\n *\r\n * `\"inside\"` drops the leader line entirely and centres the label in the wedge's\r\n * own band, which costs no gutter — so the ring draws bigger — and costs the eye\r\n * no round trip. `\"leader\"` is the classic treatment, and what a sliver too\r\n * narrow to hold text needs.\r\n */\r\nexport type PieLabelPlacement = \"inside\" | \"leader\" | \"none\"\r\n\r\n/** Degrees → radians. */\r\nexport const DEG = Math.PI / 180\r\n\r\n/** A slice's plotted value: negatives and non-finite values count as 0. */\r\nexport function sliceValue(slice: PieSlice): number {\r\n  return slice.value > 0 && Number.isFinite(slice.value) ? slice.value : 0\r\n}\r\n\r\n/** Sum of every slice's plotted value — the denominator every share is taken against. */\r\nexport function sliceTotal(slices: PieSlice[]): number {\r\n  let sum = 0\r\n  for (const slice of slices) sum += sliceValue(slice)\r\n  return sum\r\n}\r\n\r\n/**\r\n * The point at radius `r` and angle `a` on a ring centred on the origin, in the\r\n * node's centred, **y-up** space. Angles run **clockwise from 12 o'clock**:\r\n * `a = 0` points straight up (+y), and increasing `a` sweeps toward +x then −y.\r\n */\r\nexport function ringPoint(r: number, a: number): Vector2 {\r\n  return { x: r * Math.sin(a), y: r * Math.cos(a) }\r\n}\r\n\r\n/** One slice's resolved angular span on the ring. */\r\nexport interface PieArc {\r\n  /** Index of the slice in the source list. */\r\n  index: number\r\n  /** Start angle, radians clockwise from 12 o'clock. */\r\n  a0: number\r\n  /** End angle, radians clockwise from 12 o'clock. */\r\n  a1: number\r\n  /** Bisector angle — where this slice's label and pop-out point. */\r\n  mid: number\r\n  /** This slice's share of the total, in `[0, 1]`. */\r\n  fraction: number\r\n}\r\n\r\n/**\r\n * Resolve slices into per-slice arcs: each covers exactly its share of the\r\n * circle, walking clockwise from `startDegrees` (0 = 12 o'clock), with the arcs\r\n * abutting. Zero/negative slices are skipped entirely; an all-zero list yields\r\n * no arcs.\r\n *\r\n * Arcs are the *undivided* shares — the gap between neighbours is not carved out\r\n * here, because a fixed angular gap reads as a wedge: wide at the rim, pinched\r\n * shut at the hole. It's applied when the wedge is drawn instead, as a\r\n * constant-width inset off both ends of every arc, so a slice still covers its\r\n * true percentage of the circle.\r\n */\r\nexport function pieArcs(slices: PieSlice[], startDegrees: number): PieArc[] {\r\n  const total = sliceTotal(slices)\r\n  if (total <= 0) return []\r\n\r\n  const arcs: PieArc[] = []\r\n  let cursor = startDegrees * DEG\r\n  slices.forEach((slice, index) => {\r\n    const value = sliceValue(slice)\r\n    if (value <= 0) return\r\n    const fraction = value / total\r\n    const a0 = cursor\r\n    const a1 = a0 + fraction * Math.PI * 2\r\n    cursor = a1\r\n    arcs.push({ index, a0, a1, mid: (a0 + a1) / 2, fraction })\r\n  })\r\n  return arcs\r\n}\r\n\r\n/** A label competing for vertical space in one of the two label columns. */\r\nexport interface LabelSlot {\r\n  /** Where the label would sit if nothing else were in the way. */\r\n  ideal: number\r\n  /** Where it ends up once the column has been de-conflicted. Written by {@link relaxLabels}. */\r\n  y: number\r\n}\r\n\r\n/**\r\n * Spread one column of labels so no two overlap, keeping each as close to its\r\n * `ideal` y as possible and the whole column inside `[bottom, top]`.\r\n *\r\n * Two passes, the standard treatment. Walking top-to-bottom, each label takes\r\n * the highest slot at or below its ideal that still clears the label above it by\r\n * `minGap`; if that pushes the tail past `bottom`, a reverse pass lifts it back\r\n * up. When there are more labels than the column can hold, the reverse pass wins\r\n * and the crowding is shared evenly rather than dumped off the bottom edge.\r\n *\r\n * Mutates each slot's `y` and returns `slots` re-ordered top-to-bottom.\r\n */\r\nexport function relaxLabels<T extends LabelSlot>(\r\n  slots: T[],\r\n  minGap: number,\r\n  top: number,\r\n  bottom: number\r\n): T[] {\r\n  slots.sort((a, b) => b.ideal - a.ideal)\r\n\r\n  let ceiling = top\r\n  for (const slot of slots) {\r\n    slot.y = Math.min(slot.ideal, ceiling)\r\n    ceiling = slot.y - minGap\r\n  }\r\n\r\n  let floor = bottom\r\n  for (let i = slots.length - 1; i >= 0; i--) {\r\n    slots[i].y = Math.max(slots[i].y, floor)\r\n    floor = slots[i].y + minGap\r\n  }\r\n\r\n  return slots\r\n}\r\n\r\n// ---- Theme ---------------------------------------------------------------\r\n\r\n/** The ring's geometry and paint — everything about the wedges but their colour. */\r\nexport interface RingConfig {\r\n  /**\r\n   * Width of the channel between adjacent slices, in px, held constant all the\r\n   * way across the band — the same clearance at the hole as at the rim. (An\r\n   * angular gap would splay open toward the rim instead.)\r\n   */\r\n  gap: number\r\n  /**\r\n   * Radius of the hole punched through the middle. Below 1 it reads as a\r\n   * fraction of the ring's outer radius (`0.6` leaves a band 40% of the radius\r\n   * thick); 1 and up as an explicit pixel radius; `0` fills the middle in,\r\n   * drawing solid pie wedges.\r\n   */\r\n  holeRadius: number\r\n  /** Angle in degrees where the first slice begins, clockwise from 12 o'clock. */\r\n  startAngle: number\r\n  /**\r\n   * How far out a selected slice's rim reaches, as a **multiple of the ring's\r\n   * outer radius**. Being relative, the emphasis scales with the chart instead\r\n   * of shrinking on a big one and swamping a small one. Clamped to `[1, 1.6]`.\r\n   */\r\n  selectedGrow: number\r\n  /** Optional outline on every wedge. */\r\n  stroke: Stroke\r\n  /** Optional drop shadow on every wedge. */\r\n  shadow: Shadow\r\n}\r\n\r\n/** How the ring's labels are set, and the leader lines that point at them. */\r\nexport interface LabelConfig {\r\n  /** The category caption on a label. */\r\n  textStyle: TextStyle\r\n  /** The percentage on a label. */\r\n  percentStyle: TextStyle\r\n  /**\r\n   * Ink for a label set **inside** its wedge, both lines. Separate because an\r\n   * inside label sits on the wedge's own paint rather than on the background, so\r\n   * it usually wants the opposite end of the value range from everything else.\r\n   */\r\n  insideStyle: TextStyle\r\n  /** The leader line running from a wedge out to its label. */\r\n  leaderStroke: Stroke\r\n}\r\n\r\n/** The summary set in the ring's hole. */\r\nexport interface CenterConfig {\r\n  labelStyle: TextStyle\r\n  captionStyle: TextStyle\r\n}\r\n\r\n/** A {@link PieChart}'s full, resolved visual theme. */\r\nexport interface PieChartConfig {\r\n  /** Wedge and swatch paint, cycled by **row** index (`i % length`). */\r\n  sliceFills: Fill[]\r\n  ring: RingConfig\r\n  label: LabelConfig\r\n  center: CenterConfig\r\n  legend: LegendConfig\r\n  /** How far everything outside the selection fades while any slice is selected. */\r\n  spotlight: { dimOpacity: number }\r\n}\r\n\r\n/** Author-facing partial theme — every branch optional and deep-merged. */\r\nexport type PieChartTheme = {\r\n  sliceFills?: Fill[]\r\n  ring?: Partial<RingConfig>\r\n  label?: Partial<LabelConfig>\r\n  center?: Partial<CenterConfig>\r\n  legend?: LegendTheme\r\n  spotlight?: Partial<PieChartConfig[\"spotlight\"]>\r\n}\r\n\r\nconst LABEL_TEXT_STYLE: TextStyle = {\r\n  fontSize: 26,\r\n  fontWeight: 600,\r\n  textAlign: \"center\",\r\n  fill: CHART_PALETTE.markerColor,\r\n}\r\n\r\n/**\r\n * Opacity the other slices fade to under a selection. Fainter than the line and\r\n * bar charts' `SPOTLIGHT_DIM`: a ring's slices touch, so at that a selected\r\n * slice barely separates from its neighbours.\r\n */\r\nexport const PIE_SPOTLIGHT_DIM = 0.1\r\n\r\n/** The pie chart's out-of-the-box look. */\r\nexport const DEFAULT_PIE_CHART_THEME: PieChartConfig = {\r\n  sliceFills: DEFAULT_SERIES_FILLS,\r\n  ring: {\r\n    gap: 6,\r\n    // A donut rather than a solid pie by default: the hole is the largest\r\n    // uninterrupted area the chart owns and the one place a conclusion can be\r\n    // set. `0` here would give that away before anyone had asked for it.\r\n    holeRadius: 0.6,\r\n    startAngle: 0,\r\n    selectedGrow: 1.08,\r\n    stroke: [],\r\n    shadow: [],\r\n  },\r\n  label: {\r\n    textStyle: LABEL_TEXT_STYLE,\r\n    percentStyle: { ...LABEL_TEXT_STYLE, fontWeight: 700 },\r\n    // Inside labels sit on the wedge's paint, which is a mid-tone from the\r\n    // palette — so they lead with the panel colour rather than the axis ink.\r\n    insideStyle: { ...LABEL_TEXT_STYLE, fontWeight: 800, fill: \"#15130e\" },\r\n    leaderStroke: { weight: 2, fill: CHART_PALETTE.markerColor },\r\n  },\r\n  center: {\r\n    labelStyle: {\r\n      fontSize: 46,\r\n      fontWeight: 800,\r\n      textAlign: \"center\",\r\n      fill: CHART_PALETTE.markerColor,\r\n    },\r\n    captionStyle: {\r\n      fontSize: 22,\r\n      fontWeight: 500,\r\n      textAlign: \"center\",\r\n      fill: CHART_PALETTE.markerColor,\r\n    },\r\n  },\r\n  legend: DEFAULT_LEGEND,\r\n  spotlight: { dimOpacity: PIE_SPOTLIGHT_DIM },\r\n}\r\n\r\nfunction resolveRingConfig(\r\n  ring: Partial<RingConfig> | undefined,\r\n  previous: RingConfig\r\n): RingConfig {\r\n  return {\r\n    gap: ring?.gap ?? previous.gap,\r\n    holeRadius: ring?.holeRadius ?? previous.holeRadius,\r\n    startAngle: ring?.startAngle ?? previous.startAngle,\r\n    selectedGrow: ring?.selectedGrow ?? previous.selectedGrow,\r\n    stroke: strokeOps.resolve(ring?.stroke ?? previous.stroke),\r\n    shadow: shadowOps.resolve(ring?.shadow ?? previous.shadow),\r\n  }\r\n}\r\n\r\nfunction lerpRingConfig(\r\n  from: RingConfig,\r\n  to: RingConfig,\r\n  t: number\r\n): RingConfig {\r\n  return {\r\n    gap: lerpNumber(from.gap, to.gap, t),\r\n    holeRadius: lerpNumber(from.holeRadius, to.holeRadius, t),\r\n    startAngle: lerpNumber(from.startAngle, to.startAngle, t),\r\n    selectedGrow: lerpNumber(from.selectedGrow, to.selectedGrow, t),\r\n    stroke: strokeOps.lerp(\r\n      from.stroke as StrokeResolved[],\r\n      to.stroke as StrokeResolved[],\r\n      t\r\n    ),\r\n    shadow: shadowOps.lerp(\r\n      from.shadow as ShadowResolved[],\r\n      to.shadow as ShadowResolved[],\r\n      t\r\n    ),\r\n  }\r\n}\r\n\r\nfunction resolveLabelConfig(\r\n  label: Partial<LabelConfig> | undefined,\r\n  previous: LabelConfig\r\n): LabelConfig {\r\n  return {\r\n    textStyle: textOps.resolveStyle(label?.textStyle, previous.textStyle),\r\n    percentStyle: textOps.resolveStyle(\r\n      label?.percentStyle,\r\n      previous.percentStyle\r\n    ),\r\n    insideStyle: textOps.resolveStyle(label?.insideStyle, previous.insideStyle),\r\n    leaderStroke: strokeOps.resolve(\r\n      label?.leaderStroke ?? previous.leaderStroke\r\n    ),\r\n  }\r\n}\r\n\r\nfunction lerpLabelConfig(\r\n  from: LabelConfig,\r\n  to: LabelConfig,\r\n  t: number\r\n): LabelConfig {\r\n  return {\r\n    textStyle: textOps.lerpStyle(from.textStyle, to.textStyle, t),\r\n    percentStyle: textOps.lerpStyle(from.percentStyle, to.percentStyle, t),\r\n    insideStyle: textOps.lerpStyle(from.insideStyle, to.insideStyle, t),\r\n    leaderStroke: strokeOps.lerp(\r\n      from.leaderStroke as StrokeResolved[],\r\n      to.leaderStroke as StrokeResolved[],\r\n      t\r\n    ),\r\n  }\r\n}\r\n\r\nfunction resolveCenterConfig(\r\n  center: Partial<CenterConfig> | undefined,\r\n  previous: CenterConfig\r\n): CenterConfig {\r\n  return {\r\n    labelStyle: textOps.resolveStyle(center?.labelStyle, previous.labelStyle),\r\n    captionStyle: textOps.resolveStyle(\r\n      center?.captionStyle,\r\n      previous.captionStyle\r\n    ),\r\n  }\r\n}\r\n\r\nfunction lerpCenterConfig(\r\n  from: CenterConfig,\r\n  to: CenterConfig,\r\n  t: number\r\n): CenterConfig {\r\n  return {\r\n    labelStyle: textOps.lerpStyle(from.labelStyle, to.labelStyle, t),\r\n    captionStyle: textOps.lerpStyle(from.captionStyle, to.captionStyle, t),\r\n  }\r\n}\r\n\r\n/**\r\n * {@link PieChart}'s `theme` property mapper: merges the author's partial\r\n * {@link PieChartTheme} onto `previous` (falling back to\r\n * {@link DEFAULT_PIE_CHART_THEME} on first resolution), fully resolving every\r\n * leaf so the tween below always has resolved data to interpolate.\r\n */\r\nexport function resolvePieChartTheme(\r\n  theme: PieChartTheme | undefined,\r\n  previous?: PieChartConfig\r\n): PieChartConfig {\r\n  const base = previous ?? DEFAULT_PIE_CHART_THEME\r\n  return {\r\n    sliceFills: resolveSeriesFills(theme?.sliceFills, base.sliceFills),\r\n    ring: resolveRingConfig(theme?.ring, base.ring),\r\n    label: resolveLabelConfig(theme?.label, base.label),\r\n    center: resolveCenterConfig(theme?.center, base.center),\r\n    legend: resolveLegendConfig(theme?.legend, base.legend),\r\n    spotlight: {\r\n      dimOpacity: theme?.spotlight?.dimOpacity ?? base.spotlight.dimOpacity,\r\n    },\r\n  }\r\n}\r\n\r\n/** {@link PieChart}'s `theme` property tween — leaf by leaf. */\r\nexport function lerpPieChartTheme(\r\n  from: PieChartConfig,\r\n  to: PieChartConfig,\r\n  t: number\r\n): PieChartConfig {\r\n  return {\r\n    // A palette is a list of independent paints rather than one value, so it\r\n    // interpolates pairwise by index; one that grows or shrinks holds the longer\r\n    // side's tail, exactly as the cartesian charts' palettes do.\r\n    sliceFills: lerpSeriesFills(from.sliceFills, to.sliceFills, t),\r\n    ring: lerpRingConfig(from.ring, to.ring, t),\r\n    label: lerpLabelConfig(from.label, to.label, t),\r\n    center: lerpCenterConfig(from.center, to.center, t),\r\n    legend: lerpLegendConfig(from.legend, to.legend, t),\r\n    spotlight: {\r\n      dimOpacity: lerpNumber(\r\n        from.spotlight.dimOpacity,\r\n        to.spotlight.dimOpacity,\r\n        t\r\n      ),\r\n    },\r\n  }\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionscript/charts",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "type": "module",
   "description": "Animated data charts for Motion Script: a line chart, a bar chart and a pie chart sharing one axis, legend and theme kit.",
   "repository": {
@@ -48,8 +48,9 @@
     "animation"
   ],
   "license": "Apache-2.0",
+  "author": "Motionscript",
   "peerDependencies": {
-    "@motionscript/sdk": "^0.1.0-alpha.6"
+    "@motionscript/sdk": "^0.1.0-alpha.8"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",
@@ -60,8 +61,8 @@
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.48.0",
     "vitest": "^4.1.5",
-    "@motionscript/core": "0.1.0-alpha.6",
-    "@motionscript/sdk": "0.1.0-alpha.6"
+    "@motionscript/sdk": "0.1.0-alpha.8",
+    "@motionscript/core": "0.1.0-alpha.8"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json --resolve-full-paths && node ../../../scripts/build-browser.mjs",

package/src/bar-chart/bar-chart.ts

@@ -128,9 +128,17 @@ function drawnValue(s: BarChartValues, domain: AxisDomainConfig): AxisDomainConf
   return { ...domain, range, ticks: domain.ticks ?? markerValues(range, DEFAULT_MARKERS - 1) }
 }
 
+/** The last domain worked out from each data array, and what else it was read from. */
+const domainsDrawn = new WeakMap<DataRecord[], Omit<BarChartValues, "data"> & { readonly domain: BarChartDomain }>()
+
 /** The value axis as a bar chart draws it now, an auto range or tick row read back as itself. */
 export function barChartDomain(s: BarChartValues): BarChartDomain {
-  return settleAxisDomain(s.valueAxis, (d) => drawnValue(s, d)) as BarChartDomain
+  const { data, series, stacked, valueAxis } = s
+  const kept = domainsDrawn.get(data)
+  if (kept && kept.series === series && kept.stacked === stacked && kept.valueAxis === valueAxis) return kept.domain
+  const domain = settleAxisDomain(valueAxis, (d) => drawnValue(s, d)) as BarChartDomain
+  domainsDrawn.set(data, { series, stacked, valueAxis, domain })
+  return domain
 }
 
 /**
@@ -334,6 +342,7 @@ export const BarChart = component2d({
     weights: (state) => state.series.map((s) => ((s.enabled ?? true) ? 1 : 0)),
     showing: (state) => state.series.map((s) => s.enabled ?? true),
   },
+  allowedChildren: [],
   children: (state) => {
     const theme = () => state.theme
     const domain = () => barChartDomain(state)
@@ -426,10 +435,7 @@ export const BarChart = component2d({
       height: 0,
     }) as unknown as Node2D
 
-    return asParts([
-      ...(state.children as unknown as Node2D[]),
-      cartesianFrame({ axis: vAxis as unknown as Node2D, plot, gutter, below }),
-    ])
+    return asParts([cartesianFrame({ axis: vAxis as unknown as Node2D, plot, gutter, below })])
   },
   commands: {
     /**
@@ -441,6 +447,8 @@ export const BarChart = component2d({
      */
     enter: {
       args: {},
+      // Held from the chart's arrival, so it never shows finished ahead of its draw.
+      entrance: true,
       easing: easeOut(),
       run: (timeline, _state, children) => {
         const parts = partsOf(children)

package/src/bar-chart/chart-bars.ts

@@ -263,16 +263,15 @@ export const ChartBars = component2d({
           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.
+          // Corner keys are visual (the renderer keeps them in y-up author space),
+          // so a column reaching *up* rounds its `top*` corners and one reaching
+          // down its `bottom*` 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 }
+                ? { topLeft: radius, topRight: radius, bottomLeft: 0, bottomRight: 0 }
+                : { bottomLeft: radius, bottomRight: radius, topLeft: 0, topRight: 0 }
               : 0,
         })
         rect.shadow(state.barShadow)

package/src/line-chart/chart-line.ts

@@ -6,7 +6,6 @@ import {
   type NodeOf,
   // Named so this component's emitted type reaches `Node2D` through the sdk, not core.
   type Node2D as _Node2D,
-  type Node2DProps,
   type Stroke,
   type StrokeResolved,
   type Vector2,
@@ -23,40 +22,6 @@ import {
   type RegionBox,
 } from "./shared"
 
-export interface ChartLineProps extends Node2DProps {
-  /**
-   * The series polyline, already mapped into this node's local pixel space
-   * (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x.
-   */
-  points: Vector2[]
-  /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */
-  stroke: Stroke
-  /**
-   * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left
-   * end to its right.
-   *
-   * Defaults to **1**, unlike the standalone chart this was ported from: in an
-   * editor a node's resting state is what the paused editor canvas paints, so a
-   * chart that only appeared once a command had run would edit blind. {@link
-   * ChartLine.enter} drives it from 0 regardless of where it rests, so the
-   * animation is unchanged.
-   */
-  progress: number
-  /**
-   * Whether this line is drawn at all. `false` hides it outright — the switch
-   * the chart flips alongside its legend's per-series toggle.
-   */
-  enabled: boolean
-  /**
-   * A slice of the plot to spotlight, in this node's own pixel space. When set
-   * to a real box, the stretches of the line *outside* it drop to
-   * {@link ChartLineProps.dimOpacity} while the stretches inside stay full.
-   */
-  spotlight: RegionBox
-  /** Opacity the out-of-region stretches fade to. */
-  dimOpacity: number
-}
-
 /**
  * The prefix of `pts` revealed at fraction `p ∈ [0, 1]`, measuring the reveal
  * by *cumulative arc length* so the line traces at a steady pace regardless of
@@ -99,17 +64,27 @@ function tracePoints(pts: Vector2[], p: number): Vector2[] {
  * through pre-mapped pixel `points`, drawn as one {@link Graphics2D} command list.
  * Sized and positioned by the parent, which shares the plot's coordinate frame.
  *
- * Two signals drive it: {@link ChartLineProps.progress} traces the line in
+ * Two signals drive it: `progress` traces the line in
  * (animated by `enter`) and `enabled` shows or hides it wholesale.
  */
 export const ChartLine = component2d({
   key: "chartLine",
   state: {
+    /** The series polyline, already mapped into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x. */
     points: fresh<Vector2[]>(() => []),
+    /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */
     stroke: Types.custom<Stroke, StrokeResolved[]>([], { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),
+    /**
+     * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left
+     * end to its right. Defaults to 1, so the paused editor canvas paints the line;
+     * `enter` drives it from 0 regardless of where it rests.
+     */
     progress: 1,
+    /** Whether this line is drawn at all: the switch the chart flips alongside its legend's per-series toggle. */
     enabled: true,
+    /** A slice of the plot to spotlight, in this node's own pixel space: outside it the line drops to `dimOpacity`. */
     spotlight: fresh<RegionBox>(() => EMPTY_REGION_BOX),
+    /** Opacity the out-of-region stretches fade to. */
     dimOpacity: SPOTLIGHT_DIM,
   },
   load: (loader, state) => loadPaints(loader, { strokes: [state.stroke] }),

package/src/line-chart/chart-region.ts

@@ -9,7 +9,6 @@ import {
   type NodeOf,
   // Named so this component's emitted type reaches `Node2D` through the sdk, not core.
   type Node2D as _Node2D,
-  type Node2DProps,
   type Stroke,
   type StrokeResolved,
 } from "@motionscript/sdk"
@@ -23,29 +22,10 @@ import {
   type RegionBox,
 } from "./shared"
 
-export interface ChartRegionProps extends Node2DProps {
-  /**
-   * The highlighted slice, already resolved into this node's local pixel space
-   * (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box
-   * draws nothing.
-   */
-  box: RegionBox
-  /** Dashed rule marking each *bounded* edge of the box. */
-  stroke: Stroke
-  /** Wash filling the box, under the series lines. */
-  fill: Fill
-  /**
-   * Reveal of the annotation in `[0, 1]`: 0 hides it, 1 draws it fully. Driven
-   * by the chart's own `regionReveal`, so the rules and the series' dimming move
-   * as one.
-   */
-  reveal: number
-}
-
 /**
  * The **region call-out** of a {@link LineChart}: a washed rectangle over the
  * plot with a dashed rule down each edge the author actually bounded. Sized and
- * positioned entirely from the pre-mapped {@link ChartRegionProps.box} rather
+ * positioned entirely from the pre-mapped `box` rather
  * than its own box — the region already carries the plot geometry.
  *
  * It draws only the *marking*; fading the series outside the region is
@@ -59,9 +39,13 @@ export interface ChartRegionProps extends Node2DProps {
 export const ChartRegion = component2d({
   key: "chartRegion",
   state: {
+    /** The highlighted slice, already resolved into this node's local pixel space (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box draws nothing. */
     box: fresh<RegionBox>(() => EMPTY_REGION_BOX),
+    /** Dashed rule marking each *bounded* edge of the box. */
     stroke: Types.custom<Stroke, StrokeResolved[]>(DEFAULT_CHART_THEME.region.stroke, { resolve: strokeOps.resolve, lerp: strokeOps.lerp }),
+    /** Wash filling the box, under the series lines. */
     fill: Types.custom<Fill, FillResolved[]>(DEFAULT_CHART_THEME.region.fill, { resolve: fillOps.resolve, lerp: fillOps.lerp }),
+    /** Reveal of the annotation in `[0, 1]`, driven by the chart's own `regionReveal` so the rules and the series' dimming move as one. */
     reveal: 0,
   },
   load: (loader, state) => loadPaints(loader, { fills: [state.fill], strokes: [state.stroke] }),

package/src/line-chart/horizontal-axis.ts

@@ -7,7 +7,6 @@ import {
   textOps,
   type NodeOf,
   type Node2D,
-  type Node2DProps,
 } from "@motionscript/sdk";
 
 import { asParts, fresh } from "../kit/entries";
@@ -20,32 +19,9 @@ import {
 } from "../kit/shared";
 import { markerCaption } from "../kit/vertical-axis";
 
-export interface HorizontalAxisProps extends Node2DProps {
-  /** `[min, max]` of the horizontal scale the markers are positioned within. */
-  range: Range;
-  /** Tick values (in data units) to draw along the axis. */
-  markers: number[];
-  /**
-   * How each marker is captioned, one per entry of `markers` and in its order.
-   * Empty (the default), or short, captions a marker with its bare numeric
-   * reading; a chart whose x column names months or categories writes those.
-   */
-  captions: string[];
-  /** Marker/caption text style, grid stroke, and gutters — see {@link AxisConfig}. */
-  axis: AxisConfig;
-  /**
-   * Caption drawn centred in the gutter beneath the marker row. Empty string
-   * (the default) hides it.
-   */
-  label: string;
-}
-
 /** How far a marker starts above its slot when it enters, in px. */
 const SLIDE = 24;
 
-/** How a tick value is captioned — see {@link HorizontalAxisProps.captions}. */
-export type MarkerLabel = (value: number) => string;
-
 /**
  * The horizontal axis of a {@link LineChart}: a **row of {@link Text} nodes**,
  * one per marker value, running left-to-right. Pure layout — the mirror of the
@@ -56,7 +32,7 @@ export type MarkerLabel = (value: number) => string;
  * `2026-03` sits three months along, not three slots along. That is what keeps
  * it distinct from a bar chart's bottom axis, which centres a caption on each
  * slot and has no scale at all — the two only look alike. What the values are
- * captioned *as* is the chart's to decide; see {@link HorizontalAxisProps.captions}.
+ * captioned *as* is the chart's to decide, in `captions`.
  *
  * `enter` staggers the markers in **left-to-right**: each starts lifted a
  * little above its slot and transparent, then fades and slides down into place.
@@ -64,10 +40,19 @@ export type MarkerLabel = (value: number) => string;
 export const HorizontalAxis = component2d({
   key: "horizontalAxis",
   state: {
+    /** `[min, max]` of the horizontal scale the markers are positioned within. */
     range: fresh<Range>(() => [0, 1]),
+    /** Tick values (in data units) to draw along the axis. */
     markers: fresh<number[]>(() => []),
+    /**
+     * How each marker is captioned, one per entry of `markers` and in its order.
+     * Empty (the default), or short, captions a marker with its bare numeric
+     * reading; a chart whose x column names months or categories writes those.
+     */
     captions: fresh<string[]>(() => []),
+    /** Marker/caption text style, grid stroke, and gutters — see {@link AxisConfig}. */
     axis: Types.custom<AxisConfig>(DEFAULT_X_AXIS),
+    /** Caption drawn centred in the gutter beneath the marker row; empty (the default) hides it. */
     label: "",
     arrivals: arrivalsEntry(),
   },

package/src/line-chart/line-chart.ts

@@ -169,12 +169,25 @@ function drawnY(s: LineChartValues, domain: AxisDomainConfig): AxisDomainConfig
   return { ...domain, range, ticks: domain.ticks ?? markerValues(range, DEFAULT_MARKERS - 1) }
 }
 
+/** The last domains worked out from each data array, and what else they were read from. */
+const domainsDrawn = new WeakMap<
+  DataRecord[],
+  Pick<LineChartValues, "xField" | "xAxis" | "yAxis" | "series"> & { readonly domains: LineChartDomains }
+>()
+
 /** Both axes as a line chart draws them now, an auto range or tick row read back as itself. */
 export function lineChartDomains(s: LineChartValues): LineChartDomains {
-  return {
-    x: settleAxisDomain(s.xAxis, (d) => drawnX(s, d)) as LineChartDomains["x"],
-    y: settleAxisDomain(s.yAxis, (d) => drawnY(s, d)) as LineChartDomains["y"],
+  const { data, xField, xAxis, yAxis, series } = s
+  const kept = domainsDrawn.get(data)
+  if (kept && kept.xField === xField && kept.xAxis === xAxis && kept.yAxis === yAxis && kept.series === series) {
+    return kept.domains
+  }
+  const domains = {
+    x: settleAxisDomain(xAxis, (d) => drawnX(s, d)) as LineChartDomains["x"],
+    y: settleAxisDomain(yAxis, (d) => drawnY(s, d)) as LineChartDomains["y"],
   }
+  domainsDrawn.set(data, { xField, xAxis, yAxis, series, domains })
+  return domains
 }
 
 /**
@@ -333,6 +346,7 @@ export const LineChart = component2d({
   },
   // Its parts fill it; a node made of them would hug them.
   defaults: { width: "fill", height: "fill" },
+  allowedChildren: [],
   children: (state) => {
     const theme = () => state.theme
     const domains = () => lineChartDomains(state)
@@ -440,10 +454,7 @@ export const LineChart = component2d({
       height: 0,
     }) as unknown as Node2D
 
-    return asParts([
-      ...(state.children as unknown as Node2D[]),
-      cartesianFrame({ axis: vAxis as unknown as Node2D, plot, gutter, below }),
-    ])
+    return asParts([cartesianFrame({ axis: vAxis as unknown as Node2D, plot, gutter, below })])
   },
   commands: {
     /**
@@ -457,6 +468,8 @@ export const LineChart = component2d({
      */
     enter: {
       args: {},
+      // Held from the chart's arrival, so it never shows finished ahead of its draw.
+      entrance: true,
       easing: easeOut(),
       run: (timeline, state, children) => {
         const parts = partsOf(children)

package/src/line-chart/x-scale.ts

@@ -304,15 +304,30 @@ function labelBySample(
   return i >= 0 ? captions[i] : fallback(value)
 }
 
+/** Scales already resolved, by data array, then by field and pattern. */
+const scales = new WeakMap<DataRecord[], Map<string, XScale>>()
+
 /**
  * How `field` positions the rows: the number it holds, the instant it names, or
  * failing both, the row's own place in the file.
  *
- * Resolved from the data on every read rather than cached on the node: it is
- * cheap (one pass to classify, one to position), and a cache keyed on a `data`
- * array that a rebuild replaces on every edit would miss every time anyway.
+ * Kept per `data` array: a chart's bound props ask a dozen times a frame, and
+ * parsing every row's instant each time was most of a frame.
  */
 export function resolveXScale(
+  data: DataRecord[],
+  field: string,
+  pattern?: string
+): XScale {
+  let byKey = scales.get(data)
+  if (!byKey) scales.set(data, (byKey = new Map()))
+  const key = JSON.stringify([field, pattern ?? null])
+  let scale = byKey.get(key)
+  if (!scale) byKey.set(key, (scale = xScaleOf(data, field, pattern)))
+  return scale
+}
+
+function xScaleOf(
   data: DataRecord[],
   field: string,
   /**

package/src/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json

@@ -0,0 +1 @@
+{"version":"4.1.9","results":[[":document.test.ts",{"duration":547.3535000000002,"failed":false}],[":pie-chart/pie-ring.test.ts",{"duration":115.20639999999958,"failed":false}],[":bar-chart/bar-chart.test.ts",{"duration":337.1051000000002,"failed":false}],[":line-chart/line-chart.test.ts",{"duration":256.0781999999999,"failed":false}],[":kit/theme.test.ts",{"duration":23.301500000000033,"failed":false}],[":pie-chart/pie-chart.test.ts",{"duration":243.7885000000001,"failed":false}],[":kit/chart-legend.test.ts",{"duration":107.26519999999982,"failed":false}],[":line-chart/x-scale.test.ts",{"duration":6.663699999999608,"failed":false}],[":kit/shared.test.ts",{"duration":8.266599999999926,"failed":false}],[":nodes.test.ts",{"duration":34.65560000000005,"failed":false}],[":line-chart/chart-line.test.ts",{"duration":25.551500000000033,"failed":false}],[":kit/vertical-axis.test.ts",{"duration":57.74340000000029,"failed":false}],[":line-chart/shared.test.ts",{"duration":8.284700000000157,"failed":false}],[":line-chart/horizontal-axis.test.ts",{"duration":45.18509999999969,"failed":false}],[":bar-chart/category-axis.test.ts",{"duration":43.834299999999985,"failed":false}],[":kit/chart-canvas.test.ts",{"duration":14.003599999999892,"failed":false}],[":bar-chart/shared.test.ts",{"duration":6.999300000000062,"failed":false}],[":pie-chart/shared.test.ts",{"duration":5.208399999999983,"failed":false}],[":kit/declare-paints.test.ts",{"duration":11.566000000000031,"failed":false}],[":tests/leaf.test.ts",{"duration":15.790100000000052,"failed":false}]]}

package/src/pie-chart/pie-chart.ts

@@ -179,6 +179,7 @@ export const PieChart = component2d({
     height: "fill",
     pops: (state) => slicesOf(state).map(() => 0),
   },
+  allowedChildren: [],
   // The slice *structure* (one label and one legend row per row) is read once;
   // the slices themselves, their paint and the selection are bound, so a theme
   // tween re-paints and a `set` of `data` re-cuts the wedges.
@@ -216,7 +217,7 @@ export const PieChart = component2d({
       )
     }
     const row = new Rect({ flow: "horizontal", width: "fill", height: "fill", gap: state.gap, align: "center", children: parts })
-    return asParts([...(state.children as unknown as Node2D[]), row as unknown as Node2D])
+    return asParts([row as unknown as Node2D])
   },
   commands: {
     /**
@@ -227,6 +228,8 @@ export const PieChart = component2d({
      */
     enter: {
       args: {},
+      // Held from the chart's arrival, so it never shows finished ahead of its draw.
+      entrance: true,
       easing: easeOut(),
       run: (timeline, _state, children) => {
         const parts = partsOf(children)

package/src/pie-chart/shared.ts

@@ -33,7 +33,6 @@ import {
   CHART_PALETTE,
   DEFAULT_LEGEND,
   DEFAULT_SERIES_FILLS,
-  SPOTLIGHT_DIM,
   lerpLegendConfig,
   lerpSeriesFills,
   num,
@@ -306,6 +305,13 @@ const LABEL_TEXT_STYLE: TextStyle = {
   fill: CHART_PALETTE.markerColor,
 }
 
+/**
+ * Opacity the other slices fade to under a selection. Fainter than the line and
+ * bar charts' `SPOTLIGHT_DIM`: a ring's slices touch, so at that a selected
+ * slice barely separates from its neighbours.
+ */
+export const PIE_SPOTLIGHT_DIM = 0.1
+
 /** The pie chart's out-of-the-box look. */
 export const DEFAULT_PIE_CHART_THEME: PieChartConfig = {
   sliceFills: DEFAULT_SERIES_FILLS,
@@ -343,7 +349,7 @@ export const DEFAULT_PIE_CHART_THEME: PieChartConfig = {
     },
   },
   legend: DEFAULT_LEGEND,
-  spotlight: { dimOpacity: SPOTLIGHT_DIM },
+  spotlight: { dimOpacity: PIE_SPOTLIGHT_DIM },
 }
 
 function resolveRingConfig(
@@ -442,7 +448,7 @@ function lerpCenterConfig(
 }
 
 /**
- * {@link PieChart}'s `theme` @property mapper: merges the author's partial
+ * {@link PieChart}'s `theme` property mapper: merges the author's partial
  * {@link PieChartTheme} onto `previous` (falling back to
  * {@link DEFAULT_PIE_CHART_THEME} on first resolution), fully resolving every
  * leaf so the tween below always has resolved data to interpolate.
@@ -464,7 +470,7 @@ export function resolvePieChartTheme(
   }
 }
 
-/** {@link PieChart}'s `theme` @property tween — leaf by leaf. */
+/** {@link PieChart}'s `theme` property tween — leaf by leaf. */
 export function lerpPieChartTheme(
   from: PieChartConfig,
   to: PieChartConfig,