@voila.dev/chart 4.0.0

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

@@ -0,0 +1,17 @@
+import type { ChartAccessor, ChartMark, ChartValue } from "../types.js";
+export interface RuleOptions<TDatum> {
+    readonly id?: string;
+    /** The value of each rule. Defaults to the datum itself, so `ruleY([0])` works. */
+    readonly value?: ChartAccessor<TDatum, ChartValue>;
+    readonly stroke?: string;
+    readonly strokeWidth?: number;
+    readonly strokeDasharray?: string;
+    readonly opacity?: number;
+    /** Text written at the end of the rule: "Objectif", "Moyenne". */
+    readonly label?: string;
+}
+/** Horizontal rules at y values: a baseline, a target, an average. */
+export declare function ruleY<TDatum>(data: ReadonlyArray<TDatum>, options?: RuleOptions<TDatum>): ChartMark;
+/** Vertical rules at x values: a date, a threshold. */
+export declare function ruleX<TDatum>(data: ReadonlyArray<TDatum>, options?: RuleOptions<TDatum>): ChartMark;
+//# sourceMappingURL=rule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../../src/core/marks/rule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,aAAa,EACb,SAAS,EACT,UAAU,EAEV,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,WAAW,CAAC,MAAM;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAsED,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,MAAM,EAC3B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,GAAE,WAAW,CAAC,MAAM,CAAM,GAC/B,SAAS,CAEX;AAED,uDAAuD;AACvD,wBAAgB,KAAK,CAAC,MAAM,EAC3B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,GAAE,WAAW,CAAC,MAAM,CAAM,GAC/B,SAAS,CAEX"}

package/dist/core/marks/rule.js

@@ -0,0 +1,73 @@
+import { isPlaceable, readChannel } from "../channel.js";
+import { markId, paint, valueOn } from "./shared.js";
+const LABEL_GAP = 4;
+function ruleMark(kind, data, options) {
+  const horizontal = kind === "ruleY";
+  const values = readChannel(
+    data,
+    options.value ?? ((datum) => datum)
+  );
+  const channel = { values: values.filter(isPlaceable) };
+  return {
+    id: options.id,
+    coordinate: "cartesian",
+    channels: horizontal ? { y: channel } : { x: channel },
+    render(context) {
+      const id = markId(options.id, kind, context);
+      const scale = horizontal ? context.scales.y : context.scales.x;
+      if (scale === void 0) {
+        return { nodes: [] };
+      }
+      const { plot, theme } = context;
+      const stroke = options.stroke ?? theme.foreground;
+      const nodes = [];
+      for (const [index, raw] of values.entries()) {
+        const value = valueOn(scale, raw);
+        if (value === void 0) {
+          continue;
+        }
+        const at = scale.center(value);
+        nodes.push({
+          kind: "line",
+          key: `${id}:${index}`,
+          role: "rule",
+          ...horizontal ? { x1: plot.x, y1: at, x2: plot.x + plot.width, y2: at } : { x1: at, y1: plot.y, x2: at, y2: plot.y + plot.height },
+          paint: paint({
+            stroke,
+            strokeWidth: options.strokeWidth ?? 1,
+            strokeDasharray: options.strokeDasharray,
+            opacity: options.opacity
+          })
+        });
+        if (options.label !== void 0) {
+          nodes.push({
+            kind: "text",
+            key: `${id}:label:${index}`,
+            role: "label",
+            x: horizontal ? plot.x + plot.width : at + LABEL_GAP,
+            y: horizontal ? at - LABEL_GAP : plot.y,
+            text: options.label,
+            paint: {
+              fill: stroke,
+              fontSize: theme.fontSize,
+              textAnchor: horizontal ? "end" : "start",
+              baseline: horizontal ? "bottom" : "top"
+            }
+          });
+        }
+      }
+      return { nodes };
+    }
+  };
+}
+function ruleY(data, options = {}) {
+  return ruleMark("ruleY", data, options);
+}
+function ruleX(data, options = {}) {
+  return ruleMark("ruleX", data, options);
+}
+export {
+  ruleX,
+  ruleY
+};
+//# sourceMappingURL=rule.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/marks/rule.ts"],
+  "sourcesContent": ["import { isPlaceable, readChannel } from \"#/core/channel.ts\";\nimport { markId, paint, valueOn } from \"#/core/marks/shared.ts\";\nimport type {\n\tChartAccessor,\n\tChartMark,\n\tChartValue,\n\tSceneNode,\n} from \"#/core/types.ts\";\n\nexport interface RuleOptions<TDatum> {\n\treadonly id?: string;\n\t/** The value of each rule. Defaults to the datum itself, so `ruleY([0])` works. */\n\treadonly value?: ChartAccessor<TDatum, ChartValue>;\n\treadonly stroke?: string;\n\treadonly strokeWidth?: number;\n\treadonly strokeDasharray?: string;\n\treadonly opacity?: number;\n\t/** Text written at the end of the rule: \"Objectif\", \"Moyenne\". */\n\treadonly label?: string;\n}\n\nconst LABEL_GAP = 4;\n\nfunction ruleMark<TDatum>(\n\tkind: \"ruleY\" | \"ruleX\",\n\tdata: ReadonlyArray<TDatum>,\n\toptions: RuleOptions<TDatum>,\n): ChartMark {\n\tconst horizontal = kind === \"ruleY\";\n\tconst values = readChannel(\n\t\tdata,\n\t\toptions.value ?? ((datum: TDatum) => datum as unknown as ChartValue),\n\t);\n\tconst channel = { values: values.filter(isPlaceable) };\n\treturn {\n\t\tid: options.id,\n\t\tcoordinate: \"cartesian\",\n\t\tchannels: horizontal ? { y: channel } : { x: channel },\n\t\trender(context) {\n\t\t\tconst id = markId(options.id, kind, context);\n\t\t\tconst scale = horizontal ? context.scales.y : context.scales.x;\n\t\t\tif (scale === undefined) {\n\t\t\t\treturn { nodes: [] };\n\t\t\t}\n\t\t\tconst { plot, theme } = context;\n\t\t\tconst stroke = options.stroke ?? theme.foreground;\n\t\t\tconst nodes: SceneNode[] = [];\n\t\t\tfor (const [index, raw] of values.entries()) {\n\t\t\t\tconst value = valueOn(scale, raw);\n\t\t\t\tif (value === undefined) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tconst at = scale.center(value);\n\t\t\t\tnodes.push({\n\t\t\t\t\tkind: \"line\",\n\t\t\t\t\tkey: `${id}:${index}`,\n\t\t\t\t\trole: \"rule\",\n\t\t\t\t\t...(horizontal\n\t\t\t\t\t\t? { x1: plot.x, y1: at, x2: plot.x + plot.width, y2: at }\n\t\t\t\t\t\t: { x1: at, y1: plot.y, x2: at, y2: plot.y + plot.height }),\n\t\t\t\t\tpaint: paint({\n\t\t\t\t\t\tstroke,\n\t\t\t\t\t\tstrokeWidth: options.strokeWidth ?? 1,\n\t\t\t\t\t\tstrokeDasharray: options.strokeDasharray,\n\t\t\t\t\t\topacity: options.opacity,\n\t\t\t\t\t}),\n\t\t\t\t});\n\t\t\t\tif (options.label !== undefined) {\n\t\t\t\t\tnodes.push({\n\t\t\t\t\t\tkind: \"text\",\n\t\t\t\t\t\tkey: `${id}:label:${index}`,\n\t\t\t\t\t\trole: \"label\",\n\t\t\t\t\t\tx: horizontal ? plot.x + plot.width : at + LABEL_GAP,\n\t\t\t\t\t\ty: horizontal ? at - LABEL_GAP : plot.y,\n\t\t\t\t\t\ttext: options.label,\n\t\t\t\t\t\tpaint: {\n\t\t\t\t\t\t\tfill: stroke,\n\t\t\t\t\t\t\tfontSize: theme.fontSize,\n\t\t\t\t\t\t\ttextAnchor: horizontal ? \"end\" : \"start\",\n\t\t\t\t\t\t\tbaseline: horizontal ? \"bottom\" : \"top\",\n\t\t\t\t\t\t},\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\n/** Horizontal rules at y values: a baseline, a target, an average. */\nexport function ruleY<TDatum>(\n\tdata: ReadonlyArray<TDatum>,\n\toptions: RuleOptions<TDatum> = {},\n): ChartMark {\n\treturn ruleMark(\"ruleY\", data, options);\n}\n\n/** Vertical rules at x values: a date, a threshold. */\nexport function ruleX<TDatum>(\n\tdata: ReadonlyArray<TDatum>,\n\toptions: RuleOptions<TDatum> = {},\n): ChartMark {\n\treturn ruleMark(\"ruleX\", data, options);\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa,mBAAmB;AACzC,SAAS,QAAQ,OAAO,eAAe;AAoBvC,MAAM,YAAY;AAElB,SAAS,SACR,MACA,MACA,SACY;AACZ,QAAM,aAAa,SAAS;AAC5B,QAAM,SAAS;AAAA,IACd;AAAA,IACA,QAAQ,UAAU,CAAC,UAAkB;AAAA,EACtC;AACA,QAAM,UAAU,EAAE,QAAQ,OAAO,OAAO,WAAW,EAAE;AACrD,SAAO;AAAA,IACN,IAAI,QAAQ;AAAA,IACZ,YAAY;AAAA,IACZ,UAAU,aAAa,EAAE,GAAG,QAAQ,IAAI,EAAE,GAAG,QAAQ;AAAA,IACrD,OAAO,SAAS;AACf,YAAM,KAAK,OAAO,QAAQ,IAAI,MAAM,OAAO;AAC3C,YAAM,QAAQ,aAAa,QAAQ,OAAO,IAAI,QAAQ,OAAO;AAC7D,UAAI,UAAU,QAAW;AACxB,eAAO,EAAE,OAAO,CAAC,EAAE;AAAA,MACpB;AACA,YAAM,EAAE,MAAM,MAAM,IAAI;AACxB,YAAM,SAAS,QAAQ,UAAU,MAAM;AACvC,YAAM,QAAqB,CAAC;AAC5B,iBAAW,CAAC,OAAO,GAAG,KAAK,OAAO,QAAQ,GAAG;AAC5C,cAAM,QAAQ,QAAQ,OAAO,GAAG;AAChC,YAAI,UAAU,QAAW;AACxB;AAAA,QACD;AACA,cAAM,KAAK,MAAM,OAAO,KAAK;AAC7B,cAAM,KAAK;AAAA,UACV,MAAM;AAAA,UACN,KAAK,GAAG,EAAE,IAAI,KAAK;AAAA,UACnB,MAAM;AAAA,UACN,GAAI,aACD,EAAE,IAAI,KAAK,GAAG,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK,OAAO,IAAI,GAAG,IACtD,EAAE,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK,OAAO;AAAA,UAC1D,OAAO,MAAM;AAAA,YACZ;AAAA,YACA,aAAa,QAAQ,eAAe;AAAA,YACpC,iBAAiB,QAAQ;AAAA,YACzB,SAAS,QAAQ;AAAA,UAClB,CAAC;AAAA,QACF,CAAC;AACD,YAAI,QAAQ,UAAU,QAAW;AAChC,gBAAM,KAAK;AAAA,YACV,MAAM;AAAA,YACN,KAAK,GAAG,EAAE,UAAU,KAAK;AAAA,YACzB,MAAM;AAAA,YACN,GAAG,aAAa,KAAK,IAAI,KAAK,QAAQ,KAAK;AAAA,YAC3C,GAAG,aAAa,KAAK,YAAY,KAAK;AAAA,YACtC,MAAM,QAAQ;AAAA,YACd,OAAO;AAAA,cACN,MAAM;AAAA,cACN,UAAU,MAAM;AAAA,cAChB,YAAY,aAAa,QAAQ;AAAA,cACjC,UAAU,aAAa,WAAW;AAAA,YACnC;AAAA,UACD,CAAC;AAAA,QACF;AAAA,MACD;AACA,aAAO,EAAE,MAAM;AAAA,IAChB;AAAA,EACD;AACD;AAGO,SAAS,MACf,MACA,UAA+B,CAAC,GACpB;AACZ,SAAO,SAAS,SAAS,MAAM,OAAO;AACvC;AAGO,SAAS,MACf,MACA,UAA+B,CAAC,GACpB;AACZ,SAAO,SAAS,SAAS,MAAM,OAAO;AACvC;",
+  "names": []
+}

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

@@ -0,0 +1,41 @@
+import type { ChartAccessor, ChartChannel, ChartMarkContext, ChartPaint, ChartPositionScale, ChartValue } from "../types.js";
+/** Options every mark takes. */
+export interface ChartMarkOptions<TDatum> {
+    /** Stable identity, so focus and legend state survive a data update. */
+    readonly id?: string;
+    /** The series' name when the mark has no color channel: legend, tooltip, table. */
+    readonly label?: string;
+    /** A field or function whose distinct values split the mark into coloured series. */
+    readonly color?: ChartAccessor<TDatum, ChartValue>;
+    /** `false` keeps the mark out of focus, tooltips and the data table. */
+    readonly tip?: boolean;
+    readonly opacity?: number;
+}
+export declare function markId(id: string | undefined, kind: string, context: ChartMarkContext): string;
+/** A datum's series: its color value when there is a color channel, the mark otherwise. */
+export interface SeriesInfo {
+    readonly key: string;
+    readonly label: string | undefined;
+    readonly color: string;
+}
+export declare function seriesResolver<TDatum>(colors: ReadonlyArray<ChartValue | undefined>, options: ChartMarkOptions<TDatum> & {
+    readonly fixedColor?: string;
+}, id: string, context: ChartMarkContext): (index: number) => SeriesInfo;
+export declare function colorChannel<TDatum>(data: ReadonlyArray<TDatum>, options: ChartMarkOptions<TDatum>): {
+    readonly values: ReadonlyArray<ChartValue | undefined>;
+    readonly channel: ChartChannel | undefined;
+};
+/** Keeps only the defined paint keys, so a scene snapshot shows what was asked for. */
+export declare function paint<TPaint extends ChartPaint>(values: TPaint): TPaint;
+/** Indices of `data` grouped by series, each group in data order. */
+export declare function groupBySeries(count: number, seriesOf: (index: number) => SeriesInfo): ReadonlyMap<string, {
+    readonly series: SeriesInfo;
+    readonly indices: number[];
+}>;
+/**
+ * A raw channel value as the scale can place it, or `undefined` for a gap. A
+ * continuous scale reads numeric strings as numbers; a discrete one takes any
+ * category as is.
+ */
+export declare function valueOn(scale: ChartPositionScale, raw: unknown): ChartValue | undefined;
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/core/marks/shared.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,MAAM,iBAAiB,CAAC;AAEzB,gCAAgC;AAChC,MAAM,WAAW,gBAAgB,CAAC,MAAM;IACvC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnD,wEAAwE;IACxE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,MAAM,CACrB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,GACvB,MAAM,CAER;AAED,2FAA2F;AAC3F,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,cAAc,CAAC,MAAM,EACpC,MAAM,EAAE,aAAa,CAAC,UAAU,GAAG,SAAS,CAAC,EAC7C,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACpE,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,gBAAgB,GACvB,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,CAkB/B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAClC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAC/B;IACF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;CAC3C,CAYA;AAED,uFAAuF;AACvF,wBAAgB,KAAK,CAAC,MAAM,SAAS,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,GACrC,WAAW,CACb,MAAM,EACN;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAC3D,CAYA;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACtB,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,OAAO,GACV,UAAU,GAAG,SAAS,CAQxB"}

package/dist/core/marks/shared.js

@@ -0,0 +1,74 @@
+import {
+  channelLabel,
+  isPlaceable,
+  numericValue,
+  readChannel
+} from "../channel.js";
+import { categoryKey } from "../scales/discrete.js";
+function markId(id, kind, context) {
+  return id ?? `${kind}-${context.markIndex}`;
+}
+function seriesResolver(colors, options, id, context) {
+  const fallback = options.fixedColor ?? context.paletteColor(context.markIndex);
+  const single = { key: id, label: options.label, color: fallback };
+  if (options.color === void 0) {
+    return () => single;
+  }
+  return (index) => {
+    const value = colors[index];
+    if (value === void 0) {
+      return single;
+    }
+    return {
+      key: categoryKey(value),
+      label: context.seriesLabel(value),
+      color: options.fixedColor ?? context.colorOf(value)
+    };
+  };
+}
+function colorChannel(data, options) {
+  const values = readChannel(data, options.color);
+  return {
+    values,
+    channel: options.color === void 0 ? void 0 : {
+      values: values.filter(isPlaceable),
+      label: channelLabel(options.color)
+    }
+  };
+}
+function paint(values) {
+  return Object.fromEntries(
+    Object.entries(values).filter(([, value]) => value !== void 0)
+  );
+}
+function groupBySeries(count, seriesOf) {
+  const groups = /* @__PURE__ */ new Map();
+  for (let index = 0; index < count; index += 1) {
+    const series = seriesOf(index);
+    const group = groups.get(series.key);
+    if (group === void 0) {
+      groups.set(series.key, { series, indices: [index] });
+    } else {
+      group.indices.push(index);
+    }
+  }
+  return groups;
+}
+function valueOn(scale, raw) {
+  if (scale.kind === "band" || scale.kind === "point") {
+    return isPlaceable(raw) ? raw : void 0;
+  }
+  if (raw instanceof Date) {
+    return Number.isNaN(raw.getTime()) ? void 0 : raw;
+  }
+  return numericValue(raw);
+}
+export {
+  colorChannel,
+  groupBySeries,
+  markId,
+  paint,
+  seriesResolver,
+  valueOn
+};
+//# sourceMappingURL=shared.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/marks/shared.ts"],
+  "sourcesContent": ["import {\n\tchannelLabel,\n\tisPlaceable,\n\tnumericValue,\n\treadChannel,\n} from \"#/core/channel.ts\";\nimport { categoryKey } from \"#/core/scales/discrete.ts\";\nimport type {\n\tChartAccessor,\n\tChartChannel,\n\tChartMarkContext,\n\tChartPaint,\n\tChartPositionScale,\n\tChartValue,\n} from \"#/core/types.ts\";\n\n/** Options every mark takes. */\nexport interface ChartMarkOptions<TDatum> {\n\t/** Stable identity, so focus and legend state survive a data update. */\n\treadonly id?: string;\n\t/** The series' name when the mark has no color channel: legend, tooltip, table. */\n\treadonly label?: string;\n\t/** A field or function whose distinct values split the mark into coloured series. */\n\treadonly color?: ChartAccessor<TDatum, ChartValue>;\n\t/** `false` keeps the mark out of focus, tooltips and the data table. */\n\treadonly tip?: boolean;\n\treadonly opacity?: number;\n}\n\nexport function markId(\n\tid: string | undefined,\n\tkind: string,\n\tcontext: ChartMarkContext,\n): string {\n\treturn id ?? `${kind}-${context.markIndex}`;\n}\n\n/** A datum's series: its color value when there is a color channel, the mark otherwise. */\nexport interface SeriesInfo {\n\treadonly key: string;\n\treadonly label: string | undefined;\n\treadonly color: string;\n}\n\nexport function seriesResolver<TDatum>(\n\tcolors: ReadonlyArray<ChartValue | undefined>,\n\toptions: ChartMarkOptions<TDatum> & { readonly fixedColor?: string },\n\tid: string,\n\tcontext: ChartMarkContext,\n): (index: number) => SeriesInfo {\n\tconst fallback =\n\t\toptions.fixedColor ?? context.paletteColor(context.markIndex);\n\tconst single: SeriesInfo = { key: id, label: options.label, color: fallback };\n\tif (options.color === undefined) {\n\t\treturn () => single;\n\t}\n\treturn (index) => {\n\t\tconst value = colors[index];\n\t\tif (value === undefined) {\n\t\t\treturn single;\n\t\t}\n\t\treturn {\n\t\t\tkey: categoryKey(value),\n\t\t\tlabel: context.seriesLabel(value),\n\t\t\tcolor: options.fixedColor ?? context.colorOf(value),\n\t\t};\n\t};\n}\n\nexport function colorChannel<TDatum>(\n\tdata: ReadonlyArray<TDatum>,\n\toptions: ChartMarkOptions<TDatum>,\n): {\n\treadonly values: ReadonlyArray<ChartValue | undefined>;\n\treadonly channel: ChartChannel | undefined;\n} {\n\tconst values = readChannel(data, options.color);\n\treturn {\n\t\tvalues,\n\t\tchannel:\n\t\t\toptions.color === undefined\n\t\t\t\t? undefined\n\t\t\t\t: {\n\t\t\t\t\t\tvalues: values.filter(isPlaceable),\n\t\t\t\t\t\tlabel: channelLabel(options.color),\n\t\t\t\t\t},\n\t};\n}\n\n/** Keeps only the defined paint keys, so a scene snapshot shows what was asked for. */\nexport function paint<TPaint extends ChartPaint>(values: TPaint): TPaint {\n\treturn Object.fromEntries(\n\t\tObject.entries(values).filter(([, value]) => value !== undefined),\n\t) as TPaint;\n}\n\n/** Indices of `data` grouped by series, each group in data order. */\nexport function groupBySeries(\n\tcount: number,\n\tseriesOf: (index: number) => SeriesInfo,\n): ReadonlyMap<\n\tstring,\n\t{ readonly series: SeriesInfo; readonly indices: number[] }\n> {\n\tconst groups = new Map<string, { series: SeriesInfo; indices: number[] }>();\n\tfor (let index = 0; index < count; index += 1) {\n\t\tconst series = seriesOf(index);\n\t\tconst group = groups.get(series.key);\n\t\tif (group === undefined) {\n\t\t\tgroups.set(series.key, { series, indices: [index] });\n\t\t} else {\n\t\t\tgroup.indices.push(index);\n\t\t}\n\t}\n\treturn groups;\n}\n\n/**\n * A raw channel value as the scale can place it, or `undefined` for a gap. A\n * continuous scale reads numeric strings as numbers; a discrete one takes any\n * category as is.\n */\nexport function valueOn(\n\tscale: ChartPositionScale,\n\traw: unknown,\n): ChartValue | undefined {\n\tif (scale.kind === \"band\" || scale.kind === \"point\") {\n\t\treturn isPlaceable(raw) ? raw : undefined;\n\t}\n\tif (raw instanceof Date) {\n\t\treturn Number.isNaN(raw.getTime()) ? undefined : raw;\n\t}\n\treturn numericValue(raw);\n}\n"],
+  "mappings": "AAAA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACM;AACP,SAAS,mBAAmB;AAuBrB,SAAS,OACf,IACA,MACA,SACS;AACT,SAAO,MAAM,GAAG,IAAI,IAAI,QAAQ,SAAS;AAC1C;AASO,SAAS,eACf,QACA,SACA,IACA,SACgC;AAChC,QAAM,WACL,QAAQ,cAAc,QAAQ,aAAa,QAAQ,SAAS;AAC7D,QAAM,SAAqB,EAAE,KAAK,IAAI,OAAO,QAAQ,OAAO,OAAO,SAAS;AAC5E,MAAI,QAAQ,UAAU,QAAW;AAChC,WAAO,MAAM;AAAA,EACd;AACA,SAAO,CAAC,UAAU;AACjB,UAAM,QAAQ,OAAO,KAAK;AAC1B,QAAI,UAAU,QAAW;AACxB,aAAO;AAAA,IACR;AACA,WAAO;AAAA,MACN,KAAK,YAAY,KAAK;AAAA,MACtB,OAAO,QAAQ,YAAY,KAAK;AAAA,MAChC,OAAO,QAAQ,cAAc,QAAQ,QAAQ,KAAK;AAAA,IACnD;AAAA,EACD;AACD;AAEO,SAAS,aACf,MACA,SAIC;AACD,QAAM,SAAS,YAAY,MAAM,QAAQ,KAAK;AAC9C,SAAO;AAAA,IACN;AAAA,IACA,SACC,QAAQ,UAAU,SACf,SACA;AAAA,MACA,QAAQ,OAAO,OAAO,WAAW;AAAA,MACjC,OAAO,aAAa,QAAQ,KAAK;AAAA,IAClC;AAAA,EACJ;AACD;AAGO,SAAS,MAAiC,QAAwB;AACxE,SAAO,OAAO;AAAA,IACb,OAAO,QAAQ,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,MAAM,UAAU,MAAS;AAAA,EACjE;AACD;AAGO,SAAS,cACf,OACA,UAIC;AACD,QAAM,SAAS,oBAAI,IAAuD;AAC1E,WAAS,QAAQ,GAAG,QAAQ,OAAO,SAAS,GAAG;AAC9C,UAAM,SAAS,SAAS,KAAK;AAC7B,UAAM,QAAQ,OAAO,IAAI,OAAO,GAAG;AACnC,QAAI,UAAU,QAAW;AACxB,aAAO,IAAI,OAAO,KAAK,EAAE,QAAQ,SAAS,CAAC,KAAK,EAAE,CAAC;AAAA,IACpD,OAAO;AACN,YAAM,QAAQ,KAAK,KAAK;AAAA,IACzB;AAAA,EACD;AACA,SAAO;AACR;AAOO,SAAS,QACf,OACA,KACyB;AACzB,MAAI,MAAM,SAAS,UAAU,MAAM,SAAS,SAAS;AACpD,WAAO,YAAY,GAAG,IAAI,MAAM;AAAA,EACjC;AACA,MAAI,eAAe,MAAM;AACxB,WAAO,OAAO,MAAM,IAAI,QAAQ,CAAC,IAAI,SAAY;AAAA,EAClD;AACA,SAAO,aAAa,GAAG;AACxB;",
+  "names": []
+}

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

@@ -0,0 +1,13 @@
+/**
+ * Stacking: each value sits on the running total of the values before it at
+ * the same position. Positives grow away from zero upwards and negatives
+ * downwards, separately, so a stack of mixed signs never overlaps itself.
+ */
+export interface StackSegment {
+    readonly low: number;
+    readonly high: number;
+    /** The outermost segment of its side of the stack: the one whose far end gets rounded. */
+    readonly outer: boolean;
+}
+export declare function stackSegments(positions: ReadonlyArray<string | undefined>, values: ReadonlyArray<number | undefined>): ReadonlyArray<StackSegment | undefined>;
+//# sourceMappingURL=stack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../../src/core/marks/stack.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,aAAa,CAC5B,SAAS,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,EAC5C,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,GACvC,aAAa,CAAC,YAAY,GAAG,SAAS,CAAC,CAyBzC"}

package/dist/core/marks/stack.js

@@ -0,0 +1,28 @@
+function stackSegments(positions, values) {
+  const above = /* @__PURE__ */ new Map();
+  const below = /* @__PURE__ */ new Map();
+  const lastAbove = /* @__PURE__ */ new Map();
+  const lastBelow = /* @__PURE__ */ new Map();
+  const segments = positions.map((position, index) => {
+    const value = values[index];
+    if (position === void 0 || value === void 0) {
+      return void 0;
+    }
+    const totals = value >= 0 ? above : below;
+    const base = totals.get(position) ?? 0;
+    totals.set(position, base + value);
+    (value >= 0 ? lastAbove : lastBelow).set(position, index);
+    return { low: base, high: base + value, outer: false };
+  });
+  for (const index of [...lastAbove.values(), ...lastBelow.values()]) {
+    const segment = segments[index];
+    if (segment !== void 0) {
+      segment.outer = true;
+    }
+  }
+  return segments;
+}
+export {
+  stackSegments
+};
+//# sourceMappingURL=stack.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/marks/stack.ts"],
+  "sourcesContent": ["/**\n * Stacking: each value sits on the running total of the values before it at\n * the same position. Positives grow away from zero upwards and negatives\n * downwards, separately, so a stack of mixed signs never overlaps itself.\n */\n\nexport interface StackSegment {\n\treadonly low: number;\n\treadonly high: number;\n\t/** The outermost segment of its side of the stack: the one whose far end gets rounded. */\n\treadonly outer: boolean;\n}\n\nexport function stackSegments(\n\tpositions: ReadonlyArray<string | undefined>,\n\tvalues: ReadonlyArray<number | undefined>,\n): ReadonlyArray<StackSegment | undefined> {\n\tconst above = new Map<string, number>();\n\tconst below = new Map<string, number>();\n\tconst lastAbove = new Map<string, number>();\n\tconst lastBelow = new Map<string, number>();\n\tconst segments: Array<\n\t\t{ low: number; high: number; outer: boolean } | undefined\n\t> = positions.map((position, index) => {\n\t\tconst value = values[index];\n\t\tif (position === undefined || value === undefined) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst totals = value >= 0 ? above : below;\n\t\tconst base = totals.get(position) ?? 0;\n\t\ttotals.set(position, base + value);\n\t\t(value >= 0 ? lastAbove : lastBelow).set(position, index);\n\t\treturn { low: base, high: base + value, outer: false };\n\t});\n\tfor (const index of [...lastAbove.values(), ...lastBelow.values()]) {\n\t\tconst segment = segments[index];\n\t\tif (segment !== undefined) {\n\t\t\tsegment.outer = true;\n\t\t}\n\t}\n\treturn segments;\n}\n"],
+  "mappings": "AAaO,SAAS,cACf,WACA,QAC0C;AAC1C,QAAM,QAAQ,oBAAI,IAAoB;AACtC,QAAM,QAAQ,oBAAI,IAAoB;AACtC,QAAM,YAAY,oBAAI,IAAoB;AAC1C,QAAM,YAAY,oBAAI,IAAoB;AAC1C,QAAM,WAEF,UAAU,IAAI,CAAC,UAAU,UAAU;AACtC,UAAM,QAAQ,OAAO,KAAK;AAC1B,QAAI,aAAa,UAAa,UAAU,QAAW;AAClD,aAAO;AAAA,IACR;AACA,UAAM,SAAS,SAAS,IAAI,QAAQ;AACpC,UAAM,OAAO,OAAO,IAAI,QAAQ,KAAK;AACrC,WAAO,IAAI,UAAU,OAAO,KAAK;AACjC,KAAC,SAAS,IAAI,YAAY,WAAW,IAAI,UAAU,KAAK;AACxD,WAAO,EAAE,KAAK,MAAM,MAAM,OAAO,OAAO,OAAO,MAAM;AAAA,EACtD,CAAC;AACD,aAAW,SAAS,CAAC,GAAG,UAAU,OAAO,GAAG,GAAG,UAAU,OAAO,CAAC,GAAG;AACnE,UAAM,UAAU,SAAS,KAAK;AAC9B,QAAI,YAAY,QAAW;AAC1B,cAAQ,QAAQ;AAAA,IACjB;AAAA,EACD;AACA,SAAO;AACR;",
+  "names": []
+}

package/dist/core/marks/stats/difference.d.ts

@@ -0,0 +1,20 @@
+import type { ChartAccessor, ChartMark, ChartValue } from "../../types.js";
+export interface DifferenceOptions<TDatum> {
+    readonly id?: string;
+    readonly x: ChartAccessor<TDatum, ChartValue>;
+    /** The series read against the other: the fill says when it is above. */
+    readonly y1: ChartAccessor<TDatum, ChartValue>;
+    readonly y2: ChartAccessor<TDatum, ChartValue>;
+    /** Names of the two series, for the tooltip, the table and the legend. */
+    readonly labels?: readonly [string, string];
+    /** Fill where `y1` is above `y2`, and below. */
+    readonly positiveFill?: string;
+    readonly negativeFill?: string;
+    readonly fillOpacity?: number;
+}
+/**
+ * Two series and the band between them, filled by which one is ahead:
+ * revenue against costs, this year against last.
+ */
+export declare function differenceY<TDatum>(data: ReadonlyArray<TDatum>, options: DifferenceOptions<TDatum>): ChartMark;
+//# sourceMappingURL=difference.d.ts.map

package/dist/core/marks/stats/difference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"difference.d.ts","sourceRoot":"","sources":["../../../../src/core/marks/stats/difference.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,aAAa,EACb,SAAS,EAET,UAAU,EAEV,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,iBAAiB,CAAC,MAAM;IACxC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9C,yEAAyE;IACzE,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/C,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,gDAAgD;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAsCD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EACjC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAChC,SAAS,CAmIX"}

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

@@ -0,0 +1,168 @@
+import {
+  channelLabel,
+  isPlaceable,
+  numericValue,
+  readChannel
+} from "../../channel.js";
+import { markId, paint, valueOn } from "../shared.js";
+import { areaPath, linePath } from "../../paths.js";
+function signRuns(samples) {
+  const runs = [];
+  for (const [index, sample] of samples.entries()) {
+    const positive = sample.top <= sample.bottom;
+    const current = runs[runs.length - 1];
+    if (current === void 0) {
+      runs.push({ positive, samples: [sample] });
+      continue;
+    }
+    if (current.positive === positive) {
+      current.samples.push(sample);
+      continue;
+    }
+    const previous = samples[index - 1];
+    const before = previous.top - previous.bottom;
+    const after = sample.top - sample.bottom;
+    const share = before / (before - after);
+    const crossX = previous.x + (sample.x - previous.x) * share;
+    const crossY = previous.top + (sample.top - previous.top) * share;
+    const cross = { x: crossX, top: crossY, bottom: crossY };
+    current.samples.push(cross);
+    runs.push({ positive, samples: [cross, sample] });
+  }
+  return runs;
+}
+function differenceY(data, options) {
+  const xs = readChannel(data, options.x);
+  const first = readChannel(data, options.y1).map(numericValue);
+  const second = readChannel(data, options.y2).map(numericValue);
+  const [firstLabel, secondLabel] = options.labels ?? [
+    channelLabel(options.y1) ?? "y1",
+    channelLabel(options.y2) ?? "y2"
+  ];
+  return {
+    id: options.id,
+    coordinate: "cartesian",
+    focusOrder: "x",
+    channels: {
+      x: { values: xs.filter(isPlaceable), label: channelLabel(options.x) },
+      y: {
+        values: [...first, ...second].filter(
+          (value) => value !== void 0
+        )
+      }
+    },
+    render(context) {
+      const id = markId(options.id, "differenceY", context);
+      const { x: xScale, y: yScale } = context.scales;
+      if (xScale === void 0 || yScale === void 0) {
+        return { nodes: [] };
+      }
+      const positive = options.positiveFill ?? context.paletteColor(1);
+      const negative = options.negativeFill ?? context.paletteColor(0);
+      const samples = [];
+      const points = [];
+      for (const [index, raw] of xs.entries()) {
+        const x = valueOn(xScale, raw);
+        const a = first[index];
+        const b = second[index];
+        if (x === void 0 || a === void 0 || b === void 0) continue;
+        const sample = {
+          x: xScale.center(x),
+          top: yScale.map(a),
+          bottom: yScale.map(b)
+        };
+        samples.push(sample);
+        for (const [series, value, pixel, label] of [
+          ["y1", a, sample.top, firstLabel],
+          ["y2", b, sample.bottom, secondLabel]
+        ]) {
+          points.push({
+            key: `${id}:${series}:${index}`,
+            markId: id,
+            index,
+            datum: data[index],
+            x: sample.x,
+            y: pixel,
+            xValue: x,
+            yValue: value,
+            series: `${id}:${series}`,
+            seriesLabel: label,
+            color: series === "y1" ? context.theme.foreground : context.theme.muted,
+            title: context.formatX(x),
+            value: context.formatY(value)
+          });
+        }
+      }
+      const nodes = signRuns(samples).map((run, index) => ({
+        kind: "path",
+        key: `${id}:band:${index}`,
+        role: "mark",
+        d: areaPath(
+          run.samples.map(
+            (sample) => ({ x: sample.x, y: sample.top })
+          ),
+          run.samples.map(
+            (sample) => ({ x: sample.x, y: sample.bottom })
+          )
+        ),
+        paint: paint({
+          fill: run.positive ? positive : negative,
+          fillOpacity: options.fillOpacity ?? 0.35
+        })
+      }));
+      nodes.push(
+        {
+          kind: "path",
+          key: `${id}:line:y1`,
+          series: `${id}:y1`,
+          role: "mark",
+          d: linePath(
+            samples.map((sample) => ({ x: sample.x, y: sample.top }))
+          ),
+          paint: {
+            fill: "none",
+            stroke: context.theme.foreground,
+            strokeWidth: 1.5
+          }
+        },
+        {
+          kind: "path",
+          key: `${id}:line:y2`,
+          series: `${id}:y2`,
+          role: "mark",
+          d: linePath(
+            samples.map((sample) => ({ x: sample.x, y: sample.bottom }))
+          ),
+          paint: {
+            fill: "none",
+            stroke: context.theme.muted,
+            strokeWidth: 1.5,
+            strokeDasharray: "4 3"
+          }
+        }
+      );
+      return {
+        nodes,
+        points,
+        legend: [
+          {
+            key: `${id}:y1`,
+            label: firstLabel,
+            color: context.theme.foreground,
+            shape: "line"
+          },
+          {
+            key: `${id}:y2`,
+            label: secondLabel,
+            color: context.theme.muted,
+            shape: "dashed"
+          }
+        ]
+      };
+    }
+  };
+}
+export {
+  differenceY
+};
+//# sourceMappingURL=difference.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/marks/stats/difference.ts"],
+  "sourcesContent": ["import {\n\tchannelLabel,\n\tisPlaceable,\n\tnumericValue,\n\treadChannel,\n} from \"#/core/channel.ts\";\nimport { markId, paint, valueOn } from \"#/core/marks/shared.ts\";\nimport { areaPath, type ChartXY, linePath } from \"#/core/paths.ts\";\nimport type {\n\tChartAccessor,\n\tChartMark,\n\tChartPoint,\n\tChartValue,\n\tSceneNode,\n} from \"#/core/types.ts\";\n\nexport interface DifferenceOptions<TDatum> {\n\treadonly id?: string;\n\treadonly x: ChartAccessor<TDatum, ChartValue>;\n\t/** The series read against the other: the fill says when it is above. */\n\treadonly y1: ChartAccessor<TDatum, ChartValue>;\n\treadonly y2: ChartAccessor<TDatum, ChartValue>;\n\t/** Names of the two series, for the tooltip, the table and the legend. */\n\treadonly labels?: readonly [string, string];\n\t/** Fill where `y1` is above `y2`, and below. */\n\treadonly positiveFill?: string;\n\treadonly negativeFill?: string;\n\treadonly fillOpacity?: number;\n}\n\ninterface Sample {\n\treadonly x: number;\n\treadonly top: number;\n\treadonly bottom: number;\n}\n\n/** Splits the band between two lines into runs of one sign, cut where they cross. */\nfunction signRuns(\n\tsamples: ReadonlyArray<Sample>,\n): Array<{ positive: boolean; samples: Sample[] }> {\n\tconst runs: Array<{ positive: boolean; samples: Sample[] }> = [];\n\tfor (const [index, sample] of samples.entries()) {\n\t\t// Pixels: a smaller y is higher, so y1 above y2 means top < bottom.\n\t\tconst positive = sample.top <= sample.bottom;\n\t\tconst current = runs[runs.length - 1];\n\t\tif (current === undefined) {\n\t\t\truns.push({ positive, samples: [sample] });\n\t\t\tcontinue;\n\t\t}\n\t\tif (current.positive === positive) {\n\t\t\tcurrent.samples.push(sample);\n\t\t\tcontinue;\n\t\t}\n\t\tconst previous = samples[index - 1];\n\t\tconst before = previous.top - previous.bottom;\n\t\tconst after = sample.top - sample.bottom;\n\t\tconst share = before / (before - after);\n\t\tconst crossX = previous.x + (sample.x - previous.x) * share;\n\t\tconst crossY = previous.top + (sample.top - previous.top) * share;\n\t\tconst cross = { x: crossX, top: crossY, bottom: crossY };\n\t\tcurrent.samples.push(cross);\n\t\truns.push({ positive, samples: [cross, sample] });\n\t}\n\treturn runs;\n}\n\n/**\n * Two series and the band between them, filled by which one is ahead:\n * revenue against costs, this year against last.\n */\nexport function differenceY<TDatum>(\n\tdata: ReadonlyArray<TDatum>,\n\toptions: DifferenceOptions<TDatum>,\n): ChartMark {\n\tconst xs = readChannel(data, options.x);\n\tconst first = readChannel(data, options.y1).map(numericValue);\n\tconst second = readChannel(data, options.y2).map(numericValue);\n\tconst [firstLabel, secondLabel] = options.labels ?? [\n\t\tchannelLabel(options.y1) ?? \"y1\",\n\t\tchannelLabel(options.y2) ?? \"y2\",\n\t];\n\treturn {\n\t\tid: options.id,\n\t\tcoordinate: \"cartesian\",\n\t\tfocusOrder: \"x\",\n\t\tchannels: {\n\t\t\tx: { values: xs.filter(isPlaceable), label: channelLabel(options.x) },\n\t\t\ty: {\n\t\t\t\tvalues: [...first, ...second].filter(\n\t\t\t\t\t(value): value is number => value !== undefined,\n\t\t\t\t),\n\t\t\t},\n\t\t},\n\t\trender(context) {\n\t\t\tconst id = markId(options.id, \"differenceY\", 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 positive = options.positiveFill ?? context.paletteColor(1);\n\t\t\tconst negative = options.negativeFill ?? context.paletteColor(0);\n\t\t\tconst samples: Sample[] = [];\n\t\t\tconst points: ChartPoint[] = [];\n\t\t\tfor (const [index, raw] of xs.entries()) {\n\t\t\t\tconst x = valueOn(xScale, raw);\n\t\t\t\tconst a = first[index];\n\t\t\t\tconst b = second[index];\n\t\t\t\tif (x === undefined || a === undefined || b === undefined) continue;\n\t\t\t\tconst sample = {\n\t\t\t\t\tx: xScale.center(x),\n\t\t\t\t\ttop: yScale.map(a),\n\t\t\t\t\tbottom: yScale.map(b),\n\t\t\t\t};\n\t\t\t\tsamples.push(sample);\n\t\t\t\tfor (const [series, value, pixel, label] of [\n\t\t\t\t\t[\"y1\", a, sample.top, firstLabel],\n\t\t\t\t\t[\"y2\", b, sample.bottom, secondLabel],\n\t\t\t\t] as const) {\n\t\t\t\t\tpoints.push({\n\t\t\t\t\t\tkey: `${id}:${series}:${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: sample.x,\n\t\t\t\t\t\ty: pixel,\n\t\t\t\t\t\txValue: x,\n\t\t\t\t\t\tyValue: value,\n\t\t\t\t\t\tseries: `${id}:${series}`,\n\t\t\t\t\t\tseriesLabel: label,\n\t\t\t\t\t\tcolor:\n\t\t\t\t\t\t\tseries === \"y1\" ? context.theme.foreground : context.theme.muted,\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\tconst nodes: SceneNode[] = signRuns(samples).map((run, index) => ({\n\t\t\t\tkind: \"path\",\n\t\t\t\tkey: `${id}:band:${index}`,\n\t\t\t\trole: \"mark\",\n\t\t\t\td: areaPath(\n\t\t\t\t\trun.samples.map(\n\t\t\t\t\t\t(sample): ChartXY => ({ x: sample.x, y: sample.top }),\n\t\t\t\t\t),\n\t\t\t\t\trun.samples.map(\n\t\t\t\t\t\t(sample): ChartXY => ({ x: sample.x, y: sample.bottom }),\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t\tpaint: paint({\n\t\t\t\t\tfill: run.positive ? positive : negative,\n\t\t\t\t\tfillOpacity: options.fillOpacity ?? 0.35,\n\t\t\t\t}),\n\t\t\t}));\n\t\t\tnodes.push(\n\t\t\t\t{\n\t\t\t\t\tkind: \"path\",\n\t\t\t\t\tkey: `${id}:line:y1`,\n\t\t\t\t\tseries: `${id}:y1`,\n\t\t\t\t\trole: \"mark\",\n\t\t\t\t\td: linePath(\n\t\t\t\t\t\tsamples.map((sample) => ({ x: sample.x, y: sample.top })),\n\t\t\t\t\t),\n\t\t\t\t\tpaint: {\n\t\t\t\t\t\tfill: \"none\",\n\t\t\t\t\t\tstroke: context.theme.foreground,\n\t\t\t\t\t\tstrokeWidth: 1.5,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tkind: \"path\",\n\t\t\t\t\tkey: `${id}:line:y2`,\n\t\t\t\t\tseries: `${id}:y2`,\n\t\t\t\t\trole: \"mark\",\n\t\t\t\t\td: linePath(\n\t\t\t\t\t\tsamples.map((sample) => ({ x: sample.x, y: sample.bottom })),\n\t\t\t\t\t),\n\t\t\t\t\tpaint: {\n\t\t\t\t\t\tfill: \"none\",\n\t\t\t\t\t\tstroke: context.theme.muted,\n\t\t\t\t\t\tstrokeWidth: 1.5,\n\t\t\t\t\t\tstrokeDasharray: \"4 3\",\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t);\n\t\t\treturn {\n\t\t\t\tnodes,\n\t\t\t\tpoints,\n\t\t\t\tlegend: [\n\t\t\t\t\t{\n\t\t\t\t\t\tkey: `${id}:y1`,\n\t\t\t\t\t\tlabel: firstLabel,\n\t\t\t\t\t\tcolor: context.theme.foreground,\n\t\t\t\t\t\tshape: \"line\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tkey: `${id}:y2`,\n\t\t\t\t\t\tlabel: secondLabel,\n\t\t\t\t\t\tcolor: context.theme.muted,\n\t\t\t\t\t\tshape: \"dashed\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t};\n\t\t},\n\t};\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/marks/stats/distribution.d.ts

@@ -0,0 +1,41 @@
+import type { ChartAccessor, ChartMark, ChartValue } from "../../types.js";
+/**
+ * Distributions per category: the box plot, the violin and the ridgeline.
+ * Each groups the values by category first; a category's point (what the
+ * keyboard visits) sits on its median.
+ */
+interface DistributionOptions<TDatum> {
+    readonly id?: string;
+    readonly label?: string;
+    readonly fill?: string;
+    readonly opacity?: number;
+    readonly tip?: boolean;
+    readonly category: ChartAccessor<TDatum, ChartValue>;
+    readonly value: ChartAccessor<TDatum, ChartValue>;
+}
+export interface BoxOptions<TDatum> extends DistributionOptions<TDatum> {
+    /** Share of the band the box takes. */
+    readonly width?: number;
+}
+/**
+ * Box and whiskers per category: the box from the first to the third
+ * quartile, the median across it, whiskers to the furthest values within
+ * 1.5 IQR, and the outliers past them as dots.
+ */
+export declare function boxY<TDatum>(data: ReadonlyArray<TDatum>, options: BoxOptions<TDatum>): ChartMark;
+/**
+ * The density of each category's values, mirrored around its centre: the
+ * shape a box plot hides (two peaks, a long tail).
+ */
+export declare function violinY<TDatum>(data: ReadonlyArray<TDatum>, options: DistributionOptions<TDatum>): ChartMark;
+export interface RidgelineOptions<TDatum> extends DistributionOptions<TDatum> {
+    /** How far each ridge may rise into the row above: 1 stays in its row. */
+    readonly overlap?: number;
+}
+/**
+ * One density per row, stacked down the chart and allowed to overlap the row
+ * above: many distributions compared along one shared x axis.
+ */
+export declare function ridgeline<TDatum>(data: ReadonlyArray<TDatum>, options: RidgelineOptions<TDatum>): ChartMark;
+export {};
+//# sourceMappingURL=distribution.d.ts.map

package/dist/core/marks/stats/distribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../../../src/core/marks/stats/distribution.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACX,aAAa,EACb,SAAS,EAET,UAAU,EAEV,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AAEH,UAAU,mBAAmB,CAAC,MAAM;IACnC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAClD;AAmCD,MAAM,WAAW,UAAU,CAAC,MAAM,CAAE,SAAQ,mBAAmB,CAAC,MAAM,CAAC;IACtE,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAC1B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,GACzB,SAAS,CAsHX;AAID;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAC7B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAClC,SAAS,CAyGX;AAID,MAAM,WAAW,gBAAgB,CAAC,MAAM,CAAE,SAAQ,mBAAmB,CAAC,MAAM,CAAC;IAC5E,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAC/B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAC/B,SAAS,CAuFX"}