xiaodao-spreader 0.1.28 → 0.1.30

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

@@ -29,6 +29,10 @@ type __VLS_Props = {
     sortMenuOpen: boolean;
     cachedSortOrder: SortOrder;
     canSort: boolean;
+    /** 工具栏「筛选」按钮是否可用（单选合并单元格且无筛选态时禁用） */
+    canFilter: boolean;
+    /** 当前 worksheet 是否已启用筛选 */
+    filterActive: boolean;
     selHAlign: string;
     selVAlign: string;
     selWrap: boolean;
@@ -70,6 +74,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     "calc-count": () => void;
     "increase-decimals": () => void;
     "decrease-decimals": () => void;
+    "toggle-filter": () => void;
     "font-family-change": (v: string | number) => void;
     "font-size-change": (v: string | number) => void;
     "h-align-change": (v: string | number) => void;
@@ -115,6 +120,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     "onCalc-count"?: (() => any) | undefined;
     "onIncrease-decimals"?: (() => any) | undefined;
     "onDecrease-decimals"?: (() => any) | undefined;
+    "onToggle-filter"?: (() => any) | undefined;
     "onFont-family-change"?: ((v: string | number) => any) | undefined;
     "onFont-size-change"?: ((v: string | number) => any) | undefined;
     "onH-align-change"?: ((v: string | number) => any) | undefined;

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

@@ -1,6 +1,7 @@
 import { type ComputedRef, type Ref } from 'vue';
 import { FormulaDeps } from '../core/formula';
-import type { CellCoord, CellData, CellStyle, SelectionRange, BorderStyle, BorderSide, FreezePane, ViewportRegion } from '../core/types';
+import type { CellCoord, CellData, CellStyle, SelectionRange, BorderStyle, BorderSide, FreezePane, ViewportRegion, SheetFilter, FilterColumn } from '../core/types';
+import { type FilterCandidates } from '../core/filter-core';
 /** 选区触发方式，影响「合并单元格是否扩大选区」。
  *  - 'cell'：单元格点击/拖动（默认）→ 保持现有 expandSelectionForMerges 行为
  *  - 'row' ：行头点击/拖动 → Excel 风格「穿透」合并，选区矩形保持用户点击的行范围
@@ -8,6 +9,14 @@ import type { CellCoord, CellData, CellStyle, SelectionRange, BorderStyle, Borde
  *  - 'all' ：左上角全选按钮 → expandSelectionForMerges 行为
  */
 export type SelectionMode = 'cell' | 'row' | 'col' | 'all';
+/** AutoFill 拖拽状态 */
+export interface AutoFillState {
+    active: boolean;
+    sourceRange: SelectionRange | null;
+    targetRange: SelectionRange | null;
+    direction: 'up' | 'down' | 'left' | 'right' | null;
+    preview: boolean;
+}
 export interface CoreState {
     props: {
         rowCount: number;
@@ -49,6 +58,36 @@ export interface CoreState {
     setFreeze: (rows: number, cols: number) => void;
     clearFreeze: () => void;
     getFreeze: () => FreezePane;
+    filter: Ref<SheetFilter | null>;
+    getFilter: () => SheetFilter | null;
+    setFilter: (f: SheetFilter | null, silent?: boolean) => void;
+    enableFilter: (range: SelectionRange) => void;
+    clearFilter: () => void;
+    clearFilterColumn: (col: number) => void;
+    setFilterColumn: (col: number, colFilter: FilterColumn | null) => void;
+    /** 获取某列候选值列表（级联：仅统计其它列已筛选后的可见行） */
+    getColumnCandidates: (col: number) => FilterCandidates;
+    /** 探测数据实际占用范围（有值或样式的单元格包围盒）；无数据返回 null */
+    getDataRange: () => SelectionRange | null;
+    /** 探测以 anchor 为中心的「当前数据区域」（连续非空单元格块）；空 anchor 返回 null */
+    getCurrentRegion: (anchorC: number, anchorR: number) => SelectionRange | null;
+    /** 自动检测筛选范围：多选选区优先，否则以 active cell 当前区域推断；完全无数据返回 null */
+    detectFilterRange: () => SelectionRange | null;
+    /** 切换 AutoFilter：无则创建（自动检测范围），有则移除整个 AutoFilter */
+    toggleAutoFilter: () => void;
+    /** 某列是否落在当前 AutoFilter Range 内（决定表头箭头是否绘制） */
+    isColumnInFilterRange: (col: number) => boolean;
+    /** 当前 AutoFilter Range（无则 null） */
+    getFilterRange: () => SelectionRange | null;
+    /** 是否已启用 AutoFilter */
+    isFilterEnabled: () => boolean;
+    /** 某列是否已应用筛选条件（用于高亮箭头图标） */
+    isFilterColumnActive: (col: number) => boolean;
+    isRowHidden: (r: number) => boolean;
+    getFilteredOutRows: () => Set<number>;
+    getVisibleRowCount: () => number;
+    getVisibleRowAt: (index: number) => number;
+    getVisibleRowIndex: (row: number) => number;
     /** 基于真实行高/列宽计算冻结区域尺寸 */
     getFrozenMetrics: () => {
         frozenRowsHeight: number;
@@ -156,6 +195,10 @@ export interface CoreState {
     clampScroll?: (sx: number | null, sy: number | null) => void;
     /** 查找高亮钩子：返回某单元格当前的高亮类型（由 find-replace 模块注入） */
     findHighlight?: (col: number, row: number) => 'active' | 'match' | null;
+    /** AutoFill 拖拽状态：active 时 render 绘制预览，mouseup 触发 applyAutoFill */
+    autoFillState: Ref<AutoFillState>;
+    /** 一次性提交 AutoFill：saveUndo → ensureCapacity → applyAutoFillPlan → 写入 cells + formulaDeps → selectRange → scheduleRender */
+    applyAutoFill: (sourceRange: SelectionRange, targetRange: SelectionRange, direction: 'up' | 'down' | 'left' | 'right') => void;
 }
 export declare function createCoreState(rawProps: {
     rowCount?: number;

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

@@ -39,6 +39,14 @@ export interface InteractionsState {
     onRowHdrCtx: (e: MouseEvent, row: number) => void;
     onColHdrCtx: (e: MouseEvent, col: number) => void;
     onCellCtx: (e: MouseEvent, c: number, r: number) => void;
+    filterPopup: Ref<{
+        col: number;
+        x: number;
+        y: number;
+    } | null>;
+    isFilterButtonHit: (x: number, y: number) => number;
+    openFilterPopup: (col: number) => void;
+    closeFilterPopup: () => void;
     dimInputRef: Ref<HTMLInputElement | null>;
     dimPanel: Ref<{
         type: 'row' | 'col';

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

@@ -0,0 +1,29 @@
+import type { SheetFilter, FilterColumn } from './types';
+/** 空白哨兵：值列表中用此字符串表示「空白」项（原始空值无法作为 map key 区分） */
+export declare const FILTER_BLANK = "__filter_blank__";
+/** 单元格读取抽象：供引擎从任意数据源（core-state / 测试）取值与格式 */
+export interface FilterCellAccessor {
+    /** 返回单元格原始值（string）；公式结果请在此展开 */
+    getValue: (col: number, row: number) => string;
+    /** 返回单元格数字格式（用于展示与类型判定） */
+    getFormat: (col: number, row: number) => string | undefined | null;
+}
+/** 取单元格展示文本（与渲染一致）。空值回退原始串避免丢失信息。 */
+export declare function getDisplayValue(value: string, format: string | undefined | null, locale: string): string;
+/** 按单列筛选定义判定单元格是否满足（值列表 / 条件） */
+export declare function matchColumn(col: FilterColumn, value: string, format: string | undefined | null, locale: string): boolean;
+/** 某行是否满足整张筛选（多列 AND） */
+export declare function isRowVisible(filter: SheetFilter | null, row: number, acc: FilterCellAccessor, locale: string): boolean;
+export interface FilterCandidates {
+    /** 候选值（展示字符串，已去重、稳定排序） */
+    values: string[];
+    /** 该列是否存在空白单元格 */
+    hasBlank: boolean;
+}
+/**
+ * 获取某列的候选值列表（级联：仅统计「其它列已筛选」后可见的行）。
+ * 排序：若全部可解析为数字则按数值升序；否则按 locale 文本（numeric）升序。
+ */
+export declare function getColumnCandidates(filter: SheetFilter, col: number, acc: FilterCellAccessor, locale: string): FilterCandidates;
+/** 判断是否处于「该列已设置筛选」状态（用于图标高亮） */
+export declare function isColumnFiltered(col: FilterColumn | undefined): boolean;

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

@@ -90,6 +90,34 @@ export interface FreezePane {
     rows: number;
     cols: number;
 }
+/** 单列筛选类型 */
+export type FilterColumnType = 'values' | 'text' | 'number' | 'date';
+/** 条件筛选算子（文本 / 数字 / 日期通用，按 type 决定可用集合） */
+export type FilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'blank' | 'notBlank';
+/** 单列筛选条件（条件筛选模式） */
+export interface FilterCondition {
+    operator: FilterOperator;
+    /** 比较值（文本/数字原始文本；日期为输入文本） */
+    value?: string;
+    /** 介于（between）的第二个值 */
+    value2?: string;
+}
+/** 单列筛选定义 */
+export interface FilterColumn {
+    /** 筛选类型：值列表 / 文本条件 / 数字条件 / 日期条件 */
+    type: FilterColumnType;
+    /** 值列表模式下选中的值（可能包含 FILTER_BLANK 哨兵表示空白）；为空表示不过滤 */
+    values?: string[];
+    /** 条件模式下生效 */
+    condition?: FilterCondition;
+}
+/** 工作表筛选状态：独立存储，不写入 cell style / data */
+export interface SheetFilter {
+    /** 筛选区域（含表头行）。startRow 通常为表头行，数据行为 startRow+1..endRow */
+    range: SelectionRange;
+    /** 按列索引（0-based）存储的列筛选；缺失的列表示不过滤 */
+    columns: Record<number, FilterColumn>;
+}
 export interface SheetModelData {
     name: string;
     /** 表格级样式池：styles[0] 始终为默认空样式 {} */
@@ -110,6 +138,8 @@ export interface SheetModelData {
     rowCount?: number;
     /** 冻结窗格状态；缺省视为未冻结 { rows: 0, cols: 0 } */
     freeze?: FreezePane;
+    /** 数据筛选状态；缺省视为未启用筛选 */
+    filter?: SheetFilter;
 }
 export interface SheetState {
     id: string;
@@ -132,6 +162,8 @@ export interface SheetState {
     rowCount: number;
     /** 冻结窗格状态（默认 { rows: 0, cols: 0 } 表示未冻结） */
     freeze: FreezePane;
+    /** 数据筛选状态；缺省为 null 表示未启用筛选 */
+    filter: SheetFilter | null;
 }
 /** 视口区域：冻结窗格将画布划分为四个独立滚动区域 */
 export interface ViewportRegion {