@motionscript/charts 0.0.0-stage → 0.1.0-alpha.10

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

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

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

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

package/dist/nodes.d.ts

@@ -0,0 +1,17 @@
+import { LineChart } from "./line-chart/index.js";
+import { BarChart } from "./bar-chart/index.js";
+import { PieChart } from "./pie-chart/index.js";
+/**
+ * Every node type this package publishes.
+ *
+ * A host registers these by handing the array to an engine —
+ * `new Engine(platform, { nodes: NODES })` — which reads each component's key.
+ * Defining a component only *declares* that key: nothing is registered by
+ * importing a module, so a registry holds exactly what its owner asked for.
+ *
+ * Listing the component **values** is also what survives bundling: this package
+ * declares `sideEffects: false`, and a document names a node type by string, so
+ * an import kept only for its side effect is exactly what gets shaken out.
+ */
+export declare const NODES: (typeof LineChart | typeof BarChart | typeof PieChart)[];
+//# sourceMappingURL=nodes.d.ts.map

package/dist/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,KAAK,EAAE,CAAC,OAAO,SAAS,GAAG,OAAO,QAAQ,GAAG,OAAO,QAAQ,CAAC,EAAoC,CAAC"}

package/dist/nodes.js

@@ -0,0 +1,18 @@
+import { LineChart } from "./line-chart/index.js";
+import { BarChart } from "./bar-chart/index.js";
+import { PieChart } from "./pie-chart/index.js";
+/**
+ * Every node type this package publishes.
+ *
+ * A host registers these by handing the array to an engine —
+ * `new Engine(platform, { nodes: NODES })` — which reads each component's key.
+ * Defining a component only *declares* that key: nothing is registered by
+ * importing a module, so a registry holds exactly what its owner asked for.
+ *
+ * Listing the component **values** is also what survives bundling: this package
+ * declares `sideEffects: false`, and a document names a node type by string, so
+ * an import kept only for its side effect is exactly what gets shaken out.
+ */
+// Typed by name, so the declaration names each component rather than spelling out its type through core.
+export const NODES = [LineChart, BarChart, PieChart];
+//# sourceMappingURL=nodes.js.map

package/dist/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,yGAAyG;AACzG,MAAM,CAAC,MAAM,KAAK,GAA6D,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC","sourcesContent":["import { LineChart } from \"./line-chart\";\nimport { BarChart } from \"./bar-chart\";\nimport { PieChart } from \"./pie-chart\";\n\n/**\n * Every node type this package publishes.\n *\n * A host registers these by handing the array to an engine —\n * `new Engine(platform, { nodes: NODES })` — which reads each component's key.\n * Defining a component only *declares* that key: nothing is registered by\n * importing a module, so a registry holds exactly what its owner asked for.\n *\n * Listing the component **values** is also what survives bundling: this package\n * declares `sideEffects: false`, and a document names a node type by string, so\n * an import kept only for its side effect is exactly what gets shaken out.\n */\n// Typed by name, so the declaration names each component rather than spelling out its type through core.\nexport const NODES: (typeof LineChart | typeof BarChart | typeof PieChart)[] = [LineChart, BarChart, PieChart];\n"]}

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

@@ -0,0 +1,18 @@
+/**
+ * The pie chart: the one in the family that draws a mark per **row** rather
+ * than per column.
+ *
+ * So it shares the legend and the theme machinery with its siblings and none of
+ * the cartesian geometry. Set the theme's `ring.holeRadius` to 0 for a solid
+ * pie; it defaults to a donut, because the hole is the only place a chart has
+ * to put its conclusion.
+ */
+export { PieChart, isSliceSelected } from "./pie-chart.js";
+export type { PieChartProps, PieChartValues } from "./pie-chart.js";
+export { PieRing } from "./pie-ring.js";
+export type { PieRingProps } from "./pie-ring.js";
+export { PieLegend } from "./pie-legend.js";
+export type { PieLegendProps } from "./pie-legend.js";
+export { DEFAULT_PIE_CHART_THEME, lerpPieChartTheme, pieArcs, relaxLabels, resolvePieChartTheme, resolvePieSlices, ringPoint, sliceTotal, sliceValue, } from "./shared.js";
+export type { CenterConfig, LabelConfig, PieArc, PieChartConfig, PieChartTheme, PieLabelMode, PieLabelPlacement, PieSlice, RingConfig, } from "./shared.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pie-chart/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,OAAO,EACP,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,MAAM,EACN,cAAc,EACd,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EACR,UAAU,GACX,MAAM,UAAU,CAAA"}

package/dist/pie-chart/index.js

@@ -0,0 +1,14 @@
+/**
+ * The pie chart: the one in the family that draws a mark per **row** rather
+ * than per column.
+ *
+ * So it shares the legend and the theme machinery with its siblings and none of
+ * the cartesian geometry. Set the theme's `ring.holeRadius` to 0 for a solid
+ * pie; it defaults to a donut, because the hole is the only place a chart has
+ * to put its conclusion.
+ */
+export { PieChart, isSliceSelected } from "./pie-chart.js";
+export { PieRing } from "./pie-ring.js";
+export { PieLegend } from "./pie-legend.js";
+export { DEFAULT_PIE_CHART_THEME, lerpPieChartTheme, pieArcs, relaxLabels, resolvePieChartTheme, resolvePieSlices, ringPoint, sliceTotal, sliceValue, } from "./shared.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pie-chart/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,OAAO,EACP,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,UAAU,CAAA","sourcesContent":["/**\n * The pie chart: the one in the family that draws a mark per **row** rather\n * than per column.\n *\n * So it shares the legend and the theme machinery with its siblings and none of\n * the cartesian geometry. Set the theme's `ring.holeRadius` to 0 for a solid\n * pie; it defaults to a donut, because the hole is the only place a chart has\n * to put its conclusion.\n */\nexport { PieChart, isSliceSelected } from \"./pie-chart\"\nexport type { PieChartProps, PieChartValues } from \"./pie-chart\"\nexport { PieRing } from \"./pie-ring\"\nexport type { PieRingProps } from \"./pie-ring\"\nexport { PieLegend } from \"./pie-legend\"\nexport type { PieLegendProps } from \"./pie-legend\"\nexport {\n  DEFAULT_PIE_CHART_THEME,\n  lerpPieChartTheme,\n  pieArcs,\n  relaxLabels,\n  resolvePieChartTheme,\n  resolvePieSlices,\n  ringPoint,\n  sliceTotal,\n  sliceValue,\n} from \"./shared\"\nexport type {\n  CenterConfig,\n  LabelConfig,\n  PieArc,\n  PieChartConfig,\n  PieChartTheme,\n  PieLabelMode,\n  PieLabelPlacement,\n  PieSlice,\n  RingConfig,\n} from \"./shared\"\n"]}

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

@@ -0,0 +1,152 @@
+import { type DataRecord, type NodeOf, type Node2D, type Node2DProps } from "@motionscript/sdk";
+import { type PieChartConfig, type PieChartTheme, type PieLabelMode, type PieLabelPlacement } from "./shared.js";
+export interface PieChartProps extends Node2DProps {
+    /** One row per slice — a plain record of field name to value. */
+    data: DataRecord[];
+    /** Key into each row for its slice caption, used on the labels and the legend. */
+    categoryField: string;
+    /** Key into each row for its slice magnitude — the wedge's share of the ring. */
+    valueField: string;
+    /**
+     * The chart's visual theme — slice palette, ring geometry, label and centre
+     * type, legend. Every branch is optional and deep-merged onto
+     * {@link DEFAULT_PIE_CHART_THEME}.
+     */
+    theme?: PieChartTheme;
+    /** What the ring's labels say. */
+    labelMode?: PieLabelMode;
+    /** Where they sit: inside their wedge, outside on a leader, or nowhere. */
+    labelPlacement?: PieLabelPlacement;
+    /** Whether the legend column beside the ring is drawn at all. */
+    showLegend?: boolean;
+    /** Gap between the ring and the legend, in px. */
+    gap?: number;
+    /** Text set in the ring's hole — see `revealCenter`. */
+    centerLabel?: string;
+    /** Smaller second line under {@link centerLabel}. */
+    centerCaption?: string;
+    /**
+     * Whether the hole's summary is drawn at rest. `true` (the default) is the
+     * plain answer; a scene that wants the conclusion to land on a later beat sets
+     * this `false` and runs `revealCenter` when it gets there.
+     */
+    showCenter?: boolean;
+}
+/** What the selection reads: the rows, how they are cut, and the pops the commands move. */
+export interface PieChartValues {
+    readonly data: DataRecord[];
+    readonly categoryField: string;
+    readonly valueField: string;
+    readonly theme: PieChartConfig;
+    readonly pops: number[];
+}
+/** Whether slice `index` is grown out past the ring's rim: past half way, so a slice mid-swell is not yet counted. */
+export declare function isSliceSelected(s: PieChartValues, index: number): boolean;
+/**
+ * A pie or donut chart, composed from two parts laid out by a horizontal-flow
+ * {@link Rect} — the ring filling whatever the hugging legend leaves, both
+ * centred:
+ *
+ * - {@link PieRing} — the wedges, each sized by its share of the total, with its
+ *   label inside its own band or pinned outside on a leader line, and the
+ *   summary in the hole.
+ * - {@link PieLegend} — a column of swatch-and-caption rows naming each slice.
+ *
+ * **One mark per row, not per column**: a pie's palette is indexed by row and
+ * there is nothing to hide, since dropping a slice would re-cut every other
+ * wedge. `selectSlice` and its siblings are what a pie has instead — a slice
+ * swells out of the ring and everything else dims behind it.
+ *
+ * **Resting state is the finished chart**; `enter` arms every part on its first
+ * frame. The one exception is the hole's summary, which a scene can hold back
+ * with `showCenter: false`, because it is usually the chart's *conclusion*.
+ */
+export declare const PieChart: import("@motionscript/sdk").Component<"pieChart", 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: {};
+}, 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: "";
+    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 [], 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

@@ -0,0 +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;;;;;;;;;;;;IAR/E;;;;OAIG;;IAEH,oFAAoF;;IAEpF,+EAA+E;;;;;;;;;;;;;;;yBAyHjF,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAA"}