xiaodao-spreader 0.1.35 → 0.1.37

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

@@ -20,6 +20,8 @@ type __VLS_Props = {
     triggerIcon?: string;
     /** 触发器左侧图标旁的固定文本标签（溢出菜单中显示） */
     triggerLabel?: string;
+    /** 边界基准元素（通常是表格容器 wrapper）：菜单不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (v: string | number) => void;
@@ -30,10 +32,10 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     onChange?: ((v: string | number) => any) | undefined;
     "onUpdate:modelOpen"?: ((v: boolean) => any) | undefined;
 }>, {
+    title: string;
     width: string | number;
     menuWidth: string | number;
     visibleCount: number;
-    title: string;
     modelOpen: boolean;
     hideTrigger: boolean;
     align: "left" | "right";
@@ -43,6 +45,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     searchPlaceholder: string;
     triggerIcon: string;
     triggerLabel: string;
+    boundaryEl: HTMLElement | null;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {
     rootRef: HTMLDivElement;
     menuRef: HTMLDivElement;

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

@@ -4,6 +4,8 @@ type __VLS_Props = {
     locale?: string;
     currentBorder?: BorderType;
     triggerEl?: HTMLElement | null;
+    /** 边界基准元素（通常是表格容器 wrapper）：菜单不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
 };
 declare function openMenu(): void;
 declare function close(): void;
@@ -20,6 +22,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
 }>, {
     modelOpen: boolean;
     triggerEl: HTMLElement | null;
+    boundaryEl: HTMLElement | null;
     locale: string;
     currentBorder: BorderType;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {

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

@@ -4,6 +4,8 @@ type __VLS_Props = {
     locale?: string;
     triggerEl?: HTMLElement | null;
     disabled?: boolean;
+    /** 边界基准元素（通常是表格容器 wrapper）：菜单不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
 };
 declare function openMenu(): void;
 declare function close(): void;

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

@@ -4,6 +4,8 @@ type __VLS_Props = {
     currentColor?: string;
     locale?: string;
     triggerEl?: HTMLElement | null;
+    /** 边界基准元素（通常是表格容器 wrapper）：菜单不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
 };
 declare function openMenu(): void;
 declare function close(): void;
@@ -22,6 +24,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
 }>, {
     modelOpen: boolean;
     triggerEl: HTMLElement | null;
+    boundaryEl: HTMLElement | null;
     currentColor: string;
     colorKey: string;
     locale: string;

package/dist/types/components/spreader/components/pickers/conditional-format-menu.vue.d.ts

@@ -2,18 +2,26 @@ type __VLS_Props = {
     locale: string;
     hasSelection: boolean;
     themeVars?: Record<string, string>;
+    /** 边界基准元素（通常是表格容器 wrapper）：菜单不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
+    /** 受控展开状态：由 toolbar 的 coordToolbarMenu 协调器统一管理（同一时刻仅一个下拉打开） */
+    modelOpen?: boolean;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     preset: (type: string) => void;
     "new-rule": () => void;
     manage: () => void;
     clear: (scope: "sheet" | "selection") => void;
+    "update:modelOpen": (v: boolean) => void;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelOpen"?: ((v: boolean) => any) | undefined;
+    onClear?: ((scope: "sheet" | "selection") => any) | undefined;
     onPreset?: ((type: string) => any) | undefined;
     "onNew-rule"?: (() => any) | undefined;
     onManage?: (() => any) | undefined;
-    onClear?: ((scope: "sheet" | "selection") => any) | undefined;
 }>, {
+    modelOpen: boolean;
+    boundaryEl: HTMLElement | null;
     themeVars: Record<string, string>;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {
     rootRef: HTMLDivElement;

package/dist/types/components/spreader/components/pickers/data-validation-alert.vue.d.ts

@@ -2,8 +2,8 @@ import type { DataValidationSeverity } from '../../core/types';
 type __VLS_Props = {
     locale: string;
     severity: DataValidationSeverity;
-    title: string;
-    message: string;
+    title?: string;
+    message?: string;
     themeVars?: Record<string, string>;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {

package/dist/types/components/spreader/components/pickers/data-validation-dialog.vue.d.ts

@@ -6,10 +6,10 @@ type __VLS_Props = {
     defaultRangeText?: string;
     themeVars?: Record<string, string>;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    cancel: () => any;
-    clear: () => any;
-    save: (rule: DataValidationRule) => any;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    save: (rule: DataValidationRule) => void;
+    cancel: () => void;
+    clear: () => void;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onCancel?: (() => any) | undefined;
     onClear?: (() => any) | undefined;

package/dist/types/components/spreader/components/pickers/data-validation-dropdown.vue.d.ts

@@ -1,26 +1,28 @@
 type __VLS_Props = {
-    items: string[];
+    items?: string[];
     /** 当前单元格原始值（用于标记已选项） */
-    current: string;
-    locale: string;
+    current?: string;
+    locale?: string;
     /** 锚点单元格在视口中的位置与尺寸（client 坐标） */
-    x: number;
-    y: number;
-    width: number;
-    height: number;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    /** 边界基准元素（通常是表格容器 wrapper）：下拉不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    close: () => any;
     select: (value: string) => any;
+    close: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onClose?: (() => any) | undefined;
     onSelect?: ((value: string) => any) | undefined;
+    onClose?: (() => any) | undefined;
 }>, {
     y: number;
     width: number;
     current: string;
-    locale: string;
     x: number;
+    locale: string;
     height: number;
     items: string[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {

package/dist/types/components/spreader/components/pickers/filter-popup.vue.d.ts

@@ -19,6 +19,8 @@ type __VLS_Props = {
         hasBlank: boolean;
     };
     close: () => void;
+    /** 边界基准元素（通常是表格容器 wrapper）：弹窗不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     locale: string;

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

@@ -3,6 +3,8 @@ type __VLS_Props = {
     modelOpen?: boolean;
     locale?: string;
     triggerEl?: HTMLElement | null;
+    /** 边界基准元素（通常是表格容器 wrapper）：菜单不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
 };
 declare function openMenu(): void;
 declare function close(): void;
@@ -19,6 +21,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
 }>, {
     modelOpen: boolean;
     triggerEl: HTMLElement | null;
+    boundaryEl: HTMLElement | null;
     locale: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {
     rootRef: HTMLDivElement;

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

@@ -0,0 +1,32 @@
+type __VLS_Props = {
+    modelOpen?: boolean;
+    locale?: string;
+    triggerEl?: HTMLElement | null;
+    /** 边界基准元素（通常是表格容器 wrapper）：菜单不得越出其可视区，见 bounds() */
+    boundaryEl?: HTMLElement | null;
+    /** 当前选区轴：'rows'=选中整行，'cols'=选中整列，null=未选中行/列（按钮置灰）。菜单项直接作用于该轴，不再弹「行/列」子菜单。 */
+    axis?: 'rows' | 'cols' | 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;
+    boundaryEl: HTMLElement | null;
+    locale: string;
+    axis: "rows" | "cols" | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {
+    rootRef: HTMLDivElement;
+    menuRef: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

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

@@ -4,6 +4,8 @@ type __VLS_Props = {
     locale?: string;
     currentSort?: SortOrder;
     triggerEl?: HTMLElement | null;
+    /** 边界基准元素（通常是表格容器 wrapper）：菜单不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
 };
 declare function openMenu(): void;
 declare function close(): void;
@@ -20,6 +22,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
 }>, {
     modelOpen: boolean;
     triggerEl: HTMLElement | null;
+    boundaryEl: HTMLElement | null;
     locale: string;
     currentSort: SortOrder;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {

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

@@ -47,6 +47,8 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         sortMenuOpen: boolean;
         cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
         canSort: boolean;
+        outlineMenuOpen: boolean;
+        outlineAxis?: "rows" | "cols" | null | undefined;
         canFilter: boolean;
         filterActive: boolean;
         selHAlign: string;
@@ -56,6 +58,12 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         vAlignOptions: import("../core/constants").FontOption[];
         mergeMenuOpen: boolean;
         calcMenuOpen: boolean;
+        cfMenuOpen: boolean;
+        freezeMenuOpen: boolean;
+        fontMenuOpen: boolean;
+        hAlignMenuOpen: boolean;
+        vAlignMenuOpen: boolean;
+        numFmtMenuOpen: boolean;
         isSingleCell: boolean;
         hasFreeze: boolean;
         freezePanesDisabled: boolean;
@@ -64,6 +72,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         nfOptions: import("../core/number-format").NFOption[];
         canIncreaseDecimals: boolean;
         canDecreaseDecimals: boolean;
+        boundaryEl?: HTMLElement | null | undefined;
     }> & Readonly<{
         onUndo?: (() => any) | undefined;
         onRedo?: (() => any) | undefined;
@@ -103,14 +112,22 @@ 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;
+        "onUpdate:cf-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:freeze-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:font-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:h-align-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:v-align-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:num-fmt-menu-open"?: ((v: boolean) => 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;
@@ -156,14 +173,22 @@ 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;
+        "update:cf-menu-open": (v: boolean) => void;
+        "update:freeze-menu-open": (v: boolean) => void;
+        "update:font-menu-open": (v: boolean) => void;
+        "update:h-align-menu-open": (v: boolean) => void;
+        "update:v-align-menu-open": (v: boolean) => void;
+        "update:num-fmt-menu-open": (v: boolean) => 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;
@@ -177,6 +202,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, {
@@ -213,6 +239,8 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         sortMenuOpen: boolean;
         cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
         canSort: boolean;
+        outlineMenuOpen: boolean;
+        outlineAxis?: "rows" | "cols" | null | undefined;
         canFilter: boolean;
         filterActive: boolean;
         selHAlign: string;
@@ -222,6 +250,12 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         vAlignOptions: import("../core/constants").FontOption[];
         mergeMenuOpen: boolean;
         calcMenuOpen: boolean;
+        cfMenuOpen: boolean;
+        freezeMenuOpen: boolean;
+        fontMenuOpen: boolean;
+        hAlignMenuOpen: boolean;
+        vAlignMenuOpen: boolean;
+        numFmtMenuOpen: boolean;
         isSingleCell: boolean;
         hasFreeze: boolean;
         freezePanesDisabled: boolean;
@@ -230,6 +264,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         nfOptions: import("../core/number-format").NFOption[];
         canIncreaseDecimals: boolean;
         canDecreaseDecimals: boolean;
+        boundaryEl?: HTMLElement | null | undefined;
     }> & Readonly<{
         onUndo?: (() => any) | undefined;
         onRedo?: (() => any) | undefined;
@@ -269,14 +304,22 @@ 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;
+        "onUpdate:cf-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:freeze-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:font-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:h-align-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:v-align-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:num-fmt-menu-open"?: ((v: boolean) => 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;

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

@@ -5,6 +5,8 @@ type __VLS_Props = {
     activeSheetIndex: number;
     renTab: number | null;
     renTabVal: string;
+    /** 边界基准元素（通常是表格容器 wrapper）：列表菜单不得越出其可视区，见 getFloatBounds */
+    boundaryEl?: HTMLElement | null;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "tab-click": (i: number) => void;

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

@@ -30,6 +30,9 @@ type __VLS_Props = {
     sortMenuOpen: boolean;
     cachedSortOrder: SortOrder;
     canSort: boolean;
+    outlineMenuOpen: boolean;
+    /** 当前选区轴：'rows'=选中整行，'cols'=选中整列，null=未选中行/列。决定「分组」按钮是否可用（置灰提示先选行/列） */
+    outlineAxis?: 'rows' | 'cols' | null;
     /** 工具栏「筛选」按钮是否可用（单选合并单元格且无筛选态时禁用） */
     canFilter: boolean;
     /** 当前 worksheet 是否已启用筛选 */
@@ -41,6 +44,12 @@ type __VLS_Props = {
     vAlignOptions: FontOption[];
     mergeMenuOpen: boolean;
     calcMenuOpen: boolean;
+    cfMenuOpen: boolean;
+    freezeMenuOpen: boolean;
+    fontMenuOpen: boolean;
+    hAlignMenuOpen: boolean;
+    vAlignMenuOpen: boolean;
+    numFmtMenuOpen: boolean;
     isSingleCell: boolean;
     /** 当前 worksheet 是否已有冻结行或列 */
     hasFreeze: boolean;
@@ -51,6 +60,9 @@ type __VLS_Props = {
     nfOptions: NFOption[];
     canIncreaseDecimals: boolean;
     canDecreaseDecimals: boolean;
+    /** 边界基准元素（通常是表格容器 wrapper）：弹出菜单不得越出其可视区。
+     *  组件嵌入宿主 Vue 页面时必需——否则菜单会越界盖住宿主内容。缺省时退化为纯视口判定。 */
+    boundaryEl?: HTMLElement | null;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {
     closeOverflow: typeof closeOverflow;
@@ -93,14 +105,22 @@ 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;
+    "update:cf-menu-open": (v: boolean) => void;
+    "update:freeze-menu-open": (v: boolean) => void;
+    "update:font-menu-open": (v: boolean) => void;
+    "update:h-align-menu-open": (v: boolean) => void;
+    "update:v-align-menu-open": (v: boolean) => void;
+    "update:num-fmt-menu-open": (v: boolean) => void;
     "border-change": (v: BorderType) => void;
     "sort-change": (v: SortOrder) => void;
     "merge-change": (v: MergeType) => void;
@@ -144,14 +164,22 @@ 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;
+    "onUpdate:cf-menu-open"?: ((v: boolean) => any) | undefined;
+    "onUpdate:freeze-menu-open"?: ((v: boolean) => any) | undefined;
+    "onUpdate:font-menu-open"?: ((v: boolean) => any) | undefined;
+    "onUpdate:h-align-menu-open"?: ((v: boolean) => any) | undefined;
+    "onUpdate:v-align-menu-open"?: ((v: boolean) => any) | undefined;
+    "onUpdate:num-fmt-menu-open"?: ((v: boolean) => any) | undefined;
     "onBorder-change"?: ((v: BorderType) => any) | undefined;
     "onSort-change"?: ((v: SortOrder) => any) | undefined;
     "onMerge-change"?: ((v: MergeType) => any) | undefined;
@@ -165,6 +193,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/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, DataValidationRule, DataValidationResult, DataValidationSeverity } 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 风格「穿透」合并，选区矩形保持用户点击的行范围
@@ -102,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;

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

@@ -83,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/composables/useFloatMenuPosition.d.ts

@@ -0,0 +1,39 @@
+export interface FloatMenuPosition {
+    /** fixed 定位：右缘（px），与 trigger 右缘对齐后夹回有效右边界 */
+    right?: number;
+    /** fixed 定位：左缘（px）。默认不使用，仅当右缘锚定不可用时的兜底 */
+    left?: number;
+    /** fixed 定位：上缘（px） */
+    top: number;
+    /** 是否向上翻向弹出（trigger 下方放不下且上方有空间） */
+    up: boolean;
+}
+/**
+ * 主弹出菜单（工具栏下拉框：条件格式 / 分组等）的统一定位逻辑。
+ *
+ * 与 conditional-format-menu.vue 原实现完全同构，抽出来让所有工具栏下拉框复用同一套，
+ * 不再各写一套：
+ * - 右缘锚定 trigger 右缘（Math.min(r.right, b.right) 夹回有效右边界），top 先落 trigger 下缘 +4；
+ * - 传入 menuEl（已挂载、可量高度）后，按「容器∩视口」有效区做上下翻向 + 夹紧：
+ *   下方放得下就向下；下方放不下但上方有空间就向上；两边都放不下→夹紧贴顶/贴底兜底。
+ *   夹紧下界取 min(b.top + 8, trigger 下缘 + 4)：工具栏按钮在 boundaryEl（表格容器）之上，
+ *   此时 b.top + 8 落在按钮下方，若仍以它为下界会把菜单硬推离按钮数十像素（主栏下拉整体下移），
+ *   故下界不得高于「紧贴 trigger 下方」这一理想位置。
+ *
+ * 调用约定（与 cf-menu 一致）：先 place(trigger, boundary) 做初始下落放置，
+ * 再于 nextTick 后 place(trigger, boundary, menuEl) 量高翻向。
+ */
+export declare function useFloatMenuPosition(): {
+    pos: import("vue").Ref<{
+        right?: number | undefined;
+        left?: number | undefined;
+        top: number;
+        up: boolean;
+    }, FloatMenuPosition | {
+        right?: number | undefined;
+        left?: number | undefined;
+        top: number;
+        up: boolean;
+    }>;
+    place: (triggerEl: HTMLElement, boundaryEl: HTMLElement | null | undefined, menuEl?: HTMLElement | null) => void;
+};

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";