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

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

@@ -1 +1 @@
-{"version":3,"file":"x-scale.js","sourceRoot":"","sources":["../../src/line-chart/x-scale.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * What a line chart's x column *means* — the one question that has to be\r\n * answered before a row can be given a position along the bottom of the plot.\r\n *\r\n * A y column is always a magnitude. An x column is one of three things, and\r\n * which one is a property of the data rather than something the author states:\r\n *\r\n * - **numeric** — `0, 5, 10` — plot the number.\r\n * - **time** — `Jan`, `2026-03`, `2026-W12`, `2026-03-14` — plot the instant,\r\n *   so samples a month apart sit a month apart and a gap in the data reads as a\r\n *   gap.\r\n * - **ordinal** — anything else — plot the row's position, evenly spaced.\r\n *\r\n * Before this, every x column went through `num()`, which reads a non-numeric\r\n * cell as `0`. A `Month` column of `Jan…Dec` therefore stacked all twelve\r\n * points on one x and drew a vertical line — no error, no empty chart, just a\r\n * wrong picture. That is the failure this module exists to remove: every column\r\n * now plots as *something*, and the something is the reading a person would\r\n * give it.\r\n *\r\n * The captions come back off the rows rather than out of a formatter. A tick on\r\n * a time or ordinal scale is chosen *from the data* (see {@link XScale.ticks}),\r\n * so the label it wants is the cell the author wrote — `Jan`, not `1970-01-01`,\r\n * and `2026-W12`, not the Monday it resolves to. Only a tick that is not a\r\n * sample — an author-set range, or a `zoomTo` mid-flight — needs formatting,\r\n * and that is the one case {@link formatInstant} covers.\r\n */\r\n\r\nimport type { DataRecord } from \"@motionscript/sdk\"\r\n\r\nimport {\r\n  formatMarker,\r\n  markerValues,\r\n  num,\r\n  text,\r\n  type Range,\r\n} from \"../kit/shared\"\r\nimport { formatNumber } from \"@motionscript/sdk/component\"\r\n\r\n/** How an x column's cells become positions along the axis. */\r\nexport type XScaleKind = \"numeric\" | \"time\" | \"ordinal\"\r\n\r\n/**\r\n * An x column resolved into positions, captions and ticks.\r\n *\r\n * The three kinds differ in all three answers, so they are three closures built\r\n * once per (data, column) rather than a kind tag every caller switches on.\r\n */\r\nexport interface XScale {\r\n  kind: XScaleKind\r\n  /** Position of row `index` along the axis, in this scale's own units. */\r\n  at(index: number): number\r\n  /** `[min, max]` across the rows — the scale when no range is set. */\r\n  extent: Range\r\n  /** The caption for a tick at `value`. */\r\n  label(value: number): string\r\n  /** `divisions + 1` tick values spanning `range`, ends included. */\r\n  ticks(range: Range, divisions: number): number[]\r\n}\r\n\r\n// ---- Time parsing --------------------------------------------------------\r\n\r\nconst DAY = 86_400_000\r\n\r\nconst MONTHS = [\r\n  \"january\",\r\n  \"february\",\r\n  \"march\",\r\n  \"april\",\r\n  \"may\",\r\n  \"june\",\r\n  \"july\",\r\n  \"august\",\r\n  \"september\",\r\n  \"october\",\r\n  \"november\",\r\n  \"december\",\r\n]\r\n\r\n/**\r\n * The year a cell that names no year is dated into.\r\n *\r\n * Any year would place `Jan…Dec` in the right order at the right spacing; a\r\n * leap year is the one that also spaces February correctly against a column\r\n * that *does* carry years, so the two read alike.\r\n */\r\nconst NOMINAL_YEAR = 2024\r\n\r\n/**\r\n * Month index for any unambiguous abbreviation of a month name — `jan`, `sept`,\r\n * `january` — or -1.\r\n *\r\n * Three letters minimum, and then a prefix match, which is what lets `sept`\r\n * through without letting `janitor` through: a longer word has to still *be*\r\n * the month.\r\n */\r\nfunction monthIndex(word: string): number {\r\n  if (word.length < 3) return -1\r\n  return MONTHS.findIndex((month) => month.startsWith(word))\r\n}\r\n\r\n/** The Monday of ISO week `week` in `year`, as an epoch timestamp. */\r\nfunction isoWeekStart(year: number, week: number): number {\r\n  // ISO week 1 is the week containing 4 January, and weeks start on Monday.\r\n  const jan4 = Date.UTC(year, 0, 4)\r\n  const weekday = (new Date(jan4).getUTCDay() + 6) % 7 // Monday = 0\r\n  return jan4 - weekday * DAY + (week - 1) * 7 * DAY\r\n}\r\n\r\n/**\r\n * One cell read as an instant, or `null` when it isn't one.\r\n *\r\n * Deliberately **not** `Date.parse`. That accepts `\"5\"`, `\"Q3\"` and a good deal\r\n * else besides, differs between engines on anything non-ISO, and reads a bare\r\n * `2026-03-14` as UTC but `2026/03/14` as local — three ways for a column to be\r\n * silently misread as time. Every form below is matched explicitly, and an\r\n * ambiguous all-numeric date (`03/04/2026` — March or April, depending on where\r\n * the author lives) is deliberately not one of them.\r\n */\r\nexport function parseInstant(raw: unknown): number | null {\r\n  if (typeof raw !== \"string\") return null\r\n  const s = raw.trim().toLowerCase()\r\n  if (s === \"\") return null\r\n\r\n  // 2026-03-14 · 2026/03/14 · 2026-03 · 2026/03\r\n  const ymd = /^(\\d{4})[-/](\\d{1,2})(?:[-/](\\d{1,2}))?$/.exec(s)\r\n  if (ymd) {\r\n    const month = Number(ymd[2])\r\n    const day = ymd[3] === undefined ? 1 : Number(ymd[3])\r\n    if (month < 1 || month > 12 || day < 1 || day > 31) return null\r\n    return Date.UTC(Number(ymd[1]), month - 1, day)\r\n  }\r\n\r\n  // 2026-W12 · 2026W12 · w12 · week 12\r\n  const week = /^(?:(\\d{4})[-\\s]?)?w(?:ee)?k?[-\\s]?(\\d{1,2})$/.exec(s)\r\n  if (week) {\r\n    const n = Number(week[2])\r\n    if (n < 1 || n > 53) return null\r\n    return isoWeekStart(\r\n      week[1] === undefined ? NOMINAL_YEAR : Number(week[1]),\r\n      n\r\n    )\r\n  }\r\n\r\n  // jan · january · jan 2026 · january-2026 · 2026 jan\r\n  const named = /^(?:(\\d{4})[-\\s]+)?([a-z]+)(?:[-\\s]+(\\d{4}))?$/.exec(s)\r\n  if (named) {\r\n    const month = monthIndex(named[2])\r\n    if (month >= 0) {\r\n      const year = named[1] ?? named[3]\r\n      const y = year === undefined ? NOMINAL_YEAR : Number(year)\r\n      return Date.UTC(y, month, 1)\r\n    }\r\n  }\r\n\r\n  // 14 mar 2026 · mar 14 2026 · mar 14, 2026\r\n  const dayNamed =\r\n    /^(?:(\\d{1,2})[-\\s]+([a-z]+)|([a-z]+)[-\\s]+(\\d{1,2}),?)[-\\s]+(\\d{4})$/.exec(\r\n      s\r\n    )\r\n  if (dayNamed) {\r\n    const month = monthIndex(dayNamed[2] ?? dayNamed[3])\r\n    const day = Number(dayNamed[1] ?? dayNamed[4])\r\n    if (month >= 0 && day >= 1 && day <= 31) {\r\n      return Date.UTC(Number(dayNamed[5]), month, day)\r\n    }\r\n  }\r\n\r\n  return null\r\n}\r\n\r\n/**\r\n * An instant captioned at the coarsest granularity the axis's own span can tell\r\n * apart — a decade of samples reads as years, a year of them as months.\r\n *\r\n * Only reached for a tick that is *not* one of the rows (an author-set range, a\r\n * `zoomTo` part-way through). A tick that is a sample is captioned with the\r\n * cell the author wrote; see the note at the top of this file.\r\n */\r\nexport function formatInstant(value: number, span: number): string {\r\n  const date = new Date(value)\r\n  const year = date.getUTCFullYear()\r\n  const month = MONTHS[date.getUTCMonth()].slice(0, 3)\r\n  const label = month.charAt(0).toUpperCase() + month.slice(1)\r\n  if (span > 4 * 365 * DAY) return String(year)\r\n  if (span > 60 * DAY) return `${label} ${year}`\r\n  return `${label} ${date.getUTCDate()}`\r\n}\r\n\r\n// ---- Column reading ------------------------------------------------------\r\n\r\n/**\r\n * Whether every non-empty cell of `field` holds a number.\r\n *\r\n * The same rule `numericFields` applies, asked of one column: a single text\r\n * cell in an otherwise numeric column takes the whole column off the numeric\r\n * scale, because plotting that row at 0 is the failure this module is here to\r\n * stop.\r\n */\r\nfunction isNumericColumn(data: DataRecord[], field: string): boolean {\r\n  let sawValue = false\r\n  for (const row of data) {\r\n    const v = row[field]\r\n    if (v === undefined || v === null || v === \"\") continue\r\n    if (typeof v !== \"number\") return false\r\n    sawValue = true\r\n  }\r\n  return sawValue\r\n}\r\n\r\n/**\r\n * Every non-empty cell of `field` parsed as an instant, or `null` if any one of\r\n * them isn't one — in which case the column isn't a time column at all.\r\n *\r\n * A blank cell keeps its slot, so the returned list stays index-aligned with\r\n * the rows, and takes the nearest known instant: a hole in an x column is a row\r\n * whose date the file didn't say, and stacking it on the epoch would drag the\r\n * whole scale back fifty years to make room for it.\r\n */\r\nfunction instantColumn(data: DataRecord[], field: string): number[] | null {\r\n  const parsed: (number | null)[] = []\r\n  let sawValue = false\r\n  for (const row of data) {\r\n    const raw = row[field]\r\n    if (raw === undefined || raw === null || raw === \"\") {\r\n      parsed.push(null)\r\n      continue\r\n    }\r\n    const t = parseInstant(raw)\r\n    if (t === null) return null\r\n    parsed.push(t)\r\n    sawValue = true\r\n  }\r\n  if (!sawValue) return null\r\n\r\n  const first = parsed.find((t): t is number => t !== null) as number\r\n  let last = first\r\n  return parsed.map((t) => (t === null ? last : (last = t)))\r\n}\r\n\r\n/** `[min, max]` of `values`, or `[0, 1]` when there is nothing to span. */\r\nfunction extentOf(values: number[]): Range {\r\n  let lo = Infinity\r\n  let hi = -Infinity\r\n  for (const v of values) {\r\n    if (v < lo) lo = v\r\n    if (v > hi) hi = v\r\n  }\r\n  return lo <= hi ? [lo, hi] : [0, 1]\r\n}\r\n\r\n/**\r\n * Ticks spanning `range`, each one **a sample** — a row the author can point at\r\n * in their file — placed as near as it can be to where an evenly spaced tick\r\n * would have gone.\r\n *\r\n * Two things have to hold at once, and picking either alone gets it wrong.\r\n * Ticks must be *samples*, because a caption between two of them has nothing to\r\n * say (two-thirds of the way through March is not a month, and on a category\r\n * column it is not anything at all). And they must be *spread*, because the\r\n * labels sit side by side in a row: taking every nth sample instead puts five\r\n * dates in the two weeks a burst of rows happens to cover and prints them on\r\n * top of each other, which is what a column with a gap in it does.\r\n *\r\n * Walking the targets rather than the samples is what satisfies both. A run of\r\n * rows too close together to caption collapses to one tick — consecutive\r\n * targets pick the same sample and the duplicate is dropped — so a chart asked\r\n * for five ticks across a gappy column draws four honest ones instead of five\r\n * overlapping.\r\n */\r\nfunction sampledTicks(\r\n  positions: number[],\r\n  [min, max]: Range,\r\n  divisions: number\r\n): number[] {\r\n  const inside = positions.filter((v) => v >= min && v <= max)\r\n  const unique = [...new Set(inside)].sort((a, b) => a - b)\r\n  if (unique.length === 0) return markerValues([min, max], divisions)\r\n\r\n  const nearest = (target: number) =>\r\n    unique.reduce((best, v) =>\r\n      Math.abs(v - target) < Math.abs(best - target) ? v : best\r\n    )\r\n\r\n  const out: number[] = []\r\n  for (const target of markerValues([min, max], divisions)) {\r\n    const tick = nearest(target)\r\n    if (out[out.length - 1] !== tick) out.push(tick)\r\n  }\r\n  return out\r\n}\r\n\r\n/**\r\n * The caption a tick carries on a sample-based scale: the cell of the row it\r\n * came from, or `fallback` when the tick isn't a sample after all.\r\n */\r\nfunction labelBySample(\r\n  positions: number[],\r\n  captions: string[],\r\n  value: number,\r\n  fallback: (value: number) => string\r\n): string {\r\n  const i = positions.indexOf(value)\r\n  return i >= 0 ? captions[i] : fallback(value)\r\n}\r\n\r\n/**\r\n * How `field` positions the rows: the number it holds, the instant it names, or\r\n * failing both, the row's own place in the file.\r\n *\r\n * Resolved from the data on every read rather than cached on the node: it is\r\n * cheap (one pass to classify, one to position), and a cache keyed on a `data`\r\n * array that a rebuild replaces on every edit would miss every time anyway.\r\n */\r\nexport function resolveXScale(\r\n  data: DataRecord[],\r\n  field: string,\r\n  /**\r\n   * The number-format pattern for a *numeric* column. Ignored by the other two\r\n   * kinds, and correctly so: a tick on those is captioned with the cell the\r\n   * author wrote, and `Jan` has no decimal places.\r\n   */\r\n  pattern?: string\r\n): XScale {\r\n  if (field !== \"\" && isNumericColumn(data, field)) {\r\n    const positions = data.map((row) => num(row, field))\r\n    return {\r\n      kind: \"numeric\",\r\n      at: (i) => positions[i] ?? 0,\r\n      extent: extentOf(positions),\r\n      label: (value) =>\r\n        pattern === undefined ? formatMarker(value) : formatNumber(value, pattern),\r\n      // Round numbers, evenly spaced — a continuous axis is read by its scale\r\n      // rather than by which samples happen to be on it.\r\n      ticks: markerValues,\r\n    }\r\n  }\r\n\r\n  const captions = data.map((row) => text(row, field))\r\n  const instants = field === \"\" ? null : instantColumn(data, field)\r\n\r\n  if (instants) {\r\n    const extent = extentOf(instants)\r\n    const span = extent[1] - extent[0]\r\n    return {\r\n      kind: \"time\",\r\n      at: (i) => instants[i] ?? 0,\r\n      extent,\r\n      label: (value) =>\r\n        labelBySample(instants, captions, value, (v) =>\r\n          formatInstant(v, span)\r\n        ),\r\n      ticks: (range, divisions) => sampledTicks(instants, range, divisions),\r\n    }\r\n  }\r\n\r\n  const positions = data.map((_, i) => i)\r\n  return {\r\n    kind: \"ordinal\",\r\n    at: (i) => i,\r\n    // `[0, n-1]` rather than the tidy `[0, n]`: the first and last rows sit on\r\n    // the plot's edges, which is where a reader looks for them.\r\n    extent: positions.length > 0 ? [0, positions.length - 1] : [0, 1],\r\n    label: (value) => captions[Math.round(value)] ?? \"\",\r\n    ticks: (range, divisions) => sampledTicks(positions, range, divisions),\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"x-scale.js","sourceRoot":"","sources":["../../src/line-chart/x-scale.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * What a line chart's x column *means* — the one question that has to be\r\n * answered before a row can be given a position along the bottom of the plot.\r\n *\r\n * A y column is always a magnitude. An x column is one of three things, and\r\n * which one is a property of the data rather than something the author states:\r\n *\r\n * - **numeric** — `0, 5, 10` — plot the number.\r\n * - **time** — `Jan`, `2026-03`, `2026-W12`, `2026-03-14` — plot the instant,\r\n *   so samples a month apart sit a month apart and a gap in the data reads as a\r\n *   gap.\r\n * - **ordinal** — anything else — plot the row's position, evenly spaced.\r\n *\r\n * Before this, every x column went through `num()`, which reads a non-numeric\r\n * cell as `0`. A `Month` column of `Jan…Dec` therefore stacked all twelve\r\n * points on one x and drew a vertical line — no error, no empty chart, just a\r\n * wrong picture. That is the failure this module exists to remove: every column\r\n * now plots as *something*, and the something is the reading a person would\r\n * give it.\r\n *\r\n * The captions come back off the rows rather than out of a formatter. A tick on\r\n * a time or ordinal scale is chosen *from the data* (see {@link XScale.ticks}),\r\n * so the label it wants is the cell the author wrote — `Jan`, not `1970-01-01`,\r\n * and `2026-W12`, not the Monday it resolves to. Only a tick that is not a\r\n * sample — an author-set range, or a `zoomTo` mid-flight — needs formatting,\r\n * and that is the one case {@link formatInstant} covers.\r\n */\r\n\r\nimport type { DataRecord } from \"@motionscript/sdk\"\r\n\r\nimport {\r\n  formatMarker,\r\n  markerValues,\r\n  num,\r\n  text,\r\n  type Range,\r\n} from \"../kit/shared\"\r\nimport { formatNumber } from \"@motionscript/sdk/component\"\r\n\r\n/** How an x column's cells become positions along the axis. */\r\nexport type XScaleKind = \"numeric\" | \"time\" | \"ordinal\"\r\n\r\n/**\r\n * An x column resolved into positions, captions and ticks.\r\n *\r\n * The three kinds differ in all three answers, so they are three closures built\r\n * once per (data, column) rather than a kind tag every caller switches on.\r\n */\r\nexport interface XScale {\r\n  kind: XScaleKind\r\n  /** Position of row `index` along the axis, in this scale's own units. */\r\n  at(index: number): number\r\n  /** `[min, max]` across the rows — the scale when no range is set. */\r\n  extent: Range\r\n  /** The caption for a tick at `value`. */\r\n  label(value: number): string\r\n  /** `divisions + 1` tick values spanning `range`, ends included. */\r\n  ticks(range: Range, divisions: number): number[]\r\n}\r\n\r\n// ---- Time parsing --------------------------------------------------------\r\n\r\nconst DAY = 86_400_000\r\n\r\nconst MONTHS = [\r\n  \"january\",\r\n  \"february\",\r\n  \"march\",\r\n  \"april\",\r\n  \"may\",\r\n  \"june\",\r\n  \"july\",\r\n  \"august\",\r\n  \"september\",\r\n  \"october\",\r\n  \"november\",\r\n  \"december\",\r\n]\r\n\r\n/**\r\n * The year a cell that names no year is dated into.\r\n *\r\n * Any year would place `Jan…Dec` in the right order at the right spacing; a\r\n * leap year is the one that also spaces February correctly against a column\r\n * that *does* carry years, so the two read alike.\r\n */\r\nconst NOMINAL_YEAR = 2024\r\n\r\n/**\r\n * Month index for any unambiguous abbreviation of a month name — `jan`, `sept`,\r\n * `january` — or -1.\r\n *\r\n * Three letters minimum, and then a prefix match, which is what lets `sept`\r\n * through without letting `janitor` through: a longer word has to still *be*\r\n * the month.\r\n */\r\nfunction monthIndex(word: string): number {\r\n  if (word.length < 3) return -1\r\n  return MONTHS.findIndex((month) => month.startsWith(word))\r\n}\r\n\r\n/** The Monday of ISO week `week` in `year`, as an epoch timestamp. */\r\nfunction isoWeekStart(year: number, week: number): number {\r\n  // ISO week 1 is the week containing 4 January, and weeks start on Monday.\r\n  const jan4 = Date.UTC(year, 0, 4)\r\n  const weekday = (new Date(jan4).getUTCDay() + 6) % 7 // Monday = 0\r\n  return jan4 - weekday * DAY + (week - 1) * 7 * DAY\r\n}\r\n\r\n/**\r\n * One cell read as an instant, or `null` when it isn't one.\r\n *\r\n * Deliberately **not** `Date.parse`. That accepts `\"5\"`, `\"Q3\"` and a good deal\r\n * else besides, differs between engines on anything non-ISO, and reads a bare\r\n * `2026-03-14` as UTC but `2026/03/14` as local — three ways for a column to be\r\n * silently misread as time. Every form below is matched explicitly, and an\r\n * ambiguous all-numeric date (`03/04/2026` — March or April, depending on where\r\n * the author lives) is deliberately not one of them.\r\n */\r\nexport function parseInstant(raw: unknown): number | null {\r\n  if (typeof raw !== \"string\") return null\r\n  const s = raw.trim().toLowerCase()\r\n  if (s === \"\") return null\r\n\r\n  // 2026-03-14 · 2026/03/14 · 2026-03 · 2026/03\r\n  const ymd = /^(\\d{4})[-/](\\d{1,2})(?:[-/](\\d{1,2}))?$/.exec(s)\r\n  if (ymd) {\r\n    const month = Number(ymd[2])\r\n    const day = ymd[3] === undefined ? 1 : Number(ymd[3])\r\n    if (month < 1 || month > 12 || day < 1 || day > 31) return null\r\n    return Date.UTC(Number(ymd[1]), month - 1, day)\r\n  }\r\n\r\n  // 2026-W12 · 2026W12 · w12 · week 12\r\n  const week = /^(?:(\\d{4})[-\\s]?)?w(?:ee)?k?[-\\s]?(\\d{1,2})$/.exec(s)\r\n  if (week) {\r\n    const n = Number(week[2])\r\n    if (n < 1 || n > 53) return null\r\n    return isoWeekStart(\r\n      week[1] === undefined ? NOMINAL_YEAR : Number(week[1]),\r\n      n\r\n    )\r\n  }\r\n\r\n  // jan · january · jan 2026 · january-2026 · 2026 jan\r\n  const named = /^(?:(\\d{4})[-\\s]+)?([a-z]+)(?:[-\\s]+(\\d{4}))?$/.exec(s)\r\n  if (named) {\r\n    const month = monthIndex(named[2])\r\n    if (month >= 0) {\r\n      const year = named[1] ?? named[3]\r\n      const y = year === undefined ? NOMINAL_YEAR : Number(year)\r\n      return Date.UTC(y, month, 1)\r\n    }\r\n  }\r\n\r\n  // 14 mar 2026 · mar 14 2026 · mar 14, 2026\r\n  const dayNamed =\r\n    /^(?:(\\d{1,2})[-\\s]+([a-z]+)|([a-z]+)[-\\s]+(\\d{1,2}),?)[-\\s]+(\\d{4})$/.exec(\r\n      s\r\n    )\r\n  if (dayNamed) {\r\n    const month = monthIndex(dayNamed[2] ?? dayNamed[3])\r\n    const day = Number(dayNamed[1] ?? dayNamed[4])\r\n    if (month >= 0 && day >= 1 && day <= 31) {\r\n      return Date.UTC(Number(dayNamed[5]), month, day)\r\n    }\r\n  }\r\n\r\n  return null\r\n}\r\n\r\n/**\r\n * An instant captioned at the coarsest granularity the axis's own span can tell\r\n * apart — a decade of samples reads as years, a year of them as months.\r\n *\r\n * Only reached for a tick that is *not* one of the rows (an author-set range, a\r\n * `zoomTo` part-way through). A tick that is a sample is captioned with the\r\n * cell the author wrote; see the note at the top of this file.\r\n */\r\nexport function formatInstant(value: number, span: number): string {\r\n  const date = new Date(value)\r\n  const year = date.getUTCFullYear()\r\n  const month = MONTHS[date.getUTCMonth()].slice(0, 3)\r\n  const label = month.charAt(0).toUpperCase() + month.slice(1)\r\n  if (span > 4 * 365 * DAY) return String(year)\r\n  if (span > 60 * DAY) return `${label} ${year}`\r\n  return `${label} ${date.getUTCDate()}`\r\n}\r\n\r\n// ---- Column reading ------------------------------------------------------\r\n\r\n/**\r\n * Whether every non-empty cell of `field` holds a number.\r\n *\r\n * The same rule `numericFields` applies, asked of one column: a single text\r\n * cell in an otherwise numeric column takes the whole column off the numeric\r\n * scale, because plotting that row at 0 is the failure this module is here to\r\n * stop.\r\n */\r\nfunction isNumericColumn(data: DataRecord[], field: string): boolean {\r\n  let sawValue = false\r\n  for (const row of data) {\r\n    const v = row[field]\r\n    if (v === undefined || v === null || v === \"\") continue\r\n    if (typeof v !== \"number\") return false\r\n    sawValue = true\r\n  }\r\n  return sawValue\r\n}\r\n\r\n/**\r\n * Every non-empty cell of `field` parsed as an instant, or `null` if any one of\r\n * them isn't one — in which case the column isn't a time column at all.\r\n *\r\n * A blank cell keeps its slot, so the returned list stays index-aligned with\r\n * the rows, and takes the nearest known instant: a hole in an x column is a row\r\n * whose date the file didn't say, and stacking it on the epoch would drag the\r\n * whole scale back fifty years to make room for it.\r\n */\r\nfunction instantColumn(data: DataRecord[], field: string): number[] | null {\r\n  const parsed: (number | null)[] = []\r\n  let sawValue = false\r\n  for (const row of data) {\r\n    const raw = row[field]\r\n    if (raw === undefined || raw === null || raw === \"\") {\r\n      parsed.push(null)\r\n      continue\r\n    }\r\n    const t = parseInstant(raw)\r\n    if (t === null) return null\r\n    parsed.push(t)\r\n    sawValue = true\r\n  }\r\n  if (!sawValue) return null\r\n\r\n  const first = parsed.find((t): t is number => t !== null) as number\r\n  let last = first\r\n  return parsed.map((t) => (t === null ? last : (last = t)))\r\n}\r\n\r\n/** `[min, max]` of `values`, or `[0, 1]` when there is nothing to span. */\r\nfunction extentOf(values: number[]): Range {\r\n  let lo = Infinity\r\n  let hi = -Infinity\r\n  for (const v of values) {\r\n    if (v < lo) lo = v\r\n    if (v > hi) hi = v\r\n  }\r\n  return lo <= hi ? [lo, hi] : [0, 1]\r\n}\r\n\r\n/**\r\n * Ticks spanning `range`, each one **a sample** — a row the author can point at\r\n * in their file — placed as near as it can be to where an evenly spaced tick\r\n * would have gone.\r\n *\r\n * Two things have to hold at once, and picking either alone gets it wrong.\r\n * Ticks must be *samples*, because a caption between two of them has nothing to\r\n * say (two-thirds of the way through March is not a month, and on a category\r\n * column it is not anything at all). And they must be *spread*, because the\r\n * labels sit side by side in a row: taking every nth sample instead puts five\r\n * dates in the two weeks a burst of rows happens to cover and prints them on\r\n * top of each other, which is what a column with a gap in it does.\r\n *\r\n * Walking the targets rather than the samples is what satisfies both. A run of\r\n * rows too close together to caption collapses to one tick — consecutive\r\n * targets pick the same sample and the duplicate is dropped — so a chart asked\r\n * for five ticks across a gappy column draws four honest ones instead of five\r\n * overlapping.\r\n */\r\nfunction sampledTicks(\r\n  positions: number[],\r\n  [min, max]: Range,\r\n  divisions: number\r\n): number[] {\r\n  const inside = positions.filter((v) => v >= min && v <= max)\r\n  const unique = [...new Set(inside)].sort((a, b) => a - b)\r\n  if (unique.length === 0) return markerValues([min, max], divisions)\r\n\r\n  const nearest = (target: number) =>\r\n    unique.reduce((best, v) =>\r\n      Math.abs(v - target) < Math.abs(best - target) ? v : best\r\n    )\r\n\r\n  const out: number[] = []\r\n  for (const target of markerValues([min, max], divisions)) {\r\n    const tick = nearest(target)\r\n    if (out[out.length - 1] !== tick) out.push(tick)\r\n  }\r\n  return out\r\n}\r\n\r\n/**\r\n * The caption a tick carries on a sample-based scale: the cell of the row it\r\n * came from, or `fallback` when the tick isn't a sample after all.\r\n */\r\nfunction labelBySample(\r\n  positions: number[],\r\n  captions: string[],\r\n  value: number,\r\n  fallback: (value: number) => string\r\n): string {\r\n  const i = positions.indexOf(value)\r\n  return i >= 0 ? captions[i] : fallback(value)\r\n}\r\n\r\n/** Scales already resolved, by data array, then by field and pattern. */\r\nconst scales = new WeakMap<DataRecord[], Map<string, XScale>>()\r\n\r\n/**\r\n * How `field` positions the rows: the number it holds, the instant it names, or\r\n * failing both, the row's own place in the file.\r\n *\r\n * Kept per `data` array: a chart's bound props ask a dozen times a frame, and\r\n * parsing every row's instant each time was most of a frame.\r\n */\r\nexport function resolveXScale(\r\n  data: DataRecord[],\r\n  field: string,\r\n  pattern?: string\r\n): XScale {\r\n  let byKey = scales.get(data)\r\n  if (!byKey) scales.set(data, (byKey = new Map()))\r\n  const key = JSON.stringify([field, pattern ?? null])\r\n  let scale = byKey.get(key)\r\n  if (!scale) byKey.set(key, (scale = xScaleOf(data, field, pattern)))\r\n  return scale\r\n}\r\n\r\nfunction xScaleOf(\r\n  data: DataRecord[],\r\n  field: string,\r\n  /**\r\n   * The number-format pattern for a *numeric* column. Ignored by the other two\r\n   * kinds, and correctly so: a tick on those is captioned with the cell the\r\n   * author wrote, and `Jan` has no decimal places.\r\n   */\r\n  pattern?: string\r\n): XScale {\r\n  if (field !== \"\" && isNumericColumn(data, field)) {\r\n    const positions = data.map((row) => num(row, field))\r\n    return {\r\n      kind: \"numeric\",\r\n      at: (i) => positions[i] ?? 0,\r\n      extent: extentOf(positions),\r\n      label: (value) =>\r\n        pattern === undefined ? formatMarker(value) : formatNumber(value, pattern),\r\n      // Round numbers, evenly spaced — a continuous axis is read by its scale\r\n      // rather than by which samples happen to be on it.\r\n      ticks: markerValues,\r\n    }\r\n  }\r\n\r\n  const captions = data.map((row) => text(row, field))\r\n  const instants = field === \"\" ? null : instantColumn(data, field)\r\n\r\n  if (instants) {\r\n    const extent = extentOf(instants)\r\n    const span = extent[1] - extent[0]\r\n    return {\r\n      kind: \"time\",\r\n      at: (i) => instants[i] ?? 0,\r\n      extent,\r\n      label: (value) =>\r\n        labelBySample(instants, captions, value, (v) =>\r\n          formatInstant(v, span)\r\n        ),\r\n      ticks: (range, divisions) => sampledTicks(instants, range, divisions),\r\n    }\r\n  }\r\n\r\n  const positions = data.map((_, i) => i)\r\n  return {\r\n    kind: \"ordinal\",\r\n    at: (i) => i,\r\n    // `[0, n-1]` rather than the tidy `[0, n]`: the first and last rows sit on\r\n    // the plot's edges, which is where a reader looks for them.\r\n    extent: positions.length > 0 ? [0, positions.length - 1] : [0, 1],\r\n    label: (value) => captions[Math.round(value)] ?? \"\",\r\n    ticks: (range, divisions) => sampledTicks(positions, range, divisions),\r\n  }\r\n}\r\n"]}

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

@@ -94,7 +94,7 @@ export declare const PieChart: import("@motionscript/sdk").Component<"pieChart",
         readonly sliceIndex: import("@motionscript/sdk").Type<number, number, false>;
     };
     readonly clearSelection: {};
-}, null, Node2D<Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+}, readonly [], Node2D<Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
     readonly data: import("@motionscript/sdk").Type<DataRecord[], DataRecord[], false>;
     readonly categoryField: "";
     readonly valueField: "";
@@ -114,6 +114,39 @@ export declare const PieChart: import("@motionscript/sdk").Component<"pieChart",
     readonly showLegend: import("@motionscript/sdk").Type<boolean, boolean, false>;
     /** Read as the chart is built: whether the hole's summary is drawn at rest. */
     readonly showCenter: import("@motionscript/sdk").Type<boolean, boolean, false>;
-}>, null>>;
+}>, readonly [], import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly data: import("@motionscript/sdk").Type<DataRecord[], DataRecord[], false>;
+    readonly categoryField: "";
+    readonly valueField: "";
+    readonly theme: import("@motionscript/sdk").Type<PieChartTheme, PieChartConfig, false>;
+    readonly labelMode: import("@motionscript/sdk").Type<PieLabelMode, PieLabelMode, false>;
+    readonly labelPlacement: import("@motionscript/sdk").Type<PieLabelPlacement, PieLabelPlacement, false>;
+    readonly gap: 40;
+    readonly centerLabel: "";
+    readonly centerCaption: "";
+    /**
+     * How far each slice is pushed out of the ring, `0`–`1` per index. Held here
+     * rather than on the ring because two parts read it: the wedges grow out by
+     * it, and the legend entries dim by it. Seeded flush, one to a row.
+     */
+    readonly pops: import("@motionscript/sdk").Type<number[], number[], false>;
+    /** Read as the chart is built: the legend is a part the chart builds or doesn't. */
+    readonly showLegend: import("@motionscript/sdk").Type<boolean, boolean, false>;
+    /** Read as the chart is built: whether the hole's summary is drawn at rest. */
+    readonly showCenter: import("@motionscript/sdk").Type<boolean, boolean, false>;
+}>, {
+    readonly enter: {};
+    readonly revealCenter: {};
+    readonly selectSlice: {
+        readonly sliceIndex: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly deselectSlice: {
+        readonly sliceIndex: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly selectOnlySlice: {
+        readonly sliceIndex: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly clearSelection: {};
+}, Node2D<Node2DProps>>>>;
 export type PieChart = NodeOf<typeof PieChart>;
 //# sourceMappingURL=pie-chart.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pie-chart.d.ts","sourceRoot":"","sources":["../../src/pie-chart/pie-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,MAAM,EAEX,KAAK,MAAM,EACX,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAA;AAO1B,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEvB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,iEAAiE;IACjE,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAA;IACrB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAClC,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CACxB;AAqBD,sHAAsH;AACtH,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzE;AAsCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;IAYjB;;;;OAIG;;IAEH,oFAAoF;;IAEpF,+EAA+E;;;;;;;;;;;;;;;;;;;;;;;;;IAR/E;;;;OAIG;;IAEH,oFAAoF;;IAEpF,+EAA+E;;UAsHjF,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAA"}
+{"version":3,"file":"pie-chart.d.ts","sourceRoot":"","sources":["../../src/pie-chart/pie-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,MAAM,EAEX,KAAK,MAAM,EACX,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAA;AAO1B,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEvB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,iEAAiE;IACjE,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAA;IACrB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAClC,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CACxB;AAqBD,sHAAsH;AACtH,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzE;AAsCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;IAYjB;;;;OAIG;;IAEH,oFAAoF;;IAEpF,+EAA+E;;;;;;;;;;;;;;;;;;;;;;;;;IAR/E;;;;OAIG;;IAEH,oFAAoF;;IAEpF,+EAA+E;;;;;;;;;;;;IAR/E;;;;OAIG;;IAEH,oFAAoF;;IAEpF,+EAA+E;;;;;;;;;;;;;;;yBAyHjF,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAA"}

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

@@ -107,6 +107,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.
@@ -142,7 +143,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, row]);
+        return asParts([row]);
     },
     commands: {
         /**
@@ -153,6 +154,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/dist/pie-chart/pie-chart.js.map

@@ -1 +1 @@
-{"version":3,"file":"pie-chart.js","sourceRoot":"","sources":["../../src/pie-chart/pie-chart.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Rect,\r\n  Types,\r\n  component2d,\r\n  easeOut,\r\n  type ChildView,\r\n  type DataRecord,\r\n  type NodeOf,\r\n  // Named so this component's emitted type reaches `Node2D` through the sdk, not core.\r\n  type Node2D,\r\n  type Node2DProps,\r\n  type Timeline,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { asParts, fresh } from \"../kit/entries\"\r\nimport { beats, type Beat } from \"../kit/motion\"\r\nimport { clampUnit } from \"../kit/shared\"\r\nimport { PieLegend } from \"./pie-legend\"\r\nimport { PieRing } from \"./pie-ring\"\r\nimport {\r\n  DEFAULT_PIE_CHART_THEME,\r\n  lerpPieChartTheme,\r\n  resolvePieChartTheme,\r\n  resolvePieSlices,\r\n  type PieChartConfig,\r\n  type PieChartTheme,\r\n  type PieLabelMode,\r\n  type PieLabelPlacement,\r\n  type PieSlice,\r\n} from \"./shared\"\r\n\r\nexport interface PieChartProps extends Node2DProps {\r\n  /** One row per slice — a plain record of field name to value. */\r\n  data: DataRecord[]\r\n  /** Key into each row for its slice caption, used on the labels and the legend. */\r\n  categoryField: string\r\n  /** Key into each row for its slice magnitude — the wedge's share of the ring. */\r\n  valueField: string\r\n  /**\r\n   * The chart's visual theme — slice palette, ring geometry, label and centre\r\n   * type, legend. Every branch is optional and deep-merged onto\r\n   * {@link DEFAULT_PIE_CHART_THEME}.\r\n   */\r\n  theme?: PieChartTheme\r\n  /** What the ring's labels say. */\r\n  labelMode?: PieLabelMode\r\n  /** Where they sit: inside their wedge, outside on a leader, or nowhere. */\r\n  labelPlacement?: PieLabelPlacement\r\n  /** Whether the legend column beside the ring is drawn at all. */\r\n  showLegend?: boolean\r\n  /** Gap between the ring and the legend, in px. */\r\n  gap?: number\r\n  /** Text set in the ring's hole — see `revealCenter`. */\r\n  centerLabel?: string\r\n  /** Smaller second line under {@link centerLabel}. */\r\n  centerCaption?: string\r\n  /**\r\n   * Whether the hole's summary is drawn at rest. `true` (the default) is the\r\n   * plain answer; a scene that wants the conclusion to land on a later beat sets\r\n   * this `false` and runs `revealCenter` when it gets there.\r\n   */\r\n  showCenter?: boolean\r\n}\r\n\r\n/** What the selection reads: the rows, how they are cut, and the pops the commands move. */\r\nexport interface PieChartValues {\r\n  readonly data: DataRecord[]\r\n  readonly categoryField: string\r\n  readonly valueField: string\r\n  readonly theme: PieChartConfig\r\n  readonly pops: number[]\r\n}\r\n\r\n/**\r\n * How `enter` divides its duration: the wedges sweeping in, then the labels and\r\n * the legend arriving together. Shares of the whole, so they sum to 1.\r\n */\r\nconst SWEEP_SHARE = 0.65\r\nconst LABEL_SHARE = 0.35\r\n\r\nconst SLICE_ARG = Types.number(0, { min: 0, step: 1 })\r\n\r\n/** The slices the ring and the legend draw, resolved from the rows and the palette. */\r\nfunction slicesOf(s: PieChartValues): PieSlice[] {\r\n  return resolvePieSlices(s.data, s.categoryField, s.valueField, s.theme.sliceFills)\r\n}\r\n\r\n/** How far slice `index` is pushed out, in `[0, 1]`. */\r\nfunction popAt(s: PieChartValues, index: number): number {\r\n  return clampUnit(s.pops[index] ?? 0)\r\n}\r\n\r\n/** Whether slice `index` is grown out past the ring's rim: past half way, so a slice mid-swell is not yet counted. */\r\nexport function isSliceSelected(s: PieChartValues, index: number): boolean {\r\n  return popAt(s, index) > 0.5\r\n}\r\n\r\n/**\r\n * How far each slice is dimmed by the selection, one entry per slice: 1 while\r\n * nothing is out, and for the selected slice itself; falling toward the theme's\r\n * `dimOpacity` for the rest in proportion to how far the selection has grown.\r\n */\r\nfunction sliceDims(s: PieChartValues): number[] {\r\n  let focus = 0\r\n  for (let i = 0; i < s.data.length; i++) focus = Math.max(focus, popAt(s, i))\r\n  const dim = s.theme.spotlight.dimOpacity\r\n  if (focus <= 0) return s.data.map(() => 1)\r\n  return s.data.map((_, i) => 1 - (1 - clampUnit(dim)) * focus * (1 - popAt(s, i)))\r\n}\r\n\r\ntype AnyTimeline = Timeline<any, any>\r\n\r\n/**\r\n * Every slice's pop eased from where it is to what `pop` asks for. A move that\r\n * changes nothing still takes its slot, writing nothing.\r\n */\r\nfunction popping(timeline: AnyTimeline, s: PieChartValues, pop: (index: number) => number) {\r\n  const from = s.data.map((_, i) => popAt(s, i))\r\n  const targets = s.data.map((_, i) => clampUnit(pop(i)))\r\n  if (from.every((value, i) => value === targets[i])) return timeline.wait(timeline.duration)\r\n  return timeline.animate((t) => ({ pops: from.map((value, i) => value + (targets[i] - value) * t) }))\r\n}\r\n\r\n/** The ring and the legend, found through the chart's children: the last row of them is the one it built. */\r\nfunction partsOf(children: readonly ChildView[]) {\r\n  for (let i = children.length - 1; i >= 0; i--) {\r\n    const row = children[i]\r\n    const ring = Rect.is(row) ? row.children.find(PieRing.is) : undefined\r\n    if (ring) return { ring, legend: row.children.find(PieLegend.is) ?? null }\r\n  }\r\n  return null\r\n}\r\n\r\n/**\r\n * A pie or donut chart, composed from two parts laid out by a horizontal-flow\r\n * {@link Rect} — the ring filling whatever the hugging legend leaves, both\r\n * centred:\r\n *\r\n * - {@link PieRing} — the wedges, each sized by its share of the total, with its\r\n *   label inside its own band or pinned outside on a leader line, and the\r\n *   summary in the hole.\r\n * - {@link PieLegend} — a column of swatch-and-caption rows naming each slice.\r\n *\r\n * **One mark per row, not per column**: a pie's palette is indexed by row and\r\n * there is nothing to hide, since dropping a slice would re-cut every other\r\n * wedge. `selectSlice` and its siblings are what a pie has instead — a slice\r\n * swells out of the ring and everything else dims behind it.\r\n *\r\n * **Resting state is the finished chart**; `enter` arms every part on its first\r\n * frame. The one exception is the hole's summary, which a scene can hold back\r\n * with `showCenter: false`, because it is usually the chart's *conclusion*.\r\n */\r\nexport const PieChart = component2d({\r\n  key: \"pieChart\",\r\n  state: {\r\n    data: fresh<DataRecord[]>(() => []),\r\n    categoryField: \"\",\r\n    valueField: \"\",\r\n    theme: Types.custom<PieChartTheme, PieChartConfig>(DEFAULT_PIE_CHART_THEME, { resolve: resolvePieChartTheme, lerp: lerpPieChartTheme }),\r\n    labelMode: Types.custom<PieLabelMode>(\"percent\"),\r\n    labelPlacement: Types.custom<PieLabelPlacement>(\"leader\"),\r\n    gap: 40,\r\n    centerLabel: \"\",\r\n    centerCaption: \"\",\r\n    /**\r\n     * How far each slice is pushed out of the ring, `0`–`1` per index. Held here\r\n     * rather than on the ring because two parts read it: the wedges grow out by\r\n     * it, and the legend entries dim by it. Seeded flush, one to a row.\r\n     */\r\n    pops: fresh<number[]>(() => []),\r\n    /** Read as the chart is built: the legend is a part the chart builds or doesn't. */\r\n    showLegend: Types.boolean(true, { animatable: false }),\r\n    /** Read as the chart is built: whether the hole's summary is drawn at rest. */\r\n    showCenter: Types.boolean(true, { animatable: false }),\r\n  },\r\n  defaults: {\r\n    // Its parts fill it; a node made of them would hug them.\r\n    width: \"fill\",\r\n    height: \"fill\",\r\n    pops: (state) => slicesOf(state).map(() => 0),\r\n  },\r\n  // The slice *structure* (one label and one legend row per row) is read once;\r\n  // the slices themselves, their paint and the selection are bound, so a theme\r\n  // tween re-paints and a `set` of `data` re-cuts the wedges.\r\n  children: (state) => {\r\n    const theme = () => state.theme\r\n    const slices = () => slicesOf(state)\r\n    const parts: Node2D[] = [\r\n      new PieRing({\r\n        width: \"fill\",\r\n        height: \"fill\",\r\n        slices,\r\n        ring: () => theme().ring,\r\n        label: () => theme().label,\r\n        centerStyle: () => theme().center,\r\n        labelMode: state.labelMode,\r\n        labelPlacement: state.labelPlacement,\r\n        pops: () => state.pops,\r\n        dimOpacity: () => theme().spotlight.dimOpacity,\r\n        centerLabel: state.centerLabel,\r\n        centerCaption: state.centerCaption,\r\n        centerReveal: state.showCenter === false ? 0 : 1,\r\n      }) as unknown as Node2D,\r\n    ]\r\n    if (state.showLegend !== false) {\r\n      parts.push(\r\n        new PieLegend({\r\n          slices,\r\n          legend: () => theme().legend,\r\n          dims: () => sliceDims(state),\r\n          // The column's spacing is the theme's as the chart was built, like the\r\n          // entries' type and chips.\r\n          gap: state.theme.legend.itemGap / 3,\r\n          padding: state.theme.legend.padding,\r\n        }) as unknown as Node2D\r\n      )\r\n    }\r\n    const row = new Rect({ flow: \"horizontal\", width: \"fill\", height: \"fill\", gap: state.gap, align: \"center\", children: parts })\r\n    return asParts([...(state.children as unknown as Node2D[]), row as unknown as Node2D])\r\n  },\r\n  commands: {\r\n    /**\r\n     * Animate the whole chart in: the wedges sweep in clockwise from the theme's\r\n     * `startAngle`, then the labels fade up and the legend staggers in together.\r\n     * Its first frame arms the wedges, the labels and the legend; the hole's\r\n     * summary keeps its own signal. `duration` is the **whole** entrance.\r\n     */\r\n    enter: {\r\n      args: {},\r\n      easing: easeOut(),\r\n      run: (timeline, _state, children) => {\r\n        const parts = partsOf(children)\r\n        if (!parts) return timeline.wait(timeline.duration)\r\n        const { ring, legend } = parts\r\n        const sweep = timeline.duration * SWEEP_SHARE\r\n        const labels = timeline.duration * LABEL_SHARE\r\n        const at0 = (piece: Beat[\"piece\"]): Beat => ({ at: 0, duration: 0, piece })\r\n        return beats(timeline, [\r\n          at0(ring.to({ growth: 0, labelReveal: 0 })),\r\n          ...(legend ? [at0(legend.run(\"arm\"))] : []),\r\n          { at: 0, duration: sweep, piece: ring.run(\"sweep\") },\r\n          { at: sweep, duration: labels, piece: ring.run(\"revealLabels\") },\r\n          ...(legend ? [{ at: sweep, duration: labels, piece: legend.run(\"enter\") }] : []),\r\n        ])\r\n      },\r\n    },\r\n    /**\r\n     * Fade the hole's summary up. Held out of `enter` on purpose: what sits in a\r\n     * donut's hole is usually the chart's conclusion, so the scene lands it on\r\n     * its own beat. Pair it with `showCenter: false`.\r\n     */\r\n    revealCenter: {\r\n      args: {},\r\n      easing: easeOut(),\r\n      run: (timeline, _state, children) => partsOf(children)?.ring.run(\"revealCenter\") ?? timeline.wait(timeline.duration),\r\n    },\r\n    /** Grow slice `index` out past the ring's rim and dim the rest, leaving any other selected slice where it is. */\r\n    selectSlice: {\r\n      args: { sliceIndex: SLICE_ARG },\r\n      easing: easeOut(),\r\n      run: (timeline, state) => {\r\n        const index = timeline.args.sliceIndex\r\n        return popping(timeline, state, (i) => (i === index ? 1 : popAt(state, i)))\r\n      },\r\n    },\r\n    /** Settle slice `index` back flush with the ring. */\r\n    deselectSlice: {\r\n      args: { sliceIndex: SLICE_ARG },\r\n      easing: easeOut(),\r\n      run: (timeline, state) => {\r\n        const index = timeline.args.sliceIndex\r\n        return popping(timeline, state, (i) => (i === index ? 0 : popAt(state, i)))\r\n      },\r\n    },\r\n    /** Move the focus to slice `index` alone, settling whatever else was out. */\r\n    selectOnlySlice: {\r\n      args: { sliceIndex: SLICE_ARG },\r\n      easing: easeOut(),\r\n      run: (timeline, state) => {\r\n        const index = timeline.args.sliceIndex\r\n        return popping(timeline, state, (i) => (i === index ? 1 : 0))\r\n      },\r\n    },\r\n    /** Settle every slice flush and bring the whole chart back to full. */\r\n    clearSelection: {\r\n      args: {},\r\n      easing: easeOut(),\r\n      run: (timeline, state) => popping(timeline, state, () => 0),\r\n    },\r\n  },\r\n})\r\n\r\nexport type PieChart = NodeOf<typeof PieChart>\r\n"]}
+{"version":3,"file":"pie-chart.js","sourceRoot":"","sources":["../../src/pie-chart/pie-chart.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Rect,\r\n  Types,\r\n  component2d,\r\n  easeOut,\r\n  type ChildView,\r\n  type DataRecord,\r\n  type NodeOf,\r\n  // Named so this component's emitted type reaches `Node2D` through the sdk, not core.\r\n  type Node2D,\r\n  type Node2DProps,\r\n  type Timeline,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { asParts, fresh } from \"../kit/entries\"\r\nimport { beats, type Beat } from \"../kit/motion\"\r\nimport { clampUnit } from \"../kit/shared\"\r\nimport { PieLegend } from \"./pie-legend\"\r\nimport { PieRing } from \"./pie-ring\"\r\nimport {\r\n  DEFAULT_PIE_CHART_THEME,\r\n  lerpPieChartTheme,\r\n  resolvePieChartTheme,\r\n  resolvePieSlices,\r\n  type PieChartConfig,\r\n  type PieChartTheme,\r\n  type PieLabelMode,\r\n  type PieLabelPlacement,\r\n  type PieSlice,\r\n} from \"./shared\"\r\n\r\nexport interface PieChartProps extends Node2DProps {\r\n  /** One row per slice — a plain record of field name to value. */\r\n  data: DataRecord[]\r\n  /** Key into each row for its slice caption, used on the labels and the legend. */\r\n  categoryField: string\r\n  /** Key into each row for its slice magnitude — the wedge's share of the ring. */\r\n  valueField: string\r\n  /**\r\n   * The chart's visual theme — slice palette, ring geometry, label and centre\r\n   * type, legend. Every branch is optional and deep-merged onto\r\n   * {@link DEFAULT_PIE_CHART_THEME}.\r\n   */\r\n  theme?: PieChartTheme\r\n  /** What the ring's labels say. */\r\n  labelMode?: PieLabelMode\r\n  /** Where they sit: inside their wedge, outside on a leader, or nowhere. */\r\n  labelPlacement?: PieLabelPlacement\r\n  /** Whether the legend column beside the ring is drawn at all. */\r\n  showLegend?: boolean\r\n  /** Gap between the ring and the legend, in px. */\r\n  gap?: number\r\n  /** Text set in the ring's hole — see `revealCenter`. */\r\n  centerLabel?: string\r\n  /** Smaller second line under {@link centerLabel}. */\r\n  centerCaption?: string\r\n  /**\r\n   * Whether the hole's summary is drawn at rest. `true` (the default) is the\r\n   * plain answer; a scene that wants the conclusion to land on a later beat sets\r\n   * this `false` and runs `revealCenter` when it gets there.\r\n   */\r\n  showCenter?: boolean\r\n}\r\n\r\n/** What the selection reads: the rows, how they are cut, and the pops the commands move. */\r\nexport interface PieChartValues {\r\n  readonly data: DataRecord[]\r\n  readonly categoryField: string\r\n  readonly valueField: string\r\n  readonly theme: PieChartConfig\r\n  readonly pops: number[]\r\n}\r\n\r\n/**\r\n * How `enter` divides its duration: the wedges sweeping in, then the labels and\r\n * the legend arriving together. Shares of the whole, so they sum to 1.\r\n */\r\nconst SWEEP_SHARE = 0.65\r\nconst LABEL_SHARE = 0.35\r\n\r\nconst SLICE_ARG = Types.number(0, { min: 0, step: 1 })\r\n\r\n/** The slices the ring and the legend draw, resolved from the rows and the palette. */\r\nfunction slicesOf(s: PieChartValues): PieSlice[] {\r\n  return resolvePieSlices(s.data, s.categoryField, s.valueField, s.theme.sliceFills)\r\n}\r\n\r\n/** How far slice `index` is pushed out, in `[0, 1]`. */\r\nfunction popAt(s: PieChartValues, index: number): number {\r\n  return clampUnit(s.pops[index] ?? 0)\r\n}\r\n\r\n/** Whether slice `index` is grown out past the ring's rim: past half way, so a slice mid-swell is not yet counted. */\r\nexport function isSliceSelected(s: PieChartValues, index: number): boolean {\r\n  return popAt(s, index) > 0.5\r\n}\r\n\r\n/**\r\n * How far each slice is dimmed by the selection, one entry per slice: 1 while\r\n * nothing is out, and for the selected slice itself; falling toward the theme's\r\n * `dimOpacity` for the rest in proportion to how far the selection has grown.\r\n */\r\nfunction sliceDims(s: PieChartValues): number[] {\r\n  let focus = 0\r\n  for (let i = 0; i < s.data.length; i++) focus = Math.max(focus, popAt(s, i))\r\n  const dim = s.theme.spotlight.dimOpacity\r\n  if (focus <= 0) return s.data.map(() => 1)\r\n  return s.data.map((_, i) => 1 - (1 - clampUnit(dim)) * focus * (1 - popAt(s, i)))\r\n}\r\n\r\ntype AnyTimeline = Timeline<any, any>\r\n\r\n/**\r\n * Every slice's pop eased from where it is to what `pop` asks for. A move that\r\n * changes nothing still takes its slot, writing nothing.\r\n */\r\nfunction popping(timeline: AnyTimeline, s: PieChartValues, pop: (index: number) => number) {\r\n  const from = s.data.map((_, i) => popAt(s, i))\r\n  const targets = s.data.map((_, i) => clampUnit(pop(i)))\r\n  if (from.every((value, i) => value === targets[i])) return timeline.wait(timeline.duration)\r\n  return timeline.animate((t) => ({ pops: from.map((value, i) => value + (targets[i] - value) * t) }))\r\n}\r\n\r\n/** The ring and the legend, found through the chart's children: the last row of them is the one it built. */\r\nfunction partsOf(children: readonly ChildView[]) {\r\n  for (let i = children.length - 1; i >= 0; i--) {\r\n    const row = children[i]\r\n    const ring = Rect.is(row) ? row.children.find(PieRing.is) : undefined\r\n    if (ring) return { ring, legend: row.children.find(PieLegend.is) ?? null }\r\n  }\r\n  return null\r\n}\r\n\r\n/**\r\n * A pie or donut chart, composed from two parts laid out by a horizontal-flow\r\n * {@link Rect} — the ring filling whatever the hugging legend leaves, both\r\n * centred:\r\n *\r\n * - {@link PieRing} — the wedges, each sized by its share of the total, with its\r\n *   label inside its own band or pinned outside on a leader line, and the\r\n *   summary in the hole.\r\n * - {@link PieLegend} — a column of swatch-and-caption rows naming each slice.\r\n *\r\n * **One mark per row, not per column**: a pie's palette is indexed by row and\r\n * there is nothing to hide, since dropping a slice would re-cut every other\r\n * wedge. `selectSlice` and its siblings are what a pie has instead — a slice\r\n * swells out of the ring and everything else dims behind it.\r\n *\r\n * **Resting state is the finished chart**; `enter` arms every part on its first\r\n * frame. The one exception is the hole's summary, which a scene can hold back\r\n * with `showCenter: false`, because it is usually the chart's *conclusion*.\r\n */\r\nexport const PieChart = component2d({\r\n  key: \"pieChart\",\r\n  state: {\r\n    data: fresh<DataRecord[]>(() => []),\r\n    categoryField: \"\",\r\n    valueField: \"\",\r\n    theme: Types.custom<PieChartTheme, PieChartConfig>(DEFAULT_PIE_CHART_THEME, { resolve: resolvePieChartTheme, lerp: lerpPieChartTheme }),\r\n    labelMode: Types.custom<PieLabelMode>(\"percent\"),\r\n    labelPlacement: Types.custom<PieLabelPlacement>(\"leader\"),\r\n    gap: 40,\r\n    centerLabel: \"\",\r\n    centerCaption: \"\",\r\n    /**\r\n     * How far each slice is pushed out of the ring, `0`–`1` per index. Held here\r\n     * rather than on the ring because two parts read it: the wedges grow out by\r\n     * it, and the legend entries dim by it. Seeded flush, one to a row.\r\n     */\r\n    pops: fresh<number[]>(() => []),\r\n    /** Read as the chart is built: the legend is a part the chart builds or doesn't. */\r\n    showLegend: Types.boolean(true, { animatable: false }),\r\n    /** Read as the chart is built: whether the hole's summary is drawn at rest. */\r\n    showCenter: Types.boolean(true, { animatable: false }),\r\n  },\r\n  defaults: {\r\n    // Its parts fill it; a node made of them would hug them.\r\n    width: \"fill\",\r\n    height: \"fill\",\r\n    pops: (state) => slicesOf(state).map(() => 0),\r\n  },\r\n  allowedChildren: [],\r\n  // The slice *structure* (one label and one legend row per row) is read once;\r\n  // the slices themselves, their paint and the selection are bound, so a theme\r\n  // tween re-paints and a `set` of `data` re-cuts the wedges.\r\n  children: (state) => {\r\n    const theme = () => state.theme\r\n    const slices = () => slicesOf(state)\r\n    const parts: Node2D[] = [\r\n      new PieRing({\r\n        width: \"fill\",\r\n        height: \"fill\",\r\n        slices,\r\n        ring: () => theme().ring,\r\n        label: () => theme().label,\r\n        centerStyle: () => theme().center,\r\n        labelMode: state.labelMode,\r\n        labelPlacement: state.labelPlacement,\r\n        pops: () => state.pops,\r\n        dimOpacity: () => theme().spotlight.dimOpacity,\r\n        centerLabel: state.centerLabel,\r\n        centerCaption: state.centerCaption,\r\n        centerReveal: state.showCenter === false ? 0 : 1,\r\n      }) as unknown as Node2D,\r\n    ]\r\n    if (state.showLegend !== false) {\r\n      parts.push(\r\n        new PieLegend({\r\n          slices,\r\n          legend: () => theme().legend,\r\n          dims: () => sliceDims(state),\r\n          // The column's spacing is the theme's as the chart was built, like the\r\n          // entries' type and chips.\r\n          gap: state.theme.legend.itemGap / 3,\r\n          padding: state.theme.legend.padding,\r\n        }) as unknown as Node2D\r\n      )\r\n    }\r\n    const row = new Rect({ flow: \"horizontal\", width: \"fill\", height: \"fill\", gap: state.gap, align: \"center\", children: parts })\r\n    return asParts([row as unknown as Node2D])\r\n  },\r\n  commands: {\r\n    /**\r\n     * Animate the whole chart in: the wedges sweep in clockwise from the theme's\r\n     * `startAngle`, then the labels fade up and the legend staggers in together.\r\n     * Its first frame arms the wedges, the labels and the legend; the hole's\r\n     * summary keeps its own signal. `duration` is the **whole** entrance.\r\n     */\r\n    enter: {\r\n      args: {},\r\n      // Held from the chart's arrival, so it never shows finished ahead of its draw.\r\n      entrance: true,\r\n      easing: easeOut(),\r\n      run: (timeline, _state, children) => {\r\n        const parts = partsOf(children)\r\n        if (!parts) return timeline.wait(timeline.duration)\r\n        const { ring, legend } = parts\r\n        const sweep = timeline.duration * SWEEP_SHARE\r\n        const labels = timeline.duration * LABEL_SHARE\r\n        const at0 = (piece: Beat[\"piece\"]): Beat => ({ at: 0, duration: 0, piece })\r\n        return beats(timeline, [\r\n          at0(ring.to({ growth: 0, labelReveal: 0 })),\r\n          ...(legend ? [at0(legend.run(\"arm\"))] : []),\r\n          { at: 0, duration: sweep, piece: ring.run(\"sweep\") },\r\n          { at: sweep, duration: labels, piece: ring.run(\"revealLabels\") },\r\n          ...(legend ? [{ at: sweep, duration: labels, piece: legend.run(\"enter\") }] : []),\r\n        ])\r\n      },\r\n    },\r\n    /**\r\n     * Fade the hole's summary up. Held out of `enter` on purpose: what sits in a\r\n     * donut's hole is usually the chart's conclusion, so the scene lands it on\r\n     * its own beat. Pair it with `showCenter: false`.\r\n     */\r\n    revealCenter: {\r\n      args: {},\r\n      easing: easeOut(),\r\n      run: (timeline, _state, children) => partsOf(children)?.ring.run(\"revealCenter\") ?? timeline.wait(timeline.duration),\r\n    },\r\n    /** Grow slice `index` out past the ring's rim and dim the rest, leaving any other selected slice where it is. */\r\n    selectSlice: {\r\n      args: { sliceIndex: SLICE_ARG },\r\n      easing: easeOut(),\r\n      run: (timeline, state) => {\r\n        const index = timeline.args.sliceIndex\r\n        return popping(timeline, state, (i) => (i === index ? 1 : popAt(state, i)))\r\n      },\r\n    },\r\n    /** Settle slice `index` back flush with the ring. */\r\n    deselectSlice: {\r\n      args: { sliceIndex: SLICE_ARG },\r\n      easing: easeOut(),\r\n      run: (timeline, state) => {\r\n        const index = timeline.args.sliceIndex\r\n        return popping(timeline, state, (i) => (i === index ? 0 : popAt(state, i)))\r\n      },\r\n    },\r\n    /** Move the focus to slice `index` alone, settling whatever else was out. */\r\n    selectOnlySlice: {\r\n      args: { sliceIndex: SLICE_ARG },\r\n      easing: easeOut(),\r\n      run: (timeline, state) => {\r\n        const index = timeline.args.sliceIndex\r\n        return popping(timeline, state, (i) => (i === index ? 1 : 0))\r\n      },\r\n    },\r\n    /** Settle every slice flush and bring the whole chart back to full. */\r\n    clearSelection: {\r\n      args: {},\r\n      easing: easeOut(),\r\n      run: (timeline, state) => popping(timeline, state, () => 0),\r\n    },\r\n  },\r\n})\r\n\r\nexport type PieChart = NodeOf<typeof PieChart>\r\n"]}

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

@@ -78,6 +78,36 @@ export declare const PieLegend: import("@motionscript/sdk").Component<"pieLegend
     readonly overlay: import("@motionscript/sdk").Attribute<_Fill, _FillResolved[]>;
     readonly start: import("@motionscript/sdk").Type<number, number, false>;
     readonly end: import("@motionscript/sdk").Type<number, number, false>;
-}>, null>>;
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly slices: import("@motionscript/sdk").Type<PieSlice[], PieSlice[], false>;
+    readonly legend: import("@motionscript/sdk").Type<LegendConfig, LegendConfig, false>;
+    readonly dims: import("@motionscript/sdk").Type<number[], number[], false>;
+    readonly arrivals: import("@motionscript/sdk").Type<Readonly<Record<string, Arrival>>, Readonly<Record<string, Arrival>>, false>;
+    readonly cornerRadius: import("@motionscript/sdk").Attribute<_RectCornerRadius, _CornerRadiusResolved>;
+    readonly cornerStyle: import("@motionscript/sdk").Attribute<_RectCornerStyle, _CornerStyleResolved>;
+    readonly flow: import("@motionscript/sdk").Type<_FlowMode, _FlowResolved, false>;
+    readonly gap: import("@motionscript/sdk").Type<_GapSize, _GapSize, false>;
+    readonly wrap: boolean;
+    readonly crossGap: import("@motionscript/sdk").Type<number | undefined, number | undefined, false>;
+    readonly columns: import("@motionscript/sdk").Type<number, number, false>;
+    readonly align: import("@motionscript/sdk").Attribute<_Alignment, _Vector2>;
+    readonly fill: import("@motionscript/sdk").Attribute<_Fill, _FillResolved[]>;
+    readonly stroke: import("@motionscript/sdk").Attribute<_Stroke, _StrokeResolved[]>;
+    readonly shadow: import("@motionscript/sdk").Attribute<_Shadow, _ShadowResolved[]>;
+    readonly overlay: import("@motionscript/sdk").Attribute<_Fill, _FillResolved[]>;
+    readonly start: import("@motionscript/sdk").Type<number, number, false>;
+    readonly end: import("@motionscript/sdk").Type<number, number, false>;
+}>, {
+    readonly arm: unknown;
+    readonly enter: unknown;
+    readonly fillTo: readonly ["fill"];
+    readonly strokeTo: readonly ["stroke"];
+    readonly shadowTo: readonly ["shadow"];
+    readonly overlayTo: readonly ["overlay"];
+    readonly progressTo: readonly ["start", "end"];
+    readonly flash: {
+        readonly portion: import("@motionscript/sdk").Type<number, number, false>;
+    };
+}, _Node2D<_Node2DProps>>>>;
 export type PieLegend = NodeOf<typeof PieLegend>;
 //# sourceMappingURL=pie-legend.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pie-legend.d.ts","sourceRoot":"","sources":["../../src/pie-chart/pie-legend.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,MAAM,EACX,KAAK,SAAS,EAEd,KAAK,SAAS,IAAI,UAAU,EAC5B,KAAK,oBAAoB,IAAI,qBAAqB,EAClD,KAAK,mBAAmB,IAAI,oBAAoB,EAChD,KAAK,IAAI,IAAI,KAAK,EAClB,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,QAAQ,IAAI,SAAS,EAC1B,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,OAAO,IAAI,QAAQ,EACxB,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,IAAI,YAAY,EAChC,KAAK,gBAAgB,IAAI,iBAAiB,EAC1C,KAAK,eAAe,IAAI,gBAAgB,EACxC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,cAAc,IAAI,eAAe,EACtC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,cAAc,IAAI,eAAe,EACtC,KAAK,OAAO,IAAI,QAAQ,EACzB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA8D,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AACxG,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,0CAA0C;IAC1C,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,oFAAoF;IACpF,MAAM,EAAE,YAAY,CAAA;IACpB;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAKD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA+FpB,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"pie-legend.d.ts","sourceRoot":"","sources":["../../src/pie-chart/pie-legend.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,MAAM,EACX,KAAK,SAAS,EAEd,KAAK,SAAS,IAAI,UAAU,EAC5B,KAAK,oBAAoB,IAAI,qBAAqB,EAClD,KAAK,mBAAmB,IAAI,oBAAoB,EAChD,KAAK,IAAI,IAAI,KAAK,EAClB,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,QAAQ,IAAI,SAAS,EAC1B,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,OAAO,IAAI,QAAQ,EACxB,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,IAAI,YAAY,EAChC,KAAK,gBAAgB,IAAI,iBAAiB,EAC1C,KAAK,eAAe,IAAI,gBAAgB,EACxC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,cAAc,IAAI,eAAe,EACtC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,cAAc,IAAI,eAAe,EACtC,KAAK,OAAO,IAAI,QAAQ,EACzB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA8D,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AACxG,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,0CAA0C;IAC1C,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,oFAAoF;IACpF,MAAM,EAAE,YAAY,CAAA;IACpB;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAKD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA+FpB,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAA"}

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

@@ -280,7 +280,25 @@ export declare const PieRing: import("@motionscript/sdk").Component<"pieRing", i
     readonly centerLabel: "";
     readonly centerCaption: "";
     readonly centerReveal: 1;
-}>, null>>;
+}>, null, import("@motionscript/sdk").BuiltNode<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>;
+    readonly growth: 1;
+    readonly labelReveal: 1;
+    readonly pops: import("@motionscript/sdk").Type<number[], number[], false>;
+    readonly dimOpacity: number;
+    readonly centerLabel: "";
+    readonly centerCaption: "";
+    readonly centerReveal: 1;
+}>, {
+    readonly sweep: unknown;
+    readonly revealLabels: unknown;
+    readonly revealCenter: unknown;
+}, 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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"}

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

@@ -196,15 +196,21 @@ export type PieChartTheme = {
     legend?: LegendTheme;
     spotlight?: Partial<PieChartConfig["spotlight"]>;
 };
+/**
+ * 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 declare const PIE_SPOTLIGHT_DIM = 0.1;
 /** The pie chart's out-of-the-box look. */
 export declare const DEFAULT_PIE_CHART_THEME: PieChartConfig;
 /**
- * {@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.
  */
 export declare function resolvePieChartTheme(theme: PieChartTheme | undefined, previous?: PieChartConfig): PieChartConfig;
-/** {@link PieChart}'s `theme` @property tween — leaf by leaf. */
+/** {@link PieChart}'s `theme` property tween — leaf by leaf. */
 export declare function lerpPieChartTheme(from: PieChartConfig, to: PieChartConfig, t: number): PieChartConfig;
 //# sourceMappingURL=shared.d.ts.map

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

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

package/dist/pie-chart/shared.js

@@ -14,7 +14,7 @@
  * pulling the node classes in.
  */
 import { lerpNumber, shadowOps, strokeOps, textOps, } from "@motionscript/sdk";
-import { CHART_PALETTE, DEFAULT_LEGEND, DEFAULT_SERIES_FILLS, SPOTLIGHT_DIM, lerpLegendConfig, lerpSeriesFills, num, resolveLegendConfig, resolveSeriesFills, text, } from "../kit/shared.js";
+import { CHART_PALETTE, DEFAULT_LEGEND, DEFAULT_SERIES_FILLS, lerpLegendConfig, lerpSeriesFills, num, resolveLegendConfig, resolveSeriesFills, text, } from "../kit/shared.js";
 /**
  * Resolve tabular rows into slices: one per row, captioned by the `category`
  * column, sized by the `value` column, painted from `palette` by row order
@@ -115,6 +115,12 @@ const LABEL_TEXT_STYLE = {
     textAlign: "center",
     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 = {
     sliceFills: DEFAULT_SERIES_FILLS,
@@ -152,7 +158,7 @@ export const DEFAULT_PIE_CHART_THEME = {
         },
     },
     legend: DEFAULT_LEGEND,
-    spotlight: { dimOpacity: SPOTLIGHT_DIM },
+    spotlight: { dimOpacity: PIE_SPOTLIGHT_DIM },
 };
 function resolveRingConfig(ring, previous) {
     return {
@@ -203,7 +209,7 @@ function lerpCenterConfig(from, to, t) {
     };
 }
 /**
- * {@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.
@@ -221,7 +227,7 @@ export function resolvePieChartTheme(theme, previous) {
         },
     };
 }
-/** {@link PieChart}'s `theme` @property tween — leaf by leaf. */
+/** {@link PieChart}'s `theme` property tween — leaf by leaf. */
 export function lerpPieChartTheme(from, to, t) {
     return {
         // A palette is a list of independent paints rather than one value, so it