@a3s-lab/office 0.42.0 → 0.43.0

package/README.md

@@ -309,6 +309,21 @@ and [CLI reference](./docs/latest/en/cli-reference.md).
 
 ## Current release
 
+Version `0.43.0` makes Spreadsheet formula conditional formatting a local,
+editable workflow instead of a file-only preservation path:
+
+- **Home → Conditional Formatting → Custom formula** authors rules with
+  relative/absolute references, finite cross-sheet references, independent
+  text/fill colors, ordered precedence, and Stop-if-true behavior. Imported
+  XLSX expression rules reopen in the same editor.
+- The shared synchronous evaluator reads only cached workbook values, caps
+  formulas at 255 Unicode characters and each decision at 1,024 cells, scans
+  bounded blank ranges without densifying the workbook, and fails closed for
+  external, whole-row/column, missing-sheet, or uncached-formula references.
+- Native XLSX differential styles, `sqref`, priorities, and formulas round-trip
+  through export/reopen. The public **新建 → 公式条件格式** template shows a
+  blocking rule and a cross-sheet threshold without any remote service.
+
 Version `0.42.0` extends Spreadsheet data validation with a local custom-formula
 workflow that remains bounded, inspectable, and native-file compatible:
 

package/dist/0~spreadsheet-editor.js

@@ -3,14 +3,14 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Workbook } from "@fortune-sheet/react";
 import { AArrowDown, AArrowUp, AlignCenter, AlignLeft, AlignRight, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, AlignVerticalJustifyStart, ArrowDown, ArrowDownToLine, ArrowLeft, ArrowLeftToLine, ArrowRight, ArrowRightToLine, ArrowUp, ArrowUpToLine, BadgeJapaneseYen, BarChart3, BetweenHorizontalEnd, BetweenHorizontalStart, BetweenVerticalEnd, BetweenVerticalStart, Bold, Bookmark, Calculator, CalendarClock, CalendarDays, Check, ChevronDown, ChevronLeft, ChevronRight, ClipboardPaste, Clock, Cloud, Columns3, Copy, CopyPlus, DecimalsArrowLeft, DecimalsArrowRight, Eraser, Eye, EyeOff, FileX2, Globe2, Grid2X2, Grid3X3, Hash, Info, Italic, KeyRound, Layers2, Link2, Link2Off, ListChecks, ListFilter, ListOrdered, ListPlus, LocateFixed, Merge, MessageSquareX, MoveHorizontal, MoveVertical, Paintbrush, Palette, PanelLeft, PanelTop, PanelsTopLeft, Pencil, Percent, Plus, Printer, Redo2, RefreshCw, Rows3, Save, Scissors, Search, Settings2, ShieldCheck, Sigma, SlidersHorizontal, SortAsc, SortDesc, Strikethrough, SwatchBook, Table2, TableProperties, Trash2, TriangleAlert, Underline, Undo2, WrapText, X } from "lucide-react";
 import { Fragment as external_react_Fragment, cloneElement, createElement, memo, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
-import { convertSpanToShareString, genarate, indexToColumnChar, update as core_update } from "@fortune-sheet/core";
 import { Parser, SUPPORTED_FORMULAS } from "@fortune-sheet/formula-parser";
+import { convertSpanToShareString, genarate, indexToColumnChar, update as core_update } from "@fortune-sheet/core";
+import { useOfficeTaskPaneEscape, OfficeCheckbox, useOfficeDialog, CommittedOfficeNumberField, useOfficeTaskPaneModal, createOfficeKernelClient, officeFontFamilies, CollectionState, OfficeNumberField, handleOfficeTaskPaneKeyDown, normalizeFormulaForFortuneParser } from "./0~7048.js";
 import { freezeImportedSpreadsheetCell, normalizeXlsxSemanticColorOrigin, spreadsheetMatrixProfile, withXlsxPatternFill, withoutEditableRange, normalizeSpreadsheetConditionalVisualOptions, xlsxSemanticColorMatchesValue, withXlsxGradientFill, effectiveSpreadsheetPageSetup, attachSpreadsheetShownCommentCells, normalizeXlsxPatternFill, withEditableRange, sameSpreadsheetHistoryValue, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconForValue, defaultSpreadsheetConditionalIconThresholds, xlsxPatternFillTypes, sheetProtectionAuthority, normalizeXlsxGradientFill, xlsxGradientFillFallbackColor, editableRangeCellCount, unlockedCellCount, registerDerivedSpreadsheetMatrix, editableRangeRequiresCredentials, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, spreadsheetConditionalThresholdValue, normalizeSheetProtectionAuthority, withSheetProtection, spreadsheetProtectionKey, defaultSpreadsheetColorScaleThresholds, protectedSheetCount, SPREADSHEET_CONDITIONAL_ICON_SETS, withSheetSelectionPermissions, spreadsheetConditionalComparisonNeedsUpperValue, drawSpreadsheetConditionalIcon, isSpreadsheetConditionalIconSetName, spreadsheetConditionalThresholdsEqual, spreadsheetConditionalIconSetCount, spreadsheetConditionalIconAppearance } from "./9333.js";
 import { workSpreadsheetChartSupportsGrouping, spreadsheetFormulaRangesForSelection, createSpreadsheetChartFromSelection, normalizeWorkSpreadsheetDataLabelPosition, normalizeSpreadsheetPrintTitleColumns, normalizeSpreadsheetPrintTitleRows, formulaHasStructuredReference, normalizeWorkSpreadsheetErrorBars, defaultPivotValueCaption, workSpreadsheetChartSupportsBarSpacing, normalizeWorkSpreadsheetChartGrouping, spreadsheetGridSize, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetScatterStyle, cloneSparseMatrix, spreadsheetPivotAggregationLabel, workSpreadsheetChartAxisIsCategoryAxis, reconcileSpreadsheetChartPreviews, normalizeWorkSpreadsheetChartAxes, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetChartLegendPosition, spreadsheetChartCount, workSpreadsheetChartTypeLabel, sparseArrayEntries, normalizeWorkSpreadsheetTrendline, effectiveSpreadsheetCalculationSettings, spreadsheetPivotIntersects, normalizeWorkSpreadsheetDataLabels, spreadsheetPivotOutputContains, normalizeSpreadsheetPrintArea, spreadsheetCellAddress, formatSpreadsheetCellRanges, normalizeWorkSpreadsheetChartLayout, spreadsheetFormulaRangeForCell, workSpreadsheetChartAxisIsValueAxis, normalizeWorkSpreadsheetChartSmoothLines, spreadsheetPivotFilterValueKey, normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetChartSeriesStyle, volatileSpreadsheetFormulaFunctions, sparseArrayIndexes, normalizeWorkSpreadsheetBubbleSizeRepresents, workSpreadsheetChartSupportsTrendlines, normalizeWorkSpreadsheetChartLegendOverlay, parseSpreadsheetChartReference, workSpreadsheetChartGroupingIsStacked, normalizeWorkSpreadsheetChartGapWidth, workSpreadsheetChartSupportsSmoothLines, refreshSpreadsheetPivotTables, createSpreadsheetPivotFromSelection, reconcileSpreadsheetPivots, spreadsheetPivotCount, sparseMatrixColumnCount, workSpreadsheetChartSupportsErrorBars, formulaHasExternalReference, isValidSpreadsheetDefinedName, spreadsheetPivotValidation, deleteSpreadsheetPivotTable, workSpreadsheetChartAxisDefaultLabelPosition, workSpreadsheetChartSupportsSeriesAnalysis, parseSpreadsheetCellRanges, spreadsheetPivotFilterItems, spreadsheetPivotFields, normalizeWorkSpreadsheetChartOverlap, spreadsheetFormulaRangeConflict, spreadsheetSheetsWithChartPreviews, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetChartAxisShowsMajorGridlinesByDefault, workSpreadsheetChartSupportsAxes, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetRadarStyle } from "./8715.js";
 import { workSpreadsheetFilterHiddenRows, xlsxRichTextCellText, spreadsheetTextOrientationFromAngle, spreadsheetCellValueWithDiagonalBorder, spreadsheetUnderlineCellValue, workSpreadsheetAutoFilterCriteriaEntries, spreadsheetTableTotalsFunctionLabel, withDefaultSpreadsheetTableTotalsLabel, normalizeXlsxRichTextEditSource, spreadsheetTableTotalsColumnPatch, SPREADSHEET_TABLE_TOTALS_FUNCTIONS, normalizeXlsxRichTextCell, activeXlsxNativeFill, normalizeSpreadsheetDateValidationBoundary, spreadsheetTextOrientationChoiceFromCell, parseSpreadsheetSortCustomList, workSpreadsheetFilterTextCharacters, sameXlsxRichTextRunStyle, spreadsheetSortCustomListMatchKey, createSpreadsheetSortCustomList, reconcileSpreadsheetTableTotalsColumns, spreadsheetTextOrientationFromCell, patchSpreadsheetRichTextFontRuns, synchronizeSpreadsheetTableTotalsRow, workSpreadsheetAutoFilterManuallyHiddenRows, normalizedWorkSpreadsheetAutoFilterRange, workSpreadsheetSheetWithoutAutoFilterCriteria, isSpreadsheetTextOrientationId, reconcileSpreadsheetTableCalculatedColumns, spreadsheetVisibleTextRotationFromCell, spreadsheetTextOrientationFromChoice, normalizeWorkSpreadsheetFilterCriteria, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, normalizeSpreadsheetDataValidationErrorStyle, workSpreadsheetAutoFilterCriteria, normalizeXlsxRichTextColor, isHighSurrogate, xlsxNativeFillCellKeys, workSpreadsheetSheetWithReappliedAutoFilterCriteria, workSpreadsheetSheetWithAutoFilterCriteria, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, boundedSpreadsheetDataValidationText, spreadsheetUnderlineStyle, workSpreadsheetCellIsDate, workSpreadsheetAutoFilterOwnedRows, deleteXlsxNativeFills, spreadsheetTextOrientationCellStyle, normalizeXlsxRichTextRun, spreadsheetDiagonalBorderFromCellValue, isLowSurrogate, mergeSpreadsheetSortCustomLists, spreadsheetTableTotalsRowHasContent, validateSpreadsheetSortCustomList, normalizeStoredSpreadsheetSortCustomLists, coalesceXlsxRichTextRuns, fillSpreadsheetTableCalculatedColumns, replaceOfficeSpreadsheetCollaboration as replaceWorkOfficeSpreadsheetCollaboration, validXlsxRichText, spreadsheetSortCustomListsEqual, isSpreadsheetUnderlineStyle } from "./5416.js";
 import { moveOfficeMenuFocus, stepOfficeZoom, useOfficeRemoteParticipants, Popover, Dialog, officePresenceColor, useOfficePublishPresenceLocation, button_Button, icon_button_IconButton, moveOfficeGridMenuFocus, office_text_field_OfficeTextField, useDialogFocusScope, useOfficeEditorWheelZoom } from "./0~8136.js";
 import { isOfficeKernelSpreadsheetError, normalizeCssColor, OFFICE_KERNEL_SPREADSHEET_MAX_ROWS, createOfficeId as createWorkId } from "./4121.js";
-import { useOfficeTaskPaneEscape, OfficeCheckbox, CommittedOfficeNumberField, useOfficeDialog, useOfficeTaskPaneModal, createOfficeKernelClient, officeFontFamilies, CollectionState, OfficeNumberField, handleOfficeTaskPaneKeyDown, normalizeFormulaForFortuneParser } from "./0~7048.js";
 import { isOfficeShortcutBlocked, OfficeColorPicker } from "./0~3635.js";
 import { createOfficeEditorExtension, useOfficeEditorRuntime, useOfficeEditorKeyboardShortcuts } from "./0~3557.js";
 import { showToast } from "./6489.js";
@@ -159,30 +159,187 @@ function displayLength(valueRatio, minLength, maxLength) {
     const normalized = Math.max(0, Math.min(1, valueRatio));
     return minLength + (maxLength - minLength) * normalized;
 }
-function spreadsheetConditionalFormatStyles(sheet) {
+const MAX_SPREADSHEET_LOCAL_FORMULA_LENGTH = 255;
+const work_spreadsheet_local_formula_MAX_SPREADSHEET_LOCAL_FORMULA_REFERENCED_CELLS = 1024;
+const MAX_SHEET_ROW = 1048576;
+const MAX_SHEET_COLUMN = 16384;
+const LOCAL_FORMULA_FUNCTIONS = new Set(SUPPORTED_FORMULAS.map((name)=>name.toUpperCase()));
+function evaluateSpreadsheetLocalFormula(formula, options) {
+    const source = formula.trim().replace(/^=/, '').trim();
+    if (!source) return unsupportedLocalFormula('公式为空。');
+    if (Array.from(source).length > MAX_SPREADSHEET_LOCAL_FORMULA_LENGTH) return unsupportedLocalFormula('公式超过 255 个字符。');
+    const currentSheet = options.sheets.find((candidate)=>candidate.id === options.sheetId);
+    if (!currentSheet) return unsupportedLocalFormula('找不到公式所在的工作表。');
+    const evaluator = new SpreadsheetLocalFormulaEvaluator(options, currentSheet);
+    return evaluator.evaluate(source);
+}
+function spreadsheetLocalFormulaBoolean(value) {
+    if ('boolean' == typeof value) return value;
+    if ('number' == typeof value) return Number.isFinite(value) && 0 !== value;
+    return 'string' == typeof value && 'TRUE' === value.trim().toUpperCase();
+}
+class SpreadsheetLocalFormulaEvaluator {
+    options;
+    currentSheet;
+    sheetsByName = new Map();
+    anchor;
+    referencedCells = 0;
+    unsupportedMessage;
+    celldataBySheet = new Map();
+    constructor(options, currentSheet){
+        this.options = options;
+        this.currentSheet = currentSheet;
+        this.anchor = {
+            row: options.anchorRow ?? options.row,
+            column: options.anchorColumn ?? options.column
+        };
+        for (const sheet of options.sheets)this.sheetsByName.set(sheet.name.trim().toLocaleLowerCase(), sheet);
+    }
+    evaluate(formula) {
+        const parser = new Parser();
+        parser.setFunction('ROW', (parameters)=>parameters.length ? null : this.options.row + 1).setFunction('COLUMN', (parameters)=>parameters.length ? null : this.options.column + 1);
+        let unsupportedFunction;
+        parser.on('callFunction', (name)=>{
+            const normalized = name.toUpperCase();
+            if (!LOCAL_FORMULA_FUNCTIONS.has(normalized)) unsupportedFunction ??= normalized;
+        });
+        parser.on('callCellValue', (coordinate, _parserOptions, done)=>{
+            const resolved = this.resolveCoordinate(this.currentSheet, coordinate);
+            if (!resolved) return void done(null);
+            done(this.readCell(resolved));
+        });
+        parser.on('callRangeValue', (start, end, _parserOptions, done)=>{
+            done(this.readRange(start, end));
+        });
+        const parsed = parser.parse(normalizeFormulaForFortuneParser(formula), {
+            sheetId: this.currentSheet.id
+        });
+        if (unsupportedFunction) return unsupportedLocalFormula(`公式函数“${unsupportedFunction}”无法在浏览器本地求值。`);
+        if (this.unsupportedMessage) return unsupportedLocalFormula(this.unsupportedMessage);
+        if (parsed.error || void 0 === parsed.result) return unsupportedLocalFormula('公式无法求值，请检查函数、引用和括号。');
+        return {
+            supported: true,
+            value: parsed.result
+        };
+    }
+    resolveCoordinate(fallbackSheet, coordinate) {
+        const sheet = coordinate.sheetName ? this.sheetsByName.get(coordinate.sheetName.trim().toLocaleLowerCase()) : fallbackSheet;
+        if (!sheet) {
+            this.unsupportedMessage = '公式引用了不存在的工作表。';
+            return null;
+        }
+        if (coordinate.row.index < 0 || coordinate.column.index < 0) {
+            this.unsupportedMessage = '公式暂不支持整行或整列引用，请改用有限区域。';
+            return null;
+        }
+        const row = coordinate.row.isAbsolute ? coordinate.row.index : this.options.row + (coordinate.row.index - this.anchor.row);
+        const column = coordinate.column.isAbsolute ? coordinate.column.index : this.options.column + (coordinate.column.index - this.anchor.column);
+        if (row < 0 || column < 0 || row >= MAX_SHEET_ROW || column >= MAX_SHEET_COLUMN) {
+            this.unsupportedMessage = '公式引用超出了工作表边界。';
+            return null;
+        }
+        return {
+            sheet,
+            row,
+            column
+        };
+    }
+    readRange(start, end) {
+        const startCoordinate = this.resolveCoordinate(this.currentSheet, start);
+        const rangeSheet = start.sheetName ? this.sheetsByName.get(start.sheetName.trim().toLocaleLowerCase()) : this.currentSheet;
+        const endCoordinate = rangeSheet ? this.resolveCoordinate(rangeSheet, end) : null;
+        if (!startCoordinate || !endCoordinate || startCoordinate.sheet.id !== endCoordinate.sheet.id) {
+            this.unsupportedMessage ??= '公式区域引用必须位于同一工作表。';
+            return [];
+        }
+        const rowStart = Math.min(startCoordinate.row, endCoordinate.row);
+        const rowEnd = Math.max(startCoordinate.row, endCoordinate.row);
+        const columnStart = Math.min(startCoordinate.column, endCoordinate.column);
+        const columnEnd = Math.max(startCoordinate.column, endCoordinate.column);
+        const area = (rowEnd - rowStart + 1) * (columnEnd - columnStart + 1);
+        if (area <= 0 || area > work_spreadsheet_local_formula_MAX_SPREADSHEET_LOCAL_FORMULA_REFERENCED_CELLS - this.referencedCells) {
+            this.unsupportedMessage = '公式一次最多读取 1,024 个单元格。';
+            return [];
+        }
+        const values = [];
+        for(let row = rowStart; row <= rowEnd; row += 1){
+            const valuesRow = [];
+            for(let column = columnStart; column <= columnEnd; column += 1)valuesRow.push(this.readCell({
+                sheet: startCoordinate.sheet,
+                row,
+                column
+            }));
+            values.push(valuesRow);
+        }
+        return values;
+    }
+    readCell(coordinate) {
+        this.referencedCells += 1;
+        if (this.referencedCells > work_spreadsheet_local_formula_MAX_SPREADSHEET_LOCAL_FORMULA_REFERENCED_CELLS) {
+            this.unsupportedMessage = '公式一次最多读取 1,024 个单元格。';
+            return null;
+        }
+        if (this.options.useProposedValue && coordinate.sheet.id === this.currentSheet.id && coordinate.row === this.options.row && coordinate.column === this.options.column) return this.options.proposedValue;
+        const cell = this.cellAt(coordinate.sheet, coordinate.row, coordinate.column);
+        if (!cell) return null;
+        if ('string' == typeof cell.f && cell.f.length > 0 && void 0 === cell.v) {
+            this.unsupportedMessage ??= '公式引用了尚未计算的公式单元格。';
+            return null;
+        }
+        return cell.v ?? null;
+    }
+    cellAt(sheet, row, column) {
+        if (void 0 !== sheet.data) return sheet.data[row]?.[column] ?? null;
+        let cells = this.celldataBySheet.get(sheet.id);
+        if (!cells) {
+            cells = new Map();
+            for (const entry of sheet.celldata ?? []){
+                const value = entry.v && 'object' == typeof entry.v && 'v' in entry.v ? entry.v : {
+                    v: entry.v
+                };
+                cells.set(`${entry.r}_${entry.c}`, value);
+            }
+            this.celldataBySheet.set(sheet.id, cells);
+        }
+        return cells.get(`${row}_${column}`) ?? null;
+    }
+}
+function unsupportedLocalFormula(message) {
+    return {
+        supported: false,
+        value: false,
+        message
+    };
+}
+const MAX_SPREADSHEET_CONDITIONAL_FORMULA_SCAN_CELLS = 10000;
+function spreadsheetConditionalFormatStyles(sheet, formulaSheets) {
     const styles = new Map();
     const data = sheet.data ?? [];
-    if (!data.length) return styles;
+    const rules = conditionalRules(sheet);
+    if (!data.length && !rules.some(isFormulaConditionalRule)) return styles;
     const blocked = new Set();
-    for (const rule of conditionalRules(sheet)){
+    for (const rule of rules){
         const matched = new Set();
         if ('colorGradation' === rule.type) applyColorScale(styles, data, rule, blocked, matched);
         else if ('dataBar' === rule.type) applyDataBars(styles, data, rule, blocked, matched);
         else if ('icons' === rule.type) applyIconSet(styles, data, rule, blocked, matched);
-        else applyDefaultRule(styles, data, rule, blocked, matched);
+        else applyDefaultRule(styles, data, rule, blocked, matched, formulaSheets, sheet);
         if (rule.stopIfTrue) for (const key of matched)blocked.add(key);
     }
     return styles;
 }
-function applyDefaultRule(styles, data, rule, blocked, matched) {
+function isFormulaConditionalRule(rule) {
+    return 'default' === rule.type && 'formula' === rule.conditionName;
+}
+function applyDefaultRule(styles, data, rule, blocked, matched, formulaSheets, currentSheet) {
     if ('default' !== rule.type || !isConditionalFormatStyle(rule.format) || !rule.conditionName) return;
     const values = (rule.conditionValue ?? []).map(String);
     const style = rule.format;
     if ('formula' === rule.conditionName && values[0]) {
-        for (const range of rule.cellrange)forEachCell(data, [
+        for (const range of rule.cellrange)forEachFormulaCell(data, [
             range
         ], ({ row, column })=>{
-            if (evaluateFormula(values[0], row, column, range, data)) applyDifferentialStyle(styles, blocked, matched, row, column, style);
+            if (evaluateFormula(values[0], row, column, range, currentSheet, formulaSheets)) applyDifferentialStyle(styles, blocked, matched, row, column, style);
         });
         return;
     }
@@ -361,35 +518,20 @@ function matchesCondition(value, name, conditions) {
     }
     return false;
 }
-function evaluateFormula(source, row, column, baseRange, data) {
-    const formula = source.trim().replace(/^=/, '').replace(/\s+/g, '');
-    if (/^TRUE\(\)?$/i.test(formula)) return true;
-    if (/^FALSE\(\)?$/i.test(formula)) return false;
-    const parity = /^MOD\((ROW|COLUMN)\(\),(\d+)\)(=|<>|>=|<=|>|<)(-?\d+)$/i.exec(formula);
-    if (parity) {
-        const value = 'ROW' === parity[1].toUpperCase() ? row + 1 : column + 1;
-        return compareWithOperator(value % Number(parity[2]), parity[3], Number(parity[4]));
-    }
-    const blank = /^(NOT\()?ISBLANK\((\$?)([A-Z]{1,3})(\$?)([1-9]\d*)\)\)?$/i.exec(formula);
-    if (blank) {
-        const target = formulaReference(blank[2], blank[3], blank[4], blank[5], row, column, baseRange);
-        const empty = null == work_spreadsheet_conditional_format_cellValue(data, target.row, target.column) || '' === work_spreadsheet_conditional_format_cellValue(data, target.row, target.column);
-        return blank[1] ? !empty : empty;
-    }
-    const comparison = /^(\$?)([A-Z]{1,3})(\$?)([1-9]\d*)(=|<>|>=|<=|>|<)(?:"((?:[^"]|"")*)"|(-?\d+(?:\.\d+)?))$/i.exec(formula);
-    if (!comparison) return false;
-    const target = formulaReference(comparison[1], comparison[2], comparison[3], comparison[4], row, column, baseRange);
-    const left = work_spreadsheet_conditional_format_cellValue(data, target.row, target.column);
-    const right = void 0 !== comparison[6] ? comparison[6].replaceAll('""', '"') : Number(comparison[7]);
-    return compareWithOperator(left, comparison[5], right);
-}
-function formulaReference(absoluteColumn, columnName, absoluteRow, rowNumber, row, column, baseRange) {
-    const sourceColumn = decodeColumn(columnName);
-    const sourceRow = Number(rowNumber) - 1;
-    return {
-        row: absoluteRow ? sourceRow : sourceRow + row - baseRange.row[0],
-        column: absoluteColumn ? sourceColumn : sourceColumn + column - baseRange.column[0]
-    };
+function evaluateFormula(source, row, column, baseRange, currentSheet, formulaSheets) {
+    const sheets = [
+        toFormulaSheet(currentSheet),
+        ...(formulaSheets ?? []).filter((sheet)=>sheet.id && sheet.id !== currentSheet.id).map(toFormulaSheet)
+    ];
+    const result = evaluateSpreadsheetLocalFormula(source, {
+        sheets,
+        sheetId: currentSheet.id ?? '',
+        row,
+        column,
+        anchorRow: baseRange.row[0],
+        anchorColumn: baseRange.column[0]
+    });
+    return result.supported && spreadsheetLocalFormulaBoolean(result.value);
 }
 function applyDifferentialStyle(styles, blocked, matched, row, column, style) {
     const patch = {};
@@ -448,6 +590,21 @@ function forEachCell(data, ranges, visit) {
         column
     });
 }
+function forEachFormulaCell(data, ranges, visit) {
+    for (const range of ranges){
+        const area = (range.row[1] - range.row[0] + 1) * (range.column[1] - range.column[0] + 1);
+        if (area > 0 && area <= MAX_SPREADSHEET_CONDITIONAL_FORMULA_SCAN_CELLS) {
+            for(let row = range.row[0]; row <= range.row[1]; row += 1)for(let column = range.column[0]; column <= range.column[1]; column += 1)visit({
+                row,
+                column
+            });
+            continue;
+        }
+        forEachCell(data, [
+            range
+        ], visit);
+    }
+}
 function work_spreadsheet_conditional_format_cellValue(data, row, column) {
     return data[row]?.[column]?.v ?? null;
 }
@@ -464,19 +621,13 @@ function compareValues(left, right) {
     if (String(left).trim() && String(right).trim() && Number.isFinite(leftNumber) && Number.isFinite(rightNumber)) return leftNumber === rightNumber ? 0 : leftNumber > rightNumber ? 1 : -1;
     return String(left).localeCompare(String(right));
 }
-function compareWithOperator(left, operator, right) {
-    const comparison = compareValues(left, right);
-    if ('=' === operator) return 0 === comparison;
-    if ('<>' === operator) return 0 !== comparison;
-    if ('>' === operator) return comparison > 0;
-    if ('<' === operator) return comparison < 0;
-    if ('>=' === operator) return comparison >= 0;
-    return '<=' === operator && comparison <= 0;
-}
-function decodeColumn(value) {
-    let result = 0;
-    for (const character of value.toUpperCase())result = 26 * result + character.charCodeAt(0) - 64;
-    return result - 1;
+function toFormulaSheet(sheet) {
+    return {
+        id: sheet.id ?? '',
+        name: sheet.name,
+        data: sheet.data,
+        celldata: sheet.celldata
+    };
 }
 function drawSpreadsheetDiagonalDownBorder(context, bounds, line) {
     drawSpreadsheetDiagonalBorder(context, bounds, line, 'down');
@@ -13073,6 +13224,11 @@ function newConditionalRuleDraft(sheetId) {
         comparisonCellColor: DEFAULT_COLORS.comparisonCell,
         comparisonUseTextColor: true,
         comparisonUseCellColor: true,
+        formula: '=A1>0',
+        formulaTextColor: DEFAULT_COLORS.comparisonText,
+        formulaCellColor: DEFAULT_COLORS.comparisonCell,
+        formulaUseTextColor: true,
+        formulaUseCellColor: true,
         scaleSize: '3',
         minimumColor: DEFAULT_COLORS.minimum,
         midpointColor: DEFAULT_COLORS.midpoint,
@@ -13104,7 +13260,7 @@ function conditionalRuleDraftForRule(sheetId, rule) {
         draft.comparisonUseCellColor = Boolean(style.cellColor);
         draft.comparisonTextColor = colorInputValue(style.textColor, DEFAULT_COLORS.comparisonText);
         draft.comparisonCellColor = colorInputValue(style.cellColor, DEFAULT_COLORS.comparisonCell);
-    } else if (isToolbarConditionalRule(rule)) {
+    } else if ('default' !== rule.type || 'formula' !== rule.conditionName || Array.isArray(rule.format)) if (isToolbarConditionalRule(rule)) {
         draft.type = 'toolbarRule';
         draft.preservedRule = rule;
     } else if ('colorGradation' === rule.type && Array.isArray(rule.format)) {
@@ -13139,6 +13295,16 @@ function conditionalRuleDraftForRule(sheetId, rule) {
             draft.barMaxLength = String(options.maxLength ?? 90);
         }
     }
+    else {
+        const style = rule.format;
+        const values = (rule.conditionValue ?? []).map(String);
+        draft.type = 'formula';
+        draft.formula = values[0] ?? '';
+        draft.formulaUseTextColor = Boolean(style.textColor);
+        draft.formulaUseCellColor = Boolean(style.cellColor);
+        draft.formulaTextColor = colorInputValue(style.textColor, DEFAULT_COLORS.comparisonText);
+        draft.formulaCellColor = colorInputValue(style.cellColor, DEFAULT_COLORS.comparisonCell);
+    }
     return draft;
 }
 function buildConditionalRule(draft) {
@@ -13179,6 +13345,34 @@ function buildConditionalRule(draft) {
                 value
             ]
         };
+    } else if ('formula' === draft.type) {
+        const formula = draft.formula.trim();
+        if (!formula) return {
+            error: '请输入条件格式公式。'
+        };
+        const formulaSource = formula.replace(/^=/, '').trim();
+        if (!formulaSource) return {
+            error: '请输入条件格式公式，例如 =A2>0。'
+        };
+        if (Array.from(formulaSource).length > 255) return {
+            error: '条件格式公式不能超过 255 个字符。'
+        };
+        if (!draft.formulaUseTextColor && !draft.formulaUseCellColor) return {
+            error: '至少启用一种文字或填充颜色。'
+        };
+        rule = {
+            type: 'default',
+            cellrange,
+            format: {
+                textColor: draft.formulaUseTextColor ? draft.formulaTextColor : null,
+                cellColor: draft.formulaUseCellColor ? draft.formulaCellColor : null
+            },
+            conditionName: 'formula',
+            conditionRange: [],
+            conditionValue: [
+                `=${formulaSource}`
+            ]
+        };
     } else if ('dataBar' === draft.type) {
         const thresholds = savedVisualThresholds(draft.barThresholds);
         const minLength = Number(draft.barMinLength);
@@ -14429,7 +14623,7 @@ function formatSpreadsheetRowPageBreaks(breaks) {
     return normalizedBreaks(breaks).map((row)=>String(row + 1)).join(', ');
 }
 function parseSpreadsheetColumnPageBreaks(value, maximumColumn) {
-    return parsePageBreakList(value, maximumColumn, work_spreadsheet_page_breaks_decodeColumn);
+    return parsePageBreakList(value, maximumColumn, decodeColumn);
 }
 function formatSpreadsheetColumnPageBreaks(breaks) {
     return normalizedBreaks(breaks).map(encodeColumn).join(', ');
@@ -14449,7 +14643,7 @@ function parsePageBreakList(value, maximum, decode) {
 function normalizedBreaks(breaks) {
     return Array.from(new Set((breaks ?? []).filter((value)=>Number.isSafeInteger(value) && value > 0))).sort((left, right)=>left - right);
 }
-function work_spreadsheet_page_breaks_decodeColumn(token) {
+function decodeColumn(token) {
     const match = /^\$?([A-Z]+)$/i.exec(token);
     if (!match) return null;
     let value = 0;
@@ -21598,6 +21792,10 @@ function SpreadsheetConditionalFormatPanel({ content, onChange }) {
                                         value: 'icons',
                                         label: '图标集'
                                     },
+                                    {
+                                        value: 'formula',
+                                        label: '自定义公式'
+                                    },
                                     ...'toolbarRule' === draft.type ? [
                                         {
                                             value: 'toolbarRule',
@@ -21657,6 +21855,76 @@ function SpreadsheetConditionalFormatPanel({ content, onChange }) {
                                 ...draft,
                                 ...patch
                             })
+                    }) : 'formula' === draft.type ? /*#__PURE__*/ jsxs(Fragment, {
+                        children: [
+                            /*#__PURE__*/ jsxs("div", {
+                                className: "work-office-field reference",
+                                children: [
+                                    /*#__PURE__*/ jsx("span", {
+                                        children: "公式"
+                                    }),
+                                    /*#__PURE__*/ jsx(office_text_field_OfficeTextField, {
+                                        "aria-label": "条件格式公式",
+                                        value: draft.formula,
+                                        maxLength: 256,
+                                        placeholder: "=A2>0",
+                                        onChange: (event)=>setDraft({
+                                                ...draft,
+                                                formula: event.target.value
+                                            })
+                                    }),
+                                    /*#__PURE__*/ jsxs("small", {
+                                        children: [
+                                            "以应用范围左上角为相对锚点；只读取本地缓存值。",
+                                            ' ',
+                                            Array.from(draft.formula.replace(/^=/, '')).length,
+                                            "/",
+                                            255
+                                        ]
+                                    })
+                                ]
+                            }),
+                            /*#__PURE__*/ jsx("p", {
+                                className: "work-office-field-hint",
+                                children: "支持常用 Excel 函数、相对/绝对引用和有限区域；无法本地求值时保持原样。"
+                            }),
+                            /*#__PURE__*/ jsx(OfficeCheckbox, {
+                                className: "toggle",
+                                ariaLabel: "公式规则使用文字颜色",
+                                checked: draft.formulaUseTextColor,
+                                onCheckedChange: (formulaUseTextColor)=>setDraft({
+                                        ...draft,
+                                        formulaUseTextColor
+                                    }),
+                                children: "使用文字颜色"
+                            }),
+                            draft.formulaUseTextColor && /*#__PURE__*/ jsx(ColorField, {
+                                label: "文字颜色",
+                                value: draft.formulaTextColor,
+                                onChange: (formulaTextColor)=>setDraft({
+                                        ...draft,
+                                        formulaTextColor
+                                    })
+                            }),
+                            /*#__PURE__*/ jsx(OfficeCheckbox, {
+                                className: "toggle",
+                                ariaLabel: "公式规则使用填充颜色",
+                                checked: draft.formulaUseCellColor,
+                                onCheckedChange: (formulaUseCellColor)=>setDraft({
+                                        ...draft,
+                                        formulaUseCellColor
+                                    }),
+                                children: "使用填充颜色"
+                            }),
+                            draft.formulaUseCellColor && /*#__PURE__*/ jsx(ColorField, {
+                                label: "填充颜色",
+                                value: draft.formulaCellColor,
+                                onChange: (formulaCellColor)=>setDraft({
+                                        ...draft,
+                                        formulaCellColor
+                                    })
+                            })
+                        ]
                     }) : 'colorGradation' === draft.type ? /*#__PURE__*/ jsxs(Fragment, {
                         children: [
                             /*#__PURE__*/ jsxs("div", {
@@ -27185,7 +27453,6 @@ function cloneSpreadsheetDataValidationItem(item) {
     };
 }
 const MAX_SPREADSHEET_CUSTOM_VALIDATION_FORMULA_LENGTH = 255;
-const MAX_SPREADSHEET_CUSTOM_VALIDATION_REFERENCED_CELLS = 1024;
 function evaluateSpreadsheetCustomValidation(content, sheetId, row, column, item, value) {
     const sheet = content.sheets.find((candidate)=>candidate.id === sheetId);
     if (!sheet) return unsupportedCustomValidation('找不到自定义公式所在的工作表。');
@@ -27200,122 +27467,30 @@ function evaluateSpreadsheetCustomValidation(content, sheetId, row, column, item
     if (Array.from(formula).length > MAX_SPREADSHEET_CUSTOM_VALIDATION_FORMULA_LENGTH) return unsupportedCustomValidation('自定义公式超过 255 个字符。');
     const ranges = parseSpreadsheetCellRanges(item.rangeTxt);
     const anchor = spreadsheetCustomValidationAnchor(ranges, row, column);
-    const evaluator = new SpreadsheetCustomFormulaEvaluator(content, sheet, row, column, anchor, normalizedProposed);
-    return evaluator.evaluate(formula);
-}
-class SpreadsheetCustomFormulaEvaluator {
-    content;
-    currentSheet;
-    targetRow;
-    targetColumn;
-    anchor;
-    proposedValue;
-    sheetsByName = new Map();
-    referencedCells = 0;
-    unsupportedMessage;
-    constructor(content, currentSheet, targetRow, targetColumn, anchor, proposedValue){
-        this.content = content;
-        this.currentSheet = currentSheet;
-        this.targetRow = targetRow;
-        this.targetColumn = targetColumn;
-        this.anchor = anchor;
-        this.proposedValue = proposedValue;
-        for (const sheet of content.sheets)this.sheetsByName.set(sheet.name.trim().toLocaleLowerCase(), sheet);
-    }
-    evaluate(formula) {
-        const allowedFunctions = new Set(SUPPORTED_FORMULAS.map((name)=>name.toUpperCase()));
-        const parser = new Parser();
-        parser.setFunction('ROW', (parameters)=>parameters.length ? null : this.targetRow + 1).setFunction('COLUMN', (parameters)=>parameters.length ? null : this.targetColumn + 1);
-        let unsupportedFunction;
-        parser.on('callFunction', (name)=>{
-            const normalized = name.toUpperCase();
-            if (!allowedFunctions.has(normalized)) unsupportedFunction ??= normalized;
-        });
-        parser.on('callCellValue', (coordinate, _options, done)=>{
-            const resolved = this.resolveCoordinate(this.currentSheet, coordinate);
-            if (!resolved) return void done(null);
-            done(this.readCell(resolved));
-        });
-        parser.on('callRangeValue', (start, end, _options, done)=>{
-            done(this.readRange(start, end));
-        });
-        const parsed = parser.parse(normalizeFormulaForFortuneParser(formula), {
-            sheetId: this.currentSheet.id
-        });
-        if (unsupportedFunction) return unsupportedCustomValidation(`自定义公式函数“${unsupportedFunction}”无法在浏览器本地求值。`);
-        if (this.unsupportedMessage) return unsupportedCustomValidation(this.unsupportedMessage);
-        if (parsed.error) return unsupportedCustomValidation('自定义公式无法求值，请检查函数、引用和括号。');
-        return {
-            supported: true,
-            valid: spreadsheetCustomValidationBoolean(parsed.result)
-        };
-    }
-    resolveCoordinate(fallbackSheet, coordinate) {
-        const sheet = coordinate.sheetName ? this.sheetsByName.get(coordinate.sheetName.trim().toLocaleLowerCase()) : fallbackSheet;
-        if (!sheet) {
-            this.unsupportedMessage = '自定义公式引用了不存在的工作表。';
-            return null;
-        }
-        if (coordinate.row.index < 0 || coordinate.column.index < 0) {
-            this.unsupportedMessage = '自定义公式暂不支持整行或整列引用，请改用有限区域。';
-            return null;
-        }
-        const resolvedRow = coordinate.row.isAbsolute ? coordinate.row.index : this.targetRow + (coordinate.row.index - this.anchor.row);
-        const resolvedColumn = coordinate.column.isAbsolute ? coordinate.column.index : this.targetColumn + (coordinate.column.index - this.anchor.column);
-        if (resolvedRow < 0 || resolvedColumn < 0 || resolvedRow >= 1048576 || resolvedColumn >= 16384) {
-            this.unsupportedMessage = '自定义公式引用超出了工作表边界。';
-            return null;
-        }
-        return {
-            sheet,
-            row: resolvedRow,
-            column: resolvedColumn
-        };
-    }
-    readRange(start, end) {
-        const startCoordinate = this.resolveCoordinate(this.currentSheet, start);
-        const rangeSheet = start.sheetName ? this.sheetsByName.get(start.sheetName.trim().toLocaleLowerCase()) : this.currentSheet;
-        const endCoordinate = rangeSheet ? this.resolveCoordinate(rangeSheet, end) : null;
-        if (!startCoordinate || !endCoordinate || startCoordinate.sheet.id !== endCoordinate.sheet.id) {
-            this.unsupportedMessage ??= '自定义公式区域引用必须位于同一工作表。';
-            return [];
-        }
-        const rowStart = Math.min(startCoordinate.row, endCoordinate.row);
-        const rowEnd = Math.max(startCoordinate.row, endCoordinate.row);
-        const columnStart = Math.min(startCoordinate.column, endCoordinate.column);
-        const columnEnd = Math.max(startCoordinate.column, endCoordinate.column);
-        const area = (rowEnd - rowStart + 1) * (columnEnd - columnStart + 1);
-        if (area <= 0 || area > MAX_SPREADSHEET_CUSTOM_VALIDATION_REFERENCED_CELLS - this.referencedCells) {
-            this.unsupportedMessage = '自定义公式一次最多读取 1,024 个单元格。';
-            return [];
-        }
-        const values = [];
-        for(let currentRow = rowStart; currentRow <= rowEnd; currentRow += 1){
-            const row = [];
-            for(let currentColumn = columnStart; currentColumn <= columnEnd; currentColumn += 1)row.push(this.readCell({
-                sheet: startCoordinate.sheet,
-                row: currentRow,
-                column: currentColumn
-            }));
-            values.push(row);
-        }
-        return values;
-    }
-    readCell(coordinate) {
-        this.referencedCells += 1;
-        if (this.referencedCells > MAX_SPREADSHEET_CUSTOM_VALIDATION_REFERENCED_CELLS) {
-            this.unsupportedMessage = '自定义公式一次最多读取 1,024 个单元格。';
-            return null;
-        }
-        if (coordinate.sheet.id === this.currentSheet.id && coordinate.row === this.targetRow && coordinate.column === this.targetColumn) return this.proposedValue;
-        const cell = spreadsheetCustomValidationCellAt(coordinate.sheet, coordinate.row, coordinate.column);
-        if (!cell) return null;
-        if (cell.f && void 0 === cell.v) {
-            this.unsupportedMessage ??= '自定义公式引用了尚未计算的公式单元格。';
-            return null;
-        }
-        return cell.v ?? null;
-    }
+    const result = evaluateSpreadsheetLocalFormula(formula, {
+        sheets: content.sheets.flatMap((candidate)=>candidate.id ? [
+                {
+                    ...candidate,
+                    id: candidate.id
+                }
+            ] : []),
+        sheetId,
+        row,
+        column,
+        anchorRow: anchor?.row,
+        anchorColumn: anchor?.column,
+        proposedValue: normalizedProposed,
+        useProposedValue: true
+    });
+    if (!result.supported) return {
+        supported: false,
+        valid: false,
+        message: result.message ? `自定义${result.message}` : result.message
+    };
+    return {
+        supported: true,
+        valid: spreadsheetLocalFormulaBoolean(result.value)
+    };
 }
 function spreadsheetCustomValidationAnchor(ranges, row, column) {
     const range = ranges?.find((candidate)=>spreadsheetCellRangeContains(candidate, row, column));
@@ -27324,10 +27499,6 @@ function spreadsheetCustomValidationAnchor(ranges, row, column) {
         column: range?.column[0] ?? column
     };
 }
-function spreadsheetCustomValidationCellAt(sheet, row, column) {
-    if (void 0 !== sheet.data) return sheet.data[row]?.[column] ?? null;
-    return sheet.celldata?.find((entry)=>entry.r === row && entry.c === column)?.v ?? null;
-}
 function spreadsheetCustomValidationValue(value) {
     if (!value || 'object' != typeof value || Array.isArray(value)) return value;
     if ('v' in value) return value.v;
@@ -27336,11 +27507,6 @@ function spreadsheetCustomValidationValue(value) {
 function spreadsheetCustomValidationBlank(value) {
     return null == value || 'string' == typeof value && '' === value.trim();
 }
-function spreadsheetCustomValidationBoolean(value) {
-    if ('boolean' == typeof value) return value;
-    if ('number' == typeof value) return Number.isFinite(value) && 0 !== value;
-    return 'string' == typeof value && 'TRUE' === value.trim().toUpperCase();
-}
 function unsupportedCustomValidation(message) {
     return {
         supported: false,
@@ -30267,7 +30433,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
     const conditionalStylesBySheet = useMemo(()=>new Map(materializedContent.sheets.flatMap((sheet)=>sheet.id ? [
                 [
                     sheet.id,
-                    spreadsheetConditionalFormatStyles(sheet)
+                    spreadsheetConditionalFormatStyles(sheet, materializedContent.sheets)
                 ]
             ] : [])), [
         materializedContent.sheets

package/dist/4121.js

@@ -2905,6 +2905,13 @@ const WORK_TEMPLATES = [
         description: '自定义公式、下拉列表、输入提示与错误警告',
         accent: '#13795b'
     },
+    {
+        id: 'conditional-format',
+        kind: 'spreadsheet',
+        name: '公式条件格式',
+        description: '相对引用、跨表阈值、停止后续规则与本地实时强调',
+        accent: '#2f6fed'
+    },
     {
         id: 'structured-references',
         kind: 'spreadsheet',
@@ -2965,6 +2972,7 @@ function initialTitle(templateId, kind) {
         'proofing-languages': '校对语言示例',
         'quarterly-plan': '季度执行计划',
         'data-validation': '数据验证示例',
+        'conditional-format': '公式条件格式示例',
         'structured-references': '结构化引用示例',
         'strategy-deck': '业务策略汇报',
         'animated-deck': '进入与退出动画示例'
@@ -3265,6 +3273,10 @@ function contentForTemplate(templateId) {
         type: 'spreadsheet',
         sheets: dataValidationTemplateSheets()
     };
+    if ('conditional-format' === templateId) return {
+        type: 'spreadsheet',
+        sheets: conditionalFormatTemplateSheets()
+    };
     if ('structured-references' === templateId) return {
         type: 'spreadsheet',
         sheets: structuredReferenceTemplateSheets()
@@ -3647,6 +3659,247 @@ function dataValidationTemplateSheets() {
         }
     ];
 }
+function conditionalFormatTemplateSheets() {
+    const status = emptyMatrix(18, 8);
+    status[0][0] = styledCell('公式条件格式 · 发布看板', {
+        bl: 1,
+        fs: 16,
+        fc: '#ffffff',
+        bg: '#2f6fed'
+    });
+    status[1][0] = styledCell('公式以 A2:H7 左上角为锚点；先标记阻塞项，再强调达到阈值的任务。', {
+        fc: '#49617f',
+        fs: 10
+    });
+    [
+        '任务',
+        '负责人',
+        '完成率',
+        '状态',
+        '预算',
+        '实际',
+        '偏差',
+        '备注'
+    ].forEach((value, column)=>{
+        status[2][column] = headerCell(value);
+    });
+    const rows = [
+        [
+            '需求确认',
+            'Avery',
+            1,
+            '完成',
+            12000,
+            11800,
+            '按期',
+            '可发布'
+        ],
+        [
+            '接口联调',
+            'Morgan',
+            0.82,
+            '进行中',
+            18000,
+            20100,
+            '超支',
+            '关注预算'
+        ],
+        [
+            '回归测试',
+            'Riley',
+            0.54,
+            '阻塞',
+            15000,
+            7600,
+            '暂停',
+            '等待依赖'
+        ],
+        [
+            '文档发布',
+            'Jordan',
+            0.76,
+            '进行中',
+            9000,
+            8800,
+            '按期',
+            '待审阅'
+        ],
+        [
+            '版本发布',
+            'Taylor',
+            0.38,
+            '未开始',
+            22000,
+            0,
+            '未开始',
+            '尚未排期'
+        ],
+        [
+            '复盘会议',
+            'Avery',
+            0.9,
+            '进行中',
+            4000,
+            3500,
+            '按期',
+            '本周完成'
+        ]
+    ];
+    rows.forEach((row, rowIndex)=>{
+        row.forEach((value, columnIndex)=>{
+            status[rowIndex + 3][columnIndex] = styledCell(value, {
+                bg: rowIndex % 2 ? '#f6f9ff' : '#ffffff',
+                ...2 === columnIndex ? {
+                    ct: {
+                        fa: '0%',
+                        t: 'n'
+                    },
+                    m: `${Math.round(100 * Number(value))}%`
+                } : {},
+                ...4 === columnIndex || 5 === columnIndex ? {
+                    ct: {
+                        fa: '#,##0',
+                        t: 'n'
+                    },
+                    m: Number(value).toLocaleString()
+                } : {}
+            });
+        });
+    });
+    status[11][0] = styledCell('本地规则示例', {
+        bl: 1,
+        fc: '#244b9b'
+    });
+    status[12][0] = styledCell('阻塞项（停止后续规则）');
+    status[12][1] = styledCell('=$D4="阻塞"');
+    status[13][0] = styledCell('达标项（跨表阈值）');
+    status[13][1] = styledCell('=AND($C4>=Limits!$A$2,$D4<>"阻塞")');
+    const blockRule = {
+        type: 'default',
+        cellrange: [
+            {
+                row: [
+                    3,
+                    8
+                ],
+                column: [
+                    0,
+                    7
+                ]
+            }
+        ],
+        format: {
+            textColor: '#9c0006',
+            cellColor: '#ffc7ce'
+        },
+        conditionName: 'formula',
+        conditionRange: [],
+        conditionValue: [
+            '=$D4="阻塞"'
+        ],
+        stopIfTrue: true
+    };
+    const completedRule = {
+        type: 'default',
+        cellrange: [
+            {
+                row: [
+                    3,
+                    8
+                ],
+                column: [
+                    0,
+                    7
+                ]
+            }
+        ],
+        format: {
+            textColor: '#006100',
+            cellColor: '#c6efce'
+        },
+        conditionName: 'formula',
+        conditionRange: [],
+        conditionValue: [
+            '=AND($C4>=Limits!$A$2,$D4<>"阻塞")'
+        ]
+    };
+    return [
+        {
+            id: createWorkId('sheet'),
+            name: 'Status',
+            status: 1,
+            order: 0,
+            row: 18,
+            column: 8,
+            data: status,
+            luckysheet_conditionformat_save: [
+                blockRule,
+                completedRule
+            ],
+            config: {
+                columnlen: {
+                    0: 132,
+                    1: 92,
+                    2: 84,
+                    3: 86,
+                    4: 92,
+                    5: 92,
+                    6: 84,
+                    7: 116
+                },
+                rowlen: {
+                    0: 34,
+                    1: 26,
+                    2: 28,
+                    12: 24,
+                    13: 24
+                },
+                merge: {
+                    '0_0': {
+                        r: 0,
+                        c: 0,
+                        rs: 1,
+                        cs: 8
+                    }
+                }
+            }
+        },
+        {
+            id: createWorkId('sheet'),
+            name: 'Limits',
+            status: 0,
+            order: 1,
+            row: 8,
+            column: 4,
+            data: [
+                [
+                    headerCell('完成率阈值'),
+                    styledCell('说明')
+                ],
+                [
+                    styledCell(0.8, {
+                        ct: {
+                            fa: '0%',
+                            t: 'n'
+                        },
+                        m: '80%'
+                    }),
+                    styledCell('达到阈值并且未阻塞的任务使用绿色强调。')
+                ]
+            ],
+            config: {
+                columnlen: {
+                    0: 120,
+                    1: 300
+                },
+                rowlen: {
+                    0: 28,
+                    1: 36
+                }
+            }
+        }
+    ];
+}
 function structuredReferenceTemplateSheets() {
     const sales = emptyMatrix(16, 10);
     sales[0][0] = styledCell('Sales · 结构化引用', {

package/dist/internal/features/work/editors/spreadsheet-conditional-format-model.d.ts

@@ -15,7 +15,7 @@ export declare const SPREADSHEET_CONDITIONAL_COMPARISONS: {
 }[];
 export interface ConditionalRuleDraft {
     sheetId: string;
-    type: 'cellComparison' | 'colorGradation' | 'dataBar' | 'icons' | 'toolbarRule';
+    type: 'cellComparison' | 'colorGradation' | 'dataBar' | 'icons' | 'formula' | 'toolbarRule';
     reference: string;
     stopIfTrue: boolean;
     preservedRule: FortuneConditionalFormatRule | null;
@@ -26,6 +26,11 @@ export interface ConditionalRuleDraft {
     comparisonCellColor: string;
     comparisonUseTextColor: boolean;
     comparisonUseCellColor: boolean;
+    formula: string;
+    formulaTextColor: string;
+    formulaCellColor: string;
+    formulaUseTextColor: boolean;
+    formulaUseCellColor: boolean;
     scaleSize: '2' | '3';
     minimumColor: string;
     midpointColor: string;

package/dist/internal/features/work/work-spreadsheet-conditional-format.d.ts

@@ -1,10 +1,12 @@
 import type { Sheet } from '@fortune-sheet/core';
 import { type SpreadsheetConditionalDataBar } from './work-spreadsheet-conditional-data-bar';
 import { type SpreadsheetConditionalIcon } from './work-spreadsheet-conditional-icons';
+/** Full formula-rule scans stay bounded; larger ranges use materialized cells. */
+export declare const MAX_SPREADSHEET_CONDITIONAL_FORMULA_SCAN_CELLS = 10000;
 export interface SpreadsheetConditionalCellStyle {
     textColor?: string;
     cellColor?: string;
     dataBar?: SpreadsheetConditionalDataBar;
     icon?: SpreadsheetConditionalIcon;
 }
-export declare function spreadsheetConditionalFormatStyles(sheet: Sheet): Map<string, SpreadsheetConditionalCellStyle>;
+export declare function spreadsheetConditionalFormatStyles(sheet: Sheet, formulaSheets?: readonly Sheet[]): Map<string, SpreadsheetConditionalCellStyle>;

package/dist/internal/features/work/work-spreadsheet-local-formula.d.ts

@@ -0,0 +1,43 @@
+import type { CellMatrix } from '@fortune-sheet/core';
+/** OOXML and the browser editor keep local rule formulas deliberately small. */
+export declare const MAX_SPREADSHEET_LOCAL_FORMULA_LENGTH = 255;
+/** Keep synchronous browser formula evaluation bounded for hostile workbooks. */
+export declare const MAX_SPREADSHEET_LOCAL_FORMULA_REFERENCED_CELLS = 1024;
+export interface SpreadsheetFormulaSheet {
+    id: string;
+    name: string;
+    data?: CellMatrix;
+    celldata?: readonly SpreadsheetFormulaCell[];
+}
+export interface SpreadsheetFormulaCell {
+    r: number;
+    c: number;
+    v: unknown;
+}
+export interface SpreadsheetLocalFormulaOptions {
+    sheets: readonly SpreadsheetFormulaSheet[];
+    sheetId: string;
+    row: number;
+    column: number;
+    /** The first row of the rule/validation range. Defaults to the target row. */
+    anchorRow?: number;
+    /** The first column of the rule/validation range. Defaults to the target column. */
+    anchorColumn?: number;
+    /** Substitute the target cell with this value, as data validation does. */
+    proposedValue?: unknown;
+    useProposedValue?: boolean;
+}
+export interface SpreadsheetLocalFormulaResult {
+    supported: boolean;
+    value?: unknown;
+    message?: string;
+}
+/**
+ * Evaluate a bounded Excel formula against the workbook's cached local data.
+ *
+ * This is intentionally shared by custom data validation and conditional
+ * formatting. It never recalculates formula cells or reaches a remote source;
+ * an unavailable dependency therefore fails closed.
+ */
+export declare function evaluateSpreadsheetLocalFormula(formula: string, options: SpreadsheetLocalFormulaOptions): SpreadsheetLocalFormulaResult;
+export declare function spreadsheetLocalFormulaBoolean(value: unknown): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -106,6 +106,7 @@
     "playground:visual:document-opentype": "playwright test visual-tests/document-opentype.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-strike": "playwright test visual-tests/document-strike.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-data-validation": "playwright test visual-tests/spreadsheet-data-validation.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-conditional-format": "playwright test visual-tests/spreadsheet-conditional-format.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-date-time": "playwright test visual-tests/spreadsheet-date-time.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-copy-from-above": "playwright test visual-tests/spreadsheet-copy-from-above.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-custom-sort": "playwright test visual-tests/spreadsheet-custom-sort.functional.spec.ts --config playwright.config.ts",
@@ -224,6 +225,8 @@
     "test:e2e:spreadsheet-go-to:check": "a3s-test check tests/e2e/spreadsheet-go-to.acl --json",
     "test:e2e:spreadsheet-data-validation": "A3S_TEST_SUITE=tests/e2e/spreadsheet-data-validation.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:spreadsheet-data-validation:check": "a3s-test check tests/e2e/spreadsheet-data-validation.acl --json",
+    "test:e2e:spreadsheet-conditional-format": "A3S_TEST_SUITE=tests/e2e/spreadsheet-conditional-format.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:spreadsheet-conditional-format:check": "a3s-test check tests/e2e/spreadsheet-conditional-format.acl --json",
     "test:e2e:spreadsheet-diagonal-borders": "a3s-test run tests/e2e/spreadsheet-diagonal-borders.acl --json",
     "test:e2e:spreadsheet-diagonal-borders:check": "a3s-test check tests/e2e/spreadsheet-diagonal-borders.acl --json",
     "test:e2e:spreadsheet-date-time": "a3s-test run tests/e2e/spreadsheet-date-time.acl --json",