xiaodao-spreader 0.1.34 → 0.1.36

package/dist/types/components/spreader/components/pickers/outline-picker.vue.d.ts

@@ -0,0 +1,26 @@
+type __VLS_Props = {
+    modelOpen?: boolean;
+    locale?: string;
+    triggerEl?: HTMLElement | null;
+};
+declare function openMenu(): void;
+declare function close(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    open: import("vue").Ref<boolean, boolean>;
+    openMenu: typeof openMenu;
+    close: typeof close;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelOpen": (v: boolean) => any;
+    action: (v: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelOpen"?: ((v: boolean) => any) | undefined;
+    onAction?: ((v: string) => any) | undefined;
+}>, {
+    modelOpen: boolean;
+    triggerEl: HTMLElement | null;
+    locale: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {
+    rootRef: HTMLDivElement;
+    menuRef: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

package/dist/types/components/spreader/components/spreader.vue.d.ts

@@ -43,10 +43,11 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         cachedTextColor: string;
         cachedFillColor: string;
         borderMenuOpen: boolean;
-        cachedBorder: import("@/components/spreader/components/pickers/borderPicker.vue").BorderType;
+        cachedBorder: import("@/components/spreader/components/pickers/border-picker.vue").BorderType;
         sortMenuOpen: boolean;
         cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
         canSort: boolean;
+        outlineMenuOpen: boolean;
         canFilter: boolean;
         filterActive: boolean;
         selHAlign: string;
@@ -92,6 +93,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "onToggle-filter"?: (() => any) | undefined;
         "onCf-new-rule"?: (() => any) | undefined;
         "onCf-manage"?: (() => any) | undefined;
+        "onOpen-data-validation"?: (() => any) | undefined;
         "onFont-family-change"?: ((v: string | number) => any) | undefined;
         "onFont-size-change"?: ((v: string | number) => any) | undefined;
         "onH-align-change"?: ((v: string | number) => any) | undefined;
@@ -102,15 +104,17 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "onNumber-format-change"?: ((v: string) => any) | undefined;
         "onFreeze-change"?: ((v: string) => any) | undefined;
         "onCf-preset"?: ((v: string) => any) | undefined;
+        "onOutline-action"?: ((v: string) => any) | undefined;
         "onFont-size-keydown"?: ((ev: KeyboardEvent) => any) | undefined;
         "onUpdate:font-size-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:text-color-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:fill-color-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:border-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:sort-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:outline-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:merge-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:calc-menu-open"?: ((v: boolean) => any) | undefined;
-        "onBorder-change"?: ((v: import("@/components/spreader/components/pickers/borderPicker.vue").BorderType) => any) | undefined;
+        "onBorder-change"?: ((v: import("@/components/spreader/components/pickers/border-picker.vue").BorderType) => any) | undefined;
         "onSort-change"?: ((v: import("@/components/spreader/core/sort-core.ts").SortOrder) => any) | undefined;
         "onMerge-change"?: ((v: import("../core/constants").MergeType) => any) | undefined;
         "onCf-clear"?: ((scope: "sheet" | "selection") => any) | undefined;
@@ -144,6 +148,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "toggle-filter": () => void;
         "cf-new-rule": () => void;
         "cf-manage": () => void;
+        "open-data-validation": () => void;
         "font-family-change": (v: string | number) => void;
         "font-size-change": (v: string | number) => void;
         "h-align-change": (v: string | number) => void;
@@ -154,15 +159,17 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "number-format-change": (v: string) => void;
         "freeze-change": (v: string) => void;
         "cf-preset": (v: string) => void;
+        "outline-action": (v: string) => void;
         "font-size-keydown": (ev: KeyboardEvent) => void;
         "update:font-size-menu-open": (v: boolean) => void;
         "update:text-color-menu-open": (v: boolean) => void;
         "update:fill-color-menu-open": (v: boolean) => void;
         "update:border-menu-open": (v: boolean) => void;
         "update:sort-menu-open": (v: boolean) => void;
+        "update:outline-menu-open": (v: boolean) => void;
         "update:merge-menu-open": (v: boolean) => void;
         "update:calc-menu-open": (v: boolean) => void;
-        "border-change": (v: import("@/components/spreader/components/pickers/borderPicker.vue").BorderType) => void;
+        "border-change": (v: import("@/components/spreader/components/pickers/border-picker.vue").BorderType) => void;
         "sort-change": (v: import("@/components/spreader/core/sort-core.ts").SortOrder) => void;
         "merge-change": (v: import("../core/constants").MergeType) => void;
         "cf-clear": (scope: "sheet" | "selection") => void;
@@ -175,6 +182,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         mergeArrowRef: HTMLButtonElement;
         calcArrowRef: HTMLButtonElement;
         sortArrowRef: HTMLButtonElement;
+        outlineArrowRef: HTMLButtonElement;
         moreBtnEl: HTMLButtonElement;
         overflowMenuEl: HTMLDivElement;
     }, any, import("vue").ComponentProvideOptions, {
@@ -207,10 +215,11 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         cachedTextColor: string;
         cachedFillColor: string;
         borderMenuOpen: boolean;
-        cachedBorder: import("@/components/spreader/components/pickers/borderPicker.vue").BorderType;
+        cachedBorder: import("@/components/spreader/components/pickers/border-picker.vue").BorderType;
         sortMenuOpen: boolean;
         cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
         canSort: boolean;
+        outlineMenuOpen: boolean;
         canFilter: boolean;
         filterActive: boolean;
         selHAlign: string;
@@ -256,6 +265,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "onToggle-filter"?: (() => any) | undefined;
         "onCf-new-rule"?: (() => any) | undefined;
         "onCf-manage"?: (() => any) | undefined;
+        "onOpen-data-validation"?: (() => any) | undefined;
         "onFont-family-change"?: ((v: string | number) => any) | undefined;
         "onFont-size-change"?: ((v: string | number) => any) | undefined;
         "onH-align-change"?: ((v: string | number) => any) | undefined;
@@ -266,15 +276,17 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "onNumber-format-change"?: ((v: string) => any) | undefined;
         "onFreeze-change"?: ((v: string) => any) | undefined;
         "onCf-preset"?: ((v: string) => any) | undefined;
+        "onOutline-action"?: ((v: string) => any) | undefined;
         "onFont-size-keydown"?: ((ev: KeyboardEvent) => any) | undefined;
         "onUpdate:font-size-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:text-color-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:fill-color-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:border-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:sort-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:outline-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:merge-menu-open"?: ((v: boolean) => any) | undefined;
         "onUpdate:calc-menu-open"?: ((v: boolean) => any) | undefined;
-        "onBorder-change"?: ((v: import("@/components/spreader/components/pickers/borderPicker.vue").BorderType) => any) | undefined;
+        "onBorder-change"?: ((v: import("@/components/spreader/components/pickers/border-picker.vue").BorderType) => any) | undefined;
         "onSort-change"?: ((v: import("@/components/spreader/core/sort-core.ts").SortOrder) => any) | undefined;
         "onMerge-change"?: ((v: import("../core/constants").MergeType) => any) | undefined;
         "onCf-clear"?: ((scope: "sheet" | "selection") => any) | undefined;

package/dist/types/components/spreader/components/toolbar.vue.d.ts

@@ -1,6 +1,6 @@
 import type { FontOption, MergeType } from '../core/constants';
 import { type NFOption } from '../core/number-format';
-import { type BorderType } from './pickers/borderPicker.vue';
+import { type BorderType } from './pickers/border-picker.vue';
 import type { SortOrder } from '../core/sort-core';
 declare function closeOverflow(): void;
 type __VLS_Props = {
@@ -30,6 +30,7 @@ type __VLS_Props = {
     sortMenuOpen: boolean;
     cachedSortOrder: SortOrder;
     canSort: boolean;
+    outlineMenuOpen: boolean;
     /** 工具栏「筛选」按钮是否可用（单选合并单元格且无筛选态时禁用） */
     canFilter: boolean;
     /** 当前 worksheet 是否已启用筛选 */
@@ -82,6 +83,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     "toggle-filter": () => void;
     "cf-new-rule": () => void;
     "cf-manage": () => void;
+    "open-data-validation": () => void;
     "font-family-change": (v: string | number) => void;
     "font-size-change": (v: string | number) => void;
     "h-align-change": (v: string | number) => void;
@@ -92,12 +94,14 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     "number-format-change": (v: string) => void;
     "freeze-change": (v: string) => void;
     "cf-preset": (v: string) => void;
+    "outline-action": (v: string) => void;
     "font-size-keydown": (ev: KeyboardEvent) => void;
     "update:font-size-menu-open": (v: boolean) => void;
     "update:text-color-menu-open": (v: boolean) => void;
     "update:fill-color-menu-open": (v: boolean) => void;
     "update:border-menu-open": (v: boolean) => void;
     "update:sort-menu-open": (v: boolean) => void;
+    "update:outline-menu-open": (v: boolean) => void;
     "update:merge-menu-open": (v: boolean) => void;
     "update:calc-menu-open": (v: boolean) => void;
     "border-change": (v: BorderType) => void;
@@ -132,6 +136,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     "onToggle-filter"?: (() => any) | undefined;
     "onCf-new-rule"?: (() => any) | undefined;
     "onCf-manage"?: (() => any) | undefined;
+    "onOpen-data-validation"?: (() => any) | undefined;
     "onFont-family-change"?: ((v: string | number) => any) | undefined;
     "onFont-size-change"?: ((v: string | number) => any) | undefined;
     "onH-align-change"?: ((v: string | number) => any) | undefined;
@@ -142,12 +147,14 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     "onNumber-format-change"?: ((v: string) => any) | undefined;
     "onFreeze-change"?: ((v: string) => any) | undefined;
     "onCf-preset"?: ((v: string) => any) | undefined;
+    "onOutline-action"?: ((v: string) => any) | undefined;
     "onFont-size-keydown"?: ((ev: KeyboardEvent) => any) | undefined;
     "onUpdate:font-size-menu-open"?: ((v: boolean) => any) | undefined;
     "onUpdate:text-color-menu-open"?: ((v: boolean) => any) | undefined;
     "onUpdate:fill-color-menu-open"?: ((v: boolean) => any) | undefined;
     "onUpdate:border-menu-open"?: ((v: boolean) => any) | undefined;
     "onUpdate:sort-menu-open"?: ((v: boolean) => any) | undefined;
+    "onUpdate:outline-menu-open"?: ((v: boolean) => any) | undefined;
     "onUpdate:merge-menu-open"?: ((v: boolean) => any) | undefined;
     "onUpdate:calc-menu-open"?: ((v: boolean) => any) | undefined;
     "onBorder-change"?: ((v: BorderType) => any) | undefined;
@@ -163,6 +170,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     mergeArrowRef: HTMLButtonElement;
     calcArrowRef: HTMLButtonElement;
     sortArrowRef: HTMLButtonElement;
+    outlineArrowRef: HTMLButtonElement;
     moreBtnEl: HTMLButtonElement;
     overflowMenuEl: HTMLDivElement;
 }, any>;

package/dist/types/components/spreader/composables/borders-merge.d.ts

@@ -1,7 +1,7 @@
 import { type Ref } from 'vue';
 import type { CoreState } from './core-state';
 import type { UndoStylesState } from './undo-styles';
-import type { BorderType } from '../components/pickers/borderPicker.vue';
+import type { BorderType } from '../components/pickers/border-picker.vue';
 import type { MergeType } from '../core/constants';
 import type { SelectionRange, BorderStyle, BorderSide } from '../core/types';
 export interface BordersMergeState {
@@ -25,6 +25,8 @@ export interface BordersMergeState {
     copySourceRange: SelectionRange | null;
     copySourceStyles: number[][];
     captureStyles: (cS: number, cE: number, rS: number, rE: number) => void;
+    /** 复制选区与源选区相交的数据验证规则（相对源选区左上角归一化，便于粘贴平移） */
+    captureDataValidations: (cS: number, cE: number, rS: number, rE: number) => void;
     setCellWithStyle: (c: number, r: number, val: string, styleId: number | null) => void;
     copyToClipboard: () => void;
     copyRowCol: () => void;

package/dist/types/components/spreader/composables/core-state.d.ts

@@ -1,7 +1,8 @@
 import { type ComputedRef, type Ref } from 'vue';
 import { FormulaDeps } from '../core/formula';
-import type { CellCoord, CellData, CellStyle, SelectionRange, BorderStyle, BorderSide, FreezePane, ViewportRegion, SheetFilter, FilterColumn, ConditionalFormattingRule, ConditionalFormattingFormat } from '../core/types';
+import type { CellCoord, CellData, CellStyle, SelectionRange, BorderStyle, BorderSide, FreezePane, ViewportRegion, SheetFilter, FilterColumn, ConditionalFormattingRule, ConditionalFormattingFormat, DataValidationRule, DataValidationResult, DataValidationSeverity, DimensionOutline } from '../core/types';
 import { type FilterCandidates } from '../core/filter-core';
+import { type OutlineValidationResult } from '../core/outline-core';
 /** 选区触发方式，影响「合并单元格是否扩大选区」。
  *  - 'cell'：单元格点击/拖动（默认）→ 保持现有 expandSelectionForMerges 行为
  *  - 'row' ：行头点击/拖动 → Excel 风格「穿透」合并，选区矩形保持用户点击的行范围
@@ -9,6 +10,20 @@ import { type FilterCandidates } from '../core/filter-core';
  *  - 'all' ：左上角全选按钮 → expandSelectionForMerges 行为
  */
 export type SelectionMode = 'cell' | 'row' | 'col' | 'all';
+/** 数据验证出错警告的用户选择：
+ *  - 'continue'：确认继续（写入非法值）；
+ *  - 'retry'  ：返回编辑态修正（stop 专用）；
+ *  - 'cancel' ：放弃本次输入（不写入）。
+ */
+export type DataValidationAlertAction = 'continue' | 'retry' | 'cancel';
+/** 出错警告弹窗需要展示的信息 */
+export interface DataValidationAlertPayload {
+    severity: DataValidationSeverity;
+    title: string;
+    message: string;
+    col: number;
+    row: number;
+}
 /** AutoFill 拖拽状态 */
 export interface AutoFillState {
     active: boolean;
@@ -88,6 +103,45 @@ export interface CoreState {
     getVisibleRowCount: () => number;
     getVisibleRowAt: (index: number) => number;
     getVisibleRowIndex: (row: number) => number;
+    /** 当前工作表行分组集合（稳定 ID，展开/折叠状态） */
+    getRowOutlines: () => DimensionOutline[];
+    /** 当前工作表列分组集合 */
+    getColumnOutlines: () => DimensionOutline[];
+    /** 在某组上创建分组；返回是否成功（失败给出提示码） */
+    addRowGroup: (start: number, end: number) => OutlineValidationResult;
+    addColumnGroup: (start: number, end: number) => OutlineValidationResult;
+    /** 取消组合：完整覆盖某个分组才允许 Ungroup，返回是否成功 */
+    removeOutline: (id: string) => boolean;
+    clearRowGroups: () => void;
+    clearColumnGroups: () => void;
+    clearAllOutlines: () => void;
+    /** 设置分组折叠状态（一次一个视图状态操作，不影响结构） */
+    setOutlineCollapsed: (id: string, collapsed: boolean, silent?: boolean) => void;
+    toggleOutline: (id: string) => void;
+    /** 当前最大分组层级（0 = 无分组） */
+    getOutlineLevel: (axis: 'row' | 'column') => number;
+    /** Outline gutter 总尺寸：无分组为 0；否则 = 等级控件条 + 层级数×单级宽度。axis='row' → 左侧 gutter 宽，axis='column' → 顶部 gutter 高 */
+    getOutlineGutterSize: (axis: 'row' | 'column') => number;
+    /** 逻辑行/列当前所处的分组层级（0 = 不在任何分组内） */
+    getRowOutlineLevel: (row: number) => number;
+    getColumnOutlineLevel: (col: number) => number;
+    /** 逻辑行/列当前是否被折叠分组隐藏 */
+    isRowCollapsed: (row: number) => boolean;
+    isColumnCollapsed: (col: number) => boolean;
+    /** 逻辑行列是否可见（Filter + Outline 组合） */
+    isRowVisible: (row: number) => boolean;
+    isColumnVisible: (col: number) => boolean;
+    /** 列是否隐藏（当前仅由列分组折叠决定） */
+    isColHidden: (col: number) => boolean;
+    /** 逻辑列宽（折叠列返回 0，供布局/命中测试使用） */
+    getColWidth: (c: number) => number;
+    /** outline 引擎注入：行列增删后的结构调整（由 sheets-ops 调用） */
+    adjustOutlinesForInsertRows: (index: number, count: number) => void;
+    adjustOutlinesForDeleteRows: (index: number, count: number) => void;
+    adjustOutlinesForInsertCols: (index: number, count: number) => void;
+    adjustOutlinesForDeleteCols: (index: number, count: number) => void;
+    /** 设置当前工作表的分组集合（加载/撤销恢复等受控场景；同时重算层级） */
+    syncOutlines: (rowOutlines: DimensionOutline[] | undefined, columnOutlines: DimensionOutline[] | undefined) => void;
     /** 基于真实行高/列宽计算冻结区域尺寸 */
     getFrozenMetrics: () => {
         frozenRowsHeight: number;
@@ -157,7 +211,9 @@ export interface CoreState {
     setCellValue: (c: number, r: number, v: string | null | undefined) => void;
     clearCellsInRange: (cS: number, cE: number, rS: number, rE: number) => void;
     startEdit: (initialValue?: string) => void;
-    commitEdit: () => void;
+    /** 提交编辑：数据验证发生在写入之前。
+     *  @returns Promise<boolean> —— true 表示已写入；false 表示被数据验证拦截（仍保持编辑态） */
+    commitEdit: () => Promise<boolean>;
     cancelEdit: () => void;
     moveActive: (dC: number, dR: number) => void;
     ensureVisible: (c: number, r: number) => void;
@@ -203,6 +259,69 @@ export interface CoreState {
     clampScroll?: (sx: number | null, sy: number | null) => void;
     /** 查找高亮钩子：返回某单元格当前的高亮类型（由 find-replace 模块注入） */
     findHighlight?: (col: number, row: number) => 'active' | 'match' | null;
+    /** 当前工作表的全部数据验证规则（规则属于 Sheet，不属于 Cell） */
+    dataValidations: DataValidationRule[];
+    /** 命中该单元格的全部规则（经空间索引，不遍历整表） */
+    getDataValidationRules: (row: number, col: number) => DataValidationRule[];
+    /** 命中该单元格的首条规则（用于「打开数据验证对话框」时回填已有规则） */
+    getDataValidationRule: (row: number, col: number) => DataValidationRule | null;
+    hasDataValidation: (row: number, col: number) => boolean;
+    /** 命中且需要显示下拉箭头的 list 规则 */
+    getListValidation: (row: number, col: number) => DataValidationRule | null;
+    /** 下拉列表数据（去重、跟随源区域变化） */
+    getValidationDropdown: (row: number, col: number) => {
+        rule: DataValidationRule;
+        items: string[];
+    } | null;
+    /** 选中单元格时展示的输入信息 */
+    getValidationInputMessage: (row: number, col: number) => {
+        title: string;
+        message: string;
+    } | null;
+    /** 核心校验入口：编辑 / 粘贴 / AutoFill 等所有输入链路统一调用 */
+    validateCell: (row: number, col: number, value: string | null | undefined) => DataValidationResult;
+    /** 批量校验（粘贴 / 填充等原子操作）：返回最严重的那条失败结果 */
+    validateCells: (entries: {
+        col: number;
+        row: number;
+        value: string | null | undefined;
+    }[]) => DataValidationResult;
+    /** 新建规则（一个完整的规则级 Undo） */
+    createDataValidation: (rule: DataValidationRule, opts?: {
+        silent?: boolean;
+    }) => DataValidationRule;
+    /** 更新既有规则（按 id），不存在则视为新建 */
+    updateDataValidation: (id: string, patch: Partial<DataValidationRule>, opts?: {
+        silent?: boolean;
+    }) => void;
+    removeDataValidation: (id: string, opts?: {
+        silent?: boolean;
+    }) => void;
+    /** 清除指定范围的验证（规则的 Range 会被拆分/缩小）；range 为 null 时清除整个工作表 */
+    clearDataValidation: (range: SelectionRange | null, opts?: {
+        silent?: boolean;
+    }) => void;
+    /** 与给定矩形相交的规则（复制携带规则时用） */
+    getDataValidationsInRange: (range: SelectionRange) => {
+        rule: DataValidationRule;
+        range: SelectionRange;
+    }[];
+    /** 将一批规则应用到目标矩形（先扣除目标区域已有规则，再写入） */
+    applyDataValidationsToRange: (rules: DataValidationRule[], target: SelectionRange, opts?: {
+        silent?: boolean;
+    }) => void;
+    /** 规则集合 / 源区域数据变化后失效索引与列表缓存 */
+    invalidateDataValidationCache: () => void;
+    /** 出错警告弹窗是否打开（编辑器 blur 提交需要避让，避免重入） */
+    isValidationAlertOpen: () => boolean;
+    /** 出错警告弹窗钩子（由 spreader.vue 注入；未注入时按「stop 拒绝 / 其它放行」处理） */
+    showValidationAlert?: (payload: DataValidationAlertPayload) => Promise<DataValidationAlertAction>;
+    /** 复用出错警告流程：传入校验失败结果，返回用户决策（供下拉选择等非编辑器入口调用） */
+    confirmInvalidValue: (res: DataValidationResult, col: number, row: number) => Promise<DataValidationAlertAction>;
+    /** 按 id 或名称取其它工作表的 cells（list 跨表引用，由 spreader.vue 注入） */
+    getSheetCellsById?: (sheetId: string) => Record<string, CellData> | null;
+    /** 请求打开「数据验证」对话框（由 spreader.vue 注入，供右键菜单 / 工具栏使用） */
+    requestDataValidationDialog?: () => void;
     /** AutoFill 拖拽状态：active 时 render 绘制预览，mouseup 触发 applyAutoFill */
     autoFillState: Ref<AutoFillState>;
     /** 一次性提交 AutoFill：saveUndo → ensureCapacity → applyAutoFillPlan → 写入 cells + formulaDeps → selectRange → scheduleRender */

package/dist/types/components/spreader/composables/interactions.d.ts

@@ -3,7 +3,20 @@ import type { CoreState } from './core-state';
 import type { UndoStylesState } from './undo-styles';
 import type { BordersMergeState } from './borders-merge';
 import type { SheetsOpsState } from './sheets-ops';
-import type { ContextMenuItem } from '../core/types';
+import type { ContextMenuItem, DataValidationRule } from '../core/types';
+/** 数据验证下拉弹窗状态：anchor 为单元格在视口中的位置（client 坐标） */
+export interface ValidationDropdownState {
+    col: number;
+    row: number;
+    rule: DataValidationRule;
+    items: string[];
+    /** 当前单元格原始值（用于标记选中项） */
+    current: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
 export interface InteractionsState {
     scheduleRender: () => void;
     render: () => void;
@@ -47,6 +60,15 @@ export interface InteractionsState {
     isFilterButtonHit: (x: number, y: number) => number;
     openFilterPopup: (col: number) => void;
     closeFilterPopup: () => void;
+    validationDropdown: Ref<ValidationDropdownState | null>;
+    /** 屏幕坐标（client）是否命中某单元格的下拉箭头；命中返回该单元格坐标（合并格返回左上角） */
+    isValidationDropdownHit: (x: number, y: number) => {
+        col: number;
+        row: number;
+    } | null;
+    openValidationDropdown: (col: number, row: number) => boolean;
+    closeValidationDropdown: () => void;
+    onValidationDropdownSelect: (value: string) => void;
     dimInputRef: Ref<HTMLInputElement | null>;
     dimPanel: Ref<{
         type: 'row' | 'col';
@@ -61,6 +83,16 @@ export interface InteractionsState {
     onDimBlur: () => void;
     applyDimPanel: () => void;
     closeDimPanel: () => void;
+    outlineGroupRows: () => boolean;
+    outlineGroupCols: () => boolean;
+    outlineUngroupRows: () => boolean;
+    outlineUngroupCols: () => boolean;
+    outlineExpandRows: () => void;
+    outlineCollapseRows: () => void;
+    outlineExpandCols: () => void;
+    outlineCollapseCols: () => void;
+    /** 分组校验提示：由宿主注入的应用内对话框；未注入时回退 window.alert */
+    showOutlineAlert?: (message: string) => void;
     editInputStyle: ComputedRef<Record<string, string | number | undefined>>;
     hScrollbarW: ComputedRef<number>;
     vScrollbarH: ComputedRef<number>;

package/dist/types/components/spreader/core/autofill.d.ts

@@ -104,12 +104,21 @@ export declare function computeTargetRange(sourceRange: SelectionRange, draggedC
  * 平移公式引用以适配目标单元格（$ 绝对引用由 shiftFormulaRefs 处理）。
  */
 export declare function translateFormulaForTarget(sourceFormula: string, sourceCell: CellCoord, targetCell: CellCoord, colCount: number, rowCount: number, colToLabelFn: (col: number) => string): string;
+/** 合并兼容性校验结果：
+ * - 'ok'：兼容；
+ * - 'source-overlap'：源区域与某合并格部分相交（既非完全包含也非不相交）；
+ * - 'target-merge-size'：目标区域命中的合并格跨距不一致（对齐 Excel「要执行此操作，所有合并单元格必须大小相同」）。
+ */
+export type MergeCompatibilityResult = {
+    ok: boolean;
+    reason: 'ok' | 'source-overlap' | 'target-merge-size';
+};
 /**
  * 校验源/目标区域与已有合并的兼容性：
  * - 源区域不能与任何 merge 部分相交（要么完全包含，要么不相交）；
- * - 目标区域不能与任何已有 merge 相交（会破坏 merge）。
+ * - 目标区域与「未被源完全包含」的 merge 相交时，要求这些 merge 行/列跨距全部一致。
  */
-export declare function validateMergeCompatibility(sourceRange: SelectionRange, targetRange: SelectionRange, merges: Record<string, SelectionRange>): boolean;
+export declare function validateMergeCompatibility(sourceRange: SelectionRange, targetRange: SelectionRange, merges: Record<string, SelectionRange>): MergeCompatibilityResult;
 /**
  * 自动填充核心：根据源/目标区域与方向生成填充增量（纯函数，不 mutate sheet）。
  * - down/right：正向延伸；up/left：反向延伸。

package/dist/types/components/spreader/core/constants.d.ts

@@ -13,6 +13,8 @@ export declare const SCROLL_STEP = 50;
 export declare const FILL_HANDLE_SIZE = 6;
 export declare const FILL_HANDLE_HIT_PADDING = 4;
 export declare const UNDO_MAX = 50;
+export declare const OUTLINE_PANEL = 16;
+export declare const OUTLINE_GUTTER = 15;
 export declare const i18n: Record<string, Record<string, string>>;
 export declare function t(locale: string, key: string): string;
 export declare const DEFAULT_FONT_FAMILY = "-apple-system, BlinkMacSystemFont, \"Segoe UI\", \"Microsoft YaHei\", sans-serif";

package/dist/types/components/spreader/core/data-validation.d.ts

@@ -0,0 +1,119 @@
+import type { CellData, SelectionRange, DataValidationRule, DataValidationResult, DataValidationOperator, DataValidationSeverity } from './types';
+/** 数据验证求值上下文（由 core-state 注入，引擎本身保持纯净） */
+export interface DataValidationContext {
+    /** 当前工作表原始单元格数据（供公式引擎引用） */
+    cells: Record<string, CellData>;
+    colCount: number;
+    rowCount: number;
+    locale: string;
+    /** 取单元格计算后的值（公式已求值） */
+    getCellValue: (col: number, row: number) => string;
+    /** 按 id 或名称取其它工作表的 cells；用于 list 类型跨表引用。取不到返回 null */
+    getSheetCells?: (sheetId: string) => Record<string, CellData> | null;
+}
+/** 生成稳定唯一 ID（供新建规则使用，禁止依赖数组 index） */
+export declare function genDataValidationId(): string;
+/** 单元格是否落在任一应用范围之内（含边界） */
+export declare function dvCellInRanges(ranges: SelectionRange[], col: number, row: number): boolean;
+/** 规则范围左上角（所有 ranges 的最小 startCol/startRow），作为相对引用的基准 */
+export declare function dvRuleAnchor(rule: DataValidationRule): {
+    col: number;
+    row: number;
+};
+/**
+ * 空值判定：null / undefined / '' / 纯空白 均视为空。
+ * 与「不存在的单元格」在业务上等价（本项目单元格缺省即空字符串）。
+ */
+export declare function isBlankValue(value: unknown): boolean;
+/** 文本长度：按 Unicode 码点统计（中文 / Emoji 不会像 UTF-16 那样被算成 2） */
+export declare function dvTextLength(value: string): number;
+/**
+ * 将「操作数」（单元格输入值或规则条件值）解析为数值。
+ * - 前导 '=' 视为公式，求值后取数值结果（如 =TODAY()）；公式错误返回 null；
+ * - 复用项目 parseNumericText 处理千分位 / 百分比 / 货币符号；
+ * - 其余走严格数值正则，避免 Number('0x10') 之类的误判。
+ */
+export declare function parseNumericOperand(raw: string, ctx: DataValidationContext): number | null;
+/**
+ * 将操作数解析为「日期序列号」。
+ * - 纯数值 → 直接作为序列号（Excel 日期序列）；
+ * - 日期/日期时间字符串 → 复用项目 parseDateTimeInput（与单元格输入识别同源）；
+ * - 纯时间字符串（如 12:30）不属于日期 → null。
+ */
+export declare function parseDateOperand(raw: string, ctx: DataValidationContext): number | null;
+/**
+ * 将操作数解析为「时间」（一天的分数，0 <= x < 1）。
+ * - 纯时间字符串 → 复用 parseDateTimeInput；
+ * - 日期时间字符串 → 取小数部分；
+ * - 数值 → 取小数部分（Excel 时间即序列的小数部分）。
+ */
+export declare function parseTimeOperand(raw: string, ctx: DataValidationContext): number | null;
+/** 通用比较：op 作用于 (value, v1[, v2])；操作数解析失败或比较数缺失一律视为不通过（返回 false） */
+export declare function compareWithOperator(op: DataValidationOperator, value: number, v1: number | null, v2: number | null): boolean;
+/**
+ * 解析 list 规则的候选项（去重、保序）。
+ * - values：直接使用常量列表；
+ * - range：读取目标区域（默认当前表，可通过 sheetId 跨表），空单元格按 allowBlank 决定是否保留。
+ * 本函数不做缓存（缓存与失效由调用方 core-state 负责）。
+ */
+export declare function resolveListItems(rule: DataValidationRule, ctx: DataValidationContext): string[];
+/** list 规则是否显示单元格内下拉箭头 */
+export declare function hasDropdownIndicator(rule: DataValidationRule | null | undefined): boolean;
+/** 单条规则求值：value 为待写入的原始文本（不含隐式类型转换），col/row 为目标单元格坐标 */
+export declare function evaluateDataValidationRule(rule: DataValidationRule, value: string | null | undefined, col: number, row: number, ctx: DataValidationContext): boolean;
+/** errorStyle → severity（未配置默认 stop） */
+export declare function dvSeverityOf(rule: DataValidationRule): DataValidationSeverity;
+/**
+ * 校验某个单元格的候选值。
+ * 规则：命中范围内的**所有**规则必须全部通过（rules.every）；
+ * 失败时取严重级别最高（stop > warning > information）的那条规则生成提示。
+ */
+export declare function validateCellValue(value: string | null | undefined, col: number, row: number, rules: DataValidationRule[], ctx: DataValidationContext): DataValidationResult;
+/**
+ * 生成默认错误提示文案（用户未自定义 title/message 时使用）。
+ * 文案按类型描述约束条件，便于用户理解「为什么非法」。
+ */
+export declare function defaultDataValidationText(rule: DataValidationRule, locale: string): {
+    title: string;
+    message: string;
+};
+/**
+ * 数据验证规则空间索引。
+ * - rebuild(rules)：重建（随规则变化调用，成本 O(区域总数)）；
+ * - getRules(col,row)：返回命中该单元格且启用的规则列表。
+ */
+export declare class DataValidationIndex {
+    private bands;
+    private dirty;
+    private source;
+    constructor(rules?: DataValidationRule[]);
+    /** 规则集合发生变化（增/删/改/切表/撤销恢复）后调用 */
+    invalidate(): void;
+    private ensure;
+    /** 命中该单元格的规则（保持源数组顺序） */
+    getRules(col: number, row: number, rules?: DataValidationRule[]): DataValidationRule[];
+    /** 该单元格是否存在任何数据验证 */
+    has(col: number, row: number, rules?: DataValidationRule[]): boolean;
+    /**
+     * 命中该单元格且满足 predicate 的首条规则。
+     * 渲染热路径（每格判定是否画下拉箭头）专用：不分配数组，零垃圾。
+     */
+    findRule(col: number, row: number, predicate: (rule: DataValidationRule) => boolean, rules?: DataValidationRule[]): DataValidationRule | null;
+    /** 取某坐标所在行带的候选条目（必要时先重建索引） */
+    private bandsOf;
+}
+/** 删除带（axis='row' 删行 / 'col' 删列）后收缩单个 Range；整段落在删除带内返回 null */
+export declare function adjustDvRangeForDelete(r: SelectionRange, axis: 'row' | 'col', idx: number, count: number): SelectionRange | null;
+/** 插入带（axis='row' 插行 / 'col' 插列）后放大单个 Range */
+export declare function adjustDvRangeForInsert(r: SelectionRange, axis: 'row' | 'col', idx: number, count: number): SelectionRange;
+/** 规则区域是否与给定矩形相交 */
+export declare function dvRangeIntersects(a: SelectionRange, b: SelectionRange): boolean;
+/**
+ * 从规则中扣除给定矩形（用于「清除所选区域的验证」）：
+ * 支持矩形差集拆分，剩余为空时返回空数组。
+ */
+export declare function subtractDvRange(range: SelectionRange, cut: SelectionRange): SelectionRange[];
+/** 平移规则的某个区域（复制粘贴携带规则时使用） */
+export declare function translateDvRange(r: SelectionRange, dCol: number, dRow: number): SelectionRange;
+/** 求两个矩形的交集；不相交返回 null */
+export declare function intersectDvRange(a: SelectionRange, b: SelectionRange): SelectionRange | null;