ooxml-excel-editor 1.1.0 → 1.2.0

package/dist/chunks/worker-client.stub-CJlmpAgJ.js

@@ -0,0 +1,190 @@
+import { c as g, p as M } from "./plugin-overlay-BBrNby8v.js";
+const b = Array(17).fill("#000000");
+function x() {
+  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 k(e, o) {
+  return {
+    name: e,
+    index: o,
+    state: "visible",
+    dimension: { rows: 0, cols: 0 },
+    cells: /* @__PURE__ */ new Map(),
+    styles: [x()],
+    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 I(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 r = Number(t);
+    if (Number.isFinite(r)) return { raw: r, 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 r = new Date(t);
+    if (!isNaN(r.getTime())) return { raw: r, type: "date" };
+  }
+  return { raw: e, type: "string" };
+}
+function T(e, o) {
+  return o.map((t) => e[t]);
+}
+function A(e, o, t = {}) {
+  const r = t.startRow ?? 0, i = t.startCol ?? 0, c = t.autoInfer ?? !0;
+  let a = 0, m = 0, u = !1;
+  if (!o.length) return { lastRow: 0, lastCol: 0, wrote: !1 };
+  const s = o[0], w = s !== null && typeof s == "object" && !Array.isArray(s), p = w ? t.columns ?? Object.keys(s) : [];
+  let d = r;
+  if (w && (t.headerRow ?? !0)) {
+    for (let n = 0; n < p.length; n++) {
+      const l = d, f = i + n;
+      e.cells.set(g(l, f), { row: l, col: f, type: "string", raw: p[n], styleId: 0 }), a = Math.max(a, l), m = Math.max(m, f), u = !0;
+    }
+    d++;
+  }
+  for (let n = 0; n < o.length; n++) {
+    const l = o[n], f = Array.isArray(l) ? l : T(l, p);
+    for (let h = 0; h < f.length; h++) {
+      const y = d + n - (w && (t.headerRow ?? !0), 0), C = i + h, R = I(f[h], c);
+      R.type !== "empty" && (e.cells.set(g(y, C), { row: y, col: C, type: R.type, raw: R.raw, styleId: 0 }), a = Math.max(a, y), m = Math.max(m, C), u = !0);
+    }
+  }
+  return { lastRow: a, lastCol: m, wrote: u };
+}
+function E(e, o = {}) {
+  const t = o.themeColors && o.themeColors.length === 17 ? o.themeColors : b, r = o.autoInfer ?? !0, i = o.headerRow ?? !0;
+  if (e && typeof e == "object" && !Array.isArray(e) && Array.isArray(e.sheets))
+    return { sheets: e.sheets.map((d, n) => {
+      const l = k(d.name || `Sheet${n + 1}`, n), { lastRow: f, lastCol: h, wrote: y } = A(l, d.rows ?? [], { headerRow: i, autoInfer: r });
+      return l.dimension = y ? { rows: f + 1, cols: h + 1 } : { rows: 0, cols: 0 }, l;
+    }), activeSheet: 0, themeColors: t, date1904: !1 };
+  const c = k(o.sheetName || "Sheet1", 0), a = e ?? [], { lastRow: m, lastCol: u, wrote: s } = A(c, a, { headerRow: i, autoInfer: r });
+  return c.dimension = s ? { rows: m + 1, cols: u + 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], r = e.sheets[0];
+  if (!t) return e;
+  if (!r)
+    return {
+      sheets: [z(t, t.name)],
+      activeSheet: 0,
+      themeColors: o.themeColors,
+      date1904: e.date1904,
+      cellImages: e.cellImages
+    };
+  const i = {
+    name: r.name || t.name,
+    index: 0,
+    state: "visible",
+    dimension: { rows: 0, cols: 0 },
+    cells: /* @__PURE__ */ new Map(),
+    styles: t.styles.map((s) => ({ ...s })),
+    merges: t.merges.map((s) => ({ ...s })),
+    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, a = 0;
+  for (const s of r.cells.values()) {
+    const w = t.cells.get(g(s.row, s.col));
+    i.cells.set(g(s.row, s.col), {
+      row: s.row,
+      col: s.col,
+      type: s.type,
+      raw: s.raw,
+      rich: s.rich,
+      formula: s.formula,
+      hyperlink: s.hyperlink,
+      comment: s.comment,
+      styleId: (w == null ? void 0 : w.styleId) ?? 0,
+      dispImgId: s.dispImgId
+    }), s.row > c && (c = s.row), s.col > a && (a = s.col);
+  }
+  const m = t.columns.size ? Math.max(...t.columns.keys()) + 1 : 0, u = t.rows.size ? Math.max(...t.rows.keys()) + 1 : 0;
+  return i.dimension = {
+    rows: Math.max(r.dimension.rows, c + 1, u),
+    cols: Math.max(r.dimension.cols, a + 1, m)
+  }, {
+    sheets: [i],
+    activeSheet: 0,
+    themeColors: o.themeColors,
+    date1904: e.date1904,
+    cellImages: e.cellImages
+  };
+}
+function z(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 G(e, o) {
+  return M(e, o);
+}
+export {
+  S as a,
+  L as i,
+  E as j,
+  G as p
+};

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,6 +169,17 @@ 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;
@@ -113,6 +193,7 @@ declare function __VLS_template(): {
         spacerEl: HTMLDivElement;
         pluginOvEl: HTMLDivElement;
         editorSlotEl: HTMLDivElement;
+        templateInputEl: HTMLInputElement;
     };
     rootEl: HTMLDivElement;
 };
@@ -128,6 +209,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 +245,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 +352,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,10 +394,23 @@ 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;
     renderAreaEl: HTMLDivElement;
@@ -273,6 +423,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, {

package/dist/core/edit/context-menu.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 右键上下文菜单宿主(框架无关 DOM)—— 挂到 document.body 的 fixed 菜单,点项执行 action + 关闭,
+ * 点外部 / Esc 关闭,贴边自动翻转。Vue / React 壳只把 contextmenu 事件转给 controller,菜单逻辑全在这。
+ */
+export interface MenuItem {
+    label?: string;
+    action?: () => void;
+    disabled?: boolean;
+    /** true = 分隔线 */
+    separator?: boolean;
+}
+export declare class ContextMenuHost {
+    private el;
+    private cleanup;
+    isOpen(): boolean;
+    show(x: number, y: number, items: MenuItem[]): void;
+    close(): void;
+    dispose(): void;
+}