xiaodao-spreader 0.1.36 → 0.1.37

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

@@ -2,6 +2,10 @@ 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;
@@ -18,7 +22,9 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
 }>, {
     modelOpen: boolean;
     triggerEl: HTMLElement | null;
+    boundaryEl: HTMLElement | null;
     locale: string;
+    axis: "rows" | "cols" | null;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {
     rootRef: HTMLDivElement;
     menuRef: HTMLDivElement;

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

@@ -48,6 +48,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
         canSort: boolean;
         outlineMenuOpen: boolean;
+        outlineAxis?: "rows" | "cols" | null | undefined;
         canFilter: boolean;
         filterActive: boolean;
         selHAlign: string;
@@ -57,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;
@@ -65,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;
@@ -114,6 +122,12 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "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;
@@ -169,6 +183,12 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "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;
@@ -220,6 +240,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
         canSort: boolean;
         outlineMenuOpen: boolean;
+        outlineAxis?: "rows" | "cols" | null | undefined;
         canFilter: boolean;
         filterActive: boolean;
         selHAlign: string;
@@ -229,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;
@@ -237,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;
@@ -286,6 +314,12 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "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

@@ -31,6 +31,8 @@ type __VLS_Props = {
     cachedSortOrder: SortOrder;
     canSort: boolean;
     outlineMenuOpen: boolean;
+    /** 当前选区轴：'rows'=选中整行，'cols'=选中整列，null=未选中行/列。决定「分组」按钮是否可用（置灰提示先选行/列） */
+    outlineAxis?: 'rows' | 'cols' | null;
     /** 工具栏「筛选」按钮是否可用（单选合并单元格且无筛选态时禁用） */
     canFilter: boolean;
     /** 当前 worksheet 是否已启用筛选 */
@@ -42,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;
@@ -52,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;
@@ -104,6 +115,12 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     "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;
@@ -157,6 +174,12 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     "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;

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/outline-core.d.ts

@@ -14,8 +14,8 @@ export declare function countContaining(outlines: DimensionOutline[], start: num
  * 规则：
  *   - start <= end
  *   - 至少连续 2 个维度
- *   - 与既有分组要么不相交要么完全包含，禁止部分重叠
- *   - 层级（countContaining + 1）不超过 MAX_OUTLINE_LEVEL
+ *   - 与既有分组必须完全不相交，禁止部分重叠与嵌套（仅支持一层分组）
+ *   - 层级恒为 1（countContaining 必须为 0）
  */
 export declare function validateGroup(existing: DimensionOutline[], start: number, end: number): OutlineValidationResult;
 /** 创建分组后的新集合（校验失败返回原集合，同时给出校验结果供调用方提示） */

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

@@ -252,8 +252,8 @@ export interface DataValidationResult {
     title?: string;
     message?: string;
 }
-/** 单个行列分组的最大支持层级（与 Excel 一致，最多 8 级） */
-export declare const MAX_OUTLINE_LEVEL = 8;
+/** 单个行列分组的最大支持层级：固定为 1，即仅支持一层分组（分组之间互不嵌套） */
+export declare const MAX_OUTLINE_LEVEL = 1;
 /** 维度分组：属于 Sheet 的结构元数据。start/end 为 0-based 闭区间，且 start <= end */
 export interface DimensionOutline {
     /** 稳定唯一 ID（禁止数组 index） */

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

@@ -24,3 +24,23 @@ export declare function getCanvasXY(e: MouseEvent, canvas: HTMLCanvasElement | n
 export declare function gridViewW(viewW: number, sbSize: number): number;
 /** 网格可视区域高度（减去行头和滚动条） */
 export declare function gridViewH(viewH: number, sbSize: number): number;
+/** 浮层可用的有效边界（视口坐标系）。
+ *
+ * 取「组件容器(boundaryEl)」∩「浏览器视口」的交集，两者都不能单独作为判据：
+ *   - 浏览器视口：浮层 Teleport 到 body + position:fixed，挂在视口坐标系，越出视口一定看不见（硬边界）。
+ *     但组件作为子组件嵌入宿主页面时只占页面一部分，纯视口判定会漏算两侧留白 → 越界盖住宿主内容。
+ *   - 组件容器：嵌入场景下把浮层夹在表格可视区内。但容器可能大于视口（页面滚动、边缘在视口外），
+ *     纯容器判定会把「其实已在视口外」当成有空间 → 浮层照样看不见。
+ *
+ * 取交集后：组件全屏时容器≈视口，自然退化为纯视口判定；boundaryEl 为空时同样退化为纯视口。
+ */
+export interface FloatBounds {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
+export declare function getFloatBounds(boundaryEl?: HTMLElement | null): FloatBounds;
+/** 把「视口坐标 x」换算成 fixed 定位的 CSS `right` 值（相对视口右缘的偏移）。
+ *  浮层以 position:fixed 挂在视口坐标系，故换算基准恒为 window.innerWidth，与有效边界无关。 */
+export declare function cssRightFromX(x: number): number;