@agile-team/mach-report 2.4.1 → 2.6.1

package/dist/analytics.d.ts

@@ -0,0 +1,276 @@
+/**
+ * 列值格式化（声明式、JSON 可序列化）。
+ * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
+ * 三后端（DOM/Canvas/PDF）零改动。
+ *
+ * 语义约定（v0.9 固化）：
+ * - number.digits 显式给出 → 精确保留（12.5 + digits:2 → "12.50"）
+ * - number.thousands 默认 false（千分位显式开启）
+ * - date 字符串按"本地时区的日历日"解析（YYYY-MM-DD / YYYY/MM/DD 直取年月日，
+ *   不经 Date 字符串构造——后者按 UTC 零点，负时区环境会少一天）
+ */
+declare type ColumnFormat = {
+    kind: "number";
+    thousands?: boolean;
+    digits?: number;
+} | {
+    kind: "percent";
+    digits?: number;
+} | {
+    kind: "date";
+    pattern?: string;
+};
+
+declare type ComponentKind = "text" | "image" | "barcode" | "qrcode" | "chart" | "line" | "rect" | "ellipse";
+
+declare interface ComponentStyle {
+    fontSizePx?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    color?: string;
+    backgroundColor?: string;
+    align?: "left" | "center" | "right" | "justify";
+    verticalAlign?: "top" | "middle" | "bottom";
+    lineColor?: string;
+    borderColor?: string;
+    lineWidthPt?: number;
+    borderTop?: boolean;
+    borderRight?: boolean;
+    borderBottom?: boolean;
+    borderLeft?: boolean;
+    lineHeight?: number;
+    letterSpacing?: number;
+    opacity?: number;
+    rotateDeg?: number;
+}
+
+export declare interface ComputationIssue {
+    rowIndex: number;
+    field: string;
+    message: string;
+}
+
+/** 纯数据计算与界面解耦；字段按声明顺序计算，可供后续字段引用，不修改输入数据。 */
+export declare function computeDataset(input: readonly Record<string, unknown>[], options: ComputedDatasetOptions): {
+    rows: Record<string, unknown>[];
+    issues: ComputationIssue[];
+};
+
+export declare interface ComputedDatasetOptions {
+    fields: readonly ComputedField[];
+    formula?: FormulaAdapter;
+    maxRows?: number;
+    /** Calculated cells (rows × fields), default 2 million; at most 2048 field definitions. */
+    maxCells?: number;
+    signal?: AbortSignal;
+    onError?: "throw" | "null";
+}
+
+export declare interface ComputedField {
+    field: string;
+    expression: ReportExpression | string;
+}
+
+/** 轻量柱/折线图展开为共用基础图元，无外部图表依赖，DOM/Canvas/PDF 使用同一计划。 */
+export declare function createChartComponents(options: ReportChartOptions): PlanComponent[];
+
+/** 通用交叉聚合；合计直接累计原始度量，平均值不会错误地平均各分组合计。 */
+export declare function createCrossTable(input: readonly Record<string, unknown>[], options: CrossTableOptions): CrossTableResult;
+
+export declare interface CrossTableOptions {
+    rowField: string;
+    columnField: string;
+    valueField?: string;
+    aggregate?: "sum" | "count" | "avg" | "min" | "max";
+    totals?: boolean;
+    rowHeader?: string;
+    maxRows?: number;
+    maxColumns?: number;
+    maxInputRows?: number;
+    /** Dense output cells, including the dimension column and optional totals; default 2 million. */
+    maxCells?: number;
+}
+
+export declare interface CrossTableResult {
+    columns: TableTemplateColumn[];
+    rows: Record<string, unknown>[];
+}
+
+export declare interface FormulaAdapter {
+    /** 显式注入受信任的公式引擎；核心不执行 eval、宏或外部工作簿引用。 */
+    evaluate(expression: string, context: {
+        row: Readonly<Record<string, unknown>>;
+        rowIndex: number;
+    }): unknown;
+}
+
+declare interface GridCell {
+    text?: string;
+    rawText?: string;
+    /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
+    value?: string | number | boolean | null;
+    /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
+    numberFormat?: string;
+    /** 编辑输入类型；省略时只按原始值推断，数字字符串不会被转换为数值。 */
+    valueType?: "text" | "number" | "boolean";
+    /** 单元格级编辑控制；预览仍需显式开启 editing。 */
+    editable?: boolean;
+    source?: ReportCellSource;
+    /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
+    formula?: string;
+    children?: PlanComponent[];
+    colSpan?: number;
+    rowSpan?: number;
+    style?: ComponentStyle;
+}
+
+/** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
+declare type ListAlignment = NonNullable<ComponentStyle["align"]> | "auto";
+
+declare interface ListColumn {
+    header: string;
+    field: string;
+    widthMm: number;
+    style?: ComponentStyle;
+    /** 内容对齐，优先于 style.align；数值字符串不会自动判为数字。 */
+    align?: ListAlignment;
+    /** 独立的表头对齐，不改变内容对齐。 */
+    headerAlign?: ComponentStyle["align"];
+    /** 独立的表头样式，优先于列表级表头样式。 */
+    headerStyle?: ComponentStyle;
+    /** 值格式化（声明式）：千分位/小数位、百分比、日期 pattern */
+    format?: ColumnFormat;
+    /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
+    rules?: StyleRule[];
+    /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
+    editable?: boolean;
+    /** 空值列或特殊数据类型可显式声明编辑输入类型。 */
+    valueType?: GridCell["valueType"];
+    /** 字段语义用于 auto 对齐；明确声明编号，避免把数字编号当成度量。 */
+    semanticRole?: "identifier" | "dimension" | "measure" | "date" | "text";
+}
+
+declare interface PlanComponent {
+    kind: ComponentKind;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    nid?: string;
+    rkey?: string;
+    text?: string;
+    rawText?: string;
+    lines?: string[];
+    richParagraphs?: RichParagraph[];
+    imageData?: string;
+    /** 明确指定线段方向；省略保持历史水平线行为。 */
+    lineDirection?: "down" | "up";
+    grid?: PlanGrid;
+    table?: PlanTableFragment;
+    style?: ComponentStyle;
+    meta?: Record<string, unknown>;
+    /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
+    fallbackText?: string;
+}
+
+declare interface PlanGrid {
+    /** 行内允许 null 空位；渲染器按空单元格处理 */
+    cells: (GridCell | null)[][];
+    colWidthsMm?: number[];
+    rowHeightsMm?: number[];
+    gapMm?: number;
+    /** 单元格四边内距；旧静态网格默认 0.5mm，分页列表使用其真实测量内距。 */
+    paddingMm?: number;
+}
+
+/** 列表的逻辑行来源；用于连续 Excel 重组，避免按文本猜测重复表头。 */
+declare interface PlanTableFragment {
+    /** 在整个计划中唯一的逻辑表身份；同一表的分页片段共享身份。 */
+    id: string;
+    /** 表头固定 -1；其余行（包括组头/小计/总计）从 0 连续递增。 */
+    rowIndex: number;
+    role: "header" | "body" | "group-header" | "subtotal" | "grand-total";
+    /** 按物理列顺序保存字段身份；不以表头显示文本判断列结构。 */
+    columnKeys: string[];
+    layout?: "page" | "wide";
+    title?: string;
+    /** 只有宿主声明稳定 rowKey 时生成，不能用显示顺序替代业务主键。 */
+    source?: Omit<ReportCellSource, "field" | "rowKey"> & {
+        rowKey?: string | number;
+    };
+}
+
+/** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
+declare interface ReportCellSource {
+    datasetId: string;
+    rowKey: string | number;
+    field: string;
+    revision?: string | number;
+    sourceToken?: string;
+}
+
+export declare interface ReportChartOptions {
+    type: "bar" | "line";
+    categories: readonly string[];
+    series: readonly ReportChartSeries[];
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    title?: string;
+    showValues?: boolean;
+}
+
+export declare interface ReportChartSeries {
+    name: string;
+    values: readonly (number | null)[];
+    color?: string;
+}
+
+export declare type ReportExpression = {
+    field: string;
+} | {
+    value: string | number | boolean | null;
+} | {
+    op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
+    args: readonly ReportExpression[];
+};
+
+declare interface RichParagraph {
+    segments: RichSegment[];
+    align?: ComponentStyle["align"];
+    lineHeight?: number;
+    spaceBeforeMm?: number;
+    spaceAfterMm?: number;
+    indentMm?: number;
+}
+
+declare interface RichSegment {
+    kind?: "text" | "field";
+    text?: string;
+    field?: string;
+    style?: ComponentStyle;
+}
+
+/** 条件格式规则求值（声明式，见 ListColumn.rules） */
+declare interface StyleRule {
+    when: {
+        field: string;
+        op: ">" | ">=" | "<" | "<=" | "==" | "!=";
+        value: number | string;
+    };
+    /** 命中时合并进单元格样式（color/bold/backgroundColor 等） */
+    style: Record<string, unknown>;
+}
+
+/** 明细列：显式 widthMm 优先；纸张模式按 flex 分余量，宽表模式按 flex 放大基准列宽。 */
+declare type TableTemplateColumn = Omit<ListColumn, "widthMm"> & {
+    widthMm?: number;
+    /** 自动列的宽度权重，默认 1（有 widthMm 时不参与分配）。 */
+    flex?: number;
+};
+
+export { }

package/dist/analytics.js

@@ -0,0 +1,223 @@
+const E = ["#2563eb", "#0d9488", "#d97706", "#7c3aed", "#dc2626", "#0284c7"];
+function $(e) {
+  if (e.type !== "bar" && e.type !== "line") throw new Error("图表 type 应为 bar 或 line");
+  if (!Array.isArray(e.categories) || !Array.isArray(e.series) || !e.categories.length || e.categories.length > 200 || !e.series.length || e.series.length > 12) throw new Error("图表支持 1–200 个分类、1–12 个系列；大数据应先聚合");
+  if (e.categories.some((r) => typeof r != "string")) throw new Error("图表分类应为字符串");
+  z(e);
+  for (const r of e.series) L(r, e.categories.length);
+}
+function z(e) {
+  for (const r of ["leftMm", "topMm", "widthMm", "heightMm"])
+    if (!Number.isFinite(e[r]) || e[r] < 0) throw new Error(`${r} 应为有限非负数`);
+  if (e.widthMm < 45 || e.heightMm < 35) throw new Error("图表至少需要 45×35mm");
+  if (!Number.isFinite(e.leftMm + e.widthMm) || !Number.isFinite(e.topMm + e.heightMm)) throw new Error("图表几何范围溢出");
+}
+function L(e, r) {
+  if (!e || typeof e.name != "string" || !Array.isArray(e.values) || e.values.length !== r || e.values.some((t) => t !== null && !Number.isFinite(t))) throw new Error("图表系列应提供名称及逐分类的有限数字或 null");
+  if (e.color !== void 0 && !/^#[\da-f]{6}$/i.test(e.color)) throw new Error("图表颜色应为 #RRGGBB");
+}
+function F(e, r, t, n, i, l = 0.8) {
+  return { kind: "line", leftMm: Math.min(e, t), topMm: Math.min(r, n), widthMm: Math.abs(t - e), heightMm: Math.abs(n - r), lineDirection: n < r ? "up" : "down", style: { lineColor: i, lineWidthPt: l } };
+}
+function d(e, r, t, n, i = "center") {
+  return { kind: "text", text: e, leftMm: r, topMm: t, widthMm: n, heightMm: 5, style: { fontSize: 8, color: "#475569", align: i, verticalAlign: "middle" } };
+}
+function S(e) {
+  return Number(e.toPrecision(5)).toString();
+}
+function j(e) {
+  let r = 0, t = 0;
+  for (const h of e.series) for (const a of h.values) a !== null && (r = Math.min(r, a), t = Math.max(t, a));
+  r === t && (t = r + 1);
+  const n = e.leftMm + 13, i = e.topMm + 8, l = e.widthMm - 17, c = e.heightMm - 23, f = Math.max(Math.abs(r), Math.abs(t), 1), o = r / f, u = t / f - o;
+  return { left: n, top: i, width: l, height: c, min: r, max: t, y: (h) => i + c * (1 - (h / f - o) / u) };
+}
+function x(e, r) {
+  const t = [];
+  e.title && t.push({ ...d(e.title, e.leftMm, e.topMm, e.widthMm), style: { fontSize: 10, bold: !0, align: "left" } });
+  for (let l = 0; l <= 4; l++) {
+    const c = l / 4, f = r.min * (1 - c) + r.max * c, o = r.y(f);
+    t.push(F(r.left, o, r.left + r.width, o, "#e2e8f0", 0.4), d(S(f), e.leftMm, o - 2.5, 11, "right"));
+  }
+  t.push(F(r.left, r.top, r.left, r.top + r.height, "#94a3b8"));
+  const n = Math.max(1, Math.ceil(e.categories.length / Math.max(1, Math.floor(r.width / 14))));
+  e.categories.forEach((l, c) => {
+    c % n === 0 && t.push(d(l, r.left + (c + 0.5) * r.width / e.categories.length - 7, r.top + r.height + 1, 14));
+  });
+  const i = r.width / e.series.length;
+  return e.series.forEach((l, c) => {
+    t.push({ ...d(l.name, r.left + c * i, e.topMm + e.heightMm - 5, i), style: { fontSize: 8, color: l.color ?? E[c % E.length], align: "center" } });
+  }), t;
+}
+function P(e, r, t, n) {
+  const i = [], l = t.color ?? E[n % E.length], c = r.width / e.categories.length, f = c * 0.75 / e.series.length;
+  let o;
+  return t.values.forEach((u, h) => {
+    if (u === null) {
+      o = void 0;
+      return;
+    }
+    const a = r.left + (h + 0.5) * c, m = r.y(u);
+    e.type === "bar" ? i.push({ kind: "rect", leftMm: r.left + h * c + c * 0.125 + n * f, topMm: Math.min(m, r.y(0)), widthMm: f, heightMm: Math.abs(r.y(0) - m), style: { backgroundColor: l, borderTop: !1, borderRight: !1, borderBottom: !1, borderLeft: !1 } }) : (o && i.push(F(o.x, o.y, a, m, l, 1.2)), i.push({ kind: "ellipse", leftMm: a - 0.7, topMm: m - 0.7, widthMm: 1.4, heightMm: 1.4, style: { backgroundColor: l, borderColor: l } }), o = { x: a, y: m }), e.showValues && i.push({ ...d(S(u), a - c / 2, Math.max(r.top, m - 5), c), style: { fontSize: 7, color: l, align: "center" } });
+  }), i;
+}
+function U(e) {
+  $(e);
+  const r = j(e);
+  return [...x(e, r), ...e.series.flatMap((t, n) => P(e, r, t, n))];
+}
+function y() {
+  return { count: 0, sum: 0, correction: 0, min: 1 / 0, max: -1 / 0 };
+}
+function w(e, r) {
+  return Object.prototype.hasOwnProperty.call(e, r) ? e[r] : void 0;
+}
+function A(e) {
+  if (e == null) return "null";
+  if (typeof e != "string" && typeof e != "boolean" && !(typeof e == "number" && Number.isFinite(e))) throw new Error("交叉表维度应为字符串、布尔、有限数字或空值");
+  return JSON.stringify([typeof e, e]);
+}
+function N(e) {
+  return e == null ? "" : String(e);
+}
+function W(e, r, t) {
+  const n = t === "count";
+  if (!n && r == null) return;
+  if (!n && (typeof r != "number" || !Number.isFinite(r))) throw new Error("交叉表度量必须是有限数字；编号和小数文本不能隐式转为数字");
+  const i = n ? 1 : r;
+  (t === "sum" || t === "avg") && _(e, i), e.count++, e.min = Math.min(e.min, i), e.max = Math.max(e.max, i);
+}
+function _(e, r) {
+  const t = r - e.correction, n = e.sum + t;
+  if (!Number.isFinite(n)) throw new Error("交叉表聚合溢出");
+  e.correction = n - e.sum - t, e.sum = n;
+}
+function b(e, r) {
+  return e?.count ? r === "count" ? e.count : r === "avg" ? e.sum / e.count : r === "sum" ? e.sum : e[r] : r === "count" ? 0 : null;
+}
+function M(e, r) {
+  const t = e ?? r;
+  if (!Number.isInteger(t) || t < 1) throw new Error("交叉表预算应为正整数");
+  return t;
+}
+function B(e, r, t, n) {
+  const i = t ? 1 : 0;
+  if ((e + i) * (r + 1 + i) > n) throw new Error("交叉表输出单元格超出 maxCells 预算，请减少维度或服务端预聚合");
+}
+function V(e, r) {
+  const t = r.aggregate ?? "sum";
+  if (!["sum", "count", "avg", "min", "max"].includes(t)) throw new Error("未知交叉表聚合类型");
+  if (!r.rowField || !r.columnField || t !== "count" && !r.valueField) throw new Error("交叉表需要明确的行维度、列维度和度量字段");
+  if (e.length > M(r.maxInputRows, 1e5)) throw new Error("交叉表输入超出预算，请在服务端预聚合");
+  const n = M(r.maxRows, 1e3), i = M(r.maxColumns, 200), l = M(r.maxCells, 2e6), c = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), u = y();
+  for (const a of e) {
+    const m = A(w(a, r.rowField)), s = A(w(a, r.columnField));
+    if (c.has(s) || c.set(s, N(w(a, r.columnField))), f.has(m) || f.set(m, { label: N(w(a, r.rowField)), cells: /* @__PURE__ */ new Map(), total: y() }), c.size > i || f.size > n) throw new Error("交叉表维度数量超出预算");
+    B(f.size, c.size, r.totals, l);
+    const g = f.get(m);
+    g.cells.has(s) || g.cells.set(s, y()), o.has(s) || o.set(s, y());
+    const k = r.valueField ? w(a, r.valueField) : void 0;
+    for (const R of [g.cells.get(s), g.total, o.get(s), u]) W(R, k, t);
+  }
+  const h = {
+    columns: [{ header: r.rowHeader ?? r.rowField, field: "rowLabel", semanticRole: "dimension" }, ...[...c.values()].map((a, m) => ({ header: a, field: `c${m}`, semanticRole: "measure" }))],
+    rows: [...f.values()].map((a) => ({ rowLabel: a.label, ...Object.fromEntries([...c.keys()].map((m, s) => [`c${s}`, b(a.cells.get(m), t)])), ...r.totals ? { total: b(a.total, t) } : {} }))
+  };
+  return r.totals && (h.columns.push({ header: "合计", field: "total", semanticRole: "measure" }), e.length && h.rows.push({ rowLabel: "合计", ...Object.fromEntries([...c.keys()].map((a, m) => [`c${m}`, b(o.get(a), t)])), total: b(u, t) })), h;
+}
+const G = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
+function C(e) {
+  if (typeof e != "string" || !e.trim() || G.has(e)) throw new Error("计算字段应为安全的非空字段名");
+}
+function v(e) {
+  return e === null || ["string", "boolean"].includes(typeof e) || typeof e == "number" && Number.isFinite(e);
+}
+function I(e) {
+  if (e.some((r) => typeof r != "number" || !Number.isFinite(r))) throw new Error("算术参数必须是有限数字；空值和小数文本不会隐式转换");
+  return e;
+}
+function J(e, r) {
+  const t = I(r);
+  let n;
+  if (e === "add") n = t.reduce((i, l) => i + l, 0);
+  else if (e === "multiply") n = t.reduce((i, l) => i * l, 1);
+  else if (e === "subtract") n = t[0] - t[1];
+  else {
+    if (t[1] === 0) throw new Error("不能除以零");
+    n = t[0] / t[1];
+  }
+  if (!Number.isFinite(n)) throw new Error("计算结果不是有限数字");
+  return n;
+}
+function O(e, r, t = 0) {
+  if (++r.nodes > 256 || t > 16) throw new Error("计算表达式超出深度或节点预算");
+  if (!e || typeof e != "object" || Array.isArray(e)) throw new Error("计算表达式应为声明式对象");
+  if ("field" in e) {
+    C(e.field);
+    const i = e.field;
+    return (l) => Object.prototype.hasOwnProperty.call(l, i) ? l[i] : void 0;
+  }
+  if ("value" in e) {
+    if (!v(e.value)) throw new Error("常量应为有限 JSON 标量");
+    return () => e.value;
+  }
+  if (!["add", "subtract", "multiply", "divide", "coalesce"].includes(e.op) || !Array.isArray(e.args)) throw new Error("未知计算操作");
+  if (e.args.length < 2 || ["subtract", "divide"].includes(e.op) && e.args.length !== 2) throw new Error("运算参数数量不正确");
+  const n = e.args.map((i) => O(i, r, t + 1));
+  return e.op === "coalesce" ? (i, l) => T(n, i, l) : (i, l) => J(e.op, n.map((c) => c(i, l)));
+}
+function T(e, r, t) {
+  for (const n of e) {
+    const i = n(r, t);
+    if (i != null) return i;
+  }
+  return null;
+}
+function D(e) {
+  const r = /* @__PURE__ */ new Set();
+  return e.fields.map((t) => {
+    if (C(t.field), r.has(t.field)) throw new Error(`计算字段重复：${t.field}`);
+    r.add(t.field);
+    const n = t.expression;
+    let i;
+    if (typeof n == "string") {
+      if (!e.formula) throw new Error("字符串公式需要显式配置 formula adapter");
+      i = (l, c) => e.formula.evaluate(n, { row: l, rowIndex: c });
+    } else i = O(n, { nodes: 0 });
+    return { field: t.field, read: i };
+  });
+}
+function H(e, r) {
+  const t = r.maxRows ?? 1e5, n = r.maxCells ?? 2e6;
+  if (!Array.isArray(e) || !Number.isSafeInteger(t) || t < 1 || e.length > t) throw new Error("计算数据行数超出预算或输入不是数组");
+  if (!Array.isArray(r.fields) || r.fields.length > 2048) throw new Error("计算字段应为数组且最多2048项");
+  if (!Number.isSafeInteger(n) || n < 1 || e.length * r.fields.length > n) throw new Error("计算单元格超出 maxCells 预算");
+}
+function q(e, r) {
+  H(e, r);
+  const t = D(r), n = [];
+  return { rows: e.map((l, c) => {
+    if (!l || typeof l != "object" || Array.isArray(l)) throw new Error(`第 ${c + 1} 行应为对象`);
+    if (r.signal?.aborted) {
+      const o = new Error("数据计算已取消");
+      throw o.name = "AbortError", o;
+    }
+    const f = { ...l };
+    for (const o of t)
+      try {
+        const u = o.read(f, c);
+        if (u !== void 0 && !v(u)) throw new Error("计算结果应为有限 JSON 标量，异步公式请先在数据源中求值");
+        f[o.field] = u ?? null;
+      } catch (u) {
+        const h = u instanceof Error ? u.message : String(u);
+        if (r.onError !== "null") throw Object.assign(new Error(`第 ${c + 1} 行 ${o.field}：${h}`), { cause: u });
+        f[o.field] = null, n.push({ rowIndex: c, field: o.field, message: h });
+      }
+    return f;
+  }), issues: n };
+}
+export {
+  q as computeDataset,
+  U as createChartComponents,
+  V as createCrossTable
+};

package/dist/assets-66UBlhES.cjs

@@ -0,0 +1 @@
+"use strict";const h=require("./style-CpwiOPyB.cjs"),I=["borderTop","borderRight","borderBottom","borderLeft","borderColor","lineColor","lineWidthPt"];function M(t,e){const r=h.resolveBoxBorders(e.style),n=r.inner?[...t.edges]:[];r.top&&n.push({kind:"h",pos:0,from:0,to:e.widthMm}),r.bottom&&n.push({kind:"h",pos:e.heightMm,from:0,to:e.widthMm}),r.left&&n.push({kind:"v",pos:0,from:0,to:e.heightMm}),r.right&&n.push({kind:"v",pos:e.widthMm,from:0,to:e.heightMm});const o=h.resolveStroke(e.style);return n.map(s=>({...s,...o}))}function k(t,e,r){const n=t.get(e);(!n||r.widthPt>n.widthPt)&&t.set(e,r)}function w(t,e,r,n,o,s){const i=r<e.rows.length?e.rows[r].pos:e.rows[e.rows.length-1].pos+e.rows[e.rows.length-1].size;for(let c=n;c<o;c++){const d=e.columns[c];k(t,`h:${r}:${c}`,{kind:"h",pos:i,from:d.pos,to:d.pos+d.size,...s})}}function b(t,e,r,n,o,s){const i=r<e.columns.length?e.columns[r].pos:e.columns[e.columns.length-1].pos+e.columns[e.columns.length-1].size;for(let c=n;c<o;c++){const d=e.rows[c];k(t,`v:${r}:${c}`,{kind:"v",pos:i,from:d.pos,to:d.pos+d.size,...s})}}function v(t,e,r,n){const o=Math.min(e.columns.length,r.ci+(r.cell.colSpan??1)),s=Math.min(e.rows.length,r.ri+(r.cell.rowSpan??1)),i=h.mergeComponentStyles(n,r.cell.style),c=h.resolveBoxBorders(i),d=h.resolveStroke(i);c.top&&w(t,e,r.ri,r.ci,o,d),c.bottom&&w(t,e,s,r.ci,o,d),c.left&&b(t,e,r.ci,r.ri,s,d),c.right&&b(t,e,o,r.ri,s,d)}function A(t){const e=[...t.values()].sort((n,o)=>n.kind.localeCompare(o.kind)||n.pos-o.pos||n.from-o.from),r=[];for(const n of e){const o=r[r.length-1];o&&o.kind===n.kind&&o.pos===n.pos&&Math.abs(o.to-n.from)<1e-6&&o.color===n.color&&o.widthPt===n.widthPt?o.to=n.to:r.push({...n})}return r}function S(t,e){if(!t.cells.some(({cell:s})=>I.some(i=>s.style?.[i]!==void 0)))return M(t,e);const r=new Map,n=new Set,o=t.columns.length;for(const s of t.cells){v(r,t,s,e.style);const i=Math.min(t.rows.length,s.ri+(s.cell.rowSpan??1)),c=Math.min(o,s.ci+(s.cell.colSpan??1));for(let d=s.ri;d<i;d++)for(let a=s.ci;a<c;a++)n.add(d*o+a)}for(let s=0;s<t.rows.length;s++)for(let i=0;i<o;i++)n.has(s*o+i)||v(r,t,{ri:s,ci:i,cell:{}},e.style);return A(r)}class f extends Error{constructor(e,r){super(e.message),this.name="OutputAssetError",this.diagnostic=e,this.cause=r}}function p(t){if(t.aborted)throw t.reason??new DOMException("The operation was aborted.","AbortError")}function P(t,e){return p(e),new Promise((r,n)=>{const o=()=>n(e.reason??new DOMException("The operation was aborted.","AbortError"));e.addEventListener("abort",o,{once:!0}),Promise.resolve(t).then(r,n).finally(()=>e.removeEventListener("abort",o))})}function y(t){const e={maxAssets:1e3,maxImageBytes:33554432,maxTotalImageBytes:134217728,maxDurationMs:3e4,...t.assetBudget};for(const[r,n]of Object.entries(e))if(!Number.isSafeInteger(n)||n<=0||n>2147483647)throw new RangeError(`${r} must be a positive safe integer at most 2147483647.`);return e}function B(t){const e=/^data:image\/[a-z0-9.+-]+(;base64)?,(.*)$/is.exec(t);if(!e)throw new TypeError("Asset renderers must return an image data URL.");return e[1]?Math.ceil(e[2].length*3/4):new TextEncoder().encode(decodeURIComponent(e[2])).byteLength}function u(t,e,r,n,o){const s={code:r,message:n,severity:"warning",format:t.options.format??"dom",pageIndex:e.pageIndex,componentIndex:e.componentIndex,componentPath:e.componentPath,kind:e.component.kind,nid:e.component.nid};if(t.diagnostics.push(s),t.options.onDiagnostic?.(s),t.options.assetFailure!=="placeholder")throw new f(s,o)}async function D(t,e,r){const n=t.options.assetRenderers?.[e.kind];if(e.imageData||!n)return e.imageData;if(++t.rendered>t.budget.maxAssets)return u(t,r,"asset-budget-exceeded","Output exceeded the asset count budget.");let o;try{if(t.active=r,o=await P(n({...r,signal:t.signal}),t.signal),p(t.signal),o.length>t.budget.maxImageBytes*4+1024)return u(t,r,"asset-budget-exceeded","Output exceeded the image payload byte budget.");const s=B(o);if(s>t.budget.maxImageBytes||t.bytes+s>t.budget.maxTotalImageBytes)return u(t,r,"asset-budget-exceeded","Output exceeded the encoded image byte budget.");t.bytes+=s}catch(s){if(t.signal.aborted||s instanceof f)throw s;return u(t,r,"asset-render-failed",`Asset renderer failed for ${e.kind}; output was not silently omitted.`,s)}return o}function O(t,e){const r=t.active;if(!r){e.abort(new Error("Asset rendering exceeded maxDurationMs."));return}const n={code:"asset-budget-exceeded",message:"Asset rendering exceeded maxDurationMs.",severity:"warning",format:t.options.format??"dom",pageIndex:r.pageIndex,componentIndex:r.componentIndex,componentPath:r.componentPath,kind:r.component.kind,nid:r.component.nid};t.diagnostics.push(n);try{t.options.onDiagnostic?.(n)}catch(o){e.abort(o);return}e.abort(new f(n))}async function T(t,e,r,n,o){if(!e?.children?.length)return e;const s=[];for(const[i,c]of e.children.entries())s.push(await x(t,c,{...r,component:c,componentPath:[...n,i]},o));return s.some((i,c)=>i!==e.children[c])?{...e,children:s}:e}async function x(t,e,r,n){if(p(t.signal),n.has(e))throw new TypeError("Cyclic grid children cannot be rendered.");let o=t.cache.get(e);o||(o=D(t,e,r),t.cache.set(e,o));const s=await o;let i=e.grid;if(i){const c=new Set(n).add(e),d=[];for(const[a,m]of i.cells.entries()){const g=[];for(const[l,E]of m.entries())g.push(await T(t,E,r,[...r.componentPath,a,l],c));d.push(g)}d.some((a,m)=>a.some((g,l)=>g!==i.cells[m][l]))&&(i={...i,cells:d})}return s!==e.imageData||i!==e.grid?{...e,imageData:s,grid:i}:e}async function C(t,e={}){const r=y(e);if(e.signal?.aborted)throw e.signal.reason??new DOMException("The operation was aborted.","AbortError");const n=new AbortController,o=()=>n.abort(e.signal?.reason);if(e.signal?.addEventListener("abort",o,{once:!0}),!e.assetRenderers||!Object.keys(e.assetRenderers).length)return e.signal?.removeEventListener("abort",o),{plan:t,diagnostics:[]};const s={options:e,signal:n.signal,diagnostics:[],rendered:0,bytes:0,budget:r,cache:new WeakMap},i=setTimeout(()=>O(s,n),r.maxDurationMs);try{const c=[];for(const[d,a]of t.pages.entries()){if(d<(e.start??0)||d>(e.end??t.pages.length-1)){c.push(a);continue}const m=[];for(const[g,l]of a.components.entries())m.push(await x(s,l,{component:l,pageIndex:d,componentIndex:g,componentPath:[]},new Set));c.push(m.some((g,l)=>g!==a.components[l])?{...a,components:m}:a)}return{plan:c.some((d,a)=>d!==t.pages[a])?{...t,pages:c}:t,diagnostics:s.diagnostics}}finally{clearTimeout(i),e.signal?.removeEventListener("abort",o)}}exports.OutputAssetError=f;exports.resolveGridStrokes=S;exports.resolvePlanAssets=C;

package/dist/assets-NVA_sftu.js

@@ -0,0 +1,163 @@
+import { d as v, c as k, e as M } from "./style-Dv5o_x6b.js";
+const A = ["borderTop", "borderRight", "borderBottom", "borderLeft", "borderColor", "lineColor", "lineWidthPt"];
+function S(n, e) {
+  const t = v(e.style), r = t.inner ? [...n.edges] : [];
+  t.top && r.push({ kind: "h", pos: 0, from: 0, to: e.widthMm }), t.bottom && r.push({ kind: "h", pos: e.heightMm, from: 0, to: e.widthMm }), t.left && r.push({ kind: "v", pos: 0, from: 0, to: e.heightMm }), t.right && r.push({ kind: "v", pos: e.widthMm, from: 0, to: e.heightMm });
+  const o = k(e.style);
+  return r.map((s) => ({ ...s, ...o }));
+}
+function x(n, e, t) {
+  const r = n.get(e);
+  (!r || t.widthPt > r.widthPt) && n.set(e, t);
+}
+function p(n, e, t, r, o, s) {
+  const i = t < e.rows.length ? e.rows[t].pos : e.rows[e.rows.length - 1].pos + e.rows[e.rows.length - 1].size;
+  for (let a = r; a < o; a++) {
+    const c = e.columns[a];
+    x(n, `h:${t}:${a}`, { kind: "h", pos: i, from: c.pos, to: c.pos + c.size, ...s });
+  }
+}
+function w(n, e, t, r, o, s) {
+  const i = t < e.columns.length ? e.columns[t].pos : e.columns[e.columns.length - 1].pos + e.columns[e.columns.length - 1].size;
+  for (let a = r; a < o; a++) {
+    const c = e.rows[a];
+    x(n, `v:${t}:${a}`, { kind: "v", pos: i, from: c.pos, to: c.pos + c.size, ...s });
+  }
+}
+function b(n, e, t, r) {
+  const o = Math.min(e.columns.length, t.ci + (t.cell.colSpan ?? 1)), s = Math.min(e.rows.length, t.ri + (t.cell.rowSpan ?? 1)), i = M(r, t.cell.style), a = v(i), c = k(i);
+  a.top && p(n, e, t.ri, t.ci, o, c), a.bottom && p(n, e, s, t.ci, o, c), a.left && w(n, e, t.ci, t.ri, s, c), a.right && w(n, e, o, t.ri, s, c);
+}
+function P(n) {
+  const e = [...n.values()].sort((r, o) => r.kind.localeCompare(o.kind) || r.pos - o.pos || r.from - o.from), t = [];
+  for (const r of e) {
+    const o = t[t.length - 1];
+    o && o.kind === r.kind && o.pos === r.pos && Math.abs(o.to - r.from) < 1e-6 && o.color === r.color && o.widthPt === r.widthPt ? o.to = r.to : t.push({ ...r });
+  }
+  return t;
+}
+function L(n, e) {
+  if (!n.cells.some(({ cell: s }) => A.some((i) => s.style?.[i] !== void 0))) return S(n, e);
+  const t = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Set(), o = n.columns.length;
+  for (const s of n.cells) {
+    b(t, n, s, e.style);
+    const i = Math.min(n.rows.length, s.ri + (s.cell.rowSpan ?? 1)), a = Math.min(o, s.ci + (s.cell.colSpan ?? 1));
+    for (let c = s.ri; c < i; c++) for (let d = s.ci; d < a; d++) r.add(c * o + d);
+  }
+  for (let s = 0; s < n.rows.length; s++) for (let i = 0; i < o; i++)
+    r.has(s * o + i) || b(t, n, { ri: s, ci: i, cell: {} }, e.style);
+  return P(t);
+}
+class l extends Error {
+  constructor(e, t) {
+    super(e.message), this.name = "OutputAssetError", this.diagnostic = e, this.cause = t;
+  }
+}
+function u(n) {
+  if (n.aborted) throw n.reason ?? new DOMException("The operation was aborted.", "AbortError");
+}
+function y(n, e) {
+  return u(e), new Promise((t, r) => {
+    const o = () => r(e.reason ?? new DOMException("The operation was aborted.", "AbortError"));
+    e.addEventListener("abort", o, { once: !0 }), Promise.resolve(n).then(t, r).finally(() => e.removeEventListener("abort", o));
+  });
+}
+function D(n) {
+  const e = { maxAssets: 1e3, maxImageBytes: 33554432, maxTotalImageBytes: 134217728, maxDurationMs: 3e4, ...n.assetBudget };
+  for (const [t, r] of Object.entries(e))
+    if (!Number.isSafeInteger(r) || r <= 0 || r > 2147483647) throw new RangeError(`${t} must be a positive safe integer at most 2147483647.`);
+  return e;
+}
+function B(n) {
+  const e = /^data:image\/[a-z0-9.+-]+(;base64)?,(.*)$/is.exec(n);
+  if (!e) throw new TypeError("Asset renderers must return an image data URL.");
+  return e[1] ? Math.ceil(e[2].length * 3 / 4) : new TextEncoder().encode(decodeURIComponent(e[2])).byteLength;
+}
+function f(n, e, t, r, o) {
+  const s = { code: t, message: r, severity: "warning", format: n.options.format ?? "dom", pageIndex: e.pageIndex, componentIndex: e.componentIndex, componentPath: e.componentPath, kind: e.component.kind, nid: e.component.nid };
+  if (n.diagnostics.push(s), n.options.onDiagnostic?.(s), n.options.assetFailure !== "placeholder") throw new l(s, o);
+}
+async function O(n, e, t) {
+  const r = n.options.assetRenderers?.[e.kind];
+  if (e.imageData || !r) return e.imageData;
+  if (++n.rendered > n.budget.maxAssets) return f(n, t, "asset-budget-exceeded", "Output exceeded the asset count budget.");
+  let o;
+  try {
+    if (n.active = t, o = await y(r({ ...t, signal: n.signal }), n.signal), u(n.signal), o.length > n.budget.maxImageBytes * 4 + 1024) return f(n, t, "asset-budget-exceeded", "Output exceeded the image payload byte budget.");
+    const s = B(o);
+    if (s > n.budget.maxImageBytes || n.bytes + s > n.budget.maxTotalImageBytes) return f(n, t, "asset-budget-exceeded", "Output exceeded the encoded image byte budget.");
+    n.bytes += s;
+  } catch (s) {
+    if (n.signal.aborted || s instanceof l) throw s;
+    return f(n, t, "asset-render-failed", `Asset renderer failed for ${e.kind}; output was not silently omitted.`, s);
+  }
+  return o;
+}
+function T(n, e) {
+  const t = n.active;
+  if (!t) {
+    e.abort(new Error("Asset rendering exceeded maxDurationMs."));
+    return;
+  }
+  const r = { code: "asset-budget-exceeded", message: "Asset rendering exceeded maxDurationMs.", severity: "warning", format: n.options.format ?? "dom", pageIndex: t.pageIndex, componentIndex: t.componentIndex, componentPath: t.componentPath, kind: t.component.kind, nid: t.component.nid };
+  n.diagnostics.push(r);
+  try {
+    n.options.onDiagnostic?.(r);
+  } catch (o) {
+    e.abort(o);
+    return;
+  }
+  e.abort(new l(r));
+}
+async function C(n, e, t, r, o) {
+  if (!e?.children?.length) return e;
+  const s = [];
+  for (const [i, a] of e.children.entries())
+    s.push(await E(n, a, { ...t, component: a, componentPath: [...r, i] }, o));
+  return s.some((i, a) => i !== e.children[a]) ? { ...e, children: s } : e;
+}
+async function E(n, e, t, r) {
+  if (u(n.signal), r.has(e)) throw new TypeError("Cyclic grid children cannot be rendered.");
+  let o = n.cache.get(e);
+  o || (o = O(n, e, t), n.cache.set(e, o));
+  const s = await o;
+  let i = e.grid;
+  if (i) {
+    const a = new Set(r).add(e), c = [];
+    for (const [d, h] of i.cells.entries()) {
+      const g = [];
+      for (const [m, I] of h.entries()) g.push(await C(n, I, t, [...t.componentPath, d, m], a));
+      c.push(g);
+    }
+    c.some((d, h) => d.some((g, m) => g !== i.cells[h][m])) && (i = { ...i, cells: c });
+  }
+  return s !== e.imageData || i !== e.grid ? { ...e, imageData: s, grid: i } : e;
+}
+async function $(n, e = {}) {
+  const t = D(e);
+  if (e.signal?.aborted) throw e.signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+  const r = new AbortController(), o = () => r.abort(e.signal?.reason);
+  if (e.signal?.addEventListener("abort", o, { once: !0 }), !e.assetRenderers || !Object.keys(e.assetRenderers).length)
+    return e.signal?.removeEventListener("abort", o), { plan: n, diagnostics: [] };
+  const s = { options: e, signal: r.signal, diagnostics: [], rendered: 0, bytes: 0, budget: t, cache: /* @__PURE__ */ new WeakMap() }, i = setTimeout(() => T(s, r), t.maxDurationMs);
+  try {
+    const a = [];
+    for (const [c, d] of n.pages.entries()) {
+      if (c < (e.start ?? 0) || c > (e.end ?? n.pages.length - 1)) {
+        a.push(d);
+        continue;
+      }
+      const h = [];
+      for (const [g, m] of d.components.entries()) h.push(await E(s, m, { component: m, pageIndex: c, componentIndex: g, componentPath: [] }, /* @__PURE__ */ new Set()));
+      a.push(h.some((g, m) => g !== d.components[m]) ? { ...d, components: h } : d);
+    }
+    return { plan: a.some((c, d) => c !== n.pages[d]) ? { ...n, pages: a } : n, diagnostics: s.diagnostics };
+  } finally {
+    clearTimeout(i), e.signal?.removeEventListener("abort", o);
+  }
+}
+export {
+  l as O,
+  $ as a,
+  L as r
+};