graphein 0.18.0 → 0.20.0

package/dist/axes/tickLabels.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/axes/tickLabels.ts"],
+  "sourcesContent": ["import { fontString, measureText } from '../render/text';\nimport { fitLabel, labelBox, labelsOverlap, type LabelRecord } from '../render/labelLedger';\nimport type { Frame } from '../layout';\nimport type { CartesianModel } from '../runtime/cartesian';\n\n/** Thin out x tick labels that would overlap, keeping a readable subset. */\nexport function thinXTicks(model: CartesianModel, avgCharPx: number): typeof model.xTicks {\n  const ticks = model.xTicks;\n  if (ticks.length <= 1) return ticks;\n  const longest = ticks.reduce((m, t) => Math.max(m, t.label.length), 0);\n  const needed = longest * avgCharPx + 10;\n  const available = model.plot.width / ticks.length;\n  if (available >= needed) return ticks;\n  const stride = Math.ceil(needed / available);\n  return ticks.filter((_, i) => i % stride === 0);\n}\n\n/**\n * Thin gutter (left-axis) tick labels that would overlap vertically.\n *\n * Unlike the x axis \u00E2\u20AC\u201D where label widths vary and a measured sweep decides what\n * to drop \u00E2\u20AC\u201D gutter ticks are evenly spaced and all one line tall, so a stride\n * yields a readable, regularly-spaced subset. The final tick is re-added when\n * there is room, so the axis still shows the top of its range.\n */\nexport function thinGutterTicks<T extends { pos: number }>(ticks: T[], fontSize: number): T[] {\n  if (ticks.length <= 2) return ticks;\n  const minGap = fontSize * 1.35;\n  const span = Math.abs(ticks[ticks.length - 1].pos - ticks[0].pos);\n  const gap = span / (ticks.length - 1);\n  if (gap >= minGap) return ticks;\n  const stride = Math.ceil(minGap / Math.max(gap, 1e-6));\n  const kept = ticks.filter((_, i) => i % stride === 0);\n  const last = ticks[ticks.length - 1];\n  const tail = kept[kept.length - 1];\n  if (tail !== last && Math.abs(last.pos - tail.pos) >= minGap) kept.push(last);\n  return kept;\n}\n\ninterface PlacedLabel {\n  text: string;\n  pos: number;\n  left: number;\n  transform: string;\n}\n\n/**\n * Resolve thinned x ticks into non-overlapping label boxes. Each label is\n * centered on its tick, except the first/last which are clamped to the surface\n * edges. A left\u00E2\u2020\u2019right sweep then drops any label whose box would collide with\n * the previous kept label or with the final label, so the right-edge label is\n * always preserved without overlap (fixes \"Aug 2023Sep 2023\" style run-ons).\n */\nexport function placeXLabels(\n  ticks: CartesianModel['xTicks'],\n  originX: number,\n  frameWidth: number,\n  font: string,\n): PlacedLabel[] {\n  const edgePad = 2;\n  const minGap = 6;\n  const loEdge = originX + edgePad;\n  const hiEdge = originX + frameWidth - edgePad;\n  const boxes = ticks.map((t) => {\n    const w = measureText(t.label, font).width;\n    const half = w / 2;\n    let left = t.pos;\n    let transform = 'translateX(-50%)';\n    let bl = t.pos - half;\n    let br = t.pos + half;\n    if (bl < loEdge) {\n      left = loEdge;\n      transform = 'none';\n      bl = loEdge;\n      br = loEdge + w;\n    } else if (br > hiEdge) {\n      left = hiEdge;\n      transform = 'translateX(-100%)';\n      br = hiEdge;\n      bl = br - w;\n    }\n    return { text: t.label, pos: t.pos, left, transform, bl, br };\n  });\n  if (boxes.length <= 1) return boxes;\n\n  const n = boxes.length;\n  const last = boxes[n - 1];\n  const keep = new Array<boolean>(n).fill(false);\n  keep[n - 1] = true;\n  let prevBr = -Infinity;\n  for (let i = 0; i < n - 1; i += 1) {\n    const b = boxes[i];\n    if (b.bl < prevBr + minGap) continue; // overlaps the previous kept label\n    if (b.br + minGap > last.bl) break; // would overlap the final label\n    keep[i] = true;\n    prevBr = b.br;\n  }\n  return boxes.filter((_, i) => keep[i]);\n}\n\nexport function flatLabelBounds(frame: Frame): { originX: number; width: number } {\n  let left = frame.originX;\n  let right = frame.originX + frame.width;\n  if (frame.legendRect && frame.legendPosition === 'left') {\n    left = Math.max(left, frame.legendRect.x + frame.legendRect.width);\n  } else if (frame.legendRect && frame.legendPosition === 'right') {\n    right = Math.min(right, frame.legendRect.x);\n  }\n  return { originX: left, width: Math.max(0, right - left) };\n}\n\n/** Rotation still needs a readable perpendicular gap and finite edge budgets. */\nexport function placeRotatedXLabels(model: CartesianModel, angle: number, font: string): PlacedLabel[] {\n  const size = model.tokens.font.size.small;\n  const radians = (angle * Math.PI) / 180;\n  let widest = 0;\n  for (const tick of model.xTicks) {\n    const text = fitLabel(tick.label, model.frame.xLabelMaxWidth, font).text;\n    widest = Math.max(widest, measureText(text, font).width);\n  }\n  const spacing = Math.min(size / Math.sin(radians), (widest + 6) / (Math.cos(radians) * 1.35));\n  const ticks = thinGutterTicks(model.xTicks, spacing);\n  const lo = model.frame.originX + 1;\n  const hi = model.frame.originX + model.frame.width - 1;\n  const transform = `translateX(-100%) rotate(-${angle}deg)`;\n  const placed: PlacedLabel[] = [];\n  let previous: LabelRecord | undefined;\n  for (const tick of ticks) {\n    const fitted = fitLabel(tick.label, model.frame.xLabelMaxWidth, font);\n    const geometry = labelBox(\n      { left: tick.pos, top: 0, text: fitted.text, color: '', size, transform },\n      font,\n    );\n    const { box } = geometry;\n    const shift = box.x < lo ? lo - box.x : Math.min(0, hi - box.x - box.width);\n    const record: LabelRecord = {\n      role: 'axis-label',\n      text: fitted.text,\n      fullText: tick.label,\n      truncated: fitted.truncated,\n      size,\n      box: { ...box, x: box.x + shift },\n      angle: geometry.angle,\n    };\n    if (previous && labelsOverlap(previous, record, 2)) continue;\n    placed.push({ text: tick.label, pos: tick.pos, left: tick.pos + shift, transform });\n    previous = record;\n  }\n  return placed;\n}\n\n/** Compute readable placed x labels for a model. Shared by the gridline/tick underlay and\n * the label overlay so they stay perfectly aligned. */\nexport function resolveXLabels(model: CartesianModel): PlacedLabel[] {\n  const f = model.tokens.font;\n  const angle = model.frame.xLabelAngle;\n  const smallFont = fontString(f.size.small, f.family, f.weight.normal);\n  if (angle > 0) return placeRotatedXLabels(model, angle, smallFont);\n  const thinned = thinXTicks(model, f.size.small * 0.58);\n  const bounds = flatLabelBounds(model.frame);\n  return placeXLabels(thinned, bounds.originX, bounds.width, smallFont);\n}\n\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/axes/title.d.ts

@@ -0,0 +1,7 @@
+import type { Surface } from '../render/surface.js';
+import type { Frame } from '../layout/index.js';
+import type { CartesianModel } from '../runtime/cartesian.js';
+import type { ThemeTokens } from '../theme/index.js';
+export declare function drawAxisTitles(surface: Surface, model: CartesianModel): void;
+export declare function drawTitle(surface: Surface, frame: Frame, spec: CartesianModel['spec'], tokens: ThemeTokens): void;
+//# sourceMappingURL=title.d.ts.map

package/dist/axes/title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../src/axes/title.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAgB5C,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAY5E;AAkHD,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,WAAW,GAClB,IAAI,CAuDN"}

package/dist/axes/title.js

@@ -0,0 +1,151 @@
+import { fontString } from "../render/text.js";
+import { addText } from "./text.js";
+function drawAxisTitles(surface, model) {
+  const state = axisTitleState(model);
+  if (model.frame.dropped?.includes("axis-titles")) {
+    omitDroppedAxisTitles(surface, model, state);
+    return;
+  }
+  if (model.orientation === "horizontal") {
+    drawHorizontalAxisTitles(surface, model, state);
+    return;
+  }
+  drawVerticalAxisTitles(surface, model, state);
+}
+function axisTitleState(model) {
+  const { tokens, frame } = model;
+  const f = tokens.font;
+  const titleHeight = Math.round(f.size.base * 1.35);
+  const chromeGap = frame.density === "compact" ? 8 : f.size.base;
+  return {
+    xTitle: model.spec.axes?.x?.show === false ? void 0 : model.spec.axes?.x?.title ?? model.spec.encoding.x.title,
+    yTitle: model.spec.axes?.y?.show === false ? void 0 : model.spec.axes?.y?.title ?? model.spec.encoding.y.title,
+    baseFont: fontString(f.size.base, f.family, f.weight.medium),
+    titleHeight,
+    bottomTitleTop: frame.legendRect && frame.legendPosition === "bottom" ? frame.legendRect.y - chromeGap - titleHeight : frame.originY + frame.height - titleHeight,
+    leftTitleAnchor: frame.legendRect && frame.legendPosition === "left" ? frame.legendRect.x + frame.legendRect.width + chromeGap : frame.originX
+  };
+}
+function omitDroppedAxisTitles(surface, model, state) {
+  if (state.xTitle) {
+    surface.labels?.omit({
+      role: "axis-title",
+      reason: "frame",
+      required: true,
+      example: state.xTitle,
+      axis: "x",
+      path: model.spec.axes?.x?.title != null ? "/axes/x/title" : "/encoding/x/title"
+    });
+  }
+  if (state.yTitle) {
+    surface.labels?.omit({
+      role: "axis-title",
+      reason: "frame",
+      required: true,
+      example: state.yTitle,
+      axis: "y",
+      path: model.spec.axes?.y?.title != null ? "/axes/y/title" : "/encoding/y/title"
+    });
+  }
+}
+function drawHorizontalAxisTitles(surface, model, state) {
+  if (state.yTitle) drawBottomAxisTitle(surface, model, state, state.yTitle, "y");
+  if (state.xTitle) drawLeftAxisTitle(surface, model, state, state.xTitle, "x");
+}
+function drawVerticalAxisTitles(surface, model, state) {
+  if (state.xTitle) drawBottomAxisTitle(surface, model, state, state.xTitle, "x");
+  if (state.yTitle) drawLeftAxisTitle(surface, model, state, state.yTitle, "y");
+}
+function drawBottomAxisTitle(surface, model, state, text, axis) {
+  const { plot, tokens } = model;
+  const f = tokens.font;
+  addText(surface, state.baseFont, {
+    left: plot.x + plot.width / 2,
+    top: state.bottomTitleTop,
+    text,
+    color: tokens.color.text,
+    size: f.size.base,
+    weight: f.weight.medium,
+    transform: "translateX(-50%)",
+    maxWidth: plot.width,
+    role: "axis-title",
+    axis
+  });
+}
+function drawLeftAxisTitle(surface, model, state, text, axis) {
+  const { plot, tokens } = model;
+  const f = tokens.font;
+  addText(surface, state.baseFont, {
+    left: state.leftTitleAnchor + Math.round(f.size.base * 0.4),
+    top: plot.y + plot.height / 2,
+    text,
+    color: tokens.color.text,
+    size: f.size.base,
+    weight: f.weight.medium,
+    transform: "translate(-50%, -50%) rotate(-90deg)",
+    maxWidth: plot.height,
+    role: "axis-title",
+    axis
+  });
+}
+function drawTitle(surface, frame, spec, tokens) {
+  const f = tokens.font;
+  const title = typeof spec.title === "string" ? { text: spec.title } : spec.title ?? {};
+  if (!frame.titleRect) {
+    if (title.text)
+      surface.labels?.omit({
+        role: "title",
+        reason: "frame",
+        required: true,
+        example: title.text,
+        path: "/title"
+      });
+    if (title.subtitle)
+      surface.labels?.omit({
+        role: "subtitle",
+        reason: "frame",
+        required: true,
+        example: title.subtitle,
+        path: "/title/subtitle"
+      });
+    return;
+  }
+  if (title.subtitle && !frame.subtitleRect)
+    surface.labels?.omit({
+      role: "subtitle",
+      reason: "frame",
+      required: true,
+      example: title.subtitle,
+      path: "/title/subtitle"
+    });
+  const align = typeof spec.title === "object" && spec.title?.align || "left";
+  const titleFont = fontString(f.size.title, f.family, f.weight.bold);
+  addText(surface, titleFont, {
+    left: frame.titleRect.x,
+    top: frame.titleRect.y,
+    width: frame.titleRect.width,
+    text: title.text ?? "",
+    color: tokens.color.text,
+    size: f.size.title,
+    weight: f.weight.bold,
+    align,
+    role: "title"
+  });
+  if (frame.subtitleRect && title.subtitle) {
+    addText(surface, fontString(f.size.small, f.family, f.weight.normal), {
+      left: frame.subtitleRect.x,
+      top: frame.subtitleRect.y,
+      width: frame.subtitleRect.width,
+      text: title.subtitle,
+      color: tokens.color.textMuted,
+      size: f.size.small,
+      align,
+      role: "subtitle"
+    });
+  }
+}
+export {
+  drawAxisTitles,
+  drawTitle
+};
+//# sourceMappingURL=title.js.map

package/dist/axes/title.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/axes/title.ts"],
+  "sourcesContent": ["import type { Surface } from '../render/surface';\nimport { fontString } from '../render/text';\nimport type { Frame } from '../layout';\nimport type { CartesianModel } from '../runtime/cartesian';\nimport type { ThemeTokens } from '../theme';\nimport { addText } from './text';\n\n/**\n * Precomputed axis-title placement facts. Both orientations use the same title\n * strings and anchors; only which title goes bottom vs. left changes.\n */\ninterface AxisTitleState {\n  xTitle?: string;\n  yTitle?: string;\n  baseFont: string;\n  titleHeight: number;\n  bottomTitleTop: number;\n  leftTitleAnchor: number;\n}\n\nexport function drawAxisTitles(surface: Surface, model: CartesianModel): void {\n  const state = axisTitleState(model);\n  if (model.frame.dropped?.includes('axis-titles')) {\n    omitDroppedAxisTitles(surface, model, state);\n    return;\n  }\n\n  if (model.orientation === 'horizontal') {\n    drawHorizontalAxisTitles(surface, model, state);\n    return;\n  }\n  drawVerticalAxisTitles(surface, model, state);\n}\n\n/** Resolve title text and chrome-aware anchors once for both orientations. */\nfunction axisTitleState(model: CartesianModel): AxisTitleState {\n  const { tokens, frame } = model;\n  const f = tokens.font;\n  const titleHeight = Math.round(f.size.base * 1.35);\n  const chromeGap = frame.density === 'compact' ? 8 : f.size.base;\n  return {\n    xTitle: model.spec.axes?.x?.show === false\n      ? undefined\n      : (model.spec.axes?.x?.title ?? model.spec.encoding.x.title),\n    yTitle: model.spec.axes?.y?.show === false\n      ? undefined\n      : (model.spec.axes?.y?.title ?? model.spec.encoding.y.title),\n    baseFont: fontString(f.size.base, f.family, f.weight.medium),\n    titleHeight,\n    bottomTitleTop: frame.legendRect && frame.legendPosition === 'bottom'\n      ? frame.legendRect.y - chromeGap - titleHeight\n      : frame.originY + frame.height - titleHeight,\n    leftTitleAnchor: frame.legendRect && frame.legendPosition === 'left'\n      ? frame.legendRect.x + frame.legendRect.width + chromeGap\n      : frame.originX,\n  };\n}\n\n/**\n * Frame compaction can drop axis-title chrome before drawing. Suppressed-title\n * records keep reports honest about identifying text that did not fit.\n */\nfunction omitDroppedAxisTitles(surface: Surface, model: CartesianModel, state: AxisTitleState): void {\n  if (state.xTitle) {\n    surface.labels?.omit({\n      role: 'axis-title',\n      reason: 'frame',\n      required: true,\n      example: state.xTitle,\n      axis: 'x',\n      path: model.spec.axes?.x?.title != null ? '/axes/x/title' : '/encoding/x/title',\n    });\n  }\n  if (state.yTitle) {\n    surface.labels?.omit({\n      role: 'axis-title',\n      reason: 'frame',\n      required: true,\n      example: state.yTitle,\n      axis: 'y',\n      path: model.spec.axes?.y?.title != null ? '/axes/y/title' : '/encoding/y/title',\n    });\n  }\n}\n\n/** In horizontal mode, y is the bottom value axis and x is the left category axis. */\nfunction drawHorizontalAxisTitles(surface: Surface, model: CartesianModel, state: AxisTitleState): void {\n  // Value title along the bottom; category title down the left, rotated.\n  if (state.yTitle) drawBottomAxisTitle(surface, model, state, state.yTitle, 'y');\n  if (state.xTitle) drawLeftAxisTitle(surface, model, state, state.xTitle, 'x');\n}\n\n/** In standard vertical mode, x is bottom and y is the rotated left title. */\nfunction drawVerticalAxisTitles(surface: Surface, model: CartesianModel, state: AxisTitleState): void {\n  if (state.xTitle) drawBottomAxisTitle(surface, model, state, state.xTitle, 'x');\n  if (state.yTitle) drawLeftAxisTitle(surface, model, state, state.yTitle, 'y');\n}\n\n/** Draw a centered title below the plot, optionally above a bottom legend. */\nfunction drawBottomAxisTitle(\n  surface: Surface,\n  model: CartesianModel,\n  state: AxisTitleState,\n  text: string,\n  axis: 'x' | 'y',\n): void {\n  const { plot, tokens } = model;\n  const f = tokens.font;\n  addText(surface, state.baseFont, {\n    left: plot.x + plot.width / 2,\n    top: state.bottomTitleTop,\n    text,\n    color: tokens.color.text,\n    size: f.size.base,\n    weight: f.weight.medium,\n    transform: 'translateX(-50%)',\n    maxWidth: plot.width,\n    role: 'axis-title',\n    axis,\n  });\n}\n\n/** Draw a rotated title in the left gutter beside the plot. */\nfunction drawLeftAxisTitle(\n  surface: Surface,\n  model: CartesianModel,\n  state: AxisTitleState,\n  text: string,\n  axis: 'x' | 'y',\n): void {\n  const { plot, tokens } = model;\n  const f = tokens.font;\n  addText(surface, state.baseFont, {\n    left: state.leftTitleAnchor + Math.round(f.size.base * 0.4),\n    top: plot.y + plot.height / 2,\n    text,\n    color: tokens.color.text,\n    size: f.size.base,\n    weight: f.weight.medium,\n    transform: 'translate(-50%, -50%) rotate(-90deg)',\n    maxWidth: plot.height,\n    role: 'axis-title',\n    axis,\n  });\n}\n\nexport function drawTitle(\n  surface: Surface,\n  frame: Frame,\n  spec: CartesianModel['spec'],\n  tokens: ThemeTokens,\n): void {\n  const f = tokens.font;\n  const title = typeof spec.title === 'string' ? { text: spec.title } : (spec.title ?? {});\n  if (!frame.titleRect) {\n    if (title.text)\n      surface.labels?.omit({\n        role: 'title',\n        reason: 'frame',\n        required: true,\n        example: title.text,\n        path: '/title',\n      });\n    if (title.subtitle)\n      surface.labels?.omit({\n        role: 'subtitle',\n        reason: 'frame',\n        required: true,\n        example: title.subtitle,\n        path: '/title/subtitle',\n      });\n    return;\n  }\n  if (title.subtitle && !frame.subtitleRect)\n    surface.labels?.omit({\n      role: 'subtitle',\n      reason: 'frame',\n      required: true,\n      example: title.subtitle,\n      path: '/title/subtitle',\n    });\n  const align = (typeof spec.title === 'object' && spec.title?.align) || 'left';\n  const titleFont = fontString(f.size.title, f.family, f.weight.bold);\n  addText(surface, titleFont, {\n    left: frame.titleRect.x,\n    top: frame.titleRect.y,\n    width: frame.titleRect.width,\n    text: title.text ?? '',\n    color: tokens.color.text,\n    size: f.size.title,\n    weight: f.weight.bold,\n    align,\n    role: 'title',\n  });\n  if (frame.subtitleRect && title.subtitle) {\n    addText(surface, fontString(f.size.small, f.family, f.weight.normal), {\n      left: frame.subtitleRect.x,\n      top: frame.subtitleRect.y,\n      width: frame.subtitleRect.width,\n      text: title.subtitle,\n      color: tokens.color.textMuted,\n      size: f.size.small,\n      align,\n      role: 'subtitle',\n    });\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/charts/annotations.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Reference annotations for cartesian charts — lines, bands, and threshold zones.
+ *
+ * A cross-cutting overlay primitive available to every cartesian chart via
+ * `spec.annotations`. Marks (the rule strokes and band fills) are painted on the
+ * marks canvas; labels live in the HTML overlay for crisp, selectable text,
+ * mirroring how axes render. Geometry comes from the already-resolved
+ * `CartesianModel` scales, so this module is pure presentation.
+ */
+import type { Surface } from '../render/surface.js';
+import type { CartesianModel } from '../runtime/cartesian.js';
+/**
+ * Paint reference lines and band/zone fills on the marks canvas, clipped to the
+ * plot. Call after the chart's data marks so reference lines sit on top.
+ */
+export declare function drawAnnotations(surface: Surface, model: CartesianModel): void;
+/**
+ * Append annotation labels to the HTML overlay. Call after `drawOverlay` so the
+ * labels layer on top of axis text. No-op when there are no labeled annotations.
+ */
+export declare function drawAnnotationLabels(surface: Surface, model: CartesianModel): void;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/charts/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/charts/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAgE3D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAkG7E;AAyCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CA4ElF"}

package/dist/charts/annotations.js

@@ -0,0 +1,233 @@
+import { fontString } from "../render/text.js";
+import { overlayTextToCanvasCmd, paintCanvasText } from "../render/overlayText.js";
+import { autoInsightAnnotations } from "../analyze/autoInsights.js";
+import { crisp } from "../util/math.js";
+const DEFAULT_DASH = [5, 4];
+const DEFAULT_FILL_OPACITY = 0.12;
+const DEFAULT_MARKER_RADIUS = 3.5;
+function kindOf(ann) {
+  if (ann.type === "point") return "point";
+  if (ann.type === "line") return "line";
+  if (ann.type === "band" || ann.type === "zone") return "band";
+  return ann.value !== void 0 ? "line" : "band";
+}
+function toPixel(model, axis, value) {
+  if (value === void 0 || value === null) return void 0;
+  const px = axis === "x" ? model.x.pixel(value) : model.y.pixel(value);
+  return px != null && Number.isFinite(px) ? px : void 0;
+}
+function pointPixels(model, ann) {
+  const cat = toPixel(model, "x", ann.x);
+  const val = toPixel(model, "y", ann.y);
+  if (cat === void 0 || val === void 0) return void 0;
+  const { x, y } = model.project(cat, val);
+  return { px: x, py: y };
+}
+function drawsHorizontalRule(model, axis) {
+  return model.orientation === "horizontal" ? axis === "x" : axis === "y";
+}
+function anchorPixel(model, ann, axis, kind) {
+  if (kind === "line") return toPixel(model, axis, ann.value);
+  const a = toPixel(model, axis, ann.from);
+  const b = toPixel(model, axis, ann.to);
+  if (a === void 0 || b === void 0) return void 0;
+  return (a + b) / 2;
+}
+function annotationsOf(model) {
+  const spec = model.spec;
+  const explicit = Array.isArray(spec.annotations) ? spec.annotations : [];
+  if (!spec.insights) return explicit;
+  const auto = autoInsightAnnotations(model.spec);
+  return auto.length ? [...explicit, ...auto] : explicit;
+}
+function drawAnnotations(surface, model) {
+  const list = annotationsOf(model);
+  if (list.length === 0) return;
+  const ctx = surface.marks.ctx;
+  const { plot, tokens } = model;
+  const x1 = plot.x + plot.width;
+  const y1 = plot.y + plot.height;
+  ctx.save();
+  ctx.beginPath();
+  ctx.rect(plot.x, plot.y, plot.width, plot.height);
+  ctx.clip();
+  for (const ann of list) {
+    if (kindOf(ann) === "point") {
+      const pt = pointPixels(model, ann);
+      if (!pt) continue;
+      const r = ann.markerRadius ?? DEFAULT_MARKER_RADIUS;
+      const dot = ann.color ?? tokens.color.text;
+      ctx.save();
+      ctx.fillStyle = tokens.color.background;
+      ctx.globalAlpha = 0.9;
+      ctx.beginPath();
+      ctx.arc(pt.px, pt.py, r + 1.6, 0, Math.PI * 2);
+      ctx.fill();
+      ctx.globalAlpha = 1;
+      ctx.fillStyle = dot;
+      ctx.beginPath();
+      ctx.arc(pt.px, pt.py, r, 0, Math.PI * 2);
+      ctx.fill();
+      ctx.restore();
+      continue;
+    }
+    const axis = ann.axis === "x" ? "x" : "y";
+    const color = ann.color ?? tokens.color.textMuted;
+    const ruleHorizontal = drawsHorizontalRule(model, axis);
+    if (kindOf(ann) === "line") {
+      const p = toPixel(model, axis, ann.value);
+      if (p === void 0) continue;
+      ctx.save();
+      ctx.strokeStyle = color;
+      ctx.lineWidth = ann.strokeWidth ?? 1.5;
+      ctx.setLineDash(ann.strokeDash ?? DEFAULT_DASH);
+      ctx.beginPath();
+      if (ruleHorizontal) {
+        const y = crisp(p);
+        ctx.moveTo(plot.x, y);
+        ctx.lineTo(x1, y);
+      } else {
+        const x = crisp(p);
+        ctx.moveTo(x, plot.y);
+        ctx.lineTo(x, y1);
+      }
+      ctx.stroke();
+      ctx.restore();
+      continue;
+    }
+    const a = toPixel(model, axis, ann.from);
+    const b = toPixel(model, axis, ann.to);
+    if (a === void 0 || b === void 0) continue;
+    const lo = Math.min(a, b);
+    const hi = Math.max(a, b);
+    ctx.save();
+    ctx.globalAlpha = ann.fillOpacity ?? DEFAULT_FILL_OPACITY;
+    ctx.fillStyle = color;
+    if (ruleHorizontal) ctx.fillRect(plot.x, lo, plot.width, hi - lo);
+    else ctx.fillRect(lo, plot.y, hi - lo, plot.height);
+    ctx.restore();
+    ctx.save();
+    ctx.strokeStyle = color;
+    ctx.globalAlpha = 0.55;
+    ctx.lineWidth = 1;
+    ctx.setLineDash(ann.strokeDash ?? [4, 4]);
+    ctx.beginPath();
+    if (ruleHorizontal) {
+      ctx.moveTo(plot.x, crisp(lo));
+      ctx.lineTo(x1, crisp(lo));
+      ctx.moveTo(plot.x, crisp(hi));
+      ctx.lineTo(x1, crisp(hi));
+    } else {
+      ctx.moveTo(crisp(lo), plot.y);
+      ctx.lineTo(crisp(lo), y1);
+      ctx.moveTo(crisp(hi), plot.y);
+      ctx.lineTo(crisp(hi), y1);
+    }
+    ctx.stroke();
+    ctx.restore();
+  }
+  ctx.restore();
+}
+function labelBox(model, horizontalRule, pos, p) {
+  const { plot } = model;
+  const inset = 6;
+  if (horizontalRule) {
+    const top = p - 3;
+    if (pos === "start") {
+      return { left: plot.x + inset, top, align: "left", transform: "translateY(-100%)" };
+    }
+    if (pos === "middle") {
+      return { left: plot.x + plot.width / 2, top, align: "center", transform: "translateX(-50%) translateY(-100%)" };
+    }
+    return { left: plot.x + plot.width - inset, top, align: "right", transform: "translateX(-100%) translateY(-100%)" };
+  }
+  const left = p;
+  const transform = "translateX(-50%)";
+  if (pos === "start") return { left, top: plot.y + plot.height - 16, align: "center", transform };
+  if (pos === "middle") return { left, top: plot.y + plot.height / 2, align: "center", transform };
+  return { left, top: plot.y + 2, align: "center", transform };
+}
+function drawAnnotationLabels(surface, model) {
+  const list = annotationsOf(model);
+  if (list.length === 0) return;
+  const overlay = surface.overlay;
+  const { tokens } = model;
+  const f = tokens.font;
+  const font = fontString(f.size.small, f.family, f.weight.medium);
+  for (const ann of list) {
+    if (!ann.label) continue;
+    let box;
+    if (kindOf(ann) === "point") {
+      const pt = pointPixels(model, ann);
+      if (!pt) continue;
+      const r = ann.markerRadius ?? DEFAULT_MARKER_RADIUS;
+      const gap = r + 4;
+      const textH = f.size.small;
+      const aboveTop = pt.py - gap - textH;
+      const top = aboveTop < model.plot.y ? pt.py + gap : aboveTop;
+      box = { left: pt.px, top, align: "center", transform: "translateX(-50%)" };
+    } else {
+      const axis = ann.axis === "x" ? "x" : "y";
+      const p = anchorPixel(model, ann, axis, kindOf(ann));
+      if (p === void 0) continue;
+      box = labelBox(model, drawsHorizontalRule(model, axis), ann.labelPosition ?? "end", p);
+    }
+    const color = ann.color ?? tokens.color.text;
+    const pill = { background: withAlpha(tokens.color.background, 0.72), radius: 3, padX: 3, padY: 1 };
+    if (surface.headless) {
+      paintCanvasText(
+        surface.marks.ctx,
+        overlayTextToCanvasCmd(
+          {
+            left: box.left,
+            top: box.top,
+            width: box.width ?? void 0,
+            text: ann.label,
+            color,
+            size: f.size.small,
+            align: box.align,
+            transform: box.transform,
+            pill
+          },
+          font
+        )
+      );
+      continue;
+    }
+    const el = document.createElement("div");
+    el.textContent = ann.label;
+    el.style.position = "absolute";
+    el.style.font = font;
+    el.style.fontSize = `${f.size.small}px`;
+    el.style.fontWeight = String(f.weight.medium);
+    el.style.color = color;
+    el.style.whiteSpace = "nowrap";
+    el.style.left = `${box.left}px`;
+    el.style.top = `${box.top}px`;
+    if (box.width != null) {
+      el.style.width = `${box.width}px`;
+      el.style.textAlign = box.align;
+    }
+    el.style.transform = box.transform;
+    el.style.padding = "0 3px";
+    el.style.borderRadius = "3px";
+    el.style.background = pill.background;
+    el.style.pointerEvents = "none";
+    overlay.appendChild(el);
+  }
+}
+function withAlpha(color, alpha) {
+  const m = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(color);
+  if (!m) return color;
+  let hex = m[1];
+  if (hex.length === 3) hex = hex.split("").map((c) => c + c).join("");
+  const r = parseInt(hex.slice(0, 2), 16);
+  const g = parseInt(hex.slice(2, 4), 16);
+  const b = parseInt(hex.slice(4, 6), 16);
+  return `rgba(${r}, ${g}, ${b}, ${alpha})`;
+}
+export {
+  drawAnnotationLabels,
+  drawAnnotations
+};
+//# sourceMappingURL=annotations.js.map

package/dist/charts/annotations.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/charts/annotations.ts"],
+  "sourcesContent": ["/**\n * Reference annotations for cartesian charts \u2014 lines, bands, and threshold zones.\n *\n * A cross-cutting overlay primitive available to every cartesian chart via\n * `spec.annotations`. Marks (the rule strokes and band fills) are painted on the\n * marks canvas; labels live in the HTML overlay for crisp, selectable text,\n * mirroring how axes render. Geometry comes from the already-resolved\n * `CartesianModel` scales, so this module is pure presentation.\n */\n\nimport type { Surface } from '../render/surface';\nimport type { Annotation, ChartSpec } from '../spec/types';\nimport type { CartesianModel } from '../runtime/cartesian';\nimport { fontString } from '../render/text';\nimport { overlayTextToCanvasCmd, paintCanvasText } from '../render/overlayText';\nimport { autoInsightAnnotations } from '../analyze/autoInsights';\nimport { crisp } from '../util/math';\n\ntype Axis = 'x' | 'y';\ntype Kind = 'line' | 'band' | 'point';\n\nconst DEFAULT_DASH = [5, 4];\nconst DEFAULT_FILL_OPACITY = 0.12;\nconst DEFAULT_MARKER_RADIUS = 3.5;\n\n/** Resolve whether an annotation is a single line, a filled span, or a point. */\nfunction kindOf(ann: Annotation): Kind {\n  if (ann.type === 'point') return 'point';\n  if (ann.type === 'line') return 'line';\n  if (ann.type === 'band' || ann.type === 'zone') return 'band';\n  return ann.value !== undefined ? 'line' : 'band';\n}\n\n/** Project an annotation value to its pixel on the given axis (or undefined). */\nfunction toPixel(model: CartesianModel, axis: Axis, value: unknown): number | undefined {\n  if (value === undefined || value === null) return undefined;\n  const px = axis === 'x' ? model.x.pixel(value) : model.y.pixel(value);\n  return px != null && Number.isFinite(px) ? px : undefined;\n}\n\n/** Resolve a `point` annotation's (x, y) data coords to plot pixels. */\nfunction pointPixels(model: CartesianModel, ann: Annotation): { px: number; py: number } | undefined {\n  const cat = toPixel(model, 'x', ann.x);\n  const val = toPixel(model, 'y', ann.y);\n  if (cat === undefined || val === undefined) return undefined;\n  const { x, y } = model.project(cat, val);\n  return { px: x, py: y };\n}\n\n/**\n * Whether an annotation on the given data axis draws as a horizontal rule on\n * screen. In vertical charts the value (`y`) axis is horizontal; in horizontal\n * bar charts the axes swap, so the category (`x`) axis becomes the horizontal one.\n */\nfunction drawsHorizontalRule(model: CartesianModel, axis: Axis): boolean {\n  return model.orientation === 'horizontal' ? axis === 'x' : axis === 'y';\n}\n\n/** Anchor pixel for an annotation's label (line value, or band midpoint). */\nfunction anchorPixel(model: CartesianModel, ann: Annotation, axis: Axis, kind: Kind): number | undefined {\n  if (kind === 'line') return toPixel(model, axis, ann.value);\n  const a = toPixel(model, axis, ann.from);\n  const b = toPixel(model, axis, ann.to);\n  if (a === undefined || b === undefined) return undefined;\n  return (a + b) / 2;\n}\n\n/** Explicit `spec.annotations` plus any auto-insight callouts (`spec.insights`). */\nfunction annotationsOf(model: CartesianModel): Annotation[] {\n  const spec = model.spec as { annotations?: Annotation[]; insights?: unknown };\n  const explicit = Array.isArray(spec.annotations) ? spec.annotations : [];\n  if (!spec.insights) return explicit;\n  const auto = autoInsightAnnotations(model.spec as ChartSpec);\n  return auto.length ? [...explicit, ...auto] : explicit;\n}\n\n/**\n * Paint reference lines and band/zone fills on the marks canvas, clipped to the\n * plot. Call after the chart's data marks so reference lines sit on top.\n */\nexport function drawAnnotations(surface: Surface, model: CartesianModel): void {\n  const list = annotationsOf(model);\n  if (list.length === 0) return;\n\n  const ctx = surface.marks.ctx;\n  const { plot, tokens } = model;\n  const x1 = plot.x + plot.width;\n  const y1 = plot.y + plot.height;\n\n  ctx.save();\n  ctx.beginPath();\n  ctx.rect(plot.x, plot.y, plot.width, plot.height);\n  ctx.clip();\n\n  for (const ann of list) {\n    if (kindOf(ann) === 'point') {\n      const pt = pointPixels(model, ann);\n      if (!pt) continue;\n      const r = ann.markerRadius ?? DEFAULT_MARKER_RADIUS;\n      const dot = ann.color ?? tokens.color.text;\n      ctx.save();\n      // A background halo keeps the marker legible over data marks.\n      ctx.fillStyle = tokens.color.background;\n      ctx.globalAlpha = 0.9;\n      ctx.beginPath();\n      ctx.arc(pt.px, pt.py, r + 1.6, 0, Math.PI * 2);\n      ctx.fill();\n      ctx.globalAlpha = 1;\n      ctx.fillStyle = dot;\n      ctx.beginPath();\n      ctx.arc(pt.px, pt.py, r, 0, Math.PI * 2);\n      ctx.fill();\n      ctx.restore();\n      continue;\n    }\n\n    const axis: Axis = ann.axis === 'x' ? 'x' : 'y';\n    const color = ann.color ?? tokens.color.textMuted;\n    const ruleHorizontal = drawsHorizontalRule(model, axis);\n\n    if (kindOf(ann) === 'line') {\n      const p = toPixel(model, axis, ann.value);\n      if (p === undefined) continue;\n      ctx.save();\n      ctx.strokeStyle = color;\n      ctx.lineWidth = ann.strokeWidth ?? 1.5;\n      ctx.setLineDash(ann.strokeDash ?? DEFAULT_DASH);\n      ctx.beginPath();\n      if (ruleHorizontal) {\n        const y = crisp(p);\n        ctx.moveTo(plot.x, y);\n        ctx.lineTo(x1, y);\n      } else {\n        const x = crisp(p);\n        ctx.moveTo(x, plot.y);\n        ctx.lineTo(x, y1);\n      }\n      ctx.stroke();\n      ctx.restore();\n      continue;\n    }\n\n    // Band / zone: a filled span between `from` and `to`, with a faint border.\n    const a = toPixel(model, axis, ann.from);\n    const b = toPixel(model, axis, ann.to);\n    if (a === undefined || b === undefined) continue;\n    const lo = Math.min(a, b);\n    const hi = Math.max(a, b);\n\n    ctx.save();\n    ctx.globalAlpha = ann.fillOpacity ?? DEFAULT_FILL_OPACITY;\n    ctx.fillStyle = color;\n    if (ruleHorizontal) ctx.fillRect(plot.x, lo, plot.width, hi - lo);\n    else ctx.fillRect(lo, plot.y, hi - lo, plot.height);\n    ctx.restore();\n\n    ctx.save();\n    ctx.strokeStyle = color;\n    ctx.globalAlpha = 0.55;\n    ctx.lineWidth = 1;\n    ctx.setLineDash(ann.strokeDash ?? [4, 4]);\n    ctx.beginPath();\n    if (ruleHorizontal) {\n      ctx.moveTo(plot.x, crisp(lo));\n      ctx.lineTo(x1, crisp(lo));\n      ctx.moveTo(plot.x, crisp(hi));\n      ctx.lineTo(x1, crisp(hi));\n    } else {\n      ctx.moveTo(crisp(lo), plot.y);\n      ctx.lineTo(crisp(lo), y1);\n      ctx.moveTo(crisp(hi), plot.y);\n      ctx.lineTo(crisp(hi), y1);\n    }\n    ctx.stroke();\n    ctx.restore();\n  }\n\n  ctx.restore();\n}\n\ninterface LabelBox {\n  left: number;\n  top: number;\n  width?: number;\n  align: 'left' | 'center' | 'right';\n  transform: string;\n}\n\n/** Resolve the overlay box for a label given whether its rule is horizontal on\n * screen, the anchor pixel, and the requested position. */\nfunction labelBox(\n  model: CartesianModel,\n  horizontalRule: boolean,\n  pos: 'start' | 'middle' | 'end',\n  p: number,\n): LabelBox {\n  const { plot } = model;\n  const inset = 6;\n  if (horizontalRule) {\n    // Horizontal line/band: label sits just above the rule, anchored horizontally.\n    // Anchor (rather than span a full-width box) so the backing pill hugs the text\n    // instead of drawing a band across the whole plot.\n    const top = p - 3;\n    if (pos === 'start') {\n      return { left: plot.x + inset, top, align: 'left', transform: 'translateY(-100%)' };\n    }\n    if (pos === 'middle') {\n      return { left: plot.x + plot.width / 2, top, align: 'center', transform: 'translateX(-50%) translateY(-100%)' };\n    }\n    return { left: plot.x + plot.width - inset, top, align: 'right', transform: 'translateX(-100%) translateY(-100%)' };\n  }\n  // Vertical line/band: label anchored at top (end), bottom (start), or middle.\n  const left = p;\n  const transform = 'translateX(-50%)';\n  if (pos === 'start') return { left, top: plot.y + plot.height - 16, align: 'center', transform };\n  if (pos === 'middle') return { left, top: plot.y + plot.height / 2, align: 'center', transform };\n  return { left, top: plot.y + 2, align: 'center', transform };\n}\n\n/**\n * Append annotation labels to the HTML overlay. Call after `drawOverlay` so the\n * labels layer on top of axis text. No-op when there are no labeled annotations.\n */\nexport function drawAnnotationLabels(surface: Surface, model: CartesianModel): void {\n  const list = annotationsOf(model);\n  if (list.length === 0) return;\n\n  const overlay = surface.overlay;\n  const { tokens } = model;\n  const f = tokens.font;\n  const font = fontString(f.size.small, f.family, f.weight.medium);\n\n  for (const ann of list) {\n    if (!ann.label) continue;\n\n    let box: LabelBox;\n    if (kindOf(ann) === 'point') {\n      const pt = pointPixels(model, ann);\n      if (!pt) continue;\n      const r = ann.markerRadius ?? DEFAULT_MARKER_RADIUS;\n      const gap = r + 4;\n      const textH = f.size.small;\n      // Sit above the marker; flip below when that would clip the plot top.\n      const aboveTop = pt.py - gap - textH;\n      const top = aboveTop < model.plot.y ? pt.py + gap : aboveTop;\n      box = { left: pt.px, top, align: 'center', transform: 'translateX(-50%)' };\n    } else {\n      const axis: Axis = ann.axis === 'x' ? 'x' : 'y';\n      const p = anchorPixel(model, ann, axis, kindOf(ann));\n      if (p === undefined) continue;\n      box = labelBox(model, drawsHorizontalRule(model, axis), ann.labelPosition ?? 'end', p);\n    }\n\n    const color = ann.color ?? tokens.color.text;\n    const pill = { background: withAlpha(tokens.color.background, 0.72), radius: 3, padX: 3, padY: 1 };\n\n    if (surface.headless) {\n      paintCanvasText(\n        surface.marks.ctx,\n        overlayTextToCanvasCmd(\n          {\n            left: box.left,\n            top: box.top,\n            width: box.width ?? undefined,\n            text: ann.label,\n            color,\n            size: f.size.small,\n            align: box.align,\n            transform: box.transform,\n            pill,\n          },\n          font,\n        ),\n      );\n      continue;\n    }\n\n    const el = document.createElement('div');\n    el.textContent = ann.label;\n    el.style.position = 'absolute';\n    el.style.font = font;\n    el.style.fontSize = `${f.size.small}px`;\n    el.style.fontWeight = String(f.weight.medium);\n    el.style.color = color;\n    el.style.whiteSpace = 'nowrap';\n    el.style.left = `${box.left}px`;\n    el.style.top = `${box.top}px`;\n    if (box.width != null) {\n      el.style.width = `${box.width}px`;\n      el.style.textAlign = box.align;\n    }\n    el.style.transform = box.transform;\n    // A faint backing pill keeps the label legible over data marks.\n    el.style.padding = '0 3px';\n    el.style.borderRadius = '3px';\n    el.style.background = pill.background;\n    el.style.pointerEvents = 'none';\n    overlay.appendChild(el);\n  }\n}\n\n/** Best-effort translucent background (handles #rgb/#rrggbb; falls back to the color). */\nfunction withAlpha(color: string, alpha: number): string {\n  const m = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(color);\n  if (!m) return color;\n  let hex = m[1];\n  if (hex.length === 3) hex = hex.split('').map((c) => c + c).join('');\n  const r = parseInt(hex.slice(0, 2), 16);\n  const g = parseInt(hex.slice(2, 4), 16);\n  const b = parseInt(hex.slice(4, 6), 16);\n  return `rgba(${r}, ${g}, ${b}, ${alpha})`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/charts/area.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Area chart. Two modes:
+ *   - overlapping (default): each series filled from the zero baseline with a
+ *     translucent fill + opaque top stroke, so overlaps stay legible.
+ *   - stacked (`stack: true`): series are accumulated per x value; each band
+ *     spans from the running total below it to the new total, with mostly-opaque
+ *     fills for a clean stacked look.
+ *
+ * Consumes the prebuilt `CartesianModel` (x/y scales, resolved series, baseline).
+ */
+import type { Surface } from '../render/surface.js';
+import { type CartesianModel } from '../runtime/cartesian.js';
+export declare function drawArea(surface: Surface, model: CartesianModel): void;
+//# sourceMappingURL=area.d.ts.map

package/dist/charts/area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.d.ts","sourceRoot":"","sources":["../../src/charts/area.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAKjD,OAAO,EAAgB,KAAK,cAAc,EAAuB,MAAM,sBAAsB,CAAC;AAiT9F,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAsCtE"}