graphein 0.18.0 → 0.20.0

package/dist/charts/treemap.js

@@ -0,0 +1,404 @@
+import { ordinalColorScale, sequentialColorScale, sequential, rgbaToCss, parseColor } from "../color/index.js";
+import { formatValue } from "../format/index.js";
+import { fontString, measureText, ellipsize } from "../render/text.js";
+import { accessor, toNumber, toKey } from "../util/data.js";
+import { RoughPen } from "../rough/index.js";
+import { resolveSketch } from "../spec/sketch.js";
+import { addOverlayText, drawTitleBlock } from "./chrome.js";
+import { addCenteredEmptyMessage } from "./emptyOverlay.js";
+const MIN_LABEL_WIDTH = 38;
+const MIN_LABEL_HEIGHT = 24;
+function cleanRect(rect) {
+  return {
+    x: Number.isFinite(rect.x) ? rect.x : 0,
+    y: Number.isFinite(rect.y) ? rect.y : 0,
+    width: Math.max(0, Number.isFinite(rect.width) ? rect.width : 0),
+    height: Math.max(0, Number.isFinite(rect.height) ? rect.height : 0)
+  };
+}
+function worst(row, side) {
+  if (row.length === 0 || side <= 0) return Infinity;
+  let sum = 0;
+  let min = Infinity;
+  let max = 0;
+  for (const area of row) {
+    sum += area;
+    min = Math.min(min, area);
+    max = Math.max(max, area);
+  }
+  if (sum <= 0 || min <= 0) return Infinity;
+  const side2 = side * side;
+  return Math.max(side2 * max / (sum * sum), sum * sum / (side2 * min));
+}
+function layoutRow(row, rect, out) {
+  const area = row.reduce((sum, d) => sum + d.area, 0);
+  if (area <= 0 || rect.width <= 0 || rect.height <= 0) return rect;
+  if (rect.height >= rect.width) {
+    const h = Math.min(rect.height, area / rect.width);
+    let x = rect.x;
+    for (let i = 0; i < row.length; i++) {
+      const w2 = i === row.length - 1 ? rect.x + rect.width - x : row[i].area / h;
+      out.push({ item: row[i].item, rect: { x, y: rect.y, width: Math.max(0, w2), height: h } });
+      x += w2;
+    }
+    return { x: rect.x, y: rect.y + h, width: rect.width, height: Math.max(0, rect.height - h) };
+  }
+  const w = Math.min(rect.width, area / rect.height);
+  let y = rect.y;
+  for (let i = 0; i < row.length; i++) {
+    const h = i === row.length - 1 ? rect.y + rect.height - y : row[i].area / w;
+    out.push({ item: row[i].item, rect: { x: rect.x, y, width: w, height: Math.max(0, h) } });
+    y += h;
+  }
+  return { x: rect.x + w, y: rect.y, width: Math.max(0, rect.width - w), height: rect.height };
+}
+function layoutTreemap(items, rect) {
+  const box = cleanRect(rect);
+  const total = items.reduce((sum, item) => Number.isFinite(item.value) && item.value > 0 ? sum + item.value : sum, 0);
+  const area = box.width * box.height;
+  if (total <= 0 || area <= 0) return [];
+  const pending = items.filter((item) => Number.isFinite(item.value) && item.value > 0).map((item) => ({ item, area: item.value / total * area }));
+  const out = [];
+  let rest = box;
+  let row = [];
+  let rowAreas = [];
+  const flush = () => {
+    if (row.length === 0) return;
+    rest = layoutRow(row, rest, out);
+    row = [];
+    rowAreas = [];
+  };
+  for (const next of pending) {
+    const side = Math.min(rest.width, rest.height);
+    if (row.length === 0 || worst([...rowAreas, next.area], side) <= worst(rowAreas, side)) {
+      row.push(next);
+      rowAreas.push(next.area);
+    } else {
+      flush();
+      row.push(next);
+      rowAreas.push(next.area);
+    }
+  }
+  flush();
+  return out;
+}
+function insetRect(rect, pad) {
+  return {
+    x: rect.x + pad,
+    y: rect.y + pad,
+    width: Math.max(0, rect.width - pad * 2),
+    height: Math.max(0, rect.height - pad * 2)
+  };
+}
+function labelFor(value) {
+  const key = toKey(value);
+  return key === "" ? "(blank)" : key;
+}
+function textureShade(fill) {
+  const lum = (0.299 * fill.r + 0.587 * fill.g + 0.114 * fill.b) / 255;
+  const k = lum > 0.5 ? 0.68 : 1.4;
+  const c = (n) => Math.max(0, Math.min(255, Math.round(n * k)));
+  return rgbaToCss({ r: c(fill.r), g: c(fill.g), b: c(fill.b), a: 1 });
+}
+function buildLeaves(treemap) {
+  const readCategory = accessor(treemap.encoding.category.field);
+  const readValue = accessor(treemap.encoding.value.field);
+  const readGroup = treemap.encoding.group ? accessor(treemap.encoding.group.field) : null;
+  const readColor = treemap.encoding.color ? accessor(treemap.encoding.color.field) : null;
+  const order = [];
+  const totals = /* @__PURE__ */ new Map();
+  for (const row of treemap.data ?? []) {
+    const rawCategory = readCategory(row);
+    const categoryKey = toKey(rawCategory);
+    const rawGroup = readGroup ? readGroup(row) : void 0;
+    const groupKey = readGroup ? toKey(rawGroup) : void 0;
+    const key = groupKey === void 0 ? categoryKey : `${groupKey}\0${categoryKey}`;
+    const value = toNumber(readValue(row));
+    if (!Number.isFinite(value) || value <= 0) continue;
+    let leaf = totals.get(key);
+    if (!leaf) {
+      const colorValue = readColor ? readColor(row) : void 0;
+      const colorNumber = colorValue === void 0 ? void 0 : toNumber(colorValue);
+      leaf = {
+        key,
+        category: rawCategory,
+        categoryLabel: labelFor(rawCategory),
+        value: 0,
+        group: rawGroup,
+        groupKey,
+        groupLabel: groupKey === void 0 ? void 0 : labelFor(rawGroup),
+        colorValue,
+        colorNumber: Number.isFinite(colorNumber) ? colorNumber : void 0,
+        fill: { r: 0, g: 0, b: 0, a: 1 },
+        fillCss: "#000",
+        sourceRows: 0
+      };
+      totals.set(key, leaf);
+      order.push(key);
+    }
+    leaf.value += value;
+    leaf.sourceRows++;
+  }
+  return order.map((key) => totals.get(key));
+}
+function colorLeaves(leaves, treemap, tokens) {
+  const fallback = parseColor(tokens.color.surface) ?? parseColor(tokens.color.palette[0] ?? "#14b8a6") ?? { r: 20, g: 184, b: 166, a: 1 };
+  const color = treemap.encoding.color;
+  const ordinal = ordinalColorScale({ palette: tokens.color.palette });
+  const numericValues = color ? leaves.map((leaf) => leaf.colorNumber).filter((n) => n !== void 0) : [];
+  const numericColor = Boolean(color && (color.type === "quantitative" || numericValues.length > 0 && numericValues.length === leaves.length));
+  const domain = numericValues.length ? [Math.min(...numericValues), Math.max(...numericValues)] : [0, 1];
+  const continuous = sequentialColorScale({ domain, interpolator: sequential(treemap.scheme ?? "teal") });
+  for (const leaf of leaves) {
+    let fill = fallback;
+    if (color) {
+      if (numericColor) {
+        if (leaf.colorNumber === void 0) {
+          fill = parseColor(tokens.color.border) ?? fallback;
+          leaf.colorNoData = true;
+        } else {
+          fill = continuous.map(leaf.colorNumber);
+        }
+      } else fill = ordinal.map(toKey(leaf.colorValue));
+    } else if (treemap.encoding.group && leaf.groupKey !== void 0) {
+      fill = ordinal.map(leaf.groupKey);
+    } else {
+      fill = ordinal.map(leaf.categoryLabel);
+    }
+    leaf.fill = fill;
+    leaf.fillCss = rgbaToCss(fill);
+  }
+}
+function buildGroups(leaves) {
+  const order = [];
+  const groups = /* @__PURE__ */ new Map();
+  for (const leaf of leaves) {
+    const key = leaf.groupKey ?? "";
+    let group = groups.get(key);
+    if (!group) {
+      group = { key, label: leaf.groupLabel ?? "(blank)", value: 0, leaves: [] };
+      groups.set(key, group);
+      order.push(key);
+    }
+    group.value += leaf.value;
+    group.leaves.push(leaf);
+  }
+  return order.map((key) => groups.get(key));
+}
+function tileProbe(treemap, tile) {
+  const probe = { [treemap.encoding.category.field]: tile.category };
+  const groupField = treemap.encoding.group?.field;
+  if (groupField) probe[groupField] = tile.group;
+  return probe;
+}
+function drawRect(ctx, pen, rect, fill, fillCss, stroke) {
+  if (rect.width <= 0 || rect.height <= 0) return;
+  if (pen) {
+    pen.rect(rect.x, rect.y, rect.width, rect.height, { fill: fillCss, fillStyle: "solid" });
+    pen.rect(rect.x, rect.y, rect.width, rect.height, {
+      fill: textureShade(fill),
+      fillStyle: "hachure",
+      fillAlpha: 0.4,
+      hachureGap: 7,
+      stroke
+    });
+    return;
+  }
+  ctx.fillStyle = fillCss;
+  ctx.fillRect(rect.x, rect.y, rect.width, rect.height);
+  ctx.strokeStyle = stroke;
+  ctx.lineWidth = 1;
+  ctx.strokeRect(rect.x + 0.5, rect.y + 0.5, Math.max(0, rect.width - 1), Math.max(0, rect.height - 1));
+}
+function addTileLabels(surface, tokens, tile, valueFormat) {
+  const compact = tile.rect.width < MIN_LABEL_WIDTH || tile.rect.height < MIN_LABEL_HEIGHT;
+  const pad = compact ? 2 : 5;
+  const padX = compact ? 3 : 6;
+  const padY = compact ? 1 : 2;
+  const labelSize = tokens.font.size.small;
+  if (tile.rect.width <= pad * 2 + padX * 2 + 2 || tile.rect.height < labelSize + padY * 2 + pad * 2 + 2) {
+    surface.labels?.omit({ role: "data-label", reason: "space", required: true, example: tile.categoryLabel, path: "/labels" });
+    return;
+  }
+  const valueSize = tokens.font.size.tiny;
+  const labelFont = fontString(labelSize, tokens.font.family, tokens.font.weight.bold);
+  const valueFont = fontString(valueSize, tokens.font.family);
+  const maxTextWidth = tile.rect.width - pad * 2 - padX * 2 - 2;
+  const labelText = ellipsize(tile.categoryLabel, maxTextWidth, labelFont);
+  if (labelText === "" || labelText === "\u2026" || compact && labelText.length / Math.max(1, tile.categoryLabel.length) < 0.5) {
+    surface.labels?.omit({ role: "data-label", reason: "unreadable", required: true, example: tile.categoryLabel, path: "/labels" });
+    return;
+  }
+  const pill = { background: tokens.color.surface, border: tokens.color.border, padX, padY };
+  addOverlayText(surface, tokens, {
+    left: tile.rect.x + pad + 2,
+    top: tile.rect.y + pad,
+    text: tile.categoryLabel,
+    maxWidth: maxTextWidth,
+    color: tokens.color.text,
+    size: labelSize,
+    weight: tokens.font.weight.bold,
+    pill
+  });
+  const labelPillH = labelSize + padY * 2 + 2;
+  const valuePillH = valueSize + padY * 2 + 2;
+  const valueText = formatValue(tile.value, valueFormat);
+  if (tile.rect.height >= pad * 2 + labelPillH + 2 + valuePillH && measureText(valueText, valueFont).width <= maxTextWidth) {
+    addOverlayText(surface, tokens, {
+      left: tile.rect.x + pad + 2,
+      top: tile.rect.y + pad + labelPillH + 2,
+      text: valueText,
+      color: tokens.color.textMuted,
+      size: valueSize,
+      pill
+    });
+  } else {
+    surface.labels?.omit({ role: "data-label", reason: "space", required: false, example: valueText, path: "/labels" });
+  }
+}
+function drawNoPositiveTreemap(surface, tokens, content) {
+  addCenteredEmptyMessage(surface, tokens, content, "No positive values");
+}
+function drawTreemapTiles(surface, treemap, tokens, content, leaves, context) {
+  const ctx = surface.marks.ctx;
+  const emphasis = context?.emphasis ?? null;
+  const sketch = resolveSketch(treemap);
+  const pen = sketch ? new RoughPen(ctx, sketch) : null;
+  const tiles = [];
+  const groupRects = [];
+  const stroke = tokens.color.textMuted;
+  let represented = 0;
+  const drawTile = (tile) => {
+    const alpha = emphasis ? emphasis.match(tileProbe(treemap, tile)) ? 1 : emphasis.dim : 1;
+    if (alpha !== 1) ctx.globalAlpha = alpha;
+    drawRect(ctx, pen, tile.rect, tile.fill, tile.fillCss, stroke);
+    if (tile.rect.width > 0 && tile.rect.height > 0) {
+      surface.evidence?.mark("tile", tile.rect.x, tile.rect.y, tile.rect.width, tile.rect.height, tile.fillCss, alpha, void 0, 1, void 0, alpha < 1, { color: stroke, opacity: 0.65, width: 1 });
+      represented += tile.sourceRows;
+    }
+    if (alpha !== 1) ctx.globalAlpha = 1;
+  };
+  ctx.save();
+  if (treemap.encoding.group) {
+    const groups = buildGroups(leaves);
+    for (const groupNode of layoutTreemap(groups, content)) {
+      const gRect = groupNode.rect;
+      const headerH = gRect.width >= 46 && gRect.height >= 40 ? tokens.font.size.tiny + 8 : 0;
+      groupRects.push({ group: groupNode.item, rect: gRect, headerH });
+      const inner = insetRect(
+        { x: gRect.x, y: gRect.y + headerH, width: gRect.width, height: Math.max(0, gRect.height - headerH) },
+        2
+      );
+      for (const leafNode of layoutTreemap(groupNode.item.leaves, inner)) {
+        const tile = { ...leafNode.item, rect: leafNode.rect };
+        tiles.push(tile);
+        drawTile(tile);
+      }
+    }
+  } else {
+    for (const leafNode of layoutTreemap(leaves, content)) {
+      const tile = { ...leafNode.item, rect: leafNode.rect };
+      tiles.push(tile);
+      drawTile(tile);
+    }
+  }
+  ctx.restore();
+  return { tiles, groupRects, represented, pen, sketch };
+}
+function drawGroupFrames(surface, tokens, treemap, groups, pen, sketch) {
+  const ctx = surface.marks.ctx;
+  const stroke = tokens.color.background;
+  for (const { group, rect, headerH } of groups) {
+    if (pen) pen.rect(rect.x, rect.y, rect.width, rect.height, { stroke, roughness: sketch.roughness * 0.6 });
+    else {
+      ctx.strokeStyle = stroke;
+      ctx.lineWidth = 1;
+      ctx.strokeRect(rect.x + 0.5, rect.y + 0.5, Math.max(0, rect.width - 1), Math.max(0, rect.height - 1));
+    }
+    if (headerH > 0) {
+      const headerW = Math.max(0, rect.width - 10);
+      addOverlayText(surface, tokens, {
+        left: rect.x + 5,
+        top: rect.y + 4,
+        width: headerW,
+        text: group.label,
+        maxWidth: headerW,
+        color: tokens.color.text,
+        size: tokens.font.size.tiny,
+        weight: tokens.font.weight.bold,
+        opacity: 0.78
+      });
+    } else if (treemap.labels !== false) {
+      surface.labels?.omit({ role: "data-label", reason: "space", required: true, example: group.label, path: "/encoding/group" });
+    }
+  }
+}
+function buildTreemapInteraction(treemap, content, tiles, total) {
+  const valueLabel = treemap.encoding.value.title ?? treemap.encoding.value.field;
+  const colorLabel = treemap.encoding.color?.title ?? treemap.encoding.color?.field;
+  const categoryField = treemap.encoding.category.field;
+  const groupField = treemap.encoding.group?.field;
+  const hitTile = (px, py) => {
+    for (let i = tiles.length - 1; i >= 0; i--) {
+      const tile = tiles[i];
+      if (px >= tile.rect.x && px <= tile.rect.x + tile.rect.width && py >= tile.rect.y && py <= tile.rect.y + tile.rect.height) return tile;
+    }
+    return null;
+  };
+  return {
+    region: { x: content.x, y: content.y, width: content.width, height: content.height },
+    hitTest: (px, py) => {
+      const tile = hitTile(px, py);
+      if (!tile) return null;
+      return {
+        key: tile.key,
+        anchorX: px,
+        anchorY: py,
+        content: {
+          title: groupField ? `${tile.groupLabel ?? "(blank)"} \u25B8 ${tile.categoryLabel}` : tile.categoryLabel,
+          rows: [
+            { swatch: tile.fillCss, label: valueLabel, value: formatValue(tile.value, treemap.encoding.value.format) },
+            ...colorLabel ? [{
+              label: colorLabel,
+              value: tile.colorNoData ? "no data" : formatValue(tile.colorValue, treemap.encoding.color?.format),
+              muted: true
+            }] : [],
+            { label: "share", value: `${(tile.value / total * 100).toFixed(1)}%`, muted: true }
+          ]
+        }
+      };
+    },
+    pick: (px, py) => {
+      const tile = hitTile(px, py);
+      if (!tile) return null;
+      return groupField ? { kind: "point", fields: [categoryField, groupField], tuples: [[tile.category, tile.group]] } : { kind: "point", fields: [categoryField], tuples: [[tile.category]] };
+    }
+  };
+}
+function drawTreemap(surface, spec, tokens, size, context) {
+  surface.evidence?.begin("aggregate");
+  surface.evidence?.data(0, "aggregate");
+  const treemap = spec;
+  const content = drawTitleBlock(surface, tokens, size, treemap.title);
+  const leaves = buildLeaves(treemap);
+  colorLeaves(leaves, treemap, tokens);
+  const total = leaves.reduce((sum, leaf) => sum + leaf.value, 0);
+  if (leaves.length === 0 || total <= 0 || content.width <= 0 || content.height <= 0) {
+    drawNoPositiveTreemap(surface, tokens, content);
+    return;
+  }
+  const { tiles, groupRects, represented, pen, sketch } = drawTreemapTiles(surface, treemap, tokens, content, leaves, context);
+  surface.evidence?.data(represented, "aggregate");
+  if (treemap.encoding.group) {
+    drawGroupFrames(surface, tokens, treemap, groupRects, pen, sketch);
+  }
+  if (treemap.labels !== false) {
+    for (const tile of tiles) addTileLabels(surface, tokens, tile, treemap.encoding.value.format);
+  }
+  return buildTreemapInteraction(treemap, content, tiles, total);
+}
+export {
+  drawTreemap,
+  layoutTreemap
+};
+//# sourceMappingURL=treemap.js.map

package/dist/charts/treemap.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/charts/treemap.ts"],
+  "sourcesContent": ["import { ordinalColorScale, sequentialColorScale, sequential, rgbaToCss, parseColor } from '../color';\nimport { formatValue } from '../format';\nimport { fontString, measureText, ellipsize } from '../render/text';\nimport { accessor, toNumber, toKey } from '../util/data';\nimport { RoughPen } from '../rough';\nimport { resolveSketch } from '../spec/sketch';\nimport { addOverlayText, drawTitleBlock } from './chrome';\nimport type { ChartSpec, TreemapSpec } from '../spec/types';\nimport type { Surface } from '../render/surface';\nimport type { ThemeTokens } from '../theme';\nimport type { InteractionModel } from '../interaction/types';\nimport type { RenderContext } from './index';\nimport type { Datum, Rect, RGBA, Size } from '../types';\nimport { addCenteredEmptyMessage } from './emptyOverlay';\n\nexport interface TreemapLayoutInput {\n  value: number;\n}\n\nexport interface TreemapLayoutNode<T extends TreemapLayoutInput = TreemapLayoutInput> {\n  item: T;\n  rect: Rect;\n}\n\ninterface Leaf extends TreemapLayoutInput {\n  key: string;\n  category: unknown;\n  categoryLabel: string;\n  value: number;\n  group?: unknown;\n  groupKey?: string;\n  groupLabel?: string;\n  colorValue?: unknown;\n  colorNumber?: number;\n  colorNoData?: boolean;\n  fill: RGBA;\n  fillCss: string;\n  sourceRows: number;\n}\n\ninterface GroupItem extends TreemapLayoutInput {\n  key: string;\n  label: string;\n  value: number;\n  leaves: Leaf[];\n}\n\ninterface Tile extends Leaf {\n  rect: Rect;\n}\n\nconst MIN_LABEL_WIDTH = 38;\nconst MIN_LABEL_HEIGHT = 24;\n\nfunction cleanRect(rect: Rect): Rect {\n  return {\n    x: Number.isFinite(rect.x) ? rect.x : 0,\n    y: Number.isFinite(rect.y) ? rect.y : 0,\n    width: Math.max(0, Number.isFinite(rect.width) ? rect.width : 0),\n    height: Math.max(0, Number.isFinite(rect.height) ? rect.height : 0),\n  };\n}\n\nfunction worst(row: readonly number[], side: number): number {\n  if (row.length === 0 || side <= 0) return Infinity;\n  let sum = 0;\n  let min = Infinity;\n  let max = 0;\n  for (const area of row) {\n    sum += area;\n    min = Math.min(min, area);\n    max = Math.max(max, area);\n  }\n  if (sum <= 0 || min <= 0) return Infinity;\n  const side2 = side * side;\n  return Math.max((side2 * max) / (sum * sum), (sum * sum) / (side2 * min));\n}\n\nfunction layoutRow<T extends TreemapLayoutInput>(\n  row: readonly { item: T; area: number }[],\n  rect: Rect,\n  out: TreemapLayoutNode<T>[],\n): Rect {\n  const area = row.reduce((sum, d) => sum + d.area, 0);\n  if (area <= 0 || rect.width <= 0 || rect.height <= 0) return rect;\n\n  if (rect.height >= rect.width) {\n    const h = Math.min(rect.height, area / rect.width);\n    let x = rect.x;\n    for (let i = 0; i < row.length; i++) {\n      const w = i === row.length - 1 ? rect.x + rect.width - x : row[i].area / h;\n      out.push({ item: row[i].item, rect: { x, y: rect.y, width: Math.max(0, w), height: h } });\n      x += w;\n    }\n    return { x: rect.x, y: rect.y + h, width: rect.width, height: Math.max(0, rect.height - h) };\n  }\n\n  const w = Math.min(rect.width, area / rect.height);\n  let y = rect.y;\n  for (let i = 0; i < row.length; i++) {\n    const h = i === row.length - 1 ? rect.y + rect.height - y : row[i].area / w;\n    out.push({ item: row[i].item, rect: { x: rect.x, y, width: w, height: Math.max(0, h) } });\n    y += h;\n  }\n  return { x: rect.x + w, y: rect.y, width: Math.max(0, rect.width - w), height: rect.height };\n}\n\n/** Squarified treemap layout. Input order is preserved for deterministic agent output. */\nexport function layoutTreemap<T extends TreemapLayoutInput>(items: readonly T[], rect: Rect): TreemapLayoutNode<T>[] {\n  const box = cleanRect(rect);\n  const total = items.reduce((sum, item) => (Number.isFinite(item.value) && item.value > 0 ? sum + item.value : sum), 0);\n  const area = box.width * box.height;\n  if (total <= 0 || area <= 0) return [];\n\n  const pending = items\n    .filter((item) => Number.isFinite(item.value) && item.value > 0)\n    .map((item) => ({ item, area: (item.value / total) * area }));\n  const out: TreemapLayoutNode<T>[] = [];\n  let rest = box;\n  let row: { item: T; area: number }[] = [];\n  let rowAreas: number[] = [];\n\n  const flush = () => {\n    if (row.length === 0) return;\n    rest = layoutRow(row, rest, out);\n    row = [];\n    rowAreas = [];\n  };\n\n  for (const next of pending) {\n    const side = Math.min(rest.width, rest.height);\n    if (row.length === 0 || worst([...rowAreas, next.area], side) <= worst(rowAreas, side)) {\n      row.push(next);\n      rowAreas.push(next.area);\n    } else {\n      flush();\n      row.push(next);\n      rowAreas.push(next.area);\n    }\n  }\n  flush();\n  return out;\n}\n\nfunction insetRect(rect: Rect, pad: number): Rect {\n  return {\n    x: rect.x + pad,\n    y: rect.y + pad,\n    width: Math.max(0, rect.width - pad * 2),\n    height: Math.max(0, rect.height - pad * 2),\n  };\n}\n\nfunction labelFor(value: unknown): string {\n  const key = toKey(value);\n  return key === '' ? '(blank)' : key;\n}\n\n/**\n * A hand-drawn hachure shade for a tile fill: shifted *away* from the fill's own\n * luminance (darker for light tiles, lighter for dark tiles) so the \"marker\"\n * streaks stay visible on any colour in the sequential/ordinal scale.\n */\nfunction textureShade(fill: RGBA): string {\n  const lum = (0.299 * fill.r + 0.587 * fill.g + 0.114 * fill.b) / 255;\n  const k = lum > 0.5 ? 0.68 : 1.4;\n  const c = (n: number) => Math.max(0, Math.min(255, Math.round(n * k)));\n  return rgbaToCss({ r: c(fill.r), g: c(fill.g), b: c(fill.b), a: 1 });\n}\n\nfunction buildLeaves(treemap: TreemapSpec): Leaf[] {\n  const readCategory = accessor(treemap.encoding.category.field);\n  const readValue = accessor(treemap.encoding.value.field);\n  const readGroup = treemap.encoding.group ? accessor(treemap.encoding.group.field) : null;\n  const readColor = treemap.encoding.color ? accessor(treemap.encoding.color.field) : null;\n  const order: string[] = [];\n  const totals = new Map<string, Leaf>();\n\n  for (const row of treemap.data ?? []) {\n    const rawCategory = readCategory(row);\n    const categoryKey = toKey(rawCategory);\n    const rawGroup = readGroup ? readGroup(row) : undefined;\n    const groupKey = readGroup ? toKey(rawGroup) : undefined;\n    const key = groupKey === undefined ? categoryKey : `${groupKey}\\u0000${categoryKey}`;\n    const value = toNumber(readValue(row));\n    if (!Number.isFinite(value) || value <= 0) continue;\n\n    let leaf = totals.get(key);\n    if (!leaf) {\n      const colorValue = readColor ? readColor(row) : undefined;\n      const colorNumber = colorValue === undefined ? undefined : toNumber(colorValue);\n      leaf = {\n        key,\n        category: rawCategory,\n        categoryLabel: labelFor(rawCategory),\n        value: 0,\n        group: rawGroup,\n        groupKey,\n        groupLabel: groupKey === undefined ? undefined : labelFor(rawGroup),\n        colorValue,\n        colorNumber: Number.isFinite(colorNumber) ? colorNumber : undefined,\n        fill: { r: 0, g: 0, b: 0, a: 1 },\n        fillCss: '#000',\n        sourceRows: 0,\n      };\n      totals.set(key, leaf);\n      order.push(key);\n    }\n    leaf.value += value;\n    leaf.sourceRows++;\n  }\n\n  return order.map((key) => totals.get(key)!);\n}\n\nfunction colorLeaves(leaves: Leaf[], treemap: TreemapSpec, tokens: ThemeTokens): void {\n  const fallback = parseColor(tokens.color.surface) ?? parseColor(tokens.color.palette[0] ?? '#14b8a6') ?? { r: 20, g: 184, b: 166, a: 1 };\n  const color = treemap.encoding.color;\n  const ordinal = ordinalColorScale({ palette: tokens.color.palette });\n  const numericValues = color ? leaves.map((leaf) => leaf.colorNumber).filter((n): n is number => n !== undefined) : [];\n  const numericColor = Boolean(color && (color.type === 'quantitative' || (numericValues.length > 0 && numericValues.length === leaves.length)));\n  const domain: [number, number] = numericValues.length\n    ? [Math.min(...numericValues), Math.max(...numericValues)]\n    : [0, 1];\n  const continuous = sequentialColorScale({ domain, interpolator: sequential(treemap.scheme ?? 'teal') });\n\n  for (const leaf of leaves) {\n    let fill: RGBA = fallback;\n    if (color) {\n      if (numericColor) {\n        if (leaf.colorNumber === undefined) {\n          fill = parseColor(tokens.color.border) ?? fallback;\n          leaf.colorNoData = true;\n        } else {\n          fill = continuous.map(leaf.colorNumber);\n        }\n      }\n      else fill = ordinal.map(toKey(leaf.colorValue));\n    } else if (treemap.encoding.group && leaf.groupKey !== undefined) {\n      fill = ordinal.map(leaf.groupKey);\n    } else {\n      fill = ordinal.map(leaf.categoryLabel);\n    }\n    leaf.fill = fill;\n    leaf.fillCss = rgbaToCss(fill);\n  }\n}\n\nfunction buildGroups(leaves: readonly Leaf[]): GroupItem[] {\n  const order: string[] = [];\n  const groups = new Map<string, GroupItem>();\n  for (const leaf of leaves) {\n    const key = leaf.groupKey ?? '';\n    let group = groups.get(key);\n    if (!group) {\n      group = { key, label: leaf.groupLabel ?? '(blank)', value: 0, leaves: [] };\n      groups.set(key, group);\n      order.push(key);\n    }\n    group.value += leaf.value;\n    group.leaves.push(leaf);\n  }\n  return order.map((key) => groups.get(key)!);\n}\n\nfunction tileProbe(treemap: TreemapSpec, tile: Tile): Datum {\n  const probe: Datum = { [treemap.encoding.category.field]: tile.category };\n  const groupField = treemap.encoding.group?.field;\n  if (groupField) probe[groupField] = tile.group;\n  return probe;\n}\n\nfunction drawRect(ctx: CanvasRenderingContext2D, pen: RoughPen | null, rect: Rect, fill: RGBA, fillCss: string, stroke: string): void {\n  if (rect.width <= 0 || rect.height <= 0) return;\n  if (pen) {\n    // A solid base keeps the value-encoding colour crisp (light tiles stay\n    // legible on a dark page), while a same-family hachure overlay adds\n    // hand-drawn \"marker shading\" so the tile doesn't read as a flat digital\n    // block trapped inside a wobbly outline. The overlay carries the outline.\n    pen.rect(rect.x, rect.y, rect.width, rect.height, { fill: fillCss, fillStyle: 'solid' });\n    pen.rect(rect.x, rect.y, rect.width, rect.height, {\n      fill: textureShade(fill),\n      fillStyle: 'hachure',\n      fillAlpha: 0.4,\n      hachureGap: 7,\n      stroke,\n    });\n    return;\n  }\n  ctx.fillStyle = fillCss;\n  ctx.fillRect(rect.x, rect.y, rect.width, rect.height);\n  ctx.strokeStyle = stroke;\n  ctx.lineWidth = 1;\n  ctx.strokeRect(rect.x + 0.5, rect.y + 0.5, Math.max(0, rect.width - 1), Math.max(0, rect.height - 1));\n}\n\nfunction addTileLabels(surface: Surface, tokens: ThemeTokens, tile: Tile, valueFormat?: string): void {\n  const compact = tile.rect.width < MIN_LABEL_WIDTH || tile.rect.height < MIN_LABEL_HEIGHT;\n  const pad = compact ? 2 : 5;\n  const padX = compact ? 3 : 6;\n  const padY = compact ? 1 : 2;\n  const labelSize = tokens.font.size.small;\n  if (tile.rect.width <= pad * 2 + padX * 2 + 2 ||\n    tile.rect.height < labelSize + padY * 2 + pad * 2 + 2) {\n    surface.labels?.omit({ role: 'data-label', reason: 'space', required: true, example: tile.categoryLabel, path: '/labels' });\n    return;\n  }\n  const valueSize = tokens.font.size.tiny;\n  const labelFont = fontString(labelSize, tokens.font.family, tokens.font.weight.bold);\n  const valueFont = fontString(valueSize, tokens.font.family);\n  // Text budget inside the tile padding and the pill's own padding + 1px border\n  // on each side, so the rounded badge never spills past the tile edge.\n  const maxTextWidth = tile.rect.width - pad * 2 - padX * 2 - 2;\n  const labelText = ellipsize(tile.categoryLabel, maxTextWidth, labelFont);\n  if (labelText === '' || labelText === '\u2026' || (compact && labelText.length / Math.max(1, tile.categoryLabel.length) < 0.5)) {\n    surface.labels?.omit({ role: 'data-label', reason: 'unreadable', required: true, example: tile.categoryLabel, path: '/labels' });\n    return;\n  }\n\n  // A themed pill (solid fill + hairline border) keeps every label legible on\n  // any tile colour, so labels read identically across fills \u2014 like the funnel.\n  const pill = { background: tokens.color.surface, border: tokens.color.border, padX, padY } as const;\n\n  addOverlayText(surface, tokens, {\n    left: tile.rect.x + pad + 2,\n    top: tile.rect.y + pad,\n    text: tile.categoryLabel,\n    maxWidth: maxTextWidth,\n    color: tokens.color.text,\n    size: labelSize,\n    weight: tokens.font.weight.bold,\n    pill,\n  });\n\n  const labelPillH = labelSize + padY * 2 + 2;\n  const valuePillH = valueSize + padY * 2 + 2;\n  const valueText = formatValue(tile.value, valueFormat);\n  // Stack the value in its own pill only when the whole number fits (a truncated\n  // number would mislead) and the tile is tall enough for a second row.\n  if (\n    tile.rect.height >= pad * 2 + labelPillH + 2 + valuePillH &&\n    measureText(valueText, valueFont).width <= maxTextWidth\n  ) {\n    addOverlayText(surface, tokens, {\n      left: tile.rect.x + pad + 2,\n      top: tile.rect.y + pad + labelPillH + 2,\n      text: valueText,\n      color: tokens.color.textMuted,\n      size: valueSize,\n      pill,\n    });\n  } else {\n    surface.labels?.omit({ role: 'data-label', reason: 'space', required: false, example: valueText, path: '/labels' });\n  }\n}\n\ninterface GroupRect {\n  group: GroupItem;\n  rect: Rect;\n  headerH: number;\n}\n\nfunction drawNoPositiveTreemap(\n  surface: Surface,\n  tokens: ThemeTokens,\n  content: Rect,\n): void {\n  addCenteredEmptyMessage(surface, tokens, content, 'No positive values');\n}\n\nfunction drawTreemapTiles(\n  surface: Surface,\n  treemap: TreemapSpec,\n  tokens: ThemeTokens,\n  content: Rect,\n  leaves: Leaf[],\n  context?: RenderContext,\n): { tiles: Tile[]; groupRects: GroupRect[]; represented: number; pen: RoughPen | null; sketch: ReturnType<typeof resolveSketch> } {\n  const ctx = surface.marks.ctx;\n  const emphasis = context?.emphasis ?? null;\n  const sketch = resolveSketch(treemap);\n  const pen = sketch ? new RoughPen(ctx, sketch) : null;\n  const tiles: Tile[] = [];\n  const groupRects: GroupRect[] = [];\n  const stroke = tokens.color.textMuted;\n  let represented = 0;\n  const drawTile = (tile: Tile) => {\n    const alpha = emphasis ? (emphasis.match(tileProbe(treemap, tile)) ? 1 : emphasis.dim) : 1;\n    if (alpha !== 1) ctx.globalAlpha = alpha;\n    drawRect(ctx, pen, tile.rect, tile.fill, tile.fillCss, stroke);\n    if (tile.rect.width > 0 && tile.rect.height > 0) {\n      surface.evidence?.mark('tile', tile.rect.x, tile.rect.y, tile.rect.width, tile.rect.height, tile.fillCss, alpha, undefined, 1, undefined, alpha < 1, { color: stroke, opacity: 0.65, width: 1 });\n      represented += tile.sourceRows;\n    }\n    if (alpha !== 1) ctx.globalAlpha = 1;\n  };\n\n  ctx.save();\n  if (treemap.encoding.group) {\n    const groups = buildGroups(leaves);\n    for (const groupNode of layoutTreemap(groups, content)) {\n      const gRect = groupNode.rect;\n      const headerH = gRect.width >= 46 && gRect.height >= 40 ? tokens.font.size.tiny + 8 : 0;\n      groupRects.push({ group: groupNode.item, rect: gRect, headerH });\n      const inner = insetRect(\n        { x: gRect.x, y: gRect.y + headerH, width: gRect.width, height: Math.max(0, gRect.height - headerH) },\n        2,\n      );\n      for (const leafNode of layoutTreemap(groupNode.item.leaves, inner)) {\n        const tile = { ...leafNode.item, rect: leafNode.rect };\n        tiles.push(tile);\n        drawTile(tile);\n      }\n    }\n  } else {\n    for (const leafNode of layoutTreemap(leaves, content)) {\n      const tile = { ...leafNode.item, rect: leafNode.rect };\n      tiles.push(tile);\n      drawTile(tile);\n    }\n  }\n  ctx.restore();\n\n  return { tiles, groupRects, represented, pen, sketch };\n}\n\nfunction drawGroupFrames(\n  surface: Surface,\n  tokens: ThemeTokens,\n  treemap: TreemapSpec,\n  groups: readonly GroupRect[],\n  pen: RoughPen | null,\n  sketch: ReturnType<typeof resolveSketch>,\n): void {\n  const ctx = surface.marks.ctx;\n  const stroke = tokens.color.background;\n  for (const { group, rect, headerH } of groups) {\n    if (pen) pen.rect(rect.x, rect.y, rect.width, rect.height, { stroke, roughness: sketch!.roughness * 0.6 });\n    else {\n      ctx.strokeStyle = stroke;\n      ctx.lineWidth = 1;\n      ctx.strokeRect(rect.x + 0.5, rect.y + 0.5, Math.max(0, rect.width - 1), Math.max(0, rect.height - 1));\n    }\n    if (headerH > 0) {\n      const headerW = Math.max(0, rect.width - 10);\n      addOverlayText(surface, tokens, {\n        left: rect.x + 5,\n        top: rect.y + 4,\n        width: headerW,\n        text: group.label,\n        maxWidth: headerW,\n        color: tokens.color.text,\n        size: tokens.font.size.tiny,\n        weight: tokens.font.weight.bold,\n        opacity: 0.78,\n      });\n    } else if (treemap.labels !== false) {\n      surface.labels?.omit({ role: 'data-label', reason: 'space', required: true, example: group.label, path: '/encoding/group' });\n    }\n  }\n}\n\nfunction buildTreemapInteraction(\n  treemap: TreemapSpec,\n  content: Rect,\n  tiles: readonly Tile[],\n  total: number,\n): InteractionModel {\n  const valueLabel = treemap.encoding.value.title ?? treemap.encoding.value.field;\n  const colorLabel = treemap.encoding.color?.title ?? treemap.encoding.color?.field;\n  const categoryField = treemap.encoding.category.field;\n  const groupField = treemap.encoding.group?.field;\n  const hitTile = (px: number, py: number): Tile | null => {\n    for (let i = tiles.length - 1; i >= 0; i--) {\n      const tile = tiles[i];\n      if (px >= tile.rect.x && px <= tile.rect.x + tile.rect.width && py >= tile.rect.y && py <= tile.rect.y + tile.rect.height) return tile;\n    }\n    return null;\n  };\n\n  return {\n    region: { x: content.x, y: content.y, width: content.width, height: content.height },\n    hitTest: (px, py) => {\n      const tile = hitTile(px, py);\n      if (!tile) return null;\n      return {\n        key: tile.key,\n        anchorX: px,\n        anchorY: py,\n        content: {\n          title: groupField ? `${tile.groupLabel ?? '(blank)'} \u25B8 ${tile.categoryLabel}` : tile.categoryLabel,\n          rows: [\n            { swatch: tile.fillCss, label: valueLabel, value: formatValue(tile.value, treemap.encoding.value.format) },\n            ...(colorLabel\n              ? [{\n                  label: colorLabel,\n                  value: tile.colorNoData ? 'no data' : formatValue(tile.colorValue, treemap.encoding.color?.format),\n                  muted: true,\n                }]\n              : []),\n            { label: 'share', value: `${((tile.value / total) * 100).toFixed(1)}%`, muted: true },\n          ],\n        },\n      };\n    },\n    pick: (px, py) => {\n      const tile = hitTile(px, py);\n      if (!tile) return null;\n      return groupField\n        ? { kind: 'point', fields: [categoryField, groupField], tuples: [[tile.category, tile.group]] }\n        : { kind: 'point', fields: [categoryField], tuples: [[tile.category]] };\n    },\n  };\n}\n\nexport function drawTreemap(\n  surface: Surface,\n  spec: ChartSpec,\n  tokens: ThemeTokens,\n  size: Size,\n  context?: RenderContext,\n): InteractionModel | void {\n  surface.evidence?.begin('aggregate');\n  surface.evidence?.data(0, 'aggregate');\n  const treemap = spec as TreemapSpec;\n  const content = drawTitleBlock(surface, tokens, size, treemap.title);\n  const leaves = buildLeaves(treemap);\n  colorLeaves(leaves, treemap, tokens);\n  const total = leaves.reduce((sum, leaf) => sum + leaf.value, 0);\n\n  if (leaves.length === 0 || total <= 0 || content.width <= 0 || content.height <= 0) {\n    drawNoPositiveTreemap(surface, tokens, content);\n    return;\n  }\n\n  const { tiles, groupRects, represented, pen, sketch } = drawTreemapTiles(surface, treemap, tokens, content, leaves, context);\n  surface.evidence?.data(represented, 'aggregate');\n\n  if (treemap.encoding.group) {\n    drawGroupFrames(surface, tokens, treemap, groupRects, pen, sketch);\n  }\n\n  if (treemap.labels !== false) {\n    for (const tile of tiles) addTileLabels(surface, tokens, tile, treemap.encoding.value.format);\n  }\n\n  return buildTreemapInteraction(treemap, content, tiles, total);\n}\n"],
+  "mappings": "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",
+  "names": ["w"]
+}

package/dist/charts/trendline.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Derived trendlines for cartesian charts — a linear line of best fit overlaid
+ * on a scatter, line, or area plot via `spec.trendline`.
+ *
+ * The regression is computed from the already-resolved `CartesianModel` series
+ * (one fit per group, or a single overall fit), and the fitted line is stroked
+ * across each group's x-extent. Marks land on the marks canvas; optional `R²`
+ * labels live in the HTML overlay (or are painted to canvas when headless),
+ * mirroring how `annotations` render. Pure presentation — no data reshaping.
+ */
+import type { Surface } from '../render/surface.js';
+import type { CartesianModel } from '../runtime/cartesian.js';
+/**
+ * Stroke the fitted line(s) on the marks canvas, clipped to the plot. Call after
+ * the chart's data marks so the trendline sits on top. No-op unless the spec
+ * opts in via `trendline` and the x-axis is continuous/temporal.
+ */
+export declare function drawTrendlines(surface: Surface, model: CartesianModel): void;
+/**
+ * Append `R²` labels for each fitted line to the HTML overlay (or paint them to
+ * canvas when headless). Call after `drawAnnotationLabels`. No-op unless
+ * `trendline.label` is set.
+ */
+export declare function drawTrendlineLabels(surface: Surface, model: CartesianModel): void;
+//# sourceMappingURL=trendline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trendline.d.ts","sourceRoot":"","sources":["../../src/charts/trendline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA+E3D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAyC5E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAiDjF"}

package/dist/charts/trendline.js

@@ -0,0 +1,125 @@
+import { linearRegression } from "../analyze/regression.js";
+import { fontString, measureText } from "../render/text.js";
+import { overlayTextToCanvasCmd, paintCanvasText } from "../render/overlayText.js";
+import { accessor, toDate, toNumber } from "../util/data.js";
+import { crisp } from "../util/math.js";
+const DEFAULT_STROKE_WIDTH = 2;
+function resolveTrendline(value) {
+  if (!value) return null;
+  const cfg = typeof value === "object" ? value : {};
+  return {
+    method: "linear",
+    groupBy: cfg.groupBy,
+    label: cfg.label ?? false,
+    color: cfg.color,
+    strokeWidth: cfg.strokeWidth ?? DEFAULT_STROKE_WIDTH,
+    strokeDash: cfg.strokeDash ?? []
+  };
+}
+function xToNum(model, value) {
+  if (model.x.kind === "time") {
+    const d = toDate(value);
+    return d ? d.getTime() : NaN;
+  }
+  return toNumber(value);
+}
+function trendGroups(model, cfg) {
+  const readX = accessor(model.x.field);
+  const readY = accessor(model.y.field ?? "");
+  const grouped = cfg.groupBy ?? model.series.length > 1;
+  const muted = cfg.color ?? model.tokens.color.textMuted;
+  const buckets = grouped ? model.series.map((s) => ({ color: cfg.color ?? s.color, rows: s.rows })) : [{ color: muted, rows: model.series.flatMap((s) => s.rows) }];
+  const out = [];
+  for (const bucket of buckets) {
+    const xs = [];
+    const ys = [];
+    for (const row of bucket.rows) {
+      const xn = xToNum(model, readX(row));
+      const yn = toNumber(readY(row));
+      if (!Number.isFinite(xn) || !Number.isFinite(yn)) continue;
+      xs.push(xn);
+      ys.push(yn);
+    }
+    const fit = linearRegression(xs, ys);
+    if (!fit) continue;
+    out.push({ color: bucket.color, fit, xMin: Math.min(...xs), xMax: Math.max(...xs) });
+  }
+  return out;
+}
+function drawTrendlines(surface, model) {
+  const cfg = resolveTrendline(model.spec.trendline);
+  if (!cfg || model.x.kind === "band" || model.x.kind === "point") return;
+  const groups = trendGroups(model, cfg);
+  if (groups.length === 0) return;
+  const ctx = surface.marks.ctx;
+  const { plot } = model;
+  ctx.save();
+  ctx.beginPath();
+  ctx.rect(plot.x, plot.y, plot.width, plot.height);
+  ctx.clip();
+  ctx.lineWidth = cfg.strokeWidth;
+  ctx.setLineDash(cfg.strokeDash);
+  ctx.lineCap = "round";
+  for (const g of groups) {
+    const x0 = model.x.pixel(g.xMin);
+    const x1 = model.x.pixel(g.xMax);
+    const y0 = model.y.pixel(g.fit.predict(g.xMin));
+    const y1 = model.y.pixel(g.fit.predict(g.xMax));
+    if (x0 == null || x1 == null || !Number.isFinite(x0) || !Number.isFinite(x1) || !Number.isFinite(y0) || !Number.isFinite(y1)) {
+      continue;
+    }
+    ctx.strokeStyle = g.color;
+    ctx.beginPath();
+    ctx.moveTo(x0, crisp(y0));
+    ctx.lineTo(x1, crisp(y1));
+    ctx.stroke();
+  }
+  ctx.restore();
+}
+function drawTrendlineLabels(surface, model) {
+  const cfg = resolveTrendline(model.spec.trendline);
+  if (!cfg || !cfg.label || model.x.kind === "band" || model.x.kind === "point") return;
+  const groups = trendGroups(model, cfg);
+  if (groups.length === 0) return;
+  const { tokens, plot } = model;
+  const f = tokens.font;
+  const font = fontString(f.size.small, f.family, f.weight.medium);
+  for (const g of groups) {
+    const x1 = model.x.pixel(g.xMax);
+    const y1 = model.y.pixel(g.fit.predict(g.xMax));
+    if (x1 == null || !Number.isFinite(x1) || !Number.isFinite(y1)) continue;
+    const text = `R\xB2=${g.fit.r2.toFixed(2)}`;
+    const labelW = measureText(text, font).width;
+    const nearRight = x1 + 6 + labelW > plot.x + plot.width;
+    const left = nearRight ? x1 - 6 : x1 + 6;
+    const align = nearRight ? "right" : "left";
+    const transform = nearRight ? "translateX(-100%) translateY(-50%)" : "translateY(-50%)";
+    const top = Math.min(Math.max(y1, plot.y + f.size.small), plot.y + plot.height - 2);
+    const color = g.color;
+    if (surface.headless) {
+      paintCanvasText(
+        surface.marks.ctx,
+        overlayTextToCanvasCmd({ left, top, text, color, size: f.size.small, align, transform }, font)
+      );
+      continue;
+    }
+    const el = document.createElement("div");
+    el.textContent = text;
+    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 = `${left}px`;
+    el.style.top = `${top}px`;
+    el.style.transform = transform;
+    el.style.pointerEvents = "none";
+    surface.overlay.appendChild(el);
+  }
+}
+export {
+  drawTrendlineLabels,
+  drawTrendlines
+};
+//# sourceMappingURL=trendline.js.map