@voila.dev/chart 4.0.0

package/dist/core/marks/stats/waffle.js

@@ -0,0 +1,117 @@
+import {
+  channelLabel,
+  isPlaceable,
+  numericValue,
+  readChannel
+} from "../../channel.js";
+import {
+  colorChannel,
+  markId,
+  paint,
+  seriesResolver
+} from "../shared.js";
+import { categoryKey } from "../../scales/discrete.js";
+const DEFAULT_COLUMNS = 10;
+const CELL_GAP = 1.5;
+function waffleY(data, options) {
+  const xs = readChannel(data, options.x);
+  const values = readChannel(data, options.y).map(numericValue);
+  const colors = colorChannel(data, options);
+  const unit = options.unit ?? 1;
+  const columns = options.columns ?? DEFAULT_COLUMNS;
+  const totals = /* @__PURE__ */ new Map();
+  const offsets = xs.map((x, index) => {
+    if (!isPlaceable(x)) return 0;
+    const key = categoryKey(x);
+    const before = totals.get(key) ?? 0;
+    totals.set(
+      key,
+      before + Math.max(0, Math.round((values[index] ?? 0) / unit))
+    );
+    return before;
+  });
+  const tallest = Math.max(0, ...totals.values());
+  return {
+    id: options.id,
+    coordinate: "cartesian",
+    focusOrder: "x",
+    channels: {
+      x: {
+        values: xs.filter(isPlaceable),
+        discrete: "band",
+        label: channelLabel(options.x)
+      },
+      y: {
+        values: [0, Math.ceil(tallest / columns) * columns * unit],
+        includeZero: true,
+        label: channelLabel(options.y) ?? options.label
+      },
+      color: colors.channel
+    },
+    render(context) {
+      const id = markId(options.id, "waffleY", context);
+      const { x: xScale, y: yScale } = context.scales;
+      if (xScale === void 0 || yScale === void 0) {
+        return { nodes: [] };
+      }
+      const seriesOf = seriesResolver(
+        colors.values,
+        { ...options, fixedColor: options.fill },
+        id,
+        context
+      );
+      const cellWidth = xScale.bandwidth / columns;
+      const rowHeight = Math.abs(yScale.map(columns * unit) - yScale.map(0));
+      const nodes = [];
+      const points = [];
+      for (const [index, x] of xs.entries()) {
+        const value = values[index];
+        if (!isPlaceable(x) || value === void 0) continue;
+        const series = seriesOf(index);
+        const cells = Math.max(0, Math.round(value / unit));
+        let top = Number.POSITIVE_INFINITY;
+        for (let cell = 0; cell < cells; cell += 1) {
+          const position = offsets[index] + cell;
+          const column = position % columns;
+          const row = Math.floor(position / columns);
+          const y = yScale.map((row + 1) * columns * unit);
+          top = Math.min(top, y);
+          nodes.push({
+            kind: "rect",
+            key: `${id}:${index}:${cell}`,
+            series: series.key,
+            role: "mark",
+            x: xScale.map(x) + column * cellWidth + CELL_GAP / 2,
+            y: y + CELL_GAP / 2,
+            width: Math.max(0, cellWidth - CELL_GAP),
+            height: Math.max(0, rowHeight - CELL_GAP),
+            corners: [1.5, 1.5, 1.5, 1.5],
+            paint: paint({ fill: series.color, opacity: options.opacity })
+          });
+        }
+        if (options.tip !== false) {
+          points.push({
+            key: `${id}:${index}`,
+            markId: id,
+            index,
+            datum: data[index],
+            x: xScale.center(x),
+            y: Number.isFinite(top) ? top : yScale.map(0),
+            xValue: x,
+            yValue: value,
+            series: series.key,
+            seriesLabel: series.label,
+            color: series.color,
+            title: context.formatX(x),
+            value: context.formatY(value)
+          });
+        }
+      }
+      return { nodes, points };
+    }
+  };
+}
+export {
+  waffleY
+};
+//# sourceMappingURL=waffle.js.map

package/dist/core/marks/stats/waffle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/marks/stats/waffle.ts"],
+  "sourcesContent": ["import {\n\tchannelLabel,\n\tisPlaceable,\n\tnumericValue,\n\treadChannel,\n} from \"#/core/channel.ts\";\nimport {\n\ttype ChartMarkOptions,\n\tcolorChannel,\n\tmarkId,\n\tpaint,\n\tseriesResolver,\n} from \"#/core/marks/shared.ts\";\nimport { categoryKey } from \"#/core/scales/discrete.ts\";\nimport type {\n\tChartAccessor,\n\tChartMark,\n\tChartPoint,\n\tChartValue,\n\tSceneNode,\n} from \"#/core/types.ts\";\n\nexport interface WaffleOptions<TDatum> extends ChartMarkOptions<TDatum> {\n\treadonly x: ChartAccessor<TDatum, ChartValue>;\n\treadonly y: ChartAccessor<TDatum, ChartValue>;\n\t/** What one cell stands for. */\n\treadonly unit?: number;\n\t/** Cells across a band. */\n\treadonly columns?: number;\n\treadonly fill?: string;\n}\n\nconst DEFAULT_COLUMNS = 10;\nconst CELL_GAP = 1.5;\n\n/**\n * Bars made of countable cells: \"12 missions\" reads as twelve squares. A\n * row of `columns` cells is `columns \u00D7 unit` on the y axis, so the waffle\n * still reads against it; series continue one another inside a column.\n */\nexport function waffleY<TDatum>(\n\tdata: ReadonlyArray<TDatum>,\n\toptions: WaffleOptions<TDatum>,\n): ChartMark {\n\tconst xs = readChannel(data, options.x);\n\tconst values = readChannel(data, options.y).map(numericValue);\n\tconst colors = colorChannel(data, options);\n\tconst unit = options.unit ?? 1;\n\tconst columns = options.columns ?? DEFAULT_COLUMNS;\n\tconst totals = new Map<string, number>();\n\tconst offsets = xs.map((x, index) => {\n\t\tif (!isPlaceable(x)) return 0;\n\t\tconst key = categoryKey(x);\n\t\tconst before = totals.get(key) ?? 0;\n\t\ttotals.set(\n\t\t\tkey,\n\t\t\tbefore + Math.max(0, Math.round((values[index] ?? 0) / unit)),\n\t\t);\n\t\treturn before;\n\t});\n\tconst tallest = Math.max(0, ...totals.values());\n\treturn {\n\t\tid: options.id,\n\t\tcoordinate: \"cartesian\",\n\t\tfocusOrder: \"x\",\n\t\tchannels: {\n\t\t\tx: {\n\t\t\t\tvalues: xs.filter(isPlaceable),\n\t\t\t\tdiscrete: \"band\",\n\t\t\t\tlabel: channelLabel(options.x),\n\t\t\t},\n\t\t\ty: {\n\t\t\t\tvalues: [0, Math.ceil(tallest / columns) * columns * unit],\n\t\t\t\tincludeZero: true,\n\t\t\t\tlabel: channelLabel(options.y) ?? options.label,\n\t\t\t},\n\t\t\tcolor: colors.channel,\n\t\t},\n\t\trender(context) {\n\t\t\tconst id = markId(options.id, \"waffleY\", context);\n\t\t\tconst { x: xScale, y: yScale } = context.scales;\n\t\t\tif (xScale === undefined || yScale === undefined) {\n\t\t\t\treturn { nodes: [] };\n\t\t\t}\n\t\t\tconst seriesOf = seriesResolver(\n\t\t\t\tcolors.values,\n\t\t\t\t{ ...options, fixedColor: options.fill },\n\t\t\t\tid,\n\t\t\t\tcontext,\n\t\t\t);\n\t\t\tconst cellWidth = xScale.bandwidth / columns;\n\t\t\tconst rowHeight = Math.abs(yScale.map(columns * unit) - yScale.map(0));\n\t\t\tconst nodes: SceneNode[] = [];\n\t\t\tconst points: ChartPoint[] = [];\n\t\t\tfor (const [index, x] of xs.entries()) {\n\t\t\t\tconst value = values[index];\n\t\t\t\tif (!isPlaceable(x) || value === undefined) continue;\n\t\t\t\tconst series = seriesOf(index);\n\t\t\t\tconst cells = Math.max(0, Math.round(value / unit));\n\t\t\t\tlet top = Number.POSITIVE_INFINITY;\n\t\t\t\tfor (let cell = 0; cell < cells; cell += 1) {\n\t\t\t\t\tconst position = offsets[index] + cell;\n\t\t\t\t\tconst column = position % columns;\n\t\t\t\t\tconst row = Math.floor(position / columns);\n\t\t\t\t\tconst y = yScale.map((row + 1) * columns * unit);\n\t\t\t\t\ttop = Math.min(top, y);\n\t\t\t\t\tnodes.push({\n\t\t\t\t\t\tkind: \"rect\",\n\t\t\t\t\t\tkey: `${id}:${index}:${cell}`,\n\t\t\t\t\t\tseries: series.key,\n\t\t\t\t\t\trole: \"mark\",\n\t\t\t\t\t\tx: xScale.map(x) + column * cellWidth + CELL_GAP / 2,\n\t\t\t\t\t\ty: y + CELL_GAP / 2,\n\t\t\t\t\t\twidth: Math.max(0, cellWidth - CELL_GAP),\n\t\t\t\t\t\theight: Math.max(0, rowHeight - CELL_GAP),\n\t\t\t\t\t\tcorners: [1.5, 1.5, 1.5, 1.5],\n\t\t\t\t\t\tpaint: paint({ fill: series.color, opacity: options.opacity }),\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (options.tip !== false) {\n\t\t\t\t\tpoints.push({\n\t\t\t\t\t\tkey: `${id}:${index}`,\n\t\t\t\t\t\tmarkId: id,\n\t\t\t\t\t\tindex,\n\t\t\t\t\t\tdatum: data[index],\n\t\t\t\t\t\tx: xScale.center(x),\n\t\t\t\t\t\ty: Number.isFinite(top) ? top : yScale.map(0),\n\t\t\t\t\t\txValue: x,\n\t\t\t\t\t\tyValue: value,\n\t\t\t\t\t\tseries: series.key,\n\t\t\t\t\t\tseriesLabel: series.label,\n\t\t\t\t\t\tcolor: series.color,\n\t\t\t\t\t\ttitle: context.formatX(x),\n\t\t\t\t\t\tvalue: context.formatY(value),\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn { nodes, points };\n\t\t},\n\t};\n}\n"],
+  "mappings": "AAAA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACM;AACP;AAAA,EAEC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACM;AACP,SAAS,mBAAmB;AAmB5B,MAAM,kBAAkB;AACxB,MAAM,WAAW;AAOV,SAAS,QACf,MACA,SACY;AACZ,QAAM,KAAK,YAAY,MAAM,QAAQ,CAAC;AACtC,QAAM,SAAS,YAAY,MAAM,QAAQ,CAAC,EAAE,IAAI,YAAY;AAC5D,QAAM,SAAS,aAAa,MAAM,OAAO;AACzC,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,SAAS,oBAAI,IAAoB;AACvC,QAAM,UAAU,GAAG,IAAI,CAAC,GAAG,UAAU;AACpC,QAAI,CAAC,YAAY,CAAC,EAAG,QAAO;AAC5B,UAAM,MAAM,YAAY,CAAC;AACzB,UAAM,SAAS,OAAO,IAAI,GAAG,KAAK;AAClC,WAAO;AAAA,MACN;AAAA,MACA,SAAS,KAAK,IAAI,GAAG,KAAK,OAAO,OAAO,KAAK,KAAK,KAAK,IAAI,CAAC;AAAA,IAC7D;AACA,WAAO;AAAA,EACR,CAAC;AACD,QAAM,UAAU,KAAK,IAAI,GAAG,GAAG,OAAO,OAAO,CAAC;AAC9C,SAAO;AAAA,IACN,IAAI,QAAQ;AAAA,IACZ,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,UAAU;AAAA,MACT,GAAG;AAAA,QACF,QAAQ,GAAG,OAAO,WAAW;AAAA,QAC7B,UAAU;AAAA,QACV,OAAO,aAAa,QAAQ,CAAC;AAAA,MAC9B;AAAA,MACA,GAAG;AAAA,QACF,QAAQ,CAAC,GAAG,KAAK,KAAK,UAAU,OAAO,IAAI,UAAU,IAAI;AAAA,QACzD,aAAa;AAAA,QACb,OAAO,aAAa,QAAQ,CAAC,KAAK,QAAQ;AAAA,MAC3C;AAAA,MACA,OAAO,OAAO;AAAA,IACf;AAAA,IACA,OAAO,SAAS;AACf,YAAM,KAAK,OAAO,QAAQ,IAAI,WAAW,OAAO;AAChD,YAAM,EAAE,GAAG,QAAQ,GAAG,OAAO,IAAI,QAAQ;AACzC,UAAI,WAAW,UAAa,WAAW,QAAW;AACjD,eAAO,EAAE,OAAO,CAAC,EAAE;AAAA,MACpB;AACA,YAAM,WAAW;AAAA,QAChB,OAAO;AAAA,QACP,EAAE,GAAG,SAAS,YAAY,QAAQ,KAAK;AAAA,QACvC;AAAA,QACA;AAAA,MACD;AACA,YAAM,YAAY,OAAO,YAAY;AACrC,YAAM,YAAY,KAAK,IAAI,OAAO,IAAI,UAAU,IAAI,IAAI,OAAO,IAAI,CAAC,CAAC;AACrE,YAAM,QAAqB,CAAC;AAC5B,YAAM,SAAuB,CAAC;AAC9B,iBAAW,CAAC,OAAO,CAAC,KAAK,GAAG,QAAQ,GAAG;AACtC,cAAM,QAAQ,OAAO,KAAK;AAC1B,YAAI,CAAC,YAAY,CAAC,KAAK,UAAU,OAAW;AAC5C,cAAM,SAAS,SAAS,KAAK;AAC7B,cAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,MAAM,QAAQ,IAAI,CAAC;AAClD,YAAI,MAAM,OAAO;AACjB,iBAAS,OAAO,GAAG,OAAO,OAAO,QAAQ,GAAG;AAC3C,gBAAM,WAAW,QAAQ,KAAK,IAAI;AAClC,gBAAM,SAAS,WAAW;AAC1B,gBAAM,MAAM,KAAK,MAAM,WAAW,OAAO;AACzC,gBAAM,IAAI,OAAO,KAAK,MAAM,KAAK,UAAU,IAAI;AAC/C,gBAAM,KAAK,IAAI,KAAK,CAAC;AACrB,gBAAM,KAAK;AAAA,YACV,MAAM;AAAA,YACN,KAAK,GAAG,EAAE,IAAI,KAAK,IAAI,IAAI;AAAA,YAC3B,QAAQ,OAAO;AAAA,YACf,MAAM;AAAA,YACN,GAAG,OAAO,IAAI,CAAC,IAAI,SAAS,YAAY,WAAW;AAAA,YACnD,GAAG,IAAI,WAAW;AAAA,YAClB,OAAO,KAAK,IAAI,GAAG,YAAY,QAAQ;AAAA,YACvC,QAAQ,KAAK,IAAI,GAAG,YAAY,QAAQ;AAAA,YACxC,SAAS,CAAC,KAAK,KAAK,KAAK,GAAG;AAAA,YAC5B,OAAO,MAAM,EAAE,MAAM,OAAO,OAAO,SAAS,QAAQ,QAAQ,CAAC;AAAA,UAC9D,CAAC;AAAA,QACF;AACA,YAAI,QAAQ,QAAQ,OAAO;AAC1B,iBAAO,KAAK;AAAA,YACX,KAAK,GAAG,EAAE,IAAI,KAAK;AAAA,YACnB,QAAQ;AAAA,YACR;AAAA,YACA,OAAO,KAAK,KAAK;AAAA,YACjB,GAAG,OAAO,OAAO,CAAC;AAAA,YAClB,GAAG,OAAO,SAAS,GAAG,IAAI,MAAM,OAAO,IAAI,CAAC;AAAA,YAC5C,QAAQ;AAAA,YACR,QAAQ;AAAA,YACR,QAAQ,OAAO;AAAA,YACf,aAAa,OAAO;AAAA,YACpB,OAAO,OAAO;AAAA,YACd,OAAO,QAAQ,QAAQ,CAAC;AAAA,YACxB,OAAO,QAAQ,QAAQ,KAAK;AAAA,UAC7B,CAAC;AAAA,QACF;AAAA,MACD;AACA,aAAO,EAAE,OAAO,OAAO;AAAA,IACxB;AAAA,EACD;AACD;",
+  "names": []
+}

package/dist/core/marks/text.d.ts

@@ -0,0 +1,19 @@
+import type { ChartAccessor, ChartMark, ChartTextPaint, ChartValue } from "../types.js";
+export interface TextOptions<TDatum> {
+    readonly id?: string;
+    readonly x?: ChartAccessor<TDatum, ChartValue>;
+    readonly y?: ChartAccessor<TDatum, ChartValue>;
+    readonly text: ChartAccessor<TDatum, unknown>;
+    /** Pixel offsets from the anchor. */
+    readonly dx?: number;
+    readonly dy?: number;
+    readonly fill?: string;
+    readonly fontSize?: number;
+    readonly fontWeight?: number;
+    readonly textAnchor?: ChartTextPaint["textAnchor"];
+    readonly baseline?: ChartTextPaint["baseline"];
+    readonly opacity?: number;
+}
+/** A label per datum: values on bars, names on points, annotations. */
+export declare function text<TDatum>(data: ReadonlyArray<TDatum>, options: TextOptions<TDatum>): ChartMark;
+//# sourceMappingURL=text.d.ts.map

package/dist/core/marks/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/core/marks/text.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,aAAa,EACb,SAAS,EACT,cAAc,EACd,UAAU,EAEV,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,WAAW,CAAC,MAAM;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/C,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,uEAAuE;AACvE,wBAAgB,IAAI,CAAC,MAAM,EAC1B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC1B,SAAS,CAkEX"}

package/dist/core/marks/text.js

@@ -0,0 +1,60 @@
+import { channelLabel, isPlaceable, readChannel } from "../channel.js";
+import { markId, paint, valueOn } from "./shared.js";
+function text(data, options) {
+  const xs = readChannel(data, options.x);
+  const ys = readChannel(data, options.y);
+  const texts = readChannel(data, options.text);
+  return {
+    id: options.id,
+    coordinate: "cartesian",
+    channels: {
+      ...options.x === void 0 ? {} : {
+        x: {
+          values: xs.filter(isPlaceable),
+          label: channelLabel(options.x)
+        }
+      },
+      ...options.y === void 0 ? {} : {
+        y: {
+          values: ys.filter(isPlaceable),
+          label: channelLabel(options.y)
+        }
+      }
+    },
+    render(context) {
+      const id = markId(options.id, "text", context);
+      const { scales, plot, theme } = context;
+      const nodes = [];
+      for (const [index, content] of texts.entries()) {
+        const xValue = scales.x && valueOn(scales.x, xs[index]);
+        const yValue = scales.y && valueOn(scales.y, ys[index]);
+        const x = scales.x && xValue !== void 0 ? scales.x.center(xValue) : plot.x + plot.width / 2;
+        const y = scales.y && yValue !== void 0 ? scales.y.center(yValue) : plot.y + plot.height / 2;
+        if (content === void 0 || content === null || content === "") {
+          continue;
+        }
+        nodes.push({
+          kind: "text",
+          key: `${id}:${index}`,
+          role: "label",
+          x: x + (options.dx ?? 0),
+          y: y + (options.dy ?? 0),
+          text: typeof content === "number" ? context.formatY(content) : String(content),
+          paint: paint({
+            fill: options.fill ?? theme.foreground,
+            opacity: options.opacity,
+            fontSize: options.fontSize ?? theme.fontSize,
+            fontWeight: options.fontWeight,
+            textAnchor: options.textAnchor ?? "middle",
+            baseline: options.baseline ?? "middle"
+          })
+        });
+      }
+      return { nodes };
+    }
+  };
+}
+export {
+  text
+};
+//# sourceMappingURL=text.js.map

package/dist/core/marks/text.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/marks/text.ts"],
+  "sourcesContent": ["import { channelLabel, isPlaceable, readChannel } from \"#/core/channel.ts\";\nimport { markId, paint, valueOn } from \"#/core/marks/shared.ts\";\nimport type {\n\tChartAccessor,\n\tChartMark,\n\tChartTextPaint,\n\tChartValue,\n\tSceneNode,\n} from \"#/core/types.ts\";\n\nexport interface TextOptions<TDatum> {\n\treadonly id?: string;\n\treadonly x?: ChartAccessor<TDatum, ChartValue>;\n\treadonly y?: ChartAccessor<TDatum, ChartValue>;\n\treadonly text: ChartAccessor<TDatum, unknown>;\n\t/** Pixel offsets from the anchor. */\n\treadonly dx?: number;\n\treadonly dy?: number;\n\treadonly fill?: string;\n\treadonly fontSize?: number;\n\treadonly fontWeight?: number;\n\treadonly textAnchor?: ChartTextPaint[\"textAnchor\"];\n\treadonly baseline?: ChartTextPaint[\"baseline\"];\n\treadonly opacity?: number;\n}\n\n/** A label per datum: values on bars, names on points, annotations. */\nexport function text<TDatum>(\n\tdata: ReadonlyArray<TDatum>,\n\toptions: TextOptions<TDatum>,\n): ChartMark {\n\tconst xs = readChannel(data, options.x);\n\tconst ys = readChannel(data, options.y);\n\tconst texts = readChannel(data, options.text);\n\treturn {\n\t\tid: options.id,\n\t\tcoordinate: \"cartesian\",\n\t\tchannels: {\n\t\t\t...(options.x === undefined\n\t\t\t\t? {}\n\t\t\t\t: {\n\t\t\t\t\t\tx: {\n\t\t\t\t\t\t\tvalues: xs.filter(isPlaceable),\n\t\t\t\t\t\t\tlabel: channelLabel(options.x),\n\t\t\t\t\t\t},\n\t\t\t\t\t}),\n\t\t\t...(options.y === undefined\n\t\t\t\t? {}\n\t\t\t\t: {\n\t\t\t\t\t\ty: {\n\t\t\t\t\t\t\tvalues: ys.filter(isPlaceable),\n\t\t\t\t\t\t\tlabel: channelLabel(options.y),\n\t\t\t\t\t\t},\n\t\t\t\t\t}),\n\t\t},\n\t\trender(context) {\n\t\t\tconst id = markId(options.id, \"text\", context);\n\t\t\tconst { scales, plot, theme } = context;\n\t\t\tconst nodes: SceneNode[] = [];\n\t\t\tfor (const [index, content] of texts.entries()) {\n\t\t\t\tconst xValue = scales.x && valueOn(scales.x, xs[index]);\n\t\t\t\tconst yValue = scales.y && valueOn(scales.y, ys[index]);\n\t\t\t\tconst x =\n\t\t\t\t\tscales.x && xValue !== undefined\n\t\t\t\t\t\t? scales.x.center(xValue)\n\t\t\t\t\t\t: plot.x + plot.width / 2;\n\t\t\t\tconst y =\n\t\t\t\t\tscales.y && yValue !== undefined\n\t\t\t\t\t\t? scales.y.center(yValue)\n\t\t\t\t\t\t: plot.y + plot.height / 2;\n\t\t\t\tif (content === undefined || content === null || content === \"\") {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tnodes.push({\n\t\t\t\t\tkind: \"text\",\n\t\t\t\t\tkey: `${id}:${index}`,\n\t\t\t\t\trole: \"label\",\n\t\t\t\t\tx: x + (options.dx ?? 0),\n\t\t\t\t\ty: y + (options.dy ?? 0),\n\t\t\t\t\ttext:\n\t\t\t\t\t\ttypeof content === \"number\"\n\t\t\t\t\t\t\t? context.formatY(content)\n\t\t\t\t\t\t\t: String(content),\n\t\t\t\t\tpaint: paint({\n\t\t\t\t\t\tfill: options.fill ?? theme.foreground,\n\t\t\t\t\t\topacity: options.opacity,\n\t\t\t\t\t\tfontSize: options.fontSize ?? theme.fontSize,\n\t\t\t\t\t\tfontWeight: options.fontWeight,\n\t\t\t\t\t\ttextAnchor: options.textAnchor ?? \"middle\",\n\t\t\t\t\t\tbaseline: options.baseline ?? \"middle\",\n\t\t\t\t\t}),\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn { nodes };\n\t\t},\n\t};\n}\n"],
+  "mappings": "AAAA,SAAS,cAAc,aAAa,mBAAmB;AACvD,SAAS,QAAQ,OAAO,eAAe;AA0BhC,SAAS,KACf,MACA,SACY;AACZ,QAAM,KAAK,YAAY,MAAM,QAAQ,CAAC;AACtC,QAAM,KAAK,YAAY,MAAM,QAAQ,CAAC;AACtC,QAAM,QAAQ,YAAY,MAAM,QAAQ,IAAI;AAC5C,SAAO;AAAA,IACN,IAAI,QAAQ;AAAA,IACZ,YAAY;AAAA,IACZ,UAAU;AAAA,MACT,GAAI,QAAQ,MAAM,SACf,CAAC,IACD;AAAA,QACA,GAAG;AAAA,UACF,QAAQ,GAAG,OAAO,WAAW;AAAA,UAC7B,OAAO,aAAa,QAAQ,CAAC;AAAA,QAC9B;AAAA,MACD;AAAA,MACF,GAAI,QAAQ,MAAM,SACf,CAAC,IACD;AAAA,QACA,GAAG;AAAA,UACF,QAAQ,GAAG,OAAO,WAAW;AAAA,UAC7B,OAAO,aAAa,QAAQ,CAAC;AAAA,QAC9B;AAAA,MACD;AAAA,IACH;AAAA,IACA,OAAO,SAAS;AACf,YAAM,KAAK,OAAO,QAAQ,IAAI,QAAQ,OAAO;AAC7C,YAAM,EAAE,QAAQ,MAAM,MAAM,IAAI;AAChC,YAAM,QAAqB,CAAC;AAC5B,iBAAW,CAAC,OAAO,OAAO,KAAK,MAAM,QAAQ,GAAG;AAC/C,cAAM,SAAS,OAAO,KAAK,QAAQ,OAAO,GAAG,GAAG,KAAK,CAAC;AACtD,cAAM,SAAS,OAAO,KAAK,QAAQ,OAAO,GAAG,GAAG,KAAK,CAAC;AACtD,cAAM,IACL,OAAO,KAAK,WAAW,SACpB,OAAO,EAAE,OAAO,MAAM,IACtB,KAAK,IAAI,KAAK,QAAQ;AAC1B,cAAM,IACL,OAAO,KAAK,WAAW,SACpB,OAAO,EAAE,OAAO,MAAM,IACtB,KAAK,IAAI,KAAK,SAAS;AAC3B,YAAI,YAAY,UAAa,YAAY,QAAQ,YAAY,IAAI;AAChE;AAAA,QACD;AACA,cAAM,KAAK;AAAA,UACV,MAAM;AAAA,UACN,KAAK,GAAG,EAAE,IAAI,KAAK;AAAA,UACnB,MAAM;AAAA,UACN,GAAG,KAAK,QAAQ,MAAM;AAAA,UACtB,GAAG,KAAK,QAAQ,MAAM;AAAA,UACtB,MACC,OAAO,YAAY,WAChB,QAAQ,QAAQ,OAAO,IACvB,OAAO,OAAO;AAAA,UAClB,OAAO,MAAM;AAAA,YACZ,MAAM,QAAQ,QAAQ,MAAM;AAAA,YAC5B,SAAS,QAAQ;AAAA,YACjB,UAAU,QAAQ,YAAY,MAAM;AAAA,YACpC,YAAY,QAAQ;AAAA,YACpB,YAAY,QAAQ,cAAc;AAAA,YAClC,UAAU,QAAQ,YAAY;AAAA,UAC/B,CAAC;AAAA,QACF,CAAC;AAAA,MACF;AACA,aAAO,EAAE,MAAM;AAAA,IAChB;AAAA,EACD;AACD;",
+  "names": []
+}

package/dist/core/motion/tween.d.ts

@@ -0,0 +1,6 @@
+import type { ChartScene } from "../types.js";
+/** `to`, `t` of the way from `from` (0 is `from`, 1 is `to`). */
+export declare function tweenScene(from: ChartScene, to: ChartScene, t: number): ChartScene;
+/** Fast out, slow in: the motion settles rather than stops. */
+export declare function easeOutCubic(t: number): number;
+//# sourceMappingURL=tween.d.ts.map

package/dist/core/motion/tween.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.d.ts","sourceRoot":"","sources":["../../../src/core/motion/tween.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,UAAU,EAAa,MAAM,iBAAiB,CAAC;AA+GzE,iEAAiE;AACjE,wBAAgB,UAAU,CACzB,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,EACd,CAAC,EAAE,MAAM,GACP,UAAU,CASZ;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/core/motion/tween.js

@@ -0,0 +1,98 @@
+const NUMBER = /-?\d*\.?\d+(?:e[-+]?\d+)?/gi;
+function mix(from, to, t) {
+  return from + (to - from) * t;
+}
+function tweenPath(from, to, t) {
+  const fromNumbers = from.match(NUMBER);
+  const toNumbers = to.match(NUMBER);
+  if (fromNumbers === null || toNumbers === null || fromNumbers.length !== toNumbers.length || from.replace(NUMBER, "#") !== to.replace(NUMBER, "#")) {
+    return t < 1 ? from : to;
+  }
+  let index = 0;
+  return to.replace(NUMBER, () => {
+    const value = mix(Number(fromNumbers[index]), Number(toNumbers[index]), t);
+    index += 1;
+    return String(Math.round(value * 100) / 100);
+  });
+}
+function fadeIn(paint, t) {
+  return { ...paint, opacity: (paint.opacity ?? 1) * t };
+}
+function tweenNode(from, to, t) {
+  if (from === void 0 || from.kind !== to.kind) {
+    return to.kind === "group" ? {
+      ...to,
+      children: to.children.map((child) => tweenNode(void 0, child, t))
+    } : { ...to, paint: fadeIn(to.paint, t) };
+  }
+  switch (to.kind) {
+    case "group": {
+      const before = new Map(
+        from.children.map((child) => [child.key, child])
+      );
+      return {
+        ...to,
+        children: to.children.map(
+          (child) => tweenNode(before.get(child.key), child, t)
+        )
+      };
+    }
+    case "rect": {
+      const previous = from;
+      return {
+        ...to,
+        x: mix(previous.x, to.x, t),
+        y: mix(previous.y, to.y, t),
+        width: mix(previous.width, to.width, t),
+        height: mix(previous.height, to.height, t)
+      };
+    }
+    case "circle": {
+      const previous = from;
+      return {
+        ...to,
+        cx: mix(previous.cx, to.cx, t),
+        cy: mix(previous.cy, to.cy, t),
+        r: mix(previous.r, to.r, t)
+      };
+    }
+    case "line": {
+      const previous = from;
+      return {
+        ...to,
+        x1: mix(previous.x1, to.x1, t),
+        y1: mix(previous.y1, to.y1, t),
+        x2: mix(previous.x2, to.x2, t),
+        y2: mix(previous.y2, to.y2, t)
+      };
+    }
+    case "text": {
+      const previous = from;
+      return {
+        ...to,
+        x: mix(previous.x, to.x, t),
+        y: mix(previous.y, to.y, t)
+      };
+    }
+    case "path":
+      return { ...to, d: tweenPath(from.d, to.d, t) };
+  }
+}
+function tweenScene(from, to, t) {
+  if (t >= 1) {
+    return to;
+  }
+  const before = new Map(from.nodes.map((node) => [node.key, node]));
+  return {
+    ...to,
+    nodes: to.nodes.map((node) => tweenNode(before.get(node.key), node, t))
+  };
+}
+function easeOutCubic(t) {
+  return 1 - (1 - t) ** 3;
+}
+export {
+  easeOutCubic,
+  tweenScene
+};
+//# sourceMappingURL=tween.js.map

package/dist/core/motion/tween.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/motion/tween.ts"],
+  "sourcesContent": ["import type { ChartPaint, ChartScene, SceneNode } from \"#/core/types.ts\";\n\n/**\n * A scene part of the way from one scene to the next, keyed by node: what an\n * animated update draws on each frame. It lives in the core so the SVG and\n * Canvas renderers animate identically, and never feeds hit-testing or\n * focus: those always read the scene being animated towards.\n *\n * A node present on both sides moves; a new one fades in; one that left is\n * gone at once (fading out a bar the data no longer has would show a value\n * that is not true any more). A path tweens point by point when both shapes\n * share their commands, and swaps at the end when they do not.\n */\n\nconst NUMBER = /-?\\d*\\.?\\d+(?:e[-+]?\\d+)?/gi;\n\nfunction mix(from: number, to: number, t: number): number {\n\treturn from + (to - from) * t;\n}\n\n/** Two paths can tween when only their numbers differ. */\nfunction tweenPath(from: string, to: string, t: number): string {\n\tconst fromNumbers = from.match(NUMBER);\n\tconst toNumbers = to.match(NUMBER);\n\tif (\n\t\tfromNumbers === null ||\n\t\ttoNumbers === null ||\n\t\tfromNumbers.length !== toNumbers.length ||\n\t\tfrom.replace(NUMBER, \"#\") !== to.replace(NUMBER, \"#\")\n\t) {\n\t\treturn t < 1 ? from : to;\n\t}\n\tlet index = 0;\n\treturn to.replace(NUMBER, () => {\n\t\tconst value = mix(Number(fromNumbers[index]), Number(toNumbers[index]), t);\n\t\tindex += 1;\n\t\treturn String(Math.round(value * 100) / 100);\n\t});\n}\n\nfunction fadeIn<TPaint extends ChartPaint>(paint: TPaint, t: number): TPaint {\n\treturn { ...paint, opacity: (paint.opacity ?? 1) * t };\n}\n\nfunction tweenNode(\n\tfrom: SceneNode | undefined,\n\tto: SceneNode,\n\tt: number,\n): SceneNode {\n\tif (from === undefined || from.kind !== to.kind) {\n\t\treturn to.kind === \"group\"\n\t\t\t? {\n\t\t\t\t\t...to,\n\t\t\t\t\tchildren: to.children.map((child) => tweenNode(undefined, child, t)),\n\t\t\t\t}\n\t\t\t: { ...to, paint: fadeIn(to.paint, t) };\n\t}\n\tswitch (to.kind) {\n\t\tcase \"group\": {\n\t\t\tconst before = new Map(\n\t\t\t\t(from as typeof to).children.map((child) => [child.key, child]),\n\t\t\t);\n\t\t\treturn {\n\t\t\t\t...to,\n\t\t\t\tchildren: to.children.map((child) =>\n\t\t\t\t\ttweenNode(before.get(child.key), child, t),\n\t\t\t\t),\n\t\t\t};\n\t\t}\n\t\tcase \"rect\": {\n\t\t\tconst previous = from as typeof to;\n\t\t\treturn {\n\t\t\t\t...to,\n\t\t\t\tx: mix(previous.x, to.x, t),\n\t\t\t\ty: mix(previous.y, to.y, t),\n\t\t\t\twidth: mix(previous.width, to.width, t),\n\t\t\t\theight: mix(previous.height, to.height, t),\n\t\t\t};\n\t\t}\n\t\tcase \"circle\": {\n\t\t\tconst previous = from as typeof to;\n\t\t\treturn {\n\t\t\t\t...to,\n\t\t\t\tcx: mix(previous.cx, to.cx, t),\n\t\t\t\tcy: mix(previous.cy, to.cy, t),\n\t\t\t\tr: mix(previous.r, to.r, t),\n\t\t\t};\n\t\t}\n\t\tcase \"line\": {\n\t\t\tconst previous = from as typeof to;\n\t\t\treturn {\n\t\t\t\t...to,\n\t\t\t\tx1: mix(previous.x1, to.x1, t),\n\t\t\t\ty1: mix(previous.y1, to.y1, t),\n\t\t\t\tx2: mix(previous.x2, to.x2, t),\n\t\t\t\ty2: mix(previous.y2, to.y2, t),\n\t\t\t};\n\t\t}\n\t\tcase \"text\": {\n\t\t\tconst previous = from as typeof to;\n\t\t\treturn {\n\t\t\t\t...to,\n\t\t\t\tx: mix(previous.x, to.x, t),\n\t\t\t\ty: mix(previous.y, to.y, t),\n\t\t\t};\n\t\t}\n\t\tcase \"path\":\n\t\t\treturn { ...to, d: tweenPath((from as typeof to).d, to.d, t) };\n\t}\n}\n\n/** `to`, `t` of the way from `from` (0 is `from`, 1 is `to`). */\nexport function tweenScene(\n\tfrom: ChartScene,\n\tto: ChartScene,\n\tt: number,\n): ChartScene {\n\tif (t >= 1) {\n\t\treturn to;\n\t}\n\tconst before = new Map(from.nodes.map((node) => [node.key, node]));\n\treturn {\n\t\t...to,\n\t\tnodes: to.nodes.map((node) => tweenNode(before.get(node.key), node, t)),\n\t};\n}\n\n/** Fast out, slow in: the motion settles rather than stops. */\nexport function easeOutCubic(t: number): number {\n\treturn 1 - (1 - t) ** 3;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/nearest.d.ts

@@ -0,0 +1,25 @@
+import type { ChartHitShape, ChartPoint, ChartScene } from "./types.js";
+/**
+ * Focus and hit-testing, on the scene only, so SVG and Canvas behave the same.
+ * A stop is what one arrow-key press moves to: one point, or every point that
+ * shares a position (the column of a multi-series chart).
+ */
+export interface ChartFocusStop {
+    readonly key: string;
+    readonly points: ReadonlyArray<ChartPoint>;
+    /** Where the stop sits along its axis, in chart pixels. */
+    readonly at: number;
+}
+export declare function focusStops(scene: ChartScene): ReadonlyArray<ChartFocusStop>;
+export declare function contains(hit: ChartHitShape, x: number, y: number): boolean;
+export interface ChartHit {
+    readonly stop: number;
+    readonly point: number;
+}
+/**
+ * The stop and point under the pointer. Along a position axis the nearest
+ * column wins wherever the pointer is in the plot, the way a reader scrubs a
+ * time series; a scatter, pie or map needs the pointer on or near the shape.
+ */
+export declare function findNearest(scene: ChartScene, stops: ReadonlyArray<ChartFocusStop>, x: number, y: number): ChartHit | null;
+//# sourceMappingURL=nearest.d.ts.map

package/dist/core/nearest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nearest.d.ts","sourceRoot":"","sources":["../../src/core/nearest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEX,aAAa,EACb,UAAU,EACV,UAAU,EAEV,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC3C,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACpB;AAYD,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC,CAyC3E;AAQD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAqB1E;AAUD,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AA2BD;;;;GAIG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,EACpC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACP,QAAQ,GAAG,IAAI,CAuEjB"}

package/dist/core/nearest.js

@@ -0,0 +1,151 @@
+import { categoryKey } from "./scales/discrete.js";
+const POINT_REACH = 24;
+function positionOf(point, order) {
+  return order === "y" ? point.yValue : point.xValue;
+}
+function focusStops(scene) {
+  const order = scene.focusOrder;
+  if (order === "point") {
+    return scene.points.map((point) => ({
+      key: point.key,
+      points: [point],
+      at: point.x
+    }));
+  }
+  const stops = /* @__PURE__ */ new Map();
+  for (const point of scene.points) {
+    const position = positionOf(point, order);
+    const within = point.facet === void 0 ? "" : `${point.facet}|`;
+    const key = `${within}${position === void 0 ? `px:${Math.round(order === "y" ? point.y : point.x)}` : categoryKey(position)}`;
+    const stop = stops.get(key);
+    if (stop === void 0) {
+      stops.set(key, {
+        key,
+        points: [point],
+        at: order === "y" ? point.y : point.x
+      });
+    } else {
+      stop.points.push(point);
+    }
+  }
+  const cellOrder = new Map(
+    (scene.cells ?? []).map((cell, index) => [cell.key, index])
+  );
+  const cellOf = (stop) => cellOrder.get(stop.points[0].facet ?? "") ?? 0;
+  return [...stops.values()].sort(
+    (left, right) => cellOf(left) - cellOf(right) || left.at - right.at
+  );
+}
+function bearing(dx, dy) {
+  const degrees = Math.atan2(dx, -dy) * 180 / Math.PI;
+  return degrees < 0 ? degrees + 360 : degrees;
+}
+function contains(hit, x, y) {
+  if (hit.kind === "rect") {
+    const { rect } = hit;
+    return x >= rect.x && x <= rect.x + rect.width && y >= rect.y && y <= rect.y + rect.height;
+  }
+  const dx = x - hit.cx;
+  const dy = y - hit.cy;
+  const radius = Math.hypot(dx, dy);
+  if (radius < hit.innerRadius || radius > hit.outerRadius) {
+    return false;
+  }
+  const angle = bearing(dx, dy);
+  const start = (hit.startAngle % 360 + 360) % 360;
+  const sweep = hit.endAngle - hit.startAngle;
+  const offset = (angle - start + 360) % 360;
+  return sweep >= 360 || offset <= sweep;
+}
+function hitArea(hit) {
+  if (hit.kind === "rect") {
+    return hit.rect.width * hit.rect.height;
+  }
+  const sweep = Math.min(360, hit.endAngle - hit.startAngle) / 360;
+  return Math.PI * (hit.outerRadius ** 2 - hit.innerRadius ** 2) * sweep;
+}
+function pickInStop(stop, x, y, order) {
+  const inside = stop.points.findIndex(
+    (point) => point.hit !== void 0 && contains(point.hit, x, y)
+  );
+  if (inside !== -1) {
+    return inside;
+  }
+  let best = 0;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const [index, point] of stop.points.entries()) {
+    const distance = order === "y" ? Math.abs(point.x - x) : Math.abs(point.y - y);
+    if (distance < bestDistance) {
+      best = index;
+      bestDistance = distance;
+    }
+  }
+  return best;
+}
+function findNearest(scene, stops, x, y) {
+  if (stops.length === 0) {
+    return null;
+  }
+  const order = scene.focusOrder;
+  if (order === "point") {
+    let inside = -1;
+    let insideArea = Number.POSITIVE_INFINITY;
+    for (const [index, stop] of stops.entries()) {
+      const hit = stop.points[0].hit;
+      if (hit !== void 0 && contains(hit, x, y)) {
+        const area = hitArea(hit);
+        if (area < insideArea) {
+          inside = index;
+          insideArea = area;
+        }
+      }
+    }
+    if (inside !== -1) {
+      return { stop: inside, point: 0 };
+    }
+    let best2 = -1;
+    let bestDistance2 = POINT_REACH;
+    for (const [index, stop] of stops.entries()) {
+      const point = stop.points[0];
+      if (point.hit?.kind === "arc") {
+        continue;
+      }
+      const distance = Math.hypot(point.x - x, point.y - y);
+      if (distance < bestDistance2) {
+        best2 = index;
+        bestDistance2 = distance;
+      }
+    }
+    return best2 === -1 ? null : { stop: best2, point: 0 };
+  }
+  const cell = scene.cells?.find(
+    (candidate) => x >= candidate.plot.x && x <= candidate.plot.x + candidate.plot.width && y >= candidate.plot.y && y <= candidate.plot.y + candidate.plot.height
+  );
+  if (scene.cells !== void 0 && cell === void 0) {
+    return null;
+  }
+  const plot = cell?.plot ?? scene.plot;
+  if (x < plot.x || x > plot.x + plot.width || y < plot.y || y > plot.y + plot.height) {
+    return null;
+  }
+  const along = order === "y" ? y : x;
+  let best = 0;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const [index, stop] of stops.entries()) {
+    if (cell !== void 0 && stop.points[0].facet !== cell.key) {
+      continue;
+    }
+    const distance = Math.abs(stop.at - along);
+    if (distance < bestDistance) {
+      best = index;
+      bestDistance = distance;
+    }
+  }
+  return { stop: best, point: pickInStop(stops[best], x, y, order) };
+}
+export {
+  contains,
+  findNearest,
+  focusStops
+};
+//# sourceMappingURL=nearest.js.map

package/dist/core/nearest.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/nearest.ts"],
+  "sourcesContent": ["import { categoryKey } from \"#/core/scales/discrete.ts\";\nimport type {\n\tChartFocusOrder,\n\tChartHitShape,\n\tChartPoint,\n\tChartScene,\n\tChartValue,\n} from \"#/core/types.ts\";\n\n/**\n * Focus and hit-testing, on the scene only, so SVG and Canvas behave the same.\n * A stop is what one arrow-key press moves to: one point, or every point that\n * shares a position (the column of a multi-series chart).\n */\nexport interface ChartFocusStop {\n\treadonly key: string;\n\treadonly points: ReadonlyArray<ChartPoint>;\n\t/** Where the stop sits along its axis, in chart pixels. */\n\treadonly at: number;\n}\n\n/** How far from a dot the pointer may be and still hover it, in pixels. */\nconst POINT_REACH = 24;\n\nfunction positionOf(\n\tpoint: ChartPoint,\n\torder: ChartFocusOrder,\n): ChartValue | undefined {\n\treturn order === \"y\" ? point.yValue : point.xValue;\n}\n\nexport function focusStops(scene: ChartScene): ReadonlyArray<ChartFocusStop> {\n\tconst order = scene.focusOrder;\n\tif (order === \"point\") {\n\t\treturn scene.points.map((point) => ({\n\t\t\tkey: point.key,\n\t\t\tpoints: [point],\n\t\t\tat: point.x,\n\t\t}));\n\t}\n\tconst stops = new Map<\n\t\tstring,\n\t\t{ key: string; points: ChartPoint[]; at: number }\n\t>();\n\tfor (const point of scene.points) {\n\t\tconst position = positionOf(point, order);\n\t\t// On a faceted chart a column is a column of one cell, never across cells.\n\t\tconst within = point.facet === undefined ? \"\" : `${point.facet}|`;\n\t\tconst key = `${within}${\n\t\t\tposition === undefined\n\t\t\t\t? `px:${Math.round(order === \"y\" ? point.y : point.x)}`\n\t\t\t\t: categoryKey(position)\n\t\t}`;\n\t\tconst stop = stops.get(key);\n\t\tif (stop === undefined) {\n\t\t\tstops.set(key, {\n\t\t\t\tkey,\n\t\t\t\tpoints: [point],\n\t\t\t\tat: order === \"y\" ? point.y : point.x,\n\t\t\t});\n\t\t} else {\n\t\t\tstop.points.push(point);\n\t\t}\n\t}\n\tconst cellOrder = new Map(\n\t\t(scene.cells ?? []).map((cell, index) => [cell.key, index]),\n\t);\n\tconst cellOf = (stop: { points: ChartPoint[] }) =>\n\t\tcellOrder.get(stop.points[0].facet ?? \"\") ?? 0;\n\treturn [...stops.values()].sort(\n\t\t(left, right) => cellOf(left) - cellOf(right) || left.at - right.at,\n\t);\n}\n\n/** Degrees clockwise from twelve o'clock, in `[0, 360)`. */\nfunction bearing(dx: number, dy: number): number {\n\tconst degrees = (Math.atan2(dx, -dy) * 180) / Math.PI;\n\treturn degrees < 0 ? degrees + 360 : degrees;\n}\n\nexport function contains(hit: ChartHitShape, x: number, y: number): boolean {\n\tif (hit.kind === \"rect\") {\n\t\tconst { rect } = hit;\n\t\treturn (\n\t\t\tx >= rect.x &&\n\t\t\tx <= rect.x + rect.width &&\n\t\t\ty >= rect.y &&\n\t\t\ty <= rect.y + rect.height\n\t\t);\n\t}\n\tconst dx = x - hit.cx;\n\tconst dy = y - hit.cy;\n\tconst radius = Math.hypot(dx, dy);\n\tif (radius < hit.innerRadius || radius > hit.outerRadius) {\n\t\treturn false;\n\t}\n\tconst angle = bearing(dx, dy);\n\tconst start = ((hit.startAngle % 360) + 360) % 360;\n\tconst sweep = hit.endAngle - hit.startAngle;\n\tconst offset = (angle - start + 360) % 360;\n\treturn sweep >= 360 || offset <= sweep;\n}\n\nfunction hitArea(hit: ChartHitShape): number {\n\tif (hit.kind === \"rect\") {\n\t\treturn hit.rect.width * hit.rect.height;\n\t}\n\tconst sweep = Math.min(360, hit.endAngle - hit.startAngle) / 360;\n\treturn Math.PI * (hit.outerRadius ** 2 - hit.innerRadius ** 2) * sweep;\n}\n\nexport interface ChartHit {\n\treadonly stop: number;\n\treadonly point: number;\n}\n\nfunction pickInStop(\n\tstop: ChartFocusStop,\n\tx: number,\n\ty: number,\n\torder: ChartFocusOrder,\n): number {\n\tconst inside = stop.points.findIndex(\n\t\t(point) => point.hit !== undefined && contains(point.hit, x, y),\n\t);\n\tif (inside !== -1) {\n\t\treturn inside;\n\t}\n\tlet best = 0;\n\tlet bestDistance = Number.POSITIVE_INFINITY;\n\tfor (const [index, point] of stop.points.entries()) {\n\t\tconst distance =\n\t\t\torder === \"y\" ? Math.abs(point.x - x) : Math.abs(point.y - y);\n\t\tif (distance < bestDistance) {\n\t\t\tbest = index;\n\t\t\tbestDistance = distance;\n\t\t}\n\t}\n\treturn best;\n}\n\n/**\n * The stop and point under the pointer. Along a position axis the nearest\n * column wins wherever the pointer is in the plot, the way a reader scrubs a\n * time series; a scatter, pie or map needs the pointer on or near the shape.\n */\nexport function findNearest(\n\tscene: ChartScene,\n\tstops: ReadonlyArray<ChartFocusStop>,\n\tx: number,\n\ty: number,\n): ChartHit | null {\n\tif (stops.length === 0) {\n\t\treturn null;\n\t}\n\tconst order = scene.focusOrder;\n\tif (order === \"point\") {\n\t\t// Shapes can overlap (a dot over a region, regions' bounding boxes):\n\t\t// the smallest one under the pointer is the one meant.\n\t\tlet inside = -1;\n\t\tlet insideArea = Number.POSITIVE_INFINITY;\n\t\tfor (const [index, stop] of stops.entries()) {\n\t\t\tconst hit = stop.points[0].hit;\n\t\t\tif (hit !== undefined && contains(hit, x, y)) {\n\t\t\t\tconst area = hitArea(hit);\n\t\t\t\tif (area < insideArea) {\n\t\t\t\t\tinside = index;\n\t\t\t\t\tinsideArea = area;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (inside !== -1) {\n\t\t\treturn { stop: inside, point: 0 };\n\t\t}\n\t\tlet best = -1;\n\t\tlet bestDistance = POINT_REACH;\n\t\tfor (const [index, stop] of stops.entries()) {\n\t\t\tconst point = stop.points[0];\n\t\t\tif (point.hit?.kind === \"arc\") {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst distance = Math.hypot(point.x - x, point.y - y);\n\t\t\tif (distance < bestDistance) {\n\t\t\t\tbest = index;\n\t\t\t\tbestDistance = distance;\n\t\t\t}\n\t\t}\n\t\treturn best === -1 ? null : { stop: best, point: 0 };\n\t}\n\tconst cell = scene.cells?.find(\n\t\t(candidate) =>\n\t\t\tx >= candidate.plot.x &&\n\t\t\tx <= candidate.plot.x + candidate.plot.width &&\n\t\t\ty >= candidate.plot.y &&\n\t\t\ty <= candidate.plot.y + candidate.plot.height,\n\t);\n\tif (scene.cells !== undefined && cell === undefined) {\n\t\treturn null;\n\t}\n\tconst plot = cell?.plot ?? scene.plot;\n\tif (\n\t\tx < plot.x ||\n\t\tx > plot.x + plot.width ||\n\t\ty < plot.y ||\n\t\ty > plot.y + plot.height\n\t) {\n\t\treturn null;\n\t}\n\tconst along = order === \"y\" ? y : x;\n\tlet best = 0;\n\tlet bestDistance = Number.POSITIVE_INFINITY;\n\tfor (const [index, stop] of stops.entries()) {\n\t\tif (cell !== undefined && stop.points[0].facet !== cell.key) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst distance = Math.abs(stop.at - along);\n\t\tif (distance < bestDistance) {\n\t\t\tbest = index;\n\t\t\tbestDistance = distance;\n\t\t}\n\t}\n\treturn { stop: best, point: pickInStop(stops[best], x, y, order) };\n}\n"],
+  "mappings": "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",
+  "names": ["best", "bestDistance"]
+}

package/dist/core/paths.d.ts

@@ -0,0 +1,65 @@
+import type { ChartCorners, ChartCurve } from "./types.js";
+/** A point in chart pixels. */
+export interface ChartXY {
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * An open path through `points`. Returns `""` for fewer than two points, which
+ * renders as nothing rather than as a stray dot.
+ */
+export declare function linePath(points: ReadonlyArray<ChartXY>, curve?: ChartCurve): string;
+/**
+ * A closed band between a top edge and a bottom edge, both drawn with the same
+ * curve, so an area and its outline never disagree. The bottom edge runs under
+ * the same x positions as the top: a flat baseline, or the series below it in
+ * a stack.
+ */
+export declare function areaPath(top: ReadonlyArray<ChartXY>, bottom: ReadonlyArray<ChartXY>, curve?: ChartCurve): string;
+/** A closed polygon — the radar mark's outline. */
+export declare function polygonPath(points: ReadonlyArray<ChartXY>): string;
+export interface RoundedBarOptions {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    /** One radius, or `[topLeft, topRight, bottomRight, bottomLeft]`. */
+    readonly radius?: number | ChartCorners;
+}
+/**
+ * A rectangle with independently rounded corners — stacked bars round only the
+ * outer end of the stack, so the inner joins stay square.
+ */
+export declare function roundedBarPath(options: RoundedBarOptions): string;
+/**
+ * Angles are degrees, clockwise, zero at twelve o'clock: the way a pie chart
+ * is described out loud.
+ */
+export declare function polarToCartesian(cx: number, cy: number, radius: number, angle: number): ChartXY;
+export interface ArcOptions {
+    /** Centre of the circle the arc is cut from, in plot coordinates. */
+    readonly cx: number;
+    /** Centre of the circle the arc is cut from, in plot coordinates. */
+    readonly cy: number;
+    /** Inner edge. `0` makes the arc a pie wedge rather than a donut segment. */
+    readonly innerRadius: number;
+    /** Outer edge, in pixels from the centre. */
+    readonly outerRadius: number;
+    /** Degrees clockwise from twelve o'clock. */
+    readonly startAngle: number;
+    /** Degrees clockwise from twelve o'clock. A 360-degree sweep draws a full ring. */
+    readonly endAngle: number;
+}
+/**
+ * A pie wedge (`innerRadius` 0) or a donut segment. A sweep of 360 degrees or
+ * more is drawn as two half arcs, because a single arc back to its own start
+ * point renders as nothing at all.
+ */
+export declare function arcPath(options: ArcOptions): string;
+/**
+ * Path data for GeoJSON polygon rings already in chart pixels (what
+ * d3-contour returns): every ring closed, holes drawn with the even-odd rule
+ * the renderers default to.
+ */
+export declare function multiPolygonPath(polygons: ReadonlyArray<ReadonlyArray<ReadonlyArray<readonly [number, number] | ReadonlyArray<number>>>>, offsetX?: number, offsetY?: number): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEhE,+BAA+B;AAC/B,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACnB;AA2GD;;;GAGG;AACH,wBAAgB,QAAQ,CACvB,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,KAAK,GAAE,UAAqB,GAC1B,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACvB,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,EAC3B,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,KAAK,GAAE,UAAqB,GAC1B,MAAM,CAOR;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CASlE;AAkBD,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAgCjE;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACX,OAAO,CAMT;AAED,MAAM,WAAW,UAAU;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAqCnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,aAAa,CACtB,aAAa,CACZ,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAChE,CACD,EACD,OAAO,SAAI,EACX,OAAO,SAAI,GACT,MAAM,CAUR"}