xiaodao-spreader 0.1.27 → 0.1.29

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

@@ -42,6 +42,7 @@ export interface SheetsOpsState {
     toolbarThemeVars: ComputedRef<Record<string, string>>;
     wrapperRef: Ref<HTMLDivElement | null>;
     canvasRef: Ref<HTMLCanvasElement | null>;
+    freezeCanvasRef: Ref<HTMLCanvasElement | null>;
     editInputRef: Ref<HTMLTextAreaElement | null>;
     formulaBarRef: Ref<HTMLTextAreaElement | null>;
     viewSize: {

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

@@ -0,0 +1,125 @@
+import type { CellCoord, SelectionRange } from './types';
+export type FillValue = {
+    kind: 'number';
+    num: number;
+} | {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'text-number';
+    prefix: string;
+    num: number;
+    digits: number;
+} | {
+    kind: 'date';
+    serial: number;
+} | {
+    kind: 'formula';
+    formula: string;
+};
+export type FillPattern = {
+    kind: 'copy';
+    sourceValues: FillValue[];
+} | {
+    kind: 'linear';
+    step: number;
+    base: number;
+    sourceLen: number;
+} | {
+    kind: 'text-number';
+    prefix: string;
+    step: number;
+    base: number;
+    digits: number;
+    sourceLen: number;
+} | {
+    kind: 'date-linear';
+    step: number;
+    baseSerial: number;
+    sourceLen: number;
+} | {
+    kind: 'text-series';
+    step: number;
+    baseCharCode: number;
+    sourceLen: number;
+} | {
+    kind: 'formula';
+};
+export interface AutofillSheetLike {
+    cells: Record<string, {
+        value: string;
+        styleId?: number;
+    }>;
+    styles: ReadonlyArray<unknown>;
+}
+export interface FillResult {
+    cells: Record<string, {
+        value: string;
+        styleId?: number;
+    }>;
+    merges: Record<string, {
+        startCol: number;
+        startRow: number;
+        endCol: number;
+        endRow: number;
+    }>;
+}
+/**
+ * 将单元格原始值解析为 FillValue。
+ * 优先级：公式 → 日期 → 文本+数字 → 纯数字 → 纯文本。
+ */
+export declare function parseFillValue(value: string, locale: string): FillValue;
+/**
+ * 由源值序列推断填充模式。
+ * - 任一公式 → formula
+ * - 全为日期 → date-linear
+ * - 全为纯数字：单值 copy；多值等差 linear；非等差 copy
+ * - 全为文本+数字且 prefix 相同：单值 copy；多值等差 text-number；否则 copy
+ * - 全为单字符 ASCII 字母且 charCode 等差 → text-series
+ * - 其余 → copy
+ */
+export declare function inferFillPattern(sourceValues: FillValue[]): FillPattern;
+/**
+ * 生成目标区域第 index 个（0-based，相对目标起点、靠近源的一端）的填充值（正向：下/右）。
+ * 目标第 index 个的逻辑索引为 sourceLen + index。
+ */
+export declare function generateFillValue(pattern: FillPattern, index: number, sourceLen: number): FillValue;
+/**
+ * 将 FillValue 转为单元格数据（value + 透传源 styleId）。
+ * 日期存序列号字符串，渲染时由 numberFormat 格式化。
+ */
+export declare function fillValueToCellData(fv: FillValue, sourceStyleId?: number): {
+    value: string;
+    styleId?: number;
+};
+/**
+ * 根据源选区与拖拽目标格计算目标区域及方向。
+ * 落在源内返回 null。
+ */
+export declare function computeTargetRange(sourceRange: SelectionRange, draggedCell: CellCoord): {
+    targetRange: SelectionRange;
+    direction: 'up' | 'down' | 'left' | 'right';
+} | null;
+/**
+ * 平移公式引用以适配目标单元格（$ 绝对引用由 shiftFormulaRefs 处理）。
+ */
+export declare function translateFormulaForTarget(sourceFormula: string, sourceCell: CellCoord, targetCell: CellCoord, colCount: number, rowCount: number, colToLabelFn: (col: number) => string): string;
+/**
+ * 校验源/目标区域与已有合并的兼容性：
+ * - 源区域不能与任何 merge 部分相交（要么完全包含，要么不相交）；
+ * - 目标区域不能与任何已有 merge 相交（会破坏 merge）。
+ */
+export declare function validateMergeCompatibility(sourceRange: SelectionRange, targetRange: SelectionRange, merges: Record<string, SelectionRange>): boolean;
+/**
+ * 自动填充核心：根据源/目标区域与方向生成填充增量（纯函数，不 mutate sheet）。
+ * - down/right：正向延伸；up/left：反向延伸。
+ * - 公式按源位置循环并平移引用；其余按模式生成。
+ * - merges 暂返回空对象（merge 复制由后续任务决定）。
+ */
+export declare function applyAutoFillPlan(sourceRange: SelectionRange, targetRange: SelectionRange, sheet: {
+    cells: Record<string, {
+        value: string;
+        styleId?: number;
+    }>;
+    styles?: ReadonlyArray<unknown>;
+}, direction: 'up' | 'down' | 'left' | 'right', locale: string, colCount: number, rowCount: number, colToLabelFn: (col: number) => string): FillResult;

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

@@ -10,6 +10,8 @@ export declare const MAX_ROW_HEIGHT = 500;
 export declare const SB_SIZE = 11;
 export declare const ARROW_SIZE = 11;
 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 i18n: Record<string, Record<string, string>>;
 export declare function t(locale: string, key: string): string;

package/dist/types/components/spreader/core/number-format.d.ts

@@ -62,6 +62,7 @@ export interface NFOption {
 export declare function parseNumberFormat(format: string): NFParsed;
 /** 清空解析缓存（主要用于测试/资源释放） */
 export declare function clearNumberFormatCache(): void;
+export declare function serialToDate(serial: number): Date;
 /**
  * 将单元格原始字符串值按格式代码格式化为显示文本。
  * 绝不修改传入的 value。
@@ -134,6 +135,11 @@ export interface DateTimeParseResult {
     serial: number;
     format: string;
 }
+/**
+ * 日期 → Excel 1900 系统序列号（与 serialToDate 互逆）。
+ * 1900-01-01 ~ 02-28 区间减 1，对齐 Excel 的 1900 虚构闰年（1900-02-29 = 60）。
+ */
+export declare function dateToSerial(y: number, m: number, d: number): number;
 /**
  * 对常规单元格的输入做常见日期/时间/日期时间字符串自动识别（对齐 Excel 输入语义）：
  * - 日期：yyyy-m-d、yyyy/m/d、yyyy年m月d日、m-d / m/d（年份补当前年）

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

@@ -85,6 +85,11 @@ export interface SpreadsheetData {
         style?: CellStyle;
     };
 }
+/** 冻结窗格状态：rows/cols 为冻结的行数/列数（0 表示该方向未冻结） */
+export interface FreezePane {
+    rows: number;
+    cols: number;
+}
 export interface SheetModelData {
     name: string;
     /** 表格级样式池：styles[0] 始终为默认空样式 {} */
@@ -103,6 +108,8 @@ export interface SheetModelData {
     colCount?: number;
     /** 工作表逻辑有效行数（0-based exclusive）。缺失时回退到默认 200 */
     rowCount?: number;
+    /** 冻结窗格状态；缺省视为未冻结 { rows: 0, cols: 0 } */
+    freeze?: FreezePane;
 }
 export interface SheetState {
     id: string;
@@ -123,6 +130,18 @@ export interface SheetState {
     colCount: number;
     /** 工作表逻辑有效行数（0-based exclusive）。随操作动态增长 */
     rowCount: number;
+    /** 冻结窗格状态（默认 { rows: 0, cols: 0 } 表示未冻结） */
+    freeze: FreezePane;
+}
+/** 视口区域：冻结窗格将画布划分为四个独立滚动区域 */
+export interface ViewportRegion {
+    kind: 'corner' | 'rows' | 'columns' | 'body';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    scrollLeft: number;
+    scrollTop: number;
 }
 export interface UndoSnapshot {
     cells: Record<string, CellData>;