xiaodao-spreader 0.1.32 → 0.1.34

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

@@ -19,5 +19,267 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {},
     rowCount: number;
     colCount: number;
     theme: "light" | "dark";
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, HTMLDivElement>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {
+    toolbarRef: import("vue").CreateComponentPublicInstanceWithMixins<Readonly<{
+        locale: string;
+        canUndo: boolean;
+        canRedo: boolean;
+        paintFmtActive: boolean;
+        hasSelection: boolean;
+        fontFamilyOptions: import("../core/constants").FontOption[];
+        fontSizeOptions: import("../core/constants").FontOption[];
+        selFontFamily: string | number;
+        selFontSize: number;
+        fontSizeInput: string;
+        fontSizeMenuOpen: boolean;
+        selFontWeight: boolean;
+        selFontStyle: boolean;
+        selUnderline: boolean;
+        selStrikethrough: boolean;
+        selTextColor: string;
+        textColorMenuOpen: boolean;
+        selFillColor: string;
+        fillColorMenuOpen: boolean;
+        cachedTextColor: string;
+        cachedFillColor: string;
+        borderMenuOpen: boolean;
+        cachedBorder: import("@/components/spreader/components/pickers/borderPicker.vue").BorderType;
+        sortMenuOpen: boolean;
+        cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
+        canSort: boolean;
+        canFilter: boolean;
+        filterActive: boolean;
+        selHAlign: string;
+        selVAlign: string;
+        selWrap: boolean;
+        hAlignOptions: import("../core/constants").FontOption[];
+        vAlignOptions: import("../core/constants").FontOption[];
+        mergeMenuOpen: boolean;
+        calcMenuOpen: boolean;
+        isSingleCell: boolean;
+        hasFreeze: boolean;
+        freezePanesDisabled: boolean;
+        themeVars?: Record<string, string> | undefined;
+        selNumberFormat: string;
+        nfOptions: import("../core/number-format").NFOption[];
+        canIncreaseDecimals: boolean;
+        canDecreaseDecimals: boolean;
+    }> & Readonly<{
+        onUndo?: (() => any) | undefined;
+        onRedo?: (() => any) | undefined;
+        onFind?: (() => any) | undefined;
+        "onPaint-format"?: (() => any) | undefined;
+        "onClear-format"?: (() => any) | undefined;
+        "onFont-size-blur"?: (() => any) | undefined;
+        "onFont-size-toggle"?: (() => any) | undefined;
+        "onFont-size-step-up"?: (() => any) | undefined;
+        "onFont-size-step-down"?: (() => any) | undefined;
+        "onBold-toggle"?: (() => any) | undefined;
+        "onItalic-toggle"?: (() => any) | undefined;
+        "onUnderline-toggle"?: (() => any) | undefined;
+        "onStrikethrough-toggle"?: (() => any) | undefined;
+        "onApply-text-color"?: (() => any) | undefined;
+        "onApply-fill-color"?: (() => any) | undefined;
+        "onApply-border"?: (() => any) | undefined;
+        "onApply-sort"?: (() => any) | undefined;
+        "onWrap-toggle"?: (() => any) | undefined;
+        "onApply-merge"?: (() => any) | undefined;
+        "onCalc-sum"?: (() => any) | undefined;
+        "onCalc-avg"?: (() => any) | undefined;
+        "onCalc-count"?: (() => any) | undefined;
+        "onIncrease-decimals"?: (() => any) | undefined;
+        "onDecrease-decimals"?: (() => any) | undefined;
+        "onToggle-filter"?: (() => any) | undefined;
+        "onCf-new-rule"?: (() => any) | undefined;
+        "onCf-manage"?: (() => 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;
+        "onV-align-change"?: ((v: string | number) => any) | undefined;
+        "onFont-size-input"?: ((v: string) => any) | undefined;
+        "onText-color-change"?: ((v: string) => any) | undefined;
+        "onFill-color-change"?: ((v: string) => any) | undefined;
+        "onNumber-format-change"?: ((v: string) => any) | undefined;
+        "onFreeze-change"?: ((v: string) => any) | undefined;
+        "onCf-preset"?: ((v: string) => any) | undefined;
+        "onFont-size-keydown"?: ((ev: KeyboardEvent) => any) | undefined;
+        "onUpdate:font-size-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:text-color-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:fill-color-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:border-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:sort-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:merge-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:calc-menu-open"?: ((v: boolean) => any) | undefined;
+        "onBorder-change"?: ((v: import("@/components/spreader/components/pickers/borderPicker.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;
+        "onCf-clear"?: ((scope: "sheet" | "selection") => any) | undefined;
+    }>, {
+        closeOverflow: () => void;
+    }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+        undo: () => void;
+        redo: () => void;
+        find: () => void;
+        "paint-format": () => void;
+        "clear-format": () => void;
+        "font-size-blur": () => void;
+        "font-size-toggle": () => void;
+        "font-size-step-up": () => void;
+        "font-size-step-down": () => void;
+        "bold-toggle": () => void;
+        "italic-toggle": () => void;
+        "underline-toggle": () => void;
+        "strikethrough-toggle": () => void;
+        "apply-text-color": () => void;
+        "apply-fill-color": () => void;
+        "apply-border": () => void;
+        "apply-sort": () => void;
+        "wrap-toggle": () => void;
+        "apply-merge": () => void;
+        "calc-sum": () => void;
+        "calc-avg": () => void;
+        "calc-count": () => void;
+        "increase-decimals": () => void;
+        "decrease-decimals": () => void;
+        "toggle-filter": () => void;
+        "cf-new-rule": () => void;
+        "cf-manage": () => void;
+        "font-family-change": (v: string | number) => void;
+        "font-size-change": (v: string | number) => void;
+        "h-align-change": (v: string | number) => void;
+        "v-align-change": (v: string | number) => void;
+        "font-size-input": (v: string) => void;
+        "text-color-change": (v: string) => void;
+        "fill-color-change": (v: string) => void;
+        "number-format-change": (v: string) => void;
+        "freeze-change": (v: string) => void;
+        "cf-preset": (v: string) => void;
+        "font-size-keydown": (ev: KeyboardEvent) => void;
+        "update:font-size-menu-open": (v: boolean) => void;
+        "update:text-color-menu-open": (v: boolean) => void;
+        "update:fill-color-menu-open": (v: boolean) => void;
+        "update:border-menu-open": (v: boolean) => void;
+        "update:sort-menu-open": (v: boolean) => void;
+        "update:merge-menu-open": (v: boolean) => void;
+        "update:calc-menu-open": (v: boolean) => void;
+        "border-change": (v: import("@/components/spreader/components/pickers/borderPicker.vue").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;
+    }, import("vue").PublicProps, {}, false, {}, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, {
+        rootEl: HTMLDivElement;
+        fontSizeArrowRef: HTMLButtonElement;
+        textColorArrowRef: HTMLButtonElement;
+        fillColorArrowRef: HTMLButtonElement;
+        borderArrowRef: HTMLButtonElement;
+        mergeArrowRef: HTMLButtonElement;
+        calcArrowRef: HTMLButtonElement;
+        sortArrowRef: HTMLButtonElement;
+        moreBtnEl: HTMLButtonElement;
+        overflowMenuEl: HTMLDivElement;
+    }, any, import("vue").ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<{
+        locale: string;
+        canUndo: boolean;
+        canRedo: boolean;
+        paintFmtActive: boolean;
+        hasSelection: boolean;
+        fontFamilyOptions: import("../core/constants").FontOption[];
+        fontSizeOptions: import("../core/constants").FontOption[];
+        selFontFamily: string | number;
+        selFontSize: number;
+        fontSizeInput: string;
+        fontSizeMenuOpen: boolean;
+        selFontWeight: boolean;
+        selFontStyle: boolean;
+        selUnderline: boolean;
+        selStrikethrough: boolean;
+        selTextColor: string;
+        textColorMenuOpen: boolean;
+        selFillColor: string;
+        fillColorMenuOpen: boolean;
+        cachedTextColor: string;
+        cachedFillColor: string;
+        borderMenuOpen: boolean;
+        cachedBorder: import("@/components/spreader/components/pickers/borderPicker.vue").BorderType;
+        sortMenuOpen: boolean;
+        cachedSortOrder: import("@/components/spreader/core/sort-core.ts").SortOrder;
+        canSort: boolean;
+        canFilter: boolean;
+        filterActive: boolean;
+        selHAlign: string;
+        selVAlign: string;
+        selWrap: boolean;
+        hAlignOptions: import("../core/constants").FontOption[];
+        vAlignOptions: import("../core/constants").FontOption[];
+        mergeMenuOpen: boolean;
+        calcMenuOpen: boolean;
+        isSingleCell: boolean;
+        hasFreeze: boolean;
+        freezePanesDisabled: boolean;
+        themeVars?: Record<string, string> | undefined;
+        selNumberFormat: string;
+        nfOptions: import("../core/number-format").NFOption[];
+        canIncreaseDecimals: boolean;
+        canDecreaseDecimals: boolean;
+    }> & Readonly<{
+        onUndo?: (() => any) | undefined;
+        onRedo?: (() => any) | undefined;
+        onFind?: (() => any) | undefined;
+        "onPaint-format"?: (() => any) | undefined;
+        "onClear-format"?: (() => any) | undefined;
+        "onFont-size-blur"?: (() => any) | undefined;
+        "onFont-size-toggle"?: (() => any) | undefined;
+        "onFont-size-step-up"?: (() => any) | undefined;
+        "onFont-size-step-down"?: (() => any) | undefined;
+        "onBold-toggle"?: (() => any) | undefined;
+        "onItalic-toggle"?: (() => any) | undefined;
+        "onUnderline-toggle"?: (() => any) | undefined;
+        "onStrikethrough-toggle"?: (() => any) | undefined;
+        "onApply-text-color"?: (() => any) | undefined;
+        "onApply-fill-color"?: (() => any) | undefined;
+        "onApply-border"?: (() => any) | undefined;
+        "onApply-sort"?: (() => any) | undefined;
+        "onWrap-toggle"?: (() => any) | undefined;
+        "onApply-merge"?: (() => any) | undefined;
+        "onCalc-sum"?: (() => any) | undefined;
+        "onCalc-avg"?: (() => any) | undefined;
+        "onCalc-count"?: (() => any) | undefined;
+        "onIncrease-decimals"?: (() => any) | undefined;
+        "onDecrease-decimals"?: (() => any) | undefined;
+        "onToggle-filter"?: (() => any) | undefined;
+        "onCf-new-rule"?: (() => any) | undefined;
+        "onCf-manage"?: (() => 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;
+        "onV-align-change"?: ((v: string | number) => any) | undefined;
+        "onFont-size-input"?: ((v: string) => any) | undefined;
+        "onText-color-change"?: ((v: string) => any) | undefined;
+        "onFill-color-change"?: ((v: string) => any) | undefined;
+        "onNumber-format-change"?: ((v: string) => any) | undefined;
+        "onFreeze-change"?: ((v: string) => any) | undefined;
+        "onCf-preset"?: ((v: string) => any) | undefined;
+        "onFont-size-keydown"?: ((ev: KeyboardEvent) => any) | undefined;
+        "onUpdate:font-size-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:text-color-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:fill-color-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:border-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:sort-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:merge-menu-open"?: ((v: boolean) => any) | undefined;
+        "onUpdate:calc-menu-open"?: ((v: boolean) => any) | undefined;
+        "onBorder-change"?: ((v: import("@/components/spreader/components/pickers/borderPicker.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;
+        "onCf-clear"?: ((scope: "sheet" | "selection") => any) | undefined;
+    }>, {
+        closeOverflow: () => void;
+    }, {}, {}, {}, {}> | null;
+}, HTMLDivElement>;
 export default _default;

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

@@ -2,6 +2,7 @@ import type { FontOption, MergeType } from '../core/constants';
 import { type NFOption } from '../core/number-format';
 import { type BorderType } from './pickers/borderPicker.vue';
 import type { SortOrder } from '../core/sort-core';
+declare function closeOverflow(): void;
 type __VLS_Props = {
     locale: string;
     canUndo: boolean;
@@ -43,13 +44,17 @@ type __VLS_Props = {
     isSingleCell: boolean;
     /** 当前 worksheet 是否已有冻结行或列 */
     hasFreeze: boolean;
+    /** 冻结窗格的冻结点是否位于 A1（无上方/左侧可冻结），此时禁用「冻结窗格」项 */
+    freezePanesDisabled: boolean;
     themeVars?: Record<string, string>;
     selNumberFormat: string;
     nfOptions: NFOption[];
     canIncreaseDecimals: boolean;
     canDecreaseDecimals: boolean;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    closeOverflow: typeof closeOverflow;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     undo: () => void;
     redo: () => void;
     find: () => void;
@@ -75,6 +80,8 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     "increase-decimals": () => void;
     "decrease-decimals": () => void;
     "toggle-filter": () => void;
+    "cf-new-rule": () => void;
+    "cf-manage": () => void;
     "font-family-change": (v: string | number) => void;
     "font-size-change": (v: string | number) => void;
     "h-align-change": (v: string | number) => void;
@@ -84,6 +91,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     "fill-color-change": (v: string) => void;
     "number-format-change": (v: string) => void;
     "freeze-change": (v: string) => void;
+    "cf-preset": (v: string) => void;
     "font-size-keydown": (ev: KeyboardEvent) => void;
     "update:font-size-menu-open": (v: boolean) => void;
     "update:text-color-menu-open": (v: boolean) => void;
@@ -95,6 +103,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     "border-change": (v: BorderType) => void;
     "sort-change": (v: SortOrder) => void;
     "merge-change": (v: MergeType) => void;
+    "cf-clear": (scope: "sheet" | "selection") => void;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onUndo?: (() => any) | undefined;
     onRedo?: (() => any) | undefined;
@@ -121,6 +130,8 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     "onIncrease-decimals"?: (() => any) | undefined;
     "onDecrease-decimals"?: (() => any) | undefined;
     "onToggle-filter"?: (() => any) | undefined;
+    "onCf-new-rule"?: (() => any) | undefined;
+    "onCf-manage"?: (() => 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;
@@ -130,6 +141,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     "onFill-color-change"?: ((v: string) => any) | undefined;
     "onNumber-format-change"?: ((v: string) => any) | undefined;
     "onFreeze-change"?: ((v: string) => any) | undefined;
+    "onCf-preset"?: ((v: string) => any) | undefined;
     "onFont-size-keydown"?: ((ev: KeyboardEvent) => any) | undefined;
     "onUpdate:font-size-menu-open"?: ((v: boolean) => any) | undefined;
     "onUpdate:text-color-menu-open"?: ((v: boolean) => any) | undefined;
@@ -141,6 +153,7 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     "onBorder-change"?: ((v: BorderType) => any) | undefined;
     "onSort-change"?: ((v: SortOrder) => any) | undefined;
     "onMerge-change"?: ((v: MergeType) => any) | undefined;
+    "onCf-clear"?: ((scope: "sheet" | "selection") => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {
     rootEl: HTMLDivElement;
     fontSizeArrowRef: HTMLButtonElement;

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

@@ -1,6 +1,6 @@
 import { type ComputedRef, type Ref } from 'vue';
 import { FormulaDeps } from '../core/formula';
-import type { CellCoord, CellData, CellStyle, SelectionRange, BorderStyle, BorderSide, FreezePane, ViewportRegion, SheetFilter, FilterColumn } from '../core/types';
+import type { CellCoord, CellData, CellStyle, SelectionRange, BorderStyle, BorderSide, FreezePane, ViewportRegion, SheetFilter, FilterColumn, ConditionalFormattingRule, ConditionalFormattingFormat } from '../core/types';
 import { type FilterCandidates } from '../core/filter-core';
 /** 选区触发方式，影响「合并单元格是否扩大选区」。
  *  - 'cell'：单元格点击/拖动（默认）→ 保持现有 expandSelectionForMerges 行为
@@ -192,6 +192,14 @@ export interface CoreState {
         w: number;
         h: number;
     };
+    conditionalFormats: ConditionalFormattingRule[];
+    resolveConditionalFormat: (col: number, row: number) => ConditionalFormattingFormat | null;
+    addConditionalFormatRule: (rule: ConditionalFormattingRule) => void;
+    updateConditionalFormatRule: (id: string, patch: Partial<ConditionalFormattingRule>) => void;
+    removeConditionalFormatRule: (id: string) => void;
+    moveConditionalFormatRule: (id: string, dir: 'up' | 'down') => void;
+    clearConditionalFormats: (scope: 'selection' | 'sheet') => void;
+    invalidateConditionalFormatCache: () => void;
     clampScroll?: (sx: number | null, sy: number | null) => void;
     /** 查找高亮钩子：返回某单元格当前的高亮类型（由 find-replace 模块注入） */
     findHighlight?: (col: number, row: number) => 'active' | 'match' | null;

package/dist/types/components/spreader/core/conditional-formatting.d.ts

@@ -0,0 +1,61 @@
+import type { ConditionalFormattingRule, ConditionalFormattingCondition, ConditionalFormattingFormat, SelectionRange, CellData } from './types';
+/** 条件格式求值上下文（由 core-state 注入，引擎本身保持纯净） */
+export interface CFContext {
+    /** 原始单元格数据（供公式引擎引用） */
+    cells: Record<string, CellData>;
+    colCount: number;
+    rowCount: number;
+    locale?: string;
+    /** 取单元格计算后的显示值（公式已求值）；用于数值/文本/重复值比较 */
+    getCellValue: (col: number, row: number) => string;
+}
+/** 规则范围左上角（所有 ranges 的最小 startCol/startRow） */
+export declare function ruleAnchor(rule: ConditionalFormattingRule): {
+    col: number;
+    row: number;
+};
+/** 单元格是否落在任一应用范围之内（含边界） */
+export declare function cellInRanges(ranges: SelectionRange[], col: number, row: number): boolean;
+/** 计算规则 Range 内各单元格显示值的出现次数（空白不计入重复统计，与 Excel 一致） */
+export declare function computeRuleValueStats(rule: ConditionalFormattingRule, ctx: CFContext): Map<string, number>;
+interface RuleStatsCache {
+    get(ruleId: string): Map<string, number> | undefined;
+    set(ruleId: string, stats: Map<string, number>): void;
+    invalidate(ruleId?: string): void;
+}
+/** 轻量统计缓存：cell / 规则变化时失效，避免每个 repaint 重算重复值统计 */
+export declare class CfValueCache implements RuleStatsCache {
+    private map;
+    get(ruleId: string): Map<string, number> | undefined;
+    set(ruleId: string, stats: Map<string, number>): void;
+    invalidate(ruleId?: string): void;
+}
+/** 单条件评估：返回 true 表示该单元格命中该规则 */
+export declare function evaluateCondition(cond: ConditionalFormattingCondition, col: number, row: number, ctx: CFContext, anchor: {
+    col: number;
+    row: number;
+}, stats?: Map<string, number>): boolean;
+/**
+ * 按优先级合并命中规则，返回最终合成格式；无命中返回 null。
+ * priority 越小优先级越高；命中 stopIfTrue 后停止后续规则。
+ */
+export declare function resolveConditionalFormatting(col: number, row: number, rules: ConditionalFormattingRule[], ctx: CFContext, cache?: RuleStatsCache): ConditionalFormattingFormat | null;
+/** 将条件格式合成到基础样式上，返回用于渲染的样式片段（仅包含会被覆盖的属性） */
+export declare function applyCfFormat(base: {
+    backgroundColor?: string;
+    color?: string;
+    fontWeight?: string;
+    fontStyle?: string;
+    underline?: string;
+    strikethrough?: string;
+}, cf: ConditionalFormattingFormat | null): {
+    backgroundColor?: string;
+    color?: string;
+    fontWeight?: string;
+    fontStyle?: string;
+    underline?: string;
+    strikethrough?: string;
+};
+/** 生成稳定唯一 ID（供新建规则使用，禁止依赖数组 index） */
+export declare function genRuleId(): string;
+export {};

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

@@ -22,6 +22,8 @@ export interface FontOption {
     value: string | number;
     /** 触发器/菜单项图标，提供时以图标取代文本标签展示在触发器上 */
     icon?: string;
+    /** 是否为禁用项（菜单项置灰且不可点击） */
+    disabled?: boolean;
 }
 export declare const FONT_FAMILIES: FontOption[];
 export declare const FONT_SIZES: FontOption[];

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

@@ -40,6 +40,15 @@ export declare function evalFormula(key: string, cells: Record<string, CellData>
 export declare function parseFormulaRefs(formula: string, colCount: number, rowCount: number): string[];
 /** 计算单元格显示值（公式则求值，否则返回原值） */
 export declare function computeCellValue(col: number, row: number, cells: Record<string, CellData>, colCount: number, rowCount: number): string;
+/** 独立求值一段公式表达式（不含前导 '='），返回 FormulaValue。
+ *  与 evalFormula 不同，本函数不绑定具体单元格身份，适合条件格式等「以任意基准单元格求值」的场景。 */
+export declare function evalFormulaText(formula: string, cells: Record<string, CellData>, colCount: number, rowCount: number): FormulaValue;
+/** 求一段「条件表达式」的布尔值（条件格式等场景）：
+ *  - 剥离可能的前导 '='（Excel 习惯输入 "=A1>100"）
+ *  - 含顶层比较运算符（< <= > >= = <>）按比较结果返回
+ *  - 否则按标量真值（数字非 0、非空字符串为真）
+ *  与 evalExpr 不同，本函数能正确处理 "A1>100" 这类比较表达式。 */
+export declare function evalFormulaCondition(formula: string, cells: Record<string, CellData>, colCount: number, rowCount: number): boolean;
 /** 将公式中所有单元格引用偏移 dCol, dRow（支持 $ 绝对引用） */
 export declare function shiftFormulaRefs(formula: string, dCol: number, dRow: number, colCount: number, rowCount: number, colToLabelFn: (col: number) => string): string;
 /**

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

@@ -118,6 +118,78 @@ export interface SheetFilter {
     /** 按列索引（0-based）存储的列筛选；缺失的列表示不过滤 */
     columns: Record<number, FilterColumn>;
 }
+/** 条件类型：第一阶段完整实现前 8 种；后几种为第二阶段预留（数据模型保留，暂不完整实现 UI/Renderer） */
+export type CFConditionType = 'cellIs' | 'textContains' | 'textNotContains' | 'blank' | 'notBlank' | 'duplicate' | 'unique' | 'formula' | 'colorScale' | 'dataBar' | 'iconSet' | 'topBottom' | 'aboveBelowAverage';
+/** 单元格值比较算子 */
+export type CellIsOperator = 'equal' | 'notEqual' | 'greaterThan' | 'greaterThanOrEqual' | 'lessThan' | 'lessThanOrEqual' | 'between' | 'notBetween';
+export interface CFCellIsCondition {
+    type: 'cellIs';
+    operator: CellIsOperator;
+    /** 比较值（文本/数字原始文本）。between / notBetween 需要 value2 */
+    value: string;
+    /** between / notBetween 的第二个值 */
+    value2?: string;
+}
+export interface CFTextCondition {
+    type: 'textContains' | 'textNotContains';
+    value: string;
+}
+export interface CFBlankCondition {
+    type: 'blank' | 'notBlank';
+}
+export interface CFDuplicateCondition {
+    type: 'duplicate' | 'unique';
+}
+export interface CFFormulaCondition {
+    type: 'formula';
+    /** 公式（不含前导 '='）；相对/绝对引用以规则范围左上角为基准 */
+    formula: string;
+}
+/** 第二阶段可视类型占位（暂不完整实现 UI/Renderer，仅保留数据模型） */
+export interface CFColorScaleCondition {
+    type: 'colorScale';
+}
+export interface CFDataBarCondition {
+    type: 'dataBar';
+}
+export interface CFIconSetCondition {
+    type: 'iconSet';
+}
+export interface CFTopBottomCondition {
+    type: 'topBottom';
+    top: boolean;
+    percent: boolean;
+    n: number;
+}
+export interface CFAboveBelowAverageCondition {
+    type: 'aboveBelowAverage';
+    above: boolean;
+}
+export type ConditionalFormattingCondition = CFCellIsCondition | CFTextCondition | CFBlankCondition | CFDuplicateCondition | CFFormulaCondition | CFColorScaleCondition | CFDataBarCondition | CFIconSetCondition | CFTopBottomCondition | CFAboveBelowAverageCondition;
+/** 条件格式要设置的格式（仅格式属性，不持久化选中状态）。渲染时与基础样式临时合成，不写回 cell.style */
+export interface ConditionalFormattingFormat {
+    backgroundColor?: string;
+    color?: string;
+    fontWeight?: 'bold' | '';
+    fontStyle?: 'italic' | '';
+    underline?: 'underline' | '';
+    strikethrough?: 'line-through' | '';
+}
+/** 单条条件格式规则：属于 Sheet，而非 Cell */
+export interface ConditionalFormattingRule {
+    /** 稳定唯一 ID（禁止数组 index） */
+    id: string;
+    condition: ConditionalFormattingCondition;
+    format: ConditionalFormattingFormat;
+    /** 应用范围（支持多区域） */
+    ranges: SelectionRange[];
+    /** 优先级：越小越高（Excel 风格） */
+    priority: number;
+    /** 命中后停止后续规则 */
+    stopIfTrue: boolean;
+    /** 是否启用 */
+    enabled: boolean;
+}
 export interface SheetModelData {
     name: string;
     /** 表格级样式池：styles[0] 始终为默认空样式 {} */
@@ -140,6 +212,8 @@ export interface SheetModelData {
     freeze?: FreezePane;
     /** 数据筛选状态；缺省视为未启用筛选 */
     filter?: SheetFilter;
+    /** 条件格式规则集合；缺省视为无规则 */
+    conditionalFormats?: ConditionalFormattingRule[];
 }
 export interface SheetState {
     id: string;
@@ -164,6 +238,8 @@ export interface SheetState {
     freeze: FreezePane;
     /** 数据筛选状态；缺省为 null 表示未启用筛选 */
     filter: SheetFilter | null;
+    /** 条件格式规则集合；缺省为空数组 */
+    conditionalFormats: ConditionalFormattingRule[];
 }
 /** 视口区域：冻结窗格将画布划分为四个独立滚动区域 */
 export interface ViewportRegion {