@agile-team/mach-report 2.5.0 → 2.7.0

package/dist/server/node.d.ts

@@ -0,0 +1,320 @@
+/// <reference types="node" />
+
+import { WorkerOptions as WorkerOptions_2 } from 'node:worker_threads';
+
+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;
+}
+
+/** 独立 worker_threads 适配器；worker 入口注册自己的模板/Provider，不把函数跨线程序列化。 */
+export declare function createNodeReportExecutor(options: NodeReportExecutorOptions): ReportRuntimeExecutor;
+
+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;
+}
+
+export declare interface NodeReportExecutorOptions extends ReportWorkerOptions {
+    filename?: string | URL;
+    workerUrl?: string | URL;
+    workerOptions?: WorkerOptions_2;
+}
+
+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;
+}
+
+declare interface PlanPage {
+    /** wide 表示完整自然列宽；页面仅为预览的垂直窗口分段。 */
+    layout?: "page" | "wide";
+    pageWidthMm: number;
+    pageHeightMm: number;
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    marginLeftMm?: number;
+    marginRightMm?: number;
+    components: PlanComponent[];
+}
+
+/** 列表的逻辑行来源；用于连续 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 PreparedReport {
+    plan: RenderPlan;
+    diagnostics: ReportDiagnostic[];
+    stats: ReportRuntimeStats;
+    revisions: Record<string, {
+        revision?: string;
+        sourceToken?: string;
+    }>;
+}
+
+declare interface RenderPlan {
+    schemaVersion: string;
+    pages: PlanPage[];
+}
+
+/** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
+declare interface ReportCellSource {
+    datasetId: string;
+    rowKey: string | number;
+    field: string;
+    revision?: string | number;
+    sourceToken?: string;
+}
+
+declare interface ReportDescription {
+    id: string;
+    params: ReportParamDef[];
+    paramsSchema: Record<string, unknown>;
+    datasetsSchema: Record<string, Record<string, unknown>>;
+    /** Provider 的可选远程能力；runtime 自身始终提供 PDF/XLSX 导出。 */
+    capabilities: {
+        save: boolean;
+        export: boolean;
+        templates: boolean;
+    };
+}
+
+declare interface ReportDiagnostic {
+    code: string;
+    message: string;
+    path?: string;
+    severity: "warning" | "error" | "info";
+}
+
+/** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
+declare interface ReportParamDef {
+    /** 参数名（传入 params，与数据集 SQL #{field} 绑定对应） */
+    field: string;
+    /** 显示名（缺省用 field） */
+    label?: string;
+    type?: "text" | "number" | "date" | "select";
+    /** select 选项 */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    defaultValue?: string;
+    required?: boolean;
+    placeholder?: string;
+    /** 数字上下界；date 参数使用 YYYY-MM-DD 字符串（含边界）。 */
+    min?: number | string;
+    max?: number | string;
+    minLength?: number;
+    maxLength?: number;
+}
+
+declare interface ReportParamIssue {
+    code: ReportParamIssueCode;
+    path: string;
+    field: string;
+    message: string;
+}
+
+declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "minimum" | "maximum" | "minLength" | "maxLength";
+
+declare interface ReportParamValidation {
+    ok: boolean;
+    /** 保留历史取数契约的字符串形式；未知参数保留，不能代替接口权限白名单。 */
+    values: Record<string, string>;
+    /** JSON Schema 对应的规范值：number 参数转换为有限数字。 */
+    typedValues: Record<string, string | number>;
+    issues: ReportParamIssue[];
+}
+
+declare interface ReportRuntime {
+    describe(reportIds?: string[]): ReportDescription[];
+    validate(input: Omit<ReportRuntimeInput, "signal">): ReportParamValidation;
+    prepare(input: ReportRuntimeInput): Promise<PreparedReport>;
+    export(input: ReportRuntimeExportInput): Promise<ReportRuntimeExportResult>;
+}
+
+/** 可用 worker_threads/进程/RPC 实现；接收可序列化请求，signal 由桥接层映射为取消消息。 */
+declare interface ReportRuntimeExecutor {
+    prepare(input: Omit<ReportRuntimeInput, "signal" | "onEvent">, signal?: AbortSignal, onEvent?: ReportTaskObserver): Promise<PreparedReport>;
+    export(input: Omit<ReportRuntimeExportInput, "signal" | "onEvent">, signal?: AbortSignal, onEvent?: ReportTaskObserver): Promise<ReportRuntimeExportResult>;
+}
+
+declare interface ReportRuntimeExportInput extends ReportRuntimeInput {
+    format: "pdf" | "xlsx";
+    /** strict 在编码前拒绝已识别的输出降级；默认保留诊断并继续。 */
+    fidelity?: "warn" | "strict";
+    /** PDF 中文需宿主显式提供有授权的字体；不隐式下载字体或资源。 */
+    pdf?: {
+        customFontBytes?: Uint8Array | ArrayBuffer;
+        customFontName?: string;
+        customFontFaces?: {
+            regular: Uint8Array | ArrayBuffer;
+            bold?: Uint8Array | ArrayBuffer;
+            italic?: Uint8Array | ArrayBuffer;
+            boldItalic?: Uint8Array | ArrayBuffer;
+        };
+    };
+    xlsx?: {
+        sheetMode?: "auto" | "pages" | "continuous";
+        valueMode?: "text" | "raw";
+        paperSize?: "auto" | "a3" | "a4" | "a5";
+    };
+}
+
+declare interface ReportRuntimeExportResult extends Omit<PreparedReport, "plan"> {
+    bytes: Uint8Array;
+    format: "pdf" | "xlsx";
+    contentType: string;
+}
+
+declare interface ReportRuntimeInput extends ReportTaskMonitoring {
+    reportIds: string[];
+    params?: Record<string, string>;
+    signal?: AbortSignal;
+}
+
+declare interface ReportRuntimeStats {
+    rows: number;
+    pages: number;
+    cells: number;
+    durationMs: number;
+    outputBytes?: number;
+}
+
+/** 阶段事件只包含可序列化值；不表示估算百分比，也不包含业务数据。 */
+declare interface ReportTaskEvent {
+    taskId: string;
+    correlationId?: string;
+    stage: "query" | "validate" | "layout" | "encode";
+    status: "started" | "completed" | "failed";
+    reportId?: string;
+    completed?: number;
+    total?: number;
+}
+
+declare interface ReportTaskMonitoring {
+    taskId?: string;
+    correlationId?: string;
+    onEvent?: ReportTaskObserver;
+}
+
+declare type ReportTaskObserver = (event: ReportTaskEvent) => void;
+
+export declare class ReportWorkerError extends Error {
+    readonly code?: string;
+    readonly path?: string;
+    readonly issues?: unknown;
+    readonly diagnostics?: unknown;
+    constructor(error: SerializedReportError);
+}
+
+declare interface ReportWorkerOptions {
+    timeoutMs?: number;
+}
+
+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;
+}
+
+declare interface SerializedReportError {
+    name: string;
+    message: string;
+    code?: string;
+    path?: string;
+    issues?: unknown;
+    diagnostics?: unknown;
+}
+
+/** Node Worker 入口调用；主线程调用会明确报错。 */
+export declare function serveNodeReportWorker(runtime: ReportRuntime): () => void;
+
+export { }

package/dist/server-node.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const R=require("node:worker_threads");function P(e,t,r){if(!r?.aborted)try{const o=e?.({...t});o&&typeof o.then=="function"&&Promise.resolve(o).catch(()=>{})}catch{}}function T(e,t,r){e.editable!==void 0&&typeof e.editable!="boolean"&&r.push({path:`${t}.editable`,message:"编辑控制应为布尔值"}),e.valueType!==void 0&&!["text","number","boolean"].includes(e.valueType)&&r.push({path:`${t}.valueType`,message:"编辑类型应为 text、number 或 boolean"})}function v(e,t,r){T(e,t,r),x(e.source,`${t}.source`,r,!0),e.formula!==void 0&&typeof e.formula!="string"&&r.push({path:`${t}.formula`,message:"单元格公式应为字符串"})}function x(e,t,r,o=!1){if(e===void 0)return;if(!e||typeof e!="object"||Array.isArray(e)){r.push({path:t,message:"业务来源应为对象"});return}const s=e;for(const n of["datasetId",...o?["field"]:[]])(typeof s[n]!="string"||!s[n].trim())&&r.push({path:`${t}.${n}`,message:"业务标识应为非空字符串"});for(const n of["rowKey","revision"]){const i=s[n];i===void 0&&!(o&&n==="rowKey")||typeof i!="string"&&!(typeof i=="number"&&Number.isFinite(i))&&r.push({path:`${t}.${n}`,message:"业务键及修订号应为字符串或有限数字"})}s.sourceToken!==void 0&&typeof s.sourceToken!="string"&&r.push({path:`${t}.sourceToken`,message:"来源令牌应为字符串"})}const O=new Set(["text","image","barcode","qrcode","chart","line","rect","ellipse"]);function d(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function S(e,t,r,o){const s=e[t];(typeof s!="number"||!Number.isFinite(s))&&o.push({path:`${r}.${t}`,message:`应为有限数字，实际 ${JSON.stringify(s)}`})}function j(e,t,r){if(e!==void 0){const o=`${t}.table`;if(!d(e))r.push({path:o,message:"逻辑表来源应为对象"});else{x(e.source,`${o}.source`,r),(typeof e.id!="string"||!e.id.trim())&&r.push({path:`${o}.id`,message:"逻辑表 ID 应为非空字符串"});const s=e.role;["header","body","group-header","subtotal","grand-total"].includes(s)||r.push({path:`${o}.role`,message:"未知逻辑表行角色"});const n=e.rowIndex;(typeof n!="number"||!Number.isInteger(n)||(s==="header"?n!==-1:n<0))&&r.push({path:`${o}.rowIndex`,message:"表头索引应为 -1，内容行索引应为非负整数"}),(!Array.isArray(e.columnKeys)||e.columnKeys.some(i=>typeof i!="string"))&&r.push({path:`${o}.columnKeys`,message:"逻辑列字段应为字符串数组"}),e.layout!==void 0&&e.layout!=="page"&&e.layout!=="wide"&&r.push({path:`${o}.layout`,message:"布局应为 page 或 wide"}),e.title!==void 0&&typeof e.title!="string"&&r.push({path:`${o}.title`,message:"逻辑表名称应为字符串"})}}}function K(e,t,r,o){if(e!==void 0)if(!d(e)||!Array.isArray(e.cells))r.push({path:`${t}.grid.cells`,message:"grid.cells 应为二维数组"});else{const s=e.paddingMm;s!==void 0&&(typeof s!="number"||!Number.isFinite(s)||s<0)&&r.push({path:`${t}.grid.paddingMm`,message:"单元格内距应为有限非负数"}),e.cells.forEach((n,i)=>{if(!Array.isArray(n)){r.push({path:`${t}.grid.cells.${i}`,message:"行应为数组"});return}n.forEach((c,m)=>{if(c==null)return;const g=`${t}.grid.cells.${i}.${m}`;if(!d(c)){r.push({path:g,message:"网格单元格应为对象或 null"});return}v(c,g,r),Array.isArray(c.children)&&c.children.forEach((y,b)=>{I(y,`${t}.grid.cells.${i}.${m}.children.${b}`,r,o)})})})}}function _(e,t,r){e!==void 0&&(Array.isArray(e)?e.forEach((o,s)=>{(!d(o)||!Array.isArray(o.segments))&&r.push({path:`${t}.richParagraphs.${s}`,message:"段落缺少 segments 数组"})}):r.push({path:`${t}.richParagraphs`,message:"richParagraphs 应为数组"}))}function I(e,t,r,o=[]){if(!d(e)){r.push({path:t,message:"组件应为对象"});return}const s=e.kind;typeof s!="string"?r.push({path:`${t}.kind`,message:"组件缺少 kind 字符串"}):O.has(s)||o.push({path:`${t}.kind`,message:`未知组件类型 ${JSON.stringify(s)}，将以兜底方式渲染`});for(const n of["leftMm","topMm","widthMm","heightMm"])S(e,n,t,r);typeof e.leftMm=="number"&&e.leftMm<-100&&r.push({path:`${t}.leftMm`,message:"几何数值异常（leftMm<-100）"});for(const n of["widthMm","heightMm"])typeof e[n]=="number"&&e[n]<0&&r.push({path:`${t}.${n}`,message:"组件尺寸不能为负数"});j(e.table,t,r),e.lineDirection!==void 0&&!["down","up"].includes(e.lineDirection)&&r.push({path:`${t}.lineDirection`,message:"线段方向应为 down 或 up"}),K(e.grid,t,r,o),_(e.richParagraphs,t,r)}function D(e,t,r,o=[]){if(!d(e)){r.push({path:t,message:"页应为对象"});return}const s=e.pageWidthMm,n=e.pageHeightMm;(typeof s!="number"||!Number.isFinite(s)||s<=0)&&r.push({path:`${t}.pageWidthMm`,message:`页宽非法: ${JSON.stringify(s)}`}),(typeof n!="number"||!(n>0&&n<5e3))&&r.push({path:`${t}.pageHeightMm`,message:`页高非法: ${JSON.stringify(n)}`}),e.layout!==void 0&&e.layout!=="page"&&e.layout!=="wide"&&r.push({path:`${t}.layout`,message:"布局应为 page 或 wide"});const i=e.components;Array.isArray(i)?Array.isArray(i)&&i.forEach((c,m)=>I(c,`${t}.components.${m}`,r,o)):r.push({path:`${t}.components`,message:"components 应为数组"})}function F(e){const t=[],r=[],o=d(e)?e.pages:void 0;if(!Array.isArray(o))t.push({path:"$.pages",message:e==null?"渲染计划为空":"渲染计划缺少 pages 数组"});else{o.forEach((n,i)=>D(n,`$.pages.${i}`,t,r)),o.length>2e3&&r.push({path:"$.pages",message:`页数异常大（${o.length} 页），渲染与打印耗时可能显著增加`});const s=o.reduce((n,i)=>n+(d(i)&&Array.isArray(i.components)?i.components.length:0),0);s>5e4&&r.push({path:"$.pages",message:`组件总数异常大（${s} 个），可能触发浏览器性能限制`})}return{ok:t.length===0,errors:t,warnings:r}}const l="mach-report-worker/1";class E extends Error{constructor(t){super(t.message),this.name=t.name,this.code=t.code,this.path=t.path,this.issues=t.issues,this.diagnostics=t.diagnostics}}function u(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function z(e){return u(e)?["rows","pages","cells"].every(t=>typeof e[t]=="number"&&Number.isSafeInteger(e[t])&&e[t]>=0)&&typeof e.durationMs=="number"&&Number.isFinite(e.durationMs)&&e.durationMs>=0:!1}function C(e){return Array.isArray(e)&&e.every(t=>u(t)&&typeof t.code=="string"&&typeof t.message=="string"&&["info","warning","error"].includes(t.severity))}function J(e){return u(e)&&Object.values(e).every(t=>u(t)&&(t.revision===void 0||typeof t.revision=="string")&&(t.sourceToken===void 0||typeof t.sourceToken=="string"))}function L(e,t){if(!u(e)||!z(e.stats)||!C(e.diagnostics)||!J(e.revisions))return!1;if(t==="prepare")return F(e.plan).ok;const r=e.format==="pdf"?"application/pdf":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";return e.bytes instanceof Uint8Array&&(e.format==="pdf"||e.format==="xlsx")&&e.contentType===r}function N(e){if(!e||typeof e!="object")return{message:String(e)};const t={};for(const r of["code","path","field","message"]){const o=e[r];typeof o=="string"&&(t[r]=o)}return t}function U(e){const t=N(e);if(!u(e))return t;for(const r of["format","severity","kind","nid"])typeof e[r]=="string"&&(t[r]=e[r]);for(const r of["pageIndex","componentIndex"])Number.isSafeInteger(e[r])&&e[r]>=0&&(t[r]=e[r]);return Array.isArray(e.componentPath)&&e.componentPath.every(r=>Number.isSafeInteger(r)&&r>=0)&&(t.componentPath=e.componentPath),t}function q(e){if(!(e instanceof Error))return{name:"Error",message:String(e)};const t=e;return{name:e.name,message:e.message,...typeof t.code=="string"?{code:t.code}:{},...typeof t.path=="string"?{path:t.path}:{},...Array.isArray(t.issues)?{issues:t.issues.map(N)}:{},...Array.isArray(t.diagnostics)?{diagnostics:t.diagnostics.map(U)}:{}}}function B(e){if(!e||typeof e!="object")return!1;const t=e;return t.protocol===l&&typeof t.id=="string"&&(t.operation==="prepare"||t.operation==="export")&&!!t.input&&typeof t.input=="object"}async function G(e,t,r){try{const o=t.operation==="prepare"?await e.prepare({...t.input,onEvent:r}):await e.export({...t.input,onEvent:r});return{protocol:l,id:t.id,result:o}}catch(o){return{protocol:l,id:t.id,error:q(o)}}}function H(e){const t=e.result;return!t||!("bytes"in t)||!(t.bytes.buffer instanceof ArrayBuffer)?[]:[t.bytes.buffer]}function Q(e,t){if(!u(e)||typeof e.taskId!="string"||!e.taskId||t.taskId!==void 0&&e.taskId!==t.taskId||e.correlationId!==t.correlationId||e.reportId!==void 0&&(typeof e.reportId!="string"||!t.reportIds.includes(e.reportId))||!["query","validate","layout","encode"].includes(e.stage)||!["started","completed","failed"].includes(e.status))return!1;for(const r of["completed","total"])if(e[r]!==void 0&&(typeof e[r]!="number"||!Number.isFinite(e[r])||e[r]<0))return!1;return e.completed===void 0||e.total===void 0||e.completed<=e.total}let V=0;function M(e){const t=new Error("报表 Worker 任务已取消");return t.name="AbortError",Object.defineProperty(t,"cause",{value:e}),t}function X(e,t){if(!e||typeof e!="object")return;const r=e;return r.protocol===l&&r.id===t?r:void 0}function Y(e,t={}){const r=t.timeoutMs??12e4;if(!Number.isFinite(r)||r<=0||r>2147483647)throw new RangeError("Worker timeoutMs 应为正有限数字，且不能超过 2147483647");const o=(s,n,i,c)=>i?.aborted?Promise.reject(M(i.reason)):new Promise((m,g)=>{let y;try{y=e()}catch(f){g(f);return}const b=`mach-report-${Date.now()}-${++V}`;let $=!1,k=()=>{},w;const p=(f,a)=>{$||($=!0,w&&clearTimeout(w),k(),i?.removeEventListener("abort",A),Promise.resolve().then(()=>y.terminate()).then(()=>f===void 0?m(a):g(f),h=>g(f??h)))},A=()=>p(M(i?.reason)),W=f=>{const a=X(f,b);if(!(!a||$)){if("type"in a&&a.type==="event"){const h="event"in a?a.event:void 0;Q(h,n)?P(c,h,i):p(new Error("报表 Worker 返回无效阶段事件"));return}a.error&&typeof a.error.name=="string"&&typeof a.error.message=="string"?p(new E(a.error)):L(a.result,s)&&(s!=="export"||"format"in a.result&&"format"in n&&a.result.format===n.format)?p(void 0,a.result):p(new Error("报表 Worker 返回无效响应"))}};try{if(k=y.subscribe(W,f=>p(f??new Error("报表 Worker 执行失败"))),$){k();return}if(i?.addEventListener("abort",A,{once:!0}),w=setTimeout(()=>p(new E({name:"ReportRuntimeError",code:"timeout",message:`报表 Worker 执行超过 ${r}ms`})),r),i?.aborted)A();else{const{onEvent:f,signal:a,...h}=n;y.postMessage({protocol:l,id:b,operation:s,input:h})}}catch(f){p(f)}});return{prepare:(s,n,i)=>o("prepare",s,n,i),export:(s,n,i)=>o("export",s,n,i)}}function Z(e){const t=e.filename??e.workerUrl;if(!t||e.filename&&e.workerUrl)throw new TypeError("请且仅请指定 filename 或 workerUrl");return Y(()=>{const r=new R.Worker(t,e.workerOptions);return{postMessage:o=>r.postMessage(o),terminate:()=>r.terminate(),subscribe:(o,s)=>{const n=i=>s(new Error(`报表 Worker 在响应前退出（code ${i}）`));return r.on("message",o),r.on("error",s),r.on("messageerror",s),r.on("exit",n),()=>{r.off("message",o),r.off("error",s),r.off("messageerror",s),r.off("exit",n)}}}},e)}function ee(e){const t=R.parentPort;if(!t)throw new Error("serveNodeReportWorker 只能在 worker_threads 中调用");const r=o=>{B(o)&&G(e,o,s=>t.postMessage({protocol:l,id:o.id,type:"event",event:s})).then(s=>t.postMessage(s,H(s)))};return t.on("message",r),()=>t.off("message",r)}exports.ReportWorkerError=E;exports.createNodeReportExecutor=Z;exports.serveNodeReportWorker=ee;

package/dist/server-node.js

@@ -0,0 +1,303 @@
+import { parentPort as W, Worker as P } from "node:worker_threads";
+function T(e, t, r) {
+  if (!r?.aborted)
+    try {
+      const o = e?.({ ...t });
+      o && typeof o.then == "function" && Promise.resolve(o).catch(() => {
+      });
+    } catch {
+    }
+}
+function v(e, t, r) {
+  e.editable !== void 0 && typeof e.editable != "boolean" && r.push({ path: `${t}.editable`, message: "编辑控制应为布尔值" }), e.valueType !== void 0 && !["text", "number", "boolean"].includes(e.valueType) && r.push({ path: `${t}.valueType`, message: "编辑类型应为 text、number 或 boolean" });
+}
+function O(e, t, r) {
+  v(e, t, r), x(e.source, `${t}.source`, r, !0), e.formula !== void 0 && typeof e.formula != "string" && r.push({ path: `${t}.formula`, message: "单元格公式应为字符串" });
+}
+function x(e, t, r, o = !1) {
+  if (e === void 0) return;
+  if (!e || typeof e != "object" || Array.isArray(e)) {
+    r.push({ path: t, message: "业务来源应为对象" });
+    return;
+  }
+  const s = e;
+  for (const n of ["datasetId", ...o ? ["field"] : []])
+    (typeof s[n] != "string" || !s[n].trim()) && r.push({ path: `${t}.${n}`, message: "业务标识应为非空字符串" });
+  for (const n of ["rowKey", "revision"]) {
+    const i = s[n];
+    i === void 0 && !(o && n === "rowKey") || typeof i != "string" && !(typeof i == "number" && Number.isFinite(i)) && r.push({ path: `${t}.${n}`, message: "业务键及修订号应为字符串或有限数字" });
+  }
+  s.sourceToken !== void 0 && typeof s.sourceToken != "string" && r.push({ path: `${t}.sourceToken`, message: "来源令牌应为字符串" });
+}
+const S = /* @__PURE__ */ new Set([
+  "text",
+  "image",
+  "barcode",
+  "qrcode",
+  "chart",
+  "line",
+  "rect",
+  "ellipse"
+]);
+function d(e) {
+  return typeof e == "object" && e !== null && !Array.isArray(e);
+}
+function j(e, t, r, o) {
+  const s = e[t];
+  (typeof s != "number" || !Number.isFinite(s)) && o.push({ path: `${r}.${t}`, message: `应为有限数字，实际 ${JSON.stringify(s)}` });
+}
+function K(e, t, r) {
+  if (e !== void 0) {
+    const o = `${t}.table`;
+    if (!d(e)) r.push({ path: o, message: "逻辑表来源应为对象" });
+    else {
+      x(e.source, `${o}.source`, r), (typeof e.id != "string" || !e.id.trim()) && r.push({ path: `${o}.id`, message: "逻辑表 ID 应为非空字符串" });
+      const s = e.role;
+      ["header", "body", "group-header", "subtotal", "grand-total"].includes(s) || r.push({ path: `${o}.role`, message: "未知逻辑表行角色" });
+      const n = e.rowIndex;
+      (typeof n != "number" || !Number.isInteger(n) || (s === "header" ? n !== -1 : n < 0)) && r.push({ path: `${o}.rowIndex`, message: "表头索引应为 -1，内容行索引应为非负整数" }), (!Array.isArray(e.columnKeys) || e.columnKeys.some((i) => typeof i != "string")) && r.push({ path: `${o}.columnKeys`, message: "逻辑列字段应为字符串数组" }), e.layout !== void 0 && e.layout !== "page" && e.layout !== "wide" && r.push({ path: `${o}.layout`, message: "布局应为 page 或 wide" }), e.title !== void 0 && typeof e.title != "string" && r.push({ path: `${o}.title`, message: "逻辑表名称应为字符串" });
+    }
+  }
+}
+function D(e, t, r, o) {
+  if (e !== void 0)
+    if (!d(e) || !Array.isArray(e.cells))
+      r.push({ path: `${t}.grid.cells`, message: "grid.cells 应为二维数组" });
+    else {
+      const s = e.paddingMm;
+      s !== void 0 && (typeof s != "number" || !Number.isFinite(s) || s < 0) && r.push({ path: `${t}.grid.paddingMm`, message: "单元格内距应为有限非负数" }), e.cells.forEach((n, i) => {
+        if (!Array.isArray(n)) {
+          r.push({ path: `${t}.grid.cells.${i}`, message: "行应为数组" });
+          return;
+        }
+        n.forEach((c, m) => {
+          if (c == null) return;
+          const g = `${t}.grid.cells.${i}.${m}`;
+          if (!d(c)) {
+            r.push({ path: g, message: "网格单元格应为对象或 null" });
+            return;
+          }
+          O(c, g, r), Array.isArray(c.children) && c.children.forEach((y, $) => {
+            I(y, `${t}.grid.cells.${i}.${m}.children.${$}`, r, o);
+          });
+        });
+      });
+    }
+}
+function F(e, t, r) {
+  e !== void 0 && (Array.isArray(e) ? e.forEach((o, s) => {
+    (!d(o) || !Array.isArray(o.segments)) && r.push({ path: `${t}.richParagraphs.${s}`, message: "段落缺少 segments 数组" });
+  }) : r.push({ path: `${t}.richParagraphs`, message: "richParagraphs 应为数组" }));
+}
+function I(e, t, r, o = []) {
+  if (!d(e)) {
+    r.push({ path: t, message: "组件应为对象" });
+    return;
+  }
+  const s = e.kind;
+  typeof s != "string" ? r.push({ path: `${t}.kind`, message: "组件缺少 kind 字符串" }) : S.has(s) || o.push({
+    path: `${t}.kind`,
+    message: `未知组件类型 ${JSON.stringify(s)}，将以兜底方式渲染`
+  });
+  for (const n of ["leftMm", "topMm", "widthMm", "heightMm"])
+    j(e, n, t, r);
+  typeof e.leftMm == "number" && e.leftMm < -100 && r.push({ path: `${t}.leftMm`, message: "几何数值异常（leftMm<-100）" });
+  for (const n of ["widthMm", "heightMm"])
+    typeof e[n] == "number" && e[n] < 0 && r.push({ path: `${t}.${n}`, message: "组件尺寸不能为负数" });
+  K(e.table, t, r), e.lineDirection !== void 0 && !["down", "up"].includes(e.lineDirection) && r.push({ path: `${t}.lineDirection`, message: "线段方向应为 down 或 up" }), D(e.grid, t, r, o), F(e.richParagraphs, t, r);
+}
+function _(e, t, r, o = []) {
+  if (!d(e)) {
+    r.push({ path: t, message: "页应为对象" });
+    return;
+  }
+  const s = e.pageWidthMm, n = e.pageHeightMm;
+  (typeof s != "number" || !Number.isFinite(s) || s <= 0) && r.push({ path: `${t}.pageWidthMm`, message: `页宽非法: ${JSON.stringify(s)}` }), (typeof n != "number" || !(n > 0 && n < 5e3)) && r.push({ path: `${t}.pageHeightMm`, message: `页高非法: ${JSON.stringify(n)}` }), e.layout !== void 0 && e.layout !== "page" && e.layout !== "wide" && r.push({ path: `${t}.layout`, message: "布局应为 page 或 wide" });
+  const i = e.components;
+  Array.isArray(i) ? Array.isArray(i) && i.forEach(
+    (c, m) => I(c, `${t}.components.${m}`, r, o)
+  ) : r.push({ path: `${t}.components`, message: "components 应为数组" });
+}
+function z(e) {
+  const t = [], r = [], o = d(e) ? e.pages : void 0;
+  if (!Array.isArray(o))
+    t.push({
+      path: "$.pages",
+      message: e == null ? "渲染计划为空" : "渲染计划缺少 pages 数组"
+    });
+  else {
+    o.forEach((n, i) => _(n, `$.pages.${i}`, t, r)), o.length > 2e3 && r.push({
+      path: "$.pages",
+      message: `页数异常大（${o.length} 页），渲染与打印耗时可能显著增加`
+    });
+    const s = o.reduce(
+      (n, i) => n + (d(i) && Array.isArray(i.components) ? i.components.length : 0),
+      0
+    );
+    s > 5e4 && r.push({
+      path: "$.pages",
+      message: `组件总数异常大（${s} 个），可能触发浏览器性能限制`
+    });
+  }
+  return { ok: t.length === 0, errors: t, warnings: r };
+}
+const l = "mach-report-worker/1";
+class E extends Error {
+  constructor(t) {
+    super(t.message), this.name = t.name, this.code = t.code, this.path = t.path, this.issues = t.issues, this.diagnostics = t.diagnostics;
+  }
+}
+function u(e) {
+  return !!e && typeof e == "object" && !Array.isArray(e);
+}
+function C(e) {
+  return u(e) ? ["rows", "pages", "cells"].every((t) => typeof e[t] == "number" && Number.isSafeInteger(e[t]) && e[t] >= 0) && typeof e.durationMs == "number" && Number.isFinite(e.durationMs) && e.durationMs >= 0 : !1;
+}
+function J(e) {
+  return Array.isArray(e) && e.every((t) => u(t) && typeof t.code == "string" && typeof t.message == "string" && ["info", "warning", "error"].includes(t.severity));
+}
+function L(e) {
+  return u(e) && Object.values(e).every((t) => u(t) && (t.revision === void 0 || typeof t.revision == "string") && (t.sourceToken === void 0 || typeof t.sourceToken == "string"));
+}
+function U(e, t) {
+  if (!u(e) || !C(e.stats) || !J(e.diagnostics) || !L(e.revisions)) return !1;
+  if (t === "prepare") return z(e.plan).ok;
+  const r = e.format === "pdf" ? "application/pdf" : "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+  return e.bytes instanceof Uint8Array && (e.format === "pdf" || e.format === "xlsx") && e.contentType === r;
+}
+function R(e) {
+  if (!e || typeof e != "object") return { message: String(e) };
+  const t = {};
+  for (const r of ["code", "path", "field", "message"]) {
+    const o = e[r];
+    typeof o == "string" && (t[r] = o);
+  }
+  return t;
+}
+function q(e) {
+  const t = R(e);
+  if (!u(e)) return t;
+  for (const r of ["format", "severity", "kind", "nid"]) typeof e[r] == "string" && (t[r] = e[r]);
+  for (const r of ["pageIndex", "componentIndex"]) Number.isSafeInteger(e[r]) && e[r] >= 0 && (t[r] = e[r]);
+  return Array.isArray(e.componentPath) && e.componentPath.every((r) => Number.isSafeInteger(r) && r >= 0) && (t.componentPath = e.componentPath), t;
+}
+function B(e) {
+  if (!(e instanceof Error)) return { name: "Error", message: String(e) };
+  const t = e;
+  return {
+    name: e.name,
+    message: e.message,
+    ...typeof t.code == "string" ? { code: t.code } : {},
+    ...typeof t.path == "string" ? { path: t.path } : {},
+    ...Array.isArray(t.issues) ? { issues: t.issues.map(R) } : {},
+    ...Array.isArray(t.diagnostics) ? { diagnostics: t.diagnostics.map(q) } : {}
+  };
+}
+function G(e) {
+  if (!e || typeof e != "object") return !1;
+  const t = e;
+  return t.protocol === l && typeof t.id == "string" && (t.operation === "prepare" || t.operation === "export") && !!t.input && typeof t.input == "object";
+}
+async function H(e, t, r) {
+  try {
+    const o = t.operation === "prepare" ? await e.prepare({ ...t.input, onEvent: r }) : await e.export({ ...t.input, onEvent: r });
+    return { protocol: l, id: t.id, result: o };
+  } catch (o) {
+    return { protocol: l, id: t.id, error: B(o) };
+  }
+}
+function Q(e) {
+  const t = e.result;
+  return !t || !("bytes" in t) || !(t.bytes.buffer instanceof ArrayBuffer) ? [] : [t.bytes.buffer];
+}
+function V(e, t) {
+  if (!u(e) || typeof e.taskId != "string" || !e.taskId || t.taskId !== void 0 && e.taskId !== t.taskId || e.correlationId !== t.correlationId || e.reportId !== void 0 && (typeof e.reportId != "string" || !t.reportIds.includes(e.reportId)) || !["query", "validate", "layout", "encode"].includes(e.stage) || !["started", "completed", "failed"].includes(e.status)) return !1;
+  for (const r of ["completed", "total"]) if (e[r] !== void 0 && (typeof e[r] != "number" || !Number.isFinite(e[r]) || e[r] < 0)) return !1;
+  return e.completed === void 0 || e.total === void 0 || e.completed <= e.total;
+}
+let X = 0;
+function M(e) {
+  const t = new Error("报表 Worker 任务已取消");
+  return t.name = "AbortError", Object.defineProperty(t, "cause", { value: e }), t;
+}
+function Y(e, t) {
+  if (!e || typeof e != "object") return;
+  const r = e;
+  return r.protocol === l && r.id === t ? r : void 0;
+}
+function Z(e, t = {}) {
+  const r = t.timeoutMs ?? 12e4;
+  if (!Number.isFinite(r) || r <= 0 || r > 2147483647) throw new RangeError("Worker timeoutMs 应为正有限数字，且不能超过 2147483647");
+  const o = (s, n, i, c) => i?.aborted ? Promise.reject(M(i.reason)) : new Promise((m, g) => {
+    let y;
+    try {
+      y = e();
+    } catch (f) {
+      g(f);
+      return;
+    }
+    const $ = `mach-report-${Date.now()}-${++X}`;
+    let b = !1, k = () => {
+    }, w;
+    const p = (f, a) => {
+      b || (b = !0, w && clearTimeout(w), k(), i?.removeEventListener("abort", A), Promise.resolve().then(() => y.terminate()).then(
+        () => f === void 0 ? m(a) : g(f),
+        (h) => g(f ?? h)
+      ));
+    }, A = () => p(M(i?.reason)), N = (f) => {
+      const a = Y(f, $);
+      if (!(!a || b)) {
+        if ("type" in a && a.type === "event") {
+          const h = "event" in a ? a.event : void 0;
+          V(h, n) ? T(c, h, i) : p(new Error("报表 Worker 返回无效阶段事件"));
+          return;
+        }
+        a.error && typeof a.error.name == "string" && typeof a.error.message == "string" ? p(new E(a.error)) : U(a.result, s) && (s !== "export" || "format" in a.result && "format" in n && a.result.format === n.format) ? p(void 0, a.result) : p(new Error("报表 Worker 返回无效响应"));
+      }
+    };
+    try {
+      if (k = y.subscribe(N, (f) => p(f ?? new Error("报表 Worker 执行失败"))), b) {
+        k();
+        return;
+      }
+      if (i?.addEventListener("abort", A, { once: !0 }), w = setTimeout(() => p(new E({ name: "ReportRuntimeError", code: "timeout", message: `报表 Worker 执行超过 ${r}ms` })), r), i?.aborted) A();
+      else {
+        const { onEvent: f, signal: a, ...h } = n;
+        y.postMessage({ protocol: l, id: $, operation: s, input: h });
+      }
+    } catch (f) {
+      p(f);
+    }
+  });
+  return { prepare: (s, n, i) => o("prepare", s, n, i), export: (s, n, i) => o("export", s, n, i) };
+}
+function te(e) {
+  const t = e.filename ?? e.workerUrl;
+  if (!t || e.filename && e.workerUrl) throw new TypeError("请且仅请指定 filename 或 workerUrl");
+  return Z(() => {
+    const r = new P(t, e.workerOptions);
+    return {
+      postMessage: (o) => r.postMessage(o),
+      terminate: () => r.terminate(),
+      subscribe: (o, s) => {
+        const n = (i) => s(new Error(`报表 Worker 在响应前退出（code ${i}）`));
+        return r.on("message", o), r.on("error", s), r.on("messageerror", s), r.on("exit", n), () => {
+          r.off("message", o), r.off("error", s), r.off("messageerror", s), r.off("exit", n);
+        };
+      }
+    };
+  }, e);
+}
+function re(e) {
+  const t = W;
+  if (!t) throw new Error("serveNodeReportWorker 只能在 worker_threads 中调用");
+  const r = (o) => {
+    G(o) && H(e, o, (s) => t.postMessage({ protocol: l, id: o.id, type: "event", event: s })).then((s) => t.postMessage(s, Q(s)));
+  };
+  return t.on("message", r), () => t.off("message", r);
+}
+export {
+  E as ReportWorkerError,
+  te as createNodeReportExecutor,
+  re as serveNodeReportWorker
+};