xiaodao-spreader 0.1.38 → 0.1.41

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

@@ -45,7 +45,9 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         cachedTextColor: string;
         cachedFillColor: string;
         borderMenuOpen: boolean;
-        cachedBorder: import("@/components/spreader/components/pickers/border-picker.vue").BorderType;
+        cachedBorder: import("@/components/spreader/core/border-icon.ts").BorderType;
+        cachedBorderColor: string;
+        cachedBorderLineStyle: string;
         sortMenuOpen: boolean;
         cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
         canSort: boolean;
@@ -111,6 +113,8 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "onFont-size-input"?: ((v: string) => any) | undefined;
         "onText-color-change"?: ((v: string) => any) | undefined;
         "onFill-color-change"?: ((v: string) => any) | undefined;
+        "onBorder-color-change"?: ((v: string) => any) | undefined;
+        "onBorder-line-style-change"?: ((v: string) => any) | undefined;
         "onNumber-format-change"?: ((v: string) => any) | undefined;
         "onFreeze-change"?: ((v: string) => any) | undefined;
         "onCf-preset"?: ((v: string) => any) | undefined;
@@ -130,7 +134,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "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;
+        "onBorder-change"?: ((v: import("@/components/spreader/core/border-icon.ts").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;
@@ -172,6 +176,8 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "font-size-input": (v: string) => void;
         "text-color-change": (v: string) => void;
         "fill-color-change": (v: string) => void;
+        "border-color-change": (v: string) => void;
+        "border-line-style-change": (v: string) => void;
         "number-format-change": (v: string) => void;
         "freeze-change": (v: string) => void;
         "cf-preset": (v: string) => void;
@@ -191,7 +197,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "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;
+        "border-change": (v: import("@/components/spreader/core/border-icon.ts").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;
@@ -237,7 +243,9 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         cachedTextColor: string;
         cachedFillColor: string;
         borderMenuOpen: boolean;
-        cachedBorder: import("@/components/spreader/components/pickers/border-picker.vue").BorderType;
+        cachedBorder: import("@/components/spreader/core/border-icon.ts").BorderType;
+        cachedBorderColor: string;
+        cachedBorderLineStyle: string;
         sortMenuOpen: boolean;
         cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
         canSort: boolean;
@@ -303,6 +311,8 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "onFont-size-input"?: ((v: string) => any) | undefined;
         "onText-color-change"?: ((v: string) => any) | undefined;
         "onFill-color-change"?: ((v: string) => any) | undefined;
+        "onBorder-color-change"?: ((v: string) => any) | undefined;
+        "onBorder-line-style-change"?: ((v: string) => any) | undefined;
         "onNumber-format-change"?: ((v: string) => any) | undefined;
         "onFreeze-change"?: ((v: string) => any) | undefined;
         "onCf-preset"?: ((v: string) => any) | undefined;
@@ -322,7 +332,7 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
         "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;
+        "onBorder-change"?: ((v: import("@/components/spreader/core/border-icon.ts").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,7 +1,7 @@
 import type { FontOption, MergeType } from '../core/constants';
 import { type NFOption } from '../core/number-format';
-import { type BorderType } from './pickers/border-picker.vue';
 import type { SortOrder } from '../core/sort-core';
+import { type BorderType } from '../core/border-icon';
 declare function closeOverflow(): void;
 type __VLS_Props = {
     locale: string;
@@ -27,6 +27,10 @@ type __VLS_Props = {
     cachedFillColor: string;
     borderMenuOpen: boolean;
     cachedBorder: BorderType;
+    /** 当前色板选中的边框颜色；'' = 自动（缺省回退默认边框色）。仅用于边框颜色菜单项的色块与色板高亮，不反映选区边框色 */
+    cachedBorderColor: string;
+    /** 当前笔刷线型（solid/dashed/dotted）；仅用于边框线型子菜单高亮，不反映选区边框线型 */
+    cachedBorderLineStyle: string;
     sortMenuOpen: boolean;
     cachedSortOrder: SortOrder;
     canSort: boolean;
@@ -61,7 +65,7 @@ type __VLS_Props = {
     canIncreaseDecimals: boolean;
     canDecreaseDecimals: boolean;
     /** 边界基准元素（通常是表格容器 wrapper）：弹出菜单不得越出其可视区。
-     *  组件嵌入宿主 Vue 页面时必需——否则菜单会越界盖住宿主内容。缺省时退化为纯视口判定。 */
+     *  组件嵌入宿主 Vue 页面时必需，否则菜单会越界盖住宿主内容。缺省时退化为纯视口判定。 */
     boundaryEl?: HTMLElement | null;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {
@@ -102,6 +106,8 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     "font-size-input": (v: string) => void;
     "text-color-change": (v: string) => void;
     "fill-color-change": (v: string) => void;
+    "border-color-change": (v: string) => void;
+    "border-line-style-change": (v: string) => void;
     "number-format-change": (v: string) => void;
     "freeze-change": (v: string) => void;
     "cf-preset": (v: string) => void;
@@ -161,6 +167,8 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     "onFont-size-input"?: ((v: string) => any) | undefined;
     "onText-color-change"?: ((v: string) => any) | undefined;
     "onFill-color-change"?: ((v: string) => any) | undefined;
+    "onBorder-color-change"?: ((v: string) => any) | undefined;
+    "onBorder-line-style-change"?: ((v: string) => any) | undefined;
     "onNumber-format-change"?: ((v: string) => any) | undefined;
     "onFreeze-change"?: ((v: string) => any) | undefined;
     "onCf-preset"?: ((v: string) => any) | undefined;

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

@@ -1,14 +1,30 @@
-import { type Ref } from 'vue';
+/**
+ * 边框 / 合并 / 剪贴板 / 计算 组合层（依赖 Vue，不做渲染）。
+ * 承载工具栏与右键菜单发起的操作：按边设置边框（颜色、线型、owner 标记）、
+ * 合并拆分单元格、复制 / 剪切 / 粘贴、选区求和 / 平均 / 计数。
+ */
+import { type Ref, type ComputedRef } from 'vue';
 import type { CoreState } from './core-state';
 import type { UndoStylesState } from './undo-styles';
-import type { BorderType } from '../components/pickers/border-picker.vue';
+import type { BorderType } from '../core/border-icon';
 import type { MergeType } from '../core/constants';
 import type { SelectionRange, BorderStyle, BorderSide } from '../core/types';
+import type { BorderLineStyle } from '../core/border-style';
 export interface BordersMergeState {
     cachedBorder: Ref<BorderType>;
+    /** 当前色板选中的边框颜色；'' 表示「自动」（渲染回退到主题默认边框色） */
+    cachedBorderColor: Ref<string>;
+    /** 当前笔刷线型（solid/dashed/dotted）；作为「边框绘制/应用操作」的默认线型 */
+    cachedBorderLineStyle: Ref<BorderLineStyle>;
+    /** 当前选区在「当前边框类型作用域」内的统一边框颜色；混合或无线条时返回 '' */
+    selBorderColor: ComputedRef<string>;
+    /** 当前选区在「当前边框类型作用域」内的统一边框线型；混合或无线条时返回 '' */
+    selBorderLineStyle: ComputedRef<string>;
     borderMenuOpen: Ref<boolean>;
-    BORDER_COLOR: string;
     onBorderChange: (bt: BorderType) => void;
+    onBorderColorChange: (color: string) => void;
+    /** 选择线型：更新默认线型 + 立即改选区已存在边框（不创建新边框） */
+    onBorderLineStyleChange: (style: BorderLineStyle) => void;
     setCellBorderSide: (col: number, row: number, side: 'top' | 'right' | 'bottom' | 'left', borderSide: BorderSide | undefined) => void;
     applyBorderToCell: (col: number, row: number, border: BorderStyle) => void;
     applyCachedBorder: () => void;

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

@@ -1,3 +1,9 @@
+/**
+ * CoreState - 表格运行时状态核心（依赖 Vue，渲染无关逻辑独立）。
+ * 持有当前 Sheet 的 cells / styles / borders / merges / 选区 / 冻结 / 筛选 /
+ * 数据验证 / 条件格式 / 批注 / 行列分组等状态，并提供读写、导航、行列增删、
+ * 公式与数据校验等原子操作入口。
+ */
 import { type ComputedRef, type Ref } from 'vue';
 import { FormulaDeps } from '../core/formula';
 import type { CellCoord, CellData, CellStyle, CellNote, SelectionRange, BorderStyle, BorderSide, FreezePane, ViewportRegion, SheetFilter, FilterColumn, ConditionalFormattingRule, ConditionalFormattingFormat, DataValidationRule, DataValidationResult, DataValidationSeverity, DimensionOutline } from '../core/types';
@@ -166,6 +172,8 @@ export interface CoreState {
     /** 将单元格滚入 Body 可视区；冻结区域内不滚动 */
     scrollCellIntoView: (row: number, col: number) => void;
     BASE_CELL_VPAD: number;
+    /** 空行高度 = 自动行高下限 = round(BASE_CELL_VPAD*2 + 默认字号行高)，随 DEFAULT_FONT_SIZE 变化 */
+    AUTO_ROW_BASE: number;
     fontMetricsCache: Map<string, {
         ascent: number;
         descent: number;
@@ -212,7 +220,7 @@ export interface CoreState {
     clearCellsInRange: (cS: number, cE: number, rS: number, rE: number) => void;
     startEdit: (initialValue?: string) => void;
     /** 提交编辑：数据验证发生在写入之前。
-     *  @returns Promise<boolean> —— true 表示已写入；false 表示被数据验证拦截（仍保持编辑态） */
+     *  @returns Promise<boolean>：true 表示已写入；false 表示被数据验证拦截（仍保持编辑态） */
     commitEdit: () => Promise<boolean>;
     cancelEdit: () => void;
     moveActive: (dC: number, dR: number) => void;

package/dist/types/components/spreader/composables/find-replace.d.ts

@@ -1,3 +1,8 @@
+/**
+ * 查找 / 替换 交互层（依赖 Vue）。
+ * 驱动查找栏 UI 的状态与操作：范围 / 大小写 / 整格匹配选项、命中遍历与跳转、
+ * 替换与全部替换，纯算法部分委托 core/find-replace-core。
+ */
 import { type Ref, type ComputedRef } from 'vue';
 import type { CoreState } from './core-state';
 import type { UndoStylesState } from './undo-styles';

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

@@ -1,3 +1,8 @@
+/**
+ * 交互层（渲染 + 事件，体量最大的组合式模块）。
+ * 负责 Canvas 绘制（单元格、边框、合并、筛选箭头、分组控件等）、鼠标 / 键盘 / 触摸事件、
+ * 公式栏、行高列宽面板、右键菜单、滚动条，以及查找 / 筛选等浮层入口的开关与锚定。
+ */
 import { type Ref, type ComputedRef } from 'vue';
 import type { CoreState } from './core-state';
 import type { UndoStylesState } from './undo-styles';

package/dist/types/components/spreader/composables/sheets-ops.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Sheet 运维层：多工作表、主题与应用外壳 refs。
+ * 提供工作表新建 / 复制 / 删除 / 切换、插入删除行列时的合并与引用平移、
+ * 行高列宽调整、v-model 数据 emit 与模型重导入回灌等能力。
+ */
 import { type Ref, type ComputedRef } from 'vue';
 import type { ThemeColors, SheetState, SheetModelData, SelectionRange } from '../core/types';
 import { type SortOrder } from '../core/sort-core';

package/dist/types/components/spreader/composables/undo-styles.d.ts

@@ -1,3 +1,8 @@
+/**
+ * 撤销 / 重做与格式相关状态层（依赖 Vue）。
+ * 维护 undo / redo 快照与格式刷，以及字体 / 字号 / 对齐 / 文字与填充色 / 数字格式
+ * 等工具栏 UI 状态，并执行对应样式的读取与写入。
+ */
 import { type ComputedRef, type Ref } from 'vue';
 import type { FontOption } from '../core/constants';
 import type { CoreState } from './core-state';

package/dist/types/components/spreader/core/border-color.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Border Color - 边框颜色的纯逻辑层（与 Vue / Canvas 完全解耦，可直接单测）。
+ *
+ * 设计要点：
+ *  - 颜色是「每条独立边」的属性（BorderSide.color），与线型（width / style）彼此解耦：
+ *      · 改颜色  → 只改 color，保留 width / style，且不创建原本不存在的边框；
+ *      · 改线型  → 只改 width，保留已有 color；边原本不存在时才用当前色板的颜色。
+ *  - 颜色统一以标准 HEX 字符串存储（'#RRGGBB'）；'' / undefined 表示「自动」，
+ *    渲染时回退到主题默认边框色（defaultBorderColor），从而不破坏既有无颜色数据的历史边框。
+ *  - 本模块只做「计划（plan）」，不触碰真实数据；读写由调用方（borders-merge）注入，
+ *    因此合并单元格的「锚点存储」等既有机制可以原样复用。
+ */
+import type { BorderSide, BorderStyle, SelectionRange } from './types';
+import type { BorderType } from './border-icon';
+import { type BorderLineStyle } from './border-style';
+/** 默认边框颜色：BorderSide.color 缺失（自动）时的回退色（light 主题） */
+export declare const DEFAULT_BORDER_COLOR = "#444";
+/** 暗色主题下的默认边框颜色：在深色背景上需要更亮才能看清 */
+export declare const DARK_BORDER_COLOR = "#aaaaaa";
+/**
+ * 按主题返回默认边框颜色：light 用 DEFAULT_BORDER_COLOR，dark 用 DARK_BORDER_COLOR。
+ * 让「自动」边框在暗色模式下依然清晰可见。
+ */
+export declare function defaultBorderColor(theme: 'light' | 'dark' | string | undefined): string;
+/** 四条边的键名 */
+export type BorderSideKey = 'top' | 'right' | 'bottom' | 'left';
+export declare const BORDER_SIDE_KEYS: BorderSideKey[];
+/** 一条「实际边」：某个 grid 坐标上的某条边（调用方负责把它映射到 merge 锚点） */
+export interface BorderTarget {
+    col: number;
+    row: number;
+    side: BorderSideKey;
+}
+/** 一次改色 / 改线型的写入指令 */
+export interface BorderWrite extends BorderTarget {
+    next: BorderSide;
+}
+/**
+ * 归一化颜色：'' / 非字符串 / 纯空白 → undefined（自动色）。
+ * 不做大小写改写，保留用户/调用方写入的原始形态。
+ */
+export declare function normalizeBorderColor(color: string | undefined | null): string | undefined;
+/** 颜色比较：大小写不敏感；'' 与 undefined 视为同一个「自动」值 */
+export declare function sameBorderColor(a: string | undefined, b: string | undefined): boolean;
+/** 解析实际绘制颜色（自动 → 主题默认色；theme 缺省按 light 处理） */
+export declare function resolveBorderColor(color: string | undefined, theme?: 'light' | 'dark' | string): string;
+/** 该边是否有实际线宽（用于判断「边框是否存在」） */
+export declare function hasBorderLine(side: BorderSide | undefined): boolean;
+/**
+ * 仅替换颜色，保留 width / style。
+ * color 为 ''（自动）时删除 color 字段，回到默认色渲染，不残留空串。
+ */
+export declare function withBorderColor(side: BorderSide, color: string): BorderSide;
+/**
+ * 仅替换线宽，保留已有 color / style。
+ * 边原本不存在、或原本没有颜色时，才使用 fallbackColor（当前色板颜色 / 默认色）。
+ * 用于「边框颜色选择器」：只改色不动线型，且只为原本没有颜色的边补上笔刷色。
+ */
+export declare function withBorderWidth(side: BorderSide | undefined, width: number, fallbackColor?: string): BorderSide;
+/**
+ * 仅替换线型（solid/dashed/dotted），保留已有 width / color。
+ * style 为 'solid'（默认线型）时删除 style 字段，使数据与旧版完全一致、不残留冗余属性，
+ * 也避免 solid 边框在 BorderPool 中产生与「无 style」不同的去重 key。
+ */
+export declare function withBorderStyle(side: BorderSide, style: BorderLineStyle): BorderSide;
+/**
+ * 强制设置线宽与颜色（用于「点击边框类型按钮」场景）：
+ * 无论该边是否已存在，都把 width 与 color 设为给定值，color 为自动时删除 color 字段。
+ * 与 withBorderWidth 的区别：withBorderWidth 在边已存在且有颜色时保留旧颜色；
+ * 这里按 Excel 行为，用当前笔刷色覆盖该边（点「上边框」即把上边设为当前色）。
+ * 仅线型样式（style 虚线等）保留，不强制改；当传入 lineStyle 时则统一应用该线型
+ * （solid 会清掉 style 字段，使「用实线笔刷重画旧虚线边」回到 solid）。
+ */
+export declare function forceBorderSide(side: BorderSide | undefined, width: number, color?: string, lineStyle?: BorderLineStyle): BorderSide;
+/**
+ * 枚举某个边框类型在某个选区上要作用的「实际边」。
+ *
+ * - 'none'      → 无（清除是整格操作，由调用方单独处理）
+ * - 'all'       → 选区内每个单元格的四条边（跳过合并区非锚点格）
+ * - 'outer' / 'thickOuter' → 选区真正的外轮廓四边
+ * - 单边类型    → 该方向上位于选区边界的每一条边
+ *
+ * 合并单元格不在此处展开：返回的仍是 grid 坐标，由调用方的 getSide / setSide
+ * 统一重定向到 merge 锚点，与既有「合并区域锚点存储」机制保持一致。
+ */
+export declare function forEachBorderTarget(bt: BorderType, range: SelectionRange, cb: (t: BorderTarget) => void): void;
+/**
+ * 计算「改颜色」的写入计划。
+ *
+ * 约束（对应需求）：
+ *  - 只命中已经存在的边框（width > 0），绝不因此创建出新的边框；
+ *  - 颜色无变化（含大小写差异）的边不产生写入；
+ *  - 每条实际边独立成条，相邻单元格的共享边各自记录自己那一份，
+ *    不做任何跨单元格同步 - 谁被选到才改谁，避免一侧改色把另一侧覆盖掉。
+ */
+export declare function planBorderColorChanges(bt: BorderType, range: SelectionRange, color: string, getSide: (col: number, row: number, side: BorderSideKey) => BorderSide | undefined): BorderWrite[];
+/**
+ * 计算「改线型」的逐边写入计划（'all' / 'none' 之外的类型）。
+ * 已存在的边保留自己的颜色，只更新 width；新建的边使用 fallbackColor。
+ */
+export declare function planBorderTypeWrites(bt: BorderType, range: SelectionRange, width: number, fallbackColor: string | undefined, getSide: (col: number, row: number, side: BorderSideKey) => BorderSide | undefined): BorderWrite[];
+/**
+ * 为 'all' 生成整格边框（四边一次性替换），逐边保留已有颜色。
+ * 供 applyBorderToCell 这类「整格覆盖」入口使用。
+ */
+export declare function buildAllSidesBorder(col: number, row: number, width: number, fallbackColor: string | undefined, getSide: (col: number, row: number, side: BorderSideKey) => BorderSide | undefined): BorderStyle;
+/**
+ * 为 'all' 生成整格边框（四边一次性替换），逐边强制设为给定线宽与颜色（覆盖原有颜色）。
+ * 用于「点击『所有框线』按钮」：统一用当前笔刷色覆盖四条边框。
+ * lineStyle 透传：统一应用当前笔刷线型（solid 清 style 字段）。
+ */
+export declare function forceAllSidesBorder(col: number, row: number, width: number, color: string | undefined, getSide: (col: number, row: number, side: BorderSideKey) => BorderSide | undefined, lineStyle?: BorderLineStyle): BorderStyle;
+/**
+ * 读取选区在「当前边框类型作用域」内的统一边框颜色：
+ *  - 所有被命中的边颜色一致 → 返回该色；
+ *  - 存在不同颜色，或命中的边为空 → 返回 undefined（自动 / 混合，UI 按未选中处理）。
+ *
+ * 只统计真实存在的边框，未被画线的边不参与，避免「部分单元格没边框」把结果拉成混合。
+ */
+export declare function resolveSelectionBorderColor(bt: BorderType, range: SelectionRange, getSide: (col: number, row: number, side: BorderSideKey) => BorderSide | undefined): string | undefined;
+/**
+ * 计算「改线型」的逐边写入计划。
+ *
+ * 约束（对应需求）：
+ *  - 只命中已经存在的边框（width > 0），绝不因此创建出新的边框；
+ *  - 线型无变化（含缺省 solid）的边不产生写入；
+ *  - 每条实际边独立成条，相邻单元格的共享边各自记录自己那一份，不做任何跨单元格同步；
+ *  - 仅改 style，width / color 原样保留，线型与颜色互不干扰。
+ */
+export declare function planBorderStyleChanges(bt: BorderType, range: SelectionRange, style: BorderLineStyle, getSide: (col: number, row: number, side: BorderSideKey) => BorderSide | undefined): BorderWrite[];
+/**
+ * 读取选区在「当前边框类型作用域」内的统一边框线型：
+ *  - 所有被命中的边线型一致 → 返回该线型；
+ *  - 存在不同线型，或命中的边为空 → 返回 undefined（混合 / 无线条，UI 按未选中处理）。
+ *
+ * 只统计真实存在的边框。旧数据（无 style 字段）统一按 'solid' 计，不会把结果拉成混合。
+ */
+export declare function resolveSelectionBorderLineStyle(bt: BorderType, range: SelectionRange, getSide: (col: number, row: number, side: BorderSideKey) => BorderSide | undefined): BorderLineStyle | undefined;

package/dist/types/components/spreader/core/border-icon.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Border Icon - 边框图标的单一数据源。
+ *
+ * toolbar 主按钮与 border-picker 下拉项渲染的是同一套「田字型」边框图标，
+ * 此前两处各维护一份 BORDER_SEGS / SOLID_SEGS / THICK_SEGS / segRole，
+ * 靠注释「与 border-picker.vue 保持一致」约束，实际极易改一处漏一处。
+ * 现统一收敛到此模块，两处都从这里取，杜绝不同步。
+ */
+export type BorderType = 'none' | 'bottom' | 'top' | 'left' | 'right' | 'all' | 'outer' | 'thickOuter';
+/** 田字型边框图标：4 个外边 + 1 条竖中线 + 1 条横中线（viewBox 0 0 30 30） */
+export interface BorderSeg {
+    name: string;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+export declare const BORDER_SEGS: BorderSeg[];
+/** 各边框类型对应的实线段；粗外框线对应粗实线段；未列出者为虚线 */
+export declare const SOLID_SEGS: Record<BorderType, string[]>;
+export declare const THICK_SEGS: Record<BorderType, string[]>;
+export declare function segRole(bt: BorderType, name: string): 'solid' | 'dashed' | 'thick';
+/**
+ * 右下角是否需要补点。
+ *
+ * 外边线段长 22（4 → 26），虚线用 dasharray "0 4" + round cap 画圆点，
+ * 22 / 4 = 5.5 不整除，于是最后一点落在 (24,26) / (26,24)，
+ * 角点 (26,26) 恰好是两条虚线的空白位，露出缺口。
+ * 仅当 right 与 bottom 同时为虚线时才可见（top / left / none 三种）。
+ */
+export declare function needsCornerDot(bt: BorderType): boolean;
+/** 补充圆点半径：与 stroke-width 1.5 的 round cap 圆点直径一致 */
+export declare const CORNER_DOT_R = 0.75;
+/** 补充圆点位置：右下角交点 */
+export declare const CORNER_DOT_CX = 26;
+export declare const CORNER_DOT_CY = 26;
+/** 下拉菜单选项顺序 */
+export declare const BORDER_OPTIONS: {
+    key: BorderType;
+    i18nKey: string;
+}[];
+/** 各边框类型对应的 i18n 文案 key（toolbar 主按钮标签用） */
+export declare const BORDER_LABEL_KEY: Record<BorderType, string>;

package/dist/types/components/spreader/core/border-pool.d.ts

@@ -1,5 +1,5 @@
 /**
- * BorderPool — 边框池，用于减少重复边框数据的存储体积。
+ * BorderPool - 边框池，用于减少重复边框数据的存储体积。
  *
  * 核心思路：
  *  - 每个 Sheet 维护一个 borders: BorderStyle[] 数组，borders[0] 始终为默认空边框 {}。

package/dist/types/components/spreader/core/border-resolve.d.ts

@@ -1,5 +1,5 @@
 /**
- * Border Resolve — 公共边统一解析。
+ * Border Resolve - 公共边统一解析。
  *
  * 核心函数 resolveSharedBorder 负责处理相邻两个 BorderSide 的冲突，
  * 产生唯一的最终视觉边框结果。
@@ -8,9 +8,18 @@
  * 1. 两侧都 undefined/空 → 不绘制
  * 2. 一侧存在、另一侧不存在 → 使用存在的一侧
  * 3. 两侧都存在：
- *    a. width 更大者优先
- *    b. width 相同时：first 侧优先（稳定 tie-break）
+ *    a. 仅一侧带 owner（由边框操作显式写入的「选区边界边」）→ 该侧优先
+ *       （修复：选区外框/上边框/左边框被相邻单元格旧 border 覆盖的问题；
+ *        该标记持久化在数据里，取消选区/重绘/重新加载后结果仍一致，无需同步相邻单元格）
+ *    b. 两侧都带 owner 或都不带 → width 更大者优先
+ *    c. width 相同时：first 侧优先（稳定 tie-break）
  * 4. merge 不无条件覆盖 cell（firstSource/secondSource 预留但当前不影响优先级）
+ *
+ * 说明：req 要求「选区内部公共边」与「选区外普通公共边」继续沿用既有冲突规则。
+ * owner 仅由边框操作写入选区边界边时设置，因此：
+ *  - 选区内部公共边（两侧都带 owner，或都无 owner）→ 走 3b/3c 既有规则；
+ *  - 选区外普通公共边（两侧都无 owner）→ 走 3b/3c 既有规则，行为不变；
+ *  - 仅当「本次操作写入的边界边」对面是「未带 owner 的相邻边」时，才优先本次操作边。
  */
 import type { BorderSide, BorderSource } from './types';
 /**

package/dist/types/components/spreader/core/border-style.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Border Line Style - 边框线型的纯逻辑层（与 Vue / Canvas 完全解耦，可直接单测）。
+ *
+ * 线型是「每条独立边」的属性（BorderSide.style），与颜色（color）、线宽（width）彼此解耦：
+ *  - 改颜色 → 只动 color，保留 width / style；
+ *  - 改线型 → 只动 style，保留 width / color；
+ *  - 改线宽 → 只动 width，保留 color / style。
+ *
+ * 取值：'solid' | 'dashed' | 'dotted'。
+ * 旧数据（BorderSide 无 style 字段）一律按 'solid' 处理，从而保持历史数据兼容。
+ */
+/** 边框线型 */
+export type BorderLineStyle = 'solid' | 'dashed' | 'dotted';
+/**
+ * 归一化线型：非 'dashed' / 'dotted' 一律回退为 'solid'。
+ * 用于读取 BorderSide.style 时兜底（旧数据缺省 → solid），并防御非法字符串。
+ */
+export declare function normalizeBorderLineStyle(s?: string | null): BorderLineStyle;
+/**
+ * 返回 canvas 的 dash 数组（基于线宽保证视觉一致），solid 返回 null（走 fillRect，不画虚线）。
+ *  - dashed：dash 长 + gap，dash/gap 随线宽缩放；
+ *  - dotted：0 长度 dash + round cap → 画出直径 = 线宽的圆点，gap 随线宽缩放。
+ */
+export declare function borderLineDash(style: BorderLineStyle, width: number): number[] | null;

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

@@ -2,7 +2,6 @@ import type { ThemeColors } from './types';
 export declare const HEADER_WIDTH = 52;
 export declare const HEADER_HEIGHT = 24;
 export declare const DEFAULT_COL_WIDTH = 100;
-export declare const DEFAULT_ROW_HEIGHT = 24;
 export declare const MIN_COL_WIDTH = 30;
 export declare const MIN_ROW_HEIGHT = 24;
 export declare const MAX_COL_WIDTH = 1000;
@@ -20,7 +19,7 @@ export declare const DEFAULT_NOTE_AUTHOR = "";
 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";
-export declare const DEFAULT_FONT_SIZE = 10;
+export declare const DEFAULT_FONT_SIZE = 16;
 export interface FontOption {
     label: string;
     value: string | number;

package/dist/types/components/spreader/core/model-dims.d.ts

@@ -0,0 +1,19 @@
+import type { SheetModelData } from './types';
+export interface LogicalDims {
+    colCount: number;
+    rowCount: number;
+}
+/**
+ * 从序列化数据推导工作表逻辑尺寸（0-based exclusive）。
+ *
+ * SheetModelData 不再持久化 colCount/rowCount，导入（含 v-model 外部数据重新加载）时
+ * 必须按内容推导网格大小，否则超出默认 26×200 的数据加载后会被裁剪为不可访问。
+ * 参与推导的信息：
+ * - cells 键（"col,row"）与 merges 范围：数据实际占据的最大行列；
+ * - colWidths / rowHeights 键：用户自定义过尺寸的行列（仅当达到最小宽/高阈值）；
+ * - 筛选、条件格式、数据验证范围以及行列分组：跨越数据区外缘的结构性区域。
+ *
+ * @param smd  序列化的工作表数据
+ * @param base 保底尺寸（通常传 props 配置的默认 dims），结果不小于 base
+ */
+export declare function deriveModelDims(smd: SheetModelData, base: LogicalDims): LogicalDims;

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

@@ -1,3 +1,7 @@
+/**
+ * 批注（Note）纯逻辑：CRUD、单元格与批注的绑定管理、范围内批注收集与孤儿清理。
+ * 无 Vue 依赖，供 core-state 与批注浮层（note-overlay）调用。
+ */
 import type { CellNote, CellData, SelectionRange } from './types';
 /** 生成唯一 Note ID */
 export declare function genNoteId(): string;

package/dist/types/components/spreader/core/sort-icon.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Sort Icon - 排序图标的单一数据源。
+ *
+ * toolbar 触发按钮与 sort-picker 下拉项渲染的是同一套排序图标
+ * （左侧三条渐宽横线 + 右侧方向箭头，viewBox 0 0 1024 1024），
+ * 此前两处各维护一份 SORT_BARS / SORT_ARROW_PATHS，靠注释「保持一致」约束。
+ * 现统一收敛到此模块，两处都从这里取，杜绝不同步。
+ */
+import type { SortOrder } from './sort-core';
+/** 左侧三条渐宽横线 */
+export interface SortBar {
+    name: string;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+export declare const SORT_BARS: SortBar[];
+/** 右侧方向箭头路径 */
+export declare const SORT_ARROW_PATHS: Record<SortOrder, string>;
+/** 下拉菜单选项顺序 */
+export declare const SORT_OPTIONS: {
+    key: SortOrder;
+    i18nKey: string;
+}[];

package/dist/types/components/spreader/core/style-pool.d.ts

@@ -1,5 +1,5 @@
 /**
- * StylePool — 样式池，用于减少重复样式数据的存储体积。
+ * StylePool - 样式池，用于减少重复样式数据的存储体积。
  *
  * 核心思路：
  *  - 每个 Sheet 维护一个 styles: CellStyle[] 数组，styles[0] 始终为默认空样式 {}。

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

@@ -1,3 +1,8 @@
+/**
+ * 主题 CSS 变量组装：把 light / dark 的 ThemeColors 平铺成 --sp-* 自定义属性，
+ * 由外层容器注入；Teleport 到 body 的浮层通过 documentElement 级变量继承主题
+ * （见 spreader.vue 的 applyGlobalThemeVars）。
+ */
 import { type ComputedRef } from 'vue';
 import type { ThemeColors } from './types';
 export declare function useTheme(theme: ComputedRef<'light' | 'dark'>): ComputedRef<ThemeColors>;

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

@@ -13,6 +13,14 @@ export interface BorderSide {
     width?: number;
     color?: string;
     style?: string;
+    /**
+     * 渲染优先级标记（可选）：该边由一次边框操作「显式写入」时置为 true。
+     * 作用：相邻公共边解析（resolveSharedBorder）中，若仅一侧带 owner，则该侧优先，
+     * 用于修复「选区外框/上边框/左边框被相邻单元格旧 border 覆盖」的问题。
+     * 属于持久化数据（随 BorderPool 一起序列化）；旧数据缺省视为 undefined（非 owner）。
+     * 不表示跨单元格同步；A.right 与 B.left 仍各自独立存储。
+     */
+    owner?: boolean;
 }
 /** 四边边框组合 */
 export interface BorderStyle {
@@ -300,10 +308,6 @@ export interface SheetModelData {
     merges?: Record<string, SelectionRange>;
     colWidths?: Record<number, number>;
     rowHeights?: Record<number, number>;
-    /** 工作表逻辑有效列数（0-based exclusive）。缺失时回退到默认 26 */
-    colCount?: number;
-    /** 工作表逻辑有效行数（0-based exclusive）。缺失时回退到默认 200 */
-    rowCount?: number;
     /** 冻结窗格状态；缺省视为未冻结 { rows: 0, cols: 0 } */
     freeze?: FreezePane;
     /** 数据筛选状态；缺省视为未启用筛选 */
@@ -433,6 +437,12 @@ export interface ThemeColors {
     toolbarBtnHoverBg: string;
     toolbarBtnDisabledColor: string;
     toolbarBtnActiveColor: string;
+    /** 次级文本（如对话框 label），light #666 / dark #aaa */
+    toolbarTextSecondary: string;
+    /** 弱化文本（如空状态提示），light #999 / dark #888 */
+    toolbarTextMuted: string;
+    /** 下拉/右键菜单选中项底色，light #e5f1fb / dark 半透明蓝（配 toolbarBtnActiveColor 文字色） */
+    toolbarItemActiveBg: string;
     findMatchBg: string;
     findActiveBg: string;
 }