ooxml-excel-editor 1.1.0 → 1.3.0

package/dist/chunks/toolbar-icons-BcnMin5s.js

@@ -0,0 +1,223 @@
+import { i as p, p as R } from "./plugin-overlay-DLb6sRhU.js";
+const A = Array(17).fill("#000000");
+function I() {
+  return {
+    font: { name: "Calibri", size: 11, bold: !1, italic: !1, underline: !1, strike: !1, color: "#000000" },
+    fill: { type: "none" },
+    borders: {},
+    hAlign: "general",
+    vAlign: "bottom",
+    wrapText: !1,
+    shrinkToFit: !1,
+    textRotation: 0,
+    indent: 0,
+    numFmt: "General"
+  };
+}
+function M(e, o) {
+  return {
+    name: e,
+    index: o,
+    state: "visible",
+    dimension: { rows: 0, cols: 0 },
+    cells: /* @__PURE__ */ new Map(),
+    styles: [I()],
+    merges: [],
+    columns: /* @__PURE__ */ new Map(),
+    rows: /* @__PURE__ */ new Map(),
+    defaultColWidth: 64,
+    defaultRowHeight: 20,
+    freeze: { frozenRows: 0, frozenCols: 0 },
+    conditional: [],
+    dataValidations: [],
+    images: [],
+    charts: [],
+    shapes: [],
+    sparklines: [],
+    showGridLines: !0
+  };
+}
+function b(e, o) {
+  if (e == null || e === "") return { raw: null, type: "empty" };
+  if (typeof e == "number") return { raw: e, type: "number" };
+  if (typeof e == "boolean") return { raw: e, type: "boolean" };
+  if (e instanceof Date) return { raw: e, type: "date" };
+  if (typeof e != "string") return { raw: String(e), type: "string" };
+  if (!o) return { raw: e, type: "string" };
+  const t = e.trim();
+  if (/^[+-]?\d+(\.\d+)?([eE][+-]?\d+)?$/.test(t)) {
+    const s = Number(t);
+    if (Number.isFinite(s)) return { raw: s, type: "number" };
+  }
+  if (/^(TRUE|FALSE)$/i.test(t)) return { raw: /^TRUE$/i.test(t), type: "boolean" };
+  if (/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:?\d{2})?)?$/.test(t)) {
+    const s = new Date(t);
+    if (!isNaN(s.getTime())) return { raw: s, type: "date" };
+  }
+  return { raw: e, type: "string" };
+}
+function z(e, o) {
+  return o.map((t) => e[t]);
+}
+function k(e, o, t = {}) {
+  const s = t.startRow ?? 0, i = t.startCol ?? 0, c = t.autoInfer ?? !0;
+  let l = 0, y = 0, d = !1;
+  if (!o.length) return { lastRow: 0, lastCol: 0, wrote: !1 };
+  const r = o[0], h = r !== null && typeof r == "object" && !Array.isArray(r), x = h ? t.columns ?? Object.keys(r) : [];
+  let f = s;
+  if (h && (t.headerRow ?? !0)) {
+    for (let n = 0; n < x.length; n++) {
+      const a = f, m = i + n;
+      e.cells.set(p(a, m), { row: a, col: m, type: "string", raw: x[n], styleId: 0 }), l = Math.max(l, a), y = Math.max(y, m), d = !0;
+    }
+    f++;
+  }
+  for (let n = 0; n < o.length; n++) {
+    const a = o[n], m = Array.isArray(a) ? a : z(a, x);
+    for (let w = 0; w < m.length; w++) {
+      const u = f + n - (h && (t.headerRow ?? !0), 0), g = i + w, C = b(m[w], c);
+      C.type !== "empty" && (e.cells.set(p(u, g), { row: u, col: g, type: C.type, raw: C.raw, styleId: 0 }), l = Math.max(l, u), y = Math.max(y, g), d = !0);
+    }
+  }
+  return { lastRow: l, lastCol: y, wrote: d };
+}
+function V(e, o = {}) {
+  const t = o.themeColors && o.themeColors.length === 17 ? o.themeColors : A, s = o.autoInfer ?? !0, i = o.headerRow ?? !0;
+  if (e && typeof e == "object" && !Array.isArray(e) && Array.isArray(e.sheets))
+    return { sheets: e.sheets.map((f, n) => {
+      const a = M(f.name || `Sheet${n + 1}`, n), { lastRow: m, lastCol: w, wrote: u } = k(a, f.rows ?? [], { headerRow: i, autoInfer: s });
+      return a.dimension = u ? { rows: m + 1, cols: w + 1 } : { rows: 0, cols: 0 }, a;
+    }), activeSheet: 0, themeColors: t, date1904: !1 };
+  const c = M(o.sheetName || "Sheet1", 0), l = e ?? [], { lastRow: y, lastCol: d, wrote: r } = k(c, l, { headerRow: i, autoInfer: s });
+  return c.dimension = r ? { rows: y + 1, cols: d + 1 } : { rows: 0, cols: 0 }, { sheets: [c], activeSheet: 0, themeColors: t, date1904: !1 };
+}
+function L(e) {
+  return !!e && typeof e == "object" && Array.isArray(e.sheets) && typeof e.activeSheet == "number" && Array.isArray(e.themeColors);
+}
+function S(e, o) {
+  const t = o.sheets[0], s = e.sheets[0];
+  if (!t) return e;
+  if (!s)
+    return {
+      sheets: [T(t, t.name)],
+      activeSheet: 0,
+      themeColors: o.themeColors,
+      date1904: e.date1904,
+      cellImages: e.cellImages
+    };
+  const i = {
+    name: s.name || t.name,
+    index: 0,
+    state: "visible",
+    dimension: { rows: 0, cols: 0 },
+    cells: /* @__PURE__ */ new Map(),
+    styles: t.styles.map((r) => ({ ...r })),
+    merges: t.merges.map((r) => ({ ...r })),
+    columns: new Map(t.columns),
+    rows: new Map(t.rows),
+    defaultColWidth: t.defaultColWidth,
+    defaultRowHeight: t.defaultRowHeight,
+    freeze: { ...t.freeze },
+    // 条件格式 / 数据验证 不带过来 —— 数据可能不在模板的目标列上, 套规则会误命中
+    conditional: [],
+    dataValidations: [],
+    // 模板的图 / 图表 / 形状 全部不带 —— 模板是"样式骨架", 不是内容
+    images: [],
+    charts: [],
+    shapes: [],
+    sparklines: [],
+    showGridLines: t.showGridLines
+  };
+  let c = 0, l = 0;
+  for (const r of s.cells.values()) {
+    const h = t.cells.get(p(r.row, r.col));
+    i.cells.set(p(r.row, r.col), {
+      row: r.row,
+      col: r.col,
+      type: r.type,
+      raw: r.raw,
+      rich: r.rich,
+      formula: r.formula,
+      hyperlink: r.hyperlink,
+      comment: r.comment,
+      styleId: (h == null ? void 0 : h.styleId) ?? 0,
+      dispImgId: r.dispImgId
+    }), r.row > c && (c = r.row), r.col > l && (l = r.col);
+  }
+  const y = t.columns.size ? Math.max(...t.columns.keys()) + 1 : 0, d = t.rows.size ? Math.max(...t.rows.keys()) + 1 : 0;
+  return i.dimension = {
+    rows: Math.max(s.dimension.rows, c + 1, d),
+    cols: Math.max(s.dimension.cols, l + 1, y)
+  }, {
+    sheets: [i],
+    activeSheet: 0,
+    themeColors: o.themeColors,
+    date1904: e.date1904,
+    cellImages: e.cellImages
+  };
+}
+function T(e, o) {
+  return {
+    name: o,
+    index: 0,
+    state: "visible",
+    dimension: { rows: 0, cols: 0 },
+    cells: /* @__PURE__ */ new Map(),
+    styles: e.styles.map((t) => ({ ...t })),
+    merges: e.merges.map((t) => ({ ...t })),
+    columns: new Map(e.columns),
+    rows: new Map(e.rows),
+    defaultColWidth: e.defaultColWidth,
+    defaultRowHeight: e.defaultRowHeight,
+    freeze: { ...e.freeze },
+    conditional: [],
+    dataValidations: [],
+    images: [],
+    charts: [],
+    shapes: [],
+    sparklines: [],
+    showGridLines: e.showGridLines
+  };
+}
+function E(e, o) {
+  return R(e, o);
+}
+const H = {
+  // 放大镜
+  find: '<circle cx="11" cy="11" r="7"/><line x1="21" y1="21" x2="16.65" y2="16.65"/>',
+  // 漏斗
+  filter: '<path d="M3 5h18l-7 8.5V20l-4-2.2V13.5z"/>',
+  // 漏斗 + 斜杠(清除筛选)
+  "clear-filter": '<path d="M3 5h18l-7 8.5V20l-4-2.2V13.5z"/><line x1="3" y1="3" x2="21" y2="21"/>',
+  // 上下箭头(排序)
+  sort: '<path d="M7 16l3 3 3-3"/><line x1="10" y1="19" x2="10" y2="5"/><path d="M17 8l-3-3-3 3"/><line x1="14" y1="5" x2="14" y2="19"/>',
+  // 下载(导出)
+  export: '<line x1="12" y1="3" x2="12" y2="15"/><path d="M8 11l4 4 4-4"/><path d="M4 19h16"/>',
+  // 放大镜带 +
+  zoom: '<circle cx="10" cy="10" r="6"/><line x1="20" y1="20" x2="14.5" y2="14.5"/><line x1="10" y1="7.5" x2="10" y2="12.5"/><line x1="7.5" y1="10" x2="12.5" y2="10"/>',
+  // 两个叠框(复制)
+  copy: '<rect x="9" y="9" width="11" height="11" rx="1.5"/><path d="M5 15H4V5a1 1 0 0 1 1-1h10v1"/>',
+  // 十字线(冻结行列)
+  freeze: '<line x1="3" y1="9" x2="21" y2="9"/><line x1="9" y1="3" x2="9" y2="21"/>',
+  // 自动换行:两条文本线 + 折回箭头
+  "wrap-text": '<line x1="3" y1="6" x2="21" y2="6"/><line x1="3" y1="18" x2="10" y2="18"/><path d="M3 12h15a3 3 0 0 1 0 6h-3"/><polyline points="17 15 14 18 17 21"/>',
+  // 模板:文档 + 排版网格
+  template: '<rect x="4" y="3" width="16" height="18" rx="1.5"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="8" y1="12" x2="16" y2="12"/><line x1="8" y1="16" x2="16" y2="16"/>',
+  // 图片工具:山+太阳的图片框 + 小齿轮(批量转换)
+  "image-tools": '<rect x="3" y="4" width="14" height="14" rx="1.5"/><circle cx="8" cy="9" r="1.5"/><polyline points="3 16 7 12 11 16 14 13 17 16"/><path d="M19 19l2 2M19 21l2-2"/>',
+  // 三点(更多)
+  more: '<circle cx="5" cy="12" r="1.6" fill="currentColor" stroke="none"/><circle cx="12" cy="12" r="1.6" fill="currentColor" stroke="none"/><circle cx="19" cy="12" r="1.6" fill="currentColor" stroke="none"/>',
+  // 下拉小箭头
+  caret: '<path d="M6 9l6 6 6-6"/>'
+};
+function G(e) {
+  return '<svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">' + e + "</svg>";
+}
+export {
+  H as T,
+  S as a,
+  L as i,
+  V as j,
+  E as p,
+  G as s
+};

package/dist/components/ExcelViewer.vue.d.ts

@@ -1,9 +1,12 @@
-import { ExcelPlugin, ToolbarItem } from '../core/plugin';
+import { ExcelPlugin, PermissionDeniedPayload, ToolbarItem } from '../core/plugin';
 import { ExcelSource } from '../core/loader';
-import { CellModel, CellStyleFn, MergeRange, TransformModelFn, WorkbookModel } from '../core/model/types';
+import { JsonInput, JsonLoadOptions } from '../core/loader-json';
+import { CellModel, CellStyleFn, CellStyleOverride, MergeRange, TransformModelFn, WorkbookModel } from '../core/model/types';
 import { ParseProgress } from '../core/progress';
 import { ReadOptions } from '../core/model/data-access';
 import { ViewerTheme } from '../core/render/theme';
+import { ContextMenuBeforePayload, ContextMenuShowPayload, ContextMenuTransform } from '../core/viewer/controller';
+import { EditableTarget } from '../core/edit/types';
 import { FormulaEngineFactory } from '../core/formula/engine';
 import { CellChangePayload, DimChangePayload, DirtyChangePayload, ImageChangePayload, StructChangePayload } from '../core/edit/edit-controller';
 import { EditorResolver } from '../core/edit/editor-context';
@@ -11,6 +14,27 @@ import { ImageExportOptions, PdfExportOptions, PrintOptions } from '../core/expo
 import { ResolvedToolbarItem } from './toolbar-types';
 type __VLS_Props = {
     src?: ExcelSource;
+    /**
+     * 直接喂 WorkbookModel 或 JsonInput(P3):绕过 parser,常用于"从后端拿 JSON 直接渲染"或
+     * "前端构造好模型再渲染"。WorkbookModel-shape 直用,JsonInput(二维数组 / 对象数组 / `{sheets:[...]}`)
+     * 走 `jsonToWorkbook` 自动构造。优先级:`workbook` > `src`(两者都给时取 `workbook`)。
+     */
+    workbook?: WorkbookModel | JsonInput;
+    /** JSON 直渲选项(`workbook` = JsonInput 时生效) */
+    jsonOptions?: JsonLoadOptions;
+    /**
+     * 渲染模板(P3 重设计 2026-06-08):一份 .xlsx 当**样式捐赠者** —— 模板的 styling
+     * (styles / merges / 列宽 / 行高 / freeze / theme)套到无格式数据源上,模板的 raw 文字 / 占位符
+     * / 图 / 图表 / 条件格式 全部丢弃。
+     *
+     * ⚠️ **只在数据源是 :workbook(JSON / 模型)时生效**;`:src`(.xlsx)数据源自带格式,
+     * 给 `:templateFile` 会被忽略并 console.warn。
+     *
+     * 工具栏内置 `template` 项可在运行时切换/导入/清除,无需重新挂载。
+     */
+    templateFile?: ExcelSource;
+    /** 模板显示名(标题栏 `· 模板: xxx` 后缀);不给则取运行时 File.name */
+    templateName?: string;
     fileName?: string;
     /** 外观主题(覆盖默认配色) */
     theme?: Partial<ViewerTheme>;
@@ -18,6 +42,10 @@ type __VLS_Props = {
     transformModel?: TransformModelFn;
     /** 渲染钩子: 按单元格覆盖样式 */
     cellStyle?: CellStyleFn;
+    /** WPS 单元格内嵌图(DISPIMG)贴合方式:contain 等比(默认,与 WPS 渲染一致)/ fill 拉伸铺满 / cover 等比裁剪 */
+    cellImageFit?: 'fill' | 'contain' | 'cover';
+    /** 图片点击放大灯箱(默认 true):只读模式单击图放大、编辑模式右键「查看大图」;false 关闭 */
+    imageLightbox?: boolean;
     /** 单击超链接是否默认在新标签打开(false 时只派发 hyperlink-click 事件) */
     openLinks?: boolean;
     /** 插件列表(打包主题/钩子/事件/overlay) */
@@ -37,12 +65,52 @@ type __VLS_Props = {
     }) => boolean | void;
     /** 只读区域(0-based 闭区间);命中即只读 */
     readOnlyRanges?: MergeRange[];
+    /**
+     * **可编辑白名单**(2026-06-08 新增) —— 设了就是白名单语义:默认只读,只有命中**任一**
+     * target 的格才可编辑。4 种 target 形状:`{row,col}` 单格 / `{row}` 整行 / `{col}` 整列 /
+     * `MergeRange` 矩形。可单值可数组,允许**不相邻**多个 target.
+     *
+     * `undefined`(不传)= 不启用白名单(老行为:默认全可编辑);`[]`(显式空数组)= 全只读.
+     * 与 `readOnlyRanges` / `cellReadOnly` 叠加 — 白名单命中后仍可被它们二次"黑"掉.
+     */
+    editableTargets?: EditableTarget | EditableTarget[];
+    /**
+     * **严格尺寸闸门**(Phase B, 2026-06-08) —— 默认 `false`: setColumnWidth/setRowHeight/autoFit 仅受全局
+     * `editable` 控制(老行为). 设 `true` + `editableTargets` 启用了 → 该列/行至少有 1 格在白名单内才能改尺寸.
+     */
+    strictDimensions?: boolean;
+    /**
+     * **只读单元格视觉钩子** (Phase C, 2026-06-08):
+     * - `false` (默认) = 无视觉差异 (老行为不变)
+     * - `true` = 套内置默认 (浅灰底 `#f5f7fa`,跟工具栏一致)
+     * - `CellStyleOverride` 对象 = 固定样式给所有只读格 (如黄底高亮)
+     * - `CellStyleFn` 函数 = 按格自定义
+     *
+     * 跟 `editableTargets` 配合: 白名单未覆盖的格自动套此视觉, 用户一眼看出哪些可编辑.
+     */
+    readOnlyCellStyle?: boolean | CellStyleOverride | CellStyleFn;
     /** 自定义单元格编辑器(按格返回工厂;覆盖插件 editor)。需 editable 开启 */
     editor?: EditorResolver;
     /** 公式重算(E4):默认 false 沿用缓存值。开启后编辑公式/被引用格 → 依赖格自动重算。需 editable */
     recalc?: boolean;
     /** 自定义/自研公式引擎工厂(可换引擎);不给则用默认 HyperFormula(需 npm i hyperformula) */
     formulaEngine?: FormulaEngineFactory;
+    /**
+     * 内置导出进度遮罩(P1.5):默认 `true` —— 调 `viewer.downloadPdf` / `downloadImage` / `downloadXlsx` /
+     * `print` / 选区图片批量转换 时,壳自动建 `AbortController` + 接 `onProgress` →
+     * 显示居中模态(stage 标签 + 进度条 + 取消按钮)。**关闭** `:export-progress="false"` 走纯回调
+     * 路径(用户自己接 `opts.onProgress`/`opts.signal`)。**完全自渲染**用 `#export-progress` 插槽
+     * (拿到 `{ state, busy, cancel }`)。
+     */
+    exportProgress?: boolean;
+    /**
+     * 右键菜单(Plan C):
+     * - `false` → 不弹内置菜单(`before-context-menu` / `context-menu` 事件仍触发,用户自渲染)
+     * - 函数 `(ctx, items) => MenuItem[] | undefined` → 在内置 items 上加 / 减 / 重排;返 `undefined` 用原样
+     * - 不传(默认)→ editable 时显示内置菜单,非 editable 走浏览器默认菜单
+     * 与 `@before-context-menu` / `@context-menu` 事件叠加使用。
+     */
+    contextMenu?: boolean | ContextMenuTransform;
 };
 /** 单元格当前屏幕矩形(render-area 相对坐标);供 overlay slot / 命令式定位 */
 declare function rectOf(row: number, col: number): {
@@ -58,6 +126,7 @@ declare function rectOfRange(range: MergeRange): {
     w: number;
     h: number;
 } | null;
+declare function cancelExport(): void;
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
@@ -100,9 +169,21 @@ declare function __VLS_template(): {
             } | null;
             range: string;
         }): any;
+        'export-progress'?(_: {
+            state: {
+                stage: import('../core/progress').ExportStage;
+                sheetIndex?: number | undefined;
+                pageIndex?: number | undefined;
+                ratio?: number | undefined;
+                label?: string | undefined;
+            } | null;
+            busy: boolean;
+            cancel: typeof cancelExport;
+        }): any;
     };
     refs: {
         rootEl: HTMLDivElement;
+        fbEl: HTMLTextAreaElement;
         renderAreaEl: HTMLDivElement;
         canvasEl: HTMLCanvasElement;
         ovMain: HTMLDivElement;
@@ -113,6 +194,7 @@ declare function __VLS_template(): {
         spacerEl: HTMLDivElement;
         pluginOvEl: HTMLDivElement;
         editorSlotEl: HTMLDivElement;
+        templateInputEl: HTMLInputElement;
     };
     rootEl: HTMLDivElement;
 };
@@ -128,6 +210,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     rectOfRange(range: MergeRange): import('../core/plugin').Rect | null;
     redraw(): void;
     isCellEditable(row: number, col: number): boolean;
+    setEditableTargets(targets: EditableTarget | EditableTarget[] | undefined): void;
+    getEditableTargets(): EditableTarget | EditableTarget[] | undefined;
     exportImage(opts?: ImageExportOptions): Promise<Blob>;
     downloadImage(opts?: ImageExportOptions): Promise<void>;
     exportPdf(opts?: PdfExportOptions): Promise<Blob>;
@@ -162,34 +246,85 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
         col: number;
     } | null;
     getCellSnapshot(row: number, col: number): import('../core').CellSnapshot | null;
+    inspectCell(row: number, col: number): import('../core/plugin').CellInspection | null;
     beginEdit(row: number, col: number): boolean;
     cancelEdit(): void;
     isEditing(): boolean;
-    setStyle(range: MergeRange, patch: import('../core/model/types').CellStyleOverride): boolean;
+    setStyle(range: MergeRange, patch: CellStyleOverride): boolean;
+    getActiveFillColor(): string;
+    getActiveFontColor(): string;
+    setSelectionFill(color: string | null): boolean;
+    setSelectionFontColor(color: string): boolean;
+    getSelectionWrapState(): "all" | "none" | "mixed";
+    toggleWrapTextOnSelection(): boolean;
+    mergeCells(range: MergeRange): boolean;
+    unmergeCells(range: MergeRange): boolean;
+    pasteText(text: string, at?: {
+        row: number;
+        col: number;
+    }): boolean;
+    pasteRichHtml(html: string, at?: {
+        row: number;
+        col: number;
+    }): boolean;
+    pasteImageBlob(blob: Blob, at?: {
+        row: number;
+        col: number;
+    }): Promise<boolean>;
     getImages(): import('../core/model/types').ImageAnchor[];
     addImage(anchor: import('../core/model/types').ImageAnchor): number;
     removeImage(index: number): boolean;
     moveImage(index: number, dxPx: number, dyPx: number): boolean;
     resizeImage(index: number, widthPx: number, heightPx: number): boolean;
+    getCellEditString(): string;
+    canEditActiveCell(): boolean;
+    commitActiveCellValue(value: string, move?: "down"): boolean;
+    getCellImages(): {
+        id: string;
+        src: string;
+        mime?: string;
+    }[];
+    getCellImageAt(row: number, col: number): {
+        id: string;
+        src: string;
+        mime?: string;
+    } | null;
+    openImageLightbox(src: string, fileName?: string, mime?: string): void;
+    setCellImageFit(fit: "fill" | "contain" | "cover"): void;
+    convertImageToCell(imageIndex: number, row: number, col: number): boolean;
+    convertImageToCellAuto(imageIndex: number): boolean;
+    convertAllImagesToCells(col?: number): number;
+    convertImagesInRangeToCell(range: MergeRange): Promise<number>;
+    convertCellImagesInRangeToFloat(range: MergeRange, size?: {
+        width: number;
+        height: number;
+    }): Promise<number>;
+    openContextMenu(x: number, y: number, items?: import('../core/plugin').MenuItem[]): void;
+    closeContextMenu(): void;
+    convertCellImageToFloat(row: number, col: number, size?: {
+        width: number;
+        height: number;
+    }): boolean;
     insertRows(at: number, count?: number): boolean;
     deleteRows(at: number, count?: number): boolean;
     insertCols(at: number, count?: number): boolean;
     deleteCols(at: number, count?: number): boolean;
-    setColumnWidth(col: number, width: number): boolean;
-    setRowHeight(row: number, height: number): boolean;
+    setColumnWidth(target: import('../core/edit/types').DimTarget, width: number): number;
+    setRowHeight(target: import('../core/edit/types').DimTarget, height: number): number;
+    autoFitColumns(target?: import('../core/edit/types').DimTarget): number;
+    autoFitRows(target?: import('../core/edit/types').DimTarget): number;
+    resetColumnWidth(target: import('../core/edit/types').DimTarget): number;
+    resetRowHeight(target: import('../core/edit/types').DimTarget): number;
     isRecalcReady(): boolean;
+    getVirtualExtent(): {
+        rows: number;
+        cols: number;
+    };
     isDirty(): boolean;
     resetToOriginal(): boolean;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     error: (message: string) => any;
     progress: (progress: ParseProgress) => any;
-    "cell-change": (payload: CellChangePayload) => any;
-    "edit-start": (payload: unknown) => any;
-    "edit-commit": (payload: unknown) => any;
-    "dim-change": (payload: DimChangePayload) => any;
-    "dirty-change": (payload: DirtyChangePayload) => any;
-    "image-change": (payload: ImageChangePayload) => any;
-    "struct-change": (payload: StructChangePayload) => any;
     "cell-click": (payload: {
         row: number;
         col: number;
@@ -218,17 +353,20 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
             col: number;
         };
     }) => any;
+    "cell-change": (payload: CellChangePayload) => any;
+    "edit-start": (payload: unknown) => any;
+    "edit-commit": (payload: unknown) => any;
+    "dim-change": (payload: DimChangePayload) => any;
+    "dirty-change": (payload: DirtyChangePayload) => any;
+    "image-change": (payload: ImageChangePayload) => any;
+    "struct-change": (payload: StructChangePayload) => any;
+    "permission-denied": (payload: PermissionDeniedPayload) => any;
     rendered: (workbook: WorkbookModel) => any;
+    "before-context-menu": (payload: ContextMenuBeforePayload) => any;
+    "context-menu": (payload: ContextMenuShowPayload) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onError?: ((message: string) => any) | undefined;
     onProgress?: ((progress: ParseProgress) => any) | undefined;
-    "onCell-change"?: ((payload: CellChangePayload) => any) | undefined;
-    "onEdit-start"?: ((payload: unknown) => any) | undefined;
-    "onEdit-commit"?: ((payload: unknown) => any) | undefined;
-    "onDim-change"?: ((payload: DimChangePayload) => any) | undefined;
-    "onDirty-change"?: ((payload: DirtyChangePayload) => any) | undefined;
-    "onImage-change"?: ((payload: ImageChangePayload) => any) | undefined;
-    "onStruct-change"?: ((payload: StructChangePayload) => any) | undefined;
     "onCell-click"?: ((payload: {
         row: number;
         col: number;
@@ -257,12 +395,26 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
             col: number;
         };
     }) => any) | undefined;
+    "onCell-change"?: ((payload: CellChangePayload) => any) | undefined;
+    "onEdit-start"?: ((payload: unknown) => any) | undefined;
+    "onEdit-commit"?: ((payload: unknown) => any) | undefined;
+    "onDim-change"?: ((payload: DimChangePayload) => any) | undefined;
+    "onDirty-change"?: ((payload: DirtyChangePayload) => any) | undefined;
+    "onImage-change"?: ((payload: ImageChangePayload) => any) | undefined;
+    "onStruct-change"?: ((payload: StructChangePayload) => any) | undefined;
+    "onPermission-denied"?: ((payload: PermissionDeniedPayload) => any) | undefined;
     onRendered?: ((workbook: WorkbookModel) => any) | undefined;
+    "onBefore-context-menu"?: ((payload: ContextMenuBeforePayload) => any) | undefined;
+    "onContext-menu"?: ((payload: ContextMenuShowPayload) => any) | undefined;
 }>, {
     toolbar: boolean | Array<string | ToolbarItem>;
+    imageLightbox: boolean;
     openLinks: boolean;
+    exportProgress: boolean;
+    contextMenu: boolean | ContextMenuTransform;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     rootEl: HTMLDivElement;
+    fbEl: HTMLTextAreaElement;
     renderAreaEl: HTMLDivElement;
     canvasEl: HTMLCanvasElement;
     ovMain: HTMLDivElement;
@@ -273,6 +425,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     spacerEl: HTMLDivElement;
     pluginOvEl: HTMLDivElement;
     editorSlotEl: HTMLDivElement;
+    templateInputEl: HTMLInputElement;
 }, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

package/dist/components/ExportProgressOverlay.vue.d.ts

@@ -0,0 +1,11 @@
+import { ExportProgress } from '../core/progress';
+type __VLS_Props = {
+    state: ExportProgress | null;
+    busy: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    cancel: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/FilterPopup.vue.d.ts

@@ -6,14 +6,14 @@ type __VLS_Props = {
     sortDir?: 'asc' | 'desc' | null;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    sort: (dir: "asc" | "desc") => any;
-    close: () => any;
+    sort: (dir: "desc" | "asc") => any;
     apply: (checked: string[]) => any;
+    close: () => any;
     clear: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onSort?: ((dir: "asc" | "desc") => any) | undefined;
-    onClose?: (() => any) | undefined;
+    onSort?: ((dir: "desc" | "asc") => any) | undefined;
     onApply?: ((checked: string[]) => any) | undefined;
+    onClose?: (() => any) | undefined;
     onClear?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     rootEl: HTMLDivElement;

package/dist/components/ViewerToolbar.vue.d.ts

@@ -1,5 +1,7 @@
 type __VLS_Props = {
     fileName?: string;
+    /** 模板名(运行时或 prop 给出);非空时拼接到标题尾部 ` · 模板: <name>` */
+    templateName?: string;
     sheetCount: number;
     zoom: number;
 };

package/dist/composables/useExcelDocument.d.ts

@@ -6,6 +6,7 @@ export declare function useExcelDocument(): {
     error: import('vue').Ref<string | null, string | null>;
     workbook: import('vue').ShallowRef<WorkbookModel | null, WorkbookModel | null>;
     load: (src: ExcelSource, transform?: TransformModelFn) => Promise<void>;
+    loadModel: (model: WorkbookModel, transform?: TransformModelFn) => void;
     progress: import('vue').Ref<{
         stage: "read" | "parse" | "build";
         ratio?: number | undefined;

package/dist/core/edit/clipboard-html.d.ts

@@ -0,0 +1,24 @@
+import { CellStyleOverride, MergeRange } from '../model/types';
+import { CellValue } from '../model/data-access';
+export interface ParsedClipboard {
+    /** 二维值(原始串/数字/公式,交 setCellValue 推断);稠密对齐 */
+    values: CellValue[][];
+    /** 逐格样式覆盖(只含解析出的字段) */
+    styles: {
+        row: number;
+        col: number;
+        patch: CellStyleOverride;
+    }[];
+    /** 合并区(rowspan/colspan>1) */
+    merges: MergeRange[];
+    /** data-uri 图片(row,col,dataUrl) */
+    images: {
+        row: number;
+        col: number;
+        dataUrl: string;
+    }[];
+}
+/**
+ * 解析剪贴板 HTML → {values, styles, merges, images}。非浏览器环境 / 无 <table> 返 null(调用方回退 TSV)。
+ */
+export declare function parseClipboardHtml(html: string): ParsedClipboard | null;

package/dist/core/edit/commands.d.ts

@@ -1,4 +1,4 @@
-import { CellModel, CellStyleOverride, ColumnInfo, ImageAnchor, RowInfo, SheetModel, WorkbookModel } from '../model/types';
+import { CellModel, CellStyleOverride, ColumnInfo, ImageAnchor, MergeRange, RowInfo, SheetModel, WorkbookModel } from '../model/types';
 import { CellValue } from '../model/data-access';
 import { StructOp } from '../model/structure';
 export type CellPos = {
@@ -58,6 +58,50 @@ export type EditCommand = {
 } | {
     kind: 'restore-wb';
     snapshot: WorkbookModel;
+} | {
+    kind: 'merge-cells';
+    range: MergeRange;
+} | {
+    kind: 'unmerge-cells';
+    range: MergeRange;
+} | {
+    kind: 'restore-merges';
+    merges: MergeRange[];
+    cells: {
+        row: number;
+        col: number;
+        cell: CellModel | null;
+    }[];
+} | {
+    kind: 'convert-to-cell';
+    imageIndex: number;
+    row: number;
+    col: number;
+} | {
+    kind: 'convert-to-cells';
+    targets: {
+        imageIndex: number;
+        row: number;
+        col: number;
+    }[];
+} | {
+    kind: 'convert-to-float';
+    row: number;
+    col: number;
+    size?: {
+        width: number;
+        height: number;
+    };
+} | {
+    kind: 'convert-to-floats';
+    cells: {
+        row: number;
+        col: number;
+        size?: {
+            width: number;
+            height: number;
+        };
+    }[];
 };
 /** dim 命令(列宽/行高)— 仅维度族,无格位置 */
 export type DimCommand = Extract<EditCommand, {