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

package/dist/browser/kit.js

@@ -1,2 +1,2 @@
-import{A,B,C,D,E,F,G,H,I,J,K,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"./chunks/chunk-RMHQ6GYU.js";export{c as CHART_PALETTE,H as ChartBorder,I as ChartCanvas,J as ChartLegend,m as DEFAULT_LEGEND,l as DEFAULT_PLOT_AREA,d as DEFAULT_SERIES_COLORS,o as DEFAULT_SERIES_FILLS,n as DEFAULT_SERIES_STROKES,j as DEFAULT_X_AXIS,k as DEFAULT_Y_AXIS,e as SPOTLIGHT_DIM,K as VerticalAxis,f as clampUnit,G as enterBudget,C as formatMarker,D as formatPercent,q as lerpAxisConfig,b as lerpAxisDomain,u as lerpLegendConfig,s as lerpPlotArea,y as lerpSeriesFills,w as lerpSeriesStrokes,E as markerValues,F as niceStep,g as num,i as numericFields,p as resolveAxisConfig,a as resolveAxisDomain,t as resolveLegendConfig,B as resolvePalettePaint,r as resolvePlotArea,A as resolveSeriesFill,x as resolveSeriesFills,z as resolveSeriesStroke,v as resolveSeriesStrokes,h as text};
+import{A,B,C,D,E,F,G,H,I,J,K,L,M,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"./chunks/chunk-5ZPBV6BU.js";export{d as CHART_PALETTE,J as ChartBorder,K as ChartCanvas,L as ChartLegend,n as DEFAULT_LEGEND,m as DEFAULT_PLOT_AREA,e as DEFAULT_SERIES_COLORS,p as DEFAULT_SERIES_FILLS,o as DEFAULT_SERIES_STROKES,k as DEFAULT_X_AXIS,l as DEFAULT_Y_AXIS,f as SPOTLIGHT_DIM,M as VerticalAxis,c as axisTweenTarget,g as clampUnit,I as enterBudget,D as formatMarker,F as formatPercent,r as lerpAxisConfig,b as lerpAxisDomain,v as lerpLegendConfig,t as lerpPlotArea,z as lerpSeriesFills,x as lerpSeriesStrokes,E as markerStep,G as markerValues,H as niceStep,h as num,j as numericFields,q as resolveAxisConfig,a as resolveAxisDomain,u as resolveLegendConfig,C as resolvePalettePaint,s as resolvePlotArea,B as resolveSeriesFill,y as resolveSeriesFills,A as resolveSeriesStroke,w as resolveSeriesStrokes,i as text};
 //# sourceMappingURL=kit.js.map

package/dist/browser/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionscript/charts",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.5",
   "exports": {
     ".": "dist/browser/index.js",
     "./kit": "dist/browser/kit.js"
@@ -8,5 +8,6 @@
   "peers": [
     "@motionscript/sdk"
   ],
-  "assets": {}
+  "assets": {},
+  "thirdParty": []
 }

package/dist/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,6BAA6B,CAAA","sourcesContent":["/**\n * The chart **kit**: everything the three charts share, and the one thing a\n * copied chart does not copy.\n *\n * `ms add line-chart` writes `line-chart/*` into your project and rewrites its\n * reach for these to `@motionscript/charts`, so the plot panel, the value\n * axis, the legend and the number formatting stay a real dependency. That is\n * not a size decision — it is the only arrangement that works.\n *\n * A chart identifies its own parts, and the engine keys signal machinery to\n * class identity: `@property` installs against the class it was applied with,\n * and the renderer asks `instanceof` about what it is drawing. Copy\n * `VerticalAxis` alongside your fork and there are now two of it — two classes\n * answering one name, and whichever one your chart did not get renders as\n * nothing at all, with no error. Keeping the kit external makes that\n * impossible rather than unlikely.\n *\n * It also means a fix to the axis reaches a forked chart without a re-add,\n * which is the half of the bargain you get back for it.\n */\nexport * from \"./kit/shared\"\nexport * from \"./kit/chart-border\"\nexport * from \"./kit/chart-canvas\"\nexport * from \"./kit/chart-legend\"\nexport * from \"./kit/vertical-axis\"\nexport * from \"@motionscript/sdk/component\"\n"]}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,6BAA6B,CAAA","sourcesContent":["/**\r\n * The chart **kit**: everything the three charts share, and the one thing a\r\n * copied chart does not copy.\r\n *\r\n * `ms add line-chart` writes `line-chart/*` into your project and rewrites its\r\n * reach for these to `@motionscript/charts`, so the plot panel, the value\r\n * axis, the legend and the number formatting stay a real dependency. That is\r\n * not a size decision — it is the only arrangement that works.\r\n *\r\n * A chart identifies its own parts, and the engine keys signal machinery to\r\n * class identity: `@property` installs against the class it was applied with,\r\n * and the renderer asks `instanceof` about what it is drawing. Copy\r\n * `VerticalAxis` alongside your fork and there are now two of it — two classes\r\n * answering one name, and whichever one your chart did not get renders as\r\n * nothing at all, with no error. Keeping the kit external makes that\r\n * impossible rather than unlikely.\r\n *\r\n * It also means a fix to the axis reaches a forked chart without a re-add,\r\n * which is the half of the bargain you get back for it.\r\n */\r\nexport * from \"./kit/shared\"\r\nexport * from \"./kit/chart-border\"\r\nexport * from \"./kit/chart-canvas\"\r\nexport * from \"./kit/chart-legend\"\r\nexport * from \"./kit/vertical-axis\"\r\nexport * from \"@motionscript/sdk/component\"\r\n"]}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC","sourcesContent":["export * from \"./line-chart\";\nexport * from \"./bar-chart\";\nexport * from \"./pie-chart\";\nexport * from \"./engine\";\nexport { NODES } from \"./nodes\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC","sourcesContent":["export * from \"./line-chart\";\r\nexport * from \"./bar-chart\";\r\nexport * from \"./pie-chart\";\r\nexport * from \"./engine\";\r\nexport { NODES } from \"./nodes\";\r\n"]}

package/dist/kit/chart-border.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-border.js","sourceRoot":"","sources":["../../src/kit/chart-border.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAEL,UAAU,EACV,MAAM,EACN,SAAS,EACT,QAAQ,GAIT,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAW3D;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAY,SAAQ,MAAwB;IAQvD;;;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,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAA;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAM;QAE5B,0EAA0E;QAC1E,0CAA0C;QAC1C,GAAG,CAAC,IAAI,CACN,IAAI,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAC/E,CAAA;IACH,CAAC;CACF;AAtBS;IALP,QAAQ,CAAC;QACR,OAAO,EAAE,iBAAiB,CAAC,MAAM;QACjC,MAAM,EAAE,SAAS,CAAC,OAAO;QACzB,KAAK,EAAE,SAAS,CAAC,IAAI;KACtB,CAAC;2CACoB","sourcesContent":["import {\n  type AssetScope,\n  Graphics2D,\n  Node2D,\n  strokeOps,\n  property,\n  type Node2DProps,\n  type RenderContext2D,\n  type Stroke,\n} from \"@motionscript/sdk\"\n\nimport { DEFAULT_PLOT_AREA } from \"./shared\"\nimport { declarePaints } from \"@motionscript/sdk/component\"\n\nexport interface ChartBorderProps extends Node2DProps {\n  /**\n   * The plot's thick frame stroke. The stroke resolver's default `align` is\n   * `'inside'`, so the whole weight sits within the layout box unless the theme\n   * overrides it.\n   */\n  stroke: Stroke\n}\n\n/**\n * The thick **frame** around a cartesian chart's plot: an empty rect wearing an\n * inside stroke, sized from its allocated `layoutBounds`.\n *\n * Split out of {@link ChartCanvas} (the filled + gridded backdrop) so it can be\n * placed *after* the marks in the tree — the box then frames the plot **over**\n * them, so a line or a column running to the edge tucks cleanly under the border\n * rather than sitting on top of it.\n */\nexport class ChartBorder extends Node2D<ChartBorderProps> {\n  @property({\n    default: DEFAULT_PLOT_AREA.stroke,\n    mapper: strokeOps.resolve,\n    tween: strokeOps.lerp,\n  })\n  declare stroke: Stroke\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 W = this.layoutBounds.width\n    const H = this.layoutBounds.height\n    if (W <= 0 || H <= 0) return\n\n    // Empty rect (no fill) with the themed stroke, so the frame sits over the\n    // marks but the box interior stays clear.\n    ctx.draw(\n      new Graphics2D().rect({ x: 0, y: 0, width: W, height: H }).stroke(this.stroke)\n    )\n  }\n}\n"]}
+{"version":3,"file":"chart-border.js","sourceRoot":"","sources":["../../src/kit/chart-border.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAEL,UAAU,EACV,MAAM,EACN,SAAS,EACT,QAAQ,GAIT,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAW3D;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAY,SAAQ,MAAwB;IAQvD;;;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,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAA;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAM;QAE5B,0EAA0E;QAC1E,0CAA0C;QAC1C,GAAG,CAAC,IAAI,CACN,IAAI,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAC/E,CAAA;IACH,CAAC;CACF;AAtBS;IALP,QAAQ,CAAC;QACR,OAAO,EAAE,iBAAiB,CAAC,MAAM;QACjC,MAAM,EAAE,SAAS,CAAC,OAAO;QACzB,KAAK,EAAE,SAAS,CAAC,IAAI;KACtB,CAAC;2CACoB","sourcesContent":["import {\r\n  type AssetScope,\r\n  Graphics2D,\r\n  Node2D,\r\n  strokeOps,\r\n  property,\r\n  type Node2DProps,\r\n  type RenderContext2D,\r\n  type Stroke,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { DEFAULT_PLOT_AREA } from \"./shared\"\r\nimport { declarePaints } from \"@motionscript/sdk/component\"\r\n\r\nexport interface ChartBorderProps extends Node2DProps {\r\n  /**\r\n   * The plot's thick frame stroke. The stroke resolver's default `align` is\r\n   * `'inside'`, so the whole weight sits within the layout box unless the theme\r\n   * overrides it.\r\n   */\r\n  stroke: Stroke\r\n}\r\n\r\n/**\r\n * The thick **frame** around a cartesian chart's plot: an empty rect wearing an\r\n * inside stroke, sized from its allocated `layoutBounds`.\r\n *\r\n * Split out of {@link ChartCanvas} (the filled + gridded backdrop) so it can be\r\n * placed *after* the marks in the tree — the box then frames the plot **over**\r\n * them, so a line or a column running to the edge tucks cleanly under the border\r\n * rather than sitting on top of it.\r\n */\r\nexport class ChartBorder extends Node2D<ChartBorderProps> {\r\n  @property({\r\n    default: DEFAULT_PLOT_AREA.stroke,\r\n    mapper: strokeOps.resolve,\r\n    tween: strokeOps.lerp,\r\n  })\r\n  declare stroke: Stroke\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 W = this.layoutBounds.width\r\n    const H = this.layoutBounds.height\r\n    if (W <= 0 || H <= 0) return\r\n\r\n    // Empty rect (no fill) with the themed stroke, so the frame sits over the\r\n    // marks but the box interior stays clear.\r\n    ctx.draw(\r\n      new Graphics2D().rect({ x: 0, y: 0, width: W, height: H }).stroke(this.stroke)\r\n    )\r\n  }\r\n}\r\n"]}

package/dist/kit/chart-canvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-canvas.js","sourceRoot":"","sources":["../../src/kit/chart-canvas.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type AssetScope,\n  Graphics2D,\n  Node2D,\n  fillOps,\n  shadowOps,\n  strokeOps,\n  property,\n  type Fill,\n  type Node2DProps,\n  type RenderContext2D,\n  type Shadow,\n  type Stroke,\n  type StrokeResolved,\n} from \"@motionscript/sdk\"\n\nimport {\n  DEFAULT_PLOT_AREA,\n  DEFAULT_X_AXIS,\n  DEFAULT_Y_AXIS,\n  type Range,\n} from \"./shared\"\nimport { declarePaints } from \"@motionscript/sdk/component\"\n\nexport interface ChartCanvasProps extends Node2DProps {\n  /** Fill of the plot panel behind the marks. */\n  fill: Fill\n  /** Drop shadow of the panel. Default none. */\n  shadow: Shadow\n  /** Stroke of the vertical grid lines (one per {@link xMarkers}). */\n  xGridStroke: Stroke\n  /** Stroke of the horizontal grid lines (one per {@link yMarkers}). */\n  yGridStroke: Stroke\n  /**\n   * Data-unit x positions to draw a vertical grid line at — one per horizontal\n   * axis marker, so a line lands under every marker regardless of spacing.\n   * Positions at (or past) an {@link xExtent} edge coincide with the border and\n   * are skipped. Pass an empty list for a chart whose horizontal axis is\n   * categorical and so has no numeric position to rule at.\n   */\n  xMarkers: number[]\n  /** Data-unit y positions to draw a horizontal grid line at. */\n  yMarkers: number[]\n  /** `[min, max]` of the horizontal scale — maps {@link xMarkers} into the panel. */\n  xExtent: Range\n  /** `[min, max]` of the vertical scale — maps {@link yMarkers} into the panel. */\n  yExtent: Range\n}\n\n/**\n * The plot **backdrop** of a cartesian chart: a filled panel with a grid of\n * faint lines spanning both directions across it. Drawn as one {@link Graphics2D}\n * command list, sized from its allocated `layoutBounds` and centred on the node\n * origin.\n *\n * The thick frame is a **separate** {@link ChartBorder} node so it can be drawn\n * *over* the marks while this panel sits under them. Grid lines are placed from\n * the axis marker positions (in data units) mapped into the panel through\n * {@link ChartCanvasProps.xExtent}/`yExtent` — so each line lands under its\n * marker whether or not the markers are evenly spaced.\n */\nexport class ChartCanvas extends Node2D<ChartCanvasProps> {\n  @property({\n    default: DEFAULT_PLOT_AREA.fill,\n    mapper: fillOps.resolve,\n    tween: fillOps.lerp,\n  })\n  declare fill: Fill\n  @property({\n    default: DEFAULT_PLOT_AREA.shadow,\n    mapper: shadowOps.resolve,\n    tween: shadowOps.lerp,\n  })\n  declare shadow: Shadow\n  @property({\n    default: DEFAULT_X_AXIS.lineStyle,\n    mapper: strokeOps.resolve,\n    tween: strokeOps.lerp,\n  })\n  declare xGridStroke: Stroke\n  @property({\n    default: DEFAULT_Y_AXIS.lineStyle,\n    mapper: strokeOps.resolve,\n    tween: strokeOps.lerp,\n  })\n  declare yGridStroke: Stroke\n  @property({ default: () => [] as number[] }) declare xMarkers: number[]\n  @property({ default: () => [] as number[] }) declare yMarkers: number[]\n  @property({ default: () => [0, 1] as Range }) declare xExtent: Range\n  @property({ default: () => [0, 1] as Range }) declare yExtent: Range\n\n  /**\n   * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the\n   * paint props it carries — see {@link declarePaints}. The grid strokes are\n   * named past the conventional slots, so they are passed explicitly.\n   */\n  override declareAssets(assets: AssetScope): void {\n    super.declareAssets(assets)\n    declarePaints(this, assets, {\n      strokes: [this.xGridStroke as StrokeResolved[], this.yGridStroke as StrokeResolved[]],\n    })\n  }\n\n  protected renderSelf(ctx: RenderContext2D): void {\n    const W = this.layoutBounds.width\n    const H = this.layoutBounds.height\n    if (W <= 0 || H <= 0) return\n\n    // Plot panel, centred on the origin (node space is y-up, origin centre).\n    ctx.draw(\n      new Graphics2D()\n        .rect({ x: 0, y: 0, width: W, height: H })\n        .shadow(this.shadow)\n        .fill(this.fill)\n    )\n\n    const [xMin, xMax] = this.xExtent\n    const [yMin, yMax] = this.yExtent\n    // Fraction of a marker across its extent; guard a zero-width extent.\n    const xFrac = (v: number) => (xMax <= xMin ? 0 : (v - xMin) / (xMax - xMin))\n    const yFrac = (v: number) => (yMax <= yMin ? 0 : (v - yMin) / (yMax - yMin))\n    // Skip markers landing on (or outside) the edges — they'd sit under the border.\n    const interior = (f: number) => f > 1e-6 && f < 1 - 1e-6\n\n    const xStroke = (this.xGridStroke as StrokeResolved[])[0]\n    if (xStroke) {\n      const xGrid = new Graphics2D()\n      for (const v of this.xMarkers) {\n        const f = xFrac(v)\n        if (!interior(f)) continue\n        xGrid.rect({\n          x: -W / 2 + f * W,\n          y: 0,\n          width: xStroke.weight,\n          height: H,\n        })\n      }\n      ctx.draw(xGrid.fill(xStroke.fill))\n    }\n\n    const yStroke = (this.yGridStroke as StrokeResolved[])[0]\n    if (yStroke) {\n      const yGrid = new Graphics2D()\n      for (const v of this.yMarkers) {\n        const f = yFrac(v)\n        if (!interior(f)) continue\n        yGrid.rect({\n          x: 0,\n          y: -H / 2 + f * H,\n          width: W,\n          height: yStroke.weight,\n        })\n      }\n      ctx.draw(yGrid.fill(yStroke.fill))\n    }\n  }\n}\n"]}
+{"version":3,"file":"chart-canvas.js","sourceRoot":"","sources":["../../src/kit/chart-canvas.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  type AssetScope,\r\n  Graphics2D,\r\n  Node2D,\r\n  fillOps,\r\n  shadowOps,\r\n  strokeOps,\r\n  property,\r\n  type Fill,\r\n  type Node2DProps,\r\n  type RenderContext2D,\r\n  type Shadow,\r\n  type Stroke,\r\n  type StrokeResolved,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport {\r\n  DEFAULT_PLOT_AREA,\r\n  DEFAULT_X_AXIS,\r\n  DEFAULT_Y_AXIS,\r\n  type Range,\r\n} from \"./shared\"\r\nimport { declarePaints } from \"@motionscript/sdk/component\"\r\n\r\nexport interface ChartCanvasProps extends Node2DProps {\r\n  /** Fill of the plot panel behind the marks. */\r\n  fill: Fill\r\n  /** Drop shadow of the panel. Default none. */\r\n  shadow: Shadow\r\n  /** Stroke of the vertical grid lines (one per {@link xMarkers}). */\r\n  xGridStroke: Stroke\r\n  /** Stroke of the horizontal grid lines (one per {@link yMarkers}). */\r\n  yGridStroke: Stroke\r\n  /**\r\n   * Data-unit x positions to draw a vertical grid line at — one per horizontal\r\n   * axis marker, so a line lands under every marker regardless of spacing.\r\n   * Positions at (or past) an {@link xExtent} edge coincide with the border and\r\n   * are skipped. Pass an empty list for a chart whose horizontal axis is\r\n   * categorical and so has no numeric position to rule at.\r\n   */\r\n  xMarkers: number[]\r\n  /** Data-unit y positions to draw a horizontal grid line at. */\r\n  yMarkers: number[]\r\n  /** `[min, max]` of the horizontal scale — maps {@link xMarkers} into the panel. */\r\n  xExtent: Range\r\n  /** `[min, max]` of the vertical scale — maps {@link yMarkers} into the panel. */\r\n  yExtent: Range\r\n}\r\n\r\n/**\r\n * The plot **backdrop** of a cartesian chart: a filled panel with a grid of\r\n * faint lines spanning both directions across it. Drawn as one {@link Graphics2D}\r\n * command list, sized from its allocated `layoutBounds` and centred on the node\r\n * origin.\r\n *\r\n * The thick frame is a **separate** {@link ChartBorder} node so it can be drawn\r\n * *over* the marks while this panel sits under them. Grid lines are placed from\r\n * the axis marker positions (in data units) mapped into the panel through\r\n * {@link ChartCanvasProps.xExtent}/`yExtent` — so each line lands under its\r\n * marker whether or not the markers are evenly spaced.\r\n */\r\nexport class ChartCanvas extends Node2D<ChartCanvasProps> {\r\n  @property({\r\n    default: DEFAULT_PLOT_AREA.fill,\r\n    mapper: fillOps.resolve,\r\n    tween: fillOps.lerp,\r\n  })\r\n  declare fill: Fill\r\n  @property({\r\n    default: DEFAULT_PLOT_AREA.shadow,\r\n    mapper: shadowOps.resolve,\r\n    tween: shadowOps.lerp,\r\n  })\r\n  declare shadow: Shadow\r\n  @property({\r\n    default: DEFAULT_X_AXIS.lineStyle,\r\n    mapper: strokeOps.resolve,\r\n    tween: strokeOps.lerp,\r\n  })\r\n  declare xGridStroke: Stroke\r\n  @property({\r\n    default: DEFAULT_Y_AXIS.lineStyle,\r\n    mapper: strokeOps.resolve,\r\n    tween: strokeOps.lerp,\r\n  })\r\n  declare yGridStroke: Stroke\r\n  @property({ default: () => [] as number[] }) declare xMarkers: number[]\r\n  @property({ default: () => [] as number[] }) declare yMarkers: number[]\r\n  @property({ default: () => [0, 1] as Range }) declare xExtent: Range\r\n  @property({ default: () => [0, 1] as Range }) declare yExtent: Range\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}. The grid strokes are\r\n   * named past the conventional slots, so they are passed explicitly.\r\n   */\r\n  override declareAssets(assets: AssetScope): void {\r\n    super.declareAssets(assets)\r\n    declarePaints(this, assets, {\r\n      strokes: [this.xGridStroke as StrokeResolved[], this.yGridStroke as StrokeResolved[]],\r\n    })\r\n  }\r\n\r\n  protected renderSelf(ctx: RenderContext2D): void {\r\n    const W = this.layoutBounds.width\r\n    const H = this.layoutBounds.height\r\n    if (W <= 0 || H <= 0) return\r\n\r\n    // Plot panel, centred on the origin (node space is y-up, origin centre).\r\n    ctx.draw(\r\n      new Graphics2D()\r\n        .rect({ x: 0, y: 0, width: W, height: H })\r\n        .shadow(this.shadow)\r\n        .fill(this.fill)\r\n    )\r\n\r\n    const [xMin, xMax] = this.xExtent\r\n    const [yMin, yMax] = this.yExtent\r\n    // Fraction of a marker across its extent; guard a zero-width extent.\r\n    const xFrac = (v: number) => (xMax <= xMin ? 0 : (v - xMin) / (xMax - xMin))\r\n    const yFrac = (v: number) => (yMax <= yMin ? 0 : (v - yMin) / (yMax - yMin))\r\n    // Skip markers landing on (or outside) the edges — they'd sit under the border.\r\n    const interior = (f: number) => f > 1e-6 && f < 1 - 1e-6\r\n\r\n    const xStroke = (this.xGridStroke as StrokeResolved[])[0]\r\n    if (xStroke) {\r\n      const xGrid = new Graphics2D()\r\n      for (const v of this.xMarkers) {\r\n        const f = xFrac(v)\r\n        if (!interior(f)) continue\r\n        xGrid.rect({\r\n          x: -W / 2 + f * W,\r\n          y: 0,\r\n          width: xStroke.weight,\r\n          height: H,\r\n        })\r\n      }\r\n      ctx.draw(xGrid.fill(xStroke.fill))\r\n    }\r\n\r\n    const yStroke = (this.yGridStroke as StrokeResolved[])[0]\r\n    if (yStroke) {\r\n      const yGrid = new Graphics2D()\r\n      for (const v of this.yMarkers) {\r\n        const f = yFrac(v)\r\n        if (!interior(f)) continue\r\n        yGrid.rect({\r\n          x: 0,\r\n          y: -H / 2 + f * H,\r\n          width: W,\r\n          height: yStroke.weight,\r\n        })\r\n      }\r\n      ctx.draw(yGrid.fill(yStroke.fill))\r\n    }\r\n  }\r\n}\r\n"]}

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

@@ -51,35 +51,14 @@ export declare class ChartLegend extends Rect {
      * getting there means having run the add. Collapsed-but-present is the same
      * picture reached by a route that *is* a function of `t`.
      *
-     * A plain array rather than reactive props because the count is the series
-     * count, which is data. The entries' props are bound to it, so writing one
+     * One array in one slot, because the count is the series count, which is data.
+     * It is replaced rather than mutated: a write is a slot write, so the timeline
+     * sees it and restores it to the authored reveal before the command starts
+     * and after a seek back. The entries' props are bound to it, so writing it
      * still moves the layout.
      */
     private reveal;
-    /**
-     * Each entry's natural width, last time it was fully shown.
-     *
-     * A collapse needs numeric endpoints — `lerpSizeInput` snaps between a token
-     * and a number rather than interpolating — and `"hug"` is not a number until
-     * something measures it. Refreshed on every frame an entry is at full reveal
-     * (see {@link widthFor}), so it is current by the time a hide starts, and it
-     * tracks a relabelled series or a restyled legend without being told.
-     */
-    private natural;
     constructor(props?: NodeConfig<ChartLegend, ChartLegendProps>);
-    /**
-     * An entry's width for its current reveal.
-     *
-     * `"hug"` at full reveal rather than the pinned number, so a shown entry stays
-     * responsive to its own content; the number only takes over while it is
-     * collapsing, which is the only time a token cannot express it.
-     *
-     * Records the natural width as a side effect, which is the honest place for it:
-     * this runs inside a binding, so it is already reading the layout every frame,
-     * and the value it wants is the one the layout just produced. It writes a plain
-     * array rather than a signal, so nothing is invalidated by it.
-     */
-    private widthFor;
     /** One entry: the series caption beside its colour swatch. */
     private buildItem;
     /** True if series `index` is showing at all — see {@link reveal}. */

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

@@ -1 +1 @@
-{"version":3,"file":"chart-legend.d.ts","sourceRoot":"","sources":["../../src/kit/chart-legend.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAMJ,KAAK,WAAW,EAEhB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAElF,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD;;;;;OAKG;IACH,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,EAAE,IAAI,EAAE,CAAA;IAChB,oFAAoF;IACpF,MAAM,EAAE,YAAY,CAAA;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,SAAQ,IAAI;IACuB,MAAM,EAAE,WAAW,EAAE,CAAA;IAC5B,QAAQ,EAAE,IAAI,EAAE,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;IAEnE,6EAA6E;IAC7E,OAAO,CAAC,KAAK,CAAa;IAC1B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,MAAM,CAAe;IAC7B;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO,CAAe;gBAElB,KAAK,CAAC,EAAE,UAAU,CAAC,WAAW,EAAE,gBAAgB,CAAC;IA6B7D;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,QAAQ;IAUhB,8DAA8D;IAC9D,OAAO,CAAC,SAAS;IAgCjB,qEAAqE;IACrE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;;;OAOG;IAEH,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,QAAQ;IAK1D;;;OAGG;IAEH,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,QAAQ;IAK1D;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAahB;;;;;;;OAOG;IAEH,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,QAAQ;CAehE"}
+{"version":3,"file":"chart-legend.d.ts","sourceRoot":"","sources":["../../src/kit/chart-legend.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAMJ,KAAK,WAAW,EAEhB,KAAK,IAAI,EAET,KAAK,UAAU,EACf,KAAK,SAAS,EAGf,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAElF,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD;;;;;OAKG;IACH,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,EAAE,IAAI,EAAE,CAAA;IAChB,oFAAoF;IACpF,MAAM,EAAE,YAAY,CAAA;CACrB;AAuBD;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,SAAQ,IAAI;IACuB,MAAM,EAAE,WAAW,EAAE,CAAA;IAC5B,QAAQ,EAAE,IAAI,EAAE,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;IAEnE,6EAA6E;IAC7E,OAAO,CAAC,KAAK,CAAoB;IACjC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAA6D,MAAM,CAAU;gBAEjE,KAAK,CAAC,EAAE,UAAU,CAAC,WAAW,EAAE,gBAAgB,CAAC;IA4B7D,8DAA8D;IAC9D,OAAO,CAAC,SAAS;IAgCjB,qEAAqE;IACrE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;;;OAOG;IAEH,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,QAAQ;IAK1D;;;OAGG;IAEH,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,QAAQ;IAK1D;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAehB;;;;;;;OAOG;IAEH,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,QAAQ;CAehE"}

package/dist/kit/chart-legend.js

@@ -7,6 +7,27 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { Rect, Text, command, easeOut, property, textOps, } from "@motionscript/sdk";
 import { drive, hold, together } from "@motionscript/sdk/component";
 import { DEFAULT_LEGEND, SPOTLIGHT_DIM, } from "./shared.js";
+/**
+ * One legend entry. It hugs its caption and swatch; `shown` scales that width from
+ * nothing to the whole of it.
+ *
+ * The width is taken from the content on every measure, at any reveal, so a frame
+ * never depends on whether the entry was once seen fully shown. A collapse needs a
+ * number to scale, and `"hug"` is not one until something measures it — this is
+ * the something.
+ */
+class LegendEntry extends Rect {
+    _shown;
+    constructor(props, _shown) {
+        super(props);
+        this._shown = _shown;
+    }
+    measure(constraints, scope) {
+        const size = super.measure(constraints, scope);
+        const shown = this._shown();
+        return shown >= 1 ? size : { ...size, width: shown * (size.width ?? 0) };
+    }
+}
 /**
  * The legend of a chart: a **horizontal-flow row of entries**, one per series, laid out
  * left-to-right with the theme's `itemGap`. Each entry pairs the series label
@@ -24,33 +45,6 @@ import { DEFAULT_LEGEND, SPOTLIGHT_DIM, } from "./shared.js";
 export class ChartLegend extends Rect {
     /** One entry per series. **Every** entry is a child — see {@link reveal}. */
     items = [];
-    /**
-     * How far each entry is shown, `0`–`1`. Drives its width, opacity and gap
-     * together, so `0` is an entry that takes no room and `1` is one at its
-     * natural size.
-     *
-     * This replaces adding and removing the entry from the row, which is what
-     * `showSeries`/`hideSeries` used to do. That could not be a command: a command
-     * is asked what it looks like at a time, and "is this node a child" is not a
-     * value a time can produce — the tree either contains it or it doesn't, and
-     * getting there means having run the add. Collapsed-but-present is the same
-     * picture reached by a route that *is* a function of `t`.
-     *
-     * A plain array rather than reactive props because the count is the series
-     * count, which is data. The entries' props are bound to it, so writing one
-     * still moves the layout.
-     */
-    reveal = [];
-    /**
-     * Each entry's natural width, last time it was fully shown.
-     *
-     * A collapse needs numeric endpoints — `lerpSizeInput` snaps between a token
-     * and a number rather than interpolating — and `"hug"` is not a number until
-     * something measures it. Refreshed on every frame an entry is at full reveal
-     * (see {@link widthFor}), so it is current by the time a hide starts, and it
-     * tracks a relabelled series or a restyled legend without being told.
-     */
-    natural = [];
     constructor(props) {
         // `flow` after the spread, with the rest of the geometry: this class *is*
         // the row, so the direction is its own answer and not the caller's. It has
@@ -69,7 +63,6 @@ export class ChartLegend extends Rect {
         // props super() applied. Fixed row geometry last, so it wins over super().
         this.set({ gap: this.legend.itemGap, padding: this.legend.padding });
         this.reveal = this.series.map((s) => ((s.enabled ?? true) ? 1 : 0));
-        this.natural = this.series.map(() => 0);
         this.items = this.series.map((s, i) => this.buildItem(s, i));
         // All of them, in series order. Order is now fixed rather than depending on
         // which siblings happen to be shown, so an entry always comes back where it
@@ -77,37 +70,15 @@ export class ChartLegend extends Rect {
         for (const item of this.items)
             this.add(item);
     }
-    /**
-     * An entry's width for its current reveal.
-     *
-     * `"hug"` at full reveal rather than the pinned number, so a shown entry stays
-     * responsive to its own content; the number only takes over while it is
-     * collapsing, which is the only time a token cannot express it.
-     *
-     * Records the natural width as a side effect, which is the honest place for it:
-     * this runs inside a binding, so it is already reading the layout every frame,
-     * and the value it wants is the one the layout just produced. It writes a plain
-     * array rather than a signal, so nothing is invalidated by it.
-     */
-    widthFor(index) {
-        const shown = this.reveal[index] ?? 0;
-        if (shown >= 1) {
-            const measured = this.items[index]?.measuredWidth ?? 0;
-            if (measured > 0)
-                this.natural[index] = measured;
-            return "hug";
-        }
-        return shown * (this.natural[index] ?? 0);
-    }
     /** One entry: the series caption beside its colour swatch. */
     buildItem(series, index) {
         const marker = this.legend.markerStyle;
-        const item = new Rect({ flow: "horizontal",
+        const item = new LegendEntry({ flow: "horizontal",
             gap: 12,
             align: "center",
             // Bound to the reveal, so showing and hiding is a number moving rather
-            // than a child arriving and leaving.
-            width: () => this.widthFor(index),
+            // than a child arriving and leaving. The width follows it in `measure`.
+            width: "hug",
             opacity: () => this.reveal[index] ?? 0,
             height: "hug",
             children: [
@@ -124,7 +95,7 @@ export class ChartLegend extends Rect {
                     shadow: marker.shadow,
                 }),
             ],
-        });
+        }, () => this.reveal[index] ?? 0);
         // `gapScale` is a `Node` prop rather than a container one, so it is bound here
         // instead of in the config. It tracks the reveal so the flanking gap closes
         // with the entry rather than snapping when it reaches zero.
@@ -168,7 +139,9 @@ export class ChartLegend extends Rect {
             return hold(duration);
         const from = this.reveal[index] ?? 0;
         return drive(duration, (t) => {
-            this.reveal[index] = from + (target - from) * easing(t);
+            const next = [...this.reveal];
+            next[index] = from + (target - from) * easing(t);
+            this.reveal = next;
         });
     }
     /**
@@ -200,6 +173,9 @@ __decorate([
 __decorate([
     property({ default: DEFAULT_LEGEND })
 ], ChartLegend.prototype, "legend", void 0);
+__decorate([
+    property({ default: () => [] })
+], ChartLegend.prototype, "reveal", void 0);
 __decorate([
     command()
 ], ChartLegend.prototype, "showSeries", null);

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

@@ -1 +1 @@
-{"version":3,"file":"chart-legend.js","sourceRoot":"","sources":["../../src/kit/chart-legend.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Rect,\n  Text,\n  command,\n  easeOut,\n  property,\n  textOps,\n  type CommandArgs,\n  type EasingFunction,\n  type Fill,\n  type NodeConfig,\n  type RectProps,\n} from \"@motionscript/sdk\"\n\nimport { drive, hold, together, type Seekable } from \"@motionscript/sdk/component\"\n\nimport {\n  DEFAULT_LEGEND,\n  SPOTLIGHT_DIM,\n  type ChartSeries,\n  type LegendConfig,\n} from \"./shared\"\n\nexport interface ChartLegendProps extends RectProps {\n  /**\n   * One entry per series: legend `label`, its `enabled` default, and — through\n   * {@link ChartLegendProps.swatches} — the colour its chip is painted. A series\n   * that starts enabled (the default) is added to the row up front; one that\n   * starts `false` is hidden until a later {@link ChartLegend.showSeries}.\n   */\n  series: ChartSeries[]\n  /**\n   * The swatch colour for each series, by index — resolved by the chart, whose\n   * business it is whether a series' colour comes out of a stroke palette (a\n   * line) or a fill palette (a bar). Shorter than the series list means the\n   * missing entries fall back to white.\n   */\n  swatches: Fill[]\n  /** Padding, caption style, gaps, and swatch geometry — see {@link LegendConfig}. */\n  legend: LegendConfig\n}\n\n/**\n * The legend of a chart: a **horizontal-flow row of entries**, one per series, laid out\n * left-to-right with the theme's `itemGap`. Each entry pairs the series label\n * with a rounded colour swatch; only the swatch carries the series colour, the\n * caption reads in the legend's neutral ink.\n *\n * {@link showSeries}/{@link hideSeries} flip a series on or off — showing one\n * adds its entry back into the row at its stable series position and grows it\n * in, hiding one shrinks it away and removes it. So the row only ever holds the\n * currently-enabled series, in series order, and closes the gap when one leaves.\n *\n * This node *is* the row, so the parent places it (centred below the chart) and\n * it hugs its entries.\n */\nexport class ChartLegend extends Rect {\n  @property({ default: () => [] as ChartSeries[] }) declare series: ChartSeries[]\n  @property({ default: () => [] as Fill[] }) declare swatches: Fill[]\n  @property({ default: DEFAULT_LEGEND }) declare legend: LegendConfig\n\n  /** One entry per series. **Every** entry is a child — see {@link reveal}. */\n  private items: Rect[] = []\n  /**\n   * How far each entry is shown, `0`–`1`. Drives its width, opacity and gap\n   * together, so `0` is an entry that takes no room and `1` is one at its\n   * natural size.\n   *\n   * This replaces adding and removing the entry from the row, which is what\n   * `showSeries`/`hideSeries` used to do. That could not be a command: a command\n   * is asked what it looks like at a time, and \"is this node a child\" is not a\n   * value a time can produce — the tree either contains it or it doesn't, and\n   * getting there means having run the add. Collapsed-but-present is the same\n   * picture reached by a route that *is* a function of `t`.\n   *\n   * A plain array rather than reactive props because the count is the series\n   * count, which is data. The entries' props are bound to it, so writing one\n   * still moves the layout.\n   */\n  private reveal: number[] = []\n  /**\n   * Each entry's natural width, last time it was fully shown.\n   *\n   * A collapse needs numeric endpoints — `lerpSizeInput` snaps between a token\n   * and a number rather than interpolating — and `\"hug\"` is not a number until\n   * something measures it. Refreshed on every frame an entry is at full reveal\n   * (see {@link widthFor}), so it is current by the time a hide starts, and it\n   * tracks a relabelled series or a restyled legend without being told.\n   */\n  private natural: number[] = []\n\n  constructor(props?: NodeConfig<ChartLegend, ChartLegendProps>) {\n    // `flow` after the spread, with the rest of the geometry: this class *is*\n    // the row, so the direction is its own answer and not the caller's. It has\n    // to be stated — a `Rect` given no flow lays its children out `freeform`,\n    // which stacks every entry on the same spot. One series looks perfect that\n    // way and three look like one smeared caption, so the failure only shows up\n    // on the charts that most need a legend.\n    super({\n      ...(props as RectProps),\n      flow: \"horizontal\",\n      align: \"center\",\n      width: \"hug\",\n      height: \"hug\",\n    })\n\n    // Structure is one entry per series, so it's composed here from the resolved\n    // props super() applied. Fixed row geometry last, so it wins over super().\n    this.set({ gap: this.legend.itemGap, padding: this.legend.padding })\n\n    this.reveal = this.series.map((s) => ((s.enabled ?? true) ? 1 : 0))\n    this.natural = this.series.map(() => 0)\n    this.items = this.series.map((s, i) => this.buildItem(s, i))\n\n    // All of them, in series order. Order is now fixed rather than depending on\n    // which siblings happen to be shown, so an entry always comes back where it\n    // belongs and `insertionIndex` has nothing left to compute.\n    for (const item of this.items) this.add(item)\n  }\n\n  /**\n   * An entry's width for its current reveal.\n   *\n   * `\"hug\"` at full reveal rather than the pinned number, so a shown entry stays\n   * responsive to its own content; the number only takes over while it is\n   * collapsing, which is the only time a token cannot express it.\n   *\n   * Records the natural width as a side effect, which is the honest place for it:\n   * this runs inside a binding, so it is already reading the layout every frame,\n   * and the value it wants is the one the layout just produced. It writes a plain\n   * array rather than a signal, so nothing is invalidated by it.\n   */\n  private widthFor(index: number): number | \"hug\" {\n    const shown = this.reveal[index] ?? 0\n    if (shown >= 1) {\n      const measured = this.items[index]?.measuredWidth ?? 0\n      if (measured > 0) this.natural[index] = measured\n      return \"hug\"\n    }\n    return shown * (this.natural[index] ?? 0)\n  }\n\n  /** One entry: the series caption beside its colour swatch. */\n  private buildItem(series: ChartSeries, index: number): Rect {\n    const marker = this.legend.markerStyle\n    const item = new Rect({ flow: \"horizontal\",\n      gap: 12,\n      align: \"center\",\n      // Bound to the reveal, so showing and hiding is a number moving rather\n      // than a child arriving and leaving.\n      width: () => this.widthFor(index),\n      opacity: () => this.reveal[index] ?? 0,\n      height: \"hug\",\n      children: [\n        new Text({\n          ...textOps.styleProps(this.legend.textStyle),\n          text: series.label,\n        }),\n        new Rect({\n          width: marker.width,\n          height: marker.height,\n          cornerRadius: marker.borderRadius,\n          fill: this.swatches[index] ?? \"white\",\n          stroke: marker.stroke,\n          shadow: marker.shadow,\n        }),\n      ],\n    })\n    // `gapScale` is a `Node` prop rather than a container one, so it is bound here\n    // instead of in the config. It tracks the reveal so the flanking gap closes\n    // with the entry rather than snapping when it reaches zero.\n    item.set({ gapScale: () => this.reveal[index] ?? 0 })\n    return item\n  }\n\n  /** True if series `index` is showing at all — see {@link reveal}. */\n  isEnabled(index: number): boolean {\n    return (this.reveal[index] ?? 0) > 0\n  }\n\n  /**\n   * Grow series `index`'s entry back in at its series-order position, the\n   * siblings sliding over to make room.\n   *\n   * A reveal tween rather than an animated `addChildAt`. The entry never left —\n   * see {@link reveal} — so there is no add to have happened, and the whole\n   * thing is a function of `t`.\n   */\n  @command()\n  showSeries(args: CommandArgs<{ index: number }>): Seekable {\n    const { index = 0 } = args.data ?? {}\n    return this.revealTo(index, 1, args.duration ?? 0.35, args.easing ?? easeOut())\n  }\n\n  /**\n   * Shrink series `index`'s entry away, the gap closing behind it — the mirror\n   * of {@link showSeries}.\n   */\n  @command()\n  hideSeries(args: CommandArgs<{ index: number }>): Seekable {\n    const { index = 0 } = args.data ?? {}\n    return this.revealTo(index, 0, args.duration ?? 0.35, args.easing ?? easeOut())\n  }\n\n  /**\n   * Ramp one entry's reveal to `target`.\n   *\n   * `from` is read when the command is built, which for a driven scene is with\n   * the node in the state its own start time implies — so a hide that follows a\n   * show starts where the show left it rather than at whatever the node happens\n   * to hold now.\n   */\n  private revealTo(\n    index: number,\n    target: number,\n    duration: number,\n    easing: EasingFunction\n  ): Seekable {\n    if (this.items[index] === undefined) return hold(duration)\n    const from = this.reveal[index] ?? 0\n    return drive(duration, (t) => {\n      this.reveal[index] = from + (target - from) * easing(t)\n    })\n  }\n\n  /**\n   * Dim every entry but series `index` to {@link SPOTLIGHT_DIM} and bring that\n   * one back to full — the legend half of a chart's `spotlightSeries`. Entries\n   * stay in place; only their opacity moves, so the row doesn't reflow.\n   *\n   * Only the currently-shown entries are touched — a hidden series' entry is\n   * left as {@link hideSeries} left it.\n   */\n  @command()\n  spotlightSeries(args: CommandArgs<{ index: number }>): Seekable {\n    const { index = 0 } = args.data ?? {}\n    const duration = args.duration ?? 0.35\n    const easing = args.easing ?? easeOut()\n    // Opacity only, on entries that are already in the row — no membership\n    // changes, so unlike {@link showSeries} this is a plain function of `t`.\n    return together(\n      ...this.items\n        .map((item, i) => ({ item, i }))\n        .filter(({ i }) => this.isEnabled(i))\n        .map(({ item, i }) =>\n          item.to({ data: { opacity: i === index ? 1 : SPOTLIGHT_DIM }, duration, easing })\n        )\n    )\n  }\n}\n"]}
+{"version":3,"file":"chart-legend.js","sourceRoot":"","sources":["../../src/kit/chart-legend.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Rect,\r\n  Text,\r\n  command,\r\n  easeOut,\r\n  property,\r\n  textOps,\r\n  type CommandArgs,\r\n  type EasingFunction,\r\n  type Fill,\r\n  type MeasureContext2D,\r\n  type NodeConfig,\r\n  type RectProps,\r\n  type Size2D,\r\n  type SizeConstraints,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { drive, hold, together, type Seekable } from \"@motionscript/sdk/component\"\r\n\r\nimport {\r\n  DEFAULT_LEGEND,\r\n  SPOTLIGHT_DIM,\r\n  type ChartSeries,\r\n  type LegendConfig,\r\n} from \"./shared\"\r\n\r\nexport interface ChartLegendProps extends RectProps {\r\n  /**\r\n   * One entry per series: legend `label`, its `enabled` default, and — through\r\n   * {@link ChartLegendProps.swatches} — the colour its chip is painted. A series\r\n   * that starts enabled (the default) is added to the row up front; one that\r\n   * starts `false` is hidden until a later {@link ChartLegend.showSeries}.\r\n   */\r\n  series: ChartSeries[]\r\n  /**\r\n   * The swatch colour for each series, by index — resolved by the chart, whose\r\n   * business it is whether a series' colour comes out of a stroke palette (a\r\n   * line) or a fill palette (a bar). Shorter than the series list means the\r\n   * missing entries fall back to white.\r\n   */\r\n  swatches: Fill[]\r\n  /** Padding, caption style, gaps, and swatch geometry — see {@link LegendConfig}. */\r\n  legend: LegendConfig\r\n}\r\n\r\n/**\r\n * One legend entry. It hugs its caption and swatch; `shown` scales that width from\r\n * nothing to the whole of it.\r\n *\r\n * The width is taken from the content on every measure, at any reveal, so a frame\r\n * never depends on whether the entry was once seen fully shown. A collapse needs a\r\n * number to scale, and `\"hug\"` is not one until something measures it — this is\r\n * the something.\r\n */\r\nclass LegendEntry extends Rect {\r\n  constructor(props: NodeConfig<Rect, RectProps>, private readonly _shown: () => number) {\r\n    super(props)\r\n  }\r\n\r\n  override measure(constraints: SizeConstraints, scope: MeasureContext2D): Partial<Size2D> {\r\n    const size = super.measure(constraints, scope)\r\n    const shown = this._shown()\r\n    return shown >= 1 ? size : { ...size, width: shown * (size.width ?? 0) }\r\n  }\r\n}\r\n\r\n/**\r\n * The legend of a chart: a **horizontal-flow row of entries**, one per series, laid out\r\n * left-to-right with the theme's `itemGap`. Each entry pairs the series label\r\n * with a rounded colour swatch; only the swatch carries the series colour, the\r\n * caption reads in the legend's neutral ink.\r\n *\r\n * {@link showSeries}/{@link hideSeries} flip a series on or off — showing one\r\n * adds its entry back into the row at its stable series position and grows it\r\n * in, hiding one shrinks it away and removes it. So the row only ever holds the\r\n * currently-enabled series, in series order, and closes the gap when one leaves.\r\n *\r\n * This node *is* the row, so the parent places it (centred below the chart) and\r\n * it hugs its entries.\r\n */\r\nexport class ChartLegend extends Rect {\r\n  @property({ default: () => [] as ChartSeries[] }) declare series: ChartSeries[]\r\n  @property({ default: () => [] as Fill[] }) declare swatches: Fill[]\r\n  @property({ default: DEFAULT_LEGEND }) declare legend: LegendConfig\r\n\r\n  /** One entry per series. **Every** entry is a child — see {@link reveal}. */\r\n  private items: LegendEntry[] = []\r\n  /**\r\n   * How far each entry is shown, `0`–`1`. Drives its width, opacity and gap\r\n   * together, so `0` is an entry that takes no room and `1` is one at its\r\n   * natural size.\r\n   *\r\n   * This replaces adding and removing the entry from the row, which is what\r\n   * `showSeries`/`hideSeries` used to do. That could not be a command: a command\r\n   * is asked what it looks like at a time, and \"is this node a child\" is not a\r\n   * value a time can produce — the tree either contains it or it doesn't, and\r\n   * getting there means having run the add. Collapsed-but-present is the same\r\n   * picture reached by a route that *is* a function of `t`.\r\n   *\r\n   * One array in one slot, because the count is the series count, which is data.\r\n   * It is replaced rather than mutated: a write is a slot write, so the timeline\r\n   * sees it and restores it to the authored reveal before the command starts\r\n   * and after a seek back. The entries' props are bound to it, so writing it\r\n   * still moves the layout.\r\n   */\r\n  @property({ default: () => [] as number[] }) private declare reveal: number[]\r\n\r\n  constructor(props?: NodeConfig<ChartLegend, ChartLegendProps>) {\r\n    // `flow` after the spread, with the rest of the geometry: this class *is*\r\n    // the row, so the direction is its own answer and not the caller's. It has\r\n    // to be stated — a `Rect` given no flow lays its children out `freeform`,\r\n    // which stacks every entry on the same spot. One series looks perfect that\r\n    // way and three look like one smeared caption, so the failure only shows up\r\n    // on the charts that most need a legend.\r\n    super({\r\n      ...(props as RectProps),\r\n      flow: \"horizontal\",\r\n      align: \"center\",\r\n      width: \"hug\",\r\n      height: \"hug\",\r\n    })\r\n\r\n    // Structure is one entry per series, so it's composed here from the resolved\r\n    // props super() applied. Fixed row geometry last, so it wins over super().\r\n    this.set({ gap: this.legend.itemGap, padding: this.legend.padding })\r\n\r\n    this.reveal = this.series.map((s) => ((s.enabled ?? true) ? 1 : 0))\r\n    this.items = this.series.map((s, i) => this.buildItem(s, i))\r\n\r\n    // All of them, in series order. Order is now fixed rather than depending on\r\n    // which siblings happen to be shown, so an entry always comes back where it\r\n    // belongs and `insertionIndex` has nothing left to compute.\r\n    for (const item of this.items) this.add(item)\r\n  }\r\n\r\n  /** One entry: the series caption beside its colour swatch. */\r\n  private buildItem(series: ChartSeries, index: number): LegendEntry {\r\n    const marker = this.legend.markerStyle\r\n    const item = new LegendEntry({ flow: \"horizontal\",\r\n      gap: 12,\r\n      align: \"center\",\r\n      // Bound to the reveal, so showing and hiding is a number moving rather\r\n      // than a child arriving and leaving. The width follows it in `measure`.\r\n      width: \"hug\",\r\n      opacity: () => this.reveal[index] ?? 0,\r\n      height: \"hug\",\r\n      children: [\r\n        new Text({\r\n          ...textOps.styleProps(this.legend.textStyle),\r\n          text: series.label,\r\n        }),\r\n        new Rect({\r\n          width: marker.width,\r\n          height: marker.height,\r\n          cornerRadius: marker.borderRadius,\r\n          fill: this.swatches[index] ?? \"white\",\r\n          stroke: marker.stroke,\r\n          shadow: marker.shadow,\r\n        }),\r\n      ],\r\n    }, () => this.reveal[index] ?? 0)\r\n    // `gapScale` is a `Node` prop rather than a container one, so it is bound here\r\n    // instead of in the config. It tracks the reveal so the flanking gap closes\r\n    // with the entry rather than snapping when it reaches zero.\r\n    item.set({ gapScale: () => this.reveal[index] ?? 0 })\r\n    return item\r\n  }\r\n\r\n  /** True if series `index` is showing at all — see {@link reveal}. */\r\n  isEnabled(index: number): boolean {\r\n    return (this.reveal[index] ?? 0) > 0\r\n  }\r\n\r\n  /**\r\n   * Grow series `index`'s entry back in at its series-order position, the\r\n   * siblings sliding over to make room.\r\n   *\r\n   * A reveal tween rather than an animated `addChildAt`. The entry never left —\r\n   * see {@link reveal} — so there is no add to have happened, and the whole\r\n   * thing is a function of `t`.\r\n   */\r\n  @command()\r\n  showSeries(args: CommandArgs<{ index: number }>): Seekable {\r\n    const { index = 0 } = args.data ?? {}\r\n    return this.revealTo(index, 1, args.duration ?? 0.35, args.easing ?? easeOut())\r\n  }\r\n\r\n  /**\r\n   * Shrink series `index`'s entry away, the gap closing behind it — the mirror\r\n   * of {@link showSeries}.\r\n   */\r\n  @command()\r\n  hideSeries(args: CommandArgs<{ index: number }>): Seekable {\r\n    const { index = 0 } = args.data ?? {}\r\n    return this.revealTo(index, 0, args.duration ?? 0.35, args.easing ?? easeOut())\r\n  }\r\n\r\n  /**\r\n   * Ramp one entry's reveal to `target`.\r\n   *\r\n   * `from` is read when the command is built, which for a driven scene is with\r\n   * the node in the state its own start time implies — so a hide that follows a\r\n   * show starts where the show left it rather than at whatever the node happens\r\n   * to hold now.\r\n   */\r\n  private revealTo(\r\n    index: number,\r\n    target: number,\r\n    duration: number,\r\n    easing: EasingFunction\r\n  ): Seekable {\r\n    if (this.items[index] === undefined) return hold(duration)\r\n    const from = this.reveal[index] ?? 0\r\n    return drive(duration, (t) => {\r\n      const next = [...this.reveal]\r\n      next[index] = from + (target - from) * easing(t)\r\n      this.reveal = next\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Dim every entry but series `index` to {@link SPOTLIGHT_DIM} and bring that\r\n   * one back to full — the legend half of a chart's `spotlightSeries`. Entries\r\n   * stay in place; only their opacity moves, so the row doesn't reflow.\r\n   *\r\n   * Only the currently-shown entries are touched — a hidden series' entry is\r\n   * left as {@link hideSeries} left it.\r\n   */\r\n  @command()\r\n  spotlightSeries(args: CommandArgs<{ index: number }>): Seekable {\r\n    const { index = 0 } = args.data ?? {}\r\n    const duration = args.duration ?? 0.35\r\n    const easing = args.easing ?? easeOut()\r\n    // Opacity only, on entries that are already in the row — no membership\r\n    // changes, so unlike {@link showSeries} this is a plain function of `t`.\r\n    return together(\r\n      ...this.items\r\n        .map((item, i) => ({ item, i }))\r\n        .filter(({ i }) => this.isEnabled(i))\r\n        .map(({ item, i }) =>\r\n          item.to({ data: { opacity: i === index ? 1 : SPOTLIGHT_DIM }, duration, easing })\r\n        )\r\n    )\r\n  }\r\n}\r\n"]}

package/dist/kit/shared.d.ts

@@ -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`:
@@ -93,6 +92,20 @@ export declare function resolveAxisDomain(domain: AxisDomainConfig | undefined,
  * auto-derive mode, step at the midpoint.
  */
 export declare function lerpAxisDomain(from: AxisDomainConfig, to: AxisDomainConfig, t: number): AxisDomainConfig;
+/**
+ * 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 declare function axisTweenTarget(drawn: AxisDomainConfig, requested: AxisDomainConfig | undefined): AxisDomainConfig | undefined;
 /**
  * The low-level colour tokens the default themes are built from — a dark plot
  * panel with warm-grey axis furniture.
@@ -119,7 +132,8 @@ export declare const SPOTLIGHT_DIM = 0.2;
 /** Clamp a number into `[0, 1]` — the range every reveal signal here runs in. */
 export declare function clampUnit(value: number): number;
 /**
- * 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
@@ -241,8 +255,17 @@ export declare function resolveSeriesFill(palette: Stroke[], series: ChartSeries
  * simply the whole answer.
  */
 export declare function resolvePalettePaint(palette: Fill[], override: Fill | undefined, index: number): Fill;
-/** Format a marker value: integers plain, otherwise trimmed to one decimal. */
-export declare function formatMarker(value: number): string;
+/**
+ * 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 declare function formatMarker(value: number, step?: number): string;
+/** The gap between neighbouring tick values, or `undefined` for fewer than two distinct ones. */
+export declare function markerStep(markers: readonly number[]): number | undefined;
 /** Format a fraction in `[0, 1]` as a percentage: integers plain, else one decimal. */
 export declare function formatPercent(fraction: number): string;
 /** `markerCount` evenly-spaced tick values across `[min, max]`, ends inclusive. */

package/dist/kit/shared.d.ts.map

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

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`:
@@ -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) {