@agile-team/mach-report 2.15.0 → 2.16.0

package/dist/rich-text-layout-Ct5WrY1g.js

@@ -0,0 +1,102 @@
+import { e as z, d as P, f as w, r as B, b as C } from "./style-67OqfNed.js";
+const R = ["borderTop", "borderRight", "borderBottom", "borderLeft", "borderColor", "lineColor", "lineWidthPt"];
+function $(n, t) {
+  const e = z(t.style), s = e.inner ? [...n.edges] : [];
+  e.top && s.push({ kind: "h", pos: 0, from: 0, to: t.widthMm }), e.bottom && s.push({ kind: "h", pos: t.heightMm, from: 0, to: t.widthMm }), e.left && s.push({ kind: "v", pos: 0, from: 0, to: t.heightMm }), e.right && s.push({ kind: "v", pos: t.widthMm, from: 0, to: t.heightMm });
+  const o = P(t.style);
+  return s.map((i) => ({ ...i, ...o }));
+}
+function H(n, t, e) {
+  const s = n.get(t);
+  (!s || e.widthPt > s.widthPt) && n.set(t, e);
+}
+function S(n, t, e, s, o, i) {
+  const c = e < t.rows.length ? t.rows[e].pos : t.rows[t.rows.length - 1].pos + t.rows[t.rows.length - 1].size;
+  for (let r = s; r < o; r++) {
+    const h = t.columns[r];
+    H(n, `h:${e}:${r}`, { kind: "h", pos: c, from: h.pos, to: h.pos + h.size, ...i });
+  }
+}
+function k(n, t, e, s, o, i) {
+  const c = e < t.columns.length ? t.columns[e].pos : t.columns[t.columns.length - 1].pos + t.columns[t.columns.length - 1].size;
+  for (let r = s; r < o; r++) {
+    const h = t.rows[r];
+    H(n, `v:${e}:${r}`, { kind: "v", pos: c, from: h.pos, to: h.pos + h.size, ...i });
+  }
+}
+function v(n, t, e, s) {
+  const o = Math.min(t.columns.length, e.ci + (e.cell.colSpan ?? 1)), i = Math.min(t.rows.length, e.ri + (e.cell.rowSpan ?? 1)), c = w(s, e.cell.style), r = z(c), h = P(c);
+  r.top && S(n, t, e.ri, e.ci, o, h), r.bottom && S(n, t, i, e.ci, o, h), r.left && k(n, t, e.ci, e.ri, i, h), r.right && k(n, t, o, e.ri, i, h);
+}
+function A(n) {
+  const t = [...n.values()].sort((s, o) => s.kind.localeCompare(o.kind) || s.pos - o.pos || s.from - o.from), e = [];
+  for (const s of t) {
+    const o = e[e.length - 1];
+    o && o.kind === s.kind && o.pos === s.pos && Math.abs(o.to - s.from) < 1e-6 && o.color === s.color && o.widthPt === s.widthPt ? o.to = s.to : e.push({ ...s });
+  }
+  return e;
+}
+function W(n, t) {
+  if (!n.cells.some(({ cell: i }) => R.some((c) => i.style?.[c] !== void 0))) return $(n, t);
+  const e = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Set(), o = n.columns.length;
+  for (const i of n.cells) {
+    v(e, n, i, t.style);
+    const c = Math.min(n.rows.length, i.ri + (i.cell.rowSpan ?? 1)), r = Math.min(o, i.ci + (i.cell.colSpan ?? 1));
+    for (let h = i.ri; h < c; h++) for (let l = i.ci; l < r; l++) s.add(h * o + l);
+  }
+  for (let i = 0; i < n.rows.length; i++) for (let c = 0; c < o; c++)
+    s.has(i * o + c) || v(e, n, { ri: i, ci: c, cell: {} }, t.style);
+  return A(e);
+}
+function a(n) {
+  const t = B(n).fontSizePt;
+  return { runs: [], width: 0, height: t * C(n), fontSize: t };
+}
+function T(n, t, e, s) {
+  const o = n.runs[n.runs.length - 1];
+  o?.style === e ? (o.text += t, o.width += s) : n.runs.push({ text: t, style: e, width: s });
+  const i = B(e).fontSizePt;
+  n.width += s, n.fontSize = Math.max(n.fontSize, i), n.height = Math.max(n.height, i * C(e));
+}
+function E(n, t, e, s, o) {
+  const i = n.richParagraphs[t], c = w(n.style, { ...i.lineHeight === void 0 ? {} : { lineHeight: i.lineHeight } }), r = [a(c)];
+  for (const h of i.segments) {
+    const l = w(c, h.style), m = h.kind === "field" ? h.field ?? "" : h.text ?? "";
+    for (const d of m.replace(/\r\n|\r/g, `
+`)) {
+      let f = r[r.length - 1];
+      if (d === `
+`) {
+        r.push(a(l));
+        continue;
+      }
+      const g = o.measure(d, l);
+      f.runs.length && f.width + g > e - (r.length === 1 ? s : 0) && (f = a(l), r.push(f)), T(f, d, l, g);
+    }
+  }
+  return r;
+}
+function D(n, t, e) {
+  const s = n.richParagraphs.map((r, h) => {
+    const l = (r.indentMm ?? 0) * 72 / 25.4, m = E(n, h, t.width, l, e), d = m.reduce((f, g) => f + g.height, 0) + ((r.spaceBeforeMm ?? 0) + (r.spaceAfterMm ?? 0)) * 72 / 25.4;
+    return { paragraph: r, indent: l, lines: m, height: d };
+  }), o = s.reduce((r, h) => r + h.height, 0), i = n.style?.verticalAlign;
+  let c = t.yTop - (i === "middle" ? (t.height - o) / 2 : i === "bottom" ? t.height - o : 0);
+  for (const { paragraph: r, indent: h, lines: l } of s) {
+    c -= (r.spaceBeforeMm ?? 0) * 72 / 25.4;
+    const m = Math.max(0, t.width - h);
+    for (const [d, f] of l.entries()) {
+      const g = r.align ?? n.style?.align, L = d === 0 ? h : 0, u = d === 0 ? m : t.width;
+      let M = t.x + L + (g === "center" ? (u - f.width) / 2 : g === "right" ? u - f.width : 0);
+      for (const p of f.runs)
+        e.draw(p.text, { ...p.style, align: "left" }, M, c - f.fontSize, p.width), M += p.width;
+      c -= f.height;
+    }
+    c -= (r.spaceAfterMm ?? 0) * 72 / 25.4;
+  }
+  return o > t.height + 0.01;
+}
+export {
+  D as d,
+  W as r
+};

package/dist/runtime-BjKBI530.js

@@ -0,0 +1,168 @@
+import { H as R, I as W, R as y, J as C, E as O, m as X, G as z, K as H, b as K, P as Q, n as Y } from "./json-snapshot-D6ioHth9.js";
+import { g as M } from "./report-params-B1RzkhJj.js";
+import { d as $, r as Z, R as ee } from "./param-validation-Do7Eg8Zv.js";
+import { t as P, b as x, D as te, v as se, c as T, R as D } from "./sha256-DTG-Gq8i.js";
+import { a as ae } from "./template-registry-Cw3vRTX2.js";
+import { T as re } from "./tree-CjVZLRw7.js";
+import { r as j } from "./assets-CqIbfbTr.js";
+import { s as S, a as J, d as oe, e as ne, r as ce } from "./prepared-DqtpvRTn.js";
+function I(e = []) {
+  return e.map(({ code: s, message: r, severity: i, pageIndex: t, componentIndex: a }) => ({ code: s, message: r, severity: i, path: a < 0 ? `$.pages.${t}` : `$.pages.${t}.components.${a}` }));
+}
+async function _(e, s, r = Date.now()) {
+  const i = e.prepared, t = e.format === "pdf" ? await import("@agile-team/mach-report/pdf") : void 0;
+  P(e.signal);
+  const a = e.pdf?.customFontFaces ?? (e.pdf?.customFontBytes ? { regular: e.pdf.customFontBytes } : void 0), p = t && a ? t.createFontBytesMeasurer(a) : void 0, m = R(e), c = await m.run("encode", async () => {
+    let u;
+    if (e.format === "pdf") {
+      P(e.signal);
+      const n = await t.renderPlanToPdf(i.plan, { ...e.pdf, ...p ? { measurer: p } : {}, fidelity: e.fidelity, signal: e.signal, onProgress: (f, d) => m.progress("encode", f, d) });
+      u = n.bytes, i.diagnostics.push(...I(n.diagnostics)), i.diagnostics.push(...n.fidelityWarnings.map((f) => ({ code: "pdf-fidelity", message: f, severity: "warning" })), ...n.pageErrors.map((f) => ({ code: "pdf-page", message: f, severity: "error" }))), n.unsupportedTextCount && i.diagnostics.push({ code: "pdf-font", message: `${n.unsupportedTextCount} 段文本包含当前字体不支持的字符`, severity: "warning" });
+    } else {
+      const { renderPlanToXlsx: n } = await import("@agile-team/mach-report/xlsx");
+      P(e.signal);
+      const f = await n(i.plan, { ...e.xlsx, fidelity: e.fidelity, signal: e.signal, onProgress: (d, v) => m.progress("encode", d, v) });
+      u = new Uint8Array(f.buffer), i.diagnostics.push(...I(f.diagnostics)), i.diagnostics.push(...f.warnings.map((d) => ({ code: "xlsx-fidelity", message: d, severity: "warning" })));
+    }
+    return P(e.signal), u;
+  });
+  x(s, "maxOutputBytes", c.byteLength);
+  const { plan: o, ...w } = i;
+  return { ...w, bytes: c, format: e.format, contentType: e.format === "pdf" ? "application/pdf" : "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", stats: { ...w.stats, durationMs: Date.now() - r, outputBytes: c.byteLength } };
+}
+function N(e) {
+  return { ...e, reportIds: [...e.reportIds], ...e.params ? { params: { ...e.params } } : {} };
+}
+function A(e, s) {
+  if (s.length === 0) throw new y("config", "缺少报表 ID");
+  return s.map((r) => {
+    if (!Object.prototype.hasOwnProperty.call(e, r)) throw new y("config", `未注册报表 ${r}`);
+    return e[r];
+  });
+}
+function k(e) {
+  return e.grid?.cells.reduce((s, r) => s + r.reduce((i, t) => i + (t ? 1 + (t.children?.reduce((a, p) => a + k(p), 0) ?? 0) : 0), 0), 0) ?? 0;
+}
+function ie(e, s, r) {
+  return e.pages.reduce((i, t) => i + t.components.reduce((a, p) => p.kind !== "list" ? a + k(p) : a + Y(p, s, r), 0), 0);
+}
+function de(e, s = Object.keys(e)) {
+  return A(e, s).map((r, i) => {
+    const t = s[i], a = M(e, [t]);
+    return {
+      id: t,
+      params: JSON.parse(JSON.stringify(a)),
+      paramsSchema: Z(a),
+      datasetsSchema: Object.fromEntries(Object.entries(r.dataSchema ?? {}).map(([p, m]) => [p, W(typeof r.template == "function" ? void 0 : r.template, p, m)])),
+      capabilities: {
+        save: !!r.provider?.save,
+        export: !!r.provider?.export,
+        templates: !!r.provider?.templates
+      }
+    };
+  });
+}
+function U(e, s) {
+  A(e, s.reportIds);
+  const r = $(M(e, s.reportIds), s.params), i = s.reportIds.flatMap((a) => $(M(e, [a]), s.params).issues), t = new Map(i.map((a) => [JSON.stringify(a), a]));
+  return { ...r, ok: t.size === 0, issues: [...t.values()] };
+}
+function V(e, s) {
+  const r = ae(e.plan);
+  if (!r.ok) throw new y("validate", `执行器返回无效计划：${r.errors[0]?.path}`);
+  const i = e.plan.pages.length, t = e.plan.pages.reduce((a, p) => a + p.components.reduce((m, c) => m + k(c), 0), 0);
+  return x(s, "maxRows", e.stats.rows), x(s, "maxPages", i), x(s, "maxCells", t), { ...e, stats: { ...e.stats, pages: i, cells: t } };
+}
+function q(e, s) {
+  const r = U(e.reports, s);
+  if (!r.ok) throw new ee(r.issues);
+}
+function ye(e) {
+  const s = { ...te, ...e.budget };
+  se(s);
+  const r = async (t, a) => {
+    const p = Date.now();
+    let m = 0, c = 0;
+    const o = [], w = {}, u = [], n = Object.fromEntries(Object.entries(e.reports).map(([l, g]) => [l, {
+      ...g,
+      pagination: { ...e.pagination, ...g.pagination, ...a ? { measurer: a } : {} },
+      dataValidation: {
+        ...g.dataValidation,
+        maxRows: Math.min(s.maxRows ?? 1e5, g.dataValidation?.maxRows ?? 1 / 0),
+        maxCells: Math.min(s.maxCells ?? 2e6, g.dataValidation?.maxCells ?? 1 / 0)
+      }
+    }])), d = await X(n, { maxPages: s.maxPages, maxCells: s.maxCells, onDatasets: (l, g, h) => {
+      try {
+        m += z(h, g, { maxRows: s.maxRows, signal: t.signal });
+      } catch (b) {
+        throw b instanceof re ? new D("budget", b.message, "$.budget.maxRows") : b;
+      }
+      x(s, "maxRows", m), c += ie(h, g, n[l]?.pagination), x(s, "maxCells", c);
+    } })({ ...t, params: t.params ?? {}, onWarning: (l) => o.push({ code: "layout", message: l, severity: "warning" }), onQueryResult: (l, g, h = 0) => {
+      const b = H(h, l);
+      Object.defineProperty(w, l, { value: { revision: g.revision, sourceToken: g.sourceToken }, enumerable: !0, writable: !0 }), u.push({ reportId: l, reportIndex: h, reportScope: b, ...g.revision === void 0 ? {} : { revision: g.revision }, ...g.sourceToken === void 0 ? {} : { sourceToken: g.sourceToken } }), o.push(...(g.diagnostics ?? []).map((E) => ({ ...E, ...E.target ? { target: {
+        ...E.target,
+        reportScope: b,
+        ...E.target.tableId ? { tableId: JSON.stringify([h, l, E.target.tableId]) } : {}
+      } } : {} })));
+    } }).catch((l) => {
+      throw l instanceof y && l.cause instanceof K ? new D("budget", l.cause.message, "$.budget.maxPages") : l instanceof y && l.cause instanceof Q ? new D("budget", l.cause.message, "$.budget.maxCells") : l;
+    });
+    P(t.signal);
+    const v = e.assets ? await R(t).run("assets", () => j(d, { ...e.assets, signal: t.signal })) : { plan: d, diagnostics: [] }, F = v.plan;
+    o.push(...I(v.diagnostics));
+    const L = F.pages.reduce((l, g) => l + g.components.reduce((h, b) => h + k(b), 0), 0);
+    x(s, "maxPages", F.pages.length), x(s, "maxCells", L);
+    const B = ce(t.pdf), G = e.pagination?.measurer || Object.values(e.reports).some((l) => l.pagination?.measurer);
+    return { plan: F, diagnostics: o, revisions: w, sources: u, layout: { textMetrics: B ? "font-bytes" : G ? "provided" : "heuristic", ...B ? { fontFingerprint: B } : {} }, stats: { rows: m, pages: F.pages.length, cells: L, durationMs: Date.now() - p } };
+  }, i = async (t) => {
+    const a = Date.now();
+    if (t.format !== "pdf" && t.format !== "xlsx") throw new y("config", "不支持的报表导出格式");
+    const p = t.format === "pdf" ? await import("@agile-team/mach-report/pdf") : void 0;
+    P(t.signal);
+    const m = t.pdf?.customFontFaces ?? (t.pdf?.customFontBytes ? { regular: t.pdf.customFontBytes } : void 0), c = p && m ? p.createFontBytesMeasurer(m) : void 0, o = await r(t, c);
+    return P(t.signal), _({ ...t, prepared: o }, s, a);
+  };
+  return {
+    describe: (t) => de(e.reports, t),
+    validate: (t) => U(e.reports, t),
+    prepare: (t) => T(t.signal, s.maxDurationMs, async (a) => {
+      const { signal: p, onEvent: m, ...c } = N(t), o = { ...c, ...c.pdf ? { pdf: S(c.pdf) } : {}, taskId: c.taskId ?? C() }, w = m ? (v) => O(m, v, a) : void 0, u = { ...o, signal: a, onEvent: w };
+      R(u).runSync("validate", () => q(e, o));
+      let n;
+      const f = o.pdf?.customFontFaces ?? (o.pdf?.customFontBytes ? { regular: o.pdf.customFontBytes } : void 0);
+      if (!e.executor && f) {
+        const v = await import("@agile-team/mach-report/pdf");
+        P(a), n = v.createFontBytesMeasurer(f);
+      }
+      const d = e.executor ? await e.executor.prepare(o, a, w) : await r(u, n);
+      return V(d, s);
+    }),
+    exportPrepared: (t) => T(t.signal, s.maxDurationMs, async (a) => {
+      const p = Date.now(), { signal: m, onEvent: c, ...o } = t, w = V(oe(t.prepared, s.maxPreparedBytes ?? 64e6, a), s), u = { ...o, xlsx: J(o.xlsx), prepared: w, ...o.pdf ? { pdf: S(o.pdf) } : {}, taskId: o.taskId ?? C() };
+      if (u.format !== "pdf" && u.format !== "xlsx") throw new y("config", "不支持的报表导出格式");
+      const n = c ? (d) => O(c, d, a) : void 0;
+      if (e.executor) {
+        if (!e.executor.exportPrepared) throw new y("config", "执行器未实现 exportPrepared；请升级执行器或显式使用本地运行时");
+        const d = await e.executor.exportPrepared(u, a, n);
+        return x(s, "maxRows", d.stats.rows), x(s, "maxPages", d.stats.pages), x(s, "maxCells", d.stats.cells), x(s, "maxOutputBytes", d.bytes.byteLength), { ...d, stats: { ...d.stats, outputBytes: d.bytes.byteLength } };
+      }
+      const f = { ...u, signal: a, onEvent: n };
+      if (R(f).runSync("validate", () => ne(f)), e.assets) {
+        const d = await R(f).run("assets", () => j(w.plan, { ...e.assets, signal: a }));
+        w.plan = d.plan, w.diagnostics.push(...I(d.diagnostics));
+      }
+      return _(f, s, p);
+    }),
+    export: (t) => T(t.signal, s.maxDurationMs, async (a) => {
+      const { signal: p, onEvent: m, ...c } = N(t), o = { ...c, xlsx: J(c.xlsx), ...c.pdf ? { pdf: S(c.pdf) } : {}, taskId: c.taskId ?? C() }, w = m ? (f) => O(m, f, a) : void 0, u = { ...o, signal: a, onEvent: w };
+      if (R(u).runSync("validate", () => q(e, o)), o.format !== "pdf" && o.format !== "xlsx") throw new y("config", "不支持的报表导出格式");
+      const n = e.executor ? await e.executor.export(o, a, w) : await i(u);
+      return x(s, "maxRows", n.stats.rows), x(s, "maxPages", n.stats.pages), x(s, "maxCells", n.stats.cells), x(s, "maxOutputBytes", n.bytes.byteLength), { ...n, stats: { ...n.stats, outputBytes: n.bytes.byteLength } };
+    })
+  };
+}
+export {
+  ye as c,
+  V as e
+};

package/dist/runtime-CBFEPKEs.cjs

@@ -0,0 +1 @@
+"use strict";var J=Object.create;var D=Object.defineProperty;var V=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var U=Object.getPrototypeOf,X=Object.prototype.hasOwnProperty;var W=(e,t,a,c)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of N(t))!X.call(e,s)&&s!==a&&D(e,s,{get:()=>t[s],enumerable:!(c=V(t,s))||c.enumerable});return e};var E=(e,t,a)=>(a=e!=null?J(U(e)):{},W(t||!e||!e.__esModule?D(a,"default",{value:e,enumerable:!0}):a,e));const n=require("./json-snapshot-DknkjvxP.cjs"),F=require("./report-params-WDGrA4oP.cjs"),k=require("./param-validation-C3HlcLLO.cjs"),o=require("./sha256-BshdOkCC.cjs"),z=require("./template-registry-C62vpv4a.cjs"),G=require("./tree-BX380Rr7.cjs"),M=require("./assets-e4YSke8n.cjs"),b=require("./prepared-DdrjLC7L.cjs");function I(e=[]){return e.map(({code:t,message:a,severity:c,pageIndex:s,componentIndex:r})=>({code:t,message:a,severity:c,path:r<0?`$.pages.${s}`:`$.pages.${s}.components.${r}`}))}async function q(e,t,a=Date.now()){const c=e.prepared,s=e.format==="pdf"?await import("@agile-team/mach-report/pdf"):void 0;o.throwIfAborted(e.signal);const r=e.pdf?.customFontFaces??(e.pdf?.customFontBytes?{regular:e.pdf.customFontBytes}:void 0),u=s&&r?s.createFontBytesMeasurer(r):void 0,m=n.createReportTaskReporter(e),p=await m.run("encode",async()=>{let x;if(e.format==="pdf"){o.throwIfAborted(e.signal);const d=await s.renderPlanToPdf(c.plan,{...e.pdf,...u?{measurer:u}:{},fidelity:e.fidelity,signal:e.signal,onProgress:(f,l)=>m.progress("encode",f,l)});x=d.bytes,c.diagnostics.push(...I(d.diagnostics)),c.diagnostics.push(...d.fidelityWarnings.map(f=>({code:"pdf-fidelity",message:f,severity:"warning"})),...d.pageErrors.map(f=>({code:"pdf-page",message:f,severity:"error"}))),d.unsupportedTextCount&&c.diagnostics.push({code:"pdf-font",message:`${d.unsupportedTextCount} 段文本包含当前字体不支持的字符`,severity:"warning"})}else{const{renderPlanToXlsx:d}=await import("@agile-team/mach-report/xlsx");o.throwIfAborted(e.signal);const f=await d(c.plan,{...e.xlsx,fidelity:e.fidelity,signal:e.signal,onProgress:(l,h)=>m.progress("encode",l,h)});x=new Uint8Array(f.buffer),c.diagnostics.push(...I(f.diagnostics)),c.diagnostics.push(...f.warnings.map(l=>({code:"xlsx-fidelity",message:l,severity:"warning"})))}return o.throwIfAborted(e.signal),x});o.assertBudget(t,"maxOutputBytes",p.byteLength);const{plan:i,...y}=c;return{...y,bytes:p,format:e.format,contentType:e.format==="pdf"?"application/pdf":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",stats:{...y.stats,durationMs:Date.now()-a,outputBytes:p.byteLength}}}function A(e){return{...e,reportIds:[...e.reportIds],...e.params?{params:{...e.params}}:{}}}function $(e,t){if(t.length===0)throw new n.ReportSourceError("config","缺少报表 ID");return t.map(a=>{if(!Object.prototype.hasOwnProperty.call(e,a))throw new n.ReportSourceError("config",`未注册报表 ${a}`);return e[a]})}function T(e){return e.grid?.cells.reduce((t,a)=>t+a.reduce((c,s)=>c+(s?1+(s.children?.reduce((r,u)=>r+T(u),0)??0):0),0),0)??0}function Q(e,t,a){return e.pages.reduce((c,s)=>c+s.components.reduce((r,u)=>u.kind!=="list"?r+T(u):r+n.estimateListLayoutCells(u,t,a),0),0)}function H(e,t=Object.keys(e)){return $(e,t).map((a,c)=>{const s=t[c],r=F.getReportParamDefs(e,[s]);return{id:s,params:JSON.parse(JSON.stringify(r)),paramsSchema:k.reportParamsJsonSchema(r),datasetsSchema:Object.fromEntries(Object.entries(a.dataSchema??{}).map(([u,m])=>[u,n.templateDatasetJsonSchema(typeof a.template=="function"?void 0:a.template,u,m)])),capabilities:{save:!!a.provider?.save,export:!!a.provider?.export,templates:!!a.provider?.templates}}})}function j(e,t){$(e,t.reportIds);const a=k.validateReportParams(F.getReportParamDefs(e,t.reportIds),t.params),c=t.reportIds.flatMap(r=>k.validateReportParams(F.getReportParamDefs(e,[r]),t.params).issues),s=new Map(c.map(r=>[JSON.stringify(r),r]));return{...a,ok:s.size===0,issues:[...s.values()]}}function O(e,t){const a=z.validateRenderPlan(e.plan);if(!a.ok)throw new n.ReportSourceError("validate",`执行器返回无效计划：${a.errors[0]?.path}`);const c=e.plan.pages.length,s=e.plan.pages.reduce((r,u)=>r+u.components.reduce((m,p)=>m+T(p),0),0);return o.assertBudget(t,"maxRows",e.stats.rows),o.assertBudget(t,"maxPages",c),o.assertBudget(t,"maxCells",s),{...e,stats:{...e.stats,pages:c,cells:s}}}function L(e,t){const a=j(e.reports,t);if(!a.ok)throw new k.ReportParamValidationError(a.issues)}function K(e){const t={...o.DEFAULT_REPORT_RUNTIME_BUDGET,...e.budget};o.validateBudget(t);const a=async(s,r)=>{const u=Date.now();let m=0,p=0;const i=[],y={},x=[],d=Object.fromEntries(Object.entries(e.reports).map(([g,w])=>[g,{...w,pagination:{...e.pagination,...w.pagination,...r?{measurer:r}:{}},dataValidation:{...w.dataValidation,maxRows:Math.min(t.maxRows??1e5,w.dataValidation?.maxRows??1/0),maxCells:Math.min(t.maxCells??2e6,w.dataValidation?.maxCells??1/0)}}])),l=await n.createReportSource(d,{maxPages:t.maxPages,maxCells:t.maxCells,onDatasets:(g,w,v)=>{try{m+=n.templateDatasetRowCount(v,w,{maxRows:t.maxRows,signal:s.signal})}catch(R){throw R instanceof G.TreeRowLimitError?new o.ReportRuntimeError("budget",R.message,"$.budget.maxRows"):R}o.assertBudget(t,"maxRows",m),p+=Q(v,w,d[g]?.pagination),o.assertBudget(t,"maxCells",p)}})({...s,params:s.params??{},onWarning:g=>i.push({code:"layout",message:g,severity:"warning"}),onQueryResult:(g,w,v=0)=>{const R=n.reportOccurrenceScope(v,g);Object.defineProperty(y,g,{value:{revision:w.revision,sourceToken:w.sourceToken},enumerable:!0,writable:!0}),x.push({reportId:g,reportIndex:v,reportScope:R,...w.revision===void 0?{}:{revision:w.revision},...w.sourceToken===void 0?{}:{sourceToken:w.sourceToken}}),i.push(...(w.diagnostics??[]).map(P=>({...P,...P.target?{target:{...P.target,reportScope:R,...P.target.tableId?{tableId:JSON.stringify([v,g,P.target.tableId])}:{}}}:{}})))}}).catch(g=>{throw g instanceof n.ReportSourceError&&g.cause instanceof n.PaginatePageLimitError?new o.ReportRuntimeError("budget",g.cause.message,"$.budget.maxPages"):g instanceof n.ReportSourceError&&g.cause instanceof n.PaginateCellLimitError?new o.ReportRuntimeError("budget",g.cause.message,"$.budget.maxCells"):g});o.throwIfAborted(s.signal);const h=e.assets?await n.createReportTaskReporter(s).run("assets",()=>M.resolvePlanAssets(l,{...e.assets,signal:s.signal})):{plan:l,diagnostics:[]},B=h.plan;i.push(...I(h.diagnostics));const C=B.pages.reduce((g,w)=>g+w.components.reduce((v,R)=>v+T(R),0),0);o.assertBudget(t,"maxPages",B.pages.length),o.assertBudget(t,"maxCells",C);const S=b.reportFontFingerprint(s.pdf),_=e.pagination?.measurer||Object.values(e.reports).some(g=>g.pagination?.measurer);return{plan:B,diagnostics:i,revisions:y,sources:x,layout:{textMetrics:S?"font-bytes":_?"provided":"heuristic",...S?{fontFingerprint:S}:{}},stats:{rows:m,pages:B.pages.length,cells:C,durationMs:Date.now()-u}}},c=async s=>{const r=Date.now();if(s.format!=="pdf"&&s.format!=="xlsx")throw new n.ReportSourceError("config","不支持的报表导出格式");const u=s.format==="pdf"?await import("@agile-team/mach-report/pdf"):void 0;o.throwIfAborted(s.signal);const m=s.pdf?.customFontFaces??(s.pdf?.customFontBytes?{regular:s.pdf.customFontBytes}:void 0),p=u&&m?u.createFontBytesMeasurer(m):void 0,i=await a(s,p);return o.throwIfAborted(s.signal),q({...s,prepared:i},t,r)};return{describe:s=>H(e.reports,s),validate:s=>j(e.reports,s),prepare:s=>o.controlled(s.signal,t.maxDurationMs,async r=>{const{signal:u,onEvent:m,...p}=A(s),i={...p,...p.pdf?{pdf:b.snapshotPdfFonts(p.pdf)}:{},taskId:p.taskId??n.reportTaskId()},y=m?h=>n.notifyReportTaskEvent(m,h,r):void 0,x={...i,signal:r,onEvent:y};n.createReportTaskReporter(x).runSync("validate",()=>L(e,i));let d;const f=i.pdf?.customFontFaces??(i.pdf?.customFontBytes?{regular:i.pdf.customFontBytes}:void 0);if(!e.executor&&f){const h=await import("@agile-team/mach-report/pdf");o.throwIfAborted(r),d=h.createFontBytesMeasurer(f)}const l=e.executor?await e.executor.prepare(i,r,y):await a(x,d);return O(l,t)}),exportPrepared:s=>o.controlled(s.signal,t.maxDurationMs,async r=>{const u=Date.now(),{signal:m,onEvent:p,...i}=s,y=O(b.snapshotPreparedReport(s.prepared,t.maxPreparedBytes??64e6,r),t),x={...i,xlsx:b.snapshotXlsxOptions(i.xlsx),prepared:y,...i.pdf?{pdf:b.snapshotPdfFonts(i.pdf)}:{},taskId:i.taskId??n.reportTaskId()};if(x.format!=="pdf"&&x.format!=="xlsx")throw new n.ReportSourceError("config","不支持的报表导出格式");const d=p?l=>n.notifyReportTaskEvent(p,l,r):void 0;if(e.executor){if(!e.executor.exportPrepared)throw new n.ReportSourceError("config","执行器未实现 exportPrepared；请升级执行器或显式使用本地运行时");const l=await e.executor.exportPrepared(x,r,d);return o.assertBudget(t,"maxRows",l.stats.rows),o.assertBudget(t,"maxPages",l.stats.pages),o.assertBudget(t,"maxCells",l.stats.cells),o.assertBudget(t,"maxOutputBytes",l.bytes.byteLength),{...l,stats:{...l.stats,outputBytes:l.bytes.byteLength}}}const f={...x,signal:r,onEvent:d};if(n.createReportTaskReporter(f).runSync("validate",()=>b.checkPreparedFont(f)),e.assets){const l=await n.createReportTaskReporter(f).run("assets",()=>M.resolvePlanAssets(y.plan,{...e.assets,signal:r}));y.plan=l.plan,y.diagnostics.push(...I(l.diagnostics))}return q(f,t,u)}),export:s=>o.controlled(s.signal,t.maxDurationMs,async r=>{const{signal:u,onEvent:m,...p}=A(s),i={...p,xlsx:b.snapshotXlsxOptions(p.xlsx),...p.pdf?{pdf:b.snapshotPdfFonts(p.pdf)}:{},taskId:p.taskId??n.reportTaskId()},y=m?f=>n.notifyReportTaskEvent(m,f,r):void 0,x={...i,signal:r,onEvent:y};if(n.createReportTaskReporter(x).runSync("validate",()=>L(e,i)),i.format!=="pdf"&&i.format!=="xlsx")throw new n.ReportSourceError("config","不支持的报表导出格式");const d=e.executor?await e.executor.export(i,r,y):await c(x);return o.assertBudget(t,"maxRows",d.stats.rows),o.assertBudget(t,"maxPages",d.stats.pages),o.assertBudget(t,"maxCells",d.stats.cells),o.assertBudget(t,"maxOutputBytes",d.bytes.byteLength),{...d,stats:{...d.stats,outputBytes:d.bytes.byteLength}}})}}exports.createReportRuntime=K;exports.enforcePrepared=O;

package/dist/sbom.cdx.json

@@ -6,7 +6,7 @@
     "component": {
       "type": "library",
       "name": "@agile-team/mach-report",
-      "version": "2.15.0"
+      "version": "2.16.0"
     },
     "properties": [
       {
@@ -15,7 +15,7 @@
       },
       {
         "name": "mach-report:pnpm-lock-sha256",
-        "value": "f1e4c95d99a99330d34b81c8d599595a6674a6ca23e22d6630d0e4d3ceae52cb"
+        "value": "fddd4c6493151407325d6e9b417bbecd0901d87a44543b1dbf4b96c0f3025ef7"
       }
     ]
   },

package/dist/server/node.d.cts

@@ -2,6 +2,15 @@
 
 import { WorkerOptions as WorkerOptions_2 } from 'node:worker_threads';
 
+declare interface BrowserReportWorker {
+    postMessage(value: unknown, transfer?: Transferable[]): void;
+    terminate(): void;
+    addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    addEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+    removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+}
+
 /** Serializable symbol settings. Encoders remain in the optional /codes entry. */
 declare interface CodeOptions {
     /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
@@ -72,6 +81,9 @@ declare interface ComponentStyle {
     rotateDeg?: number;
 }
 
+/** Node needs no URL factory: this module is the isolated encoding entry in both ESM and CommonJS builds. */
+export declare function createNodeAutoReportExporter(options?: Omit<ReportExportExecutionOptions, "workerFactory">): ReportAutoExporter;
+
 /** 独立 worker_threads 适配器；worker 入口注册自己的模板/Provider，不把函数跨线程序列化。 */
 export declare function createNodeReportExecutor(options: NodeReportExecutorOptions): ReportRuntimeExecutor;
 
@@ -85,6 +97,8 @@ export declare interface FileReportJobStoreOptions extends ReportJobStoreBudgetO
 }
 
 declare interface GridCell {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -108,6 +122,19 @@ declare interface GridCell {
     style?: ComponentStyle;
 }
 
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+declare interface ImageMediaOptions {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
+
 export declare interface NodeReportExecutorOptions extends ReportWorkerOptions {
     filename?: string | URL;
     workerUrl?: string | URL;
@@ -213,6 +240,16 @@ declare interface RenderPlan {
 /** Optional publication digest for Node hosts; use as reviewReportPublication({ digest }). */
 export declare function reportArtifactSha256(bytes: Uint8Array): string;
 
+export declare interface ReportAutoExporter {
+    exportPrepared(input: ReportRuntimePreparedExportInput, localOverride?: ReportLocalExport): Promise<ReportAutoExportResult>;
+    cancel(): void;
+    dispose(): void;
+}
+
+export declare interface ReportAutoExportResult extends ReportRuntimeExportResult {
+    execution: ReportExportDecision;
+}
+
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
     /** Source identity across report occurrences; sharing must be explicitly declared. */
@@ -257,6 +294,38 @@ declare interface ReportDiagnostic {
     target?: ReportDataTarget;
 }
 
+export declare interface ReportExportDecision {
+    mode: "local" | "worker";
+    reason: ReportExportDecisionReason;
+    /** Lower bounds: traversal stops as soon as isolation is warranted. No font or image hashing. */
+    estimate: {
+        pages: number;
+        cells: number;
+        bytes: number;
+    };
+    hardCancellation: boolean;
+}
+
+declare type ReportExportDecisionReason = "small-task" | "threshold" | "scan-limit" | "explicit-local" | "explicit-worker" | "worker-unavailable" | "worker-start-failed" | "nonserializable-options";
+
+export declare interface ReportExportExecutionOptions {
+    mode?: "auto" | "worker" | "local";
+    /** A fresh bundler-managed module Worker for every call; never a shared worker. */
+    workerFactory?: () => BrowserReportWorker;
+    thresholds?: ReportExportThresholds;
+    /** Auto only. Startup unavailability may use local; encoding failures never retry. */
+    fallback?: "local" | "error";
+    timeoutMs?: number;
+    budget?: ReportRuntimeBudget;
+    onDecision?: (decision: ReportExportDecision) => void;
+}
+
+declare interface ReportExportThresholds {
+    cells?: number;
+    pages?: number;
+    bytes?: number;
+}
+
 declare type ReportJobJson = null | boolean | number | string | ReportJobJson[] | {
     [key: string]: ReportJobJson;
 };
@@ -338,6 +407,8 @@ declare interface ReportJobTombstone {
     expiresAt: number;
 }
 
+declare type ReportLocalExport = (input: ReportRuntimePreparedExportInput) => Promise<ReportRuntimeExportResult>;
+
 /** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
 declare interface ReportParamDef {
     /** 参数名（传入 params，与数据集 SQL #{field} 绑定对应） */
@@ -402,6 +473,16 @@ declare interface ReportRuntime {
     exportPrepared(input: ReportRuntimePreparedExportInput): Promise<ReportRuntimeExportResult>;
 }
 
+declare interface ReportRuntimeBudget {
+    maxRows?: number;
+    maxPages?: number;
+    maxCells?: number;
+    maxOutputBytes?: number;
+    /** Bound the plain JSON snapshot accepted by exportPrepared (default 64 MB). */
+    maxPreparedBytes?: number;
+    maxDurationMs?: number;
+}
+
 /** 可用 worker_threads/进程/RPC 实现；接收可序列化请求，signal 由桥接层映射为取消消息。 */
 declare interface ReportRuntimeExecutor {
     /** Old custom executors may omit this; the runtime explicitly rejects unsupported prepared output. */
@@ -414,10 +495,11 @@ declare interface ReportRuntimeExportInput extends ReportRuntimeInput {
     format: "pdf" | "xlsx";
     /** strict 在编码前拒绝已识别的输出降级；默认保留诊断并继续。 */
     fidelity?: "warn" | "strict";
-    xlsx?: {
+    xlsx?: ImageMediaOptions & {
         sheetMode?: "auto" | "pages" | "continuous";
         valueMode?: "text" | "raw";
         paperSize?: "auto" | "a3" | "a4" | "a5";
+        sheetName?: (sheetIndex: number) => string;
     };
 }
 
@@ -438,6 +520,8 @@ declare interface ReportRuntimeInput extends ReportTaskMonitoring {
 /** Encode an existing plan without querying providers or repaginating. */
 declare interface ReportRuntimePreparedExportInput extends ReportTaskMonitoring {
     prepared: PreparedReport;
+    /** verify checks font metric identity; preserve explicitly keeps existing geometry, with a diagnostic. Encoding fidelity is unchanged. */
+    layoutPolicy?: "verify" | "preserve";
     format: ReportRuntimeExportInput["format"];
     fidelity?: ReportRuntimeExportInput["fidelity"];
     pdf?: ReportPdfFontOptions;
@@ -494,6 +578,7 @@ export declare class ReportWorkerError extends Error {
 
 declare interface ReportWorkerOptions {
     timeoutMs?: number;
+    budget?: ReportRuntimeBudget;
 }
 
 declare interface RichParagraph {

package/dist/server/node.d.ts

@@ -2,6 +2,15 @@
 
 import { WorkerOptions as WorkerOptions_2 } from 'node:worker_threads';
 
+declare interface BrowserReportWorker {
+    postMessage(value: unknown, transfer?: Transferable[]): void;
+    terminate(): void;
+    addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    addEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+    removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+}
+
 /** Serializable symbol settings. Encoders remain in the optional /codes entry. */
 declare interface CodeOptions {
     /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
@@ -72,6 +81,9 @@ declare interface ComponentStyle {
     rotateDeg?: number;
 }
 
+/** Node needs no URL factory: this module is the isolated encoding entry in both ESM and CommonJS builds. */
+export declare function createNodeAutoReportExporter(options?: Omit<ReportExportExecutionOptions, "workerFactory">): ReportAutoExporter;
+
 /** 独立 worker_threads 适配器；worker 入口注册自己的模板/Provider，不把函数跨线程序列化。 */
 export declare function createNodeReportExecutor(options: NodeReportExecutorOptions): ReportRuntimeExecutor;
 
@@ -85,6 +97,8 @@ export declare interface FileReportJobStoreOptions extends ReportJobStoreBudgetO
 }
 
 declare interface GridCell {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -108,6 +122,19 @@ declare interface GridCell {
     style?: ComponentStyle;
 }
 
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+declare interface ImageMediaOptions {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
+
 export declare interface NodeReportExecutorOptions extends ReportWorkerOptions {
     filename?: string | URL;
     workerUrl?: string | URL;
@@ -213,6 +240,16 @@ declare interface RenderPlan {
 /** Optional publication digest for Node hosts; use as reviewReportPublication({ digest }). */
 export declare function reportArtifactSha256(bytes: Uint8Array): string;
 
+export declare interface ReportAutoExporter {
+    exportPrepared(input: ReportRuntimePreparedExportInput, localOverride?: ReportLocalExport): Promise<ReportAutoExportResult>;
+    cancel(): void;
+    dispose(): void;
+}
+
+export declare interface ReportAutoExportResult extends ReportRuntimeExportResult {
+    execution: ReportExportDecision;
+}
+
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
     /** Source identity across report occurrences; sharing must be explicitly declared. */
@@ -257,6 +294,38 @@ declare interface ReportDiagnostic {
     target?: ReportDataTarget;
 }
 
+export declare interface ReportExportDecision {
+    mode: "local" | "worker";
+    reason: ReportExportDecisionReason;
+    /** Lower bounds: traversal stops as soon as isolation is warranted. No font or image hashing. */
+    estimate: {
+        pages: number;
+        cells: number;
+        bytes: number;
+    };
+    hardCancellation: boolean;
+}
+
+declare type ReportExportDecisionReason = "small-task" | "threshold" | "scan-limit" | "explicit-local" | "explicit-worker" | "worker-unavailable" | "worker-start-failed" | "nonserializable-options";
+
+export declare interface ReportExportExecutionOptions {
+    mode?: "auto" | "worker" | "local";
+    /** A fresh bundler-managed module Worker for every call; never a shared worker. */
+    workerFactory?: () => BrowserReportWorker;
+    thresholds?: ReportExportThresholds;
+    /** Auto only. Startup unavailability may use local; encoding failures never retry. */
+    fallback?: "local" | "error";
+    timeoutMs?: number;
+    budget?: ReportRuntimeBudget;
+    onDecision?: (decision: ReportExportDecision) => void;
+}
+
+declare interface ReportExportThresholds {
+    cells?: number;
+    pages?: number;
+    bytes?: number;
+}
+
 declare type ReportJobJson = null | boolean | number | string | ReportJobJson[] | {
     [key: string]: ReportJobJson;
 };
@@ -338,6 +407,8 @@ declare interface ReportJobTombstone {
     expiresAt: number;
 }
 
+declare type ReportLocalExport = (input: ReportRuntimePreparedExportInput) => Promise<ReportRuntimeExportResult>;
+
 /** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
 declare interface ReportParamDef {
     /** 参数名（传入 params，与数据集 SQL #{field} 绑定对应） */
@@ -402,6 +473,16 @@ declare interface ReportRuntime {
     exportPrepared(input: ReportRuntimePreparedExportInput): Promise<ReportRuntimeExportResult>;
 }
 
+declare interface ReportRuntimeBudget {
+    maxRows?: number;
+    maxPages?: number;
+    maxCells?: number;
+    maxOutputBytes?: number;
+    /** Bound the plain JSON snapshot accepted by exportPrepared (default 64 MB). */
+    maxPreparedBytes?: number;
+    maxDurationMs?: number;
+}
+
 /** 可用 worker_threads/进程/RPC 实现；接收可序列化请求，signal 由桥接层映射为取消消息。 */
 declare interface ReportRuntimeExecutor {
     /** Old custom executors may omit this; the runtime explicitly rejects unsupported prepared output. */
@@ -414,10 +495,11 @@ declare interface ReportRuntimeExportInput extends ReportRuntimeInput {
     format: "pdf" | "xlsx";
     /** strict 在编码前拒绝已识别的输出降级；默认保留诊断并继续。 */
     fidelity?: "warn" | "strict";
-    xlsx?: {
+    xlsx?: ImageMediaOptions & {
         sheetMode?: "auto" | "pages" | "continuous";
         valueMode?: "text" | "raw";
         paperSize?: "auto" | "a3" | "a4" | "a5";
+        sheetName?: (sheetIndex: number) => string;
     };
 }
 
@@ -438,6 +520,8 @@ declare interface ReportRuntimeInput extends ReportTaskMonitoring {
 /** Encode an existing plan without querying providers or repaginating. */
 declare interface ReportRuntimePreparedExportInput extends ReportTaskMonitoring {
     prepared: PreparedReport;
+    /** verify checks font metric identity; preserve explicitly keeps existing geometry, with a diagnostic. Encoding fidelity is unchanged. */
+    layoutPolicy?: "verify" | "preserve";
     format: ReportRuntimeExportInput["format"];
     fidelity?: ReportRuntimeExportInput["fidelity"];
     pdf?: ReportPdfFontOptions;
@@ -494,6 +578,7 @@ export declare class ReportWorkerError extends Error {
 
 declare interface ReportWorkerOptions {
     timeoutMs?: number;
+    budget?: ReportRuntimeBudget;
 }
 
 declare interface RichParagraph {