niceeval 0.12.2-canary.31 → 0.13.0

package/dist/report/assets/colors.js

@@ -0,0 +1,18 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./colors.cjs");
+const __niceevalExport0 = __niceevalCanonical["SERIES_PALETTE"];
+export { __niceevalExport0 as SERIES_PALETTE };
+const __niceevalExport1 = __niceevalCanonical["SERIES_PALETTE_SIZE"];
+export { __niceevalExport1 as SERIES_PALETTE_SIZE };
+const __niceevalExport2 = __niceevalCanonical["colorClassForKey"];
+export { __niceevalExport2 as colorClassForKey };
+const __niceevalExport3 = __niceevalCanonical["colorHexForKey"];
+export { __niceevalExport3 as colorHexForKey };
+const __niceevalExport4 = __niceevalCanonical["colorIndexForKey"];
+export { __niceevalExport4 as colorIndexForKey };
+const __niceevalExport5 = __niceevalCanonical["colorIndicesForKeys"];
+export { __niceevalExport5 as colorIndicesForKeys };
+const __niceevalExport6 = __niceevalCanonical["seriesClassForKey"];
+export { __niceevalExport6 as seriesClassForKey };
+//# sourceMappingURL=colors.js.map

package/dist/report/assets/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sources":[],"names":[],"mappings":""}

package/dist/report/assets/enhance.js

@@ -0,0 +1,466 @@
+// niceeval 报告的渐进增强 runtime:纯 vanilla JS、零依赖、IIFE、幂等。
+// 只作用于 .niceeval-report DOM 与 data-niceeval-* 属性;六个行为——Tabs 单选切换、表格排序、
+// 行过滤、SVG 点 tooltip、警告命令复制、源码语法着色。全部只改浏览状态,不改数据、指标口径或初始 HTML 数值。
+// 静态 HTML 无 JS 时内容完整可读是硬约束:排序有数据侧预排、tooltip 退化为原生 <title>、
+// 过滤输入框静默无功能、Tabs 退化为原生 <details> 手风琴、命令块退化为点击全选。
+// 全部经 document 级事件委托绑定,重复注入本文件只在首次生效(window.__nreEnhanced 守卫),
+// DOM 被搬动(如 view 把 <template> 内容摆进报告槽)也无需重新绑定。
+
+(function () {
+  "use strict";
+  if (typeof window === "undefined" || window.__nreEnhanced) return;
+  window.__nreEnhanced = true;
+
+  // 根类 niceeval-js:styles.css 用它把仅增强态的布局(单选 tab 条、复制指针)限定在 JS 在场时。
+  // 挂在 documentElement 上与报告块位置无关,块之后被搬进槽位也不需要补标记。
+  document.documentElement.classList.add("niceeval-js");
+
+  function closest(target, selector) {
+    return target && target.closest ? target.closest(selector) : null;
+  }
+
+  // ───────────────────────── SourceView:客户端语法着色 ─────────────────────────
+  // 静态 HTML 只保留完整、已转义的源码文本，避免全站构建为每个 token、每种 locale
+  // 预先创建 React 节点。浏览器只给当前打开的文档着色；无 JS 时源码仍完整可读。
+  // MutationObserver 覆盖 attempt 文档被 Host modal 插入后的同一行为。
+
+  var sourceTokenPattern =
+    /(\/\/[^\n]*)|(\/\*[^]*?\*\/)|(`(?:\\.|[^`\\])*`|"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')|\b(import|from|export|default|const|let|var|async|await|function|return|if|else|for|of|in|new|class|extends|typeof|void|true|false|null|undefined)\b|\b(\d[\d_.]*)\b|([A-Za-z_$][\w$]*)(?=\s*\()/g;
+
+  function highlightSourceCode(code) {
+    if (code.hasAttribute("data-niceeval-highlighted")) return;
+    var line = code.textContent || "";
+    var fragment = document.createDocumentFragment();
+    var last = 0;
+    var match;
+    sourceTokenPattern.lastIndex = 0;
+    while ((match = sourceTokenPattern.exec(line))) {
+      if (match.index > last) fragment.appendChild(document.createTextNode(line.slice(last, match.index)));
+      var token = document.createElement("span");
+      token.className = match[1] || match[2]
+        ? "tok-comment"
+        : match[3]
+          ? "tok-str"
+          : match[4]
+            ? "tok-kw"
+            : match[5]
+              ? "tok-num"
+              : "tok-fn";
+      token.textContent = match[0];
+      fragment.appendChild(token);
+      last = match.index + match[0].length;
+      if (match[0].length === 0) sourceTokenPattern.lastIndex++;
+    }
+    if (last < line.length) fragment.appendChild(document.createTextNode(line.slice(last)));
+    code.replaceChildren(fragment);
+    code.setAttribute("data-niceeval-highlighted", "");
+  }
+
+  function highlightSources(root) {
+    if (!root || (root.nodeType !== 1 && root.nodeType !== 9 && root.nodeType !== 11)) return;
+    if (root.nodeType === 1 && root.matches(".niceeval-source-code")) highlightSourceCode(root);
+    var codes = root.querySelectorAll ? root.querySelectorAll(".niceeval-source-code") : [];
+    for (var i = 0; i < codes.length; i++) highlightSourceCode(codes[i]);
+  }
+
+  highlightSources(document);
+  new MutationObserver(function (records) {
+    for (var i = 0; i < records.length; i++) {
+      for (var j = 0; j < records[i].addedNodes.length; j++) highlightSources(records[i].addedNodes[j]);
+    }
+  }).observe(document.documentElement, { childList: true, subtree: true });
+
+  // ───────────────────────── Tabs:[data-niceeval-tabs] 单选切换 ─────────────────────────
+  // 静态 HTML 每 tab 一个 <details> 且仅首个 open;点击 summary 时接管原生 toggle:
+  // 打开所点 tab、收起同组其余,点已开的 tab 保持打开(单选语义,恒有一个面板可见)。
+  // 只切换 open 状态,不触碰 tab 内任何数据;键盘 Enter/Space 走 summary 的原生激活(即 click)。
+
+  document.addEventListener("click", function (e) {
+    var title = closest(e.target, "[data-niceeval-tabs] > details > summary");
+    if (!title) return;
+    e.preventDefault();
+    var tab = title.parentNode;
+    var group = tab.parentNode;
+    for (var i = 0; i < group.children.length; i++) {
+      var child = group.children[i];
+      if (child.tagName === "DETAILS") child.open = child === tab;
+    }
+  });
+
+  // ───────────────────────── 复制:[data-niceeval-copy](宿主警告块的命令) ─────────────────────────
+  // 点击把 data-niceeval-copy 携带的完整命令写进剪贴板,成功后短暂打上 data-niceeval-copied
+  // (styles.css 显示 ✓);剪贴板不可用时退化为全选该块文本,用户手动复制。
+  // 块内文本与属性值恒不变,复制的是数据侧已写好的命令原文。
+
+  document.addEventListener("click", function (e) {
+    var block = closest(e.target, "[data-niceeval-copy]");
+    if (!block) return;
+    var command = block.getAttribute("data-niceeval-copy") || "";
+    function mark() {
+      block.setAttribute("data-niceeval-copied", "");
+      setTimeout(function () {
+        block.removeAttribute("data-niceeval-copied");
+      }, 1500);
+    }
+    function selectFallback() {
+      var selection = window.getSelection();
+      if (!selection) return;
+      var range = document.createRange();
+      range.selectNodeContents(block);
+      selection.removeAllRanges();
+      selection.addRange(range);
+    }
+    if (navigator.clipboard && navigator.clipboard.writeText) {
+      navigator.clipboard.writeText(command).then(mark, selectFallback);
+    } else {
+      selectFallback();
+    }
+  });
+
+  // ───────────────────────── 排序:th[data-niceeval-sort] ─────────────────────────
+  // 点击按该列排序 tbody 行(td/th 的 data-sort-value,数值优先、退回字符串;
+  // 空值恒沉底),再点反向;方向指示由 th 上的 niceeval-sort-asc / niceeval-sort-desc 类驱动。
+
+  function sortValue(row, index) {
+    var cell = row.cells[index];
+    if (!cell) return "";
+    var v = cell.getAttribute("data-sort-value");
+    return v !== null ? v : cell.textContent.trim();
+  }
+
+  document.addEventListener("click", function (e) {
+    var th = closest(e.target, ".niceeval-report table th[data-niceeval-sort]");
+    if (!th) return;
+    var table = th.closest("table");
+    var tbody = table && table.tBodies[0];
+    if (!tbody) return;
+    var index = Array.prototype.indexOf.call(th.parentNode.children, th);
+    var dir = th.classList.contains("niceeval-sort-asc") ? "desc" : "asc";
+    var siblings = th.parentNode.querySelectorAll("th[data-niceeval-sort]");
+    for (var i = 0; i < siblings.length; i++) siblings[i].classList.remove("niceeval-sort-asc", "niceeval-sort-desc");
+    th.classList.add(dir === "asc" ? "niceeval-sort-asc" : "niceeval-sort-desc");
+
+    if (table.classList.contains("niceeval-table--hierarchical")) {
+      var body = table.querySelector(".niceeval-table-hierarchy-body");
+      var entries = body
+        ? Array.prototype.slice.call(body.querySelectorAll(":scope > .niceeval-table-hierarchy-row"))
+        : [];
+      entries.sort(function (a, b) {
+        var ac = a.querySelector(":scope > .niceeval-table-hierarchy-summary, :scope > .niceeval-table-hierarchy-cell");
+        var bc = b.querySelector(":scope > .niceeval-table-hierarchy-summary, :scope > .niceeval-table-hierarchy-cell");
+        var aCells = ac && ac.classList.contains("niceeval-table-hierarchy-summary") ? ac.children : a.children;
+        var bCells = bc && bc.classList.contains("niceeval-table-hierarchy-summary") ? bc.children : b.children;
+        var av = aCells[index] ? aCells[index].getAttribute("data-sort-value") || aCells[index].textContent.trim() : "";
+        var bv = bCells[index] ? bCells[index].getAttribute("data-sort-value") || bCells[index].textContent.trim() : "";
+        if (av === "" && bv === "") return 0;
+        if (av === "") return 1;
+        if (bv === "") return -1;
+        var an = Number(av), bn = Number(bv);
+        var compared = !isNaN(an) && !isNaN(bn) ? an - bn : String(av).localeCompare(String(bv));
+        return dir === "asc" ? compared : -compared;
+      });
+      for (var h = 0; h < entries.length; h++) body.appendChild(entries[h]);
+      return;
+    }
+
+    var rows = Array.prototype.slice.call(tbody.rows);
+    rows.sort(function (a, b) {
+      var va = sortValue(a, index);
+      var vb = sortValue(b, index);
+      // 空值 = 缺数据:恒沉底,与「缺数据不编 0」同一姿势
+      if (va === "" && vb === "") return 0;
+      if (va === "") return 1;
+      if (vb === "") return -1;
+      var na = Number(va);
+      var nb = Number(vb);
+      var out;
+      if (!isNaN(na) && !isNaN(nb)) out = na - nb;
+      else out = String(va).localeCompare(String(vb));
+      return dir === "asc" ? out : -out;
+    });
+    for (var u = 0; u < rows.length; u++) tbody.appendChild(rows[u]);
+  });
+
+  // ───────────────────────── 过滤:input[data-niceeval-filter] ─────────────────────────
+  // 对同容器内的表格行做 textContent 匹配,不匹配者加隐藏类(样式在 styles.css)。
+
+  document.addEventListener("input", function (e) {
+    var input = closest(e.target, "input[data-niceeval-filter]");
+    if (!input) return;
+    var sample = input.parentElement;
+    var table = sample ? sample.querySelector("table") : null;
+    if (!table || !table.tBodies[0]) return;
+    var query = input.value.trim().toLowerCase();
+    if (table.classList.contains("niceeval-table--hierarchical")) {
+      // A top-level group's text includes every descendant. Filtering only its
+      // direct children therefore leaves non-matching nested rows visible
+      // whenever a sibling matches. Each rendered hierarchy row must receive
+      // the same visibility decision independently.
+      var entries = table.querySelectorAll(".niceeval-table-hierarchy-row");
+      for (var h = 0; h < entries.length; h++) {
+        entries[h].classList.toggle(
+          "niceeval-row-hidden",
+          query !== "" && entries[h].textContent.toLowerCase().indexOf(query) === -1,
+        );
+      }
+      return;
+    }
+    var rows = table.tBodies[0].rows;
+    for (var i = 0; i < rows.length; i++) {
+      var row = rows[i];
+      var hide = query !== "" && row.textContent.toLowerCase().indexOf(query) === -1;
+      row.classList.toggle("niceeval-row-hidden", hide);
+    }
+  });
+
+  // ───────────────────────── TurnTrace:trajectory toolbar + row accordion ─────────────────────────
+  // 每个 ledger row、timeline span 和行内 evidence 都在 SSR 时生成。这里仅把
+  // 它们按稳定 data id 联动：单开折叠，不 cloneNode、不搬动 evidence、也不依赖 CSS.escape。
+
+  function traceByElement(element) {
+    return element ? element.closest("[data-niceeval-turn-trace]") : null;
+  }
+
+  function traceElementsById(trace, attribute, id) {
+    var nodes = trace.querySelectorAll("[" + attribute + "]");
+    var found = [];
+    for (var i = 0; i < nodes.length; i++) {
+      if (nodes[i].getAttribute(attribute) === id) found.push(nodes[i]);
+    }
+    return found;
+  }
+
+  function traceElementById(trace, attribute, id) {
+    var elements = traceElementsById(trace, attribute, id);
+    return elements.length === 0 ? null : elements[0];
+  }
+
+  function activateTurnTraceEvidenceTab(evidence, tab) {
+    if (!evidence) return;
+    var buttons = evidence.querySelectorAll("[data-niceeval-trace-evidence-tab]");
+    var panels = evidence.querySelectorAll("[data-niceeval-trace-evidence-panel]");
+    for (var i = 0; i < buttons.length; i++) {
+      var active = buttons[i].getAttribute("data-niceeval-trace-evidence-tab") === tab;
+      buttons[i].setAttribute("aria-selected", active ? "true" : "false");
+    }
+    for (var j = 0; j < panels.length; j++) {
+      var panelActive = panels[j].getAttribute("data-niceeval-trace-evidence-panel") === tab;
+      panels[j].setAttribute("data-active", panelActive ? "true" : "false");
+    }
+  }
+
+  function closeTurnTraceEvidence(trace) {
+    if (!trace) return;
+    var evidence = trace.querySelectorAll("[data-niceeval-trace-evidence]");
+    for (var i = 0; i < evidence.length; i++) evidence[i].open = false;
+    var selected = trace.querySelectorAll("[data-niceeval-trace-select][aria-pressed='true'], [data-niceeval-trace-timeline-event][aria-pressed='true']");
+    for (var j = 0; j < selected.length; j++) {
+      selected[j].setAttribute("aria-pressed", "false");
+      if (selected[j].hasAttribute("data-niceeval-trace-select")) selected[j].setAttribute("aria-expanded", "false");
+    }
+  }
+
+  function toggleTurnTraceEvidence(trace, eventId, reveal) {
+    if (!trace || !eventId) return;
+    var row = traceElementById(trace, "data-niceeval-trace-event", eventId);
+    var evidence = traceElementById(trace, "data-niceeval-trace-evidence", eventId);
+    if (!evidence || !row) return;
+    var wasOpen = evidence.open;
+
+    closeTurnTraceEvidence(trace);
+    if (wasOpen) return;
+    var turn = row.closest("[data-niceeval-trace-turn]");
+    if (turn) setTurnCollapsed(turn, false);
+    evidence.open = true;
+    var rowSelectors = traceElementsById(trace, "data-niceeval-trace-select", eventId);
+    var timelineSelectors = traceElementsById(trace, "data-niceeval-trace-timeline-event", eventId);
+    for (var k = 0; k < rowSelectors.length; k++) {
+      rowSelectors[k].setAttribute("aria-pressed", "true");
+      rowSelectors[k].setAttribute("aria-expanded", "true");
+    }
+    for (var m = 0; m < timelineSelectors.length; m++) timelineSelectors[m].setAttribute("aria-pressed", "true");
+    activateTurnTraceEvidenceTab(evidence, "preview");
+    if (reveal && row.scrollIntoView) row.scrollIntoView({ block: "nearest" });
+  }
+
+  function setTurnCollapsed(turn, collapsed) {
+    if (!turn) return;
+    turn.setAttribute("data-collapsed", collapsed ? "true" : "false");
+    var toggle = turn.querySelector("[data-niceeval-trace-turn-toggle]");
+    if (toggle) toggle.setAttribute("aria-expanded", collapsed ? "false" : "true");
+  }
+
+  function toggleAllTurns(trace) {
+    var turns = trace.querySelectorAll("[data-niceeval-trace-turn]");
+    if (turns.length === 0) return;
+    var allCollapsed = true;
+    for (var i = 0; i < turns.length; i++) {
+      if (turns[i].getAttribute("data-collapsed") !== "true") {
+        allCollapsed = false;
+        break;
+      }
+    }
+    for (var j = 0; j < turns.length; j++) setTurnCollapsed(turns[j], !allCollapsed);
+    var control = trace.querySelector("[data-niceeval-trace-turns]");
+    if (control) {
+      control.setAttribute("aria-pressed", allCollapsed ? "false" : "true");
+      var glyph = control.querySelector(".niceeval-trace-toolbar-glyph");
+      if (glyph) glyph.textContent = allCollapsed ? "⊟" : "⊞";
+    }
+  }
+
+  function toggleAllCalls(trace) {
+    var collapsed = trace.getAttribute("data-calls-collapsed") === "true";
+    trace.setAttribute("data-calls-collapsed", collapsed ? "false" : "true");
+    var control = trace.querySelector("[data-niceeval-trace-calls]");
+    if (control) {
+      control.setAttribute("aria-pressed", collapsed ? "false" : "true");
+      var glyph = control.querySelector(".niceeval-trace-toolbar-glyph");
+      if (glyph) glyph.textContent = collapsed ? "⊟" : "⊞";
+    }
+  }
+
+  function toggleTraceDuration(trace, control) {
+    if (!trace || !control || control.disabled) return;
+    var timeline = trace.querySelector("[data-niceeval-trace-timeline]");
+    // Incomplete timing must remain equal-width sequence; never infer event clocks.
+    if (!timeline || timeline.getAttribute("data-timing-complete") !== "true") return;
+    var duration = trace.getAttribute("data-niceeval-duration-mode") === "duration";
+    trace.setAttribute("data-niceeval-duration-mode", duration ? "sequence" : "duration");
+    control.setAttribute("aria-pressed", duration ? "false" : "true");
+  }
+
+  function filterTurnTrace(input) {
+    var trace = traceByElement(input);
+    if (!trace) return;
+    var query = (input.value || "").trim().toLowerCase();
+    var events = trace.querySelectorAll("[data-niceeval-trace-event]");
+    for (var i = 0; i < events.length; i++) {
+      var event = events[i];
+      var match = query === "" || (event.textContent || "").toLowerCase().indexOf(query) !== -1;
+      event.classList.toggle("niceeval-row-hidden", !match);
+      event.setAttribute("data-search-match", match ? "true" : "false");
+      var id = event.getAttribute("data-niceeval-trace-event");
+      if (!id) continue;
+      var spans = traceElementsById(trace, "data-niceeval-trace-timeline-event", id);
+      for (var j = 0; j < spans.length; j++) spans[j].setAttribute("data-search-match", match ? "true" : "false");
+    }
+    var turns = trace.querySelectorAll("[data-niceeval-trace-turn]");
+    for (var k = 0; k < turns.length; k++) {
+      var rows = turns[k].querySelectorAll("[data-niceeval-trace-event]");
+      var hasMatch = false;
+      for (var m = 0; m < rows.length; m++) {
+        if (rows[m].getAttribute("data-search-match") === "true") {
+          hasMatch = true;
+          break;
+        }
+      }
+      turns[k].setAttribute("data-search-empty", hasMatch ? "false" : "true");
+      if (query !== "" && hasMatch) turns[k].setAttribute("data-search-active", "true");
+      else turns[k].removeAttribute("data-search-active");
+    }
+  }
+
+  document.addEventListener("click", function (e) {
+    var tab = closest(e.target, "[data-niceeval-trace-evidence-tab]");
+    if (tab) {
+      activateTurnTraceEvidenceTab(tab.closest("[data-niceeval-trace-evidence]"), tab.getAttribute("data-niceeval-trace-evidence-tab"));
+      return;
+    }
+    var duration = closest(e.target, "[data-niceeval-trace-duration]");
+    if (duration) {
+      toggleTraceDuration(traceByElement(duration), duration);
+      return;
+    }
+    var turns = closest(e.target, "[data-niceeval-trace-turns]");
+    if (turns) {
+      toggleAllTurns(traceByElement(turns));
+      return;
+    }
+    var calls = closest(e.target, "[data-niceeval-trace-calls]");
+    if (calls) {
+      toggleAllCalls(traceByElement(calls));
+      return;
+    }
+    var turnToggle = closest(e.target, "[data-niceeval-trace-turn-toggle]");
+    if (turnToggle) {
+      var turn = turnToggle.closest("[data-niceeval-trace-turn]");
+      setTurnCollapsed(turn, turn && turn.getAttribute("data-collapsed") !== "true");
+      return;
+    }
+    var recordSelect = closest(e.target, "[data-niceeval-trace-select]");
+    if (recordSelect) {
+      toggleTurnTraceEvidence(traceByElement(recordSelect), recordSelect.getAttribute("data-niceeval-trace-select"), false);
+      return;
+    }
+    var timelineSelect = closest(e.target, "[data-niceeval-trace-timeline-event]");
+    if (timelineSelect) {
+      toggleTurnTraceEvidence(traceByElement(timelineSelect), timelineSelect.getAttribute("data-niceeval-trace-timeline-event"), true);
+    }
+  });
+
+  document.addEventListener("input", function (e) {
+    var input = closest(e.target, "input[data-niceeval-trace-search]");
+    if (input) filterTurnTrace(input);
+  });
+
+  document.addEventListener("keydown", function (e) {
+    if (e.key !== "Escape") return;
+    var trace = traceByElement(e.target);
+    if (trace) closeTurnTraceEvidence(trace);
+  });
+
+  // ───────────────────────── tooltip:.niceeval-chart-dot ─────────────────────────
+  // 首次 hover 时把点内 <title> 的内容搬进 data-niceeval-title(避免与原生 tooltip 重影),
+  // 渲染样式化 tooltip div(定位在点上方,挂在所属 figure 里)。无 JS 时 <title> 原样生效。
+
+  var tooltip = null;
+
+  function hideTooltip() {
+    if (tooltip && tooltip.parentNode) tooltip.parentNode.removeChild(tooltip);
+    tooltip = null;
+  }
+
+  function tooltipText(point) {
+    var text = point.getAttribute("data-niceeval-title");
+    if (text === null) {
+      var title = point.querySelector("title");
+      text = title ? title.textContent : "";
+      if (title && title.parentNode) title.parentNode.removeChild(title);
+      point.setAttribute("data-niceeval-title", text);
+    }
+    return text;
+  }
+
+  document.addEventListener("mouseover", function (e) {
+    var point = closest(e.target, ".niceeval-chart-dot");
+    if (!point) return;
+    var text = tooltipText(point);
+    if (!text) return;
+    var figure = point.closest("figure") || document.body;
+    hideTooltip();
+    tooltip = document.createElement("div");
+    tooltip.className = "niceeval-tooltip";
+    var lines = text.split("\n");
+    for (var i = 0; i < lines.length; i++) {
+      var line = document.createElement(i === 0 ? "b" : "div");
+      if (i > 0) line.className = "niceeval-tooltip-meta";
+      line.textContent = lines[i];
+      tooltip.appendChild(line);
+    }
+    if (getComputedStyle(figure).position === "static") figure.style.position = "relative";
+    figure.appendChild(tooltip);
+    var pointBox = point.getBoundingClientRect();
+    var figureBox = figure.getBoundingClientRect();
+    tooltip.style.left = pointBox.left + pointBox.width / 2 - figureBox.left + "px";
+    tooltip.style.top = pointBox.top - figureBox.top + "px";
+  });
+
+  document.addEventListener("mouseout", function (e) {
+    var point = closest(e.target, ".niceeval-chart-dot");
+    if (!point) return;
+    // 移入 tooltip 自身不算离开(pointer-events: none 下 relatedTarget 不会是它,防御性判断)
+    if (e.relatedTarget && point.contains(e.relatedTarget)) return;
+    hideTooltip();
+  });
+})();

package/dist/report/assets/series-encoding.cjs

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.seriesColorVar = seriesColorVar;
+exports.seriesPatternId = seriesPatternId;
+exports.seriesFill = seriesFill;
+exports.seriesStrokeDasharray = seriesStrokeDasharray;
+exports.seriesMarkerShape = seriesMarkerShape;
+exports.seriesMarker = seriesMarker;
+exports.seriesClassesFromFill = seriesClassesFromFill;
+exports.seriesClassFromColorVar = seriesClassFromColorVar;
+exports.SeriesPatternDefs = SeriesPatternDefs;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/** 槽位色板下标 1..6 → CSS 变量,原样交给 fill / stroke / color。 */
+function seriesColorVar(colorIndex) {
+    if (!Number.isInteger(colorIndex) || colorIndex < 1 || colorIndex > 6) {
+        throw new Error(`colorIndex must be an integer in [1, 6], got ${colorIndex}.`);
+    }
+    return `var(--niceeval-color-series-${colorIndex})`;
+}
+/** SVG pattern id:niceeval-series-pat-v{2|3|4}-c{1..6}。variant 1 是实心,无 pattern。 */
+function seriesPatternId(colorIndex, variant) {
+    if (variant === 1) {
+        throw new Error("variant 1 is solid fill; it has no pattern id.");
+    }
+    return `niceeval-series-pat-v${variant}-c${colorIndex}`;
+}
+function seriesFill(colorIndex, variant) {
+    if (variant === 1)
+        return seriesColorVar(colorIndex);
+    return `url(#${seriesPatternId(colorIndex, variant)})`;
+}
+/** 线型变体 → strokeDasharray;variant 1 为空串(实线)。 */
+function seriesStrokeDasharray(variant) {
+    switch (variant) {
+        case 1:
+            return "";
+        case 2:
+            return "6 4";
+        case 3:
+            return "2 3";
+        case 4:
+            return "8 3 2 3";
+    }
+}
+/** 四种 marker 形状(viewBox 0 0 12 12),变体按 docs 槽序表 1–4。 */
+function seriesMarkerShape(variant) {
+    switch (variant) {
+        case 1:
+            // 圆
+            return { path: "M6 1.5a4.5 4.5 0 1 0 0.01 0z", viewBox: "0 0 12 12" };
+        case 2:
+            // 方
+            return { path: "M2.5 2.5h7v7h-7z", viewBox: "0 0 12 12" };
+        case 3:
+            // 菱
+            return { path: "M6 1.5 10.5 6 6 10.5 1.5 6z", viewBox: "0 0 12 12" };
+        case 4:
+            // 三角
+            return { path: "M6 1.5 10.5 10.5 1.5 10.5z", viewBox: "0 0 12 12" };
+    }
+}
+function seriesMarker(colorIndex, variant) {
+    const shape = seriesMarkerShape(variant);
+    const color = seriesColorVar(colorIndex);
+    return {
+        path: shape.path,
+        viewBox: shape.viewBox,
+        fill: color,
+        stroke: color,
+    };
+}
+/**
+ * 从 presentation.fill 反推 HTML 柱需要的系列 class。
+ * SVG 用 url(#pattern)/var();HTML 柱不能引用 SVG pattern,改挂 series-cN + fill-vN 类,
+ * 由 styles.css 用 repeating-linear-gradient 画等效图案,颜色仍走 --series 令牌。
+ */
+function seriesClassesFromFill(fill) {
+    const pattern = /^url\(#niceeval-series-pat-v([2-4])-c([1-6])\)$/.exec(fill);
+    if (pattern) {
+        const variant = pattern[1];
+        const colorIndex = Number(pattern[2]);
+        return `niceeval-series-c${colorIndex - 1} niceeval-series-fill-v${variant}`;
+    }
+    const solid = /^var\(--niceeval-color-series-([1-6])\)$/.exec(fill);
+    if (solid) {
+        return `niceeval-series-c${Number(solid[1]) - 1}`;
+    }
+    return "niceeval-series-none";
+}
+/** 从 color 呈现或 series 的 stroke/fill 反推 series-cN 类(图例色点回落)。 */
+function seriesClassFromColorVar(color) {
+    const solid = /^var\(--niceeval-color-series-([1-6])\)$/.exec(color);
+    if (solid)
+        return `niceeval-series-c${Number(solid[1]) - 1}`;
+    return "niceeval-series-none";
+}
+/**
+ * 页内注入一次的 SVG pattern defs。
+ * 18 个 pattern(3 非实心变体 × 6 色);id 与 seriesFill() 产出的 url(#…) 对齐。
+ * 子元素直接写 var(--niceeval-color-series-N),不走 currentColor
+ * (SVG pattern 内部 currentColor 取自 pattern 自身,引用者传不进来)。
+ */
+function SeriesPatternDefs() {
+    const patterns = [];
+    for (let colorIndex = 1; colorIndex <= 6; colorIndex++) {
+        const color = seriesColorVar(colorIndex);
+        // v2:对角斜线
+        patterns.push((0, jsx_runtime_1.jsxs)("pattern", { id: seriesPatternId(colorIndex, 2), patternUnits: "userSpaceOnUse", width: "6", height: "6", children: [(0, jsx_runtime_1.jsx)("rect", { width: "6", height: "6", fill: color, fillOpacity: 0.22 }), (0, jsx_runtime_1.jsx)("path", { d: "M-1 1l2-2M0 6l6-6M5 7l2-2", stroke: color, strokeWidth: 1.4, fill: "none" })] }, `v2-c${colorIndex}`));
+        // v3:水平条纹
+        patterns.push((0, jsx_runtime_1.jsxs)("pattern", { id: seriesPatternId(colorIndex, 3), patternUnits: "userSpaceOnUse", width: "6", height: "6", children: [(0, jsx_runtime_1.jsx)("rect", { width: "6", height: "6", fill: color, fillOpacity: 0.18 }), (0, jsx_runtime_1.jsx)("path", { d: "M0 1.5h6M0 4.5h6", stroke: color, strokeWidth: 1.5, fill: "none" })] }, `v3-c${colorIndex}`));
+        // v4:点阵
+        patterns.push((0, jsx_runtime_1.jsxs)("pattern", { id: seriesPatternId(colorIndex, 4), patternUnits: "userSpaceOnUse", width: "6", height: "6", children: [(0, jsx_runtime_1.jsx)("rect", { width: "6", height: "6", fill: color, fillOpacity: 0.16 }), (0, jsx_runtime_1.jsx)("circle", { cx: "2", cy: "2", r: "1.15", fill: color }), (0, jsx_runtime_1.jsx)("circle", { cx: "5", cy: "5", r: "1.15", fill: color })] }, `v4-c${colorIndex}`));
+    }
+    return ((0, jsx_runtime_1.jsx)("svg", { className: "niceeval-series-defs", width: 0, height: 0, "aria-hidden": "true", focusable: "false", style: { position: "absolute", width: 0, height: 0, overflow: "hidden" }, children: (0, jsx_runtime_1.jsx)("defs", { children: patterns }) }));
+}
+//# sourceMappingURL=series-encoding.cjs.map

package/dist/report/assets/series-encoding.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"series-encoding.js","sourceRoot":"","sources":["series-encoding.tsx"],"names":[],"mappings":"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","sourcesContent":["// 24 视觉身份 = 六色 × 四变体的可直接使用 SVG/CSS 值。\n// 契约:docs/feature/reports/library.md「实验颜色与维度呈现」、\n// docs/feature/reports/library.md「视觉编码容量（24 个身份）」。\n// pattern id 全局唯一、颜色走主题令牌 --niceeval-color-series-N,换 basalt/chalk 自动换色。\nimport type { ReactNode } from \"react\";\nimport type { SeriesVariant } from \"../presentation.ts\";\n/** 槽位色板下标 1..6 → CSS 变量,原样交给 fill / stroke / color。 */\nexport function seriesColorVar(colorIndex: number): string {\n    if (!Number.isInteger(colorIndex) || colorIndex < 1 || colorIndex > 6) {\n        throw new Error(`colorIndex must be an integer in [1, 6], got ${colorIndex}.`);\n    }\n    return `var(--niceeval-color-series-${colorIndex})`;\n}\n/** SVG pattern id:niceeval-series-pat-v{2|3|4}-c{1..6}。variant 1 是实心,无 pattern。 */\nexport function seriesPatternId(colorIndex: number, variant: SeriesVariant): string {\n    if (variant === 1) {\n        throw new Error(\"variant 1 is solid fill; it has no pattern id.\");\n    }\n    return `niceeval-series-pat-v${variant}-c${colorIndex}`;\n}\nexport function seriesFill(colorIndex: number, variant: SeriesVariant): string {\n    if (variant === 1)\n        return seriesColorVar(colorIndex);\n    return `url(#${seriesPatternId(colorIndex, variant)})`;\n}\n/** 线型变体 → strokeDasharray;variant 1 为空串(实线)。 */\nexport function seriesStrokeDasharray(variant: SeriesVariant): string {\n    switch (variant) {\n        case 1:\n            return \"\";\n        case 2:\n            return \"6 4\";\n        case 3:\n            return \"2 3\";\n        case 4:\n            return \"8 3 2 3\";\n    }\n}\nexport interface SeriesMarkerShape {\n    readonly path: string;\n    readonly viewBox: string;\n}\n/** 四种 marker 形状(viewBox 0 0 12 12),变体按 docs 槽序表 1–4。 */\nexport function seriesMarkerShape(variant: SeriesVariant): SeriesMarkerShape {\n    switch (variant) {\n        case 1:\n            // 圆\n            return { path: \"M6 1.5a4.5 4.5 0 1 0 0.01 0z\", viewBox: \"0 0 12 12\" };\n        case 2:\n            // 方\n            return { path: \"M2.5 2.5h7v7h-7z\", viewBox: \"0 0 12 12\" };\n        case 3:\n            // 菱\n            return { path: \"M6 1.5 10.5 6 6 10.5 1.5 6z\", viewBox: \"0 0 12 12\" };\n        case 4:\n            // 三角\n            return { path: \"M6 1.5 10.5 10.5 1.5 10.5z\", viewBox: \"0 0 12 12\" };\n    }\n}\nexport function seriesMarker(colorIndex: number, variant: SeriesVariant): {\n    readonly path: string;\n    readonly viewBox: string;\n    readonly fill: string;\n    readonly stroke: string;\n} {\n    const shape = seriesMarkerShape(variant);\n    const color = seriesColorVar(colorIndex);\n    return {\n        path: shape.path,\n        viewBox: shape.viewBox,\n        fill: color,\n        stroke: color,\n    };\n}\n/**\n * 从 presentation.fill 反推 HTML 柱需要的系列 class。\n * SVG 用 url(#pattern)/var();HTML 柱不能引用 SVG pattern,改挂 series-cN + fill-vN 类,\n * 由 styles.css 用 repeating-linear-gradient 画等效图案,颜色仍走 --series 令牌。\n */\nexport function seriesClassesFromFill(fill: string): string {\n    const pattern = /^url\\(#niceeval-series-pat-v([2-4])-c([1-6])\\)$/.exec(fill);\n    if (pattern) {\n        const variant = pattern[1]!;\n        const colorIndex = Number(pattern[2]);\n        return `niceeval-series-c${colorIndex - 1} niceeval-series-fill-v${variant}`;\n    }\n    const solid = /^var\\(--niceeval-color-series-([1-6])\\)$/.exec(fill);\n    if (solid) {\n        return `niceeval-series-c${Number(solid[1]) - 1}`;\n    }\n    return \"niceeval-series-none\";\n}\n/** 从 color 呈现或 series 的 stroke/fill 反推 series-cN 类(图例色点回落)。 */\nexport function seriesClassFromColorVar(color: string): string {\n    const solid = /^var\\(--niceeval-color-series-([1-6])\\)$/.exec(color);\n    if (solid)\n        return `niceeval-series-c${Number(solid[1]) - 1}`;\n    return \"niceeval-series-none\";\n}\n/**\n * 页内注入一次的 SVG pattern defs。\n * 18 个 pattern(3 非实心变体 × 6 色);id 与 seriesFill() 产出的 url(#…) 对齐。\n * 子元素直接写 var(--niceeval-color-series-N),不走 currentColor\n * (SVG pattern 内部 currentColor 取自 pattern 自身,引用者传不进来)。\n */\nexport function SeriesPatternDefs(): ReactNode {\n    const patterns: ReactNode[] = [];\n    for (let colorIndex = 1; colorIndex <= 6; colorIndex++) {\n        const color = seriesColorVar(colorIndex);\n        // v2:对角斜线\n        patterns.push(<pattern key={`v2-c${colorIndex}`} id={seriesPatternId(colorIndex, 2)} patternUnits=\"userSpaceOnUse\" width=\"6\" height=\"6\">\n        <rect width=\"6\" height=\"6\" fill={color} fillOpacity={0.22}/>\n        <path d=\"M-1 1l2-2M0 6l6-6M5 7l2-2\" stroke={color} strokeWidth={1.4} fill=\"none\"/>\n      </pattern>);\n        // v3:水平条纹\n        patterns.push(<pattern key={`v3-c${colorIndex}`} id={seriesPatternId(colorIndex, 3)} patternUnits=\"userSpaceOnUse\" width=\"6\" height=\"6\">\n        <rect width=\"6\" height=\"6\" fill={color} fillOpacity={0.18}/>\n        <path d=\"M0 1.5h6M0 4.5h6\" stroke={color} strokeWidth={1.5} fill=\"none\"/>\n      </pattern>);\n        // v4:点阵\n        patterns.push(<pattern key={`v4-c${colorIndex}`} id={seriesPatternId(colorIndex, 4)} patternUnits=\"userSpaceOnUse\" width=\"6\" height=\"6\">\n        <rect width=\"6\" height=\"6\" fill={color} fillOpacity={0.16}/>\n        <circle cx=\"2\" cy=\"2\" r=\"1.15\" fill={color}/>\n        <circle cx=\"5\" cy=\"5\" r=\"1.15\" fill={color}/>\n      </pattern>);\n    }\n    return (<svg className=\"niceeval-series-defs\" width={0} height={0} aria-hidden=\"true\" focusable=\"false\" style={{ position: \"absolute\", width: 0, height: 0, overflow: \"hidden\" }}>\n      <defs>{patterns}</defs>\n    </svg>);\n}\n"]}

package/dist/report/assets/series-encoding.d.cts

@@ -0,0 +1,36 @@
+import type { ReactNode } from "react";
+import type { SeriesVariant } from "../presentation.cjs";
+/** 槽位色板下标 1..6 → CSS 变量,原样交给 fill / stroke / color。 */
+export declare function seriesColorVar(colorIndex: number): string;
+/** SVG pattern id:niceeval-series-pat-v{2|3|4}-c{1..6}。variant 1 是实心,无 pattern。 */
+export declare function seriesPatternId(colorIndex: number, variant: SeriesVariant): string;
+export declare function seriesFill(colorIndex: number, variant: SeriesVariant): string;
+/** 线型变体 → strokeDasharray;variant 1 为空串(实线)。 */
+export declare function seriesStrokeDasharray(variant: SeriesVariant): string;
+export interface SeriesMarkerShape {
+    readonly path: string;
+    readonly viewBox: string;
+}
+/** 四种 marker 形状(viewBox 0 0 12 12),变体按 docs 槽序表 1–4。 */
+export declare function seriesMarkerShape(variant: SeriesVariant): SeriesMarkerShape;
+export declare function seriesMarker(colorIndex: number, variant: SeriesVariant): {
+    readonly path: string;
+    readonly viewBox: string;
+    readonly fill: string;
+    readonly stroke: string;
+};
+/**
+ * 从 presentation.fill 反推 HTML 柱需要的系列 class。
+ * SVG 用 url(#pattern)/var();HTML 柱不能引用 SVG pattern,改挂 series-cN + fill-vN 类,
+ * 由 styles.css 用 repeating-linear-gradient 画等效图案,颜色仍走 --series 令牌。
+ */
+export declare function seriesClassesFromFill(fill: string): string;
+/** 从 color 呈现或 series 的 stroke/fill 反推 series-cN 类(图例色点回落)。 */
+export declare function seriesClassFromColorVar(color: string): string;
+/**
+ * 页内注入一次的 SVG pattern defs。
+ * 18 个 pattern(3 非实心变体 × 6 色);id 与 seriesFill() 产出的 url(#…) 对齐。
+ * 子元素直接写 var(--niceeval-color-series-N),不走 currentColor
+ * (SVG pattern 内部 currentColor 取自 pattern 自身,引用者传不进来)。
+ */
+export declare function SeriesPatternDefs(): ReactNode;