ooxml-excel-editor 1.3.3 → 1.11.0

package/dist/chunks/{toolbar-icons-fOm95ASq.js → toolbar-icons-BjwdJDiN.js}

@@ -1,7 +1,7 @@
 var S = Object.defineProperty;
 var T = Object.getOwnPropertySymbols;
 var E = Object.prototype.hasOwnProperty, H = Object.prototype.propertyIsEnumerable;
-var j = (e, r, t) => r in e ? S(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t, f = (e, r) => {
+var j = (e, r, t) => r in e ? S(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t, w = (e, r) => {
   for (var t in r || (r = {}))
     E.call(r, t) && j(e, t, r[t]);
   if (T)
@@ -9,22 +9,8 @@ var j = (e, r, t) => r in e ? S(e, r, { enumerable: !0, configurable: !0, writab
       H.call(r, t) && j(e, t, r[t]);
   return e;
 };
-import { i as R, p as G } from "./plugin-overlay-BUrPrpT2.js";
-const N = Array(17).fill("#000000");
-function F() {
-  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"
-  };
-}
+import { m as N, i as R, p as G } from "./plugin-overlay-C_fL02Qc.js";
+const O = Array(17).fill("#000000");
 function V(e, r) {
   return {
     name: e,
@@ -32,7 +18,7 @@ function V(e, r) {
     state: "visible",
     dimension: { rows: 0, cols: 0 },
     cells: /* @__PURE__ */ new Map(),
-    styles: [F()],
+    styles: [N()],
     merges: [],
     columns: /* @__PURE__ */ new Map(),
     rows: /* @__PURE__ */ new Map(),
@@ -45,10 +31,11 @@ function V(e, r) {
     charts: [],
     shapes: [],
     sparklines: [],
+    pivotTables: [],
     showGridLines: !0
   };
 }
-function O(e, r) {
+function $(e, r) {
   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" };
@@ -67,54 +54,54 @@ function O(e, r) {
   }
   return { raw: e, type: "string" };
 }
-function $(e, r) {
+function D(e, r) {
   return r.map((t) => e[t]);
 }
 function L(e, r, t = {}) {
-  var A, x, p, w, C, M;
-  const s = (A = t.startRow) != null ? A : 0, c = (x = t.startCol) != null ? x : 0, y = (p = t.autoInfer) != null ? p : !0;
-  let n = 0, h = 0, d = !1;
+  var b, x, p, f, M, C;
+  const s = (b = t.startRow) != null ? b : 0, c = (x = t.startCol) != null ? x : 0, y = (p = t.autoInfer) != null ? p : !0;
+  let l = 0, h = 0, m = !1;
   if (!r.length) return { lastRow: 0, lastCol: 0, wrote: !1 };
-  const m = r[0], o = m !== null && typeof m == "object" && !Array.isArray(m), a = o ? (w = t.columns) != null ? w : Object.keys(m) : [];
+  const d = r[0], o = d !== null && typeof d == "object" && !Array.isArray(d), a = o ? (f = t.columns) != null ? f : Object.keys(d) : [];
   let g = s;
-  if (o && ((C = t.headerRow) == null || C)) {
-    for (let l = 0; l < a.length; l++) {
-      const i = g, u = c + l;
-      e.cells.set(R(i, u), { row: i, col: u, type: "string", raw: a[l], styleId: 0 }), n = Math.max(n, i), h = Math.max(h, u), d = !0;
+  if (o && ((M = t.headerRow) == null || M)) {
+    for (let n = 0; n < a.length; n++) {
+      const i = g, u = c + n;
+      e.cells.set(R(i, u), { row: i, col: u, type: "string", raw: a[n], styleId: 0 }), l = Math.max(l, i), h = Math.max(h, u), m = !0;
     }
     g++;
   }
-  for (let l = 0; l < r.length; l++) {
-    const i = r[l], u = Array.isArray(i) ? i : $(i, a);
+  for (let n = 0; n < r.length; n++) {
+    const i = r[n], u = Array.isArray(i) ? i : D(i, a);
     for (let k = 0; k < u.length; k++) {
-      const I = g + l - (o && ((M = t.headerRow) == null || M), 0), b = c + k, z = O(u[k], y);
-      z.type !== "empty" && (e.cells.set(R(I, b), { row: I, col: b, type: z.type, raw: z.raw, styleId: 0 }), n = Math.max(n, I), h = Math.max(h, b), d = !0);
+      const I = g + n - (o && ((C = t.headerRow) == null || C), 0), A = c + k, z = $(u[k], y);
+      z.type !== "empty" && (e.cells.set(R(I, A), { row: I, col: A, type: z.type, raw: z.raw, styleId: 0 }), l = Math.max(l, I), h = Math.max(h, A), m = !0);
     }
   }
-  return { lastRow: n, lastCol: h, wrote: d };
+  return { lastRow: l, lastCol: h, wrote: m };
 }
-function B(e, r = {}) {
+function v(e, r = {}) {
   var o, a;
-  const t = r.themeColors && r.themeColors.length === 17 ? r.themeColors : N, s = (o = r.autoInfer) != null ? o : !0, c = (a = r.headerRow) != null ? a : !0;
+  const t = r.themeColors && r.themeColors.length === 17 ? r.themeColors : O, s = (o = r.autoInfer) != null ? o : !0, c = (a = r.headerRow) != null ? a : !0;
   if (e && typeof e == "object" && !Array.isArray(e) && Array.isArray(e.sheets))
     return { sheets: e.sheets.map((x, p) => {
       var i;
-      const w = V(x.name || `Sheet${p + 1}`, p), { lastRow: C, lastCol: M, wrote: l } = L(w, (i = x.rows) != null ? i : [], { headerRow: c, autoInfer: s });
-      return w.dimension = l ? { rows: C + 1, cols: M + 1 } : { rows: 0, cols: 0 }, w;
+      const f = V(x.name || `Sheet${p + 1}`, p), { lastRow: M, lastCol: C, wrote: n } = L(f, (i = x.rows) != null ? i : [], { headerRow: c, autoInfer: s });
+      return f.dimension = n ? { rows: M + 1, cols: C + 1 } : { rows: 0, cols: 0 }, f;
     }), activeSheet: 0, themeColors: t, date1904: !1 };
-  const y = V(r.sheetName || "Sheet1", 0), n = e != null ? e : [], { lastRow: h, lastCol: d, wrote: m } = L(y, n, { headerRow: c, autoInfer: s });
-  return y.dimension = m ? { rows: h + 1, cols: d + 1 } : { rows: 0, cols: 0 }, { sheets: [y], activeSheet: 0, themeColors: t, date1904: !1 };
+  const y = V(r.sheetName || "Sheet1", 0), l = e != null ? e : [], { lastRow: h, lastCol: m, wrote: d } = L(y, l, { headerRow: c, autoInfer: s });
+  return y.dimension = d ? { rows: h + 1, cols: m + 1 } : { rows: 0, cols: 0 }, { sheets: [y], activeSheet: 0, themeColors: t, date1904: !1 };
 }
-function _(e) {
+function B(e) {
   return !!e && typeof e == "object" && Array.isArray(e.sheets) && typeof e.activeSheet == "number" && Array.isArray(e.themeColors);
 }
-function K(e, r) {
-  var m;
+function _(e, r) {
+  var d;
   const t = r.sheets[0], s = e.sheets[0];
   if (!t) return e;
   if (!s)
     return {
-      sheets: [D(t, t.name)],
+      sheets: [F(t, t.name)],
       activeSheet: 0,
       themeColors: r.themeColors,
       date1904: e.date1904,
@@ -126,13 +113,13 @@ function K(e, r) {
     state: "visible",
     dimension: { rows: 0, cols: 0 },
     cells: /* @__PURE__ */ new Map(),
-    styles: t.styles.map((o) => f({}, o)),
-    merges: t.merges.map((o) => f({}, o)),
+    styles: t.styles.map((o) => w({}, o)),
+    merges: t.merges.map((o) => w({}, o)),
     columns: new Map(t.columns),
     rows: new Map(t.rows),
     defaultColWidth: t.defaultColWidth,
     defaultRowHeight: t.defaultRowHeight,
-    freeze: f({}, t.freeze),
+    freeze: w({}, t.freeze),
     // 条件格式 / 数据验证 不带过来 —— 数据可能不在模板的目标列上, 套规则会误命中
     conditional: [],
     dataValidations: [],
@@ -141,9 +128,10 @@ function K(e, r) {
     charts: [],
     shapes: [],
     sparklines: [],
+    pivotTables: [],
     showGridLines: t.showGridLines
   };
-  let y = 0, n = 0;
+  let y = 0, l = 0;
   for (const o of s.cells.values()) {
     const a = t.cells.get(R(o.row, o.col));
     c.cells.set(R(o.row, o.col), {
@@ -155,14 +143,14 @@ function K(e, r) {
       formula: o.formula,
       hyperlink: o.hyperlink,
       comment: o.comment,
-      styleId: (m = a == null ? void 0 : a.styleId) != null ? m : 0,
+      styleId: (d = a == null ? void 0 : a.styleId) != null ? d : 0,
       dispImgId: o.dispImgId
-    }), o.row > y && (y = o.row), o.col > n && (n = o.col);
+    }), o.row > y && (y = o.row), o.col > l && (l = o.col);
   }
-  const h = t.columns.size ? Math.max(...t.columns.keys()) + 1 : 0, d = t.rows.size ? Math.max(...t.rows.keys()) + 1 : 0;
+  const h = t.columns.size ? Math.max(...t.columns.keys()) + 1 : 0, m = t.rows.size ? Math.max(...t.rows.keys()) + 1 : 0;
   return c.dimension = {
-    rows: Math.max(s.dimension.rows, y + 1, d),
-    cols: Math.max(s.dimension.cols, n + 1, h)
+    rows: Math.max(s.dimension.rows, y + 1, m),
+    cols: Math.max(s.dimension.cols, l + 1, h)
   }, {
     sheets: [c],
     activeSheet: 0,
@@ -171,33 +159,34 @@ function K(e, r) {
     cellImages: e.cellImages
   };
 }
-function D(e, r) {
+function F(e, r) {
   return {
     name: r,
     index: 0,
     state: "visible",
     dimension: { rows: 0, cols: 0 },
     cells: /* @__PURE__ */ new Map(),
-    styles: e.styles.map((t) => f({}, t)),
-    merges: e.merges.map((t) => f({}, t)),
+    styles: e.styles.map((t) => w({}, t)),
+    merges: e.merges.map((t) => w({}, t)),
     columns: new Map(e.columns),
     rows: new Map(e.rows),
     defaultColWidth: e.defaultColWidth,
     defaultRowHeight: e.defaultRowHeight,
-    freeze: f({}, e.freeze),
+    freeze: w({}, e.freeze),
     conditional: [],
     dataValidations: [],
     images: [],
     charts: [],
     shapes: [],
     sparklines: [],
+    pivotTables: [],
     showGridLines: e.showGridLines
   };
 }
-function Z(e, r) {
+function K(e, r) {
   return G(e, r);
 }
-const q = {
+const Z = {
   // 放大镜
   find: '<circle cx="11" cy="11" r="7"/><line x1="21" y1="21" x2="16.65" y2="16.65"/>',
   // 漏斗
@@ -206,6 +195,12 @@ const q = {
   "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"/>',
+  // 透视表: 小表格 + 汇总箭头
+  "pivot-table": '<rect x="3" y="4" width="13" height="13" rx="1.5"/><line x1="3" y1="8" x2="16" y2="8"/><line x1="7" y1="4" x2="7" y2="17"/><path d="M14 14h7"/><path d="M18 11l3 3-3 3"/>',
+  // 条件格式: 渐变色块 + 小滴
+  "conditional-format": '<rect x="3" y="4" width="13" height="13" rx="1.5"/><path d="M3 9h13"/><path d="M3 13h13"/><circle cx="18.5" cy="15" r="3"/><path d="M18.5 9.5c1.2 1.4 2 2.7 2 3.8a2 2 0 0 1-4 0c0-1.1.8-2.4 2-3.8z"/>',
+  // 数字格式: 百分号 + 小数点(123)
+  "number-format": '<text x="2" y="11" font-size="9" font-family="sans-serif" fill="currentColor" stroke="none">123</text><circle cx="5" cy="17" r="1" fill="currentColor" stroke="none"/><path d="M21 6l-7 12"/><circle cx="14.5" cy="8" r="2"/><circle cx="20.5" cy="16" r="2"/>',
   // 下载(导出)
   export: '<line x1="12" y1="3" x2="12" y2="15"/><path d="M8 11l4 4 4-4"/><path d="M4 19h16"/>',
   // 放大镜带 +
@@ -225,14 +220,14 @@ const q = {
   // 下拉小箭头
   caret: '<path d="M6 9l6 6 6-6"/>'
 };
-function J(e) {
+function q(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 {
-  q as T,
-  K as a,
-  _ as i,
-  B as j,
-  Z as p,
-  J as s
+  Z as T,
+  _ as a,
+  B as i,
+  v as j,
+  K as p,
+  q as s
 };

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

@@ -7,6 +7,7 @@ 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 { PasteBehavior } from '../core/edit/paste-behavior';
 import { FormulaEngineFactory } from '../core/formula/engine';
 import { CellChangePayload, DimChangePayload, DirtyChangePayload, ImageChangePayload, StructChangePayload } from '../core/edit/edit-controller';
 import { EditorResolver } from '../core/edit/editor-context';
@@ -58,6 +59,18 @@ type __VLS_Props = {
     toolbar?: boolean | Array<string | ToolbarItem>;
     /** 编辑总开关:默认 false = 只读(行为不变)。开启后才能进入编辑(E0:闸门) */
     editable?: boolean;
+    /**
+     * 透视表功能开关:默认 false = 关闭。开启后(还需 `editable`)工具栏 `pivot-table` 入口可见、
+     * `createPivotTable`/`openPivotTableDialog` 等 API 生效、导出 .xlsx 回注真实 OOXML 透视表零件
+     * (overlay 模式同时保留原文件透视表)。
+     */
+    pivotTable?: boolean;
+    /**
+     * 条件格式编辑开关:默认 false = 关闭(只读渲染)。开启后(还需 `editable`)工具栏 `conditional-format`
+     * 入口可见、`openConditionalFormatDialog`/`addConditionalRule` 等 API 生效、导出 .xlsx 回写条件格式
+     * (overlay 模式保留原件未编辑规则原样,只增改用户改的)。
+     */
+    conditionalFormat?: boolean;
     /** 按格只读判定:返回 true = 只读(cell 为空格时传 null) */
     cellReadOnly?: (cell: CellModel | null, pos: {
         row: number;
@@ -95,6 +108,13 @@ type __VLS_Props = {
     recalc?: boolean;
     /** 自定义/自研公式引擎工厂(可换引擎);不给则用默认 HyperFormula(需 npm i hyperformula) */
     formulaEngine?: FormulaEngineFactory;
+    /**
+     * 粘贴行为(默认 = 覆盖式 1:1)。控制 Ctrl+V / 右键粘贴时源各方面如何落目标(覆盖/合并/仅值)。
+     * 不传 = 默认;也可 `viewer.setPasteBehavior(cfg)` 运行时改、右键「选择性粘贴」逐次选预设。
+     */
+    pasteBehavior?: Partial<PasteBehavior>;
+    /** 粘贴撞只读格的内置提醒:'dialog'(默认,弹窗列出哪些格只读)/ 'toast'(气泡)/ 'none'(只发事件) */
+    readOnlyPrompt?: 'dialog' | 'toast' | 'none';
     /**
      * 内置导出进度遮罩(P1.5):默认 `true` —— 调 `viewer.downloadPdf` / `downloadImage` / `downloadXlsx` /
      * `print` / 选区图片批量转换 时,壳自动建 `AbortController` + 接 `onProgress` →
@@ -206,12 +226,34 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     setActiveSheet(index: number): void;
     getSelection(): MergeRange | null;
     setSelection(range: MergeRange): void;
+    scrollToCell(row: number, col: number, opts?: {
+        select?: boolean;
+    }): boolean;
     rectOf(row: number, col: number): import('../core/plugin').Rect | null;
     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;
+    sortActiveColumn(dir: "asc" | "desc"): boolean;
+    createPivotTable(opts: import('../core/plugin').CreatePivotTableOptions): boolean;
+    createPivotTableFromSelection(opts?: {
+        rowFieldIndex?: number;
+        valueFieldIndex?: number;
+        output?: import('../core/plugin').PivotOutput;
+    }): boolean;
+    openPivotTableDialog(): boolean;
+    getConditionalRules(): import('../core/model/types').ConditionalRule[];
+    addConditionalRule(rule: Partial<import('../core/model/types').ConditionalRule> & Pick<import('../core/model/types').ConditionalRule, "ranges" | "type">): string | false;
+    updateConditionalRule(ruleId: string, patch: Partial<import('../core/model/types').ConditionalRule>): boolean;
+    removeConditionalRule(ruleId: string): boolean;
+    setConditionalRules(rules: import('../core/model/types').ConditionalRule[]): boolean;
+    openConditionalFormatDialog(): boolean;
+    setSelectionNumberFormat(code: string): boolean;
+    openNumberFormatDialog(): boolean;
+    getCellComment(row: number, col: number): string;
+    setCellComment(row: number, col: number, comment: string): boolean;
+    openCommentEditor(row?: number, col?: number): boolean;
     exportImage(opts?: ImageExportOptions): Promise<Blob>;
     downloadImage(opts?: ImageExportOptions): Promise<void>;
     exportPdf(opts?: PdfExportOptions): Promise<Blob>;
@@ -266,7 +308,10 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     pasteRichHtml(html: string, at?: {
         row: number;
         col: number;
-    }): boolean;
+    }, behaviorOverride?: Partial<PasteBehavior> | null): boolean;
+    getPasteBehavior(): PasteBehavior;
+    setPasteBehavior(cfg: Partial<PasteBehavior> | null): void;
+    openPasteConfigDialog(): boolean;
     pasteImageBlob(blob: Blob, at?: {
         row: number;
         col: number;

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

@@ -4,6 +4,8 @@ type __VLS_Props = {
     current: number;
     matchCase: boolean;
     wholeCell: boolean;
+    editable: boolean;
+    replace: string;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {
     focus: () => void | undefined;
@@ -12,15 +14,21 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     "update:query": (v: string) => any;
     "update:matchCase": (v: boolean) => any;
     "update:wholeCell": (v: boolean) => any;
+    "update:replace": (v: string) => any;
     next: () => any;
     prev: () => any;
+    "replace-one": () => any;
+    "replace-all": () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClose?: (() => any) | undefined;
     "onUpdate:query"?: ((v: string) => any) | undefined;
     "onUpdate:matchCase"?: ((v: boolean) => any) | undefined;
     "onUpdate:wholeCell"?: ((v: boolean) => any) | undefined;
+    "onUpdate:replace"?: ((v: string) => any) | undefined;
     onNext?: (() => any) | undefined;
     onPrev?: (() => any) | undefined;
+    "onReplace-one"?: (() => any) | undefined;
+    "onReplace-all"?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     inputEl: HTMLInputElement;
 }, HTMLDivElement>;

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

@@ -0,0 +1,10 @@
+import { CellValue } from '../model/data-access';
+/**
+ * 接续 source 产出 count 个新值。source 已按填充正方向排序(至少 1 个)。
+ *
+ * `ctrl` = 拖拽时是否按住 Ctrl,翻转"复制 ↔ 序列"(对齐 Excel/WPS):
+ *  - 数值:普通 单个→复制 / ≥2→等差;Ctrl 单个→递增(+1) / ≥2→复制
+ *  - 日期/星期月份/文本递增:普通→序列;Ctrl→复制
+ *  - 纯文本:始终循环复制(Ctrl 无影响)
+ */
+export declare function computeFillSeries(source: CellValue[], count: number, ctrl?: boolean): CellValue[];

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

@@ -17,7 +17,19 @@ export interface ParsedClipboard {
         col: number;
         dataUrl: string;
     }[];
+    /** 列宽(相对列 index → px;来自 <col width>);稀疏 */
+    colWidths: number[];
+    /** 行高(相对行 index → px;来自 <tr height>);稀疏 */
+    rowHeights: number[];
 }
+/** mso-number-format 的值是 CSS 转义的 Excel 格式码(\0022→" \#→# \;→; \\(→\( …),解回真实格式码。 */
+export declare function unescapeMsoNumFmt(v: string): string;
+/**
+ * 从合并 CSS 串里解析 mso-number-format → Excel 格式码(值可能含转义的 \; ,故按引号串/到分号匹配)。
+ * **取最后一条**:合并串是 `td默认;类;内联`,按 CSS 层叠后写的覆盖——裸 `td` 默认常带 `mso-number-format:General`,
+ * 若取第一条会被它的 General 顶掉、丢掉后面类里的真实日期/货币格式码。
+ */
+export declare function parseMsoNumberFormat(css: string): string | undefined;
 /**
  * 解析剪贴板 HTML → {values, styles, merges, images}。非浏览器环境 / 无 <table> 返 null(调用方回退 TSV)。
  */

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

@@ -0,0 +1,76 @@
+import { AnchorCell, CellModel, CellStyle, CellValueType, MergeRange, RichTextRun, SheetModel, WorkbookModel } from '../model/types';
+/** raw 是 Date 时序列化为 {__d: epochMs},反序列化还原。其余原样 JSON。 */
+type ClipRaw = number | string | boolean | null | {
+    __d: number;
+};
+export interface ClipCell {
+    r: number;
+    c: number;
+    type: CellValueType;
+    raw: ClipRaw;
+    formula?: string;
+    hyperlink?: string;
+    comment?: string;
+    rich?: RichTextRun[];
+    dispImgId?: string;
+    style: CellStyle;
+}
+export interface ClipImage {
+    from: AnchorCell;
+    to?: AnchorCell;
+    extWidthEmu?: number;
+    extHeightEmu?: number;
+    editAs?: string;
+    mime: string;
+    b64: string;
+}
+export interface ClipCellImage {
+    id: string;
+    mime: string;
+    b64: string;
+}
+export interface ClipDim {
+    i: number;
+    height?: number;
+    width?: number;
+    hidden?: boolean;
+    custom?: boolean;
+}
+export interface ClipSnapshot {
+    v: 1;
+    rows: number;
+    cols: number;
+    cells: ClipCell[];
+    merges: MergeRange[];
+    images: ClipImage[];
+    cellImages: ClipCellImage[];
+    rowHeights: ClipDim[];
+    colWidths: ClipDim[];
+}
+/** 图片字节预算(原始字节):复制区图片总字节超此值 → 降级为"无图 1:1 复制",避免剪贴板超限/卡顿。 */
+export declare const CLIP_IMAGE_BUDGET_BYTES: number;
+/**
+ * 抓一段区域的完整模型快照(相对坐标)。
+ * `withImageBytes=false`:图片只记引用(id / 浮动序号),b64 留空 —— 给"图片字节走可见 `<img>`、
+ * 快照只引用"的瘦身传输用(避免图片被双重 base64),粘贴时由 parseSnapshotHtml 从 `<img>` 回填字节。
+ */
+export declare function serializeSnapshot(sheet: SheetModel, wb: WorkbookModel, range: MergeRange, opts?: {
+    withImageBytes?: boolean;
+}): ClipSnapshot;
+/** ClipRaw → 运行时 raw(还原 Date)。 */
+export declare function reviveClipRaw(raw: ClipRaw): CellModel['raw'];
+export declare function encodeSnapshot(snap: ClipSnapshot): string;
+export declare function decodeSnapshot(s: string | null | undefined): ClipSnapshot | null;
+/**
+ * 把图片字节从可见 `<img data-clip-img="key">` 回填进瘦身快照(传输优化:图片只在 `<img>` 存一份)。
+ * key 约定:DISPIMG 单元格图 = `c:${id}`,浮动图 = `f:${序号}`(序号同 serializeSnapshot 的 images 顺序)。
+ * 已带 b64(完整快照路径)则原样保留。
+ */
+export declare function reattachImages(snap: ClipSnapshot | null, imgB64: Map<string, string>): ClipSnapshot | null;
+/** 降级:去掉所有图片(超字节预算时用)。DISPIMG 格中性化为空格(保样式),避免粘出引用不到的破图。 */
+export declare function withoutImages(snap: ClipSnapshot): ClipSnapshot;
+/** 从剪贴板 HTML 抽出本组件的 1:1 快照(`<table data-ooxml-clip="...">` + 回填 `<img>` 字节);非本组件复制返 null。 */
+export declare function parseSnapshotHtml(html: string): ClipSnapshot | null;
+export declare function bytesToB64(bytes: Uint8Array): string;
+export declare function b64ToBytes(b64: string): Uint8Array;
+export {};

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

@@ -1,4 +1,4 @@
-import { CellModel, CellStyleOverride, ColumnInfo, ImageAnchor, MergeRange, RowInfo, SheetModel, WorkbookModel } from '../model/types';
+import { CellModel, CellStyleOverride, ColumnInfo, ConditionalRule, ImageAnchor, MergeRange, RowInfo, SheetModel, WorkbookModel } from '../model/types';
 import { CellValue } from '../model/data-access';
 import { StructOp } from '../model/structure';
 export type CellPos = {
@@ -64,6 +64,14 @@ export type EditCommand = {
 } | {
     kind: 'unmerge-cells';
     range: MergeRange;
+} | {
+    kind: 'set-conditional';
+    rules: ConditionalRule[];
+} | {
+    kind: 'set-comment';
+    row: number;
+    col: number;
+    comment: string;
 } | {
     kind: 'restore-merges';
     merges: MergeRange[];

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

@@ -1,6 +1,7 @@
 /**
  * 右键上下文菜单宿主(框架无关 DOM)—— 挂到 document.body 的 fixed 菜单,点项执行 action + 关闭,
- * 点外部 / Esc 关闭,贴边自动翻转。Vue / React 壳只把 contextmenu 事件转给 controller,菜单逻辑全在这。
+ * 点外部 / Esc 关闭,贴边自动翻转。支持一级子菜单(`children`,悬停展开右侧 flyout)。
+ * Vue / React 壳只把 contextmenu 事件转给 controller,菜单逻辑全在这。
  */
 export interface MenuItem {
     label?: string;
@@ -8,12 +9,24 @@ export interface MenuItem {
     disabled?: boolean;
     /** true = 分隔线 */
     separator?: boolean;
+    /** 子菜单项(有则该行不执行 action,悬停展开右侧 flyout) */
+    children?: MenuItem[];
 }
 export declare class ContextMenuHost {
     private el;
+    private submenus;
+    private openSubRow;
+    private subCloseTimer;
     private cleanup;
     isOpen(): boolean;
     show(x: number, y: number, items: MenuItem[]): void;
+    /** 建一级菜单 DOM(不挂载、不定位);子菜单悬停时再建 flyout。 */
+    private buildMenu;
+    /** 在 row 右侧展开子菜单 flyout(贴边翻转到左侧);悬停 flyout 取消关闭,离开 flyout 延时关。 */
+    private openSubmenu;
+    private scheduleSubClose;
+    private cancelSubClose;
+    private closeAllSubmenus;
     close(): void;
     dispose(): void;
 }

package/dist/core/edit/data-validation.d.ts

@@ -0,0 +1,15 @@
+import { DataValidationRule, SheetModel } from '../model/types';
+import { CellValue } from '../model/data-access';
+export interface ValidationViolation {
+    rule: DataValidationRule;
+    errorStyle: 'stop' | 'warning' | 'information';
+    title?: string;
+    message: string;
+}
+/** 找命中 (row,col) 的数据验证规则(Excel 一格至多一条;取首个包含该格的)。 */
+export declare function findValidationRuleAt(sheet: SheetModel, row: number, col: number): DataValidationRule | undefined;
+/**
+ * 校验一个值是否满足规则。返回 null = 合法(放行);返回 violation = 非法。
+ * 空值一律放行(允许清空 —— 拦截清空对预览/编辑组件太粗暴;allowBlank 只表"空值跳过其余校验")。
+ */
+export declare function validateCellValue(rule: DataValidationRule, value: CellValue): ValidationViolation | null;

package/dist/core/edit/edit-controller.d.ts

@@ -1,7 +1,9 @@
-import { CellStyleOverride, ColumnInfo, ImageAnchor, MergeRange, RowInfo, SheetModel, WorkbookModel } from '../model/types';
+import { CellStyleOverride, ColumnInfo, ConditionalRule, ImageAnchor, MergeRange, RowInfo, SheetModel, WorkbookModel } from '../model/types';
 import { CellValue } from '../model/data-access';
 import { CellSnapshot } from '../model/snapshot';
+import { PasteBehavior } from './paste-behavior';
 import { ParsedClipboard } from './clipboard-html';
+import { ClipSnapshot } from './clipboard-snapshot';
 import { CellPos, DimAxis, EditCommand } from './commands';
 import { StructOp } from '../model/structure';
 import { FormulaEngineFactory } from '../formula/engine';
@@ -72,7 +74,12 @@ export declare class EditController {
     private engine;
     private engineFor;
     private warming;
+    private pasteBehavior;
     constructor(host: EditControllerHost);
+    /** 读当前粘贴行为(完整配置)。 */
+    getPasteBehavior(): PasteBehavior;
+    /** 设粘贴行为默认(缺项回落默认);影响 Ctrl+V / 右键「粘贴」。 */
+    setPasteBehavior(cfg: Partial<PasteBehavior> | null): void;
     /** 异步懒初始化引擎(开重算 + 有工厂 + 尚未为当前簿建好)。返回的 Promise 供测试 await;生产 fire-and-forget。 */
     warmEngine(): Promise<void>;
     /** 释放引擎(切簿/关重算/dispose)。 */
@@ -94,14 +101,38 @@ export declare class EditController {
     editCell(row: number, col: number, value: CellValue): boolean;
     /** 区域批量设值(2D,左上对齐 range.top/left);跳过只读格,返回是否有改动 */
     editRange(range: MergeRange, values: CellValue[][]): boolean;
+    /** 设/清单元格批注(1.11.0,单次撤销)。 */
+    setCellComment(row: number, col: number, comment: string): boolean;
+    /** 批量设一组散列格(自动填充用,1.10.0):跳过只读格,整体单次撤销。 */
+    setCellsBatch(cells: {
+        row: number;
+        col: number;
+        value: CellValue;
+    }[]): boolean;
+    /** 替换整张表的条件格式规则集(1.9.0,整体单次撤销)。规则对象不可变 → 直接换数组。 */
+    setConditionalRules(rules: ConditionalRule[]): boolean;
+    /** 合并区 m 是否与矩形 [top,left]-[bottom,right] 有交叠(用于清粘贴区内的目标原有合并)。 */
+    private _mergeOverlaps;
     /**
      * 富粘贴(Excel/WPS 复制的 HTML 解析后):值 + 样式 + 合并 + 图片,**整体单次撤销**。
      * start = 落点左上角。跳过只读格。一次 cloneWorkbook 快照 → 应用全部 → 压一条 restore-wb 逆。
+     * behaviorOverride = 右键「选择性粘贴」逐次预设(覆盖 this.pasteBehavior;缺省走默认配置)。
      */
     pasteRich(start: {
         row: number;
         col: number;
-    }, parsed: ParsedClipboard): boolean;
+    }, parsed: ParsedClipboard, behaviorOverride?: Partial<PasteBehavior> | null): boolean;
+    /** 去重后发一次 paste 的 permission-denied(没只读格则不发)。 */
+    private _emitPasteDenied;
+    /**
+     * 1:1 保真粘贴:用复制时序列化进剪贴板的完整模型快照(本组件自己复制的,跨实例 Vue3/Vue2/React 通用)
+     * 覆盖式落到目标区 —— 完整还原 值/原始类型/数字格式/全部样式(含边框)/合并/图片(浮动 + DISPIMG)/行高列宽。
+     * 跟 pasteRich(外部 HTML 近似)同走命令栈(整体单次撤销)+ 前后快照 cell-change + 只读 permission-denied。
+     */
+    pasteSnapshot(start: {
+        row: number;
+        col: number;
+    }, snap: ClipSnapshot, behaviorOverride?: Partial<PasteBehavior> | null): boolean;
     /** 清空区域(跳过只读) */
     clearRange(range: MergeRange): boolean;
     /** 给区域套样式覆盖(E5;跳过只读格)。返回是否有改动。前后 style 不同 → 发 cell-change。 */

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

@@ -23,8 +23,11 @@ export interface CellEditorContext {
     permission: EditPermission;
     /** 进入编辑的初始文本(打字进入时为该字符;否则 undefined → editor 用 snapshot.text) */
     initialText?: string;
-    /** 提交编辑(走命令栈 + 事件);move 指示提交后活动格移动方向 */
-    commit(value: EditorCommitValue, move?: 'down' | 'right'): void;
+    /**
+     * 提交编辑(走命令栈 + 事件);move 指示提交后活动格移动方向。
+     * 返回 false = 提交被拒(如数据验证拦截),编辑器应保持打开让用户改正;void/true = 已提交。
+     */
+    commit(value: EditorCommitValue, move?: 'down' | 'right'): boolean | void;
     /** 取消编辑(不改模型) */
     cancel(): void;
     /**