@taloswork/ose-shared 0.1.11 → 0.1.13

package/skills/document/bin/deck-chart.cjs

@@ -0,0 +1,771 @@
+#!/usr/bin/env node
+"use strict";
+
+// apps/admin/data/skills.lib/document/bin-src/deck-chart.mjs
+var import_promises = require("node:fs/promises");
+
+// packages/core/dist/document/html-escape.js
+function escapeHtml(value) {
+  return String(value).replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
+}
+
+// packages/core/dist/document/deck-chart-svg.js
+var SVG_CHART_TYPES = ["bar", "barH", "line", "area", "pie", "doughnut", "radar", "scatter"];
+var RADAR_MAX_DIMS = 8;
+var RADAR_MAX_SERIES = 3;
+var SINGLE = "var(--chart-1, var(--accent))";
+var RAMP = [
+  "var(--series-1, var(--c1, var(--accent)))",
+  "var(--series-2, var(--c2, var(--muted)))",
+  "var(--series-3, var(--c3, var(--title)))",
+  "var(--series-4, var(--c4, var(--body)))"
+];
+var MAX_SERIES = RAMP.length;
+var ACCENT = "var(--chart-accent, var(--accent))";
+var SURFACE = "var(--chart-surface, var(--slide-bg, #fff))";
+var TXT = "var(--chart-ink, var(--body, currentColor))";
+var MUTED = "var(--chart-muted, var(--muted, currentColor))";
+var TITLE = "var(--chart-title, var(--title, currentColor))";
+var GRID = "var(--chart-grid, var(--hair, var(--muted)))";
+var r1 = (n) => String(Math.round(n * 10) / 10);
+var esc = (s) => escapeHtml(s);
+function textW(s, size) {
+  let w = 0;
+  for (const ch of s) {
+    const cp = ch.codePointAt(0);
+    w += cp >= 11904 ? 1 : ch === " " ? 0.3 : 0.56;
+  }
+  return w * size;
+}
+function formatValue(v) {
+  const rounded = Math.abs(v) >= 100 ? Math.round(v) : Math.round(v * 100) / 100;
+  const [int, frac] = String(Math.abs(rounded)).split(".");
+  const grouped = int.length > 4 ? int.replace(/\B(?=(\d{3})+(?!\d))/g, ",") : int;
+  return `${rounded < 0 ? "-" : ""}${grouped}${frac ? `.${frac}` : ""}`;
+}
+function niceNum(x, round) {
+  const exp = Math.floor(Math.log10(x));
+  const f = x / 10 ** exp;
+  const nf = round ? f < 1.5 ? 1 : f < 3 ? 2 : f < 7 ? 5 : 10 : f <= 1 ? 1 : f <= 2 ? 2 : f <= 5 ? 5 : 10;
+  return nf * 10 ** exp;
+}
+function niceScale(min, max, target = 5) {
+  if (!Number.isFinite(min) || !Number.isFinite(max))
+    return { lo: 0, hi: 1, ticks: [0, 1] };
+  if (min === max) {
+    if (min === 0)
+      return { lo: 0, hi: 1, ticks: [0, 0.25, 0.5, 0.75, 1] };
+    if (min > 0)
+      min = 0;
+    else
+      max = 0;
+  }
+  const step = niceNum(niceNum(max - min, false) / (target - 1), true);
+  const lo = Math.floor(min / step) * step;
+  const hi = Math.ceil(max / step) * step;
+  const ticks = [];
+  for (let t = lo; t <= hi + step / 2; t += step)
+    ticks.push(Math.round(t / step) * step);
+  return { lo, hi, ticks };
+}
+function barPath(x, y, w, h, end, radius = 4) {
+  if (w <= 0 || h <= 0)
+    return "";
+  const r = Math.min(radius, w / 2, h / 2);
+  const R = (n) => r1(n);
+  switch (end) {
+    case "top":
+      return `M${R(x)},${R(y + h)}V${R(y + r)}Q${R(x)},${R(y)} ${R(x + r)},${R(y)}H${R(x + w - r)}Q${R(x + w)},${R(y)} ${R(x + w)},${R(y + r)}V${R(y + h)}Z`;
+    case "bottom":
+      return `M${R(x)},${R(y)}V${R(y + h - r)}Q${R(x)},${R(y + h)} ${R(x + r)},${R(y + h)}H${R(x + w - r)}Q${R(x + w)},${R(y + h)} ${R(x + w)},${R(y + h - r)}V${R(y)}Z`;
+    case "right":
+      return `M${R(x)},${R(y)}H${R(x + w - r)}Q${R(x + w)},${R(y)} ${R(x + w)},${R(y + r)}V${R(y + h - r)}Q${R(x + w)},${R(y + h)} ${R(x + w - r)},${R(y + h)}H${R(x)}Z`;
+    case "left":
+      return `M${R(x + w)},${R(y)}H${R(x + r)}Q${R(x)},${R(y)} ${R(x)},${R(y + r)}V${R(y + h - r)}Q${R(x)},${R(y + h)} ${R(x + r)},${R(y + h)}H${R(x + w)}Z`;
+  }
+}
+function normalize(spec, warnings, errors) {
+  let type = String(spec?.type ?? "bar");
+  if (type === "bar" && spec.horizontal === true)
+    type = "barH";
+  if (type === "column")
+    type = "bar";
+  if (!SVG_CHART_TYPES.includes(type)) {
+    errors.push(`chart type "${type}" has no SVG renderer (${SVG_CHART_TYPES.join(" | ")}) \u2014 keep it native (render:"native")`);
+    return null;
+  }
+  if (type === "radar") {
+    const dims = Array.isArray(spec.labels) ? spec.labels.length : 0;
+    if (dims && dims < 3)
+      errors.push(`radar needs at least 3 dimensions (got ${dims}) \u2014 use a bar chart`);
+    if (dims > RADAR_MAX_DIMS)
+      errors.push(`radar takes at most ${RADAR_MAX_DIMS} dimensions (got ${dims}) \u2014 use barH, or group the dimensions`);
+    const raw = Array.isArray(spec.series) ? spec.series.filter((s) => s && Array.isArray(s.values)) : [];
+    if (raw.length > RADAR_MAX_SERIES)
+      errors.push(`radar overlays at most ${RADAR_MAX_SERIES} series (got ${raw.length}) \u2014 more polygons are unreadable; split the chart`);
+    raw.forEach((s, i) => {
+      if (!s.values.length)
+        errors.push(`radar series ${i + 1}${s.name ? ` "${s.name}"` : ""} has no values`);
+    });
+  }
+  const labels = Array.isArray(spec.labels) ? spec.labels.map((l) => String(l ?? "")) : [];
+  const rawSeries = Array.isArray(spec.series) ? spec.series.filter((s) => s && Array.isArray(s.values)) : [];
+  if (!labels.length)
+    errors.push("chart needs labels (one per category / slice)");
+  if (!rawSeries.length)
+    errors.push("chart needs at least one series with values");
+  if (errors.length)
+    return null;
+  const series = rawSeries.map((s, i) => {
+    const name = String(s.name ?? "");
+    const at = `series ${i + 1}${name ? ` "${name}"` : ""}`;
+    const vals = s.values.map((v) => typeof v === "string" ? Number(v.replace(/[,%\s]/g, "")) : Number(v));
+    if (vals.length !== labels.length) {
+      warnings.push(`${at} has ${vals.length} value(s) for ${labels.length} label(s) \u2014 ${vals.length < labels.length ? "missing ones drawn as 0" : "extras ignored"}`);
+    }
+    const bad = vals.filter((v) => !Number.isFinite(v)).length;
+    if (bad)
+      warnings.push(`${at} has ${bad} non-numeric value(s) \u2014 drawn as 0`);
+    return { name, values: labels.map((_, j) => Number.isFinite(vals[j]) ? vals[j] : 0) };
+  });
+  const pie = type === "pie" || type === "doughnut";
+  if (!pie && series.length > MAX_SERIES) {
+    errors.push(`${series.length} series \u2014 a chart carries at most ${MAX_SERIES} (the skin's --c1..--c4); fold the rest into "\u5176\u4ED6" or split the chart`);
+    return null;
+  }
+  if (pie && series.length > 1)
+    warnings.push(`${type} draws only the first series (${series.length} given)`);
+  return { type, labels, series };
+}
+function renderChartSvg(spec, opts) {
+  const warnings = [];
+  const errors = [];
+  const W = Math.max(120, Math.round(opts.width));
+  const H = Math.max(80, Math.round(opts.height));
+  const base = Math.max(12, Math.min(18, Math.round(Math.min(W / 2, H) / 22)));
+  const unit = typeof spec?.unit === "string" ? spec.unit : "";
+  const label = (v) => `${formatValue(v)}${unit}`;
+  let type;
+  let body;
+  let names;
+  if (String(spec?.type ?? "") === "scatter") {
+    const sc = normalizeScatter(spec, warnings, errors);
+    if (!sc)
+      return { svg: "", warnings, errors };
+    type = "scatter";
+    body = scatterBody(sc, W, H, base, spec);
+    names = sc.series.map((s) => s.name).filter(Boolean);
+  } else {
+    const n = normalize(spec, warnings, errors);
+    if (!n)
+      return { svg: "", warnings, errors };
+    type = n.type;
+    names = n.labels;
+    body = n.type === "radar" ? radarBody(n, W, H, base, spec, label, warnings) : n.type === "pie" || n.type === "doughnut" ? pieBody(n, W, H, base, spec, label, warnings) : n.type === "barH" ? barHBody(n, W, H, base, spec, label, warnings) : n.type === "bar" ? barBody(n, W, H, base, spec, label, warnings) : lineBody(n, W, H, base, spec, label);
+  }
+  const size = opts.fluid === false ? `width="${W}" height="${H}"` : `width="100%" height="100%"`;
+  const aria = esc(`${type} chart: ${names.slice(0, 12).join(", ")}`);
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg" class="talos-chart-svg" data-chart-type="${type}" ${size} viewBox="0 0 ${W} ${H}" preserveAspectRatio="xMidYMid meet" role="img" aria-label="${aria}" style="display:block;overflow:visible;font-family:var(--font-body, inherit);font-size:${base}px">${body}</svg>`;
+  return { svg, warnings, errors };
+}
+function legendRow(names, colors, x, y, base, maxW, centre = false) {
+  const size = Math.round(base * 0.75);
+  const rowH = Math.round(base * 1.6);
+  const rows = [[]];
+  let rowW = 0;
+  names.forEach((name, i) => {
+    const w = size + 6 + textW(name, base) + 18;
+    if (rowW > 0 && rowW + w > maxW) {
+      rows.push([]);
+      rowW = 0;
+    }
+    rows[rows.length - 1].push({ name, color: colors[i], w });
+    rowW += w;
+  });
+  const parts = [];
+  rows.forEach((row, ri) => {
+    const used = row.reduce((sum, it) => sum + it.w, 0) - 18;
+    let cx = centre ? x + Math.max(0, (maxW - used) / 2) : x;
+    const cy = y + ri * rowH;
+    for (const it of row) {
+      parts.push(`<rect x="${r1(cx)}" y="${r1(cy + (rowH - size) / 2 - 2)}" width="${size}" height="${size}" rx="2" style="fill:${it.color}"/>`);
+      parts.push(`<text x="${r1(cx + size + 6)}" y="${r1(cy + rowH / 2 + base * 0.35 - 2)}" style="fill:${TXT}">${esc(it.name)}</text>`);
+      cx += it.w;
+    }
+  });
+  return [parts.join(""), rows.length * rowH];
+}
+function seriesColors(n) {
+  return n.series.length === 1 ? [SINGLE] : n.series.map((_, i) => RAMP[i]);
+}
+function highlightSet(spec, count, warnings) {
+  if (spec.highlight === void 0)
+    return null;
+  const list = (Array.isArray(spec.highlight) ? spec.highlight : [spec.highlight]).map(Number);
+  const ok = list.filter((i) => Number.isInteger(i) && i >= 0 && i < count);
+  if (ok.length !== list.length)
+    warnings.push(`highlight indexes must be 0..${count - 1} \u2014 ignoring the rest`);
+  return ok.length ? new Set(ok) : null;
+}
+function labelled(values, showValues, few) {
+  if (showValues === false)
+    return /* @__PURE__ */ new Set();
+  if (showValues === true || values.length <= few)
+    return new Set(values.map((_, i) => i));
+  let hi = 0;
+  values.forEach((v, i) => {
+    if (v > values[hi])
+      hi = i;
+  });
+  return /* @__PURE__ */ new Set([hi, values.length - 1]);
+}
+function yAxis(ticks, toY, x0, x1, base, unit) {
+  return ticks.map((t) => {
+    const y = r1(toY(t));
+    return `<line x1="${r1(x0)}" x2="${r1(x1)}" y1="${y}" y2="${y}" style="stroke:${GRID};stroke-width:1" shape-rendering="crispEdges"/><text x="${r1(x0 - 8)}" y="${r1(toY(t) + base * 0.35)}" text-anchor="end" style="fill:${MUTED};font-size:${base - 1}px">${esc(formatValue(t) + (t === ticks[ticks.length - 1] ? unit : ""))}</text>`;
+  }).join("");
+}
+function barBody(n, W, H, base, spec, label, warnings) {
+  const stacked = spec.stacked === true && n.series.length > 1;
+  const colors = seriesColors(n);
+  const parts = [];
+  let top = 8;
+  if (n.series.length > 1) {
+    const [lg, h] = legendRow(n.series.map((s) => s.name || "\u2014"), colors, 0, 0, base, W);
+    parts.push(lg);
+    top = h + 8;
+  }
+  const totals = n.labels.map((_, j) => n.series.reduce((a, s) => a + Math.max(0, s.values[j]), 0));
+  const all = stacked ? totals : n.series.flatMap((s) => s.values);
+  if (stacked && n.series.some((s) => s.values.some((v) => v < 0)))
+    warnings.push("stacked bars cannot show negative values \u2014 drawn as 0");
+  const sc = niceScale(Math.min(0, ...all), Math.max(0, ...all));
+  const tickW = Math.max(...sc.ticks.map((t, i) => textW(formatValue(t) + (i === sc.ticks.length - 1 ? spec.unit ?? "" : ""), base - 1)));
+  const x0 = Math.ceil(tickW + 14);
+  const x1 = W - 4;
+  const y0 = top + base * 1.6;
+  const y1 = H - base * 2;
+  const toY = (v) => y1 - (v - sc.lo) / (sc.hi - sc.lo) * (y1 - y0);
+  parts.push(yAxis(sc.ticks, toY, x0, x1, base, spec.unit ?? ""));
+  const band = (x1 - x0) / n.labels.length;
+  const groupW = Math.min(band * 0.64, stacked ? 72 : 72 * n.series.length);
+  const barW = stacked ? groupW : (groupW - 2 * (n.series.length - 1)) / n.series.length;
+  const hl = n.series.length === 1 && !stacked ? highlightSet(spec, n.labels.length, warnings) : null;
+  const tooLong = n.labels.some((l) => textW(l, base) > band - 4);
+  if (tooLong)
+    warnings.push(`category labels are wider than their ${Math.round(band)}px column \u2014 use type "barH" or shorter labels`);
+  n.labels.forEach((lab, j) => {
+    const gx = x0 + band * j + (band - groupW) / 2;
+    if (stacked) {
+      let acc = 0;
+      n.series.forEach((s, i) => {
+        const v = Math.max(0, s.values[j]);
+        if (v <= 0)
+          return;
+        const yTop = toY(acc + v);
+        const yBot = toY(acc);
+        const isTop = n.series.slice(i + 1).every((t) => Math.max(0, t.values[j]) === 0);
+        const h = yBot - yTop - (acc > 0 ? 2 : 0);
+        parts.push(`<path d="${barPath(gx, yTop, barW, h, "top", isTop ? 4 : 0)}" style="fill:${colors[i]}"/>`);
+        acc += v;
+      });
+    } else {
+      n.series.forEach((s, i) => {
+        const v = s.values[j];
+        const x = gx + i * (barW + 2);
+        const yv = toY(v);
+        const yz = toY(0);
+        const fill = hl ? hl.has(j) ? ACCENT : MUTED : colors[i];
+        const op = hl && !hl.has(j) ? ";fill-opacity:.45" : "";
+        if (v >= 0)
+          parts.push(`<path d="${barPath(x, yv, barW, yz - yv, "top")}" style="fill:${fill}${op}"/>`);
+        else
+          parts.push(`<path d="${barPath(x, yz, barW, yv - yz, "bottom")}" style="fill:${fill}${op}"/>`);
+      });
+    }
+    parts.push(`<text x="${r1(x0 + band * j + band / 2)}" y="${r1(y1 + base * 1.4)}" text-anchor="middle" style="fill:${MUTED}">${esc(lab)}</text>`);
+  });
+  if (stacked || n.series.length === 1) {
+    const vals = stacked ? totals : n.series[0].values;
+    for (const j of labelled(vals, spec.showValues, 12)) {
+      const v = vals[j];
+      const y = v >= 0 ? toY(v) - 6 : toY(v) + base + 2;
+      parts.push(`<text x="${r1(x0 + band * j + band / 2)}" y="${r1(y)}" text-anchor="middle" style="fill:${TXT};font-weight:600">${esc(label(v))}</text>`);
+    }
+  } else if (spec.showValues === true) {
+    n.labels.forEach((_, j) => {
+      const gx = x0 + band * j + (band - groupW) / 2;
+      n.series.forEach((s, i) => {
+        const v = s.values[j];
+        const y = v >= 0 ? toY(v) - 5 : toY(v) + base;
+        parts.push(`<text x="${r1(gx + i * (barW + 2) + barW / 2)}" y="${r1(y)}" text-anchor="middle" style="fill:${TXT};font-size:${base - 2}px">${esc(label(v))}</text>`);
+      });
+    });
+  }
+  parts.push(`<line x1="${r1(x0)}" x2="${r1(x1)}" y1="${r1(toY(0))}" y2="${r1(toY(0))}" style="stroke:${MUTED};stroke-width:1" shape-rendering="crispEdges"/>`);
+  return parts.join("");
+}
+function barHBody(n, W, H, base, spec, label, warnings) {
+  const stacked = spec.stacked === true && n.series.length > 1;
+  const colors = seriesColors(n);
+  const parts = [];
+  let top = 4;
+  if (n.series.length > 1) {
+    const [lg, h] = legendRow(n.series.map((s) => s.name || "\u2014"), colors, 0, 0, base, W);
+    parts.push(lg);
+    top = h + 6;
+  }
+  const totals = n.labels.map((_, j) => n.series.reduce((a, s) => a + Math.max(0, s.values[j]), 0));
+  const vals = stacked ? totals : n.series.flatMap((s) => s.values);
+  if (vals.some((v) => v < 0))
+    warnings.push("barH draws negative values as 0 \u2014 use a vertical bar for a diverging series");
+  const sc = niceScale(0, Math.max(0, ...vals));
+  const labelW = Math.min(W * 0.38, Math.max(...n.labels.map((l) => textW(l, base))) + 12);
+  const valueW = Math.max(...(stacked ? totals : n.series.flatMap((s) => s.values)).map((v) => textW(label(Math.max(0, v)), base))) + 12;
+  const x0 = labelW;
+  const x1 = W - valueW;
+  const toX = (v) => x0 + Math.max(0, v) / (sc.hi || 1) * (x1 - x0);
+  const band = (H - top) / n.labels.length;
+  const groupH = Math.min(band * 0.62, stacked ? 44 : 44 * n.series.length);
+  const barH = stacked ? groupH : (groupH - 2 * (n.series.length - 1)) / n.series.length;
+  const hl = n.series.length === 1 && !stacked ? highlightSet(spec, n.labels.length, warnings) : null;
+  const shown = labelled(stacked ? totals : n.series[0].values, n.series.length === 1 || stacked ? spec.showValues : spec.showValues === true, 16);
+  n.labels.forEach((lab, j) => {
+    const gy = top + band * j + (band - groupH) / 2;
+    parts.push(`<text x="${r1(x0 - 12)}" y="${r1(top + band * j + band / 2 + base * 0.35)}" text-anchor="end" style="fill:${TXT}">${esc(lab)}</text>`);
+    if (stacked) {
+      let acc = 0;
+      n.series.forEach((s, i) => {
+        const v = Math.max(0, s.values[j]);
+        if (v <= 0)
+          return;
+        const xa = toX(acc) + (acc > 0 ? 2 : 0);
+        const isEnd = n.series.slice(i + 1).every((t) => Math.max(0, t.values[j]) === 0);
+        parts.push(`<path d="${barPath(xa, gy, toX(acc + v) - xa, barH, "right", isEnd ? 4 : 0)}" style="fill:${colors[i]}"/>`);
+        acc += v;
+      });
+      if (shown.has(j))
+        parts.push(`<text x="${r1(toX(totals[j]) + 8)}" y="${r1(gy + barH / 2 + base * 0.35)}" style="fill:${TXT};font-weight:600">${esc(label(totals[j]))}</text>`);
+    } else {
+      n.series.forEach((s, i) => {
+        const v = s.values[j];
+        const y = gy + i * (barH + 2);
+        const fill = hl ? hl.has(j) ? ACCENT : MUTED : colors[i];
+        const op = hl && !hl.has(j) ? ";fill-opacity:.45" : "";
+        parts.push(`<path d="${barPath(x0, y, toX(v) - x0, barH, "right")}" style="fill:${fill}${op}"/>`);
+        if (shown.has(j) && (n.series.length === 1 || spec.showValues === true)) {
+          parts.push(`<text x="${r1(toX(v) + 8)}" y="${r1(y + barH / 2 + base * 0.35)}" style="fill:${TXT};font-weight:600">${esc(label(v))}</text>`);
+        }
+      });
+    }
+  });
+  parts.push(`<line x1="${r1(x0)}" x2="${r1(x0)}" y1="${r1(top)}" y2="${r1(H)}" style="stroke:${MUTED};stroke-width:1" shape-rendering="crispEdges"/>`);
+  return parts.join("");
+}
+function lineBody(n, W, H, base, spec, label) {
+  const colors = seriesColors(n);
+  const parts = [];
+  let top = 8;
+  if (n.series.length > 1) {
+    const [lg, h] = legendRow(n.series.map((s) => s.name || "\u2014"), colors, 0, 0, base, W);
+    parts.push(lg);
+    top = h + 8;
+  }
+  const all = n.series.flatMap((s) => s.values);
+  const min = Math.min(...all);
+  const max = Math.max(...all);
+  const zoom = n.type === "line" && spec.zeroBaseline !== true && min > 0 && min > max * 0.6;
+  const sc = niceScale(zoom ? min : Math.min(0, min), Math.max(0, max));
+  const tickW = Math.max(...sc.ticks.map((t, i) => textW(formatValue(t) + (i === sc.ticks.length - 1 ? spec.unit ?? "" : ""), base - 1)));
+  const endW = Math.max(...n.series.map((s) => textW(label(s.values[s.values.length - 1]), base))) + 14;
+  const x0 = Math.ceil(tickW + 14);
+  const x1 = W - endW;
+  const y0 = top + base;
+  const y1 = H - base * 2;
+  const toY = (v) => y1 - (v - sc.lo) / (sc.hi - sc.lo) * (y1 - y0);
+  const inset = Math.min(24, (x1 - x0) / (2 * n.labels.length));
+  const toX = (j) => n.labels.length === 1 ? (x0 + x1) / 2 : x0 + inset + j * (x1 - x0 - 2 * inset) / (n.labels.length - 1);
+  parts.push(yAxis(sc.ticks, toY, x0, x1, base, spec.unit ?? ""));
+  const every = Math.max(1, Math.ceil(n.labels.reduce((m, l) => Math.max(m, textW(l, base)), 0) / Math.max(1, (x1 - x0) / n.labels.length - 6)));
+  n.labels.forEach((lab, j) => {
+    if (j % every !== 0 && j !== n.labels.length - 1)
+      return;
+    parts.push(`<text x="${r1(toX(j))}" y="${r1(y1 + base * 1.4)}" text-anchor="middle" style="fill:${MUTED}">${esc(lab)}</text>`);
+  });
+  n.series.forEach((s, i) => {
+    const pts = s.values.map((v, j) => `${r1(toX(j))},${r1(toY(v))}`);
+    if (n.type === "area") {
+      parts.push(`<path d="M${r1(toX(0))},${r1(toY(Math.max(sc.lo, 0)))}L${pts.join("L")}L${r1(toX(s.values.length - 1))},${r1(toY(Math.max(sc.lo, 0)))}Z" style="fill:${colors[i]};fill-opacity:.12"/>`);
+    }
+    parts.push(`<path d="M${pts.join("L")}" style="fill:none;stroke:${colors[i]};stroke-width:2.5;stroke-linejoin:round;stroke-linecap:round"/>`);
+    const marks = s.values.length <= 12 || spec.showValues === true ? s.values.map((_, j) => j) : [s.values.length - 1];
+    for (const j of marks) {
+      parts.push(`<circle cx="${r1(toX(j))}" cy="${r1(toY(s.values[j]))}" r="4.5" style="fill:${colors[i]};stroke:${SURFACE};stroke-width:2"/>`);
+    }
+    const lab = spec.showValues === false ? [] : spec.showValues === true ? s.values.map((_, j) => j) : [s.values.length - 1];
+    for (const j of lab) {
+      const end = j === s.values.length - 1;
+      parts.push(`<text x="${r1(toX(j) + (end ? 10 : 0))}" y="${r1(toY(s.values[j]) + (end ? base * 0.35 : -10))}" text-anchor="${end ? "start" : "middle"}" style="fill:${TXT};font-weight:600">${esc(label(s.values[j]))}</text>`);
+    }
+  });
+  return parts.join("");
+}
+function arc(cx, cy, r, a0, a1) {
+  const p = (a) => [cx + r * Math.sin(a), cy - r * Math.cos(a)];
+  const [xa, ya] = p(a0);
+  const [xb, yb] = p(a1);
+  return `${r1(xa)},${r1(ya)} A${r1(r)},${r1(r)} 0 ${a1 - a0 > Math.PI ? 1 : 0} 1 ${r1(xb)},${r1(yb)}`;
+}
+function pieBody(n, W, H, base, spec, label, warnings) {
+  let slices = n.labels.map((name, j) => ({ name, value: n.series[0].values[j] }));
+  if (slices.some((s) => s.value < 0))
+    warnings.push("pie/doughnut slices cannot be negative \u2014 drawn as 0");
+  slices = slices.map((s) => ({ ...s, value: Math.max(0, s.value) }));
+  let other = false;
+  if (slices.length > MAX_SERIES) {
+    const isOther = (name) => /^(其他|其它|others?)$/i.test(name.trim());
+    const sorted = [...slices].sort((a2, b) => Number(isOther(a2.name)) - Number(isOther(b.name)) || b.value - a2.value);
+    const rest = sorted.slice(MAX_SERIES - 1);
+    slices = [...sorted.slice(0, MAX_SERIES - 1), { name: "\u5176\u4ED6", value: rest.reduce((a2, s) => a2 + s.value, 0) }];
+    other = true;
+    warnings.push(`${n.labels.length} slices \u2014 the ${rest.length} smallest are folded into "\u5176\u4ED6" (a chart carries ${MAX_SERIES} colors)`);
+  }
+  const total = slices.reduce((a2, s) => a2 + s.value, 0);
+  const colors = slices.map((_, i) => other && i === slices.length - 1 ? MUTED : RAMP[i]);
+  const percentData = (spec.unit ?? "").trim() === "%";
+  const pctOf = (v) => total > 0 ? Math.round(v / total * 1e3) / 10 : 0;
+  const legendText = (v) => percentData ? label(v) : spec.showValues === false ? `${pctOf(v)}%` : `${label(v)} \xB7 ${pctOf(v)}%`;
+  const legendW = Math.min(W * 0.45, Math.max(...slices.map((s) => textW(`${s.name}  ${legendText(s.value)}`, base))) + base + 16);
+  const r = Math.max(20, Math.min((W - legendW - 32) / 2, H / 2 - 4));
+  const left = Math.max(0, (W - (2 * r + 32 + legendW)) / 2);
+  const cx = left + r + 4;
+  const cy = H / 2;
+  const parts = [];
+  const hole = n.type === "doughnut" ? r * 0.58 : 0;
+  let a = 0;
+  slices.forEach((s, i) => {
+    if (s.value <= 0 || total <= 0)
+      return;
+    const sweep = s.value / total * Math.PI * 2;
+    const a1 = a + sweep;
+    if (sweep >= Math.PI * 2 - 1e-6) {
+      parts.push(`<circle cx="${r1(cx)}" cy="${r1(cy)}" r="${r1(r)}" style="fill:${colors[i]}"/>`);
+    } else if (hole) {
+      const p = (rad, ang) => `${r1(cx + rad * Math.sin(ang))},${r1(cy - rad * Math.cos(ang))}`;
+      parts.push(`<path d="M${arc(cx, cy, r, a, a1)} L${p(hole, a1)} A${r1(hole)},${r1(hole)} 0 ${sweep > Math.PI ? 1 : 0} 0 ${p(hole, a)}Z" style="fill:${colors[i]};stroke:${SURFACE};stroke-width:2;stroke-linejoin:round"/>`);
+    } else {
+      parts.push(`<path d="M${r1(cx)},${r1(cy)} L${arc(cx, cy, r, a, a1)}Z" style="fill:${colors[i]};stroke:${SURFACE};stroke-width:2;stroke-linejoin:round"/>`);
+    }
+    a = a1;
+  });
+  const center = spec.centerLabel ?? (percentData ? "" : label(total));
+  if (hole && center) {
+    parts.push(`<text x="${r1(cx)}" y="${r1(cy + base * 0.6)}" text-anchor="middle" style="fill:${TITLE};font-weight:700;font-size:${Math.round(Math.min(hole * 0.55, base * 2))}px">${esc(center)}</text>`);
+  }
+  const lx = cx + r + 28;
+  const rowH = Math.round(base * 1.9);
+  const ly = cy - slices.length * rowH / 2;
+  slices.forEach((s, i) => {
+    const y = ly + i * rowH;
+    parts.push(`<rect x="${r1(lx)}" y="${r1(y + rowH / 2 - base * 0.4)}" width="${r1(base * 0.8)}" height="${r1(base * 0.8)}" rx="2" style="fill:${colors[i]}"/>`);
+    parts.push(`<text x="${r1(lx + base + 8)}" y="${r1(y + rowH / 2 + base * 0.35)}" style="fill:${TXT}">${esc(s.name)}<tspan dx="8" style="fill:${MUTED}">${esc(legendText(s.value))}</tspan></text>`);
+  });
+  return parts.join("");
+}
+function radarBody(n, W, H, base, spec, label, warnings) {
+  const colors = seriesColors(n);
+  const parts = [];
+  let top = 0;
+  if (n.series.length > 1) {
+    const [lg, h] = legendRow(n.series.map((s) => s.name || "\u2014"), colors, 0, 0, base, W, true);
+    parts.push(lg);
+    top = h + 4;
+  }
+  const dataMax = Math.max(0, ...n.series.flatMap((s) => s.values));
+  const given = Number(spec.max);
+  const explicit = spec.max !== void 0 && Number.isFinite(given) && given > 0;
+  if (spec.max !== void 0 && !explicit)
+    warnings.push(`radar max must be a positive number \u2014 using a scale over the data`);
+  const sc = niceScale(0, explicit ? given : dataMax || 1);
+  const max = explicit ? given : sc.hi;
+  const ticks = explicit ? [0.25, 0.5, 0.75, 1].map((f) => f * max) : sc.ticks.filter((t) => t > 0);
+  let low = 0;
+  let high = 0;
+  const series = n.series.map((s) => ({
+    name: s.name,
+    values: s.values.map((v) => {
+      if (v < 0) {
+        low++;
+        return 0;
+      }
+      if (v > max) {
+        high++;
+        return max;
+      }
+      return v;
+    })
+  }));
+  if (low)
+    warnings.push(`radar: ${low} negative value(s) drawn at the centre (0) \u2014 a radar's scale starts at 0`);
+  if (high)
+    warnings.push(`radar: ${high} value(s) above max ${formatValue(max)} drawn on the outer ring \u2014 raise "max" or fix the data`);
+  const single = n.series.length === 1;
+  const showVal = single && spec.showValues !== false;
+  const dimText = (j) => n.labels[j] + (showVal ? `  ${label(n.series[0].values[j])}` : "");
+  const labelW = Math.max(...n.labels.map((_, j) => textW(dimText(j), base)));
+  const dims = n.labels.length;
+  const ang = (j) => j * 2 * Math.PI / dims;
+  const sideW = Math.max(...n.labels.map((_, j) => Math.abs(Math.sin(ang(j))) > 0.2 ? textW(dimText(j), base) : textW(dimText(j), base) / 2));
+  const r = Math.max(30, Math.min((H - top) / 2 - base * 1.8, W / 2 - Math.min(sideW, labelW) - 14));
+  const cx = W / 2;
+  const cy = top + (H - top) / 2;
+  const pt = (j, rad) => [cx + rad * Math.sin(ang(j)), cy - rad * Math.cos(ang(j))];
+  const poly = (rad) => n.labels.map((_, j) => pt(j, rad(j)).map(r1).join(",")).join(" ");
+  for (const t of ticks) {
+    parts.push(`<polygon points="${poly(() => t / max * r)}" style="fill:none;stroke:${GRID};stroke-width:1"/>`);
+  }
+  n.labels.forEach((_, j) => {
+    const [x, y] = pt(j, r);
+    parts.push(`<line x1="${r1(cx)}" y1="${r1(cy)}" x2="${r1(x)}" y2="${r1(y)}" style="stroke:${GRID};stroke-width:1"/>`);
+  });
+  parts.push(radarTicks(series, ticks, max, r, cx, cy, dims, base, spec.unit ?? ""));
+  series.forEach((s, i) => {
+    const pts = poly((j) => s.values[j] / max * r);
+    parts.push(`<polygon points="${pts}" style="fill:${colors[i]};fill-opacity:${single ? ".18" : ".1"};stroke:${colors[i]};stroke-width:2.5;stroke-linejoin:round"/>`);
+    s.values.forEach((v, j) => {
+      const [x, y] = pt(j, v / max * r);
+      parts.push(`<circle cx="${r1(x)}" cy="${r1(y)}" r="4" style="fill:${colors[i]};stroke:${SURFACE};stroke-width:2"/>`);
+    });
+  });
+  n.labels.forEach((name, j) => {
+    const sin = Math.sin(ang(j));
+    const cos = Math.cos(ang(j));
+    const [x, y] = pt(j, r + 14);
+    const anchor = sin > 0.2 ? "start" : sin < -0.2 ? "end" : "middle";
+    const dy = cos > 0.2 ? -2 : cos < -0.2 ? base * 0.9 : base * 0.35;
+    const value = showVal ? `<tspan dx="6" style="fill:${TITLE};font-weight:700">${esc(label(n.series[0].values[j]))}</tspan>` : "";
+    parts.push(`<text x="${r1(x)}" y="${r1(y + dy)}" text-anchor="${anchor}" style="fill:${TXT}">${esc(name)}${value}</text>`);
+  });
+  return parts.join("");
+}
+function segHitsBox(ax, ay, bx, by, box) {
+  const dx = bx - ax;
+  const dy = by - ay;
+  let t0 = 0;
+  let t1 = 1;
+  for (const [p, q] of [[-dx, ax - box.x0], [dx, box.x1 - ax], [-dy, ay - box.y0], [dy, box.y1 - ay]]) {
+    if (p === 0) {
+      if (q < 0)
+        return false;
+      continue;
+    }
+    const t = q / p;
+    if (p < 0) {
+      if (t > t1)
+        return false;
+      if (t > t0)
+        t0 = t;
+    } else {
+      if (t < t0)
+        return false;
+      if (t < t1)
+        t1 = t;
+    }
+  }
+  return true;
+}
+function radarTicks(series, ticks, max, r, cx, cy, dims, base, unit) {
+  const size = base - 3;
+  const ang = (j) => j * 2 * Math.PI / dims;
+  const at = (j, rad) => [cx + rad * Math.sin(ang(j)), cy - rad * Math.cos(ang(j))];
+  const edge = Math.cos(Math.PI / dims);
+  const gap = ticks.length > 1 ? (ticks[1] - ticks[0]) / max * r * edge : Infinity;
+  const step = gap < size * 1.6 ? 2 : 1;
+  const shown = ticks.map((t, i) => ({ t, i })).filter(({ i }) => (ticks.length - 1 - i) % step === 0);
+  const segs = [];
+  const dots = [];
+  for (const s of series) {
+    const pts = s.values.map((v, j) => at(j, v / max * r));
+    pts.forEach((p, j) => {
+      const q = pts[(j + 1) % pts.length];
+      segs.push([p[0], p[1], q[0], q[1]]);
+      dots.push(p);
+    });
+  }
+  const DOT = 6;
+  const PAD = 2;
+  const place = (wedge, t, last) => {
+    const mid = ang(wedge) + Math.PI / dims;
+    const sin = Math.sin(mid);
+    const cos = Math.cos(mid);
+    const rad = t / max * r * edge;
+    const px = cx + rad * sin;
+    const py = cy - rad * cos;
+    const text = formatValue(t) + (last ? unit : "");
+    const w = textW(text, size);
+    const anchor = sin < -0.2 ? "end" : sin > 0.2 ? "start" : "middle";
+    const x = px + (anchor === "end" ? -3 : anchor === "start" ? 3 : 0);
+    const y = cos > 0.2 ? py - 3 : cos < -0.2 ? py + size + 1 : py + size * 0.35;
+    const x0 = anchor === "end" ? x - w : anchor === "start" ? x : x - w / 2;
+    const box = { x0: x0 - PAD, y0: y - size * 0.8 - PAD, x1: x0 + w + PAD, y1: y + size * 0.2 + PAD };
+    const hit = segs.some(([ax, ay, bx, by]) => segHitsBox(ax, ay, bx, by, box)) || dots.some(([dx, dy]) => Math.hypot(Math.max(box.x0 - dx, 0, dx - box.x1), Math.max(box.y0 - dy, 0, dy - box.y1)) < DOT);
+    return { x, y, anchor, text, hit };
+  };
+  const order = [dims - 1, ...Array.from({ length: dims - 1 }, (_, j) => j)];
+  let best = order[0];
+  let bestHits = Infinity;
+  for (const wedge of order) {
+    const hits = shown.reduce((n, { t, i }) => n + (place(wedge, t, i === ticks.length - 1).hit ? 1 : 0), 0);
+    if (hits < bestHits) {
+      best = wedge;
+      bestHits = hits;
+    }
+    if (!hits)
+      break;
+  }
+  return shown.map(({ t, i }) => ({ last: i === ticks.length - 1, ...place(best, t, i === ticks.length - 1) })).filter((l) => l.last || !l.hit).map((l) => `<text x="${r1(l.x)}" y="${r1(l.y)}" text-anchor="${l.anchor}" style="fill:${MUTED};font-size:${size}px;paint-order:stroke;stroke:${SURFACE};stroke-width:3px;stroke-linejoin:round">${esc(l.text)}</text>`).join("");
+}
+var toNum = (v) => typeof v === "number" ? v : typeof v === "string" && v.trim() ? Number(v.replace(/[,%\s]/g, "")) : NaN;
+function normalizeScatter(spec, warnings, errors) {
+  const raw = Array.isArray(spec.series) ? spec.series.filter((s) => s && typeof s === "object") : [];
+  if (!raw.length) {
+    errors.push("scatter needs at least one series with points ([x, y] or {x, y, label})");
+    return null;
+  }
+  if (raw.length > MAX_SERIES) {
+    errors.push(`${raw.length} series \u2014 a chart carries at most ${MAX_SERIES} (the skin's --c1..--c4); merge or split the chart`);
+    return null;
+  }
+  const labels = Array.isArray(spec.labels) ? spec.labels : [];
+  const series = raw.map((s, i) => {
+    const name = String(s.name ?? "");
+    const at = `scatter series ${i + 1}${name ? ` "${name}"` : ""}`;
+    let rows = Array.isArray(s.points) ? s.points : [];
+    if (!Array.isArray(s.points) && Array.isArray(s.values))
+      rows = s.values.map((y, j) => [labels[j], y]);
+    let bad = 0;
+    const points = [];
+    for (const p of rows) {
+      const [x, y, lab] = Array.isArray(p) ? [p[0], p[1], p[2]] : p && typeof p === "object" ? [p.x, p.y, p.label] : [NaN, NaN, ""];
+      const nx = toNum(x);
+      const ny = toNum(y);
+      if (!Number.isFinite(nx) || !Number.isFinite(ny)) {
+        bad++;
+        continue;
+      }
+      points.push({ x: nx, y: ny, label: lab == null ? "" : String(lab) });
+    }
+    if (bad)
+      warnings.push(`${at}: ${bad} point(s) without a numeric x and y \u2014 dropped`);
+    if (!rows.length)
+      warnings.push(`${at} has no points`);
+    return { name, points };
+  });
+  if (!series.some((s) => s.points.length)) {
+    errors.push("scatter has no plottable point \u2014 give series[].points as [x, y] or {x, y, label}");
+    return null;
+  }
+  return { series };
+}
+function axisScale(vals) {
+  const min = Math.min(...vals);
+  const max = Math.max(...vals);
+  const zoom = min > 0 && min > max * 0.6 || max < 0 && max < min * 0.6;
+  return niceScale(zoom ? min : Math.min(0, min), zoom ? max : Math.max(0, max));
+}
+function scatterBody(d, W, H, base, spec) {
+  const colors = d.series.length === 1 ? [SINGLE] : d.series.map((_, i) => RAMP[i]);
+  const parts = [];
+  let top = 8;
+  if (d.series.length > 1) {
+    const [lg, h] = legendRow(d.series.map((s) => s.name || "\u2014"), colors, 0, 0, base, W);
+    parts.push(lg);
+    top = h + 8;
+  }
+  const all = d.series.flatMap((s) => s.points);
+  const xs = axisScale(all.map((p) => p.x));
+  const ys = axisScale(all.map((p) => p.y));
+  const unit = spec.unit ?? "";
+  const xUnit = spec.xUnit ?? "";
+  if (spec.yLabel) {
+    parts.push(`<text x="0" y="${r1(top + base * 0.8)}" style="fill:${MUTED};font-size:${base - 1}px">${esc(spec.yLabel)}</text>`);
+    top += base * 1.4;
+  }
+  const tickW = Math.max(...ys.ticks.map((t, i) => textW(formatValue(t) + (i === ys.ticks.length - 1 ? unit : ""), base - 1)));
+  const lastX = formatValue(xs.ticks[xs.ticks.length - 1]) + xUnit;
+  const x0 = Math.ceil(tickW + 14);
+  const x1 = W - Math.max(8, textW(lastX, base - 1) / 2 + 2);
+  const y0 = top + base * 0.6;
+  const y1 = H - base * (spec.xLabel ? 3.2 : 2);
+  const toX = (v) => x0 + (v - xs.lo) / (xs.hi - xs.lo) * (x1 - x0);
+  const toY = (v) => y1 - (v - ys.lo) / (ys.hi - ys.lo) * (y1 - y0);
+  parts.push(yAxis(ys.ticks, toY, x0, x1, base, unit));
+  xs.ticks.forEach((t, i) => {
+    const x = r1(toX(t));
+    parts.push(`<line x1="${x}" x2="${x}" y1="${r1(y0)}" y2="${r1(y1)}" style="stroke:${GRID};stroke-width:1" shape-rendering="crispEdges"/>`);
+    parts.push(`<text x="${x}" y="${r1(y1 + base * 1.4)}" text-anchor="middle" style="fill:${MUTED};font-size:${base - 1}px">${esc(formatValue(t) + (i === xs.ticks.length - 1 ? xUnit : ""))}</text>`);
+  });
+  if (spec.xLabel) {
+    parts.push(`<text x="${r1(x1)}" y="${r1(H - base * 0.4)}" text-anchor="end" style="fill:${MUTED};font-size:${base - 1}px">${esc(spec.xLabel)}</text>`);
+  }
+  const ax = r1(toX(xs.lo <= 0 && xs.hi >= 0 ? 0 : xs.lo));
+  const ay = r1(toY(ys.lo <= 0 && ys.hi >= 0 ? 0 : ys.lo));
+  parts.push(`<line x1="${r1(x0)}" x2="${r1(x1)}" y1="${ay}" y2="${ay}" style="stroke:${MUTED};stroke-width:1" shape-rendering="crispEdges"/>`);
+  parts.push(`<line x1="${ax}" x2="${ax}" y1="${r1(y0)}" y2="${r1(y1)}" style="stroke:${MUTED};stroke-width:1" shape-rendering="crispEdges"/>`);
+  const dense = all.length > 60;
+  d.series.forEach((s, i) => {
+    for (const p of s.points) {
+      parts.push(`<circle cx="${r1(toX(p.x))}" cy="${r1(toY(p.y))}" r="${dense ? 4 : 6}" style="fill:${colors[i]};fill-opacity:.85;stroke:${SURFACE};stroke-width:1.5"/>`);
+    }
+  });
+  if (spec.showValues !== false) {
+    d.series.forEach((s) => {
+      for (const p of s.points) {
+        if (!p.label)
+          continue;
+        parts.push(`<text x="${r1(toX(p.x) + 9)}" y="${r1(toY(p.y) + base * 0.35 - 1)}" style="fill:${TXT};font-size:${base - 2}px">${esc(p.label)}</text>`);
+      }
+    });
+  }
+  return parts.join("");
+}
+
+// apps/admin/data/skills.lib/document/bin-src/deck-chart.mjs
+function die(msg, code = 1) {
+  process.stderr.write(`deck-chart: ${msg}
+`);
+  process.exit(code);
+}
+async function main() {
+  const argv = process.argv.slice(2);
+  const flag = (k) => {
+    const i = argv.indexOf(`--${k}`);
+    return i >= 0 ? argv[i + 1] : void 0;
+  };
+  const pos = argv.filter((a, i) => !a.startsWith("--") && !argv[i - 1]?.startsWith("--"));
+  const [chartPath, outPath] = pos;
+  const width = Number(flag("width"));
+  const height = Number(flag("height"));
+  if (!chartPath || !(width > 0) || !(height > 0)) die("usage: deck-chart <chart.json> [out.svg] --width <px> --height <px>", 64);
+  let spec;
+  try {
+    spec = JSON.parse(await (0, import_promises.readFile)(chartPath, "utf8"));
+  } catch (e) {
+    die(`cannot read chart ${chartPath}: ${e.message}`, 66);
+  }
+  const r = renderChartSvg(spec, { width, height, fluid: false });
+  for (const w of r.warnings) process.stderr.write(`deck-chart: ${w}
+`);
+  if (r.errors.length) {
+    for (const e of r.errors) process.stderr.write(`deck-chart: ERROR ${e}
+`);
+    die(`${r.errors.length} chart error(s) \u2014 nothing written`, 1);
+  }
+  if (outPath) {
+    await (0, import_promises.writeFile)(outPath, r.svg + "\n", "utf8");
+    process.stdout.write(JSON.stringify({ ok: true, out: outPath, width, height, warnings: r.warnings }) + "\n");
+  } else {
+    process.stdout.write(r.svg + "\n");
+  }
+}
+main().catch((e) => die(e.message, 1));