xiaodao-spreader 0.1.37 → 0.1.41

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 {
@@ -59,6 +67,26 @@ export interface CellStyle {
 export interface CellData {
     value: string;
     styleId?: number;
+    /** 批注引用：指向 Sheet 级 notes 池中的一个 CellNote；与 value/style 完全独立 */
+    noteId?: string;
+}
+/**
+ * 批注是绑定到 Cell 的独立附加元数据，不属于 cell.value / formula / style。
+ * 采用「Note Pool」存储：Sheet 级 notes 池按 id 存放，cell 只保存 noteId 引用，
+ * 便于扩展 Threaded Comment，且多个操作（排序/插入删除）移动 cell 时 noteId 随数据移动。
+ * 第一阶段实现与多人协作 Threaded Comment 无关。
+ */
+export interface CellNote {
+    /** 稳定唯一 ID（不可用数组 index） */
+    id: string;
+    /** 批注正文（多行文本，含换行） */
+    text: string;
+    /** 作者信息（可选） */
+    author?: string;
+    /** 创建时间（epoch ms） */
+    createdAt: number;
+    /** 最近修改时间（epoch ms） */
+    updatedAt: number;
 }
 /** 搜索范围：当前工作表 / 整个工作簿 / 当前选区 */
 export type FindScope = 'sheet' | 'workbook' | 'selection';
@@ -280,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;
     /** 数据筛选状态；缺省视为未启用筛选 */
@@ -296,6 +320,8 @@ export interface SheetModelData {
     rowOutlines?: DimensionOutline[];
     /** 列分组集合；旧数据缺省视为无分组 */
     columnOutlines?: DimensionOutline[];
+    /** 单元格批注池：按 noteId 存放，cell.noteId 引用之；与 cell value/style 完全独立 */
+    notes?: Record<string, CellNote>;
 }
 export interface SheetState {
     id: string;
@@ -328,6 +354,8 @@ export interface SheetState {
     rowOutlines: DimensionOutline[];
     /** 列分组集合；缺省为空数组 */
     columnOutlines: DimensionOutline[];
+    /** 单元格批注池：按 noteId 存放，cell.noteId 引用之 */
+    notes: Record<string, CellNote>;
 }
 /** 视口区域：冻结窗格将画布划分为四个独立滚动区域 */
 export interface ViewportRegion {
@@ -409,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;
 }