@motionscript/charts 0.1.0-alpha.0 → 0.1.0-alpha.5

package/dist/kit/shared.js

@@ -12,9 +12,8 @@
  * that three times would mean three answers to "how does a chart round its axis"
  * within one app.
  *
- * Kept renderer-agnostic (no `Node` imports) so the studio's own inspector
- * mappings can build a partial theme without pulling the node classes in, the
- * same way `line-chart-props.ts` always has.
+ * Kept renderer-agnostic (no `Node` imports) so a host's own inspector
+ * mappings can build a partial theme without pulling the node classes in.
  *
  * **Two conventions run through every resolver and lerp below**, inherited from
  * the shape system's `resolveStroke`/`resolveShadow`:
@@ -28,7 +27,7 @@
  *   defaulting the missing side to 0 would animate a font weight down to nothing
  *   on the way to "unset".
  */
-import { fillOps, lerpNumber, shadowOps, strokeOps, insetsOps, textOps, } from "@motionscript/core";
+import { fillOps, lerpNumber, shadowOps, strokeOps, insetsOps, textOps, } from "@motionscript/sdk";
 /**
  * An axis domain's @property mapper: merges the author's partial input onto
  * `previous`, so a later partial `.set({ yAxis: {...} })` patches
@@ -74,6 +73,29 @@ function lerpOptionalTicks(from, to, t) {
     }
     return out;
 }
+/**
+ * Where a generic `to()` of an axis domain should land, given the domain as it
+ * is *drawn* (`drawn`, with `range` and `ticks` resolved off the data), or
+ * `undefined` when the request states neither a `range` nor `ticks` and the
+ * plain property tween will do.
+ *
+ * The stored domain of an auto axis has no `range` and no `ticks`, and
+ * {@link lerpAxisDomain} steps an unset side at the midpoint, so tweening the
+ * stored value from an auto axis is a cut. The charts therefore tween between
+ * resolved domains, as their zoom does; this builds the destination. A `range`
+ * given without `ticks` keeps the tick *count* the axis already draws, so each
+ * marker slides from its old value to its new one instead of the row popping.
+ */
+export function axisTweenTarget(drawn, requested) {
+    if (requested?.range === undefined && requested?.ticks === undefined)
+        return undefined;
+    const target = resolveAxisDomain(requested, drawn);
+    if (requested.ticks === undefined && requested.range !== undefined) {
+        const count = Math.max(2, drawn.ticks?.length ?? 2);
+        target.ticks = markerValues(requested.range, count - 1);
+    }
+    return target;
+}
 /**
  * The low-level colour tokens the default themes are built from — a dark plot
  * panel with warm-grey axis furniture.
@@ -109,7 +131,8 @@ export function clampUnit(value) {
 }
 // ---- Row readers ---------------------------------------------------------
 /**
- * Read a numeric field off a row, defaulting missing/non-numeric values to 0.
+ * Read a numeric field off a row, defaulting missing, non-numeric and non-finite
+ * values to 0.
  *
  * A column left as strings silently plots as 0, which is why the CSV parser's
  * numeric auto-coercion matters — a quoted or unit-suffixed column won't plot
@@ -119,7 +142,9 @@ export function num(row, field) {
     if (field === undefined)
         return 0;
     const v = row[field];
-    return typeof v === "number" ? v : 0;
+    // A `NaN` or infinite cell is no more a measurement than a missing one: read
+    // as 0, it cannot poison the scale and turn every point into `NaN`.
+    return typeof v === "number" && Number.isFinite(v) ? v : 0;
 }
 /**
  * Read a field off a row as its caption — the counterpart to {@link num} for
@@ -376,11 +401,42 @@ export function resolvePalettePaint(palette, override, index) {
     return palette[index % palette.length];
 }
 // ---- Scales and formatting -----------------------------------------------
-/** Format a marker value: integers plain, otherwise trimmed to one decimal. */
-export function formatMarker(value) {
+/**
+ * Format a marker value: integers plain, otherwise trimmed to one decimal, or to
+ * as many as the axis's tick `step` needs to tell neighbouring ticks apart.
+ *
+ * One decimal is the floor, so a step of 0.1 or more reads exactly as it always
+ * has; a finer step (a unit axis ticked every 0.05) gets two, instead of five
+ * ticks captioned `0.1 0.1 0.2 0.2 0.3`. Trailing zeros are dropped either way.
+ */
+export function formatMarker(value, step) {
     if (Number.isInteger(value))
         return String(value);
-    return value.toFixed(1).replace(/\.0$/, "");
+    const decimals = Math.max(1, step === undefined ? 1 : decimalsFor(step));
+    return value.toFixed(decimals).replace(/(\.\d*?)0+$/, "$1").replace(/\.$/, "");
+}
+/** Decimal places needed to write `step` exactly, capped at six. */
+function decimalsFor(step) {
+    if (!(step > 0) || !Number.isFinite(step))
+        return 1;
+    for (let d = 0; d <= 6; d++) {
+        const scaled = step * 10 ** d;
+        if (Math.abs(scaled - Math.round(scaled)) < 1e-6 * Math.max(1, scaled))
+            return d;
+    }
+    // An irrational-looking step (a third): as many places as separate the ticks.
+    return Math.min(6, Math.max(1, Math.ceil(-Math.log10(step)) + 1));
+}
+/** The gap between neighbouring tick values, or `undefined` for fewer than two distinct ones. */
+export function markerStep(markers) {
+    const sorted = [...markers].filter(Number.isFinite).sort((a, b) => a - b);
+    let step;
+    for (let i = 1; i < sorted.length; i++) {
+        const gap = sorted[i] - sorted[i - 1];
+        if (gap > 1e-12 && (step === undefined || gap < step))
+            step = gap;
+    }
+    return step;
 }
 /** Format a fraction in `[0, 1]` as a percentage: integers plain, else one decimal. */
 export function formatPercent(fraction) {
@@ -395,7 +451,7 @@ export function markerValues([min, max], markerCount) {
     return Array.from({ length: n + 1 }, (_, i) => min + ((max - min) / n) * i);
 }
 // Lifted into the engine, because a graph and a diagram want them too — see
-// `@motionscript/core/component`. Re-exported so a chart, and anything that
+// `@motionscript/sdk/component`. Re-exported so a chart, and anything that
 // copied one, still reaches them where it always did.
-export { niceStep, enterBudget } from "@motionscript/core/component";
+export { niceStep, enterBudget } from "@motionscript/sdk/component";
 //# sourceMappingURL=shared.js.map

package/dist/kit/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/kit/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EACL,OAAO,EACP,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,GAWR,MAAM,oBAAoB,CAAA;AAuD3B;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAoC,EACpC,QAA2B;IAE3B,OAAO;QACL,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC7C,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK;QACvC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK;QACvC,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM;KAC3C,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAsB,EACtB,EAAoB,EACpB,CAAS;IAET,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK;QACtC,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,2EAA2E;QAC3E,uCAAuC;QACvC,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM;KAC1C,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAuB,EACvB,EAAqB,EACrB,CAAS;IAET,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5C,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACvE,CAAC;AAED,SAAS,iBAAiB,CACxB,IAA0B,EAC1B,EAAwB,EACxB,CAAS;IAET,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,+CAA+C;IAC/C,QAAQ,EAAE,SAAS;IACnB,yCAAyC;IACzC,WAAW,EAAE,SAAS;IACtB,wDAAwD;IACxD,SAAS,EAAE,SAAS;IACpB,4EAA4E;IAC5E,WAAW,EAAE,SAAS;IACtB,8DAA8D;IAC9D,WAAW,EAAE,SAAS;CACd,CAAA;AAEV,iEAAiE;AACjE,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACD,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAA;AAEhC,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAC9C,CAAC;AAED,6EAA6E;AAE7E;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,GAAe,EAAE,KAAyB;IAC5D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAA;IACjC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAA;IACpB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,GAAe,EAAE,KAAyB;IAC7D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,CAAA;IAClD,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAA;IACpB,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AACvD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAkB,EAClB,UAAoB,EAAE;IAEtB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI;QACpB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBACb,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACjB,CAAC;IAEL,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;YAClB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;gBAAE,SAAQ;YACzC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAA;YACvC,QAAQ,GAAG,IAAI,CAAA;QACjB,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC;AAkDD,MAAM,gBAAgB,GAAc;IAClC,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,GAAG;IACf,SAAS,EAAE,QAAQ;IACnB,IAAI,EAAE,aAAa,CAAC,WAAW;CAChC,CAAA;AACD,MAAM,gBAAgB,GAAc;IAClC,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,GAAG;IACf,SAAS,EAAE,QAAQ;IACnB,IAAI,EAAE,aAAa,CAAC,WAAW;CAChC,CAAA;AACD,MAAM,eAAe,GAAW,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,SAAS,EAAE,CAAA;AAE5E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE,gBAAgB;IAC5B,SAAS,EAAE,eAAe;IAC1B,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,CAAC;CAChB,CAAA;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,UAAU,EAAE,EAAE,GAAG,gBAAgB,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE;IACxE,UAAU,EAAE,gBAAgB;IAC5B,SAAS,EAAE,eAAe;IAC1B,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,EAAE;CACjB,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,EAAE;IACR,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,WAAW,EAAE;IACtD,MAAM,EAAE,EAAE;CACX,CAAA;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,OAAO,EAAE,CAAC;IACV,SAAS,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,MAAM;QACjB,IAAI,EAAE,aAAa,CAAC,WAAW;KAChC;IACD,OAAO,EAAE,EAAE;IACX,WAAW,EAAE;QACX,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,YAAY,EAAE,CAAC;QACf,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;KACX;CACF,CAAA;AAED,wFAAwF;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAa,qBAAqB,CAAC,GAAG,CACvE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAChC,CAAA;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAW,qBAAqB,CAAC,GAAG,CACnE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CACf,CAAA;AAED,6EAA6E;AAC7E,gFAAgF;AAChF,2EAA2E;AAC3E,8BAA8B;AAE9B,MAAM,UAAU,iBAAiB,CAC/B,IAAqC,EACrC,QAAoB;IAEpB,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;QACvE,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;QACvE,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC;QACnE,WAAW,EAAE,SAAS,CAAC,OAAO,CAC5B,IAAI,EAAE,WAAW,IAAI,QAAQ,CAAC,WAAW,EACzC,QAAQ,CAAC,WAA6B,CACvC;QACD,YAAY,EAAE,SAAS,CAAC,OAAO,CAC7B,IAAI,EAAE,YAAY,IAAI,QAAQ,CAAC,YAAY,EAC3C,QAAQ,CAAC,YAA8B,CACxC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAgB,EAChB,EAAc,EACd,CAAS;IAET,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;QAChE,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;QAChE,SAAS,EAAE,SAAS,CAAC,IAAI,CACvB,IAAI,CAAC,SAA6B,EAClC,EAAE,CAAC,SAA6B,EAChC,CAAC,CACF;QACD,WAAW,EAAE,SAAS,CAAC,IAAI,CACzB,IAAI,CAAC,WAA6B,EAClC,EAAE,CAAC,WAA6B,EAChC,CAAC,CACF;QACD,YAAY,EAAE,SAAS,CAAC,IAAI,CAC1B,IAAI,CAAC,YAA8B,EACnC,EAAE,CAAC,YAA8B,EACjC,CAAC,CACF;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAA6C,EAC7C,QAAwB;IAExB,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC;QACtD,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;QAC9D,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;KAC/D,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAoB,EACpB,EAAkB,EAClB,CAAS;IAET,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAChB,IAAI,CAAC,IAAsB,EAC3B,EAAE,CAAC,IAAsB,EACzB,CAAC,CACF;QACD,MAAM,EAAE,SAAS,CAAC,IAAI,CACpB,IAAI,CAAC,MAA0B,EAC/B,EAAE,CAAC,MAA0B,EAC7B,CAAC,CACF;QACD,MAAM,EAAE,SAAS,CAAC,IAAI,CACpB,IAAI,CAAC,MAA0B,EAC/B,EAAE,CAAC,MAA0B,EAC7B,CAAC,CACF;KACF,CAAA;AACH,CAAC;AAED,SAAS,yBAAyB,CAChC,MAA+C,EAC/C,QAA4B;IAE5B,OAAO;QACL,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,QAAQ,CAAC,KAAK;QACtC,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM;QACzC,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,QAAQ,CAAC,YAAY;QAC3D,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;QAC5D,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;KAC7D,CAAA;AACH,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAAwB,EACxB,EAAsB,EACtB,CAAS;IAET,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7C,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/D,MAAM,EAAE,SAAS,CAAC,IAAI,CACpB,IAAI,CAAC,MAA0B,EAC/B,EAAE,CAAC,MAA0B,EAC7B,CAAC,CACF;QACD,MAAM,EAAE,SAAS,CAAC,IAAI,CACpB,IAAI,CAAC,MAA0B,EAC/B,EAAE,CAAC,MAA0B,EAC7B,CAAC,CACF;KACF,CAAA;AACH,CAAC;AAOD,MAAM,UAAU,mBAAmB,CACjC,MAA+B,EAC/B,QAAsB;IAEtB,OAAO;QACL,OAAO,EAAE,SAAS,CAAC,OAAO,CACxB,MAAM,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO,EACnC,QAAQ,CAAC,OAAyB,CACnC;QACD,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QACtE,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO;QAC5C,WAAW,EAAE,yBAAyB,CACpC,MAAM,EAAE,WAAW,EACnB,QAAQ,CAAC,WAAW,CACrB;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAkB,EAClB,EAAgB,EAChB,CAAS;IAET,OAAO;QACL,OAAO,EAAE,SAAS,CAAC,IAAI,CACrB,IAAI,CAAC,OAAyB,EAC9B,EAAE,CAAC,OAAyB,EAC5B,CAAC,CACF;QACD,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAChD,WAAW,EAAE,sBAAsB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;KACzE,CAAA;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAClC,MAA4B,EAC5B,QAAkB;IAElB,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAC9D,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAC/B,IAAc,EACd,EAAY,EACZ,CAAS;IAET,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAqB,CAAA;QAChD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAqB,CAAA;QAChD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAChC,KAAyB,EACzB,QAAgB;IAEhB,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,EAAU,EAAE,CAAS;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAW,EAAE,CAAA;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAmB,CAAA;QAC9C,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAmB,CAAA;QAC9C,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,6EAA6E;AAE7E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiB,EACjB,MAAmB,EACnB,KAAa;IAEb,MAAM,KAAK,GACT,OAAO,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QACjC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IAClC,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI;QAAE,OAAO,KAAK,CAAA;IACrC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;IAChE,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,CAAA;IACxB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG;QACtB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;KACnC,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAiB,EACjB,MAAmB,EACnB,KAAa;IAEb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAC7E,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,OAAO,CAAA;AACnD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,QAA0B,EAC1B,KAAa;IAEb,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAA;IACrC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAA;IACxC,OAAO,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC;AAED,6EAA6E;AAG7E,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACjD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAC7C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,QAAQ,GAAG,GAAG,CAAA;IAC1B,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,GAAG,GAAG,CAAA;IAC3C,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAA;AACjD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,CAAQ,EAAE,WAAmB;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAA;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;AAC7E,CAAC;AAED,4EAA4E;AAC5E,4EAA4E;AAC5E,sDAAsD;AACtD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA","sourcesContent":["/**\n * The vocabulary every chart node shares: what a *series* is, how an axis is\n * scaled and formatted, and the theme leaves each chart's own theme is assembled\n * from.\n *\n * This module exists because the three chart types are three ways of drawing the\n * same table. A line chart, a bar chart and a pie chart disagree about almost\n * everything visible — polylines against columns against wedges — and agree\n * about almost everything underneath: a series is a column with a caption and a\n * paint, a marker is a number formatted one way, a legend is a swatch beside a\n * label, and a theme is a tree of paints with one mapper and one tween. Writing\n * that three times would mean three answers to \"how does a chart round its axis\"\n * within one app.\n *\n * Kept renderer-agnostic (no `Node` imports) so the studio's own inspector\n * mappings can build a partial theme without pulling the node classes in, the\n * same way `line-chart-props.ts` always has.\n *\n * **Two conventions run through every resolver and lerp below**, inherited from\n * the shape system's `resolveStroke`/`resolveShadow`:\n *\n * - A **mapper** merges the author's loose, partial input onto a `previous`\n *   resolved value and resolves every leaf, so the tween always has resolved\n *   data to interpolate. It is idempotent.\n * - A **tween** interpolates two resolved values leaf by leaf. Categorical\n *   fields (`fontFamily`, `textAlign`) and fields that are `undefined` on either\n *   side **step at the midpoint**, because there is no meaningful in-between and\n *   defaulting the missing side to 0 would animate a font weight down to nothing\n *   on the way to \"unset\".\n */\n\nimport {\n  fillOps,\n  lerpNumber,\n  shadowOps,\n  strokeOps,\n  insetsOps,\n  textOps,\n  type DataRecord,\n  type Fill,\n  type FillResolved,\n  type Insets,\n  type InsetsResolved,\n  type Shadow,\n  type ShadowResolved,\n  type Stroke,\n  type StrokeResolved,\n  type TextStyle,\n} from \"@motionscript/core\"\n\n/**\n * One series of a chart: a column of the table, captioned and painted.\n *\n * `field` names the column carrying this series' values. What that becomes is\n * the chart's business — a traced polyline, a column of bars, a wedge — but the\n * three questions asked of it are the same everywhere: which column, what to\n * call it, what to paint it, and whether it is currently drawn.\n *\n * `fill` is an **override**: omit it and the series takes the theme palette's\n * entry for its own index, which is what makes a chart nobody has themed come\n * out in five distinct colours rather than five identical ones.\n */\nexport interface ChartSeries {\n  /** Key into each data row for this series' value. */\n  field: string\n  /** Legend caption for this series. */\n  label: string\n  /**\n   * Paint override for this series' mark and its legend swatch. Omit to take\n   * the theme palette's entry for this series' index.\n   */\n  fill?: Fill\n  /** Whether the series shows by default. Defaults to `true`. */\n  enabled?: boolean\n}\n\n/** A `[min, max]` numeric range in data units. */\nexport type Range = [min: number, max: number]\n\n/**\n * One axis's *data* domain — what it shows — as opposed to {@link AxisConfig},\n * which is how it's *styled*. Every field is optional: `range`/`ticks` derive\n * from the plotted data when omitted, and `label` defaults to `\"\"`.\n */\nexport interface AxisDomainConfig {\n  /** Caption drawn alongside the axis. Pass `\"\"` (the default) to hide it. */\n  label?: string\n  /** `[min, max]` of the scale. Derived from the data bounds when omitted. */\n  range?: Range\n  /** Tick values (in data units). Derived (five evenly-spaced) when omitted. */\n  ticks?: number[]\n  /**\n   * How a tick value is written down — a `number-format` pattern such as\n   * `#,##0.00` or `$#,##0`.\n   *\n   * Here rather than in {@link AxisConfig} because it is a statement about the\n   * *numbers*, not about the ink they are set in: `$` on a revenue axis says\n   * what the column holds, and it has to survive a re-theme. It sits beside\n   * `range` and `ticks` for the same reason those do.\n   */\n  format?: string\n}\n\n/**\n * An axis domain's @property mapper: merges the author's partial input onto\n * `previous`, so a later partial `.set({ yAxis: {...} })` patches\n * `label`/`range`/`ticks` independently. `range`/`ticks` staying `undefined`\n * after the merge is the auto-derive signal the scale getters read.\n */\nexport function resolveAxisDomain(\n  domain: AxisDomainConfig | undefined,\n  previous?: AxisDomainConfig\n): AxisDomainConfig {\n  return {\n    label: domain?.label ?? previous?.label ?? \"\",\n    range: domain?.range ?? previous?.range,\n    ticks: domain?.ticks ?? previous?.ticks,\n    format: domain?.format ?? previous?.format,\n  }\n}\n\n/**\n * An axis domain's @property tween: interpolates `range`/`ticks` numerically\n * (pairwise by index for `ticks`), so a `to` command that restates a range\n * rescales the plot smoothly. `label`, and either field when one side is in\n * auto-derive mode, step at the midpoint.\n */\nexport function lerpAxisDomain(\n  from: AxisDomainConfig,\n  to: AxisDomainConfig,\n  t: number\n): AxisDomainConfig {\n  return {\n    label: t < 0.5 ? from.label : to.label,\n    range: lerpOptionalRange(from.range, to.range, t),\n    ticks: lerpOptionalTicks(from.ticks, to.ticks, t),\n    // Steps at the midpoint with the caption, for the same reason: there is no\n    // halfway between `$#,##0` and `0.0%`.\n    format: t < 0.5 ? from.format : to.format,\n  }\n}\n\nfunction lerpOptionalRange(\n  from: Range | undefined,\n  to: Range | undefined,\n  t: number\n): Range | undefined {\n  if (!from || !to) return t < 0.5 ? from : to\n  return [lerpNumber(from[0], to[0], t), lerpNumber(from[1], to[1], t)]\n}\n\nfunction lerpOptionalTicks(\n  from: number[] | undefined,\n  to: number[] | undefined,\n  t: number\n): number[] | undefined {\n  if (!from || !to) return t < 0.5 ? from : to\n  const n = Math.max(from.length, to.length)\n  const out: number[] = []\n  for (let i = 0; i < n; i++) {\n    out.push(lerpNumber(from[i] ?? to[i], to[i] ?? from[i], t))\n  }\n  return out\n}\n\n/**\n * The low-level colour tokens the default themes are built from — a dark plot\n * panel with warm-grey axis furniture.\n */\nexport const CHART_PALETTE = {\n  /** Fill of the plot panel behind the marks. */\n  plotFill: \"#15130e\",\n  /** Colour of the plot's thick border. */\n  borderColor: \"#4a4036\",\n  /** Colour of the faint grid lines spanning the plot. */\n  gridColor: \"#2c2820\",\n  /** Colour of the numeric axis markers, axis captions, and legend labels. */\n  markerColor: \"#8a7f70\",\n  /** Colour of a spotlit region's dashed rules and its wash. */\n  regionColor: \"#d99a3a\",\n} as const\n\n/** The out-of-the-box series palette, cycled by series index. */\nexport const DEFAULT_SERIES_COLORS = [\n  \"#d9603b\",\n  \"#8194ad\",\n  \"#e0a93b\",\n  \"#5e9d6b\",\n  \"#9ec85a\",\n] as const\n\n/**\n * Opacity an *un*-spotlighted series fades to — its mark and its legend entry\n * alike, so the two dim together.\n */\nexport const SPOTLIGHT_DIM = 0.2\n\n/** Clamp a number into `[0, 1]` — the range every reveal signal here runs in. */\nexport function clampUnit(value: number): number {\n  return value < 0 ? 0 : value > 1 ? 1 : value\n}\n\n// ---- Row readers ---------------------------------------------------------\n\n/**\n * Read a numeric field off a row, defaulting missing/non-numeric values to 0.\n *\n * A column left as strings silently plots as 0, which is why the CSV parser's\n * numeric auto-coercion matters — a quoted or unit-suffixed column won't plot\n * until it's coerced.\n */\nexport function num(row: DataRecord, field: string | undefined): number {\n  if (field === undefined) return 0\n  const v = row[field]\n  return typeof v === \"number\" ? v : 0\n}\n\n/**\n * Read a field off a row as its caption — the counterpart to {@link num} for\n * the columns a chart *names* things by rather than measures them by (a bar's\n * category, a wedge's slice). A missing cell reads as empty rather than as the\n * string `\"undefined\"`.\n */\nexport function text(row: DataRecord, field: string | undefined): string {\n  if (field === undefined || field === \"\") return \"\"\n  const v = row[field]\n  return v === undefined || v === null ? \"\" : String(v)\n}\n\n/**\n * Every column that holds numbers across `data`, in header order, skipping the\n * names in `exclude` (typically the category column).\n *\n * A column counts as numeric only if every non-empty cell in it is a number, so\n * a stray text cell leaves the column out rather than plotting zeros. This is\n * what lets a chart plot \"every other column\" without the author naming twenty\n * fields.\n */\nexport function numericFields(\n  data: DataRecord[],\n  exclude: string[] = []\n): string[] {\n  if (data.length === 0) return []\n  const skip = new Set(exclude)\n  const seen = new Set<string>()\n  const order: string[] = []\n  for (const row of data)\n    for (const key of Object.keys(row))\n      if (!skip.has(key) && !seen.has(key)) {\n        seen.add(key)\n        order.push(key)\n      }\n\n  return order.filter((key) => {\n    let sawValue = false\n    for (const row of data) {\n      const v = row[key]\n      if (v === undefined || v === \"\") continue\n      if (typeof v !== \"number\") return false\n      sawValue = true\n    }\n    return sawValue\n  })\n}\n\n// ---- Theme branches ------------------------------------------------------\n\n/** One axis's (x or y) style vocabulary. */\nexport interface AxisConfig {\n  /** Style of each marker along the axis. */\n  labelStyle: TextStyle\n  /** Style of the axis caption. */\n  titleStyle: TextStyle\n  /**\n   * This axis's direction of the plot's internal grid — weight+fill honoured,\n   * dash/cap/join ignored (grid lines are drawn as filled rects).\n   */\n  lineStyle: Stroke\n  /**\n   * Gap between the plot and the marker row. Only the side facing the plot is\n   * read — `.top` for a horizontal axis, `.right` for a vertical one.\n   */\n  tickPadding: Insets\n  /** Gap between the marker row and the caption, read the same side. */\n  titlePadding: Insets\n}\n\n/** A legend's per-series colour swatch — a rounded chip, not the caption. */\nexport interface LegendMarkerConfig {\n  width: number\n  height: number\n  borderRadius: number\n  stroke: Stroke\n  shadow: Shadow\n}\n\n/** A legend's visual theme. */\nexport interface LegendConfig {\n  padding: Insets\n  /** Caption style — only the swatch carries the series colour. */\n  textStyle: TextStyle\n  /** Gap between legend entries. */\n  itemGap: number\n  markerStyle: LegendMarkerConfig\n}\n\n/** The plot panel a cartesian chart draws its marks over. */\nexport interface PlotAreaConfig {\n  stroke: Stroke\n  fill: Fill\n  shadow: Shadow\n}\n\nconst AXIS_LABEL_STYLE: TextStyle = {\n  fontSize: 24,\n  fontWeight: 700,\n  textAlign: \"center\",\n  fill: CHART_PALETTE.markerColor,\n}\nconst AXIS_TITLE_STYLE: TextStyle = {\n  fontSize: 30,\n  fontWeight: 600,\n  textAlign: \"center\",\n  fill: CHART_PALETTE.markerColor,\n}\nconst AXIS_LINE_STYLE: Stroke = { weight: 2, fill: CHART_PALETTE.gridColor }\n\n/** The default styling of a horizontal (marker row beneath the plot) axis. */\nexport const DEFAULT_X_AXIS: AxisConfig = {\n  labelStyle: AXIS_LABEL_STYLE,\n  titleStyle: AXIS_TITLE_STYLE,\n  lineStyle: AXIS_LINE_STYLE,\n  tickPadding: 20,\n  titlePadding: 4,\n}\n\n/** The default styling of a vertical (marker column beside the plot) axis. */\nexport const DEFAULT_Y_AXIS: AxisConfig = {\n  labelStyle: { ...AXIS_LABEL_STYLE, fontWeight: 500, textAlign: \"right\" },\n  titleStyle: AXIS_TITLE_STYLE,\n  lineStyle: AXIS_LINE_STYLE,\n  tickPadding: 40,\n  titlePadding: 24,\n}\n\n/**\n * The default plot panel: **unpainted**, framed. A chart reads against the\n * stage rather than punching a panel into it, which is the look the family was\n * designed at.\n */\nexport const DEFAULT_PLOT_AREA: PlotAreaConfig = {\n  fill: [],\n  stroke: { weight: 6, fill: CHART_PALETTE.borderColor },\n  shadow: [],\n}\n\n/** The default legend styling, shared by every chart that draws one. */\nexport const DEFAULT_LEGEND: LegendConfig = {\n  padding: 0,\n  textStyle: {\n    fontSize: 30,\n    fontWeight: 600,\n    textAlign: \"left\",\n    fill: CHART_PALETTE.markerColor,\n  },\n  itemGap: 44,\n  markerStyle: {\n    width: 60,\n    height: 24,\n    borderRadius: 6,\n    stroke: [],\n    shadow: [],\n  },\n}\n\n/** The default per-series stroke palette — {@link DEFAULT_SERIES_COLORS}, drawn 4px. */\nexport const DEFAULT_SERIES_STROKES: Stroke[] = DEFAULT_SERIES_COLORS.map(\n  (fill) => ({ weight: 4, fill })\n)\n\n/** The default per-series fill palette — the same colours, as solid paint. */\nexport const DEFAULT_SERIES_FILLS: Fill[] = DEFAULT_SERIES_COLORS.map(\n  (fill) => fill\n)\n\n// ---- Theme branch resolvers ----------------------------------------------\n// Each chart type assembles its own theme out of these, so \"the axis furniture\"\n// means one thing across the family and each chart still declares only the\n// branches it actually draws.\n\nexport function resolveAxisConfig(\n  axis: Partial<AxisConfig> | undefined,\n  previous: AxisConfig\n): AxisConfig {\n  return {\n    labelStyle: textOps.resolveStyle(axis?.labelStyle, previous.labelStyle),\n    titleStyle: textOps.resolveStyle(axis?.titleStyle, previous.titleStyle),\n    lineStyle: strokeOps.resolve(axis?.lineStyle ?? previous.lineStyle),\n    tickPadding: insetsOps.resolve(\n      axis?.tickPadding ?? previous.tickPadding,\n      previous.tickPadding as InsetsResolved\n    ),\n    titlePadding: insetsOps.resolve(\n      axis?.titlePadding ?? previous.titlePadding,\n      previous.titlePadding as InsetsResolved\n    ),\n  }\n}\n\nexport function lerpAxisConfig(\n  from: AxisConfig,\n  to: AxisConfig,\n  t: number\n): AxisConfig {\n  return {\n    labelStyle: textOps.lerpStyle(from.labelStyle, to.labelStyle, t),\n    titleStyle: textOps.lerpStyle(from.titleStyle, to.titleStyle, t),\n    lineStyle: strokeOps.lerp(\n      from.lineStyle as StrokeResolved[],\n      to.lineStyle as StrokeResolved[],\n      t\n    ),\n    tickPadding: insetsOps.lerp(\n      from.tickPadding as InsetsResolved,\n      to.tickPadding as InsetsResolved,\n      t\n    ),\n    titlePadding: insetsOps.lerp(\n      from.titlePadding as InsetsResolved,\n      to.titlePadding as InsetsResolved,\n      t\n    ),\n  }\n}\n\nexport function resolvePlotArea(\n  plotArea: Partial<PlotAreaConfig> | undefined,\n  previous: PlotAreaConfig\n): PlotAreaConfig {\n  return {\n    fill: fillOps.resolve(plotArea?.fill ?? previous.fill),\n    stroke: strokeOps.resolve(plotArea?.stroke ?? previous.stroke),\n    shadow: shadowOps.resolve(plotArea?.shadow ?? previous.shadow),\n  }\n}\n\nexport function lerpPlotArea(\n  from: PlotAreaConfig,\n  to: PlotAreaConfig,\n  t: number\n): PlotAreaConfig {\n  return {\n    fill: fillOps.lerp(\n      from.fill as FillResolved[],\n      to.fill as FillResolved[],\n      t\n    ),\n    stroke: strokeOps.lerp(\n      from.stroke as StrokeResolved[],\n      to.stroke as StrokeResolved[],\n      t\n    ),\n    shadow: shadowOps.lerp(\n      from.shadow as ShadowResolved[],\n      to.shadow as ShadowResolved[],\n      t\n    ),\n  }\n}\n\nfunction resolveLegendMarkerConfig(\n  marker: Partial<LegendMarkerConfig> | undefined,\n  previous: LegendMarkerConfig\n): LegendMarkerConfig {\n  return {\n    width: marker?.width ?? previous.width,\n    height: marker?.height ?? previous.height,\n    borderRadius: marker?.borderRadius ?? previous.borderRadius,\n    stroke: strokeOps.resolve(marker?.stroke ?? previous.stroke),\n    shadow: shadowOps.resolve(marker?.shadow ?? previous.shadow),\n  }\n}\n\nfunction lerpLegendMarkerConfig(\n  from: LegendMarkerConfig,\n  to: LegendMarkerConfig,\n  t: number\n): LegendMarkerConfig {\n  return {\n    width: lerpNumber(from.width, to.width, t),\n    height: lerpNumber(from.height, to.height, t),\n    borderRadius: lerpNumber(from.borderRadius, to.borderRadius, t),\n    stroke: strokeOps.lerp(\n      from.stroke as StrokeResolved[],\n      to.stroke as StrokeResolved[],\n      t\n    ),\n    shadow: shadowOps.lerp(\n      from.shadow as ShadowResolved[],\n      to.shadow as ShadowResolved[],\n      t\n    ),\n  }\n}\n\n/** A legend theme as the author may state it — every branch optional. */\nexport type LegendTheme = Partial<Omit<LegendConfig, \"markerStyle\">> & {\n  markerStyle?: Partial<LegendMarkerConfig>\n}\n\nexport function resolveLegendConfig(\n  legend: LegendTheme | undefined,\n  previous: LegendConfig\n): LegendConfig {\n  return {\n    padding: insetsOps.resolve(\n      legend?.padding ?? previous.padding,\n      previous.padding as InsetsResolved\n    ),\n    textStyle: textOps.resolveStyle(legend?.textStyle, previous.textStyle),\n    itemGap: legend?.itemGap ?? previous.itemGap,\n    markerStyle: resolveLegendMarkerConfig(\n      legend?.markerStyle,\n      previous.markerStyle\n    ),\n  }\n}\n\nexport function lerpLegendConfig(\n  from: LegendConfig,\n  to: LegendConfig,\n  t: number\n): LegendConfig {\n  return {\n    padding: insetsOps.lerp(\n      from.padding as InsetsResolved,\n      to.padding as InsetsResolved,\n      t\n    ),\n    textStyle: textOps.lerpStyle(from.textStyle, to.textStyle, t),\n    itemGap: lerpNumber(from.itemGap, to.itemGap, t),\n    markerStyle: lerpLegendMarkerConfig(from.markerStyle, to.markerStyle, t),\n  }\n}\n\n/** A whole-palette override replaces the previous palette outright. */\nexport function resolveSeriesStrokes(\n  styles: Stroke[] | undefined,\n  previous: Stroke[]\n): Stroke[] {\n  return (styles ?? previous).map((s) => strokeOps.resolve(s))\n}\n\n/** Pairwise by index; a palette that grows/shrinks holds the longer side's tail. */\nexport function lerpSeriesStrokes(\n  from: Stroke[],\n  to: Stroke[],\n  t: number\n): Stroke[] {\n  const n = Math.max(from.length, to.length)\n  const out: Stroke[] = []\n  for (let i = 0; i < n; i++) {\n    const a = (from[i] ?? to[i]) as StrokeResolved[]\n    const b = (to[i] ?? from[i]) as StrokeResolved[]\n    out.push(strokeOps.lerp(a, b, t))\n  }\n  return out\n}\n\n/** The fill-palette twin of {@link resolveSeriesStrokes}, for filled marks. */\nexport function resolveSeriesFills(\n  fills: Fill[] | undefined,\n  previous: Fill[]\n): Fill[] {\n  return (fills ?? previous).map((f) => fillOps.resolve(f))\n}\n\n/** The fill-palette twin of {@link lerpSeriesStrokes}. */\nexport function lerpSeriesFills(from: Fill[], to: Fill[], t: number): Fill[] {\n  const n = Math.max(from.length, to.length)\n  const out: Fill[] = []\n  for (let i = 0; i < n; i++) {\n    const a = (from[i] ?? to[i]) as FillResolved[]\n    const b = (to[i] ?? from[i]) as FillResolved[]\n    out.push(fillOps.lerp(a, b, t))\n  }\n  return out\n}\n\n// ---- Per-series paint ----------------------------------------------------\n\n/**\n * The effective stroke for series `index`: the palette's entry at\n * `index % palette.length`, with the series' own `fill`, if set, overriding just\n * the last (topmost) layer's colour.\n */\nexport function resolveSeriesStroke(\n  palette: Stroke[],\n  series: ChartSeries,\n  index: number\n): Stroke {\n  const entry: Stroke =\n    palette.length > 0\n      ? palette[index % palette.length]\n      : { weight: 4, fill: \"white\" }\n  if (series.fill == null) return entry\n  const layers = strokeOps.resolve(entry)\n  if (layers.length === 0) return { weight: 4, fill: series.fill }\n  const next = [...layers]\n  next[next.length - 1] = {\n    ...next[next.length - 1],\n    fill: fillOps.resolve(series.fill),\n  }\n  return next\n}\n\n/**\n * The effective *colour* for series `index` — the same colour\n * {@link resolveSeriesStroke} draws its line in — for contexts (a legend\n * swatch) that only need the fill.\n */\nexport function resolveSeriesFill(\n  palette: Stroke[],\n  series: ChartSeries,\n  index: number\n): Fill {\n  const layers = strokeOps.resolve(resolveSeriesStroke(palette, series, index))\n  return layers[layers.length - 1]?.fill ?? \"white\"\n}\n\n/**\n * The effective paint for mark `index` of a **filled** chart (a bar, a wedge):\n * the series' own `fill` when it carries one, else the palette's entry for its\n * index, cycled.\n *\n * The stroke twin above has to reach inside a stroke to swap one layer's colour;\n * a filled mark has no such geometry wrapped around its paint, so an override is\n * simply the whole answer.\n */\nexport function resolvePalettePaint(\n  palette: Fill[],\n  override: Fill | undefined,\n  index: number\n): Fill {\n  if (override != null) return override\n  if (palette.length === 0) return \"white\"\n  return palette[index % palette.length]\n}\n\n// ---- Scales and formatting -----------------------------------------------\n\n\n/** Format a marker value: integers plain, otherwise trimmed to one decimal. */\nexport function formatMarker(value: number): string {\n  if (Number.isInteger(value)) return String(value)\n  return value.toFixed(1).replace(/\\.0$/, \"\")\n}\n\n/** Format a fraction in `[0, 1]` as a percentage: integers plain, else one decimal. */\nexport function formatPercent(fraction: number): string {\n  const pct = fraction * 100\n  if (Number.isInteger(pct)) return `${pct}%`\n  return `${pct.toFixed(1).replace(/\\.0$/, \"\")}%`\n}\n\n/** `markerCount` evenly-spaced tick values across `[min, max]`, ends inclusive. */\nexport function markerValues([min, max]: Range, markerCount: number): number[] {\n  const n = Math.max(2, Math.round(markerCount))\n  return Array.from({ length: n + 1 }, (_, i) => min + ((max - min) / n) * i)\n}\n\n// Lifted into the engine, because a graph and a diagram want them too — see\n// `@motionscript/core/component`. Re-exported so a chart, and anything that\n// copied one, still reaches them where it always did.\nexport { niceStep, enterBudget } from \"@motionscript/core/component\"\n"]}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/kit/shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * The vocabulary every chart node shares: what a *series* is, how an axis is\r\n * scaled and formatted, and the theme leaves each chart's own theme is assembled\r\n * from.\r\n *\r\n * This module exists because the three chart types are three ways of drawing the\r\n * same table. A line chart, a bar chart and a pie chart disagree about almost\r\n * everything visible — polylines against columns against wedges — and agree\r\n * about almost everything underneath: a series is a column with a caption and a\r\n * paint, a marker is a number formatted one way, a legend is a swatch beside a\r\n * label, and a theme is a tree of paints with one mapper and one tween. Writing\r\n * that three times would mean three answers to \"how does a chart round its axis\"\r\n * within one app.\r\n *\r\n * Kept renderer-agnostic (no `Node` imports) so a host's own inspector\r\n * mappings can build a partial theme without pulling the node classes in.\r\n *\r\n * **Two conventions run through every resolver and lerp below**, inherited from\r\n * the shape system's `resolveStroke`/`resolveShadow`:\r\n *\r\n * - A **mapper** merges the author's loose, partial input onto a `previous`\r\n *   resolved value and resolves every leaf, so the tween always has resolved\r\n *   data to interpolate. It is idempotent.\r\n * - A **tween** interpolates two resolved values leaf by leaf. Categorical\r\n *   fields (`fontFamily`, `textAlign`) and fields that are `undefined` on either\r\n *   side **step at the midpoint**, because there is no meaningful in-between and\r\n *   defaulting the missing side to 0 would animate a font weight down to nothing\r\n *   on the way to \"unset\".\r\n */\r\n\r\nimport {\r\n  fillOps,\r\n  lerpNumber,\r\n  shadowOps,\r\n  strokeOps,\r\n  insetsOps,\r\n  textOps,\r\n  type DataRecord,\r\n  type Fill,\r\n  type FillResolved,\r\n  type Insets,\r\n  type InsetsResolved,\r\n  type Shadow,\r\n  type ShadowResolved,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n  type TextStyle,\r\n} from \"@motionscript/sdk\"\r\n\r\n/**\r\n * One series of a chart: a column of the table, captioned and painted.\r\n *\r\n * `field` names the column carrying this series' values. What that becomes is\r\n * the chart's business — a traced polyline, a column of bars, a wedge — but the\r\n * three questions asked of it are the same everywhere: which column, what to\r\n * call it, what to paint it, and whether it is currently drawn.\r\n *\r\n * `fill` is an **override**: omit it and the series takes the theme palette's\r\n * entry for its own index, which is what makes a chart nobody has themed come\r\n * out in five distinct colours rather than five identical ones.\r\n */\r\nexport interface ChartSeries {\r\n  /** Key into each data row for this series' value. */\r\n  field: string\r\n  /** Legend caption for this series. */\r\n  label: string\r\n  /**\r\n   * Paint override for this series' mark and its legend swatch. Omit to take\r\n   * the theme palette's entry for this series' index.\r\n   */\r\n  fill?: Fill\r\n  /** Whether the series shows by default. Defaults to `true`. */\r\n  enabled?: boolean\r\n}\r\n\r\n/** A `[min, max]` numeric range in data units. */\r\nexport type Range = [min: number, max: number]\r\n\r\n/**\r\n * One axis's *data* domain — what it shows — as opposed to {@link AxisConfig},\r\n * which is how it's *styled*. Every field is optional: `range`/`ticks` derive\r\n * from the plotted data when omitted, and `label` defaults to `\"\"`.\r\n */\r\nexport interface AxisDomainConfig {\r\n  /** Caption drawn alongside the axis. Pass `\"\"` (the default) to hide it. */\r\n  label?: string\r\n  /** `[min, max]` of the scale. Derived from the data bounds when omitted. */\r\n  range?: Range\r\n  /** Tick values (in data units). Derived (five evenly-spaced) when omitted. */\r\n  ticks?: number[]\r\n  /**\r\n   * How a tick value is written down — a `number-format` pattern such as\r\n   * `#,##0.00` or `$#,##0`.\r\n   *\r\n   * Here rather than in {@link AxisConfig} because it is a statement about the\r\n   * *numbers*, not about the ink they are set in: `$` on a revenue axis says\r\n   * what the column holds, and it has to survive a re-theme. It sits beside\r\n   * `range` and `ticks` for the same reason those do.\r\n   */\r\n  format?: string\r\n}\r\n\r\n/**\r\n * An axis domain's @property mapper: merges the author's partial input onto\r\n * `previous`, so a later partial `.set({ yAxis: {...} })` patches\r\n * `label`/`range`/`ticks` independently. `range`/`ticks` staying `undefined`\r\n * after the merge is the auto-derive signal the scale getters read.\r\n */\r\nexport function resolveAxisDomain(\r\n  domain: AxisDomainConfig | undefined,\r\n  previous?: AxisDomainConfig\r\n): AxisDomainConfig {\r\n  return {\r\n    label: domain?.label ?? previous?.label ?? \"\",\r\n    range: domain?.range ?? previous?.range,\r\n    ticks: domain?.ticks ?? previous?.ticks,\r\n    format: domain?.format ?? previous?.format,\r\n  }\r\n}\r\n\r\n/**\r\n * An axis domain's @property tween: interpolates `range`/`ticks` numerically\r\n * (pairwise by index for `ticks`), so a `to` command that restates a range\r\n * rescales the plot smoothly. `label`, and either field when one side is in\r\n * auto-derive mode, step at the midpoint.\r\n */\r\nexport function lerpAxisDomain(\r\n  from: AxisDomainConfig,\r\n  to: AxisDomainConfig,\r\n  t: number\r\n): AxisDomainConfig {\r\n  return {\r\n    label: t < 0.5 ? from.label : to.label,\r\n    range: lerpOptionalRange(from.range, to.range, t),\r\n    ticks: lerpOptionalTicks(from.ticks, to.ticks, t),\r\n    // Steps at the midpoint with the caption, for the same reason: there is no\r\n    // halfway between `$#,##0` and `0.0%`.\r\n    format: t < 0.5 ? from.format : to.format,\r\n  }\r\n}\r\n\r\nfunction lerpOptionalRange(\r\n  from: Range | undefined,\r\n  to: Range | undefined,\r\n  t: number\r\n): Range | undefined {\r\n  if (!from || !to) return t < 0.5 ? from : to\r\n  return [lerpNumber(from[0], to[0], t), lerpNumber(from[1], to[1], t)]\r\n}\r\n\r\nfunction lerpOptionalTicks(\r\n  from: number[] | undefined,\r\n  to: number[] | undefined,\r\n  t: number\r\n): number[] | undefined {\r\n  if (!from || !to) return t < 0.5 ? from : to\r\n  const n = Math.max(from.length, to.length)\r\n  const out: number[] = []\r\n  for (let i = 0; i < n; i++) {\r\n    out.push(lerpNumber(from[i] ?? to[i], to[i] ?? from[i], t))\r\n  }\r\n  return out\r\n}\r\n\r\n/**\r\n * Where a generic `to()` of an axis domain should land, given the domain as it\r\n * is *drawn* (`drawn`, with `range` and `ticks` resolved off the data), or\r\n * `undefined` when the request states neither a `range` nor `ticks` and the\r\n * plain property tween will do.\r\n *\r\n * The stored domain of an auto axis has no `range` and no `ticks`, and\r\n * {@link lerpAxisDomain} steps an unset side at the midpoint, so tweening the\r\n * stored value from an auto axis is a cut. The charts therefore tween between\r\n * resolved domains, as their zoom does; this builds the destination. A `range`\r\n * given without `ticks` keeps the tick *count* the axis already draws, so each\r\n * marker slides from its old value to its new one instead of the row popping.\r\n */\r\nexport function axisTweenTarget(\r\n  drawn: AxisDomainConfig,\r\n  requested: AxisDomainConfig | undefined\r\n): AxisDomainConfig | undefined {\r\n  if (requested?.range === undefined && requested?.ticks === undefined) return undefined\r\n  const target = resolveAxisDomain(requested, drawn)\r\n  if (requested.ticks === undefined && requested.range !== undefined) {\r\n    const count = Math.max(2, drawn.ticks?.length ?? 2)\r\n    target.ticks = markerValues(requested.range, count - 1)\r\n  }\r\n  return target\r\n}\r\n\r\n/**\r\n * The low-level colour tokens the default themes are built from — a dark plot\r\n * panel with warm-grey axis furniture.\r\n */\r\nexport const CHART_PALETTE = {\r\n  /** Fill of the plot panel behind the marks. */\r\n  plotFill: \"#15130e\",\r\n  /** Colour of the plot's thick border. */\r\n  borderColor: \"#4a4036\",\r\n  /** Colour of the faint grid lines spanning the plot. */\r\n  gridColor: \"#2c2820\",\r\n  /** Colour of the numeric axis markers, axis captions, and legend labels. */\r\n  markerColor: \"#8a7f70\",\r\n  /** Colour of a spotlit region's dashed rules and its wash. */\r\n  regionColor: \"#d99a3a\",\r\n} as const\r\n\r\n/** The out-of-the-box series palette, cycled by series index. */\r\nexport const DEFAULT_SERIES_COLORS = [\r\n  \"#d9603b\",\r\n  \"#8194ad\",\r\n  \"#e0a93b\",\r\n  \"#5e9d6b\",\r\n  \"#9ec85a\",\r\n] as const\r\n\r\n/**\r\n * Opacity an *un*-spotlighted series fades to — its mark and its legend entry\r\n * alike, so the two dim together.\r\n */\r\nexport const SPOTLIGHT_DIM = 0.2\r\n\r\n/** Clamp a number into `[0, 1]` — the range every reveal signal here runs in. */\r\nexport function clampUnit(value: number): number {\r\n  return value < 0 ? 0 : value > 1 ? 1 : value\r\n}\r\n\r\n// ---- Row readers ---------------------------------------------------------\r\n\r\n/**\r\n * Read a numeric field off a row, defaulting missing, non-numeric and non-finite\r\n * values to 0.\r\n *\r\n * A column left as strings silently plots as 0, which is why the CSV parser's\r\n * numeric auto-coercion matters — a quoted or unit-suffixed column won't plot\r\n * until it's coerced.\r\n */\r\nexport function num(row: DataRecord, field: string | undefined): number {\r\n  if (field === undefined) return 0\r\n  const v = row[field]\r\n  // A `NaN` or infinite cell is no more a measurement than a missing one: read\r\n  // as 0, it cannot poison the scale and turn every point into `NaN`.\r\n  return typeof v === \"number\" && Number.isFinite(v) ? v : 0\r\n}\r\n\r\n/**\r\n * Read a field off a row as its caption — the counterpart to {@link num} for\r\n * the columns a chart *names* things by rather than measures them by (a bar's\r\n * category, a wedge's slice). A missing cell reads as empty rather than as the\r\n * string `\"undefined\"`.\r\n */\r\nexport function text(row: DataRecord, field: string | undefined): string {\r\n  if (field === undefined || field === \"\") return \"\"\r\n  const v = row[field]\r\n  return v === undefined || v === null ? \"\" : String(v)\r\n}\r\n\r\n/**\r\n * Every column that holds numbers across `data`, in header order, skipping the\r\n * names in `exclude` (typically the category column).\r\n *\r\n * A column counts as numeric only if every non-empty cell in it is a number, so\r\n * a stray text cell leaves the column out rather than plotting zeros. This is\r\n * what lets a chart plot \"every other column\" without the author naming twenty\r\n * fields.\r\n */\r\nexport function numericFields(\r\n  data: DataRecord[],\r\n  exclude: string[] = []\r\n): string[] {\r\n  if (data.length === 0) return []\r\n  const skip = new Set(exclude)\r\n  const seen = new Set<string>()\r\n  const order: string[] = []\r\n  for (const row of data)\r\n    for (const key of Object.keys(row))\r\n      if (!skip.has(key) && !seen.has(key)) {\r\n        seen.add(key)\r\n        order.push(key)\r\n      }\r\n\r\n  return order.filter((key) => {\r\n    let sawValue = false\r\n    for (const row of data) {\r\n      const v = row[key]\r\n      if (v === undefined || 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// ---- Theme branches ------------------------------------------------------\r\n\r\n/** One axis's (x or y) style vocabulary. */\r\nexport interface AxisConfig {\r\n  /** Style of each marker along the axis. */\r\n  labelStyle: TextStyle\r\n  /** Style of the axis caption. */\r\n  titleStyle: TextStyle\r\n  /**\r\n   * This axis's direction of the plot's internal grid — weight+fill honoured,\r\n   * dash/cap/join ignored (grid lines are drawn as filled rects).\r\n   */\r\n  lineStyle: Stroke\r\n  /**\r\n   * Gap between the plot and the marker row. Only the side facing the plot is\r\n   * read — `.top` for a horizontal axis, `.right` for a vertical one.\r\n   */\r\n  tickPadding: Insets\r\n  /** Gap between the marker row and the caption, read the same side. */\r\n  titlePadding: Insets\r\n}\r\n\r\n/** A legend's per-series colour swatch — a rounded chip, not the caption. */\r\nexport interface LegendMarkerConfig {\r\n  width: number\r\n  height: number\r\n  borderRadius: number\r\n  stroke: Stroke\r\n  shadow: Shadow\r\n}\r\n\r\n/** A legend's visual theme. */\r\nexport interface LegendConfig {\r\n  padding: Insets\r\n  /** Caption style — only the swatch carries the series colour. */\r\n  textStyle: TextStyle\r\n  /** Gap between legend entries. */\r\n  itemGap: number\r\n  markerStyle: LegendMarkerConfig\r\n}\r\n\r\n/** The plot panel a cartesian chart draws its marks over. */\r\nexport interface PlotAreaConfig {\r\n  stroke: Stroke\r\n  fill: Fill\r\n  shadow: Shadow\r\n}\r\n\r\nconst AXIS_LABEL_STYLE: TextStyle = {\r\n  fontSize: 24,\r\n  fontWeight: 700,\r\n  textAlign: \"center\",\r\n  fill: CHART_PALETTE.markerColor,\r\n}\r\nconst AXIS_TITLE_STYLE: TextStyle = {\r\n  fontSize: 30,\r\n  fontWeight: 600,\r\n  textAlign: \"center\",\r\n  fill: CHART_PALETTE.markerColor,\r\n}\r\nconst AXIS_LINE_STYLE: Stroke = { weight: 2, fill: CHART_PALETTE.gridColor }\r\n\r\n/** The default styling of a horizontal (marker row beneath the plot) axis. */\r\nexport const DEFAULT_X_AXIS: AxisConfig = {\r\n  labelStyle: AXIS_LABEL_STYLE,\r\n  titleStyle: AXIS_TITLE_STYLE,\r\n  lineStyle: AXIS_LINE_STYLE,\r\n  tickPadding: 20,\r\n  titlePadding: 4,\r\n}\r\n\r\n/** The default styling of a vertical (marker column beside the plot) axis. */\r\nexport const DEFAULT_Y_AXIS: AxisConfig = {\r\n  labelStyle: { ...AXIS_LABEL_STYLE, fontWeight: 500, textAlign: \"right\" },\r\n  titleStyle: AXIS_TITLE_STYLE,\r\n  lineStyle: AXIS_LINE_STYLE,\r\n  tickPadding: 40,\r\n  titlePadding: 24,\r\n}\r\n\r\n/**\r\n * The default plot panel: **unpainted**, framed. A chart reads against the\r\n * stage rather than punching a panel into it, which is the look the family was\r\n * designed at.\r\n */\r\nexport const DEFAULT_PLOT_AREA: PlotAreaConfig = {\r\n  fill: [],\r\n  stroke: { weight: 6, fill: CHART_PALETTE.borderColor },\r\n  shadow: [],\r\n}\r\n\r\n/** The default legend styling, shared by every chart that draws one. */\r\nexport const DEFAULT_LEGEND: LegendConfig = {\r\n  padding: 0,\r\n  textStyle: {\r\n    fontSize: 30,\r\n    fontWeight: 600,\r\n    textAlign: \"left\",\r\n    fill: CHART_PALETTE.markerColor,\r\n  },\r\n  itemGap: 44,\r\n  markerStyle: {\r\n    width: 60,\r\n    height: 24,\r\n    borderRadius: 6,\r\n    stroke: [],\r\n    shadow: [],\r\n  },\r\n}\r\n\r\n/** The default per-series stroke palette — {@link DEFAULT_SERIES_COLORS}, drawn 4px. */\r\nexport const DEFAULT_SERIES_STROKES: Stroke[] = DEFAULT_SERIES_COLORS.map(\r\n  (fill) => ({ weight: 4, fill })\r\n)\r\n\r\n/** The default per-series fill palette — the same colours, as solid paint. */\r\nexport const DEFAULT_SERIES_FILLS: Fill[] = DEFAULT_SERIES_COLORS.map(\r\n  (fill) => fill\r\n)\r\n\r\n// ---- Theme branch resolvers ----------------------------------------------\r\n// Each chart type assembles its own theme out of these, so \"the axis furniture\"\r\n// means one thing across the family and each chart still declares only the\r\n// branches it actually draws.\r\n\r\nexport function resolveAxisConfig(\r\n  axis: Partial<AxisConfig> | undefined,\r\n  previous: AxisConfig\r\n): AxisConfig {\r\n  return {\r\n    labelStyle: textOps.resolveStyle(axis?.labelStyle, previous.labelStyle),\r\n    titleStyle: textOps.resolveStyle(axis?.titleStyle, previous.titleStyle),\r\n    lineStyle: strokeOps.resolve(axis?.lineStyle ?? previous.lineStyle),\r\n    tickPadding: insetsOps.resolve(\r\n      axis?.tickPadding ?? previous.tickPadding,\r\n      previous.tickPadding as InsetsResolved\r\n    ),\r\n    titlePadding: insetsOps.resolve(\r\n      axis?.titlePadding ?? previous.titlePadding,\r\n      previous.titlePadding as InsetsResolved\r\n    ),\r\n  }\r\n}\r\n\r\nexport function lerpAxisConfig(\r\n  from: AxisConfig,\r\n  to: AxisConfig,\r\n  t: number\r\n): AxisConfig {\r\n  return {\r\n    labelStyle: textOps.lerpStyle(from.labelStyle, to.labelStyle, t),\r\n    titleStyle: textOps.lerpStyle(from.titleStyle, to.titleStyle, t),\r\n    lineStyle: strokeOps.lerp(\r\n      from.lineStyle as StrokeResolved[],\r\n      to.lineStyle as StrokeResolved[],\r\n      t\r\n    ),\r\n    tickPadding: insetsOps.lerp(\r\n      from.tickPadding as InsetsResolved,\r\n      to.tickPadding as InsetsResolved,\r\n      t\r\n    ),\r\n    titlePadding: insetsOps.lerp(\r\n      from.titlePadding as InsetsResolved,\r\n      to.titlePadding as InsetsResolved,\r\n      t\r\n    ),\r\n  }\r\n}\r\n\r\nexport function resolvePlotArea(\r\n  plotArea: Partial<PlotAreaConfig> | undefined,\r\n  previous: PlotAreaConfig\r\n): PlotAreaConfig {\r\n  return {\r\n    fill: fillOps.resolve(plotArea?.fill ?? previous.fill),\r\n    stroke: strokeOps.resolve(plotArea?.stroke ?? previous.stroke),\r\n    shadow: shadowOps.resolve(plotArea?.shadow ?? previous.shadow),\r\n  }\r\n}\r\n\r\nexport function lerpPlotArea(\r\n  from: PlotAreaConfig,\r\n  to: PlotAreaConfig,\r\n  t: number\r\n): PlotAreaConfig {\r\n  return {\r\n    fill: fillOps.lerp(\r\n      from.fill as FillResolved[],\r\n      to.fill as FillResolved[],\r\n      t\r\n    ),\r\n    stroke: strokeOps.lerp(\r\n      from.stroke as StrokeResolved[],\r\n      to.stroke as StrokeResolved[],\r\n      t\r\n    ),\r\n    shadow: shadowOps.lerp(\r\n      from.shadow as ShadowResolved[],\r\n      to.shadow as ShadowResolved[],\r\n      t\r\n    ),\r\n  }\r\n}\r\n\r\nfunction resolveLegendMarkerConfig(\r\n  marker: Partial<LegendMarkerConfig> | undefined,\r\n  previous: LegendMarkerConfig\r\n): LegendMarkerConfig {\r\n  return {\r\n    width: marker?.width ?? previous.width,\r\n    height: marker?.height ?? previous.height,\r\n    borderRadius: marker?.borderRadius ?? previous.borderRadius,\r\n    stroke: strokeOps.resolve(marker?.stroke ?? previous.stroke),\r\n    shadow: shadowOps.resolve(marker?.shadow ?? previous.shadow),\r\n  }\r\n}\r\n\r\nfunction lerpLegendMarkerConfig(\r\n  from: LegendMarkerConfig,\r\n  to: LegendMarkerConfig,\r\n  t: number\r\n): LegendMarkerConfig {\r\n  return {\r\n    width: lerpNumber(from.width, to.width, t),\r\n    height: lerpNumber(from.height, to.height, t),\r\n    borderRadius: lerpNumber(from.borderRadius, to.borderRadius, t),\r\n    stroke: strokeOps.lerp(\r\n      from.stroke as StrokeResolved[],\r\n      to.stroke as StrokeResolved[],\r\n      t\r\n    ),\r\n    shadow: shadowOps.lerp(\r\n      from.shadow as ShadowResolved[],\r\n      to.shadow as ShadowResolved[],\r\n      t\r\n    ),\r\n  }\r\n}\r\n\r\n/** A legend theme as the author may state it — every branch optional. */\r\nexport type LegendTheme = Partial<Omit<LegendConfig, \"markerStyle\">> & {\r\n  markerStyle?: Partial<LegendMarkerConfig>\r\n}\r\n\r\nexport function resolveLegendConfig(\r\n  legend: LegendTheme | undefined,\r\n  previous: LegendConfig\r\n): LegendConfig {\r\n  return {\r\n    padding: insetsOps.resolve(\r\n      legend?.padding ?? previous.padding,\r\n      previous.padding as InsetsResolved\r\n    ),\r\n    textStyle: textOps.resolveStyle(legend?.textStyle, previous.textStyle),\r\n    itemGap: legend?.itemGap ?? previous.itemGap,\r\n    markerStyle: resolveLegendMarkerConfig(\r\n      legend?.markerStyle,\r\n      previous.markerStyle\r\n    ),\r\n  }\r\n}\r\n\r\nexport function lerpLegendConfig(\r\n  from: LegendConfig,\r\n  to: LegendConfig,\r\n  t: number\r\n): LegendConfig {\r\n  return {\r\n    padding: insetsOps.lerp(\r\n      from.padding as InsetsResolved,\r\n      to.padding as InsetsResolved,\r\n      t\r\n    ),\r\n    textStyle: textOps.lerpStyle(from.textStyle, to.textStyle, t),\r\n    itemGap: lerpNumber(from.itemGap, to.itemGap, t),\r\n    markerStyle: lerpLegendMarkerConfig(from.markerStyle, to.markerStyle, t),\r\n  }\r\n}\r\n\r\n/** A whole-palette override replaces the previous palette outright. */\r\nexport function resolveSeriesStrokes(\r\n  styles: Stroke[] | undefined,\r\n  previous: Stroke[]\r\n): Stroke[] {\r\n  return (styles ?? previous).map((s) => strokeOps.resolve(s))\r\n}\r\n\r\n/** Pairwise by index; a palette that grows/shrinks holds the longer side's tail. */\r\nexport function lerpSeriesStrokes(\r\n  from: Stroke[],\r\n  to: Stroke[],\r\n  t: number\r\n): Stroke[] {\r\n  const n = Math.max(from.length, to.length)\r\n  const out: Stroke[] = []\r\n  for (let i = 0; i < n; i++) {\r\n    const a = (from[i] ?? to[i]) as StrokeResolved[]\r\n    const b = (to[i] ?? from[i]) as StrokeResolved[]\r\n    out.push(strokeOps.lerp(a, b, t))\r\n  }\r\n  return out\r\n}\r\n\r\n/** The fill-palette twin of {@link resolveSeriesStrokes}, for filled marks. */\r\nexport function resolveSeriesFills(\r\n  fills: Fill[] | undefined,\r\n  previous: Fill[]\r\n): Fill[] {\r\n  return (fills ?? previous).map((f) => fillOps.resolve(f))\r\n}\r\n\r\n/** The fill-palette twin of {@link lerpSeriesStrokes}. */\r\nexport function lerpSeriesFills(from: Fill[], to: Fill[], t: number): Fill[] {\r\n  const n = Math.max(from.length, to.length)\r\n  const out: Fill[] = []\r\n  for (let i = 0; i < n; i++) {\r\n    const a = (from[i] ?? to[i]) as FillResolved[]\r\n    const b = (to[i] ?? from[i]) as FillResolved[]\r\n    out.push(fillOps.lerp(a, b, t))\r\n  }\r\n  return out\r\n}\r\n\r\n// ---- Per-series paint ----------------------------------------------------\r\n\r\n/**\r\n * The effective stroke for series `index`: the palette's entry at\r\n * `index % palette.length`, with the series' own `fill`, if set, overriding just\r\n * the last (topmost) layer's colour.\r\n */\r\nexport function resolveSeriesStroke(\r\n  palette: Stroke[],\r\n  series: ChartSeries,\r\n  index: number\r\n): Stroke {\r\n  const entry: Stroke =\r\n    palette.length > 0\r\n      ? palette[index % palette.length]\r\n      : { weight: 4, fill: \"white\" }\r\n  if (series.fill == null) return entry\r\n  const layers = strokeOps.resolve(entry)\r\n  if (layers.length === 0) return { weight: 4, fill: series.fill }\r\n  const next = [...layers]\r\n  next[next.length - 1] = {\r\n    ...next[next.length - 1],\r\n    fill: fillOps.resolve(series.fill),\r\n  }\r\n  return next\r\n}\r\n\r\n/**\r\n * The effective *colour* for series `index` — the same colour\r\n * {@link resolveSeriesStroke} draws its line in — for contexts (a legend\r\n * swatch) that only need the fill.\r\n */\r\nexport function resolveSeriesFill(\r\n  palette: Stroke[],\r\n  series: ChartSeries,\r\n  index: number\r\n): Fill {\r\n  const layers = strokeOps.resolve(resolveSeriesStroke(palette, series, index))\r\n  return layers[layers.length - 1]?.fill ?? \"white\"\r\n}\r\n\r\n/**\r\n * The effective paint for mark `index` of a **filled** chart (a bar, a wedge):\r\n * the series' own `fill` when it carries one, else the palette's entry for its\r\n * index, cycled.\r\n *\r\n * The stroke twin above has to reach inside a stroke to swap one layer's colour;\r\n * a filled mark has no such geometry wrapped around its paint, so an override is\r\n * simply the whole answer.\r\n */\r\nexport function resolvePalettePaint(\r\n  palette: Fill[],\r\n  override: Fill | undefined,\r\n  index: number\r\n): Fill {\r\n  if (override != null) return override\r\n  if (palette.length === 0) return \"white\"\r\n  return palette[index % palette.length]\r\n}\r\n\r\n// ---- Scales and formatting -----------------------------------------------\r\n\r\n\r\n/**\r\n * Format a marker value: integers plain, otherwise trimmed to one decimal, or to\r\n * as many as the axis's tick `step` needs to tell neighbouring ticks apart.\r\n *\r\n * One decimal is the floor, so a step of 0.1 or more reads exactly as it always\r\n * has; a finer step (a unit axis ticked every 0.05) gets two, instead of five\r\n * ticks captioned `0.1 0.1 0.2 0.2 0.3`. Trailing zeros are dropped either way.\r\n */\r\nexport function formatMarker(value: number, step?: number): string {\r\n  if (Number.isInteger(value)) return String(value)\r\n  const decimals = Math.max(1, step === undefined ? 1 : decimalsFor(step))\r\n  return value.toFixed(decimals).replace(/(\\.\\d*?)0+$/, \"$1\").replace(/\\.$/, \"\")\r\n}\r\n\r\n/** Decimal places needed to write `step` exactly, capped at six. */\r\nfunction decimalsFor(step: number): number {\r\n  if (!(step > 0) || !Number.isFinite(step)) return 1\r\n  for (let d = 0; d <= 6; d++) {\r\n    const scaled = step * 10 ** d\r\n    if (Math.abs(scaled - Math.round(scaled)) < 1e-6 * Math.max(1, scaled)) return d\r\n  }\r\n  // An irrational-looking step (a third): as many places as separate the ticks.\r\n  return Math.min(6, Math.max(1, Math.ceil(-Math.log10(step)) + 1))\r\n}\r\n\r\n/** The gap between neighbouring tick values, or `undefined` for fewer than two distinct ones. */\r\nexport function markerStep(markers: readonly number[]): number | undefined {\r\n  const sorted = [...markers].filter(Number.isFinite).sort((a, b) => a - b)\r\n  let step: number | undefined\r\n  for (let i = 1; i < sorted.length; i++) {\r\n    const gap = sorted[i] - sorted[i - 1]\r\n    if (gap > 1e-12 && (step === undefined || gap < step)) step = gap\r\n  }\r\n  return step\r\n}\r\n\r\n/** Format a fraction in `[0, 1]` as a percentage: integers plain, else one decimal. */\r\nexport function formatPercent(fraction: number): string {\r\n  const pct = fraction * 100\r\n  if (Number.isInteger(pct)) return `${pct}%`\r\n  return `${pct.toFixed(1).replace(/\\.0$/, \"\")}%`\r\n}\r\n\r\n/** `markerCount` evenly-spaced tick values across `[min, max]`, ends inclusive. */\r\nexport function markerValues([min, max]: Range, markerCount: number): number[] {\r\n  const n = Math.max(2, Math.round(markerCount))\r\n  return Array.from({ length: n + 1 }, (_, i) => min + ((max - min) / n) * i)\r\n}\r\n\r\n// Lifted into the engine, because a graph and a diagram want them too — see\r\n// `@motionscript/sdk/component`. Re-exported so a chart, and anything that\r\n// copied one, still reaches them where it always did.\r\nexport { niceStep, enterBudget } from \"@motionscript/sdk/component\"\r\n"]}

package/dist/kit/vertical-axis.d.ts

@@ -1,6 +1,6 @@
-import { Node2D, type CommandArgs, type NodeConfig, type Node2DProps } from "@motionscript/core";
+import { Node2D, type CommandArgs, type NodeConfig, type Node2DProps } from "@motionscript/sdk";
 import { type AxisConfig, type Range } from "./shared.js";
-import { type Seekable } from "@motionscript/core/component";
+import { type Seekable } from "@motionscript/sdk/component";
 export interface VerticalAxisProps extends Node2DProps {
     /** `[min, max]` of the vertical scale the markers are positioned within. */
     range: Range;

package/dist/kit/vertical-axis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vertical-axis.d.ts","sourceRoot":"","sources":["../../src/kit/vertical-axis.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EAQN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,UAAU,CAAA;AACjB,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAEzE,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,4EAA4E;IAC5E,KAAK,EAAE,KAAK,CAAA;IACZ;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,oFAAoF;IACpF,IAAI,EAAE,UAAU,CAAA;IAChB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;CACd;AAKD,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACH,KAAK,EAAE,KAAK,CAAA;IACb,OAAO,EAAE,MAAM,EAAE,CAAA;IACvB,IAAI,EAAE,UAAU,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;IAEhD;;;;;;;OAOG;IACH,QAAQ,EAAE,WAAW,CAAe;IAEpC,+EAA+E;IAC/E,OAAO,CAAC,WAAW,CAAa;IAChC,kFAAkF;IAClF,OAAO,CAAC,SAAS,CAAoB;IAErC,gFAAgF;IAChF,OAAO,KAAK,aAAa,GAExB;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAIf,yEAAyE;IACzE,OAAO,CAAC,MAAM;gBAOF,KAAK,CAAC,EAAE,UAAU,CAAC,YAAY,EAAE,iBAAiB,CAAC;IA0D/D;;;;OAIG;IACH,GAAG,CAAC,KAAK,SAAQ,GAAG,IAAI;IAKxB;;;;;;;;;;;;;;OAcG;IAEH,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;CA6BhG"}
+{"version":3,"file":"vertical-axis.d.ts","sourceRoot":"","sources":["../../src/kit/vertical-axis.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EAQN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,UAAU,CAAA;AACjB,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAExE,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,4EAA4E;IAC5E,KAAK,EAAE,KAAK,CAAA;IACZ;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,oFAAoF;IACpF,IAAI,EAAE,UAAU,CAAA;IAChB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;CACd;AAKD,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACH,KAAK,EAAE,KAAK,CAAA;IACb,OAAO,EAAE,MAAM,EAAE,CAAA;IACvB,IAAI,EAAE,UAAU,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;IAEhD;;;;;;;OAOG;IACH,QAAQ,EAAE,WAAW,CAAe;IAEpC,+EAA+E;IAC/E,OAAO,CAAC,WAAW,CAAa;IAChC,kFAAkF;IAClF,OAAO,CAAC,SAAS,CAAoB;IAErC,gFAAgF;IAChF,OAAO,KAAK,aAAa,GAExB;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAIf,yEAAyE;IACzE,OAAO,CAAC,MAAM;gBAOF,KAAK,CAAC,EAAE,UAAU,CAAC,YAAY,EAAE,iBAAiB,CAAC;IA0D/D;;;;OAIG;IACH,GAAG,CAAC,KAAK,SAAQ,GAAG,IAAI;IAKxB;;;;;;;;;;;;;;OAcG;IAEH,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;CA6BhG"}

package/dist/kit/vertical-axis.js

@@ -4,9 +4,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { command, Node2D, Rect, RotatedBox, Text, easeOut, property, insetsOps, textOps, } from "@motionscript/core";
+import { command, Node2D, Rect, RotatedBox, Text, easeOut, property, insetsOps, textOps, } from "@motionscript/sdk";
 import { DEFAULT_Y_AXIS, enterBudget, formatMarker, } from "./shared.js";
-import { at, compose } from "@motionscript/core/component";
+import { at, compose } from "@motionscript/sdk/component";
 /** How far a marker starts to the right of its slot when it enters, in px. */
 const SLIDE = 24;
 /**

package/dist/kit/vertical-axis.js.map

@@ -1 +1 @@
-{"version":3,"file":"vertical-axis.js","sourceRoot":"","sources":["../../src/kit/vertical-axis.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  command,\n  Node2D,\n  Rect,\n  RotatedBox,\n  Text,\n  easeOut,\n  property,\n  insetsOps,\n  textOps,\n  type CommandArgs,\n  type NodeConfig,\n  type Node2DProps,\n} from \"@motionscript/core\"\n\nimport {\n  DEFAULT_Y_AXIS,\n  enterBudget,\n  formatMarker,\n  type AxisConfig,\n  type Range,\n} from \"./shared\"\nimport { at, compose, type Seekable } from \"@motionscript/core/component\"\n\nexport interface VerticalAxisProps extends Node2DProps {\n  /** `[min, max]` of the vertical scale the markers are positioned within. */\n  range: Range\n  /**\n   * Tick values (in data units) to draw up the axis, each placed by its fraction\n   * across {@link VerticalAxisProps.range}. Need not be evenly spaced or include\n   * the ends.\n   */\n  markers: number[]\n  /** Marker/caption text style, grid stroke, and gutters — see {@link AxisConfig}. */\n  axis: AxisConfig\n  /**\n   * Rotated caption drawn in the gutter to the left of the marker column. Empty\n   * string (the default) hides it — no caption node is built and no label gutter\n   * is reserved.\n   */\n  label: string\n}\n\n/** How far a marker starts to the right of its slot when it enters, in px. */\nconst SLIDE = 24\n\n/** How a tick value is captioned — see {@link VerticalAxis.labelFor}. */\nexport type MarkerLabel = (value: number) => string\n\n/**\n * The numeric vertical axis shared by the cartesian charts: a **column of\n * {@link Text} nodes**, one per marker value, running top-to-bottom (highest\n * value at the top). Pure layout — no `Graphics` — so the markers are real text\n * nodes the scene can measure, restyle, or animate individually.\n *\n * Each marker is positioned so its centre lands exactly on its value's fraction\n * across `range` within the axis's filled height, so unevenly-spaced markers\n * land where their values fall. Both the caption and the position are *bound*,\n * not snapshotted: a chart that rescales its axes (see `LineChart.zoomTo`)\n * tweens `range`/`markers` live. Only the marker **count** is fixed at\n * construction.\n *\n * {@link enter} staggers them in **bottom-to-top**: each marker starts pushed a\n * little to the right and transparent, then fades and slides left into place.\n * The resting state is the landed one, so a chart that is never told to enter\n * still reads as a finished chart.\n */\nexport class VerticalAxis extends Node2D<VerticalAxisProps> {\n  @property({ default: () => [0, 1] as Range }) declare range: Range\n  @property({ default: () => [] as number[] }) declare markers: number[]\n  @property({ default: DEFAULT_Y_AXIS }) declare axis: AxisConfig\n  @property({ default: \"\" }) declare label: string\n\n  /**\n   * How a tick value is captioned. Defaults to the bare numeric reading; a\n   * chart with a number format on this axis replaces it (see `number-format`).\n   *\n   * A plain field rather than a `@property`, for the reason the horizontal\n   * axis's twin spells out: it is a policy, not a value, and there is nothing\n   * to tween between two formatters.\n   */\n  labelFor: MarkerLabel = formatMarker\n\n  /** One text node per marker, ordered top → bottom, for the staggered enter. */\n  private markerNodes: Text[] = []\n  /** The caption node, or null when `label` is empty. Entered after the markers. */\n  private labelNode: Text | null = null\n\n  /** The live tick values, top → bottom (highest first) — re-read every frame. */\n  private get sortedMarkers(): number[] {\n    return [...this.markers].sort((a, b) => b - a)\n  }\n\n  /**\n   * Tick `i`'s value, or `undefined` once the live `markers` list is shorter\n   * than the column of text nodes built for it — a slot with no value renders as\n   * empty text rather than repeating its neighbour.\n   */\n  private valueAt(index: number): number | undefined {\n    return this.sortedMarkers[index]\n  }\n\n  /** Tick `i`'s fraction across the live `range`, 0 at the bottom edge. */\n  private fracAt(index: number): number {\n    const v = this.valueAt(index)\n    if (v === undefined) return 0\n    const [min, max] = this.range\n    return max <= min ? 0 : (v - min) / (max - min)\n  }\n\n  constructor(props?: NodeConfig<VerticalAxis, VerticalAxisProps>) {\n    super(props)\n\n    // Composed from plain props (range/markers/label) — no context needed, so\n    // it's built here. super() applied the props, so the reads below resolve.\n    const tickPad = insetsOps.resolve(this.axis.tickPadding).right\n    const titlePad = insetsOps.resolve(this.axis.titlePadding).right\n\n    this.markerNodes = this.markers.map((_, i) => {\n      const marker: Text = new Text({\n        ...textOps.styleProps(this.axis.labelStyle),\n        text: () => {\n          const v = this.valueAt(i)\n          return v === undefined ? \"\" : this.labelFor(v)\n        },\n        y: () => {\n          // Node2D space is y-up, so the fraction runs from the bottom.\n          const height = this.layoutBounds.height\n          const centred = (this.fracAt(i) - 0.5) * height\n          // Held inside the axis's top edge — the backstop for a chart whose\n          // headroom is smaller than its marker text is tall, which a theme with\n          // much larger markers can arrange. Only the top, because what lies\n          // below the axis is the chart's own horizontal axis and legend.\n          const limit = height / 2 - marker.layoutBounds.height / 2\n          return Math.min(centred, limit)\n        },\n      })\n      return marker\n    })\n\n    const children: Node2D[] = []\n    if (this.label !== \"\") {\n      this.labelNode = new Text({\n        ...textOps.styleProps(this.axis.titleStyle),\n        text: this.label,\n      })\n      // Node2D space is y-up and rotation is clockwise, so -90° reads bottom-to-top.\n      children.push(\n        new RotatedBox({\n          angle: -90,\n          width: \"hug\",\n          height: \"hug\",\n          children: this.labelNode,\n        })\n      )\n    }\n    children.push(\n      new Rect({\n        height: \"fill\",\n        width: \"hug\",\n        padding: { right: tickPad },\n        children: this.markerNodes,\n      })\n    )\n\n    this.add(new Rect({ flow: \"horizontal\", gap: titlePad, children }))\n  }\n\n  /**\n   * Primes every marker (and the caption) at its pre-entrance state: shifted\n   * right and transparent. Idempotent, and separate from {@link enter} so the\n   * chart can arm its whole composition before the first frame is drawn.\n   */\n  arm(slide = SLIDE): void {\n    for (const marker of this.markerNodes) marker.set({ opacity: 0, x: slide })\n    this.labelNode?.set({ opacity: 0, x: slide })\n  }\n\n  /**\n   * Stagger the markers in bottom to top, then slide the caption in from the\n   * right after them.\n   *\n   * A {@link Seekable} rather than a generator — see the note on the horizontal\n   * axis's `enter`. The offsets were always static; expressing them as `wait`\n   * inside a generator is what made them reachable only by running it.\n   *\n   * `args.duration` is the **whole** entrance, not one marker's slide: the\n   * stagger and the caption are carved out of it rather than added on top. See\n   * {@link enterBudget} for why that distinction matters here.\n   *\n   * `args.data.stagger` is seconds between successive markers (derived when\n   * omitted); `args.data.slide` is the starting rightward offset in px.\n   */\n  @command()\n  enter(args: CommandArgs<{ stagger?: number; slide?: number }> & { duration: number }): Seekable {\n    const { stagger, slide = SLIDE } = args.data ?? {}\n    const easing = args.easing ?? easeOut()\n    const nodes = this.markerNodes\n    if (nodes.length === 0) return compose([])\n    const { step, per, caption } = enterBudget(\n      args.duration,\n      nodes.length,\n      this.labelNode !== null,\n      stagger\n    )\n\n    this.arm(slide)\n\n    // Bottom marker leads: markerNodes is top → bottom, so walk it in reverse.\n    const markers = nodes.map((node, i) => {\n      const order = nodes.length - 1 - i // bottom-most = 0\n      return at(order * step, node.to({ data: { opacity: 1, x: 0 }, duration: per, easing }))\n    })\n    const lastMarkerEnds = (nodes.length - 1) * step + per\n\n    // Once every marker has landed, the caption slides in from the right.\n    return compose([\n      ...markers,\n      ...(this.labelNode\n        ? [at(lastMarkerEnds, this.labelNode.to({ data: { opacity: 1, x: 0 }, duration: caption, easing }))]\n        : []),\n    ])\n  }\n}\n"]}
+{"version":3,"file":"vertical-axis.js","sourceRoot":"","sources":["../../src/kit/vertical-axis.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  command,\r\n  Node2D,\r\n  Rect,\r\n  RotatedBox,\r\n  Text,\r\n  easeOut,\r\n  property,\r\n  insetsOps,\r\n  textOps,\r\n  type CommandArgs,\r\n  type NodeConfig,\r\n  type Node2DProps,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport {\r\n  DEFAULT_Y_AXIS,\r\n  enterBudget,\r\n  formatMarker,\r\n  type AxisConfig,\r\n  type Range,\r\n} from \"./shared\"\r\nimport { at, compose, type Seekable } from \"@motionscript/sdk/component\"\r\n\r\nexport interface VerticalAxisProps extends Node2DProps {\r\n  /** `[min, max]` of the vertical scale the markers are positioned within. */\r\n  range: Range\r\n  /**\r\n   * Tick values (in data units) to draw up the axis, each placed by its fraction\r\n   * across {@link VerticalAxisProps.range}. Need not be evenly spaced or include\r\n   * the ends.\r\n   */\r\n  markers: number[]\r\n  /** Marker/caption text style, grid stroke, and gutters — see {@link AxisConfig}. */\r\n  axis: AxisConfig\r\n  /**\r\n   * Rotated caption drawn in the gutter to the left of the marker column. Empty\r\n   * string (the default) hides it — no caption node is built and no label gutter\r\n   * is reserved.\r\n   */\r\n  label: string\r\n}\r\n\r\n/** How far a marker starts to the right of its slot when it enters, in px. */\r\nconst SLIDE = 24\r\n\r\n/** How a tick value is captioned — see {@link VerticalAxis.labelFor}. */\r\nexport type MarkerLabel = (value: number) => string\r\n\r\n/**\r\n * The numeric vertical axis shared by the cartesian charts: a **column of\r\n * {@link Text} nodes**, one per marker value, running top-to-bottom (highest\r\n * value at the top). Pure layout — no `Graphics` — so the markers are real text\r\n * nodes the scene can measure, restyle, or animate individually.\r\n *\r\n * Each marker is positioned so its centre lands exactly on its value's fraction\r\n * across `range` within the axis's filled height, so unevenly-spaced markers\r\n * land where their values fall. Both the caption and the position are *bound*,\r\n * not snapshotted: a chart that rescales its axes (see `LineChart.zoomTo`)\r\n * tweens `range`/`markers` live. Only the marker **count** is fixed at\r\n * construction.\r\n *\r\n * {@link enter} staggers them in **bottom-to-top**: each marker starts pushed a\r\n * little to the right and transparent, then fades and slides left into place.\r\n * The resting state is the landed one, so a chart that is never told to enter\r\n * still reads as a finished chart.\r\n */\r\nexport class VerticalAxis extends Node2D<VerticalAxisProps> {\r\n  @property({ default: () => [0, 1] as Range }) declare range: Range\r\n  @property({ default: () => [] as number[] }) declare markers: number[]\r\n  @property({ default: DEFAULT_Y_AXIS }) declare axis: AxisConfig\r\n  @property({ default: \"\" }) declare label: string\r\n\r\n  /**\r\n   * How a tick value is captioned. Defaults to the bare numeric reading; a\r\n   * chart with a number format on this axis replaces it (see `number-format`).\r\n   *\r\n   * A plain field rather than a `@property`, for the reason the horizontal\r\n   * axis's twin spells out: it is a policy, not a value, and there is nothing\r\n   * to tween between two formatters.\r\n   */\r\n  labelFor: MarkerLabel = formatMarker\r\n\r\n  /** One text node per marker, ordered top → bottom, for the staggered enter. */\r\n  private markerNodes: Text[] = []\r\n  /** The caption node, or null when `label` is empty. Entered after the markers. */\r\n  private labelNode: Text | null = null\r\n\r\n  /** The live tick values, top → bottom (highest first) — re-read every frame. */\r\n  private get sortedMarkers(): number[] {\r\n    return [...this.markers].sort((a, b) => b - a)\r\n  }\r\n\r\n  /**\r\n   * Tick `i`'s value, or `undefined` once the live `markers` list is shorter\r\n   * than the column of text nodes built for it — a slot with no value renders as\r\n   * empty text rather than repeating its neighbour.\r\n   */\r\n  private valueAt(index: number): number | undefined {\r\n    return this.sortedMarkers[index]\r\n  }\r\n\r\n  /** Tick `i`'s fraction across the live `range`, 0 at the bottom edge. */\r\n  private fracAt(index: number): number {\r\n    const v = this.valueAt(index)\r\n    if (v === undefined) return 0\r\n    const [min, max] = this.range\r\n    return max <= min ? 0 : (v - min) / (max - min)\r\n  }\r\n\r\n  constructor(props?: NodeConfig<VerticalAxis, VerticalAxisProps>) {\r\n    super(props)\r\n\r\n    // Composed from plain props (range/markers/label) — no context needed, so\r\n    // it's built here. super() applied the props, so the reads below resolve.\r\n    const tickPad = insetsOps.resolve(this.axis.tickPadding).right\r\n    const titlePad = insetsOps.resolve(this.axis.titlePadding).right\r\n\r\n    this.markerNodes = this.markers.map((_, i) => {\r\n      const marker: Text = new Text({\r\n        ...textOps.styleProps(this.axis.labelStyle),\r\n        text: () => {\r\n          const v = this.valueAt(i)\r\n          return v === undefined ? \"\" : this.labelFor(v)\r\n        },\r\n        y: () => {\r\n          // Node2D space is y-up, so the fraction runs from the bottom.\r\n          const height = this.layoutBounds.height\r\n          const centred = (this.fracAt(i) - 0.5) * height\r\n          // Held inside the axis's top edge — the backstop for a chart whose\r\n          // headroom is smaller than its marker text is tall, which a theme with\r\n          // much larger markers can arrange. Only the top, because what lies\r\n          // below the axis is the chart's own horizontal axis and legend.\r\n          const limit = height / 2 - marker.layoutBounds.height / 2\r\n          return Math.min(centred, limit)\r\n        },\r\n      })\r\n      return marker\r\n    })\r\n\r\n    const children: Node2D[] = []\r\n    if (this.label !== \"\") {\r\n      this.labelNode = new Text({\r\n        ...textOps.styleProps(this.axis.titleStyle),\r\n        text: this.label,\r\n      })\r\n      // Node2D space is y-up and rotation is clockwise, so -90° reads bottom-to-top.\r\n      children.push(\r\n        new RotatedBox({\r\n          angle: -90,\r\n          width: \"hug\",\r\n          height: \"hug\",\r\n          children: this.labelNode,\r\n        })\r\n      )\r\n    }\r\n    children.push(\r\n      new Rect({\r\n        height: \"fill\",\r\n        width: \"hug\",\r\n        padding: { right: tickPad },\r\n        children: this.markerNodes,\r\n      })\r\n    )\r\n\r\n    this.add(new Rect({ flow: \"horizontal\", gap: titlePad, children }))\r\n  }\r\n\r\n  /**\r\n   * Primes every marker (and the caption) at its pre-entrance state: shifted\r\n   * right and transparent. Idempotent, and separate from {@link enter} so the\r\n   * chart can arm its whole composition before the first frame is drawn.\r\n   */\r\n  arm(slide = SLIDE): void {\r\n    for (const marker of this.markerNodes) marker.set({ opacity: 0, x: slide })\r\n    this.labelNode?.set({ opacity: 0, x: slide })\r\n  }\r\n\r\n  /**\r\n   * Stagger the markers in bottom to top, then slide the caption in from the\r\n   * right after them.\r\n   *\r\n   * A {@link Seekable} rather than a generator — see the note on the horizontal\r\n   * axis's `enter`. The offsets were always static; expressing them as `wait`\r\n   * inside a generator is what made them reachable only by running it.\r\n   *\r\n   * `args.duration` is the **whole** entrance, not one marker's slide: the\r\n   * stagger and the caption are carved out of it rather than added on top. See\r\n   * {@link enterBudget} for why that distinction matters here.\r\n   *\r\n   * `args.data.stagger` is seconds between successive markers (derived when\r\n   * omitted); `args.data.slide` is the starting rightward offset in px.\r\n   */\r\n  @command()\r\n  enter(args: CommandArgs<{ stagger?: number; slide?: number }> & { duration: number }): Seekable {\r\n    const { stagger, slide = SLIDE } = args.data ?? {}\r\n    const easing = args.easing ?? easeOut()\r\n    const nodes = this.markerNodes\r\n    if (nodes.length === 0) return compose([])\r\n    const { step, per, caption } = enterBudget(\r\n      args.duration,\r\n      nodes.length,\r\n      this.labelNode !== null,\r\n      stagger\r\n    )\r\n\r\n    this.arm(slide)\r\n\r\n    // Bottom marker leads: markerNodes is top → bottom, so walk it in reverse.\r\n    const markers = nodes.map((node, i) => {\r\n      const order = nodes.length - 1 - i // bottom-most = 0\r\n      return at(order * step, node.to({ data: { opacity: 1, x: 0 }, duration: per, easing }))\r\n    })\r\n    const lastMarkerEnds = (nodes.length - 1) * step + per\r\n\r\n    // Once every marker has landed, the caption slides in from the right.\r\n    return compose([\r\n      ...markers,\r\n      ...(this.labelNode\r\n        ? [at(lastMarkerEnds, this.labelNode.to({ data: { opacity: 1, x: 0 }, duration: caption, easing }))]\r\n        : []),\r\n    ])\r\n  }\r\n}\r\n"]}

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

@@ -1,4 +1,4 @@
-import { type AssetScope, Node2D, type Command, type CommandArgs, type EasingFunction, type Node2DProps, type RenderContext2D, type Stroke, type Vector2 } from "@motionscript/core";
+import { type AssetScope, Node2D, type Command, type CommandArgs, type EasingFunction, type Node2DProps, type RenderContext2D, type Stroke, type Vector2 } from "@motionscript/sdk";
 import { type RegionBox } from "./shared.js";
 export interface ChartLineProps extends Node2DProps {
     /**
@@ -12,8 +12,8 @@ export interface ChartLineProps extends Node2DProps {
      * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left
      * end to its right.
      *
-     * Defaults to **1**, unlike the standalone chart this was ported from: in the
-     * studio a node's resting state is what the paused editor canvas paints, so a
+     * Defaults to **1**, unlike the standalone chart this was ported from: in an
+     * editor a node's resting state is what the paused editor canvas paints, so a
      * chart that only appeared once a command had run would edit blind. {@link
      * enter} drives it from 0 regardless of where it rests, so the animation is
      * unchanged.

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

@@ -1 +1 @@
-{"version":3,"file":"chart-line.d.ts","sourceRoot":"","sources":["../../src/line-chart/chart-line.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAEf,MAAM,EAKN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,MAAM,EAEX,KAAK,OAAO,EACb,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,UAAU,CAAA;AAGjB,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD;;;OAGG;IACH,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,SAAS,EAAE,SAAS,CAAA;IACpB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,MAAM,CAAC,cAAc,CAAC;IACG,MAAM,EAAE,OAAO,EAAE,CAAA;IAE/D,MAAM,EAAE,MAAM,CAAA;IACY,QAAQ,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IACE,SAAS,EAAE,SAAS,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;IAEhE;;;OAGG;IACM,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKhD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAuChD;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IA+BnB;;;;;;;;;OASG;IAEH,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAI/F;;;;;;;;;;;OAWG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,cAA0B,EAClC,EAAE,SAAI,GACL,OAAO,CAAC,cAAc,CAAC;CAY3B"}
+{"version":3,"file":"chart-line.d.ts","sourceRoot":"","sources":["../../src/line-chart/chart-line.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAEf,MAAM,EAKN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,MAAM,EAEX,KAAK,OAAO,EACb,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,UAAU,CAAA;AAGjB,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD;;;OAGG;IACH,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,SAAS,EAAE,SAAS,CAAA;IACpB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,MAAM,CAAC,cAAc,CAAC;IACG,MAAM,EAAE,OAAO,EAAE,CAAA;IAE/D,MAAM,EAAE,MAAM,CAAA;IACY,QAAQ,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IACE,SAAS,EAAE,SAAS,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;IAEhE;;;OAGG;IACM,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKhD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAuChD;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IA+BnB;;;;;;;;;OASG;IAEH,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAI/F;;;;;;;;;;;OAWG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,cAA0B,EAClC,EAAE,SAAI,GACL,OAAO,CAAC,cAAc,CAAC;CAY3B"}

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

@@ -4,10 +4,10 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { Graphics2D, Node2D, command, easeOut, strokeOps, property, } from "@motionscript/core";
+import { Graphics2D, Node2D, command, easeOut, strokeOps, property, } from "@motionscript/sdk";
 import { SPOTLIGHT_DIM } from "../kit/shared.js";
 import { EMPTY_REGION_BOX, clipPolylineToBox, hasRegion, } from "./shared.js";
-import { declarePaints } from "@motionscript/core/component";
+import { declarePaints } from "@motionscript/sdk/component";
 /**
  * A single series line of a {@link LineChart}: one rounded polyline traced
  * through pre-mapped pixel `points`, drawn as one {@link Graphics2D} command list.

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

@@ -1 +1 @@
-{"version":3,"file":"chart-line.js","sourceRoot":"","sources":["../../src/line-chart/chart-line.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type AssetScope,\n  Graphics2D,\n  Node2D,\n  command,\n  easeOut,\n  strokeOps,\n  property,\n  type Command,\n  type CommandArgs,\n  type EasingFunction,\n  type Node2DProps,\n  type RenderContext2D,\n  type Stroke,\n  type StrokeResolved,\n  type Vector2,\n} from \"@motionscript/core\"\n\nimport { SPOTLIGHT_DIM } from \"../kit/shared\"\nimport {\n  EMPTY_REGION_BOX,\n  clipPolylineToBox,\n  hasRegion,\n  type RegionBox,\n} from \"./shared\"\nimport { declarePaints } from \"@motionscript/core/component\"\n\nexport interface ChartLineProps extends Node2DProps {\n  /**\n   * The series polyline, already mapped into this node's local pixel space\n   * (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x.\n   */\n  points: Vector2[]\n  /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */\n  stroke: Stroke\n  /**\n   * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left\n   * end to its right.\n   *\n   * Defaults to **1**, unlike the standalone chart this was ported from: in the\n   * studio a node's resting state is what the paused editor canvas paints, so a\n   * chart that only appeared once a command had run would edit blind. {@link\n   * enter} drives it from 0 regardless of where it rests, so the animation is\n   * unchanged.\n   */\n  progress: number\n  /**\n   * Whether this line is drawn at all. `false` hides it outright — the switch\n   * the chart flips alongside its legend's per-series toggle.\n   */\n  enabled: boolean\n  /**\n   * A slice of the plot to spotlight, in this node's own pixel space. When set\n   * to a real box, the stretches of the line *outside* it drop to\n   * {@link ChartLineProps.dimOpacity} while the stretches inside stay full.\n   */\n  spotlight: RegionBox\n  /** Opacity the out-of-region stretches fade to. */\n  dimOpacity: number\n}\n\n/**\n * A single series line of a {@link LineChart}: one rounded polyline traced\n * through pre-mapped pixel `points`, drawn as one {@link Graphics2D} command list.\n * Sized and positioned by the parent, which shares the plot's coordinate frame.\n *\n * Two signals drive it: {@link ChartLineProps.progress} traces the line in\n * (animated by {@link enter}) and `enabled` shows or hides it wholesale.\n */\nexport class ChartLine extends Node2D<ChartLineProps> {\n  @property({ default: () => [] as Vector2[] }) declare points: Vector2[]\n  @property({ default: [], mapper: strokeOps.resolve, tween: strokeOps.lerp })\n  declare stroke: Stroke\n  @property({ default: 1 }) declare progress: number\n  @property({ default: true }) declare enabled: boolean\n  @property({ default: () => EMPTY_REGION_BOX }) declare spotlight: RegionBox\n  @property({ default: SPOTLIGHT_DIM }) declare dimOpacity: number\n\n  /**\n   * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the\n   * paint props it carries — see {@link declarePaints}.\n   */\n  override declareAssets(assets: AssetScope): void {\n    super.declareAssets(assets)\n    declarePaints(this, assets)\n  }\n\n  protected renderSelf(ctx: RenderContext2D): void {\n    if (!this.enabled) return\n    const pts = this.points\n    if (pts.length < 2) return\n\n    const p = Math.max(0, Math.min(1, this.progress))\n    if (p <= 0) return\n\n    const drawn = this.tracePoints(pts, p)\n    if (drawn.length < 2) return\n    const stroke = this.stroke as StrokeResolved[]\n    const radius = (stroke[0]?.weight ?? 0) * 2 // round the joins\n\n    const box = this.spotlight\n    if (!hasRegion(box)) {\n      ctx.draw(new Graphics2D().line({ points: drawn, radius }).stroke(stroke))\n      return\n    }\n\n    // Spotlit: the whole line goes down to `dimOpacity`, then the stretches\n    // inside the region are re-drawn over it at full strength. Two passes rather\n    // than one dim + one bright *complementary* pair, so the bright run has\n    // continuous geometry through the region and its joins round the way an\n    // unspotlit line's do — and so the boundary lands exactly on the region edge.\n    ctx.draw(\n      new Graphics2D()\n        .line({ points: drawn, radius })\n        .stroke(stroke)\n        .opacity(Math.max(0, Math.min(1, this.dimOpacity)))\n    )\n\n    // One `draw` per run: shapes chained before a `stroke()` are combined into a\n    // single surface, and stroking a union of disjoint open paths doesn't paint\n    // — so a line that leaves the region and comes back would lose both halves.\n    for (const run of clipPolylineToBox(drawn, box)) {\n      ctx.draw(new Graphics2D().line({ points: run, radius }).stroke(stroke))\n    }\n  }\n\n  /**\n   * The prefix of `pts` revealed at fraction `p ∈ [0, 1]`, measuring the reveal\n   * by *cumulative arc length* so the line traces at a steady pace regardless of\n   * uneven point spacing. Returns the whole-point prefix plus one interpolated\n   * point partway along the active segment.\n   */\n  private tracePoints(pts: Vector2[], p: number): Vector2[] {\n    if (p >= 1 || pts.length < 2) return pts\n    if (p <= 0) return []\n\n    const segLen: number[] = []\n    let total = 0\n    for (let i = 1; i < pts.length; i++) {\n      const d = Math.hypot(pts[i].x - pts[i - 1].x, pts[i].y - pts[i - 1].y)\n      segLen.push(d)\n      total += d\n    }\n    if (total === 0) return pts\n\n    let target = total * p\n    const out: Vector2[] = [pts[0]]\n    for (let i = 0; i < segLen.length; i++) {\n      if (target >= segLen[i]) {\n        out.push(pts[i + 1])\n        target -= segLen[i]\n      } else {\n        const t = segLen[i] === 0 ? 0 : target / segLen[i]\n        out.push({\n          x: pts[i].x + (pts[i + 1].x - pts[i].x) * t,\n          y: pts[i].y + (pts[i + 1].y - pts[i].y) * t,\n        })\n        break\n      }\n    }\n    return out\n  }\n\n  /**\n   * Trace the line in from its left end to its right over `duration` seconds.\n   * Drives `progress` `0 → 1`.\n   *\n   * A `Command` rather than a generator, so the trace can be *evaluated* at a\n   * time instead of run to one — which is what lets a scene containing this\n   * chart be scrubbed in constant time. It no longer needs to prime `progress`\n   * to 0 first: the value at `t` is a function of `t`, so a repeat call re-traces\n   * by definition rather than by having reset something.\n   */\n  @command()\n  enter(args: CommandArgs<Record<string, never>> & { duration: number }): Command<ChartLineProps> {\n    return this.enterFrom(0, args.duration, args.easing ?? easeOut())\n  }\n\n  /**\n   * The trace, with both ends stated: `progress` runs `from` → `to`.\n   *\n   * What {@link LineChart.showSeries} and `hideSeries` are both made of — they\n   * are the same motion in opposite directions, and expressing them as one thing\n   * with endpoints is what stops the pair drifting apart.\n   *\n   * `enabled` rides along in the same value rather than being set before or after\n   * the command. A line is drawable for every `t` the trace covers and undrawn\n   * outside it, which is what makes arriving at a time backwards show what\n   * arriving forwards does — a flag flipped by a side effect would not.\n   */\n  enterFrom(\n    from: number,\n    duration: number,\n    easing: EasingFunction = easeOut(),\n    to = 1\n  ): Command<ChartLineProps> {\n    return this.command<ChartLineProps>(\n      (t) => {\n        const progress = from + (to - from) * t\n        // Hidden only once it has fully retraced, so the last frame of a hide is\n        // the empty plot rather than a line that vanished a frame early.\n        return { progress, enabled: progress > 0 }\n      },\n      duration,\n      easing\n    )\n  }\n}\n"]}
+{"version":3,"file":"chart-line.js","sourceRoot":"","sources":["../../src/line-chart/chart-line.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  type AssetScope,\r\n  Graphics2D,\r\n  Node2D,\r\n  command,\r\n  easeOut,\r\n  strokeOps,\r\n  property,\r\n  type Command,\r\n  type CommandArgs,\r\n  type EasingFunction,\r\n  type Node2DProps,\r\n  type RenderContext2D,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n  type Vector2,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { SPOTLIGHT_DIM } from \"../kit/shared\"\r\nimport {\r\n  EMPTY_REGION_BOX,\r\n  clipPolylineToBox,\r\n  hasRegion,\r\n  type RegionBox,\r\n} from \"./shared\"\r\nimport { declarePaints } from \"@motionscript/sdk/component\"\r\n\r\nexport interface ChartLineProps extends Node2DProps {\r\n  /**\r\n   * The series polyline, already mapped into this node's local pixel space\r\n   * (origin at centre, y-up) by the parent {@link LineChart}. Ordered along x.\r\n   */\r\n  points: Vector2[]\r\n  /** Line colour + weight (+ optional dash/cap/join) — the per-series stroke. */\r\n  stroke: Stroke\r\n  /**\r\n   * Reveal of the line in `[0, 1]`: 0 hides it, 1 traces it fully from its left\r\n   * end to its right.\r\n   *\r\n   * Defaults to **1**, unlike the standalone chart this was ported from: in an\r\n   * editor a node's resting state is what the paused editor canvas paints, so a\r\n   * chart that only appeared once a command had run would edit blind. {@link\r\n   * enter} drives it from 0 regardless of where it rests, so the animation is\r\n   * unchanged.\r\n   */\r\n  progress: number\r\n  /**\r\n   * Whether this line is drawn at all. `false` hides it outright — the switch\r\n   * the chart flips alongside its legend's per-series toggle.\r\n   */\r\n  enabled: boolean\r\n  /**\r\n   * A slice of the plot to spotlight, in this node's own pixel space. When set\r\n   * to a real box, the stretches of the line *outside* it drop to\r\n   * {@link ChartLineProps.dimOpacity} while the stretches inside stay full.\r\n   */\r\n  spotlight: RegionBox\r\n  /** Opacity the out-of-region stretches fade to. */\r\n  dimOpacity: number\r\n}\r\n\r\n/**\r\n * A single series line of a {@link LineChart}: one rounded polyline traced\r\n * through pre-mapped pixel `points`, drawn as one {@link Graphics2D} command list.\r\n * Sized and positioned by the parent, which shares the plot's coordinate frame.\r\n *\r\n * Two signals drive it: {@link ChartLineProps.progress} traces the line in\r\n * (animated by {@link enter}) and `enabled` shows or hides it wholesale.\r\n */\r\nexport class ChartLine extends Node2D<ChartLineProps> {\r\n  @property({ default: () => [] as Vector2[] }) declare points: Vector2[]\r\n  @property({ default: [], mapper: strokeOps.resolve, tween: strokeOps.lerp })\r\n  declare stroke: Stroke\r\n  @property({ default: 1 }) declare progress: number\r\n  @property({ default: true }) declare enabled: boolean\r\n  @property({ default: () => EMPTY_REGION_BOX }) declare spotlight: RegionBox\r\n  @property({ default: SPOTLIGHT_DIM }) declare dimOpacity: number\r\n\r\n  /**\r\n   * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the\r\n   * paint props it carries — see {@link declarePaints}.\r\n   */\r\n  override declareAssets(assets: AssetScope): void {\r\n    super.declareAssets(assets)\r\n    declarePaints(this, assets)\r\n  }\r\n\r\n  protected renderSelf(ctx: RenderContext2D): void {\r\n    if (!this.enabled) return\r\n    const pts = this.points\r\n    if (pts.length < 2) return\r\n\r\n    const p = Math.max(0, Math.min(1, this.progress))\r\n    if (p <= 0) return\r\n\r\n    const drawn = this.tracePoints(pts, p)\r\n    if (drawn.length < 2) return\r\n    const stroke = this.stroke as StrokeResolved[]\r\n    const radius = (stroke[0]?.weight ?? 0) * 2 // round the joins\r\n\r\n    const box = this.spotlight\r\n    if (!hasRegion(box)) {\r\n      ctx.draw(new Graphics2D().line({ points: drawn, radius }).stroke(stroke))\r\n      return\r\n    }\r\n\r\n    // Spotlit: the whole line goes down to `dimOpacity`, then the stretches\r\n    // inside the region are re-drawn over it at full strength. Two passes rather\r\n    // than one dim + one bright *complementary* pair, so the bright run has\r\n    // continuous geometry through the region and its joins round the way an\r\n    // unspotlit line's do — and so the boundary lands exactly on the region edge.\r\n    ctx.draw(\r\n      new Graphics2D()\r\n        .line({ points: drawn, radius })\r\n        .stroke(stroke)\r\n        .opacity(Math.max(0, Math.min(1, this.dimOpacity)))\r\n    )\r\n\r\n    // One `draw` per run: shapes chained before a `stroke()` are combined into a\r\n    // single surface, and stroking a union of disjoint open paths doesn't paint\r\n    // — so a line that leaves the region and comes back would lose both halves.\r\n    for (const run of clipPolylineToBox(drawn, box)) {\r\n      ctx.draw(new Graphics2D().line({ points: run, radius }).stroke(stroke))\r\n    }\r\n  }\r\n\r\n  /**\r\n   * The prefix of `pts` revealed at fraction `p ∈ [0, 1]`, measuring the reveal\r\n   * by *cumulative arc length* so the line traces at a steady pace regardless of\r\n   * uneven point spacing. Returns the whole-point prefix plus one interpolated\r\n   * point partway along the active segment.\r\n   */\r\n  private tracePoints(pts: Vector2[], p: number): Vector2[] {\r\n    if (p >= 1 || pts.length < 2) return pts\r\n    if (p <= 0) return []\r\n\r\n    const segLen: number[] = []\r\n    let total = 0\r\n    for (let i = 1; i < pts.length; i++) {\r\n      const d = Math.hypot(pts[i].x - pts[i - 1].x, pts[i].y - pts[i - 1].y)\r\n      segLen.push(d)\r\n      total += d\r\n    }\r\n    if (total === 0) return pts\r\n\r\n    let target = total * p\r\n    const out: Vector2[] = [pts[0]]\r\n    for (let i = 0; i < segLen.length; i++) {\r\n      if (target >= segLen[i]) {\r\n        out.push(pts[i + 1])\r\n        target -= segLen[i]\r\n      } else {\r\n        const t = segLen[i] === 0 ? 0 : target / segLen[i]\r\n        out.push({\r\n          x: pts[i].x + (pts[i + 1].x - pts[i].x) * t,\r\n          y: pts[i].y + (pts[i + 1].y - pts[i].y) * t,\r\n        })\r\n        break\r\n      }\r\n    }\r\n    return out\r\n  }\r\n\r\n  /**\r\n   * Trace the line in from its left end to its right over `duration` seconds.\r\n   * Drives `progress` `0 → 1`.\r\n   *\r\n   * A `Command` rather than a generator, so the trace can be *evaluated* at a\r\n   * time instead of run to one — which is what lets a scene containing this\r\n   * chart be scrubbed in constant time. It no longer needs to prime `progress`\r\n   * to 0 first: the value at `t` is a function of `t`, so a repeat call re-traces\r\n   * by definition rather than by having reset something.\r\n   */\r\n  @command()\r\n  enter(args: CommandArgs<Record<string, never>> & { duration: number }): Command<ChartLineProps> {\r\n    return this.enterFrom(0, args.duration, args.easing ?? easeOut())\r\n  }\r\n\r\n  /**\r\n   * The trace, with both ends stated: `progress` runs `from` → `to`.\r\n   *\r\n   * What {@link LineChart.showSeries} and `hideSeries` are both made of — they\r\n   * are the same motion in opposite directions, and expressing them as one thing\r\n   * with endpoints is what stops the pair drifting apart.\r\n   *\r\n   * `enabled` rides along in the same value rather than being set before or after\r\n   * the command. A line is drawable for every `t` the trace covers and undrawn\r\n   * outside it, which is what makes arriving at a time backwards show what\r\n   * arriving forwards does — a flag flipped by a side effect would not.\r\n   */\r\n  enterFrom(\r\n    from: number,\r\n    duration: number,\r\n    easing: EasingFunction = easeOut(),\r\n    to = 1\r\n  ): Command<ChartLineProps> {\r\n    return this.command<ChartLineProps>(\r\n      (t) => {\r\n        const progress = from + (to - from) * t\r\n        // Hidden only once it has fully retraced, so the last frame of a hide is\r\n        // the empty plot rather than a line that vanished a frame early.\r\n        return { progress, enabled: progress > 0 }\r\n      },\r\n      duration,\r\n      easing\r\n    )\r\n  }\r\n}\r\n"]}

package/dist/line-chart/chart-region.d.ts

@@ -1,4 +1,4 @@
-import { type AssetScope, Node2D, type Fill, type Node2DProps, type RenderContext2D, type Stroke } from "@motionscript/core";
+import { type AssetScope, Node2D, type Fill, type Node2DProps, type RenderContext2D, type Stroke } from "@motionscript/sdk";
 import { type RegionBox } from "./shared.js";
 export interface ChartRegionProps extends Node2DProps {
     /**

package/dist/line-chart/chart-region.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-region.d.ts","sourceRoot":"","sources":["../../src/line-chart/chart-region.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAEf,MAAM,EAIN,KAAK,IAAI,EAET,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,UAAU,CAAA;AAGjB,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;OAIG;IACH,GAAG,EAAE,SAAS,CAAA;IACd,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,IAAI,EAAE,IAAI,CAAA;IACV;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,SAAQ,MAAM,CAAC,gBAAgB,CAAC;IACA,GAAG,EAAE,SAAS,CAAA;IAM7D,MAAM,EAAE,MAAM,CAAA;IAMd,IAAI,EAAE,IAAI,CAAA;IACgB,MAAM,EAAE,MAAM,CAAA;IAEhD;;;OAGG;IACM,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKhD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;CAqDjD"}
+{"version":3,"file":"chart-region.d.ts","sourceRoot":"","sources":["../../src/line-chart/chart-region.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAEf,MAAM,EAIN,KAAK,IAAI,EAET,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,MAAM,EAEZ,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,UAAU,CAAA;AAGjB,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;OAIG;IACH,GAAG,EAAE,SAAS,CAAA;IACd,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,IAAI,EAAE,IAAI,CAAA;IACV;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,SAAQ,MAAM,CAAC,gBAAgB,CAAC;IACA,GAAG,EAAE,SAAS,CAAA;IAM7D,MAAM,EAAE,MAAM,CAAA;IAMd,IAAI,EAAE,IAAI,CAAA;IACgB,MAAM,EAAE,MAAM,CAAA;IAEhD;;;OAGG;IACM,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKhD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;CAqDjD"}

package/dist/line-chart/chart-region.js

@@ -4,9 +4,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { Graphics2D, Node2D, fillOps, strokeOps, property, } from "@motionscript/core";
+import { Graphics2D, Node2D, fillOps, strokeOps, property, } from "@motionscript/sdk";
 import { DEFAULT_CHART_THEME, EMPTY_REGION_BOX, hasRegion, } from "./shared.js";
-import { declarePaints } from "@motionscript/core/component";
+import { declarePaints } from "@motionscript/sdk/component";
 /**
  * The **region call-out** of a {@link LineChart}: a washed rectangle over the
  * plot with a dashed rule down each edge the author actually bounded. Sized and

package/dist/line-chart/chart-region.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-region.js","sourceRoot":"","sources":["../../src/line-chart/chart-region.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAEL,UAAU,EACV,MAAM,EACN,OAAO,EACP,SAAS,EACT,QAAQ,GAOT,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,GAEV,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAqB5D;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,WAAY,SAAQ,MAAwB;IAgBvD;;;OAGG;IACM,aAAa,CAAC,MAAkB;QACvC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QAC3B,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC7B,CAAC;IAES,UAAU,CAAC,GAAoB;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QACpB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;YAAE,OAAM;QAE3B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI,CAAC;YAAE,OAAM;QAElB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAA;QAClC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAA;QACnC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACrC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAErC,oDAAoD;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAsB,CAAA;QAC1C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,CACN,IAAI,UAAU,EAAE;iBACb,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;iBACrC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;iBACf,OAAO,CAAC,CAAC,CAAC,CACd,CAAA;QACH,CAAC;QAED,yEAAyE;QACzE,qEAAqE;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,MAA0B,CAAA;QAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAE/B,sEAAsE;QACtE,wEAAwE;QACxE,yDAAyD;QACzD,MAAM,IAAI,GAAG,CAAC,MAAkC,EAAE,EAAE,CAClD,GAAG,CAAC,IAAI,CAAC,IAAI,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;QAE5E,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;YAC7B,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC;oBACH,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE;oBACnB,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE;iBACpB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;YAC5B,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC;oBACH,EAAE,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE;oBACnB,EAAE,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE;iBACpB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA7EwD;IAAtD,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC;wCAAuB;AAM7D;IALP,QAAQ,CAAC;QACR,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM;QAC1C,MAAM,EAAE,SAAS,CAAC,OAAO;QACzB,KAAK,EAAE,SAAS,CAAC,IAAI;KACtB,CAAC;2CACoB;AAMd;IALP,QAAQ,CAAC;QACR,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI;QACxC,MAAM,EAAE,OAAO,CAAC,OAAO;QACvB,KAAK,EAAE,OAAO,CAAC,IAAI;KACpB,CAAC;yCACgB;AACgB;IAAjC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;2CAAuB","sourcesContent":["import {\n  type AssetScope,\n  Graphics2D,\n  Node2D,\n  fillOps,\n  strokeOps,\n  property,\n  type Fill,\n  type FillResolved,\n  type Node2DProps,\n  type RenderContext2D,\n  type Stroke,\n  type StrokeResolved,\n} from \"@motionscript/core\"\n\nimport {\n  DEFAULT_CHART_THEME,\n  EMPTY_REGION_BOX,\n  hasRegion,\n  type RegionBox,\n} from \"./shared\"\nimport { declarePaints } from \"@motionscript/core/component\"\n\nexport interface ChartRegionProps extends Node2DProps {\n  /**\n   * The highlighted slice, already resolved into this node's local pixel space\n   * (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box\n   * draws nothing.\n   */\n  box: RegionBox\n  /** Dashed rule marking each *bounded* edge of the box. */\n  stroke: Stroke\n  /** Wash filling the box, under the series lines. */\n  fill: Fill\n  /**\n   * Reveal of the annotation in `[0, 1]`: 0 hides it, 1 draws it fully. Driven\n   * by the chart's own `regionReveal`, so the rules and the series' dimming move\n   * as one.\n   */\n  reveal: number\n}\n\n/**\n * The **region call-out** of a {@link LineChart}: a washed rectangle over the\n * plot with a dashed rule down each edge the author actually bounded. Sized and\n * positioned entirely from the pre-mapped {@link ChartRegionProps.box} rather\n * than its own `layoutBounds` — the box already carries the plot geometry.\n *\n * It draws only the *marking*; fading the series outside the region is\n * {@link ChartLine}'s job (it clips its own polyline against the same box), so\n * the two can't disagree about where the boundary is.\n *\n * Only bounded edges get a rule: a region given just an `x` range spans the full\n * plot height, so its top and bottom edges are the plot's own border, not a data\n * bound — drawing dashes there would assert a limit the author didn't set.\n */\nexport class ChartRegion extends Node2D<ChartRegionProps> {\n  @property({ default: () => EMPTY_REGION_BOX }) declare box: RegionBox\n  @property({\n    default: DEFAULT_CHART_THEME.region.stroke,\n    mapper: strokeOps.resolve,\n    tween: strokeOps.lerp,\n  })\n  declare stroke: Stroke\n  @property({\n    default: DEFAULT_CHART_THEME.region.fill,\n    mapper: fillOps.resolve,\n    tween: fillOps.lerp,\n  })\n  declare fill: Fill\n  @property({ default: 0 }) declare reveal: number\n\n  /**\n   * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the\n   * paint props it carries — see {@link declarePaints}.\n   */\n  override declareAssets(assets: AssetScope): void {\n    super.declareAssets(assets)\n    declarePaints(this, assets)\n  }\n\n  protected renderSelf(ctx: RenderContext2D): void {\n    const box = this.box\n    if (!hasRegion(box)) return\n\n    const r = Math.max(0, Math.min(1, this.reveal))\n    if (r <= 0) return\n\n    const width = box.right - box.left\n    const height = box.top - box.bottom\n    const cx = (box.left + box.right) / 2\n    const cy = (box.bottom + box.top) / 2\n\n    // Wash first, so the rules sit over their own tint.\n    const layers = this.fill as FillResolved[]\n    if (layers.length > 0) {\n      ctx.draw(\n        new Graphics2D()\n          .rect({ x: cx, y: cy, width, height })\n          .fill(this.fill)\n          .opacity(r)\n      )\n    }\n\n    // One rule per bounded edge, growing from the region's centre outward as\n    // `reveal` climbs — the same \"trace it in\" beat as the series lines.\n    const stroke = this.stroke as StrokeResolved[]\n    if (stroke.length === 0) return\n\n    // One `draw` per rule rather than four line ops under a single paint:\n    // shapes chained before a `stroke()` are combined into one surface, and\n    // stroking a union of disjoint open paths doesn't paint.\n    const rule = (points: { x: number; y: number }[]) =>\n      ctx.draw(new Graphics2D().line({ points }).stroke(this.stroke).opacity(r))\n\n    if (box.xBounded) {\n      const half = (height / 2) * r\n      for (const x of [box.left, box.right]) {\n        rule([\n          { x, y: cy - half },\n          { x, y: cy + half },\n        ])\n      }\n    }\n    if (box.yBounded) {\n      const half = (width / 2) * r\n      for (const y of [box.bottom, box.top]) {\n        rule([\n          { x: cx - half, y },\n          { x: cx + half, y },\n        ])\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"chart-region.js","sourceRoot":"","sources":["../../src/line-chart/chart-region.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  type AssetScope,\r\n  Graphics2D,\r\n  Node2D,\r\n  fillOps,\r\n  strokeOps,\r\n  property,\r\n  type Fill,\r\n  type FillResolved,\r\n  type Node2DProps,\r\n  type RenderContext2D,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport {\r\n  DEFAULT_CHART_THEME,\r\n  EMPTY_REGION_BOX,\r\n  hasRegion,\r\n  type RegionBox,\r\n} from \"./shared\"\r\nimport { declarePaints } from \"@motionscript/sdk/component\"\r\n\r\nexport interface ChartRegionProps extends Node2DProps {\r\n  /**\r\n   * The highlighted slice, already resolved into this node's local pixel space\r\n   * (origin at centre, y-up) by the parent {@link LineChart}. A degenerate box\r\n   * draws nothing.\r\n   */\r\n  box: RegionBox\r\n  /** Dashed rule marking each *bounded* edge of the box. */\r\n  stroke: Stroke\r\n  /** Wash filling the box, under the series lines. */\r\n  fill: Fill\r\n  /**\r\n   * Reveal of the annotation in `[0, 1]`: 0 hides it, 1 draws it fully. Driven\r\n   * by the chart's own `regionReveal`, so the rules and the series' dimming move\r\n   * as one.\r\n   */\r\n  reveal: number\r\n}\r\n\r\n/**\r\n * The **region call-out** of a {@link LineChart}: a washed rectangle over the\r\n * plot with a dashed rule down each edge the author actually bounded. Sized and\r\n * positioned entirely from the pre-mapped {@link ChartRegionProps.box} rather\r\n * than its own `layoutBounds` — the box already carries the plot geometry.\r\n *\r\n * It draws only the *marking*; fading the series outside the region is\r\n * {@link ChartLine}'s job (it clips its own polyline against the same box), so\r\n * the two can't disagree about where the boundary is.\r\n *\r\n * Only bounded edges get a rule: a region given just an `x` range spans the full\r\n * plot height, so its top and bottom edges are the plot's own border, not a data\r\n * bound — drawing dashes there would assert a limit the author didn't set.\r\n */\r\nexport class ChartRegion extends Node2D<ChartRegionProps> {\r\n  @property({ default: () => EMPTY_REGION_BOX }) declare box: RegionBox\r\n  @property({\r\n    default: DEFAULT_CHART_THEME.region.stroke,\r\n    mapper: strokeOps.resolve,\r\n    tween: strokeOps.lerp,\r\n  })\r\n  declare stroke: Stroke\r\n  @property({\r\n    default: DEFAULT_CHART_THEME.region.fill,\r\n    mapper: fillOps.resolve,\r\n    tween: fillOps.lerp,\r\n  })\r\n  declare fill: Fill\r\n  @property({ default: 0 }) declare reveal: number\r\n\r\n  /**\r\n   * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the\r\n   * paint props it carries — see {@link declarePaints}.\r\n   */\r\n  override declareAssets(assets: AssetScope): void {\r\n    super.declareAssets(assets)\r\n    declarePaints(this, assets)\r\n  }\r\n\r\n  protected renderSelf(ctx: RenderContext2D): void {\r\n    const box = this.box\r\n    if (!hasRegion(box)) return\r\n\r\n    const r = Math.max(0, Math.min(1, this.reveal))\r\n    if (r <= 0) return\r\n\r\n    const width = box.right - box.left\r\n    const height = box.top - box.bottom\r\n    const cx = (box.left + box.right) / 2\r\n    const cy = (box.bottom + box.top) / 2\r\n\r\n    // Wash first, so the rules sit over their own tint.\r\n    const layers = this.fill as FillResolved[]\r\n    if (layers.length > 0) {\r\n      ctx.draw(\r\n        new Graphics2D()\r\n          .rect({ x: cx, y: cy, width, height })\r\n          .fill(this.fill)\r\n          .opacity(r)\r\n      )\r\n    }\r\n\r\n    // One rule per bounded edge, growing from the region's centre outward as\r\n    // `reveal` climbs — the same \"trace it in\" beat as the series lines.\r\n    const stroke = this.stroke as StrokeResolved[]\r\n    if (stroke.length === 0) return\r\n\r\n    // One `draw` per rule rather than four line ops under a single paint:\r\n    // shapes chained before a `stroke()` are combined into one surface, and\r\n    // stroking a union of disjoint open paths doesn't paint.\r\n    const rule = (points: { x: number; y: number }[]) =>\r\n      ctx.draw(new Graphics2D().line({ points }).stroke(this.stroke).opacity(r))\r\n\r\n    if (box.xBounded) {\r\n      const half = (height / 2) * r\r\n      for (const x of [box.left, box.right]) {\r\n        rule([\r\n          { x, y: cy - half },\r\n          { x, y: cy + half },\r\n        ])\r\n      }\r\n    }\r\n    if (box.yBounded) {\r\n      const half = (width / 2) * r\r\n      for (const y of [box.bottom, box.top]) {\r\n        rule([\r\n          { x: cx - half, y },\r\n          { x: cx + half, y },\r\n        ])\r\n      }\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/line-chart/horizontal-axis.d.ts

@@ -1,6 +1,6 @@
-import { Node2D, type CommandArgs, type NodeConfig, type Node2DProps } from "@motionscript/core";
+import { Node2D, type CommandArgs, type NodeConfig, type Node2DProps } from "@motionscript/sdk";
 import { type AxisConfig, type Range } from "../kit/shared.js";
-import { type Seekable } from "@motionscript/core/component";
+import { type Seekable } from "@motionscript/sdk/component";
 export interface HorizontalAxisProps extends Node2DProps {
     /** `[min, max]` of the horizontal scale the markers are positioned within. */
     range: Range;