@agile-team/mach-report 2.16.0 → 2.17.0

package/dist/server.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const D=require("./runtime-CBFEPKEs.cjs"),w=require("./sha256-BshdOkCC.cjs"),C=require("./json-snapshot-DknkjvxP.cjs"),p=require("./batch-z6Aw5GEY.cjs"),Y=require("./template-catalog-C2NLdrwB.cjs"),A=require("./template-registry-C62vpv4a.cjs"),B=require("./prepared-DdrjLC7L.cjs"),ee=require("./param-validation-C3HlcLLO.cjs"),te=require("./record-bindings-DUX1VMlR.cjs"),re=require("./dataset-BkRmwgeJ.cjs"),ne=require("./media-B7vnpD8k.cjs");function he(e={}){const t=e.concurrency??1,r=e.maxQueued??20;if(!Number.isSafeInteger(t)||t<1||!Number.isSafeInteger(r)||r<0)throw new w.ReportRuntimeError("budget","队列并发应为正整数，排队上限应为非负整数");const n=[],o=new Set,s=new Set;let a=!1,d=0;const c=()=>{for(;!a&&o.size<t&&n.length;)n.shift().start()};return{get active(){return o.size},get pending(){return n.length},enqueue:(l,f={})=>{if(a)throw new w.ReportRuntimeError("closed","任务队列已关闭");if(w.throwIfAborted(f.signal),o.size>=t&&n.length>=r)throw new w.ReportRuntimeError("queue-full","报表任务队列已满");const u=f.id??`report-${++d}`;if(s.has(u))throw new w.ReportRuntimeError("queue-full","任务 ID 正在执行或排队");const b=new AbortController;let m="queued",v,y,g,I;const j=new Promise((R,x)=>{g=R,I=x}),O=()=>{f.signal?.removeEventListener("abort",T),s.delete(u)},S=R=>{if(m!=="queued"&&m!=="running")return;const x=m==="queued";m="cancelled",b.abort(R);try{w.throwIfAborted(b.signal)}catch(N){I(N)}if(x){const N=n.indexOf(E);N>=0&&n.splice(N,1),O(),c()}},T=()=>S(f.signal?.reason),L=(R,x)=>{m==="running"&&(!Number.isFinite(R)||R<0||x!==void 0&&(!Number.isFinite(x)||x<R)||(v={completed:R,...x===void 0?{}:{total:x}}))},k=R=>{m!=="running"||b.signal.aborted||(y={...R,taskId:u},R.completed!==void 0&&L(R.completed,R.total),C.notifyReportTaskEvent(f.onEvent,y,b.signal))},E={cancel:S,start:()=>{m==="queued"&&(m="running",o.add(E),Promise.resolve().then(()=>(w.throwIfAborted(b.signal),l({taskId:u,signal:b.signal,reportProgress:L,onEvent:k}))).then(R=>{m==="running"&&(m="completed",g(R))},R=>{m==="running"&&(m="failed",I(R))}).finally(()=>{o.delete(E),O(),c()}))}};return s.add(u),f.signal?.addEventListener("abort",T,{once:!0}),f.signal?.aborted?S(f.signal.reason):o.size<t?E.start():n.push(E),{id:u,get status(){return m},get progress(){return v},get event(){return y},result:j,cancel:S}},close:(l={})=>{a=!0;for(const f of[...n])f.cancel(new w.ReportRuntimeError("closed","任务队列已关闭"));if(l.cancelRunning)for(const f of o)f.cancel(new w.ReportRuntimeError("closed","任务队列已关闭"))}}}function ge(e){let t,r;const n=new Promise((o,s)=>{t=o,r=s});return n.catch(()=>{}),{progress:e,promise:n,resolve:t,reject:r}}function V(e){const t=Promise.reject(e);return t.catch(()=>{}),t}function ye(e,t){let r,n,o=!0,s;function a(i){s??=i??new Error("任务心跳更新失败"),n?.reject(s),n=void 0,t(s)}function d(i){const l=Promise.resolve().then(()=>e(i?.progress)).then(()=>i?.resolve(),f=>{i?.reject(f),a(f)}).finally(()=>{r=void 0;const f=n;n=void 0,f&&s===void 0&&d(f)});r=l,l.catch(f=>{a(f)})}function c(i){if(!o)return V(new p.ReportJobError("closed","任务进度上报已结束"));if(s!==void 0)return V(s);n?n.progress=i:n=ge(i);const l=n;return r||(n=void 0,d(l)),l.promise}return{progress:c,pulse(){o&&!r&&s===void 0&&d()},async finish(){for(o=!1;r;)await r;if(s!==void 0)throw s}}}class H extends p.ReportJobError{constructor(){super("capacity","任务结果超过独立预算，请保存文件引用")}}function me(e){const t=e.concurrency??1,r=e.leaseMs??3e4,n=e.heartbeatMs??1e4,o=e.maxResultBytes??256*1024;if(![t,r,n,o].every(a=>Number.isSafeInteger(a)&&a>0)||n*2>r)throw new p.ReportJobError("input","并发、租约、心跳应为正整数，租约至少为心跳的两倍");if(n>2147483647)throw new p.ReportJobError("input","心跳间隔超过平台定时器上限（2147483647毫秒）");return{concurrency:t,leaseMs:r,heartbeatMs:n,maxResultBytes:o,now:()=>{const a=(e.now??Date.now)();if(!Number.isSafeInteger(a)||a<0)throw new p.ReportJobError("input","任务时钟应返回非负整数毫秒");return a}}}async function M(e,t,r){p.checkJobIdentity(t,r);const n=await e.read(t,r);if(!n)throw new p.ReportJobError("missing","报表任务不存在");return n}async function P(e,t,r,n=[]){const o={...t,...r,revision:t.revision+1};for(const s of n)delete o[s];if(!await e.compareAndSwap(t.scope,t.id,t.revision,o))throw new p.ReportJobError("conflict","报表任务已被其他请求更新");return p.cloneJob(o)}async function be(e,t,r,n){if(!t.trim()||t.length>128)throw new p.ReportJobError("input","workerId应为1–128位标识");for(const o of await e.store.candidates(n,100)){const s=o.cancelRequested?{...o,revision:o.revision+1,status:"cancelled",updatedAt:n}:{...o,revision:o.revision+1,status:"running",attempt:o.attempt+1,updatedAt:n,lease:{owner:t,expiresAt:n+r}};if(s.status==="cancelled"&&delete s.lease,await e.store.compareAndSwap(o.scope,o.id,o.revision,s))return s}}function U(e,t,r,n){return e.status==="running"&&e.attempt===n&&e.lease?.owner===t&&e.lease.expiresAt>r}async function ve(e,t,r,n){const{scope:o,id:s}=r,a=r.lease.owner;let d;const c=ye(async y=>{const g=await M(e.store,o,s),I=t.now();if(!U(g,a,I,r.attempt))throw new p.ReportJobError("lease","报表任务租约已失效");if(g.cancelRequested){n.abort(new p.ReportJobError("closed","任务已请求取消"));return}await P(e.store,g,{updatedAt:I,lease:{owner:a,expiresAt:I+t.leaseMs},...y?{progress:y}:{}})},y=>{d=y,n.abort(y)}),i=(y,g)=>!Number.isFinite(y)||y<0||g!==void 0&&(!Number.isFinite(g)||g<y)?Promise.reject(new p.ReportJobError("input","任务进度无效")):c.progress({completed:y,...g===void 0?{}:{total:g}}),l=setInterval(()=>{c.pulse()},t.heartbeatMs);let f,u;try{const y=Object.prototype.hasOwnProperty.call(e.handlers,r.request.kind)?e.handlers[r.request.kind]:void 0;if(!y)throw new p.ReportJobError("input","报表任务处理器未注册");if(!n.signal.aborted){const g=await y(p.cloneJob(r.request.payload),{scope:o,taskId:s,attempt:r.attempt,executionToken:JSON.stringify([o,s,r.attempt]),signal:n.signal,reportProgress:i});if(f=JSON.parse(p.serializeJobJson(g)),p.jobByteLength(f)>t.maxResultBytes)throw new H}}catch(y){u=y??new Error("报表任务执行失败")}finally{clearInterval(l),await c.finish().catch(()=>{})}const b=await M(e.store,o,s),m=t.now();if(!U(b,a,m,r.attempt))throw new p.ReportJobError("lease","任务租约已失效，迟到结果不会写回");const v={...b,updatedAt:m};delete v.lease,u??=d,b.cancelRequested||n.signal.aborted&&d===void 0?v.status="cancelled":u!==void 0?(v.status="failed",v.error={code:u instanceof H?"result-budget":u instanceof p.ReportJobError?u.code:"execution",message:u instanceof Error?u.message.slice(0,500):"报表任务执行失败"}):(v.status="completed",v.result=f);try{p.serializeJobJson(v)}catch{delete v.result,v.status="failed",v.error={code:"result-budget",message:"任务结果与请求的组合超过存储预算，请保存文件引用而非文件内容"}}return Re(e.store,b,v)}async function Re(e,t,r){try{return await P(e,t,r,["lease"])}catch(n){if(!(n instanceof p.ReportJobError)||n.code!=="capacity"||r.status!=="completed")throw n;return delete r.result,r.status="failed",r.error={code:"result-budget",message:"任务结果超过存储剩余预算，请保存文件引用而非文件内容"},P(e,t,r,["lease","result"])}}async function K(e,t,r,n){const o=await e.readTombstone?.(t,r);if(o){if(o.requestHash!==await p.jobRequestHash(n))throw new p.ReportJobError("conflict","相同任务ID不能提交不同内容（幂等保留期内）");return{scope:t,id:r,revision:o.revision,request:p.cloneJob(n),status:o.status,createdAt:o.createdAt,updatedAt:o.updatedAt,attempt:o.attempt,archived:!0}}}function Ie(e){e={...e,handlers:{...e.handlers}};const t=me(e),r=new Set,n=new Set;let o=!1,s=0;const a=(i,l)=>(p.checkJobIdentity(i,l),e.store.read(i,l));return{submit:async i=>{if(i={...i},p.checkJobIdentity(i.scope,i.id),!Object.prototype.hasOwnProperty.call(e.handlers,i.kind)||typeof e.handlers[i.kind]!="function")throw new p.ReportJobError("input","报表任务处理器未注册");const l={kind:i.kind,payload:JSON.parse(p.serializeJobJson(i.payload,{maxNodes:19e3,maxCharacters:75e4}))},f=await a(i.scope,i.id);if(f){if(p.serializeJobJson(f.request)!==p.serializeJobJson(l))throw new p.ReportJobError("conflict","相同任务ID不能提交不同内容");return f}const u=await K(e.store,i.scope,i.id,l);if(u)return u;const b=t.now(),m={scope:i.scope,id:i.id,revision:1,request:l,status:"queued",createdAt:b,updatedAt:b,attempt:0};if(!await e.store.compareAndSwap(i.scope,i.id,null,m)){const v=await a(i.scope,i.id);if(v&&p.serializeJobJson(v.request)===p.serializeJobJson(l))return v;const y=await K(e.store,i.scope,i.id,l);if(y)return y;throw new p.ReportJobError("conflict","报表任务提交发生冲突")}return p.cloneJob(m)},get:a,runNext:i=>{if(o)return Promise.reject(new p.ReportJobError("closed","报表任务服务已关闭"));if(s>=t.concurrency)return Promise.reject(new p.ReportJobError("capacity","报表任务执行槽位已满"));s++;const l=new AbortController;r.add(l);const f=(async()=>{try{const u=await be(e,i,t.leaseMs,t.now());return u?.status==="running"?await ve(e,t,u,l):u}finally{s--,r.delete(l)}})();return n.add(f),f.then(()=>n.delete(f),()=>n.delete(f)),f},get active(){return s},cancel:async(i,l)=>{const f=await M(e.store,i,l);return f.status!=="queued"&&f.status!=="running"?f:P(e.store,f,{updatedAt:t.now(),...f.status==="queued"?{status:"cancelled"}:{cancelRequested:!0}})},retry:async(i,l,f)=>{const u=await M(e.store,i,l);if(u.revision!==f||u.status!=="failed")throw new p.ReportJobError("conflict","仅可重试当前修订的失败任务");const b={...u,status:"queued",updatedAt:t.now()};return delete b.error,delete b.progress,P(e.store,u,b,["error","progress"])},prune:async i=>{if(!e.store.prune||!e.store.readTombstone)throw new p.ReportJobError("input","当前任务适配器未实现可选终态保留能力");return e.store.prune({...i,now:t.now()})},close:async()=>{o=!0;for(const i of r)i.abort(new p.ReportJobError("closed","任务服务正在关闭"));await Promise.allSettled([...n])}}}function oe(e,t){const r=e.assets,n=e[t];if(!(!r&&!n?.assetRenderers))return{...r,...n?.assetFailure===void 0?{}:{assetFailure:n.assetFailure},...n?.onDiagnostic===void 0?{}:{onDiagnostic:n.onDiagnostic},assetRenderers:{...r?.assetRenderers,...n?.assetRenderers},assetBudget:{...r?.assetBudget,...n?.assetBudget}}}function G(e,t){return!e||e.code!=="missing-image"||e.format!=="pdf"&&e.format!=="xlsx"?!1:typeof oe(t,e.format)?.assetRenderers?.[e.kind]=="function"}function Ee(e,t){const r=Y.reviewReportTemplate(e,t),n=r.issues.filter(s=>!G(s.diagnostic,t)),o=r.samples.map(s=>({...s,diagnostics:s.diagnostics.filter(a=>!G(a,t))}));return{...r,issues:n,samples:o,ok:n.every(s=>s.severity!=="error"),artifacts:[]}}async function Se(e,t,r,n,o){const s=D.createReportRuntime({reports:{sample:{template:r,datasets:e.datasets}},assets:oe(n,t),budget:{maxRows:n.maxSampleRows??1e3,maxPages:n.maxPages??100,maxCells:n.maxCells??25e4,maxOutputBytes:n.maxOutputBytes??2e7,maxDurationMs:n.maxDurationMs??3e4}});try{const{result:a,digest:d}=await w.controlled(n.signal,n.maxDurationMs??3e4,async c=>{const i=await s.export({reportIds:["sample"],params:e.params,format:t,signal:c,fidelity:n.strictOutputs?"strict":"warn",pdf:n.pdf,xlsx:n.xlsx}),l=i.diagnostics.filter(u=>u.severity!=="info");if(n.strictOutputs&&l.length)throw new Error(`Strict ${t} encoding found fidelity issues: ${l.slice(0,3).map(u=>u.message).join("; ")}`);const f=await n.digest?.(i.bytes);return w.throwIfAborted(c),await n.onArtifact?.(e.name,i),w.throwIfAborted(c),{result:i,digest:f}});o.artifacts.push({fixture:e.name,format:t,bytes:a.bytes.byteLength,pages:a.stats.pages,...d?{digest:d}:{}}),o.issues.push(...a.diagnostics.map(c=>({code:"output",severity:n.strictOutputs||c.severity==="error"?"error":"warning",path:"$.template",fixture:e.name,message:`${t}: ${c.message}`})))}catch(a){w.throwIfAborted(n.signal),o.issues.push({code:"output",severity:"error",path:"$.template",fixture:e.name,message:`${t}: ${a instanceof Error?a.message:String(a)}`})}}async function xe(e,t={}){w.throwIfAborted(t.signal);const r=Ee(e,t);if(!r.ok)return r;const n=A.parseReportTemplate(e).template,o=[...new Set(t.formats??["pdf","xlsx"])];if(!o.length||o.some(s=>s!=="pdf"&&s!=="xlsx"))return r.issues.push({code:"output",severity:"error",path:"$.formats",message:"真实文件验收应至少选择PDF/XLSX之一"}),r.ok=!1,r;for(const s of t.fixtures??[])for(const a of o)w.throwIfAborted(t.signal),!(a!=="pdf"&&a!=="xlsx")&&await Se(s,a,n,t,r);return r.ok=r.issues.every(s=>s.severity!=="error"),r}class h extends Error{constructor(t,r){super(r),this.code=t,this.name="ReportInstanceError"}}function J(e,t){if(typeof e!="string"||!e.trim()||e.length>256||typeof t!="string"||t!==t.trim()||!/^[a-zA-Z0-9][a-zA-Z0-9_.:-]{0,127}$/.test(t))throw new h("input","实例范围应非空，ID 应为安全标识")}function Ae(e,t){const r=Object.getPrototypeOf(e);if(r!==(t?Array.prototype:Object.prototype)&&!(r===null&&!t)||Object.getOwnPropertySymbols(e).length)throw new h("input","实例应为普通 JSON 对象");if(t&&Object.keys(e).some(o=>o!==String(Number(o))||!Number.isSafeInteger(Number(o))||Number(o)<0||Number(o)>=e.length))throw new h("input","实例数组不能包含额外属性");if(Object.getOwnPropertyNames(e).filter(o=>!(t&&o==="length")).length!==Object.keys(e).length)throw new h("input","实例不能包含不可枚举属性")}function ke(e){if(!Number.isSafeInteger(e.revision)||e.revision<1||typeof e.title!="string"||!e.title.trim()||e.title.length>512)throw new h("input","实例修订或标题无效");if(typeof e.generatedAt!="string"||!Number.isFinite(Date.parse(e.generatedAt))||new Date(e.generatedAt).toISOString()!==e.generatedAt)throw new h("input","实例生成时间应为 ISO UTC 字符串");if(!Array.isArray(e.reportIds)||!e.reportIds.length||e.reportIds.length>100||e.reportIds.some(t=>typeof t!="string"||!t.trim())||new Set(e.reportIds).size!==e.reportIds.length)throw new h("input","实例报表 ID 应非空且唯一")}function Je(e){return e===null||typeof e=="boolean"||typeof e=="string"||typeof e=="number"&&Number.isFinite(e)}function se(e,t){if(!Number.isSafeInteger(t)||t<1)throw new h("input","实例快照字节预算应为正安全整数");let r=0,n=0;const o=new Set;function s(d,c){if(++r>1e6||c>64)throw new h("capacity","实例节点或嵌套深度超过预算");if(typeof d=="string"&&(n+=d.length,n>t))throw new h("capacity","实例文本超过预算");if(Je(d))return d;if(!d||typeof d!="object"||o.has(d))throw new h("input","实例只允许无循环的有限 JSON 值");const i=Array.isArray(d);Ae(d,i),o.add(d);const l=Object.create(null);for(const f of Object.keys(d)){if(n+=f.length,n>t)throw new h("capacity","实例文本超过预算");const u=Object.getOwnPropertyDescriptor(d,f);if(u.get||u.set||["__proto__","constructor","prototype"].includes(f))throw new h("input","实例不能包含访问器或危险键");u.value!==void 0&&(l[f]=s(u.value,c+1))}if(o.delete(d),i){if(Object.keys(l).length!==d.length)throw new h("input","实例数组不能稀疏或包含额外属性");return Array.from({length:d.length},(f,u)=>l[String(u)])}return l}const a=JSON.stringify(s(e,0));if(new TextEncoder().encode(a).byteLength>t)throw new h("capacity","实例快照超过单条字节预算");return a}function z(e,t=8e6){const r=JSON.parse(se(e,t));J(r.scope,r.id);const n=new Set(["scope","id","revision","title","generatedAt","reportIds","params","templateRevisions","sourceRevisions","plan","artifacts","output"]);if(Object.keys(r).some(s=>!n.has(s)))throw new h("input","实例包含未知字段");ke(r);for(const s of[r.params,r.templateRevisions,r.sourceRevisions])if(!s||typeof s!="object"||Array.isArray(s)||Object.values(s).some(a=>typeof a!="string"))throw new h("input","实例参数和修订应为字符串字典");if(r.reportIds.some(s=>!r.templateRevisions[s]))throw new h("input","每张报表都应记录生成时的模板修订");const o=A.validateRenderPlan(r.plan);if(!o.ok)throw new h("input",`实例渲染计划无效：${o.errors[0]?.path}`);if(r.output!==void 0){if(!r.output||Object.keys(r.output).some(s=>!["stats","diagnostics","layout","sources"].includes(s)))throw new h("input","实例输出元数据只允许统计、诊断和字体度量；不保存来源令牌");if(B.validatePreparedMetadata({...r.output,plan:r.plan,revisions:{}}),r.output.sources?.some(s=>"sourceToken"in s))throw new h("input","实例来源清单不保存来源令牌")}return r.artifacts!==void 0&&Oe(r.artifacts),r}function Oe(e){if(!Array.isArray(e)||e.length>100)throw new h("input","实例文件列表无效");const t=new Set;for(const r of e){if(!r||typeof r.key!="string"||!r.key.trim()||r.key.length>1024||t.has(r.key)||!["pdf","xlsx"].includes(r.format)||!Number.isSafeInteger(r.bytes)||r.bytes<0||r.sha256!==void 0&&(typeof r.sha256!="string"||r.sha256.length!==64||!/^[a-f0-9]{64}$/i.test(r.sha256)))throw new h("input","实例文件应包含唯一存储键、格式、大小和可选 SHA256");t.add(r.key)}}function ae(e){const{scope:t,id:r,revision:n,title:o,generatedAt:s,reportIds:a,params:d,templateRevisions:c,sourceRevisions:i}=e;return JSON.parse(JSON.stringify({scope:t,id:r,revision:n,title:o,generatedAt:s,reportIds:a,params:d,templateRevisions:c,sourceRevisions:i}))}function Te(e){const t={maxInstances:100,maxRevisions:20,maxBytes:64e6,maxSnapshotBytes:8e6,...e};if(Object.values(t).some(r=>!Number.isSafeInteger(r)||r<1))throw new h("input","实例存储预算应为正安全整数");return t}function Pe(e={}){const t=Te(e),r=new Map;let n=0;return{read:async(o,s,a,d)=>{w.throwIfAborted(d),J(o,s);const c=r.get(JSON.stringify([o,s])),i=c?.get(a??c.size);return i?z(i,t.maxSnapshotBytes):void 0},list:async(o,s={})=>{w.throwIfAborted(s.signal),J(o,"list");const a=s.limit??25;if(!Number.isSafeInteger(a)||a<1||a>100)throw new h("input","实例每页数量应为 1–100");const d=Array.from(r.values(),c=>c.get(c.size)).filter(c=>c.scope===o&&(!s.after||c.id>s.after)&&(!s.reportId||c.reportIds.includes(s.reportId))).sort((c,i)=>c.id<i.id?-1:1).slice(0,a+1);return{items:d.slice(0,a).map(ae),...d.length>a?{next:d[a-1].id}:{}}},compareAndSwap:async(o,s,a,d,c)=>{w.throwIfAborted(c),J(o,s);const i=z(d,t.maxSnapshotBytes);if(i.scope!==o||i.id!==s||i.revision!==(a??0)+1)throw new h("input","实例身份或修订不一致");const l=JSON.stringify([o,s]),f=r.get(l)??new Map;if((f.size||null)!==a)return!1;const u=new TextEncoder().encode(JSON.stringify(i)).byteLength;if(f.size>=t.maxRevisions||n+u>t.maxBytes||!f.size&&r.size>=t.maxInstances)throw new h("capacity","实例存储达到预算，请使用持久化归档策略或显式调整容量");return f.set(i.revision,i),r.set(l,f),n+=u,!0}}}function ie(e,t={}){const r=t.maxSnapshotBytes??8e6;if(!Number.isSafeInteger(r)||r<1)throw new h("input","实例快照字节预算应为正安全整数");return{read:e.read.bind(e),list:e.list.bind(e),save:async(n,o)=>{const s=o.expectedRevision;if(s!==null&&(!Number.isSafeInteger(s)||s<1||s>=Number.MAX_SAFE_INTEGER))throw new h("input","实例预期修订无效");const a=JSON.parse(se(n,r)),d=z({...a,revision:(s??0)+1},r);if(w.throwIfAborted(o.signal),!await e.compareAndSwap(d.scope,d.id,s,d,o.signal))throw new h("conflict","实例已存在或已变化，请显式确认修订后保存");return d}}}function je(e,t){return p.serializeJobJson({reportIds:e,params:t})}function Ne(e){if(!e||typeof e!="object"||Object.getOwnPropertySymbols(e).length)throw new h("input","生成请求应为普通对象");const t=Object.create(null);let r;const n=new Set(["scope","id","title","reportIds","params","expectedRevision","signal"]);for(const o of Object.getOwnPropertyNames(e)){const s=Object.getOwnPropertyDescriptor(e,o);if(!n.has(o)||!s.enumerable||s.get||s.set)throw new h("input","生成请求不能包含未知字段或访问器");o==="signal"?r=s.value:s.value!==void 0&&(t[o]=s.value)}return{signal:r,request:JSON.parse(p.serializeJobJson(t))}}function ce(e){const t=JSON.parse(p.serializeJobJson(e.templateRevisions)),r=B.snapshotPdfFonts(e.pdf),n=ie(e.instances,{maxSnapshotBytes:e.maxSnapshotBytes});return{async generate(o){const{signal:s,request:a}=Ne(o);if(J(a.scope,a.id),a.expectedRevision!==null&&(!Number.isSafeInteger(a.expectedRevision)||a.expectedRevision<1))throw new h("input","实例预期修订无效");const d=e.runtime.validate(a);if(!d.ok)throw new ee.ReportParamValidationError(d.issues);const c=Object.create(null);for(const g of a.reportIds){if(typeof t[g]!="string"||!t[g])throw new TypeError(`报表 ${g} 缺少生成时的模板修订`);c[g]=t[g]}if(w.throwIfAborted(s),((await e.instances.read(a.scope,a.id,void 0,s))?.revision??null)!==a.expectedRevision)throw new h("conflict","实例已存在或已变化，请显式确认修订后生成");const l=await e.runtime.prepare({reportIds:a.reportIds,params:d.values,pdf:r,signal:s});w.throwIfAborted(s);const f=Object.create(null);for(const[g,I]of Object.entries(l.revisions))I.revision!==void 0&&(f[g]=I.revision);const{plan:u,revisions:b,sources:m,...v}=l,y={...v,...m?{sources:m.map(({sourceToken:g,...I})=>I)}:{}};return n.save({scope:a.scope,id:a.id,title:a.title,reportIds:a.reportIds,params:d.values,templateRevisions:c,sourceRevisions:f,generatedAt:(e.now?.()??new Date).toISOString(),plan:u,output:y},{expectedRevision:a.expectedRevision,signal:s})},read:n.read,list:n.list,async exportInstance(o){const{scope:s,id:a,revision:d,signal:c,format:i,fidelity:l,taskId:f,correlationId:u,onEvent:b}=o,m=B.snapshotPdfFonts(o.pdf??r),v=B.snapshotXlsxOptions(o.xlsx);J(s,a),w.throwIfAborted(c);const y=await n.read(s,a,d,c);if(!y)throw new h("input","报表实例不存在");const g={plan:y.plan,revisions:Object.fromEntries(y.reportIds.map(I=>[I,{revision:y.sourceRevisions[I]}])),diagnostics:[{code:"instance-row-count",severity:"info",message:"历史实例未保存原始取数行数；本次 rows 统计为 0，页面及单元格数由已保存计划校验。"}],stats:{rows:0,pages:y.plan.pages.length,cells:0,durationMs:0},...y.output};return e.runtime.exportPrepared({prepared:g,format:i,fidelity:l,pdf:m,xlsx:v,signal:c,taskId:f,correlationId:u,onEvent:b})},save:n.save}}function $(e,t,r){if(!Number.isSafeInteger(e)||e<1||e>t)throw new RangeError(`${r} 应为 1–${t} 的安全整数`);return e}function Q(e){if(!e||typeof e.key!="string"||!e.key.trim()||e.key.length>1024||!["pdf","xlsx"].includes(e.format)||!Number.isSafeInteger(e.bytes)||e.bytes<0||e.sha256!==void 0&&!/^[a-f0-9]{64}$/i.test(e.sha256))throw new TypeError("分批归档回执应包含存储键、格式、大小和可选 SHA256");return{key:e.key,format:e.format,bytes:e.bytes,...e.sha256?{sha256:e.sha256}:{}}}function $e(e){if(!A.validateReportTemplate(e).ok||!e.repeat)throw new TypeError("分批生成仅支持有效的逐记录固定标签模板");return JSON.parse(JSON.stringify(e))}function Be(e){const t=new Set,r=e.repeat;r.rowKey&&t.add(r.rowKey),typeof r.copies=="object"&&t.add(r.copies.field);const n=o=>{o.binding&&t.add(o.binding.field);for(const s of o.grid?.cells??[])for(const a of s)a?.children?.forEach(n)};return e.pages.forEach(o=>o.components.forEach(s=>n(s))),[...t]}function Me(e,t,r,n){if(!e||typeof e!="object"||Array.isArray(e))throw new TypeError(`标签记录 ${n} 应为对象`);const o=Object.create(null);for(const s of t){const a=te.readRecordScalar(e,s,{dataset:r,rowIndex:n});if(typeof a=="string"&&a.length>1e6)throw new w.ReportRuntimeError("budget","标签字段超过 1 MB 字符预算",`$.datasets.${r}[${n}].${s}`);a!==void 0&&(o[s]=a)}return o}function ze(e,t,r,n){const o=t.repeat;if(!o.rowKey)return;const s=te.readRecordScalar(e,o.rowKey,{rowIndex:n,dataset:o.dataset});if(!(typeof s=="string"&&s.trim()||typeof s=="number"&&Number.isFinite(s)))throw new TypeError(`标签记录 ${n} 的业务主键无效`);const a=JSON.stringify([typeof s,s]);if(r.keys.has(a))throw new TypeError(`标签记录 ${n} 的业务主键重复（包含先前批次）`);r.bytes+=a.length*2+64,r.keys.add(a)}function De(e){return Object.entries(e).reduce((t,[r,n])=>t+64+r.length*2+(typeof n=="string"?n.length*2:8),0)}function Ce(e,t){if(!t)return e;for(const r of e.plan.pages){const n=r.meta?.record;n&&typeof n=="object"&&"rowIndex"in n&&typeof n.rowIndex=="number"&&(n.rowIndex+=t)}return e}async function qe(e,t){if(!e.return)return;const r=Promise.resolve(e.return());if(t.aborted){r.catch(()=>{});return}await w.controlled(t,void 0,()=>r)}async function X(e,t,r){const n=Promise.resolve().then(()=>e.onReceipt?.(t,r));n.catch(()=>{}),await w.controlled(r.signal,void 0,()=>n)}function Le(e,t,r){return new Promise((n,o)=>{let s=!1,a=!1,d;const c=()=>{clearTimeout(d),t.removeEventListener("abort",i)},i=()=>{s||d!==void 0||(d=setTimeout(()=>{if(!s){s=!0,a=!0,c();try{w.throwIfAborted(t)}catch(l){o(l)}}},0))};e.then(l=>{if(a){Promise.resolve().then(()=>r(l)).catch(()=>{});return}s||(s=!0,c(),n(l))},l=>{s||(s=!0,c(),o(l))}),t.addEventListener("abort",i,{once:!0}),t.aborted&&i()})}async function Fe(e,t){const r=$(t.batchSize??100,1e3,"batchSize"),n=$(t.maxRows??1e5,1e6,"maxRows"),o=$(t.maxChunks??1e3,1e4,"maxChunks"),s=$(t.maxRetainedBytes??16e6,64e6,"maxRetainedBytes"),a=$e(t.template),d=Be(a);if(!e||typeof e[Symbol.asyncIterator]!="function")throw new TypeError("标签来源应为 AsyncIterable");return w.controlled(t.signal,t.runtime?.budget?.maxDurationMs??12e4,async c=>{const i={rows:0,chunks:[]},l={keys:new Set,bytes:0},f=e[Symbol.asyncIterator]();let u=!1,b=!1,m;const v=()=>m??=qe(f,c),y=()=>{u||v().catch(()=>{})};c.addEventListener("abort",y,{once:!0});try{for(;!u;){w.throwIfAborted(c);const g=[];let I=0;for(;g.length<r;){const E=await w.controlled(c,void 0,()=>Promise.resolve(f.next()));if(E.done){u=!0;break}if(i.rows+g.length>=n)throw new w.ReportRuntimeError("budget","标签来源行数超过预算","$.maxRows");if(i.chunks.length>=o)throw new w.ReportRuntimeError("budget","标签分块数量超过预算","$.maxChunks");const R=Me(E.value,d,a.repeat.dataset,i.rows+g.length);if(ze(R,a,l,i.rows+g.length),I+=De(R),l.bytes+I>s)throw new w.ReportRuntimeError("budget","标签当前块字段与全局主键索引超过内存预算","$.maxRetainedBytes");g.push(R)}if(!g.length)break;const j=D.createReportRuntime({...t.runtime,reports:{labels:{template:a,datasets:{[a.repeat.dataset]:g}}}});let O;const S={index:i.chunks.length,rowOffset:i.rows,rowCount:g.length,signal:c,export:E=>j.exportPrepared({pdf:t.pdf,...E,prepared:O,signal:c})};let T;const k=(await p.runReportBatch([{id:`labels-${S.index}`,params:{}}],async()=>{try{O=Ce(await j.prepare({reportIds:["labels"],pdf:t.pdf,signal:c}),S.rowOffset),w.throwIfAborted(c);const E=Promise.resolve(t.execute(O,S)),R=await Le(E,c,x=>X(t,Q(x),S));return Q(R)}catch(E){throw T=E,E}},{concurrency:1,signal:c,failure:"stop"}))[0];if(k.status==="cancelled")throw w.throwIfAborted(c),new Error("标签分批任务已取消");if(k.status==="failed")throw T??new Error(k.error.message);i.chunks.push({...k.value,index:S.index,rowOffset:S.rowOffset,rowCount:S.rowCount}),i.rows+=g.length,await X(t,k.value,S)}return i}catch(g){throw b=!0,g}finally{c.removeEventListener("abort",y),u||await v().catch(g=>{if(!b)throw g})}})}async function de(e,t){const r=t.document().id,n=()=>t.editor.saving||t.editor.blocked;if(n())throw new Error("草稿尚未保存，请处理设计器提示后再发布");if(t.editor.pendingLocalChanges){const s=t.successfulSaves();if(await t.editor.save(),await t.afterSave(),t.successfulSaves()===s||t.editor.pendingLocalChanges||n())throw new Error("草稿尚未保存，请处理设计器提示后再发布")}const o=t.document();if(o.id!==r)throw new h("conflict","当前模板已切换，请重新确认后发布");return e.publish(o.id,{expectedRevision:o.revision??null})}function fe(e,t){return{async search(r){w.throwIfAborted(r.signal);const n=await e.list(r.signal);if(n.length>1e3)throw new RangeError("本地模板连接目录最多 1000 项；更大目录请使用宿主分页查询适配器");const o=[];for(const s of n){w.throwIfAborted(r.signal);const[a,d]=await Promise.all([e.get(s.id,{draft:!0,signal:r.signal}),e.get(s.id,{signal:r.signal})]),c=a??d;c&&o.push({document:c,published:d,draftRevision:a?.revision,publishedRevision:d?.revision,...t?.(A.parseReportTemplate(c))})}return Y.createLocalTemplateCatalog(o).search(r)},async get(r,n){return n.mode==="published"?e.get(r,{signal:n.signal}):await e.get(r,{draft:!0,signal:n.signal})??e.get(r,{signal:n.signal})}}}function le(e=1e3){if(!Number.isSafeInteger(e)||e<1||e>1e3)throw new RangeError("本地生成意图上限应为 1–1000");const t=new Map,r=globalThis.crypto?.randomUUID?.()??`${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;return{forCase(n,o){if(![n,o].every(c=>typeof c=="string"&&c.length>0&&c.length<=256))throw new TypeError("模板与参数组标识无效");const s=JSON.stringify([n,o]),a=t.get(s);if(a)return a;if(t.size>=e)throw new RangeError("本地生成意图已达上限，请使用持久化任务服务");const d=`instance-${r}-${(t.size+1).toString(36)}`;return t.set(s,d),d}}}function _e(e,t,r){const n=Object.keys(r);return e.reportIds.length===1&&e.reportIds[0]===t.id&&Object.keys(e.templateRevisions).length===1&&e.templateRevisions[t.id]===t.revision&&Object.keys(e.params).length===n.length&&n.every(o=>r[o]===e.params[o])}function Z(e){return{instanceId:e.id,label:e.title}}function Ve(e,t,r){const n=A.parseReportTemplate(e);if(!n.revision)throw new Error("请先发布该模板");const o=typeof t.data=="function"?t.data(A.parseReportTemplate(n)):t.data,s=D.createReportRuntime({...t.runtime,reports:{[n.id]:{...o,template:n.template}}}),a=ce({runtime:s,instances:t.instances,templateRevisions:{[n.id]:n.revision},pdf:t.pdf});async function d(c,i,l){w.throwIfAborted(l);const f=await t.instances.read(t.scope,c,void 0,l);if(w.throwIfAborted(l),!!f){if(!_e(f,n,i))throw new h("conflict","此参数组已用于其他参数或发布修订，请复制为新任务生成");return Z(f)}}return{document:A.parseReportTemplate(n),async execute(c,{signal:i}){w.throwIfAborted(i);const l=s.validate({reportIds:[n.id],params:c.params});if(!l.ok)throw new Error(l.issues[0]?.message??"生成参数无效");const f=r(n.id,c.id),u=await d(f,l.values,i);if(u)return u;try{return Z(await a.generate({scope:t.scope,id:f,title:(t.title?.(A.parseReportTemplate(n),c,l.values)??`${n.name} · ${c.id}`).slice(0,512),reportIds:[n.id],params:l.values,expectedRevision:null,signal:i}))}catch(b){if(b instanceof h&&b.code==="conflict"){const m=await d(f,l.values,i);if(m)return m}throw b}}}}function He(e){e={...e};const t=le(),r=e.instanceId??t.forCase;return{catalog:e.catalog??fe(e.templates,e.catalogMetadata),publish:n=>de(e.templates,n),async batch(n,o={}){const{expectedRevision:s,signal:a}=o,d=await e.templates.get(n,{signal:a});if(w.throwIfAborted(a),!d?.revision)throw new Error("请先发布该模板");if(s!==void 0&&d.revision!==s)throw new h("conflict","模板发布版本已变化，请重新打开后生成");return Ve(d,e,r)}}}const ue="2.16.0";function q(e,t){const r=t?.componentPath;if(!Number.isSafeInteger(t?.pageIndex)||t.pageIndex<0||!Array.isArray(r)||r.length<1||r.length>31||r.length%3!==1||r.some(o=>!Number.isSafeInteger(o)||o<0))throw new TypeError("模板包图片位置无效");let n=e.template.pages[t.pageIndex]?.components[r[0]];for(let o=1;n&&o<r.length;o+=3)n=n.grid?.cells[r[o]]?.[r[o+1]]?.children?.[r[o+2]];if(!n||n.kind!=="image"||n.binding)throw new TypeError("模板包图片位置应指向静态图片组件");return n}function Ue(e){const t=["id","kind","mediaType","bytes","sha256","license","font","targets"];if(!e||Object.keys(e).some(r=>!t.includes(r)))throw new TypeError("模板资源包含未知字段");if(typeof e.id!="string"||!/^[a-zA-Z0-9][a-zA-Z0-9_.:-]{0,127}$/.test(e.id))throw new TypeError("模板资源ID应为安全标识");if(!Number.isSafeInteger(e.bytes)||e.bytes<1||e.bytes>32e6||!/^[a-f0-9]{64}$/.test(e.sha256))throw new TypeError("模板资源大小或SHA256无效");if(e.license!==void 0&&(typeof e.license!="string"||e.license.length>512))throw new TypeError("模板资源许可说明无效")}function Ke(e,t){if(Ue(e),e.kind==="font"){if(!["font/ttf","font/otf"].includes(e.mediaType)||e.targets!==void 0)throw new TypeError("字体资源类型无效");const r=e.font;if(!r||typeof r.family!="string"||!r.family.trim()||r.family.length>128||!["regular","bold","italic","boldItalic"].includes(r.face)||Object.keys(r).some(n=>!["family","face"].includes(n)))throw new TypeError("字体资源需要family和face");return}if(e.kind!=="image"||!["image/png","image/jpeg"].includes(e.mediaType)||e.font!==void 0)throw new TypeError("模板图片仅支持PNG/JPEG");if(!Array.isArray(e.targets)||!e.targets.length||e.targets.length>1e3)throw new TypeError("模板图片需要1–1000个位置");for(const r of e.targets){if(Object.keys(r).some(n=>!["pageIndex","componentPath"].includes(n)))throw new TypeError("模板图片位置包含未知字段");q(t,r)}}function Ge(e,t){const r=n=>n.every((o,s)=>e[s]===o);return t==="image/png"?r([137,80,78,71,13,10,26,10]):t==="image/jpeg"?r([255,216,255]):t==="font/otf"?r([79,84,84,79]):r([0,1,0,0])||r([116,114,117,101])}function pe(e){if(!(e instanceof Uint8Array)||!e.byteLength||e.byteLength>32e6)throw new RangeError("资源摘要只接受1–32MB字节");return w.portableSha256Hex(e)}function we(e,t,r=ne.createImageMediaInspector()){const n=new Set(t.flatMap(a=>(a.targets??[]).map(d=>q(e,d)))),o=new Map,s=a=>{if(a.imageData&&!n.has(a)){const d=r(a.imageData);o.set(d.dataUrl,d.bytes.byteLength)}for(const d of a.grid?.cells??[])for(const c of d)for(const i of c?.children??[])s(i)};for(const a of e.template.pages)for(const d of a.components)s(d);return[...o.values()].reduce((a,d)=>a+d,0)}function Qe(e,t){let r="";for(let n=0;n<e.length;n+=16384)r+=String.fromCharCode(...e.subarray(n,n+16384));return`data:${t};base64,${btoa(r)}`}async function Xe(e,t,r,n,o=3e4){if(!Number.isFinite(o)||o<1||o>2147483647)throw new RangeError("模板资源加载超时应为1–2147483647毫秒");return w.controlled(n,o,async s=>{const a=[],d=ne.createImageMediaInspector();we(e,t,d);for(const c of t){w.throwIfAborted(s);const i=await w.controlled(s,void 0,()=>Promise.resolve(r(JSON.parse(JSON.stringify(c)),{signal:s})));if(w.throwIfAborted(s),!i||!(i.bytes instanceof Uint8Array)||i.mediaType!==c.mediaType||i.bytes.byteLength!==c.bytes)throw new TypeError(`资源 ${c.id} 的类型或大小与清单不一致`);const l=new Uint8Array(i.bytes);if(!Ge(l,c.mediaType)||pe(l)!==c.sha256)throw new TypeError(`资源 ${c.id} 的文件标识或SHA256与清单不一致`);if(c.kind==="font")a.push({id:c.id,family:c.font.family,face:c.font.face,bytes:l});else{const f=d(Qe(l,c.mediaType)).dataUrl;for(const u of c.targets)q(e,u).imageData=f}}return a})}function W(e){if(typeof e!="string"||!/^(0|[1-9]\d{0,5})\.(0|[1-9]\d{0,5})\.(0|[1-9]\d{0,5})$/.test(e))throw new TypeError("模板包最低版本与运行版本应为正式版本x.y.z");return e.split(".").map(Number)}function Ze(e,t){const r=W(e),n=W(t);for(let o=0;o<3;o++){if(n[o]>r[o])return;if(n[o]<r[o])throw new Error(`模板包需要MachReport ${e}或更新版本`)}}function F(e,t,r){const n=e??t;if(!Number.isSafeInteger(n)||n<1||n>r)throw new RangeError("模板包字节预算无效");return n}function We(e){if(e.contracts!==void 0){if(!e.contracts||typeof e.contracts!="object"||Array.isArray(e.contracts)||Object.keys(e.contracts).length>100)throw new TypeError("模板包字段契约应为最多100个数据集");for(const[t,r]of Object.entries(e.contracts)){if(!t.trim()||t.length>256)throw new TypeError("模板包数据集名称无效");re.validateDatasetRows([],r)}}}function Ye(e,t){if(!e||e.deidentified!==!0||typeof e.name!="string"||!e.name.trim()||e.name.length>128)throw new TypeError("样例需要名称和明确的deidentified:true确认");if(Object.keys(e).some(n=>!["name","deidentified","datasets","params"].includes(n)))throw new TypeError("模板包样例包含未知字段");if(!e.datasets||typeof e.datasets!="object"||Array.isArray(e.datasets))throw new TypeError("模板包样例数据集无效");if(et(e,t),!ee.validateReportParams(t.document.template.params??[],e.params).ok)throw new TypeError(`样例 ${e.name} 的参数不符合模板定义`)}function et(e,t){let r=0;for(const o of Object.values(e.datasets))if(!Array.isArray(o)||o.some(s=>!s||typeof s!="object"||Array.isArray(s)))throw new TypeError("模板包样例应为对象行数组");const n=C.templateValidationDatasets(t.document.template,e.datasets,{maxRows:1e3});for(const[o,s]of Object.entries(n)){if(r+=s.length,r>1e3)throw new RangeError("模板包每个样例最多1000行");const a=t.contracts?.[o];if(a&&!re.validateDatasetRows(s,a).ok)throw new TypeError(`样例 ${e.name} 不符合 ${o} 字段契约`)}for(const o of Object.keys(t.contracts??{}))if(!Object.prototype.hasOwnProperty.call(e.datasets,o))throw new TypeError(`样例 ${e.name} 缺少 ${o} 数据集`)}function tt(e){if(e.fixtures===void 0)return;if(!Array.isArray(e.fixtures)||e.fixtures.length>20)throw new RangeError("模板包最多20个脱敏样例");const t=new Set;for(const r of e.fixtures){if(Ye(r,e),t.has(r.name))throw new TypeError("模板包样例名称重复");t.add(r.name)}}function rt(e,t){if(!Array.isArray(e.resources)||e.resources.length>64)throw new RangeError("模板包最多64个资源依赖");const r=new Set,n=new Set,o=new Set;let s=0;for(const a of e.resources){if(Ke(a,e.document),r.has(a.id))throw new TypeError("模板资源ID重复");if(r.add(a.id),s+=a.bytes,s>t)throw new RangeError("模板包资源总大小超过预算");const d=a.font&&JSON.stringify([a.font.family,a.font.face]);if(d&&o.has(d))throw new TypeError("模板包字体family/face重复");d&&o.add(d);for(const c of a.targets??[]){const i=JSON.stringify([c.pageIndex,c.componentPath]);if(n.has(i))throw new TypeError("同一图片位置不能绑定多个资源");n.add(i)}}if(s+we(e.document,e.resources)>t)throw new RangeError("模板包内嵌与外部资源总大小超过预算")}function _(e,t={}){w.throwIfAborted(t.signal);const r=F(t.maxBytes,8e6,32e6);if(typeof e=="string"){if(e.length>r||new TextEncoder().encode(e).byteLength>r)throw new RangeError("模板包JSON超过预算");e=JSON.parse(e)}const n=C.snapshotReportJson(e,{maxBytes:r,check:()=>w.throwIfAborted(t.signal),error:(o,s)=>new TypeError(s)});if(!n||typeof n!="object"||Array.isArray(n)||n.schemaVersion!=="1.0"||Object.keys(n).some(o=>!["schemaVersion","minimumVersion","document","contracts","resources","fixtures"].includes(o)))throw new TypeError("模板包结构或版本无效");return Ze(n.minimumVersion,t.runtimeVersion??ue),n.document=A.parseReportTemplate(n.document),We(n),tt(n),rt(n,F(t.maxResourceBytes,32e6,64e6)),n}function nt(e,t={}){const r=C.snapshotReportJson(e,{maxBytes:F(t.maxBytes,8e6,32e6),check:()=>w.throwIfAborted(t.signal),error:(o,s)=>new TypeError(s)}),n=_({schemaVersion:"1.0",...r,minimumVersion:r.minimumVersion??ue,resources:r.resources??[]},t);for(const o of n.resources)for(const s of o.targets??[])delete q(n.document,s).imageData;return n}async function ot(e,t){const{resolve:r,signal:n,maxDurationMs:o}=t,s=_(e,t),a=await Xe(s.document,s.resources,r,n,o);return{document:s.document,fonts:a,contracts:s.contracts,fixtures:s.fixtures??[]}}exports.createReportRuntime=D.createReportRuntime;exports.ReportRuntimeError=w.ReportRuntimeError;exports.ReportJobError=p.ReportJobError;exports.checkJobIdentity=p.checkJobIdentity;exports.cloneJob=p.cloneJob;exports.createMemoryReportJobStore=p.createMemoryReportJobStore;exports.runReportBatch=p.runReportBatch;exports.runnableJob=p.runnableJob;exports.serializeJobJson=p.serializeJobJson;exports.snapshotReportBatchCases=p.snapshotReportBatchCases;exports.validateJobRecord=p.validateJobRecord;exports.validateJobTransition=p.validateJobTransition;exports.ReportInstanceError=h;exports.checkInstanceIdentity=J;exports.createManagerTemplateCatalog=fe;exports.createMemoryReportInstanceIds=le;exports.createMemoryReportInstanceStore=Pe;exports.createReportGenerationService=ce;exports.createReportInstanceManager=ie;exports.createReportJobService=Ie;exports.createReportTaskQueue=he;exports.createReportTemplatePackage=nt;exports.createReportWorkflow=He;exports.parseReportTemplatePackage=_;exports.reportInstanceParameterKey=je;exports.reportInstanceSummary=ae;exports.reportPackageResourceDigest=pe;exports.resolveReportTemplatePackage=ot;exports.reviewReportPublication=xe;exports.runLabelStream=Fe;exports.saveAndPublishReportTemplate=de;exports.snapshotReportInstance=z;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const H=require("./runtime-dL5ygIfa.cjs"),p=require("./sha256-BshdOkCC.cjs"),C=require("./json-snapshot-D7PE1NsU.cjs"),h=require("./batch-z6Aw5GEY.cjs"),ce=require("./template-catalog-Dua8h9ZA.cjs"),O=require("./template-registry-CpysHAxy.cjs"),M=require("./prepared-Ch1x_Gog.cjs"),fe=require("./param-validation-C3HlcLLO.cjs"),de=require("./record-bindings-B86Sur_y.cjs"),ue=require("./dataset-IrlXbUvh.cjs"),le=require("./media-B7vnpD8k.cjs"),Ee=require("./component-tree-DkGLEfZC.cjs");function Ae(e={}){const t=e.concurrency??1,r=e.maxQueued??20;if(!Number.isSafeInteger(t)||t<1||!Number.isSafeInteger(r)||r<0)throw new p.ReportRuntimeError("budget","队列并发应为正整数，排队上限应为非负整数");const n=[],o=new Set,s=new Set;let a=!1,u=0;const f=()=>{for(;!a&&o.size<t&&n.length;)n.shift().start()};return{get active(){return o.size},get pending(){return n.length},enqueue:(i,d={})=>{if(a)throw new p.ReportRuntimeError("closed","任务队列已关闭");if(p.throwIfAborted(d.signal),o.size>=t&&n.length>=r)throw new p.ReportRuntimeError("queue-full","报表任务队列已满");const l=d.id??`report-${++u}`;if(s.has(l))throw new p.ReportRuntimeError("queue-full","任务 ID 正在执行或排队");const w=new AbortController;let m="queued",b,y,g,R;const P=new Promise((S,A)=>{g=S,R=A}),N=()=>{d.signal?.removeEventListener("abort",$),s.delete(l)},E=S=>{if(m!=="queued"&&m!=="running")return;const A=m==="queued";m="cancelled",w.abort(S);try{p.throwIfAborted(w.signal)}catch(q){R(q)}if(A){const q=n.indexOf(x);q>=0&&n.splice(q,1),N(),f()}},$=()=>E(d.signal?.reason),K=(S,A)=>{m==="running"&&(!Number.isFinite(S)||S<0||A!==void 0&&(!Number.isFinite(A)||A<S)||(b={completed:S,...A===void 0?{}:{total:A}}))},T=S=>{m!=="running"||w.signal.aborted||(y={...S,taskId:l},S.completed!==void 0&&K(S.completed,S.total),C.notifyReportTaskEvent(d.onEvent,y,w.signal))},x={cancel:E,start:()=>{m==="queued"&&(m="running",o.add(x),Promise.resolve().then(()=>(p.throwIfAborted(w.signal),i({taskId:l,signal:w.signal,reportProgress:K,onEvent:T}))).then(S=>{m==="running"&&(m="completed",g(S))},S=>{m==="running"&&(m="failed",R(S))}).finally(()=>{o.delete(x),N(),f()}))}};return s.add(l),d.signal?.addEventListener("abort",$,{once:!0}),d.signal?.aborted?E(d.signal.reason):o.size<t?x.start():n.push(x),{id:l,get status(){return m},get progress(){return b},get event(){return y},result:P,cancel:E}},close:(i={})=>{a=!0;for(const d of[...n])d.cancel(new p.ReportRuntimeError("closed","任务队列已关闭"));if(i.cancelRunning)for(const d of o)d.cancel(new p.ReportRuntimeError("closed","任务队列已关闭"))}}}function ke(e){let t,r;const n=new Promise((o,s)=>{t=o,r=s});return n.catch(()=>{}),{progress:e,promise:n,resolve:t,reject:r}}function Q(e){const t=Promise.reject(e);return t.catch(()=>{}),t}function Oe(e,t){let r,n,o=!0,s;function a(c){s??=c??new Error("任务心跳更新失败"),n?.reject(s),n=void 0,t(s)}function u(c){const i=Promise.resolve().then(()=>e(c?.progress)).then(()=>c?.resolve(),d=>{c?.reject(d),a(d)}).finally(()=>{r=void 0;const d=n;n=void 0,d&&s===void 0&&u(d)});r=i,i.catch(d=>{a(d)})}function f(c){if(!o)return Q(new h.ReportJobError("closed","任务进度上报已结束"));if(s!==void 0)return Q(s);n?n.progress=c:n=ke(c);const i=n;return r||(n=void 0,u(i)),i.promise}return{progress:f,pulse(){o&&!r&&s===void 0&&u()},async finish(){for(o=!1;r;)await r;if(s!==void 0)throw s}}}class W extends h.ReportJobError{constructor(){super("capacity","任务结果超过独立预算，请保存文件引用")}}function Je(e){const t=e.concurrency??1,r=e.leaseMs??3e4,n=e.heartbeatMs??1e4,o=e.maxResultBytes??256*1024;if(![t,r,n,o].every(a=>Number.isSafeInteger(a)&&a>0)||n*2>r)throw new h.ReportJobError("input","并发、租约、心跳应为正整数，租约至少为心跳的两倍");if(n>2147483647)throw new h.ReportJobError("input","心跳间隔超过平台定时器上限（2147483647毫秒）");return{concurrency:t,leaseMs:r,heartbeatMs:n,maxResultBytes:o,now:()=>{const a=(e.now??Date.now)();if(!Number.isSafeInteger(a)||a<0)throw new h.ReportJobError("input","任务时钟应返回非负整数毫秒");return a}}}async function L(e,t,r){h.checkJobIdentity(t,r);const n=await e.read(t,r);if(!n)throw new h.ReportJobError("missing","报表任务不存在");return n}async function D(e,t,r,n=[]){const o={...t,...r,revision:t.revision+1};for(const s of n)delete o[s];if(!await e.compareAndSwap(t.scope,t.id,t.revision,o))throw new h.ReportJobError("conflict","报表任务已被其他请求更新");return h.cloneJob(o)}async function Pe(e,t,r,n){if(!t.trim()||t.length>128)throw new h.ReportJobError("input","workerId应为1–128位标识");for(const o of await e.store.candidates(n,100)){const s=o.cancelRequested?{...o,revision:o.revision+1,status:"cancelled",updatedAt:n}:{...o,revision:o.revision+1,status:"running",attempt:o.attempt+1,updatedAt:n,lease:{owner:t,expiresAt:n+r}};if(s.status==="cancelled"&&delete s.lease,await e.store.compareAndSwap(o.scope,o.id,o.revision,s))return s}}function Y(e,t,r,n){return e.status==="running"&&e.attempt===n&&e.lease?.owner===t&&e.lease.expiresAt>r}async function Te(e,t,r,n){const{scope:o,id:s}=r,a=r.lease.owner;let u;const f=Oe(async y=>{const g=await L(e.store,o,s),R=t.now();if(!Y(g,a,R,r.attempt))throw new h.ReportJobError("lease","报表任务租约已失效");if(g.cancelRequested){n.abort(new h.ReportJobError("closed","任务已请求取消"));return}await D(e.store,g,{updatedAt:R,lease:{owner:a,expiresAt:R+t.leaseMs},...y?{progress:y}:{}})},y=>{u=y,n.abort(y)}),c=(y,g)=>!Number.isFinite(y)||y<0||g!==void 0&&(!Number.isFinite(g)||g<y)?Promise.reject(new h.ReportJobError("input","任务进度无效")):f.progress({completed:y,...g===void 0?{}:{total:g}}),i=setInterval(()=>{f.pulse()},t.heartbeatMs);let d,l;try{const y=Object.prototype.hasOwnProperty.call(e.handlers,r.request.kind)?e.handlers[r.request.kind]:void 0;if(!y)throw new h.ReportJobError("input","报表任务处理器未注册");if(!n.signal.aborted){const g=await y(h.cloneJob(r.request.payload),{scope:o,taskId:s,attempt:r.attempt,executionToken:JSON.stringify([o,s,r.attempt]),signal:n.signal,reportProgress:c});if(d=JSON.parse(h.serializeJobJson(g)),h.jobByteLength(d)>t.maxResultBytes)throw new W}}catch(y){l=y??new Error("报表任务执行失败")}finally{clearInterval(i),await f.finish().catch(()=>{})}const w=await L(e.store,o,s),m=t.now();if(!Y(w,a,m,r.attempt))throw new h.ReportJobError("lease","任务租约已失效，迟到结果不会写回");const b={...w,updatedAt:m};delete b.lease,l??=u,w.cancelRequested||n.signal.aborted&&u===void 0?b.status="cancelled":l!==void 0?(b.status="failed",b.error={code:l instanceof W?"result-budget":l instanceof h.ReportJobError?l.code:"execution",message:l instanceof Error?l.message.slice(0,500):"报表任务执行失败"}):(b.status="completed",b.result=d);try{h.serializeJobJson(b)}catch{delete b.result,b.status="failed",b.error={code:"result-budget",message:"任务结果与请求的组合超过存储预算，请保存文件引用而非文件内容"}}return je(e.store,w,b)}async function je(e,t,r){try{return await D(e,t,r,["lease"])}catch(n){if(!(n instanceof h.ReportJobError)||n.code!=="capacity"||r.status!=="completed")throw n;return delete r.result,r.status="failed",r.error={code:"result-budget",message:"任务结果超过存储剩余预算，请保存文件引用而非文件内容"},D(e,t,r,["lease","result"])}}async function ee(e,t,r,n){const o=await e.readTombstone?.(t,r);if(o){if(o.requestHash!==await h.jobRequestHash(n))throw new h.ReportJobError("conflict","相同任务ID不能提交不同内容（幂等保留期内）");return{scope:t,id:r,revision:o.revision,request:h.cloneJob(n),status:o.status,createdAt:o.createdAt,updatedAt:o.updatedAt,attempt:o.attempt,archived:!0}}}function Ne(e){e={...e,handlers:{...e.handlers}};const t=Je(e),r=new Set,n=new Set;let o=!1,s=0;const a=(c,i)=>(h.checkJobIdentity(c,i),e.store.read(c,i));return{submit:async c=>{if(c={...c},h.checkJobIdentity(c.scope,c.id),!Object.prototype.hasOwnProperty.call(e.handlers,c.kind)||typeof e.handlers[c.kind]!="function")throw new h.ReportJobError("input","报表任务处理器未注册");const i={kind:c.kind,payload:JSON.parse(h.serializeJobJson(c.payload,{maxNodes:19e3,maxCharacters:75e4}))},d=await a(c.scope,c.id);if(d){if(h.serializeJobJson(d.request)!==h.serializeJobJson(i))throw new h.ReportJobError("conflict","相同任务ID不能提交不同内容");return d}const l=await ee(e.store,c.scope,c.id,i);if(l)return l;const w=t.now(),m={scope:c.scope,id:c.id,revision:1,request:i,status:"queued",createdAt:w,updatedAt:w,attempt:0};if(!await e.store.compareAndSwap(c.scope,c.id,null,m)){const b=await a(c.scope,c.id);if(b&&h.serializeJobJson(b.request)===h.serializeJobJson(i))return b;const y=await ee(e.store,c.scope,c.id,i);if(y)return y;throw new h.ReportJobError("conflict","报表任务提交发生冲突")}return h.cloneJob(m)},get:a,runNext:c=>{if(o)return Promise.reject(new h.ReportJobError("closed","报表任务服务已关闭"));if(s>=t.concurrency)return Promise.reject(new h.ReportJobError("capacity","报表任务执行槽位已满"));s++;const i=new AbortController;r.add(i);const d=(async()=>{try{const l=await Pe(e,c,t.leaseMs,t.now());return l?.status==="running"?await Te(e,t,l,i):l}finally{s--,r.delete(i)}})();return n.add(d),d.then(()=>n.delete(d),()=>n.delete(d)),d},get active(){return s},cancel:async(c,i)=>{const d=await L(e.store,c,i);return d.status!=="queued"&&d.status!=="running"?d:D(e.store,d,{updatedAt:t.now(),...d.status==="queued"?{status:"cancelled"}:{cancelRequested:!0}})},retry:async(c,i,d)=>{const l=await L(e.store,c,i);if(l.revision!==d||l.status!=="failed")throw new h.ReportJobError("conflict","仅可重试当前修订的失败任务");const w={...l,status:"queued",updatedAt:t.now()};return delete w.error,delete w.progress,D(e.store,l,w,["error","progress"])},prune:async c=>{if(!e.store.prune||!e.store.readTombstone)throw new h.ReportJobError("input","当前任务适配器未实现可选终态保留能力");return e.store.prune({...c,now:t.now()})},close:async()=>{o=!0;for(const c of r)c.abort(new h.ReportJobError("closed","任务服务正在关闭"));await Promise.allSettled([...n])}}}function pe(e,t){const r=e.assets,n=e[t];if(!(!r&&!n?.assetRenderers&&!n?.assetRegistry))return{...r,...n?.assetFailure===void 0?{}:{assetFailure:n.assetFailure},...n?.onDiagnostic===void 0?{}:{onDiagnostic:n.onDiagnostic},assetRegistry:n?.assetRegistry??r?.assetRegistry,assetRenderers:{...r?.assetRenderers,...n?.assetRenderers},assetBudget:{...r?.assetBudget,...n?.assetBudget}}}function te(e,t){if(!e||e.code!=="missing-image"||e.format!=="pdf"&&e.format!=="xlsx")return!1;const r=pe(t,e.format);return typeof r?.assetRenderers?.[e.kind]=="function"||!!(e.extension&&r?.assetRegistry?.hasExtension(e.extension.id,e.extension.version,e.kind))}function Be(e,t){const r=ce.reviewReportTemplate(e,t),n=r.issues.filter(s=>!te(s.diagnostic,t)),o=r.samples.map(s=>({...s,diagnostics:s.diagnostics.filter(a=>!te(a,t))}));return{...r,issues:n,samples:o,ok:n.every(s=>s.severity!=="error"),artifacts:[]}}async function $e(e,t,r,n,o){const s=H.createReportRuntime({reports:{sample:{template:r,datasets:e.datasets}},assets:pe(n,t),budget:{maxRows:n.maxSampleRows??1e3,maxPages:n.maxPages??100,maxCells:n.maxCells??25e4,maxOutputBytes:n.maxOutputBytes??2e7,maxDurationMs:n.maxDurationMs??3e4}});try{const{result:a,digest:u}=await p.controlled(n.signal,n.maxDurationMs??3e4,async f=>{const c=await s.export({reportIds:["sample"],params:e.params,format:t,signal:f,fidelity:n.strictOutputs?"strict":"warn",pdf:n.pdf,xlsx:n.xlsx}),i=c.diagnostics.filter(l=>l.severity!=="info");if(n.strictOutputs&&i.length)throw new Error(`Strict ${t} encoding found fidelity issues: ${i.slice(0,3).map(l=>l.message).join("; ")}`);const d=await n.digest?.(c.bytes);return p.throwIfAborted(f),await n.onArtifact?.(e.name,c),p.throwIfAborted(f),{result:c,digest:d}});o.artifacts.push({fixture:e.name,format:t,bytes:a.bytes.byteLength,pages:a.stats.pages,...u?{digest:u}:{}}),o.issues.push(...a.diagnostics.map(f=>({code:"output",severity:n.strictOutputs||f.severity==="error"?"error":"warning",path:"$.template",fixture:e.name,message:`${t}: ${f.message}`})))}catch(a){p.throwIfAborted(n.signal),o.issues.push({code:"output",severity:"error",path:"$.template",fixture:e.name,message:`${t}: ${a instanceof Error?a.message:String(a)}`})}}async function Me(e,t={}){p.throwIfAborted(t.signal);const r=Be(e,t);if(!r.ok)return r;const n=O.parseReportTemplate(e).template,o=[...new Set(t.formats??["pdf","xlsx"])];if(!o.length||o.some(s=>s!=="pdf"&&s!=="xlsx"))return r.issues.push({code:"output",severity:"error",path:"$.formats",message:"真实文件验收应至少选择PDF/XLSX之一"}),r.ok=!1,r;for(const s of t.fixtures??[])for(const a of o)p.throwIfAborted(t.signal),!(a!=="pdf"&&a!=="xlsx")&&await $e(s,a,n,t,r);return r.ok=r.issues.every(s=>s.severity!=="error"),r}class v extends Error{constructor(t,r){super(r),this.code=t,this.name="ReportInstanceError"}}function j(e,t){if(typeof e!="string"||!e.trim()||e.length>256||typeof t!="string"||t!==t.trim()||!/^[a-zA-Z0-9][a-zA-Z0-9_.:-]{0,127}$/.test(t))throw new v("input","实例范围应非空，ID 应为安全标识")}function De(e,t){const r=Object.getPrototypeOf(e);if(r!==(t?Array.prototype:Object.prototype)&&!(r===null&&!t)||Object.getOwnPropertySymbols(e).length)throw new v("input","实例应为普通 JSON 对象");if(t&&Object.keys(e).some(o=>o!==String(Number(o))||!Number.isSafeInteger(Number(o))||Number(o)<0||Number(o)>=e.length))throw new v("input","实例数组不能包含额外属性");if(Object.getOwnPropertyNames(e).filter(o=>!(t&&o==="length")).length!==Object.keys(e).length)throw new v("input","实例不能包含不可枚举属性")}function Ce(e){if(!Number.isSafeInteger(e.revision)||e.revision<1||typeof e.title!="string"||!e.title.trim()||e.title.length>512)throw new v("input","实例修订或标题无效");if(typeof e.generatedAt!="string"||!Number.isFinite(Date.parse(e.generatedAt))||new Date(e.generatedAt).toISOString()!==e.generatedAt)throw new v("input","实例生成时间应为 ISO UTC 字符串");if(!Array.isArray(e.reportIds)||!e.reportIds.length||e.reportIds.length>100||e.reportIds.some(t=>typeof t!="string"||!t.trim())||new Set(e.reportIds).size!==e.reportIds.length)throw new v("input","实例报表 ID 应非空且唯一")}function qe(e){return e===null||typeof e=="boolean"||typeof e=="string"||typeof e=="number"&&Number.isFinite(e)}function we(e,t){if(!Number.isSafeInteger(t)||t<1)throw new v("input","实例快照字节预算应为正安全整数");let r=0,n=0;const o=new Set;function s(u,f){if(++r>1e6||f>64)throw new v("capacity","实例节点或嵌套深度超过预算");if(typeof u=="string"&&(n+=u.length,n>t))throw new v("capacity","实例文本超过预算");if(qe(u))return u;if(!u||typeof u!="object"||o.has(u))throw new v("input","实例只允许无循环的有限 JSON 值");const c=Array.isArray(u);De(u,c),o.add(u);const i=Object.create(null);for(const d of Object.keys(u)){if(n+=d.length,n>t)throw new v("capacity","实例文本超过预算");const l=Object.getOwnPropertyDescriptor(u,d);if(l.get||l.set||["__proto__","constructor","prototype"].includes(d))throw new v("input","实例不能包含访问器或危险键");l.value!==void 0&&(i[d]=s(l.value,f+1))}if(o.delete(u),c){if(Object.keys(i).length!==u.length)throw new v("input","实例数组不能稀疏或包含额外属性");return Array.from({length:u.length},(d,l)=>i[String(l)])}return i}const a=JSON.stringify(s(e,0));if(new TextEncoder().encode(a).byteLength>t)throw new v("capacity","实例快照超过单条字节预算");return a}function F(e,t=8e6){const r=JSON.parse(we(e,t));j(r.scope,r.id);const n=new Set(["scope","id","revision","title","generatedAt","reportIds","params","templateRevisions","sourceRevisions","plan","artifacts","output"]);if(Object.keys(r).some(s=>!n.has(s)))throw new v("input","实例包含未知字段");Ce(r);for(const s of[r.params,r.templateRevisions,r.sourceRevisions])if(!s||typeof s!="object"||Array.isArray(s)||Object.values(s).some(a=>typeof a!="string"))throw new v("input","实例参数和修订应为字符串字典");if(r.reportIds.some(s=>!r.templateRevisions[s]))throw new v("input","每张报表都应记录生成时的模板修订");const o=O.validateRenderPlan(r.plan);if(!o.ok)throw new v("input",`实例渲染计划无效：${o.errors[0]?.path}`);if(r.output!==void 0){if(!r.output||Object.keys(r.output).some(s=>!["stats","diagnostics","layout","sources"].includes(s)))throw new v("input","实例输出元数据只允许统计、诊断和字体度量；不保存来源令牌");if(M.validatePreparedMetadata({...r.output,plan:r.plan,revisions:{}}),r.output.sources?.some(s=>"sourceToken"in s))throw new v("input","实例来源清单不保存来源令牌")}return r.artifacts!==void 0&&ze(r.artifacts),r}function ze(e){if(!Array.isArray(e)||e.length>100)throw new v("input","实例文件列表无效");const t=new Set;for(const r of e){if(!r||typeof r.key!="string"||!r.key.trim()||r.key.length>1024||t.has(r.key)||!["pdf","xlsx"].includes(r.format)||!Number.isSafeInteger(r.bytes)||r.bytes<0||r.sha256!==void 0&&(typeof r.sha256!="string"||r.sha256.length!==64||!/^[a-f0-9]{64}$/i.test(r.sha256)))throw new v("input","实例文件应包含唯一存储键、格式、大小和可选 SHA256");t.add(r.key)}}function me(e){const{scope:t,id:r,revision:n,title:o,generatedAt:s,reportIds:a,params:u,templateRevisions:f,sourceRevisions:c}=e;return JSON.parse(JSON.stringify({scope:t,id:r,revision:n,title:o,generatedAt:s,reportIds:a,params:u,templateRevisions:f,sourceRevisions:c}))}function _e(e){const t={maxInstances:100,maxRevisions:20,maxBytes:64e6,maxSnapshotBytes:8e6,...e};if(Object.values(t).some(r=>!Number.isSafeInteger(r)||r<1))throw new v("input","实例存储预算应为正安全整数");return t}function Le(e={}){const t=_e(e),r=new Map;let n=0;return{read:async(o,s,a,u)=>{p.throwIfAborted(u),j(o,s);const f=r.get(JSON.stringify([o,s])),c=f?.get(a??f.size);return c?F(c,t.maxSnapshotBytes):void 0},list:async(o,s={})=>{p.throwIfAborted(s.signal),j(o,"list");const a=s.limit??25;if(!Number.isSafeInteger(a)||a<1||a>100)throw new v("input","实例每页数量应为 1–100");const u=Array.from(r.values(),f=>f.get(f.size)).filter(f=>f.scope===o&&(!s.after||f.id>s.after)&&(!s.reportId||f.reportIds.includes(s.reportId))).sort((f,c)=>f.id<c.id?-1:1).slice(0,a+1);return{items:u.slice(0,a).map(me),...u.length>a?{next:u[a-1].id}:{}}},compareAndSwap:async(o,s,a,u,f)=>{p.throwIfAborted(f),j(o,s);const c=F(u,t.maxSnapshotBytes);if(c.scope!==o||c.id!==s||c.revision!==(a??0)+1)throw new v("input","实例身份或修订不一致");const i=JSON.stringify([o,s]),d=r.get(i)??new Map;if((d.size||null)!==a)return!1;const l=new TextEncoder().encode(JSON.stringify(c)).byteLength;if(d.size>=t.maxRevisions||n+l>t.maxBytes||!d.size&&r.size>=t.maxInstances)throw new v("capacity","实例存储达到预算，请使用持久化归档策略或显式调整容量");return d.set(c.revision,c),r.set(i,d),n+=l,!0}}}function ye(e,t={}){const r=t.maxSnapshotBytes??8e6;if(!Number.isSafeInteger(r)||r<1)throw new v("input","实例快照字节预算应为正安全整数");return{read:e.read.bind(e),list:e.list.bind(e),save:async(n,o)=>{const s=o.expectedRevision;if(s!==null&&(!Number.isSafeInteger(s)||s<1||s>=Number.MAX_SAFE_INTEGER))throw new v("input","实例预期修订无效");const a=JSON.parse(we(n,r)),u=F({...a,revision:(s??0)+1},r);if(p.throwIfAborted(o.signal),!await e.compareAndSwap(u.scope,u.id,s,u,o.signal))throw new v("conflict","实例已存在或已变化，请显式确认修订后保存");return u}}}function Fe(e,t){return h.serializeJobJson({reportIds:e,params:t})}function Ve(e){if(!e||typeof e!="object"||Object.getOwnPropertySymbols(e).length)throw new v("input","生成请求应为普通对象");const t=Object.create(null);let r;const n=new Set(["scope","id","title","reportIds","params","expectedRevision","signal"]);for(const o of Object.getOwnPropertyNames(e)){const s=Object.getOwnPropertyDescriptor(e,o);if(!n.has(o)||!s.enumerable||s.get||s.set)throw new v("input","生成请求不能包含未知字段或访问器");o==="signal"?r=s.value:s.value!==void 0&&(t[o]=s.value)}return{signal:r,request:JSON.parse(h.serializeJobJson(t))}}function he(e){const t=JSON.parse(h.serializeJobJson(e.templateRevisions)),r=M.snapshotPdfFonts(e.pdf),n=ye(e.instances,{maxSnapshotBytes:e.maxSnapshotBytes});return{async generate(o){const{signal:s,request:a}=Ve(o);if(j(a.scope,a.id),a.expectedRevision!==null&&(!Number.isSafeInteger(a.expectedRevision)||a.expectedRevision<1))throw new v("input","实例预期修订无效");const u=e.runtime.validate(a);if(!u.ok)throw new fe.ReportParamValidationError(u.issues);const f=Object.create(null);for(const g of a.reportIds){if(typeof t[g]!="string"||!t[g])throw new TypeError(`报表 ${g} 缺少生成时的模板修订`);f[g]=t[g]}if(p.throwIfAborted(s),((await e.instances.read(a.scope,a.id,void 0,s))?.revision??null)!==a.expectedRevision)throw new v("conflict","实例已存在或已变化，请显式确认修订后生成");const i=await e.runtime.prepare({reportIds:a.reportIds,params:u.values,pdf:r,signal:s});p.throwIfAborted(s);const d=Object.create(null);for(const[g,R]of Object.entries(i.revisions))R.revision!==void 0&&(d[g]=R.revision);const{plan:l,revisions:w,sources:m,...b}=i,y={...b,...m?{sources:m.map(({sourceToken:g,...R})=>R)}:{}};return n.save({scope:a.scope,id:a.id,title:a.title,reportIds:a.reportIds,params:u.values,templateRevisions:f,sourceRevisions:d,generatedAt:(e.now?.()??new Date).toISOString(),plan:l,output:y},{expectedRevision:a.expectedRevision,signal:s})},read:n.read,list:n.list,async exportInstance(o){const{scope:s,id:a,revision:u,signal:f,format:c,fidelity:i,taskId:d,correlationId:l,onEvent:w}=o,m=M.snapshotPdfFonts(o.pdf??r),b=M.snapshotXlsxOptions(o.xlsx);j(s,a),p.throwIfAborted(f);const y=await n.read(s,a,u,f);if(!y)throw new v("input","报表实例不存在");const g={plan:y.plan,revisions:Object.fromEntries(y.reportIds.map(R=>[R,{revision:y.sourceRevisions[R]}])),diagnostics:[{code:"instance-row-count",severity:"info",message:"历史实例未保存原始取数行数；本次 rows 统计为 0，页面及单元格数由已保存计划校验。"}],stats:{rows:0,pages:y.plan.pages.length,cells:0,durationMs:0},...y.output};return e.runtime.exportPrepared({prepared:g,format:c,fidelity:i,pdf:m,xlsx:b,signal:f,taskId:d,correlationId:l,onEvent:w})},save:n.save}}function z(e,t,r){if(!Number.isSafeInteger(e)||e<1||e>t)throw new RangeError(`${r} 应为 1–${t} 的安全整数`);return e}function re(e){if(!e||typeof e.key!="string"||!e.key.trim()||e.key.length>1024||!["pdf","xlsx"].includes(e.format)||!Number.isSafeInteger(e.bytes)||e.bytes<0||e.sha256!==void 0&&!/^[a-f0-9]{64}$/i.test(e.sha256))throw new TypeError("分批归档回执应包含存储键、格式、大小和可选 SHA256");return{key:e.key,format:e.format,bytes:e.bytes,...e.sha256?{sha256:e.sha256}:{}}}function He(e){if(!O.validateReportTemplate(e).ok||!e.repeat)throw new TypeError("分批生成仅支持有效的逐记录固定标签模板");return JSON.parse(JSON.stringify(e))}function Ue(e){const t=new Set,r=e.repeat;r.rowKey&&t.add(r.rowKey),typeof r.copies=="object"&&t.add(r.copies.field);const n=o=>{o.binding&&t.add(o.binding.field);for(const s of o.grid?.cells??[])for(const a of s)a?.children?.forEach(n)};return e.pages.forEach(o=>o.components.forEach(s=>n(s))),[...t]}function Ke(e,t,r,n){if(!e||typeof e!="object"||Array.isArray(e))throw new TypeError(`标签记录 ${n} 应为对象`);const o=Object.create(null);for(const s of t){const a=de.readRecordScalar(e,s,{dataset:r,rowIndex:n});if(typeof a=="string"&&a.length>1e6)throw new p.ReportRuntimeError("budget","标签字段超过 1 MB 字符预算",`$.datasets.${r}[${n}].${s}`);a!==void 0&&(o[s]=a)}return o}function Ze(e,t,r,n){const o=t.repeat;if(!o.rowKey)return;const s=de.readRecordScalar(e,o.rowKey,{rowIndex:n,dataset:o.dataset});if(!(typeof s=="string"&&s.trim()||typeof s=="number"&&Number.isFinite(s)))throw new TypeError(`标签记录 ${n} 的业务主键无效`);const a=JSON.stringify([typeof s,s]);if(r.keys.has(a))throw new TypeError(`标签记录 ${n} 的业务主键重复（包含先前批次）`);r.bytes+=a.length*2+64,r.keys.add(a)}function Xe(e){return Object.entries(e).reduce((t,[r,n])=>t+64+r.length*2+(typeof n=="string"?n.length*2:8),0)}function Ge(e,t){if(!t)return e;for(const r of e.plan.pages){const n=r.meta?.record;n&&typeof n=="object"&&"rowIndex"in n&&typeof n.rowIndex=="number"&&(n.rowIndex+=t)}return e}async function Qe(e,t){if(!e.return)return;const r=Promise.resolve(e.return());if(t.aborted){r.catch(()=>{});return}await p.controlled(t,void 0,()=>r)}async function ne(e,t,r){const n=Promise.resolve().then(()=>e.onReceipt?.(t,r));n.catch(()=>{}),await p.controlled(r.signal,void 0,()=>n)}function We(e,t,r){return new Promise((n,o)=>{let s=!1,a=!1,u;const f=()=>{clearTimeout(u),t.removeEventListener("abort",c)},c=()=>{s||u!==void 0||(u=setTimeout(()=>{if(!s){s=!0,a=!0,f();try{p.throwIfAborted(t)}catch(i){o(i)}}},0))};e.then(i=>{if(a){Promise.resolve().then(()=>r(i)).catch(()=>{});return}s||(s=!0,f(),n(i))},i=>{s||(s=!0,f(),o(i))}),t.addEventListener("abort",c,{once:!0}),t.aborted&&c()})}async function Ye(e,t){const r=z(t.batchSize??100,1e3,"batchSize"),n=z(t.maxRows??1e5,1e6,"maxRows"),o=z(t.maxChunks??1e3,1e4,"maxChunks"),s=z(t.maxRetainedBytes??16e6,64e6,"maxRetainedBytes"),a=He(t.template),u=Ue(a);if(!e||typeof e[Symbol.asyncIterator]!="function")throw new TypeError("标签来源应为 AsyncIterable");return p.controlled(t.signal,t.runtime?.budget?.maxDurationMs??12e4,async f=>{const c={rows:0,chunks:[]},i={keys:new Set,bytes:0},d=e[Symbol.asyncIterator]();let l=!1,w=!1,m;const b=()=>m??=Qe(d,f),y=()=>{l||b().catch(()=>{})};f.addEventListener("abort",y,{once:!0});try{for(;!l;){p.throwIfAborted(f);const g=[];let R=0;for(;g.length<r;){const x=await p.controlled(f,void 0,()=>Promise.resolve(d.next()));if(x.done){l=!0;break}if(c.rows+g.length>=n)throw new p.ReportRuntimeError("budget","标签来源行数超过预算","$.maxRows");if(c.chunks.length>=o)throw new p.ReportRuntimeError("budget","标签分块数量超过预算","$.maxChunks");const S=Ke(x.value,u,a.repeat.dataset,c.rows+g.length);if(Ze(S,a,i,c.rows+g.length),R+=Xe(S),i.bytes+R>s)throw new p.ReportRuntimeError("budget","标签当前块字段与全局主键索引超过内存预算","$.maxRetainedBytes");g.push(S)}if(!g.length)break;const P=H.createReportRuntime({...t.runtime,reports:{labels:{template:a,datasets:{[a.repeat.dataset]:g}}}});let N;const E={index:c.chunks.length,rowOffset:c.rows,rowCount:g.length,signal:f,export:x=>P.exportPrepared({pdf:t.pdf,...x,prepared:N,signal:f})};let $;const T=(await h.runReportBatch([{id:`labels-${E.index}`,params:{}}],async()=>{try{N=Ge(await P.prepare({reportIds:["labels"],pdf:t.pdf,signal:f}),E.rowOffset),p.throwIfAborted(f);const x=Promise.resolve(t.execute(N,E)),S=await We(x,f,A=>ne(t,re(A),E));return re(S)}catch(x){throw $=x,x}},{concurrency:1,signal:f,failure:"stop"}))[0];if(T.status==="cancelled")throw p.throwIfAborted(f),new Error("标签分批任务已取消");if(T.status==="failed")throw $??new Error(T.error.message);c.chunks.push({...T.value,index:E.index,rowOffset:E.rowOffset,rowCount:E.rowCount}),c.rows+=g.length,await ne(t,T.value,E)}return c}catch(g){throw w=!0,g}finally{f.removeEventListener("abort",y),l||await b().catch(g=>{if(!w)throw g})}})}async function ge(e,t){const r=t.document().id,n=()=>t.editor.saving||t.editor.blocked;if(n())throw new Error("草稿尚未保存，请处理设计器提示后再发布");if(t.editor.pendingLocalChanges){const s=t.successfulSaves();if(await t.editor.save(),await t.afterSave(),t.successfulSaves()===s||t.editor.pendingLocalChanges||n())throw new Error("草稿尚未保存，请处理设计器提示后再发布")}const o=t.document();if(o.id!==r)throw new v("conflict","当前模板已切换，请重新确认后发布");return e.publish(o.id,{expectedRevision:o.revision??null})}function be(e,t){return{async search(r){p.throwIfAborted(r.signal);const n=await e.list(r.signal);if(n.length>1e3)throw new RangeError("本地模板连接目录最多 1000 项；更大目录请使用宿主分页查询适配器");const o=[];for(const s of n){p.throwIfAborted(r.signal);const[a,u]=await Promise.all([e.get(s.id,{draft:!0,signal:r.signal}),e.get(s.id,{signal:r.signal})]),f=a??u;f&&o.push({document:f,published:u,draftRevision:a?.revision,publishedRevision:u?.revision,...t?.(O.parseReportTemplate(f))})}return ce.createLocalTemplateCatalog(o).search(r)},async get(r,n){return n.mode==="published"?e.get(r,{signal:n.signal}):await e.get(r,{draft:!0,signal:n.signal})??e.get(r,{signal:n.signal})}}}function ve(e=1e3){if(!Number.isSafeInteger(e)||e<1||e>1e3)throw new RangeError("本地生成意图上限应为 1–1000");const t=new Map,r=globalThis.crypto?.randomUUID?.()??`${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;return{forCase(n,o){if(![n,o].every(f=>typeof f=="string"&&f.length>0&&f.length<=256))throw new TypeError("模板与参数组标识无效");const s=JSON.stringify([n,o]),a=t.get(s);if(a)return a;if(t.size>=e)throw new RangeError("本地生成意图已达上限，请使用持久化任务服务");const u=`instance-${r}-${(t.size+1).toString(36)}`;return t.set(s,u),u}}}function et(e,t,r){const n=Object.keys(r);return e.reportIds.length===1&&e.reportIds[0]===t.id&&Object.keys(e.templateRevisions).length===1&&e.templateRevisions[t.id]===t.revision&&Object.keys(e.params).length===n.length&&n.every(o=>r[o]===e.params[o])}function oe(e){return{instanceId:e.id,label:e.title}}function tt(e,t,r){const n=O.parseReportTemplate(e);if(!n.revision)throw new Error("请先发布该模板");const o=typeof t.data=="function"?t.data(O.parseReportTemplate(n)):t.data,s=H.createReportRuntime({...t.runtime,reports:{[n.id]:{...o,template:n.template}}}),a=he({runtime:s,instances:t.instances,templateRevisions:{[n.id]:n.revision},pdf:t.pdf});async function u(f,c,i){p.throwIfAborted(i);const d=await t.instances.read(t.scope,f,void 0,i);if(p.throwIfAborted(i),!!d){if(!et(d,n,c))throw new v("conflict","此参数组已用于其他参数或发布修订，请复制为新任务生成");return oe(d)}}return{document:O.parseReportTemplate(n),async execute(f,{signal:c}){p.throwIfAborted(c);const i=s.validate({reportIds:[n.id],params:f.params});if(!i.ok)throw new Error(i.issues[0]?.message??"生成参数无效");const d=r(n.id,f.id),l=await u(d,i.values,c);if(l)return l;try{return oe(await a.generate({scope:t.scope,id:d,title:(t.title?.(O.parseReportTemplate(n),f,i.values)??`${n.name} · ${f.id}`).slice(0,512),reportIds:[n.id],params:i.values,expectedRevision:null,signal:c}))}catch(w){if(w instanceof v&&w.code==="conflict"){const m=await u(d,i.values,c);if(m)return m}throw w}}}}function rt(e){e={...e};const t=ve(),r=e.instanceId??t.forCase;return{catalog:e.catalog??be(e.templates,e.catalogMetadata),publish:n=>ge(e.templates,n),async batch(n,o={}){const{expectedRevision:s,signal:a}=o,u=await e.templates.get(n,{signal:a});if(p.throwIfAborted(a),!u?.revision)throw new Error("请先发布该模板");if(s!==void 0&&u.revision!==s)throw new v("conflict","模板发布版本已变化，请重新打开后生成");return tt(u,e,r)}}}const Re="2.17.0";function U(e,t){const r=t?.componentPath;if(!Number.isSafeInteger(t?.pageIndex)||t.pageIndex<0||!Array.isArray(r)||r.length<1||r.length>31||r.length%3!==1||r.some(o=>!Number.isSafeInteger(o)||o<0))throw new TypeError("模板包图片位置无效");let n=e.template.pages[t.pageIndex]?.components[r[0]];for(let o=1;n&&o<r.length;o+=3)n=n.grid?.cells[r[o]]?.[r[o+1]]?.children?.[r[o+2]];if(!n||n.kind!=="image"||n.binding)throw new TypeError("模板包图片位置应指向静态图片组件");return n}function nt(e){const t=["id","kind","mediaType","bytes","sha256","license","font","targets"];if(!e||Object.keys(e).some(r=>!t.includes(r)))throw new TypeError("模板资源包含未知字段");if(typeof e.id!="string"||!/^[a-zA-Z0-9][a-zA-Z0-9_.:-]{0,127}$/.test(e.id))throw new TypeError("模板资源ID应为安全标识");if(!Number.isSafeInteger(e.bytes)||e.bytes<1||e.bytes>32e6||!/^[a-f0-9]{64}$/.test(e.sha256))throw new TypeError("模板资源大小或SHA256无效");if(e.license!==void 0&&(typeof e.license!="string"||e.license.length>512))throw new TypeError("模板资源许可说明无效")}function ot(e,t){if(nt(e),e.kind==="font"){if(!["font/ttf","font/otf"].includes(e.mediaType)||e.targets!==void 0)throw new TypeError("字体资源类型无效");const r=e.font;if(!r||typeof r.family!="string"||!r.family.trim()||r.family.length>128||!["regular","bold","italic","boldItalic"].includes(r.face)||Object.keys(r).some(n=>!["family","face"].includes(n)))throw new TypeError("字体资源需要family和face");return}if(e.kind!=="image"||!["image/png","image/jpeg"].includes(e.mediaType)||e.font!==void 0)throw new TypeError("模板图片仅支持PNG/JPEG");if(!Array.isArray(e.targets)||!e.targets.length||e.targets.length>1e3)throw new TypeError("模板图片需要1–1000个位置");for(const r of e.targets){if(Object.keys(r).some(n=>!["pageIndex","componentPath"].includes(n)))throw new TypeError("模板图片位置包含未知字段");U(t,r)}}function st(e,t){const r=n=>n.every((o,s)=>e[s]===o);return t==="image/png"?r([137,80,78,71,13,10,26,10]):t==="image/jpeg"?r([255,216,255]):t==="font/otf"?r([79,84,84,79]):r([0,1,0,0])||r([116,114,117,101])}function Ie(e){if(!(e instanceof Uint8Array)||!e.byteLength||e.byteLength>32e6)throw new RangeError("资源摘要只接受1–32MB字节");return p.portableSha256Hex(e)}function Se(e,t,r=le.createImageMediaInspector()){const n=new Set(t.flatMap(a=>(a.targets??[]).map(u=>U(e,u)))),o=new Map,s=a=>{if(a.imageData&&!n.has(a)){const u=r(a.imageData);o.set(u.dataUrl,u.bytes.byteLength)}for(const u of a.grid?.cells??[])for(const f of u)for(const c of f?.children??[])s(c)};for(const a of e.template.pages)for(const u of a.components)s(u);return[...o.values()].reduce((a,u)=>a+u,0)}function at(e,t){let r="";for(let n=0;n<e.length;n+=16384)r+=String.fromCharCode(...e.subarray(n,n+16384));return`data:${t};base64,${btoa(r)}`}async function it(e,t,r,n,o=3e4){if(!Number.isFinite(o)||o<1||o>2147483647)throw new RangeError("模板资源加载超时应为1–2147483647毫秒");return p.controlled(n,o,async s=>{const a=[],u=le.createImageMediaInspector();Se(e,t,u);for(const f of t){p.throwIfAborted(s);const c=await p.controlled(s,void 0,()=>Promise.resolve(r(JSON.parse(JSON.stringify(f)),{signal:s})));if(p.throwIfAborted(s),!c||!(c.bytes instanceof Uint8Array)||c.mediaType!==f.mediaType||c.bytes.byteLength!==f.bytes)throw new TypeError(`资源 ${f.id} 的类型或大小与清单不一致`);const i=new Uint8Array(c.bytes);if(!st(i,f.mediaType)||Ie(i)!==f.sha256)throw new TypeError(`资源 ${f.id} 的文件标识或SHA256与清单不一致`);if(f.kind==="font")a.push({id:f.id,family:f.font.family,face:f.font.face,bytes:i});else{const d=u(at(i,f.mediaType)).dataUrl;for(const l of f.targets)U(e,l).imageData=d}}return a})}function se(e){if(typeof e!="string"||!/^(0|[1-9]\d{0,5})\.(0|[1-9]\d{0,5})\.(0|[1-9]\d{0,5})$/.test(e))throw new TypeError("模板包最低版本与运行版本应为正式版本x.y.z");return e.split(".").map(Number)}function ct(e,t){const r=se(e),n=se(t);for(let o=0;o<3;o++){if(n[o]>r[o])return;if(n[o]<r[o])throw new Error(`模板包需要MachReport ${e}或更新版本`)}}function X(e,t,r){const n=e??t;if(!Number.isSafeInteger(n)||n<1||n>r)throw new RangeError("模板包字节预算无效");return n}function ft(e){if(e.contracts!==void 0){if(!e.contracts||typeof e.contracts!="object"||Array.isArray(e.contracts)||Object.keys(e.contracts).length>100)throw new TypeError("模板包字段契约应为最多100个数据集");for(const[t,r]of Object.entries(e.contracts)){if(!t.trim()||t.length>256)throw new TypeError("模板包数据集名称无效");ue.validateDatasetRows([],r)}}}function dt(e,t){if(!e||e.deidentified!==!0||typeof e.name!="string"||!e.name.trim()||e.name.length>128)throw new TypeError("样例需要名称和明确的deidentified:true确认");if(Object.keys(e).some(n=>!["name","deidentified","datasets","params"].includes(n)))throw new TypeError("模板包样例包含未知字段");if(!e.datasets||typeof e.datasets!="object"||Array.isArray(e.datasets))throw new TypeError("模板包样例数据集无效");if(ut(e,t),!fe.validateReportParams(t.document.template.params??[],e.params).ok)throw new TypeError(`样例 ${e.name} 的参数不符合模板定义`)}function ut(e,t){let r=0;for(const o of Object.values(e.datasets))if(!Array.isArray(o)||o.some(s=>!s||typeof s!="object"||Array.isArray(s)))throw new TypeError("模板包样例应为对象行数组");const n=C.templateValidationDatasets(t.document.template,e.datasets,{maxRows:1e3});for(const[o,s]of Object.entries(n)){if(r+=s.length,r>1e3)throw new RangeError("模板包每个样例最多1000行");const a=t.contracts?.[o];if(a&&!ue.validateDatasetRows(s,a).ok)throw new TypeError(`样例 ${e.name} 不符合 ${o} 字段契约`)}for(const o of Object.keys(t.contracts??{}))if(!Object.prototype.hasOwnProperty.call(e.datasets,o))throw new TypeError(`样例 ${e.name} 缺少 ${o} 数据集`)}function lt(e){if(e.fixtures===void 0)return;if(!Array.isArray(e.fixtures)||e.fixtures.length>20)throw new RangeError("模板包最多20个脱敏样例");const t=new Set;for(const r of e.fixtures){if(dt(r,e),t.has(r.name))throw new TypeError("模板包样例名称重复");t.add(r.name)}}function pt(e,t){if(!Array.isArray(e.resources)||e.resources.length>64)throw new RangeError("模板包最多64个资源依赖");const r=new Set,n=new Set,o=new Set;let s=0;for(const a of e.resources){if(ot(a,e.document),r.has(a.id))throw new TypeError("模板资源ID重复");if(r.add(a.id),s+=a.bytes,s>t)throw new RangeError("模板包资源总大小超过预算");const u=a.font&&JSON.stringify([a.font.family,a.font.face]);if(u&&o.has(u))throw new TypeError("模板包字体family/face重复");u&&o.add(u);for(const f of a.targets??[]){const c=JSON.stringify([f.pageIndex,f.componentPath]);if(n.has(c))throw new TypeError("同一图片位置不能绑定多个资源");n.add(c)}}if(s+Se(e.document,e.resources)>t)throw new RangeError("模板包内嵌与外部资源总大小超过预算")}function G(e,t={}){p.throwIfAborted(t.signal);const r=X(t.maxBytes,8e6,32e6);if(typeof e=="string"){if(e.length>r||new TextEncoder().encode(e).byteLength>r)throw new RangeError("模板包JSON超过预算");e=JSON.parse(e)}const n=C.snapshotReportJson(e,{maxBytes:r,check:()=>p.throwIfAborted(t.signal),error:(o,s)=>new TypeError(s)});if(!n||typeof n!="object"||Array.isArray(n)||n.schemaVersion!=="1.0"||Object.keys(n).some(o=>!["schemaVersion","minimumVersion","document","contracts","resources","fixtures"].includes(o)))throw new TypeError("模板包结构或版本无效");return ct(n.minimumVersion,t.runtimeVersion??Re),n.document=O.parseReportTemplate(n.document),ft(n),lt(n),pt(n,X(t.maxResourceBytes,32e6,64e6)),n}function wt(e,t={}){const r=C.snapshotReportJson(e,{maxBytes:X(t.maxBytes,8e6,32e6),check:()=>p.throwIfAborted(t.signal),error:(o,s)=>new TypeError(s)}),n=G({schemaVersion:"1.0",...r,minimumVersion:r.minimumVersion??Re,resources:r.resources??[]},t);for(const o of n.resources)for(const s of o.targets??[])delete U(n.document,s).imageData;return n}async function mt(e,t){const{resolve:r,signal:n,maxDurationMs:o}=t,s=G(e,t),a=await it(s.document,s.resources,r,n,o);return{document:s.document,fonts:a,contracts:s.contracts,fixtures:s.fixtures??[]}}class I extends Error{constructor(t,r){super(r),this.code=t,this.name="ReportDocumentError"}}function yt(e={}){const t={maxDocuments:e.maxDocuments??32,maxBytes:e.maxBytes??64e6,maxPages:e.maxPages??1e4,maxPageBytes:e.maxPageBytes??4e6,maxManifestBytes:e.maxManifestBytes??1e6};if(Object.values(t).some(r=>!Number.isSafeInteger(r)||r<1))throw new I("input","文档预算应为正安全整数");return t}function J(e,t,r){if([e,t,...r===void 0?[]:[r]].some(n=>typeof n!="string"||!n.trim()||n.length>256))throw new I("input","文档 scope、id、version 应为 1–256 位非空字符串");return JSON.stringify([e,t])}function k(e,t,r){return C.snapshotReportJson(e,{maxBytes:t,maxNodes:t,check:()=>p.throwIfAborted(r),error:(n,o)=>new I(n==="budget"?"capacity":"input",o)})}function B(e){return new TextEncoder().encode(JSON.stringify(e)).byteLength}function ae(e){if(!e||e.schemaVersion!==Ee.RENDER_PLAN_SCHEMA_VERSION||"pages"in e||e.requiresRecalculation!==void 0&&typeof e.requiresRecalculation!="boolean")throw new I("input","文档计划头应使用当前版本，且不得携带 pages")}function _(e,t){e.bytes=0;for(let r=0;r<8;r++){const n=t+B(e);if(n===e.bytes)return;e.bytes=n}throw new I("capacity","文档容量统计无效")}function ht(e,t,r=[]){const n=new Map;let o=0,s=Promise.resolve();for(const i of r){const d=J(i.scope,i.id,i.version);if(ae(i.plan),n.has(d)||!Number.isSafeInteger(i.bytes)||i.bytes<0||!Number.isSafeInteger(i.pageCount)||i.pageCount<0||i.pageCount>t.maxPages||!["building","complete","failed"].includes(i.state)||i.revision!==i.pageCount+(i.state==="building"?0:1))throw new I("input","文档清单无效");n.set(d,k(i,t.maxManifestBytes)),o+=i.bytes}function a(i,d){if(o-(d?.bytes??0)+i.bytes>t.maxBytes||!d&&n.size>=t.maxDocuments)throw new I("capacity","文档存储容量已满，请显式清理旧文档")}if(n.size>t.maxDocuments||o>t.maxBytes)throw new I("capacity","已存文档超过预算");const u=i=>{const d=s.then(i);return s=d.then(()=>{},()=>{}),d},f=(i,d,l,w)=>{const m=n.get(J(i,d,l));if(!m)throw new I("missing","文档不存在");if(m.version!==l||w!==void 0&&m.revision!==w)throw new I("conflict","文档已变化，请重新读取清单");return m},c=async(i,d,l)=>{const w=k(i,t.maxManifestBytes);return a(w,d),await e.write(w,l),n.set(J(i.scope,i.id),w),o+=i.bytes-(d?.bytes??0),k(w,t.maxManifestBytes)};return{create:(i,d)=>{const l=k(i,t.maxManifestBytes,d),w=J(l.scope,l.id,l.version);return ae(l.plan),u(async()=>{if(p.throwIfAborted(d),n.has(w))throw new I("conflict","文档已存在，不可覆盖");const m={...l,revision:0,state:"building",pageCount:0,bytes:0};return _(m,0),c(m)})},append:(i,d,l,w,m,b)=>{const y=k(m,t.maxPageBytes,b),g=O.validateRenderPlan({pages:[y]});if(!g.ok)throw new I("input",g.errors[0].message);return u(async()=>{p.throwIfAborted(b);const R=f(i,d,l,w);if(R.state!=="building")throw new I("conflict","已完成文档不可追加");if(R.pageCount>=t.maxPages)throw new I("capacity","文档页数超过预算");const P={...R,revision:w+1,pageCount:R.pageCount+1};return _(P,R.bytes-B(R)+B(y)),c(P,R,{index:R.pageCount,value:y})})},complete:(i,d,l,w,m,b)=>{const y=m===void 0?void 0:k(m,t.maxManifestBytes,b);return y&&M.validatePreparedMetadata({...y}),u(async()=>{p.throwIfAborted(b);const g=f(i,d,l,w);if(g.state!=="building")throw new I("conflict","文档已完成");if(y&&y.stats.pages!==g.pageCount)throw new I("input","准备结果页数与文档页数不一致");const R={...g,revision:w+1,state:"complete",...y?{metadata:y}:{}};return _(R,g.bytes-B(g)),c(R,g)})},fail:(i,d,l,w,m)=>{const b=k(m,4096);if(!b||!["cancelled","generation"].includes(b.code)||typeof b.message!="string"||!b.message.trim()||b.message.length>1024)throw new I("input","文档失败状态无效");return u(async()=>{const y=f(i,d,l,w);if(y.state!=="building")throw new I("conflict","终态文档不可变更");const g={...y,state:"failed",revision:w+1,failure:b};return _(g,y.bytes-B(y)),c(g,y)})},read:async(i,d,l)=>{p.throwIfAborted(l);const w=J(i,d);await s,p.throwIfAborted(l);const m=n.get(w);return m?k(m,t.maxManifestBytes):void 0},readPage:(i,d,l,w,m)=>u(async()=>{p.throwIfAborted(m);const b=f(i,d,l);if(!Number.isSafeInteger(w)||w<0)throw new I("input","页索引应为非负安全整数");if(w>=b.pageCount)return;const y=await e.readPage(i,d,w);if(p.throwIfAborted(m),!y)throw new I("missing","已提交的文档页缺失");return k(y,t.maxPageBytes,m)}),remove:(i,d,l,w)=>u(async()=>{p.throwIfAborted(w);const m=J(i,d,l),b=n.get(m);return b?(f(i,d,l),await e.remove(b),n.delete(m),o-=b.bytes,!0):!1})}}function gt(e={}){const t=new Map;return ht({write:async(r,n)=>{if(!n)return;const o=J(r.scope,r.id),s=t.get(o)??[];s[n.index]=n.value,t.set(o,s)},readPage:async(r,n,o)=>t.get(J(r,n))?.[o],remove:async r=>{t.delete(J(r.scope,r.id))}},yt(e))}async function bt(e,t){const r=t.fromPage??0,n=t.limit??4,o=t.maxBytes??8e6;if(!Number.isSafeInteger(r)||r<0||!Number.isSafeInteger(n)||n<1||n>32||!Number.isSafeInteger(o)||o<1)throw new I("input","页窗口参数无效；每次最多读取 32 页");const s=await e.read(t.scope,t.id,t.signal);if(!s)throw new I("missing","文档不存在");if(s.version!==t.version)throw new I("conflict","文档版本已变化");const a=[];let u=0,f=Math.min(r,s.pageCount);for(;f<Math.min(s.pageCount,r+n);f++){const c=await e.readPage(t.scope,t.id,t.version,f,t.signal);if(!c)throw new I("missing","文档页缺失");const i=B(c);if(u+i>o){if(!a.length)throw new I("capacity","单页超过读取窗口预算");break}a.push(c),u+=i}return{manifest:s,pages:a,nextPage:f}}async function vt(e,t){const{scope:r,id:n,version:o,signal:s,pages:a}=t,u=t.metadata===void 0?void 0:k(t.metadata,1e6,s);let f=await e.create({scope:r,id:n,version:o,plan:t.plan},s),c;try{const i=Symbol.asyncIterator in a?a[Symbol.asyncIterator]():a[Symbol.iterator]();for(c=i;;){const d=await p.controlled(s,void 0,()=>Promise.resolve(i.next()));if(d.done)break;f=await e.append(r,n,o,f.revision,d.value,s)}return await e.complete(r,n,o,f.revision,u,s)}catch(i){throw Promise.resolve(c?.return?.()).catch(()=>{}),await e.fail(r,n,o,f.revision,s?.aborted?{code:"cancelled",message:"报表文档生成已取消"}:{code:"generation",message:"报表文档生成失败"}).catch(()=>{}),i}}const xe="1.0",ie=Object.freeze({params:422,validate:422,fetch:502,config:400,input:400,budget:413,capacity:413,timeout:504,"queue-full":429,closed:503,cancelled:499,"output-fidelity":422,conflict:409,missing:404});function V(e){return e&&typeof e=="object"?e:{}}function Rt(e){if(Array.isArray(e))return e.slice(0,100).map(t=>Object.fromEntries(["code","path","field","message"].flatMap(r=>typeof V(t)[r]=="string"?[[r,V(t)[r].slice(0,4096)]]:[])))}function It(e,t){const r=V(e),n=r.name==="AbortError"?"cancelled":r.code,o=typeof n=="string"&&Object.prototype.hasOwnProperty.call(ie,n)?n:"internal",s=o==="internal"?void 0:Rt(r.issues??V(r.cause).issues);return{status:ie[o]??500,body:{error:{code:o,message:o==="internal"?"Report execution failed":typeof r.message=="string"?r.message.slice(0,4096):"Report request failed",correlationId:t.slice(0,128),...o!=="internal"&&typeof r.path=="string"?{path:r.path.slice(0,4096)}:{},...s?{issues:s}:{}}}}}function Z(e,t,r){return{description:r,headers:{"X-Request-Id":{schema:{type:"string"},description:"Request correlation identity"}},content:{[e]:{schema:t}}}}function St(e){return{type:"object",additionalProperties:!1,properties:Object.fromEntries(e.params.map(t=>[t.field,{type:"string"}])),required:e.params.filter(t=>t.required&&t.defaultValue===void 0).map(t=>t.field),"x-report-typedSchema":e.paramsSchema}}function xt(e,t={}){const r=t.basePath??"/reports";if(!/^\/[A-Za-z0-9/_-]*[A-Za-z0-9_-]$/.test(r))throw new Error("OpenAPI basePath 应为不含查询串、参数和尾斜线的绝对路径");const n={[r]:{get:{operationId:"describeReports",responses:{200:Z("application/json",{type:"array",items:{type:"object"}},"Authorized report descriptions")}}}},o=new Set;for(const s of e){if(!s.id.trim()||o.has(s.id)||[".",".."].includes(s.id))throw new Error("OpenAPI 报表 ID 应非空、唯一且不是路径跳转段");o.add(s.id);for(const a of["prepare","pdf","xlsx"]){const u=a==="prepare"?"prepare":`export/${a}`,f=a!=="prepare",c={200:Z(f?a==="pdf"?"application/pdf":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":"application/json",f?{type:"string",format:"binary"}:{type:"object",required:["plan","stats","diagnostics","revisions"]},f?"Report file":"Prepared report snapshot")};for(const i of[400,413,422,429,499,500,502,503,504])c[String(i)]=Z("application/json",{$ref:"#/components/schemas/ReportError"},"Structured report error");n[`${r}/${encodeURIComponent(s.id)}/${u}`]={post:{operationId:`report_${o.size}_${a}`,parameters:[{in:"header",name:"X-Request-Id",schema:{type:"string",pattern:"^[A-Za-z0-9._-]{1,80}$"}}],requestBody:{required:!0,content:{"application/json":{schema:{type:"object",required:["params"],additionalProperties:!1,properties:{params:St(s)}}}}},responses:c,"x-report-datasets":s.datasetsSchema}}}}return{openapi:"3.1.0",info:{title:t.title??"MachReport HTTP",version:t.version??xe},paths:n,components:{schemas:{ReportError:{type:"object",required:["error"],properties:{error:{type:"object",required:["code","message","correlationId"],properties:{code:{type:"string"},message:{type:"string"},correlationId:{type:"string"},path:{type:"string"},issues:{type:"array",items:{type:"object",additionalProperties:{type:"string"}}}}}}}}}}}exports.createReportRuntime=H.createReportRuntime;exports.ReportRuntimeError=p.ReportRuntimeError;exports.ReportJobError=h.ReportJobError;exports.checkJobIdentity=h.checkJobIdentity;exports.cloneJob=h.cloneJob;exports.createMemoryReportJobStore=h.createMemoryReportJobStore;exports.runReportBatch=h.runReportBatch;exports.runnableJob=h.runnableJob;exports.serializeJobJson=h.serializeJobJson;exports.snapshotReportBatchCases=h.snapshotReportBatchCases;exports.validateJobRecord=h.validateJobRecord;exports.validateJobTransition=h.validateJobTransition;exports.REPORT_HTTP_CONTRACT_VERSION=xe;exports.ReportDocumentError=I;exports.ReportInstanceError=v;exports.checkInstanceIdentity=j;exports.createManagerTemplateCatalog=be;exports.createMemoryReportDocumentStore=gt;exports.createMemoryReportInstanceIds=ve;exports.createMemoryReportInstanceStore=Le;exports.createReportGenerationService=he;exports.createReportInstanceManager=ye;exports.createReportJobService=Ne;exports.createReportOpenApi=xt;exports.createReportTaskQueue=Ae;exports.createReportTemplatePackage=wt;exports.createReportWorkflow=rt;exports.parseReportTemplatePackage=G;exports.readReportDocumentPages=bt;exports.reportHttpError=It;exports.reportInstanceParameterKey=Fe;exports.reportInstanceSummary=me;exports.reportPackageResourceDigest=Ie;exports.resolveReportTemplatePackage=mt;exports.reviewReportPublication=Me;exports.runLabelStream=Ye;exports.saveAndPublishReportTemplate=ge;exports.snapshotReportInstance=F;exports.writeReportDocument=vt;

package/dist/server.d.cts

@@ -35,6 +35,8 @@ declare interface AssetRenderBudget {
 
 declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMediaOptions {
     assetRenderers?: Partial<Record<ImageComponentKind, ComponentImageRenderer>>;
+    /** Explicit id/version registry; unbound components continue using assetRenderers by kind. */
+    assetRegistry?: ComponentAssetRegistry;
     assetBudget?: AssetRenderBudget;
     /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
     assetFailure?: "throw" | "placeholder";
@@ -117,6 +119,11 @@ declare type ColumnFormat_2 = {
     pattern?: string;
 };
 
+declare interface ComponentAssetRegistry {
+    rendererFor(component: Readonly<PlanComponent>): ComponentImageRenderer | undefined;
+    hasExtension(id: string, version: string, kind: string): boolean;
+}
+
 /** A literal own field of the current label record; expressions and paths are not evaluated. */
 declare interface ComponentBinding {
     field: string;
@@ -219,6 +226,9 @@ declare interface ComputedField_2 extends ExpressionOptions_2 {
 
 export declare function createManagerTemplateCatalog(manager: ReportTemplateManager, metadata?: (document: ReportTemplateDocument) => Pick<LocalTemplateCatalogItem, "category" | "tags">): ReportTemplateCatalogProvider;
 
+/** Bounded, single-process reference store. Scope is host-authorized identity, never a client permission. */
+export declare function createMemoryReportDocumentStore(options?: ReportDocumentBudget): ReportDocumentStore;
+
 /** Session-local intents; durable hosts should supply their own authorized stable IDs. */
 export declare function createMemoryReportInstanceIds(maximum?: number): {
     forCase(templateId: string, caseId: string): string;
@@ -270,6 +280,13 @@ export declare function createReportInstanceManager(store: ReportInstanceStore,
 /** Durable at-least-once dispatch; export/artifact handlers must be idempotent by scope+taskId. */
 export declare function createReportJobService(options: ReportJobServiceOptions): ReportJobService;
 
+/** OpenAPI 3.1 for the minimal Java/Node wire contract. Host registers routes and authorizes IDs before describe(). */
+export declare function createReportOpenApi(descriptions: readonly ReportDescription[], options?: {
+    title?: string;
+    version?: string;
+    basePath?: string;
+}): Record<string, unknown>;
+
 /** 无 Vue、无 HTTP 框架的可选服务端外观；PDF/Excel 仅在对应 export 调用时加载。 */
 export declare function createReportRuntime(options: ReportRuntimeOptions): ReportRuntime;
 
@@ -709,6 +726,46 @@ declare interface LocalTemplateCatalogItem {
     tags?: string[];
 }
 
+declare interface MatrixAxisOptions {
+    /** Display names in the same outer-to-inner order as the dimension fields. */
+    labels?: readonly string[];
+    /** Per-level sibling order; omitted levels retain first-seen order. */
+    sort?: readonly MatrixDimensionOrder[];
+    /** One-based prefix depths. Leaf depths are not subtotals. */
+    subtotals?: readonly number[];
+}
+
+declare interface MatrixAxisOptions_2 {
+    /** Display names in the same outer-to-inner order as the dimension fields. */
+    labels?: readonly string[];
+    /** Per-level sibling order; omitted levels retain first-seen order. */
+    sort?: readonly MatrixDimensionOrder_2[];
+    /** One-based prefix depths. Leaf depths are not subtotals. */
+    subtotals?: readonly number[];
+}
+
+declare type MatrixDimensionOrder = "source" | "asc" | "desc";
+
+declare type MatrixDimensionOrder_2 = "source" | "asc" | "desc";
+
+declare interface MatrixHierarchyOptions {
+    row?: MatrixAxisOptions;
+    column?: MatrixAxisOptions;
+    /** Only null/missing values use this label; empty strings and zero stay distinct. */
+    emptyLabel?: string;
+    subtotalLabel?: string;
+    totalLabel?: string;
+}
+
+declare interface MatrixHierarchyOptions_2 {
+    row?: MatrixAxisOptions_2;
+    column?: MatrixAxisOptions_2;
+    /** Only null/missing values use this label; empty strings and zero stay distinct. */
+    emptyLabel?: string;
+    subtotalLabel?: string;
+    totalLabel?: string;
+}
+
 declare interface MatrixTableOptions {
     rowFields: readonly string[];
     columnFields: readonly string[];
@@ -723,6 +780,10 @@ declare interface MatrixTableOptions {
     maxColumns?: number;
     maxInputRows?: number;
     maxCells?: number;
+    /** Opt-in hierarchical dimensions, physical merged headers and prefix subtotals. */
+    hierarchy?: MatrixHierarchyOptions;
+    /** Hierarchical aggregate work, checked before measure reads; default 10 million updates. */
+    maxAggregateUpdates?: number;
 }
 
 declare interface MatrixTableOptions_2 {
@@ -739,6 +800,10 @@ declare interface MatrixTableOptions_2 {
     maxColumns?: number;
     maxInputRows?: number;
     maxCells?: number;
+    /** Opt-in hierarchical dimensions, physical merged headers and prefix subtotals. */
+    hierarchy?: MatrixHierarchyOptions_2;
+    /** Hierarchical aggregate work, checked before measure reads; default 10 million updates. */
+    maxAggregateUpdates?: number;
 }
 
 export declare interface MemoryReportInstanceStoreOptions {
@@ -758,6 +823,11 @@ declare interface OutputDiagnostic {
     componentPath?: readonly number[];
     kind: string;
     nid?: string;
+    /** Declarative extension identity only; no property values or business binding data enter diagnostics. */
+    extension?: {
+        id: string;
+        version: string;
+    };
     message: string;
 }
 
@@ -940,6 +1010,21 @@ export declare interface PreparedReport {
 
 declare type PublicationAssets = Omit<AssetRenderOptions, "signal">;
 
+/** Progressive consumption ends at the currently committed boundary; caller may resume with nextPage. */
+export declare function readReportDocumentPages(store: ReportDocumentStore, input: {
+    scope: string;
+    id: string;
+    version: string;
+    fromPage?: number;
+    limit?: number;
+    maxBytes?: number;
+    signal?: AbortSignal;
+}): Promise<{
+    manifest: ReportDocumentManifest;
+    pages: PlanPage[];
+    nextPage: number;
+}>;
+
 declare interface RenderPlan {
     schemaVersion: string;
     /** 编辑需要模板重算上下文；跨 Worker/JSON 保留要求，但不声明本地会话可用。 */
@@ -947,6 +1032,8 @@ declare interface RenderPlan {
     pages: PlanPage[];
 }
 
+export declare const REPORT_HTTP_CONTRACT_VERSION = "1.0";
+
 export declare interface ReportBatchCase {
     id: string;
     params: Record<string, string>;
@@ -1085,6 +1172,46 @@ declare interface ReportDiagnostic {
     target?: ReportDataTarget;
 }
 
+export declare interface ReportDocumentBudget {
+    maxDocuments?: number;
+    maxBytes?: number;
+    maxPages?: number;
+    maxPageBytes?: number;
+    maxManifestBytes?: number;
+}
+
+export declare class ReportDocumentError extends Error {
+    readonly code: "input" | "capacity" | "conflict" | "missing" | "closed";
+    constructor(code: "input" | "capacity" | "conflict" | "missing" | "closed", message: string);
+}
+
+export declare interface ReportDocumentManifest {
+    scope: string;
+    id: string;
+    version: string;
+    /** CAS token increases after each append and completion. */
+    revision: number;
+    state: "building" | "complete" | "failed";
+    failure?: {
+        code: "cancelled" | "generation";
+        message: string;
+    };
+    pageCount: number;
+    bytes: number;
+    plan: Omit<RenderPlan, "pages">;
+    metadata?: Omit<PreparedReport, "plan">;
+}
+
+export declare interface ReportDocumentStore {
+    create(input: Pick<ReportDocumentManifest, "scope" | "id" | "version" | "plan">, signal?: AbortSignal): Promise<ReportDocumentManifest>;
+    append(scope: string, id: string, version: string, expectedRevision: number, page: PlanPage, signal?: AbortSignal): Promise<ReportDocumentManifest>;
+    complete(scope: string, id: string, version: string, expectedRevision: number, metadata?: Omit<PreparedReport, "plan">, signal?: AbortSignal): Promise<ReportDocumentManifest>;
+    fail(scope: string, id: string, version: string, expectedRevision: number, failure: NonNullable<ReportDocumentManifest["failure"]>): Promise<ReportDocumentManifest>;
+    read(scope: string, id: string, signal?: AbortSignal): Promise<ReportDocumentManifest | undefined>;
+    readPage(scope: string, id: string, version: string, index: number, signal?: AbortSignal): Promise<PlanPage | undefined>;
+    remove(scope: string, id: string, version: string, signal?: AbortSignal): Promise<boolean>;
+}
+
 declare type ReportExpression = {
     field: string;
 } | {
@@ -1111,7 +1238,15 @@ declare type ReportExpression_2 = {
     args: readonly ReportExpression_2[];
 };
 
-declare interface ReportFieldContract {
+declare type ReportFieldAggregation = "sum" | "avg" | "min" | "max" | "count" | "none";
+
+declare interface ReportFieldCalculation {
+    /** Business-owned explanation, never executable JavaScript or an inferred business formula. */
+    description: string;
+    dependsOn: readonly string[];
+}
+
+declare interface ReportFieldContract extends ReportFieldSemantics {
     field: string;
     label?: string;
     type: "text" | "number" | "boolean" | "date" | "decimal";
@@ -1126,6 +1261,17 @@ declare interface ReportFieldContract {
     unit?: string;
 }
 
+declare interface ReportFieldSemantics {
+    description?: string;
+    /** Explicit meaning of null/missing; does not convert blanks into zero. */
+    missingMeaning?: string;
+    /** Recommended aggregation; none marks non-additive measures such as ratios. No aggregation runs implicitly. */
+    aggregation?: ReportFieldAggregation;
+    /** Shared presentation only; raw values and calculation precision remain unchanged. */
+    format?: ColumnFormat;
+    calculation?: ReportFieldCalculation;
+}
+
 declare interface ReportFlowBand {
     /** Exact stable component IDs. Static components use nid, lists use id. */
     componentIds: string[];
@@ -1152,6 +1298,22 @@ export declare interface ReportGenerationInput {
     signal?: AbortSignal;
 }
 
+/** Stable transport mapping; unexpected errors never expose exception details or stacks. */
+export declare function reportHttpError(error: unknown, correlationId: string): {
+    status: number;
+    body: ReportHttpErrorBody;
+};
+
+export declare interface ReportHttpErrorBody {
+    error: {
+        code: string;
+        message: string;
+        correlationId: string;
+        path?: string;
+        issues?: Record<string, string>[];
+    };
+}
+
 export declare interface ReportInstanceArtifact {
     key: string;
     format: "pdf" | "xlsx";
@@ -2186,4 +2348,15 @@ declare type ValueFormat = ColumnFormat;
 /** The same declarative formatting used by list columns, before any output backend. */
 declare type ValueFormat_2 = ColumnFormat_2;
 
+/** Accepts paginateTemplatePages/AsyncIterable without retaining all pages; partial documents stay inspectable on failure. */
+export declare function writeReportDocument(store: ReportDocumentStore, input: {
+    scope: string;
+    id: string;
+    version: string;
+    plan: Omit<RenderPlan, "pages">;
+    pages: Iterable<PlanPage> | AsyncIterable<PlanPage>;
+    metadata?: Omit<PreparedReport, "plan">;
+    signal?: AbortSignal;
+}): Promise<ReportDocumentManifest>;
+
 export { }