@agile-team/mach-report 2.14.0 → 2.15.0

package/dist/xlsx.cjs

@@ -1,4 +1,3 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./progress-BnLiS5eH.cjs"),w=require("./workbook-session-DNa2RHNG.cjs"),W=require("./render-plan-7xpGrCEl.cjs"),R=require("./grid-geometry-CZ_cYB6O.cjs"),C=require("./style-UgIJSA1F.cjs"),P=require("./capabilities-CsZ-pNHR.cjs"),m=require("./region-binding-workflow-BzfbxRiR.cjs");function v(e,t){const i=e??t;if(!Number.isSafeInteger(i)||i<=0)throw new Error("Excel 图片字节预算应为正安全整数");return i}function z(e,t){const i=e.imageData;if(!i||!/^data:image\/(png|jpe?g);base64,/i.test(i))return;if(i.length>Math.ceil(t/3)*4+64)throw new Error("Excel 单张图片超过字节预算");const n=i.indexOf(","),r=i.slice(n+1);if(!/^[A-Za-z0-9+/]+={0,2}$/.test(r)||r.length%4!==0)throw new Error("Excel 图片不是有效的 base64 数据");const o=r.length/4*3-(r.endsWith("==")?2:r.endsWith("=")?1:0);if(o>t)throw new Error("Excel 单张图片超过字节预算");const l=/^data:image\/png;/i.test(i)?"png":"jpeg",s=atob(r.slice(0,12));if(l==="png"?!s.startsWith(`‰PNG\r
-
-`):!s.startsWith("ÿØÿ"))throw new Error("Excel 图片内容与 PNG/JPEG 类型不一致");return{base64:`data:image/${l};base64,${r}`,key:`${l}:${r}`,extension:l,bytes:o}}function O(e,t,i){let n=i*72/25.4;if(!Number.isFinite(n)||t+Math.ceil(n/409)-1>1048576)throw new Error("Excel 图片占位超过工作表行数上限");for(;n>0;){if(t>1048576)throw new Error("Excel 图片占位超过工作表行数上限");const r=Math.min(409,n);e.getRow(t++).height=r,n-=r}return t}function G(e,t,i){let n=Math.round(t*36e3),r=0;if(!Number.isSafeInteger(n))throw new Error("Excel 图片锚点超出安全坐标范围");for(e.properties.defaultColWidth??=8.43;r<16384;){const o=e.getColumn(r+1).width??e.properties.defaultColWidth,l=Math.round(w.excelColumnWidthToMm(o)*36e3);if(!Number.isSafeInteger(l)||l<=0)throw new Error("Excel 图片锚点所在列宽无效");if(n<l)return{col:r+n/l,row:i-1,nativeCol:r,nativeColOff:n,nativeRow:i-1,nativeRowOff:0};n-=l,r++}throw new Error("Excel 图片锚点超过16384列上限")}function N(e,t,i){const n=v(t.maxImageBytes,16777216),r=v(t.maxTotalImageBytes,32*1024*1024),o=v(t.maxImages,1e3),l=new Map,s=new Map;let a=0;return{write(d,c,h){if(![c.widthMm,c.heightMm,c.leftMm].every(Number.isFinite)||c.widthMm<0||c.heightMm<0||c.leftMm<0)throw new Error("Excel 图片尺寸无效");if(!c.widthMm||!c.heightMm)return h;const g=s.get(c.imageData)??z(c,n);if(g&&s.set(c.imageData,g),!g)return i.push(`${c.nid??c.kind}: Excel 图片仅支持 PNG/JPEG data URI，已跳过`),h;let f=l.get(g.key);if(f===void 0){if(l.size>=o)throw new Error("Excel 唯一图片数量超过预算");if(a+g.bytes>r)throw new Error("Excel 图片总字节数超过预算");f=e.addImage({base64:g.base64,extension:g.extension}),l.set(g.key,f),a+=g.bytes}const u=O(d,h,c.heightMm);return d.addImage(f,{tl:G(d,c.leftMm,h),ext:{width:c.widthMm*96/25.4,height:c.heightMm*96/25.4},editAs:"oneCell"}),u}}}function B(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function A(e,t){const i=e.meta?.xlsxFlow;if(i===void 0)return;if(!B(i)||i.version!=="1.0"||!Number.isSafeInteger(i.columnStart)||Number(i.columnStart)<0)throw new Error("Excel 多区域几何标记无效，不能按列序猜测输出");if(!e.grid)throw new Error("Excel 多区域输出只接受显式网格组件");const n=i,r=e.grid.colWidthsMm;if(!r?.length||n.columnStart+r.length>t.length||r.some((o,l)=>Math.abs(o-t[n.columnStart+l])>.001))throw new Error("Excel 多区域列位置与网格列宽不一致");return n}function I(e){const t=e.meta?.xlsxFlow;if(t===void 0){if(e.components.some(n=>n.meta?.xlsxFlow!==void 0))throw new Error("Excel 多区域页面缺少完整列几何标记");return}const i=L(t,e.meta?.reportScope);for(const n of e.components){const r=A(n,i.widths);if(!r)throw new Error("Excel 多区域页面混入没有区域几何的组件，请使用独立页面模板");const o=i.widths.slice(0,r.columnStart).reduce((s,a)=>s+a,e.marginLeftMm??0),l=n.grid.colWidthsMm.reduce((s,a)=>s+a,0);if(Math.abs(o-n.leftMm)>.01||Math.abs(l-n.widthMm)>.01)throw new Error("Excel 多区域标记与真实横向位置不一致")}return i}function L(e,t){if(!B(e)||e.version!=="1.0"||typeof e.sheet!="string"||!e.sheet.trim()||typeof e.templateId!="string"||!e.templateId.trim())throw new Error("Excel 多区域工作表标识无效");if(!Array.isArray(e.fullWidthsMm)||!e.fullWidthsMm.length||e.fullWidthsMm.length>16384||e.fullWidthsMm.some(i=>typeof i!="number"||!Number.isFinite(i)||i<=0||i>2e3))throw new Error("Excel 多区域完整列宽无效");if(t!==void 0&&(typeof t!="string"||!t.trim()))throw new Error("Excel 多区域报表命名空间无效");return{key:JSON.stringify([t??e.templateId,e.sheet]),sheet:e.sheet,widths:e.fullWidthsMm}}function S(e){return Math.round(e*1e6)/1e6}function D(e,t,i,n,r){return e.components.filter(o=>n?o.pageAnchor==="header"?t===0:o.pageAnchor==="footer"?t===i-1:o.table?.role!=="header"?!0:r.has(o.table.id)?!1:(r.add(o.table.id),!0):!0)}function j(e,t,i,n){const r=e.components.filter(l=>!t.includes(l)&&l.table?.role==="header"),o=t.filter(l=>!l.pageAnchor).reduce((l,s)=>Math.max(l,s.topMm+s.heightMm),e.marginTopMm??0);return t.map(l=>{let s=l.topMm;return i&&l.pageAnchor==="footer"&&(s=o),s-=r.filter(a=>a.topMm+a.heightMm<=s+.001).reduce((a,d)=>a+d.heightMm,0),{component:l,layout:R.resolveGridLayout(l.grid,l.widthMm,l.heightMm),top:s,column:A(l,n).columnStart}})}function _(e,t,i){const n=t.length-1;if(n*i.length>1e6)throw new Error("Excel 多区域单页超过 100 万几何单元格，请减小预览分页高度或列数");const r=new Map(t.map((s,a)=>[s,a])),o=new Map,l=new Map;for(const s of e)for(const a of s.layout.cells){if(!Object.keys(a.cell).length)continue;const d=r.get(S(s.top+a.yMm)),c=r.get(S(s.top+a.yMm+a.heightMm)),h=s.column+a.ci,g=h+(a.cell.colSpan??1),f=`${d}:${h}`;for(let u=d;u<c;u++)for(let x=h;x<g;x++){const M=`${u}:${x}`;if(l.has(M))throw new Error("Excel 多区域实际单元格互相覆盖，已终止输出，未覆盖已有内容");l.set(M,f)}o.set(f,{...a.cell,style:C.mergeComponentStyles(s.component.style,a.cell.style),rowSpan:c-d,colSpan:g-h})}return Array.from({length:n},(s,a)=>{const d=[];for(let c=0;c<i.length;c++){const h=`${a}:${c}`,g=o.get(h);g?(d.push(g),c+=(g.colSpan??1)-1):l.has(h)||d.push(null)}return d})}function H(e,t){const i=new Set,n=[];let r;for(const[o,{page:l}]of e.entries()){const s=I(l);if(r&&(s.key!==r.key||s.widths.length!==r.widths.length||s.widths.some((f,u)=>Math.abs(f-r.widths[u])>.001)))throw new Error("Excel 多区域分页的工作表或列结构不一致");r??=s;const a=D(l,o,e.length,t,i),d=j(l,a,t,s.widths);if(!d.length)continue;const c=[...new Set(d.flatMap(f=>[...f.layout.rows.map(u=>S(f.top+u.pos)),S(f.top+f.component.heightMm)]))].sort((f,u)=>f-u),h=_(d,c,s.widths),g=c.slice(1).map((f,u)=>f-c[u]);n.push({kind:"rect",leftMm:0,topMm:0,widthMm:s.widths.reduce((f,u)=>f+u,0),heightMm:g.reduce((f,u)=>f+u,0),grid:{cells:h,colWidthsMm:s.widths,rowHeightsMm:g}})}return n}const T=72/25.4,q=32767,X=253;function b(e,t){if(typeof e!="string")return;if(e.length>q)throw new Error(`Excel 单元格 ${t} 最多支持 32767 个字符，无法无损导出；内容未裁剪`);let i=0;for(let n=0;n<e.length;n++)if(e.charCodeAt(n)===10&&++i>X)throw new Error(`Excel 单元格 ${t} 最多支持 253 个换行，无法无损导出；内容未改写`)}function E(e){if(!e)return;const t=e.replace("#","");return/^[0-9a-fA-F]{6}$/.test(t)?`FF${t.toUpperCase()}`:void 0}function F(e,t={}){e.font={name:t.fontFamily,bold:t.bold===!0,italic:t.italic===!0,underline:t.underline===!0,size:C.resolveFontSize(t).fontSizePt,color:E(t.color)?{argb:E(t.color)}:void 0}}const y={a3:{width:297,height:420,code:8},a4:{width:210,height:297,code:9},a5:{width:148,height:210,code:11}};function K(e,t,i,n){if(t&&t!=="auto")return y[t].code;const r=Math.min(e.pageWidthMm,e.pageHeightMm),o=Math.max(e.pageWidthMm,e.pageHeightMm),l=Object.values(y).find(s=>Math.abs(r-s.width)<=1&&Math.abs(o-s.height)<=1);return l?l.code:(n.push(`page ${i+1}: 自定义纸张 ${e.pageWidthMm}×${e.pageHeightMm}mm 无对应 Excel 纸型，打印设置回退 A4；可显式配置 paperSize`),y.a4.code)}function J(e,t,i,n){const r=typeof t.text=="string"?t.text:"";if(i!=="raw"||!Object.prototype.hasOwnProperty.call(t,"value")){b(r,e.address),e.value=r;return}const o=t.value;if(o===null||typeof o=="string"||typeof o=="boolean"||typeof o=="number"&&Number.isFinite(o)){b(o,e.address),e.value=o,t.numberFormat&&(e.numFmt=t.numberFormat);return}b(r,e.address),e.value=r,n.push(`原始单元格值无效，已保留显示文本：${e.address}`)}function U(e){const t=I(e);return t?{id:`xlsx-flow:${t.key}`,title:t.sheet,wide:!0,flow:!0}:V(e)}function V(e){const i=e.components.filter(n=>n.table!==void 0)[0]?.table;if(!(!i||typeof i.id!="string"||!i.id.trim()||!Array.isArray(i.columnKeys)||!i.columnKeys.length)){for(const n of e.components){if(n.table){if(!n.grid||n.table.id!==i.id)return;continue}if(n.grid||n.kind!=="text"&&!W.isImageBackedComponent(n)||n.richParagraphs?.length&&!n.text&&!n.lines?.length)return}return{id:i.id,title:i.title,wide:i.layout==="wide"||e.layout==="wide"}}}function Z(e,t){const i=new Set;for(const[n,r]of e.pages.entries())if(!t[n])for(const o of r.components)typeof o.table?.id=="string"&&i.add(o.table.id);return i}function k(e){return e.layout==="wide"||e.components.some(t=>t.table?.layout==="wide")}function Q(e,t,i){const n=[],r=e.pages.map(U),o=Z(e,r);for(const[l,s]of e.pages.entries()){const a=r[l],d=a&&!o.has(a.id),c=t==="pages"||!d?void 0:a;if(t==="continuous"&&!c)throw new Error(`page ${l+1}: continuous Excel 需要完整、单一的逻辑表来源；自由布局请使用 sheetMode: 'pages'`);const h=c!==void 0&&(t==="continuous"||c.wide);!h&&t!=="pages"&&k(s)&&i.push(`page ${l+1}: 混合或缺少逻辑表来源，已保留独立 Sheet，未猜测合并内容`);const g=n[n.length-1];h&&g?.continuous&&g.tableId===c.id?g.pages.push({page:s,index:l}):n.push({pages:[{page:s,index:l}],continuous:h,...h?{tableId:c.id,title:c.title}:{},...a?.flow?{flow:!0,title:a.title}:{}})}return n}function $(e,t,i){return!e||e.length===t.length&&e.every((n,r)=>i(n,t[r]))}function Y(e,t,i,n){const r=e.table,o=t.columns.map(a=>a.size),l=$(n.keys,r.columnKeys,(a,d)=>a===d),s=$(n.widths,o,(a,d)=>Math.abs(a-d)<=.001);if(r.columnKeys.length!==o.length||!l||!s)throw new Error(`page ${i+1}: 连续 Excel 逻辑表 ${r.id} 的列结构或列宽不一致`);if(n.keys??=r.columnKeys,n.widths??=o,r.role==="header"){if(r.rowIndex!==-1)throw new Error(`page ${i+1}: 连续 Excel 表头 rowIndex 必须为 -1`);n.headerSeen=!0}else{if(!["body","group-header","subtotal","grand-total"].includes(r.role)||r.rowIndex!==n.expectedRow)throw new Error(`page ${i+1}: 连续 Excel 逻辑行来源不连续或重复（期望 ${n.expectedRow}）`);n.expectedRow+=t.rows.length}if(t.cells.some(a=>a.cell.children?.length))throw new Error(`page ${i+1}: 连续 Excel 暂不支持嵌套组件；请使用独立 Sheet 导出并检查告警`)}function ee(e,t){const i={expectedRow:0,headerSeen:!1};for(const{page:n,index:r}of e.pages)for(const o of n.components){const l=t.get(o);o.table&&l&&Y(o,l,r,i)}if(!i.headerSeen)throw new Error("连续 Excel 逻辑表缺少明确表头来源")}function te(e,t,i){let n=(e?.replace(/[\\/*?:[\]]/g," ").replace(/\s+/g," ").trim()||`Sheet${t+1}`).slice(0,31).replace(/^'+|'+$/g,"").trim()||`Sheet${t+1}`;n.toLowerCase()==="history"&&(n+=" 报表");let r=n,o=1;for(;i.has(r.toLowerCase());){const l=` (${++o})`;r=n.slice(0,31-l.length)+l}return i.add(r.toLowerCase()),r}function ne(e){const t=new Set;function i(n,r,o,l){return n<=r?n:(t.has(o)||(e.push(l),t.add(o)),r)}return{column:n=>i(n,255,"column","Excel 单列宽度上限为 255 字符，超宽列已收敛至 255；单元格值完整保留，显示范围可能受限"),row:n=>i(n,409,"row","Excel 行高上限为 409pt，超高行已收敛至 409pt；单元格值完整保留，显示范围可能受限")}}function ie(e){const t=e.flow?H(e.pages,e.continuous).map(o=>({comp:o,pageIndex:e.pages[0].index})):e.pages.flatMap(({page:o,index:l},s)=>o.components.filter(a=>!e.continuous||(a.pageAnchor!=="header"||s===0)&&(a.pageAnchor!=="footer"||s===e.pages.length-1)).map(a=>({comp:a,pageIndex:l}))),i=new Map;let n=1,r=0;for(const{comp:o}of t)if(o.grid){const l=R.resolveGridLayout(o.grid,o.widthMm,o.heightMm);i.set(o,l),n=Math.max(n,l.columns.length)}else o.kind==="text"&&(r=Math.max(r,o.widthMm));if(n>16384)throw new Error("Excel 最多支持 16384 列，无法无损导出此报表");return{components:t,grids:i,columnCount:n,textWidthMm:r}}function re(e,t,i){const{page:n,index:r}=e.pages[0],o=t!==void 0&&t!=="auto";return(e.continuous||k(n))&&!o?{}:{pageSetup:{paperSize:K(n,t,r,i),orientation:n.pageWidthMm>n.pageHeightMm?"landscape":"portrait",fitToPage:!0,...e.continuous?{fitToWidth:1,fitToHeight:0}:{}}}}function oe(e){const t=E(e.borderColor??e.lineColor),i={style:"thin",...t?{color:{argb:t}}:{}};return{...e.borderTop!==!1?{top:i}:{},...e.borderLeft!==!1?{left:i}:{},...e.borderBottom!==!1?{bottom:i}:{},...e.borderRight!==!1?{right:i}:{}}}function le(e,t){e.alignment={horizontal:t.align??"left",vertical:t.verticalAlign??"middle",wrapText:!0};const i=E(t.backgroundColor);i&&(e.fill={type:"pattern",pattern:"solid",fgColor:{argb:i}}),e.border=oe(t),F(e,t)}function se(e,t){for(const[i,n]of t.columns.entries()){const r=e.sheet.getColumn(i+1),o=e.limits.column(w.mmToExcelColumnWidth(n.size));(r.width==null||r.width<o)&&(r.width=o)}}function ae(e,t,i){for(const[n,r]of t.rows.entries()){const o=e.sheet.getRow(i+n),l=e.limits.row(r.size*T);(o.height==null||o.height<l)&&(o.height=l)}}function ce(e,t,i,n){const r=Math.max(1,Math.min(t.cell.colSpan??1,i.columns.length-t.ci)),o=Math.max(1,Math.min(t.cell.rowSpan??1,i.rows.length-t.ri));(r>1||o>1)&&e.mergeCells(n+t.ri,t.ci+1,n+t.ri+o-1,t.ci+r)}function de(e,t,i,n,r){if(n+i.rows.length-1>1048576)throw new Error("Excel 最多支持 1048576 行，无法无损导出此报表");ae(e,i,n);for(const o of i.cells){const l=e.sheet.getCell(n+o.ri,o.ci+1);J(l,o.cell,e.valueMode,e.warnings),o.cell.children?.length&&e.warnings.push(`page ${r+1} ${t.nid??t.kind} cell ${o.ri+1}:${o.ci+1}: 嵌套组件内容暂不支持 xlsx 导出，已跳过`),le(l,C.mergeComponentStyles(t.style,o.cell.style)),o.cell.indentMm&&(l.alignment={...l.alignment,indent:Math.min(250,Math.max(1,Math.round(o.cell.indentMm/2.5)))}),ce(e.sheet,o,i,n)}return n+i.rows.length}function he(e,t,i,n,r){const o=Array.isArray(t.lines)&&t.lines.length>0?t.lines.join(`
-`):t.text??"";if(t.richParagraphs?.length){const d=o.length===0?"富文本内容暂不支持 xlsx 导出，已跳过":"富文本按已有文本回退导出，内联样式未保留";e.warnings.push(`page ${r+1} ${t.nid??t.kind}: ${d}`)}const l=e.sheet.getRow(i),s=l.getCell(1);b(o,s.address),s.value=o,s.alignment={horizontal:t.style?.align??"left",vertical:t.style?.verticalAlign??"middle",wrapText:!0};const a=E(t.style?.backgroundColor);return a&&(s.fill={type:"pattern",pattern:"solid",fgColor:{argb:a}}),F(s,t.style),n>1&&e.sheet.mergeCells(i,1,i,n),l.height=e.limits.row(t.heightMm*T),i+1}function ge(e,t,i){const n=t+i-1;e.views=[{state:"frozen",ySplit:n,xSplit:0}],e.pageSetup.printTitlesRow=`1:${n}`}function fe(e,t,i,n){!t.grids.size&&t.textWidthMm>0&&(e.sheet.getColumn(1).width=e.limits.column(w.mmToExcelColumnWidth(t.textWidthMm)));for(const l of t.grids.values())se(e,l);let r=1,o=!1;for(const{comp:l,pageIndex:s}of t.components){const a=i&&l.table?.role==="header";if(a&&o)continue;if(r>1048576)throw new Error("Excel 最多支持 1048576 行，无法无损导出此报表");const d=t.grids.get(l);d?(a&&(ge(e.sheet,r,d.rows.length),o=!0),r=de(e,l,d,r,s)):l.kind==="text"?r=he(e,l,r,t.columnCount,s):W.isImageBackedComponent(l)?r=n.write(e.sheet,l,r):e.warnings.push(`page ${s+1} ${l.nid??l.kind}: 组件类型 ${l.kind} 暂不支持 xlsx 导出，已跳过`)}}function ue(e){if(e.valueMode!==void 0&&e.valueMode!=="text"&&e.valueMode!=="raw")throw new Error("xlsx valueMode 必须是 text 或 raw");if(e.paperSize!==void 0&&e.paperSize!=="auto"&&!Object.prototype.hasOwnProperty.call(y,e.paperSize))throw new Error("xlsx paperSize 必须是 auto、a3、a4 或 a5");if(e.sheetMode!==void 0&&!["auto","pages","continuous"].includes(e.sheetMode))throw new Error("xlsx sheetMode 必须是 auto、pages 或 continuous")}async function me(e,t={}){ue(t),p.assertOutputActive(t.signal);const i=P.reportOutputDiagnostics(e,"xlsx",t),n=new w.ExcelJSRuntime.Workbook,r=[],o=N(n,t,r),l=ne(r),s=Q(e,t.sheetMode,r),a=new Set;for(const[c,h]of s.entries()){const g=ie(h);h.continuous&&!h.flow&&ee(h,g.grids);const f=h.pages[0].page,u=t.sheetName?.(c)??te(h.title,c,a);a.add(u.toLowerCase());const x=n.addWorksheet(u,re(h,t.paperSize,r)),M=t.valueMode??(k(f)||h.continuous||h.flow?"raw":"text");p.assertOutputActive(t.signal),fe({sheet:x,warnings:r,limits:l,valueMode:M},g,h.continuous,o),await p.outputCheckpoint(t,c+1,s.length)}p.assertOutputActive(t.signal);const d=await n.xlsx.writeBuffer();return p.assertOutputActive(t.signal),{workbook:n,buffer:d,warnings:r,diagnostics:i}}exports.importExcelTemplate=w.importExcelTemplate;exports.inspectExcelWorkbook=w.inspectExcelWorkbook;exports.openExcelWorkbook=w.openExcelWorkbook;exports.bindExcelTemplate=m.bindExcelTemplate;exports.createExcelBindingDocument=m.createExcelBindingDocument;exports.createExcelBindingSession=m.createExcelBindingSession;exports.createExcelRegionBindingDocument=m.createExcelRegionBindingDocument;exports.createExcelRegionBindingSession=m.createExcelRegionBindingSession;exports.excelBindingCellRange=m.excelBindingCellRange;exports.excelBindingRowRange=m.excelBindingRowRange;exports.getExcelSheetWindow=m.getExcelSheetWindow;exports.parseExcelBindingSession=m.parseExcelBindingSession;exports.parseExcelRegionBindingSession=m.parseExcelRegionBindingSession;exports.validateExcelBindingFields=m.validateExcelBindingFields;exports.validateExcelBindingRecipe=m.validateExcelBindingRecipe;exports.validateExcelBindingRegions=m.validateExcelBindingRegions;exports.validateExcelRegionBindings=m.validateExcelRegionBindings;exports.validateExcelRegionFields=m.validateExcelRegionFields;exports.validateExcelRegionGeometry=m.validateExcelRegionGeometry;exports.renderPlanToXlsx=me;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=require("./progress-B0ctFpKf.cjs"),w=require("./workbook-session-Bjv1YCRK.cjs"),R=require("./render-plan-7xpGrCEl.cjs"),P=require("./media-B7vnpD8k.cjs"),A=require("./grid-geometry-CZ_cYB6O.cjs"),b=require("./style-UgIJSA1F.cjs"),z=require("./capabilities-CAh2Nrue.cjs"),m=require("./region-binding-workflow-DIYJdCUr.cjs");function O(e,t,r){let n=r*72/25.4;if(!Number.isFinite(n)||t+Math.ceil(n/409)-1>1048576)throw new Error("Excel 图片占位超过工作表行数上限");for(;n>0;){if(t>1048576)throw new Error("Excel 图片占位超过工作表行数上限");const o=Math.min(409,n);e.getRow(t++).height=o,n-=o}return t}function N(e,t,r){let n=Math.round(t*36e3),o=0;if(!Number.isSafeInteger(n))throw new Error("Excel 图片锚点超出安全坐标范围");for(e.properties.defaultColWidth??=8.43;o<16384;){const l=e.getColumn(o+1).width??e.properties.defaultColWidth,i=Math.round(w.excelColumnWidthToMm(l)*36e3);if(!Number.isSafeInteger(i)||i<=0)throw new Error("Excel 图片锚点所在列宽无效");if(n<i)return{col:o+n/i,row:r-1,nativeCol:o,nativeColOff:n,nativeRow:r-1,nativeRowOff:0};n-=i,o++}throw new Error("Excel 图片锚点超过16384列上限")}function L(e,t,r){let n=r*72/25.4;if(!Number.isFinite(n)||Math.abs(n)>1048576*409)throw new Error("Excel 图片纵向偏移超过工作表范围");const o=l=>{const i=e.getRow(l).height??e.properties.defaultRowHeight??15;if(!Number.isFinite(i)||i<=0)throw new Error("Excel 图片锚点所在行高无效");return i};for(;n<0&&t>1;)n+=o(--t);for(;t<=1048576&&n>=o(t);)n-=o(t++);if(t>1048576||n<0)throw new Error("Excel 图片移动到工作表边界之外");return{nativeRow:t-1,nativeRowOff:Math.round(n*25.4/72*36e3)}}function G(e,t,r){const n=P.createImageMediaInspector(t),o=new Map;return{write(l,i,a,s){if(![i.widthMm,i.heightMm,i.leftMm].every(Number.isFinite)||i.widthMm<0||i.heightMm<0||i.leftMm<0)throw new Error("Excel 图片尺寸无效");if(!i.widthMm||!i.heightMm)return a;if(!i.imageData||!/^data:image\/(png|jpe?g);base64,/i.test(i.imageData))return r.push(`${i.nid??i.kind}: Excel 图片仅支持 PNG/JPEG data URI，已跳过`),a;const c=n(i.imageData);let d=o.get(c.dataUrl);d===void 0&&(d=e.addImage({base64:c.dataUrl,extension:c.extension}),o.set(c.dataUrl,d));const h=s?a:O(l,a,i.heightMm);return l.addImage(d,{tl:{...N(l,s?.leftMm??i.leftMm,a),...s?L(l,a,s.offsetMm):{}},ext:{width:i.widthMm*96/25.4,height:i.heightMm*96/25.4},editAs:"oneCell"}),h}}}function W(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function B(e,t){const r=e.meta?.xlsxFlow;if(r===void 0)return;if(!W(r)||r.version!=="1.0"||!Number.isSafeInteger(r.columnStart)||Number(r.columnStart)<0)throw new Error("Excel 多区域几何标记无效，不能按列序猜测输出");if(!e.grid)throw new Error("Excel 多区域输出只接受显式网格组件");const n=r,o=e.grid.colWidthsMm;if(!o?.length||n.columnStart+o.length>t.length||o.some((l,i)=>Math.abs(l-t[n.columnStart+i])>.001))throw new Error("Excel 多区域列位置与网格列宽不一致");return n}function $(e){const t=e.meta?.xlsxFlow;if(t===void 0){if(e.components.some(n=>n.meta?.xlsxFlow!==void 0))throw new Error("Excel 多区域页面缺少完整列几何标记");return}const r=j(t,e.meta?.reportScope);for(const n of e.components){const o=B(n,r.widths);if(!o)throw new Error("Excel 多区域页面混入没有区域几何的组件，请使用独立页面模板");const l=r.widths.slice(0,o.columnStart).reduce((a,s)=>a+s,e.marginLeftMm??0),i=n.grid.colWidthsMm.reduce((a,s)=>a+s,0);if(Math.abs(l-n.leftMm)>.01||Math.abs(i-n.widthMm)>.01)throw new Error("Excel 多区域标记与真实横向位置不一致")}return r}function j(e,t){if(!W(e)||e.version!=="1.0"||typeof e.sheet!="string"||!e.sheet.trim()||typeof e.templateId!="string"||!e.templateId.trim())throw new Error("Excel 多区域工作表标识无效");if(!Array.isArray(e.fullWidthsMm)||!e.fullWidthsMm.length||e.fullWidthsMm.length>16384||e.fullWidthsMm.some(r=>typeof r!="number"||!Number.isFinite(r)||r<=0||r>2e3))throw new Error("Excel 多区域完整列宽无效");if(t!==void 0&&(typeof t!="string"||!t.trim()))throw new Error("Excel 多区域报表命名空间无效");return{key:JSON.stringify([t??e.templateId,e.sheet]),sheet:e.sheet,widths:e.fullWidthsMm}}function v(e){return Math.round(e*1e6)/1e6}function D(e,t,r,n,o){return e.components.filter(l=>n?l.pageAnchor==="header"?t===0:l.pageAnchor==="footer"?t===r-1:l.table?.role!=="header"?!0:o.has(l.table.id)?!1:(o.add(l.table.id),!0):!0)}function H(e,t,r,n){const o=e.components.filter(i=>!t.includes(i)&&i.table?.role==="header"),l=t.filter(i=>!i.pageAnchor).reduce((i,a)=>Math.max(i,a.topMm+a.heightMm),e.marginTopMm??0);return t.map(i=>{let a=i.topMm;return r&&i.pageAnchor==="footer"&&(a=l),a-=o.filter(s=>s.topMm+s.heightMm<=a+.001).reduce((s,c)=>s+c.heightMm,0),{component:i,layout:A.resolveGridLayout(i.grid,i.widthMm,i.heightMm),top:a,column:B(i,n).columnStart}})}function _(e,t,r){const n=t.length-1;if(n*r.length>1e6)throw new Error("Excel 多区域单页超过 100 万几何单元格，请减小预览分页高度或列数");const o=new Map(t.map((a,s)=>[a,s])),l=new Map,i=new Map;for(const a of e)for(const s of a.layout.cells){if(!Object.keys(s.cell).length)continue;const c=o.get(v(a.top+s.yMm)),d=o.get(v(a.top+s.yMm+s.heightMm)),h=a.column+s.ci,u=h+(s.cell.colSpan??1),g=`${c}:${h}`;for(let f=c;f<d;f++)for(let x=h;x<u;x++){const y=`${f}:${x}`;if(i.has(y))throw new Error("Excel 多区域实际单元格互相覆盖，已终止输出，未覆盖已有内容");i.set(y,g)}l.set(g,{...s.cell,style:b.mergeComponentStyles(a.component.style,s.cell.style),rowSpan:d-c,colSpan:u-h})}return Array.from({length:n},(a,s)=>{const c=[];for(let d=0;d<r.length;d++){const h=`${s}:${d}`,u=l.get(h);u?(c.push(u),d+=(u.colSpan??1)-1):i.has(h)||c.push(null)}return c})}function q(e,t){const r=new Set,n=[];let o;for(const[l,{page:i}]of e.entries()){const a=$(i);if(o&&(a.key!==o.key||a.widths.length!==o.widths.length||a.widths.some((g,f)=>Math.abs(g-o.widths[f])>.001)))throw new Error("Excel 多区域分页的工作表或列结构不一致");o??=a;const s=D(i,l,e.length,t,r),c=H(i,s,t,a.widths);if(!c.length)continue;const d=[...new Set(c.flatMap(g=>[...g.layout.rows.map(f=>v(g.top+f.pos)),v(g.top+g.component.heightMm)]))].sort((g,f)=>g-f),h=_(c,d,a.widths),u=d.slice(1).map((g,f)=>g-d[f]);n.push({kind:"rect",leftMm:0,topMm:0,widthMm:a.widths.reduce((g,f)=>g+f,0),heightMm:u.reduce((g,f)=>g+f,0),grid:{cells:h,colWidthsMm:a.widths,rowHeightsMm:u}})}return n}const F=72/25.4,U=32767,X=253;function M(e,t){if(typeof e!="string")return;if(e.length>U)throw new Error(`Excel 单元格 ${t} 最多支持 32767 个字符，无法无损导出；内容未裁剪`);let r=0;for(let n=0;n<e.length;n++)if(e.charCodeAt(n)===10&&++r>X)throw new Error(`Excel 单元格 ${t} 最多支持 253 个换行，无法无损导出；内容未改写`)}function p(e){if(!e)return;const t=e.replace("#","");return/^[0-9a-fA-F]{6}$/.test(t)?`FF${t.toUpperCase()}`:void 0}function T(e,t={}){e.font={name:t.fontFamily,bold:t.bold===!0,italic:t.italic===!0,underline:t.underline===!0,size:b.resolveFontSize(t).fontSizePt,color:p(t.color)?{argb:p(t.color)}:void 0}}const S={a3:{width:297,height:420,code:8},a4:{width:210,height:297,code:9},a5:{width:148,height:210,code:11}};function K(e,t,r,n){if(t&&t!=="auto")return S[t].code;const o=Math.min(e.pageWidthMm,e.pageHeightMm),l=Math.max(e.pageWidthMm,e.pageHeightMm),i=Object.values(S).find(a=>Math.abs(o-a.width)<=1&&Math.abs(l-a.height)<=1);return i?i.code:(n.push(`page ${r+1}: 自定义纸张 ${e.pageWidthMm}×${e.pageHeightMm}mm 无对应 Excel 纸型，打印设置回退 A4；可显式配置 paperSize`),S.a4.code)}function J(e,t,r,n){const o=typeof t.text=="string"?t.text:"";if(r!=="raw"||!Object.prototype.hasOwnProperty.call(t,"value")){M(o,e.address),e.value=o;return}const l=t.value;if(l===null||typeof l=="string"||typeof l=="boolean"||typeof l=="number"&&Number.isFinite(l)){M(l,e.address),e.value=l,t.numberFormat&&(e.numFmt=t.numberFormat);return}M(o,e.address),e.value=o,n.push(`原始单元格值无效，已保留显示文本：${e.address}`)}function V(e){const t=$(e);return t?{id:`xlsx-flow:${t.key}`,title:t.sheet,wide:!0,flow:!0}:Q(e)}function Q(e){const r=e.components.filter(n=>n.table!==void 0)[0]?.table;if(!(!r||typeof r.id!="string"||!r.id.trim()||!Array.isArray(r.columnKeys)||!r.columnKeys.length)){for(const n of e.components){if(n.table){if(!n.grid||n.table.id!==r.id)return;continue}if(n.grid||n.kind!=="text"&&!R.isImageBackedComponent(n))return}return{id:r.id,title:r.title,wide:r.layout==="wide"||e.layout==="wide"}}}function Y(e,t){const r=new Set;for(const[n,o]of e.pages.entries())if(!t[n])for(const l of o.components)typeof l.table?.id=="string"&&r.add(l.table.id);return r}function C(e){return e.layout==="wide"||e.components.some(t=>t.table?.layout==="wide")}function Z(e,t,r){const n=[],o=e.pages.map(V),l=Y(e,o);for(const[i,a]of e.pages.entries()){const s=o[i],c=s&&!l.has(s.id),d=t==="pages"||!c?void 0:s;if(t==="continuous"&&!d)throw new Error(`page ${i+1}: continuous Excel 需要完整、单一的逻辑表来源；自由布局请使用 sheetMode: 'pages'`);const h=d!==void 0&&(t==="continuous"||d.wide);!h&&t!=="pages"&&C(a)&&r.push(`page ${i+1}: 混合或缺少逻辑表来源，已保留独立 Sheet，未猜测合并内容`);const u=n[n.length-1];h&&u?.continuous&&u.tableId===d.id?u.pages.push({page:a,index:i}):n.push({pages:[{page:a,index:i}],continuous:h,...h?{tableId:d.id,title:d.title}:{},...s?.flow?{flow:!0,title:s.title}:{}})}return n}function k(e,t,r){return!e||e.length===t.length&&e.every((n,o)=>r(n,t[o]))}function ee(e,t,r,n){const o=e.table,l=t.columns.map(s=>s.size),i=k(n.keys,o.columnKeys,(s,c)=>s===c),a=k(n.widths,l,(s,c)=>Math.abs(s-c)<=.001);if(o.columnKeys.length!==l.length||!i||!a)throw new Error(`page ${r+1}: 连续 Excel 逻辑表 ${o.id} 的列结构或列宽不一致`);if(n.keys??=o.columnKeys,n.widths??=l,o.role==="header"){if(o.rowIndex!==-1)throw new Error(`page ${r+1}: 连续 Excel 表头 rowIndex 必须为 -1`);n.headerSeen=!0}else{if(!["body","group-header","subtotal","grand-total"].includes(o.role)||o.rowIndex!==n.expectedRow)throw new Error(`page ${r+1}: 连续 Excel 逻辑行来源不连续或重复（期望 ${n.expectedRow}）`);n.expectedRow+=t.rows.length}if(t.cells.some(s=>s.cell.children?.length))throw new Error(`page ${r+1}: 连续 Excel 暂不支持嵌套组件；请使用独立 Sheet 导出并检查告警`)}function te(e,t){const r={expectedRow:0,headerSeen:!1};for(const{page:n,index:o}of e.pages)for(const l of n.components){const i=t.get(l);l.table&&i&&ee(l,i,o,r)}if(!r.headerSeen)throw new Error("连续 Excel 逻辑表缺少明确表头来源")}function ne(e,t,r){let n=(e?.replace(/[\\/*?:[\]]/g," ").replace(/\s+/g," ").trim()||`Sheet${t+1}`).slice(0,31).replace(/^'+|'+$/g,"").trim()||`Sheet${t+1}`;n.toLowerCase()==="history"&&(n+=" 报表");let o=n,l=1;for(;r.has(o.toLowerCase());){const i=` (${++l})`;o=n.slice(0,31-i.length)+i}return r.add(o.toLowerCase()),o}function ie(e){const t=new Set;function r(n,o,l,i){return n<=o?n:(t.has(l)||(e.push(i),t.add(l)),o)}return{column:n=>r(n,255,"column","Excel 单列宽度上限为 255 字符，超宽列已收敛至 255；单元格值完整保留，显示范围可能受限"),row:n=>r(n,409,"row","Excel 行高上限为 409pt，超高行已收敛至 409pt；单元格值完整保留，显示范围可能受限")}}async function re(e,t){const r=e.flow?q(e.pages,e.continuous).map(i=>({comp:i,pageIndex:e.pages[0].index})):e.pages.flatMap(({page:i,index:a},s)=>i.components.filter(c=>!e.continuous||(c.pageAnchor!=="header"||s===0)&&(c.pageAnchor!=="footer"||s===e.pages.length-1)).map(c=>({comp:c,pageIndex:a}))),n=new Map;let o=1,l=0;for(const{comp:i}of r)if(i.grid){const a=A.resolveGridLayout(i.grid,i.widthMm,i.heightMm);n.set(i,a),o=Math.max(o,a.columns.length);const s=t(a.cells.length);s&&await s}else i.kind==="text"&&(l=Math.max(l,i.widthMm));if(o>16384)throw new Error("Excel 最多支持 16384 列，无法无损导出此报表");return{components:r,grids:n,columnCount:o,textWidthMm:l}}function oe(e,t,r){const{page:n,index:o}=e.pages[0],l=t!==void 0&&t!=="auto";return(e.continuous||C(n))&&!l?{}:{pageSetup:{paperSize:K(n,t,o,r),orientation:n.pageWidthMm>n.pageHeightMm?"landscape":"portrait",fitToPage:!0,...e.continuous?{fitToWidth:1,fitToHeight:0}:{}}}}function le(e){const t=p(e.borderColor??e.lineColor),r={style:"thin",...t?{color:{argb:t}}:{}};return{...e.borderTop!==!1?{top:r}:{},...e.borderLeft!==!1?{left:r}:{},...e.borderBottom!==!1?{bottom:r}:{},...e.borderRight!==!1?{right:r}:{}}}function ae(e,t){e.alignment={horizontal:t.align??"left",vertical:t.verticalAlign??"middle",wrapText:!0};const r=p(t.backgroundColor);r&&(e.fill={type:"pattern",pattern:"solid",fgColor:{argb:r}}),e.border=le(t),T(e,t)}function se(e,t){for(const[r,n]of t.columns.entries()){const o=e.sheet.getColumn(r+1),l=e.limits.column(w.mmToExcelColumnWidth(n.size));(o.width==null||o.width<l)&&(o.width=l)}}function ce(e,t,r){for(const[n,o]of t.rows.entries()){const l=e.sheet.getRow(r+n),i=e.limits.row(o.size*F);(l.height==null||l.height<i)&&(l.height=i)}}function de(e,t,r,n){const o=Math.max(1,Math.min(t.cell.colSpan??1,r.columns.length-t.ci)),l=Math.max(1,Math.min(t.cell.rowSpan??1,r.rows.length-t.ri));(o>1||l>1)&&e.mergeCells(n+t.ri,t.ci+1,n+t.ri+l-1,t.ci+o)}async function he(e,t,r,n,o){if(n+r.rows.length-1>1048576)throw new Error("Excel 最多支持 1048576 行，无法无损导出此报表");ce(e,r,n);for(const l of r.cells){const i=e.sheet.getCell(n+l.ri,l.ci+1);J(i,l.cell,e.valueMode,e.warnings),l.cell.children?.length&&e.warnings.push(`page ${o+1} ${t.nid??t.kind} cell ${l.ri+1}:${l.ci+1}: 嵌套组件内容暂不支持 xlsx 导出，已跳过`),ae(i,b.mergeComponentStyles(t.style,l.cell.style)),l.cell.indentMm&&(i.alignment={...i.alignment,indent:Math.min(250,Math.max(1,Math.round(l.cell.indentMm/2.5)))}),de(e.sheet,l,r,n);const a=e.schedule();a&&await a}return n+r.rows.length}function ue(e,t,r,n){const o=Array.isArray(t.lines)&&t.lines.length>0?t.lines.join(`
+`):t.text??"",l=e.sheet.getRow(r),i=l.getCell(1);t.richParagraphs?.length||M(o,i.address),i.value=t.richParagraphs?.length?{richText:t.richParagraphs.flatMap((s,c)=>[...c?[{text:`
+`}]:[],...s.segments.map(d=>{const h=b.mergeComponentStyles(t.style,d.style);return{text:d.kind==="field"?d.field??"":d.text??"",font:{name:h.fontFamily,bold:h.bold,italic:h.italic,underline:h.underline,size:b.resolveFontSize(h).fontSizePt,...p(h.color)?{color:{argb:p(h.color)}}:{}}}})])}:o,typeof i.value=="object"&&i.value&&"richText"in i.value&&M(i.value.richText.map(s=>s.text).join(""),i.address),i.alignment={horizontal:t.style?.align??"left",vertical:t.style?.verticalAlign??"middle",wrapText:!0};const a=p(t.style?.backgroundColor);return a&&(i.fill={type:"pattern",pattern:"solid",fgColor:{argb:a}}),T(i,t.style),n>1&&e.sheet.mergeCells(r,1,r,n),l.height=e.limits.row(t.heightMm*F),r+1}function ge(e,t,r){const n=t+r-1;e.views=[{state:"frozen",ySplit:n,xSplit:0}],e.pageSetup.printTitlesRow=`1:${n}`}async function fe(e,t,r,n){!t.grids.size&&t.textWidthMm>0&&(e.sheet.getColumn(1).width=e.limits.column(w.mmToExcelColumnWidth(t.textWidthMm)));for(const i of t.grids.values()){se(e,i);const a=e.schedule(i.columns.length);a&&await a}let o=1,l=!1;for(const{comp:i,pageIndex:a}of t.components){const s=r&&i.table?.role==="header";if(s&&l)continue;if(o>1048576)throw new Error("Excel 最多支持 1048576 行，无法无损导出此报表");const c=t.grids.get(i);if(c)s&&(ge(e.sheet,o,c.rows.length),l=!0),o=await he(e,i,c,o,a);else if(i.kind==="text")o=ue(e,i,o,t.columnCount);else if(R.isImageBackedComponent(i)){const d=w.importedImageOverlay(i,r),h=n.write(e.sheet,i,d?.row??o,d);d||(o=h)}else e.warnings.push(`page ${a+1} ${i.nid??i.kind}: 组件类型 ${i.kind} 暂不支持 xlsx 导出，已跳过`)}}function me(e){if(e.valueMode!==void 0&&e.valueMode!=="text"&&e.valueMode!=="raw")throw new Error("xlsx valueMode 必须是 text 或 raw");if(e.paperSize!==void 0&&e.paperSize!=="auto"&&!Object.prototype.hasOwnProperty.call(S,e.paperSize))throw new Error("xlsx paperSize 必须是 auto、a3、a4 或 a5");if(e.sheetMode!==void 0&&!["auto","pages","continuous"].includes(e.sheetMode))throw new Error("xlsx sheetMode 必须是 auto、pages 或 continuous")}async function we(e,t={}){me(t),E.assertOutputActive(t.signal);const r=z.reportOutputDiagnostics(e,"xlsx",t),n=new w.ExcelJSRuntime.Workbook,o=[],l=G(n,t,o),i=ie(o),a=Z(e,t.sheetMode,o),s=new Set,c=E.createOutputScheduler(t);for(const[h,u]of a.entries()){const g=await re(u,c);u.continuous&&!u.flow&&te(u,g.grids);const f=u.pages[0].page,x=t.sheetName?.(h)??ne(u.title,h,s);s.add(x.toLowerCase());const y=n.addWorksheet(x,oe(u,t.paperSize,o)),I=t.valueMode??(C(f)||u.continuous||u.flow?"raw":"text");E.assertOutputActive(t.signal),await fe({sheet:y,warnings:o,limits:i,valueMode:I,schedule:c},g,u.continuous,l),await E.outputCheckpoint(t,h+1,a.length)}E.assertOutputActive(t.signal);const d=await n.xlsx.writeBuffer();return E.assertOutputActive(t.signal),{workbook:n,buffer:d,warnings:o,diagnostics:r}}exports.importExcelTemplate=w.importExcelTemplate;exports.inspectExcelWorkbook=w.inspectExcelWorkbook;exports.openExcelWorkbook=w.openExcelWorkbook;exports.bindExcelTemplate=m.bindExcelTemplate;exports.createExcelBindingDocument=m.createExcelBindingDocument;exports.createExcelBindingSession=m.createExcelBindingSession;exports.createExcelRegionBindingDocument=m.createExcelRegionBindingDocument;exports.createExcelRegionBindingSession=m.createExcelRegionBindingSession;exports.excelBindingCellRange=m.excelBindingCellRange;exports.excelBindingRowRange=m.excelBindingRowRange;exports.getExcelSheetWindow=m.getExcelSheetWindow;exports.parseExcelBindingSession=m.parseExcelBindingSession;exports.parseExcelRegionBindingSession=m.parseExcelRegionBindingSession;exports.validateExcelBindingFields=m.validateExcelBindingFields;exports.validateExcelBindingRecipe=m.validateExcelBindingRecipe;exports.validateExcelBindingRegions=m.validateExcelBindingRegions;exports.validateExcelRegionBindings=m.validateExcelRegionBindings;exports.validateExcelRegionFields=m.validateExcelRegionFields;exports.validateExcelRegionGeometry=m.validateExcelRegionGeometry;exports.renderPlanToXlsx=we;

package/dist/xlsx.d.cts

@@ -1248,6 +1248,19 @@ declare interface ImageHyperlinkValue {
     	tooltip?: string;
 }
 
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+export declare interface ImageMediaOptions {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
+
 declare interface ImagePosition {
     	tl: { col: number; row: number };
     	ext: { width: number; height: number };
@@ -1447,7 +1460,7 @@ declare interface Media {
 export declare function openExcelWorkbook(input: ArrayBuffer | Uint8Array | Blob, options?: ExcelImportOptions): Promise<ExcelWorkbookSession>;
 
 declare interface OutputDiagnostic {
-    code: "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
+    code: "invalid-image-data" | "image-budget-exceeded" | "component-render-failed" | "unsupported-text" | "output-degraded" | "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
     severity: "warning";
     format: OutputFormat;
     pageIndex: number;
@@ -1796,6 +1809,8 @@ export declare function renderPlanToXlsx(plan: RenderPlan, options?: XlsxRenderO
 
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;
@@ -1855,6 +1870,10 @@ declare interface ReportParamDef {
         label: string;
         value: string;
     }>;
+    /** Opaque host-resolved source key. No URL, credentials or executable code is stored. */
+    optionsSource?: string;
+    /** Select dependencies must be declared parameters; changing a parent clears descendants. */
+    dependsOn?: string[];
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
@@ -3026,14 +3045,7 @@ declare interface Xlsx {
     	write(stream: Stream, options?: Partial<XlsxWriteOptions>): Promise<void>;
 }
 
-declare interface XlsxImageOptions {
-    /** Decoded bytes per unique embedded image; default 16 MiB. */
-    maxImageBytes?: number;
-    /** Total decoded bytes of unique images in this workbook; default 32 MiB. */
-    maxTotalImageBytes?: number;
-    /** Unique embedded media limit, default 1000; repeated placements reuse the same media. */
-    maxImages?: number;
-}
+declare type XlsxImageOptions = ImageMediaOptions;
 
 declare interface XlsxReadOptions {
     	/**
@@ -3048,7 +3060,7 @@ declare interface XlsxReadOptions {
  *   加粗/对齐/底色/字号直译（resolveGridLayout 复用单真相源几何）
  * - 文本组件 → 合并标题行（顺序流式输出，保字号/加粗/对齐；非像素级定位，
  *   目标是"财务能直接用的对账表"而非复刻版面）
- * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
+ * - 原生 richText 保留基础字形；未支持组件、段落专有排版与单元格嵌套组件计入 diagnostics / warnings
  */
 export declare interface XlsxRenderOptions extends OutputDiagnosticOptions, XlsxImageOptions {
     /** 工作表命名（连续表默认使用标题，其余默认 "Sheet1" 起序）。 */

package/dist/xlsx.d.ts

@@ -1248,6 +1248,19 @@ declare interface ImageHyperlinkValue {
     	tooltip?: string;
 }
 
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+export declare interface ImageMediaOptions {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
+
 declare interface ImagePosition {
     	tl: { col: number; row: number };
     	ext: { width: number; height: number };
@@ -1447,7 +1460,7 @@ declare interface Media {
 export declare function openExcelWorkbook(input: ArrayBuffer | Uint8Array | Blob, options?: ExcelImportOptions): Promise<ExcelWorkbookSession>;
 
 declare interface OutputDiagnostic {
-    code: "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
+    code: "invalid-image-data" | "image-budget-exceeded" | "component-render-failed" | "unsupported-text" | "output-degraded" | "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
     severity: "warning";
     format: OutputFormat;
     pageIndex: number;
@@ -1796,6 +1809,8 @@ export declare function renderPlanToXlsx(plan: RenderPlan, options?: XlsxRenderO
 
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;
@@ -1855,6 +1870,10 @@ declare interface ReportParamDef {
         label: string;
         value: string;
     }>;
+    /** Opaque host-resolved source key. No URL, credentials or executable code is stored. */
+    optionsSource?: string;
+    /** Select dependencies must be declared parameters; changing a parent clears descendants. */
+    dependsOn?: string[];
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
@@ -3026,14 +3045,7 @@ declare interface Xlsx {
     	write(stream: Stream, options?: Partial<XlsxWriteOptions>): Promise<void>;
 }
 
-declare interface XlsxImageOptions {
-    /** Decoded bytes per unique embedded image; default 16 MiB. */
-    maxImageBytes?: number;
-    /** Total decoded bytes of unique images in this workbook; default 32 MiB. */
-    maxTotalImageBytes?: number;
-    /** Unique embedded media limit, default 1000; repeated placements reuse the same media. */
-    maxImages?: number;
-}
+declare type XlsxImageOptions = ImageMediaOptions;
 
 declare interface XlsxReadOptions {
     	/**
@@ -3048,7 +3060,7 @@ declare interface XlsxReadOptions {
  *   加粗/对齐/底色/字号直译（resolveGridLayout 复用单真相源几何）
  * - 文本组件 → 合并标题行（顺序流式输出，保字号/加粗/对齐；非像素级定位，
  *   目标是"财务能直接用的对账表"而非复刻版面）
- * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
+ * - 原生 richText 保留基础字形；未支持组件、段落专有排版与单元格嵌套组件计入 diagnostics / warnings
  */
 export declare interface XlsxRenderOptions extends OutputDiagnosticOptions, XlsxImageOptions {
     /** 工作表命名（连续表默认使用标题，其余默认 "Sheet1" 起序）。 */