@a3s-lab/office 0.41.0 → 0.43.0

package/README.md

@@ -309,6 +309,36 @@ 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:
+
+- Author a formula with an optional `=` prefix in the same accessible dialog;
+  relative references are anchored per selected range and the proposed value
+  is evaluated before it enters the controlled workbook.
+- Common local functions, cell/range references, and sheet-qualified references
+  are evaluated synchronously with a 255-character formula and 1,024-cell read
+  budget. External, whole-row/column, missing-sheet, and uncached-formula
+  references fail closed instead of silently accepting an unsafe edit.
+- Custom rules round-trip through XLSX and are demonstrated in the public
+  **新建 → 数据验证** template, alongside the existing list, date, and alert
+  branches. Paste and object-level batch writes remain separate preflight
+  boundaries.
+
 Version `0.41.0` aligns Spreadsheet data-validation alerts with the local,
 testable interaction model used by Traditional Office:
 

package/dist/0~7048.js

@@ -2733,4 +2733,4 @@ function abortError() {
 function disposedError() {
     return new Error('Office kernel client is disposed.');
 }
-export { CollectionState, CommittedOfficeNumberField, OfficeCheckbox, OfficeNumberField, createOfficeKernelClient, handleOfficeTaskPaneKeyDown, normalizeOfficeFontFamily, officeFontFamilies, officeFontFamilyLabel, useOfficeDialog, useOfficeTaskPaneEscape, useOfficeTaskPaneModal };
+export { CollectionState, CommittedOfficeNumberField, OfficeCheckbox, OfficeNumberField, createOfficeKernelClient, handleOfficeTaskPaneKeyDown, normalizeFormulaForFortuneParser, normalizeOfficeFontFamily, officeFontFamilies, officeFontFamilyLabel, useOfficeDialog, useOfficeTaskPaneEscape, useOfficeTaskPaneModal };

package/dist/0~spreadsheet-editor.js

@@ -3,13 +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 { 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 } from "./0~7048.js";
 import { isOfficeShortcutBlocked, OfficeColorPicker } from "./0~3635.js";
 import { createOfficeEditorExtension, useOfficeEditorRuntime, useOfficeEditorKeyboardShortcuts } from "./0~3557.js";
 import { showToast } from "./6489.js";
@@ -158,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;
     }
@@ -360,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 = {};
@@ -447,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;
 }
@@ -463,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');
@@ -8036,7 +8188,7 @@ const dateOperators = [
     'noLaterThan'
 ];
 function spreadsheetDataValidationOperators(type) {
-    if ('dropdown' === type) return [];
+    if ('custom' === type || 'dropdown' === type) return [];
     return 'date' === type ? dateOperators : numericOperators;
 }
 function createSpreadsheetDataValidationDialogSource(content, target) {
@@ -8121,8 +8273,8 @@ function spreadsheetDataValidationTargetError(sheet, ranges) {
 }
 function normalizeSpreadsheetDataValidationItem(content, sheet, ranges, value) {
     const operators = spreadsheetDataValidationOperators(value.type);
-    const type2 = 'dropdown' === value.type ? '' : value.type2;
-    if ('dropdown' !== value.type && !operators.includes(type2)) return spreadsheetDataValidationError('invalid-operator');
+    const type2 = 'dropdown' === value.type || 'custom' === value.type ? '' : value.type2;
+    if ('dropdown' !== value.type && 'custom' !== value.type && !operators.includes(type2)) return spreadsheetDataValidationError('invalid-operator');
     const normalizedValues = normalizeSpreadsheetDataValidationValues(content, sheet, value.type, type2, value.value1, value.value2);
     if (!normalizedValues.ok) return normalizedValues;
     return {
@@ -8153,6 +8305,15 @@ function normalizeSpreadsheetDataValidationValues(content, sheet, type, type2, r
     const value2 = rawValue2.trim();
     if (!value1) return spreadsheetDataValidationError('missing-value');
     if ('dropdown' === type) return normalizeSpreadsheetListValidation(content, sheet, value1);
+    if ('custom' === type) {
+        const formula = value1.replace(/^=/, '').trim();
+        if (!formula || Array.from(formula).length > 255 || /[\u0000-\u001f\u007f]/u.test(formula)) return spreadsheetDataValidationError('invalid-custom-formula');
+        return {
+            ok: true,
+            value1: formula,
+            value2: ''
+        };
+    }
     const needsSecond = 'between' === type2 || 'notBetween' === type2;
     if (needsSecond && !value2) return spreadsheetDataValidationError('missing-value');
     if ('date' === type) {
@@ -8256,6 +8417,7 @@ function spreadsheetDataValidationDialogValue(value) {
 }
 function spreadsheetDataValidationType(value) {
     return [
+        'custom',
         'date',
         'dropdown',
         'number',
@@ -8443,6 +8605,7 @@ function cloneSpreadsheetCellRange(range) {
 }
 function spreadsheetDataValidationError(code) {
     const messages = {
+        'invalid-custom-formula': '自定义公式必须是 255 个字符以内的本地公式，且不能包含控制字符。',
         'invalid-date': '请输入有效的日期、Excel 日期序号或 DATE(...) 表达式。',
         'invalid-list-source': '请输入不超过 255 个字符的逗号分隔列表，或有效的单行/单列区域。',
         'invalid-number': '请输入有效的数字；整数验证不能使用小数边界。',
@@ -13061,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,
@@ -13092,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)) {
@@ -13127,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) {
@@ -13167,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);
@@ -14417,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(', ');
@@ -14437,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;
@@ -21586,6 +21792,10 @@ function SpreadsheetConditionalFormatPanel({ content, onChange }) {
                                         value: 'icons',
                                         label: '图标集'
                                     },
+                                    {
+                                        value: 'formula',
+                                        label: '自定义公式'
+                                    },
                                     ...'toolbarRule' === draft.type ? [
                                         {
                                             value: 'toolbarRule',
@@ -21645,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", {
@@ -26523,6 +26803,10 @@ function pruneSpreadsheetCollaborationViewState(view, content) {
     for (const sheetId of view.zoomBySheet.keys())if (!sheetIds.has(sheetId)) view.zoomBySheet.delete(sheetId);
 }
 const validationTypes = [
+    {
+        value: 'custom',
+        label: '自定义公式'
+    },
     {
         value: 'dropdown',
         label: '序列'
@@ -26679,7 +26963,7 @@ function SpreadsheetDataValidationDialog({ source, restoreFocusTarget, onApply,
                                             }, option.value))
                                     })
                                 }),
-                                'dropdown' !== value.type && /*#__PURE__*/ jsx(field_Field, {
+                                'dropdown' !== value.type && 'custom' !== value.type && /*#__PURE__*/ jsx(field_Field, {
                                     label: "数据",
                                     children: /*#__PURE__*/ jsx("select", {
                                         value: value.type2,
@@ -26741,6 +27025,13 @@ function SpreadsheetDataValidationDialog({ source, restoreFocusTarget, onApply,
                                     setTouched(true);
                                 }
                             })
+                        }) : 'custom' === value.type ? /*#__PURE__*/ jsx(SpreadsheetDataValidationCustomFormulaField, {
+                            value: value.value1,
+                            error: visibleError,
+                            onTouched: ()=>setTouched(true),
+                            onValueChange: (value1)=>update({
+                                    value1
+                                })
                         }) : /*#__PURE__*/ jsx(SpreadsheetDataValidationBoundaryFields, {
                             type: value.type,
                             type2: value.type2,
@@ -26900,6 +27191,45 @@ function SpreadsheetDataValidationDialog({ source, restoreFocusTarget, onApply,
         })
     });
 }
+function SpreadsheetDataValidationCustomFormulaField({ error, onTouched, onValueChange, value }) {
+    return /*#__PURE__*/ jsxs("div", {
+        className: "work-spreadsheet-data-validation-custom-formula",
+        children: [
+            /*#__PURE__*/ jsx(field_Field, {
+                label: "公式",
+                required: true,
+                description: "公式必须返回 TRUE；相对引用以每个选定区域的左上角为基准。仅计算本地单元格和区域，不访问网络。",
+                error: error ?? void 0,
+                children: /*#__PURE__*/ jsx("textarea", {
+                    "aria-label": "公式",
+                    rows: 2,
+                    maxLength: 255,
+                    placeholder: '例如：=AND(A1<>"",A1<=100)',
+                    autoCapitalize: "none",
+                    spellCheck: false,
+                    value: value,
+                    onBlur: onTouched,
+                    onChange: (event)=>{
+                        onValueChange(event.currentTarget.value);
+                        onTouched();
+                    }
+                })
+            }),
+            /*#__PURE__*/ jsxs("p", {
+                className: "work-spreadsheet-data-validation-formula-note",
+                children: [
+                    /*#__PURE__*/ jsx(Sigma, {
+                        size: 14,
+                        "aria-hidden": "true"
+                    }),
+                    /*#__PURE__*/ jsx("span", {
+                        children: "支持常用 Excel 函数、单元格引用和区域引用；无法安全求值时会阻止输入。"
+                    })
+                ]
+            })
+        ]
+    });
+}
 function SpreadsheetDataValidationBoundaryFields({ error, onTouched, onValueChange, type, type2, value1, value2 }) {
     const needsSecond = spreadsheetDataValidationNeedsSecondValue(type2);
     const inputMode = 'date' === type ? 'text' : 'decimal';
@@ -27122,6 +27452,68 @@ function cloneSpreadsheetDataValidationItem(item) {
         hintTitle: item.hintTitle
     };
 }
+const MAX_SPREADSHEET_CUSTOM_VALIDATION_FORMULA_LENGTH = 255;
+function evaluateSpreadsheetCustomValidation(content, sheetId, row, column, item, value) {
+    const sheet = content.sheets.find((candidate)=>candidate.id === sheetId);
+    if (!sheet) return unsupportedCustomValidation('找不到自定义公式所在的工作表。');
+    const proposed = spreadsheetCustomValidationValue(value);
+    const normalizedProposed = spreadsheetCustomValidationBlank(proposed) ? '' : proposed;
+    if (false !== item.allowBlank && '' === normalizedProposed) return {
+        supported: true,
+        valid: true
+    };
+    const formula = item.value1.trim().replace(/^=/, '').trim();
+    if (!formula) return unsupportedCustomValidation('自定义公式为空。');
+    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 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));
+    return {
+        row: range?.row[0] ?? row,
+        column: range?.column[0] ?? column
+    };
+}
+function spreadsheetCustomValidationValue(value) {
+    if (!value || 'object' != typeof value || Array.isArray(value)) return value;
+    if ('v' in value) return value.v;
+    return value;
+}
+function spreadsheetCustomValidationBlank(value) {
+    return null == value || 'string' == typeof value && '' === value.trim();
+}
+function unsupportedCustomValidation(message) {
+    return {
+        supported: false,
+        valid: false,
+        message
+    };
+}
 const spreadsheetCellFormatAttributes = [
     'bl',
     'it',
@@ -29990,6 +30382,27 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         const requestSheetId = sheetId ?? activeSheetIdRef.current;
         if (!requestSheetId || !item || 'object' != typeof item || pendingDataValidationRef.current) return pendingDataValidationRef.current ? false : void 0;
         const validationItem = item;
+        if ('custom' === validationItem.type) {
+            const evaluation = evaluateSpreadsheetCustomValidation(contentRef.current, requestSheetId, row, column, validationItem, value);
+            if (evaluation.supported && evaluation.valid) return true;
+            const displayItem = cloneSpreadsheetDataValidationItem(validationItem);
+            if (!displayItem.errorMessage?.trim() && evaluation.message) displayItem.errorMessage = evaluation.message;
+            const style = spreadsheetDataValidationErrorStyle(displayItem);
+            const request = {
+                column,
+                failureText: evaluation.message ?? failureText,
+                interaction: spreadsheetDataValidationInteraction(style),
+                item: displayItem,
+                row,
+                sheetId: requestSheetId,
+                value
+            };
+            pendingDataValidationRef.current = request;
+            queueMicrotask(()=>{
+                if (pendingDataValidationRef.current === request) setPendingDataValidation(request);
+            });
+            return false;
+        }
         const style = spreadsheetDataValidationErrorStyle(validationItem);
         const request = {
             column,
@@ -30020,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

@@ -2902,9 +2902,16 @@ const WORK_TEMPLATES = [
         id: 'data-validation',
         kind: 'spreadsheet',
         name: '数据验证',
-        description: '下拉列表、输入提示与错误警告',
+        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()
@@ -3566,6 +3578,32 @@ function dataValidationTemplateSheets() {
                         hintTitle: 'Priority',
                         hintValue: '1 is highest priority; 5 is lowest.'
                     })
+                },
+                {
+                    ranges: [
+                        {
+                            row: [
+                                1,
+                                5
+                            ],
+                            column: [
+                                4,
+                                4
+                            ]
+                        }
+                    ],
+                    item: dataValidationTemplateItem({
+                        type: 'custom',
+                        rangeTxt: 'E2:E6',
+                        value1: 'LEN(E2)>0',
+                        allowBlank: false,
+                        errorStyle: 'stop',
+                        errorTitle: 'Owner required',
+                        errorMessage: 'Enter an owner for every task.',
+                        hintShow: true,
+                        hintTitle: 'Owner',
+                        hintValue: 'The custom formula checks that this cell is not blank.'
+                    })
                 }
             ],
             luckysheet_select_save: [
@@ -3621,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/core.js

@@ -3325,6 +3325,7 @@ function parseListFormula(value) {
 }
 function fortuneValidationType(value) {
     const types = {
+        custom: 'custom',
         list: 'dropdown',
         whole: 'number_integer',
         decimal: 'number',
@@ -3335,6 +3336,7 @@ function fortuneValidationType(value) {
 }
 function xlsxValidationType(value) {
     const types = {
+        custom: 'custom',
         dropdown: 'list',
         number: 'decimal',
         number_integer: 'whole',

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/editors/spreadsheet-data-validation-custom.d.ts

@@ -0,0 +1,18 @@
+import type { WorkSpreadsheetContent, WorkSpreadsheetDataValidationItem } from '../work-types';
+/** OOXML limits a data-validation formula to 255 characters. */
+export declare const MAX_SPREADSHEET_CUSTOM_VALIDATION_FORMULA_LENGTH = 255;
+/** Keep synchronous browser validation bounded even for a hostile workbook. */
+export declare const MAX_SPREADSHEET_CUSTOM_VALIDATION_REFERENCED_CELLS = 1024;
+export interface SpreadsheetCustomValidationResult {
+    message?: string;
+    supported: boolean;
+    valid: boolean;
+}
+/**
+ * Evaluates a local Excel custom-validation formula synchronously.
+ *
+ * The editor deliberately evaluates against cached cell values. Formula
+ * recalculation remains a separate kernel concern; a formula cell without a
+ * cached value therefore fails closed instead of silently accepting input.
+ */
+export declare function evaluateSpreadsheetCustomValidation(content: WorkSpreadsheetContent, sheetId: string, row: number, column: number, item: WorkSpreadsheetDataValidationItem, value: unknown): SpreadsheetCustomValidationResult;

package/dist/internal/features/work/editors/spreadsheet-data-validation.d.ts

@@ -1,7 +1,7 @@
 import type { WorkSpreadsheetContent, WorkSpreadsheetDataValidationErrorStyle, WorkSpreadsheetDataValidationItem, WorkSpreadsheetSheet } from '../work-types';
 import { type SpreadsheetCellRange } from './spreadsheet-cell-range';
 export declare const MAX_SPREADSHEET_DATA_VALIDATION_CELLS = 10000;
-export type SpreadsheetDataValidationType = 'date' | 'dropdown' | 'number' | 'number_integer' | 'text_length';
+export type SpreadsheetDataValidationType = 'custom' | 'date' | 'dropdown' | 'number' | 'number_integer' | 'text_length';
 export type SpreadsheetDataValidationOperator = 'between' | 'equal' | 'greaterOrEqualTo' | 'lessThan' | 'lessThanOrEqualTo' | 'moreThanThe' | 'noEarlierThan' | 'noLaterThan' | 'notBetween' | 'notEqualTo' | 'earlierThan' | 'laterThan';
 export interface SpreadsheetDataValidationDialogValue {
     allowBlank: boolean;
@@ -46,7 +46,7 @@ export type SpreadsheetDataValidationResult = {
     message: string;
     ok: false;
 };
-export type SpreadsheetDataValidationErrorCode = 'invalid-date' | 'invalid-list-source' | 'invalid-number' | 'invalid-operator' | 'invalid-range' | 'invalid-text-length' | 'missing-value' | 'multiple-list-columns' | 'out-of-bounds' | 'protected-range' | 'range-too-large' | 'sheet-not-found' | 'value-order';
+export type SpreadsheetDataValidationErrorCode = 'invalid-custom-formula' | 'invalid-date' | 'invalid-list-source' | 'invalid-number' | 'invalid-operator' | 'invalid-range' | 'invalid-text-length' | 'missing-value' | 'multiple-list-columns' | 'out-of-bounds' | 'protected-range' | 'range-too-large' | 'sheet-not-found' | 'value-order';
 export declare function spreadsheetDataValidationOperators(type: SpreadsheetDataValidationType): readonly SpreadsheetDataValidationOperator[];
 export declare function createSpreadsheetDataValidationDialogSource(content: WorkSpreadsheetContent, target: SpreadsheetDataValidationTarget): SpreadsheetDataValidationDialogSource | null;
 export declare function validateSpreadsheetDataValidationRequest(content: WorkSpreadsheetContent, request: SpreadsheetDataValidationRequest): SpreadsheetDataValidationResult;

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-data-validation.d.ts

@@ -2,6 +2,7 @@ import type { WorkSpreadsheetDataValidationErrorStyle } from './work-types';
 export declare const SPREADSHEET_DATA_VALIDATION_TITLE_LIMIT = 32;
 export declare const SPREADSHEET_DATA_VALIDATION_HINT_LIMIT = 255;
 export declare const SPREADSHEET_DATA_VALIDATION_ERROR_LIMIT = 225;
+export declare const SPREADSHEET_DATA_VALIDATION_FORMULA_LIMIT = 255;
 export declare const SPREADSHEET_DATA_VALIDATION_ERROR_STYLES: readonly ["stop", "warning", "information"];
 export declare function normalizeSpreadsheetDataValidationErrorStyle(value: unknown): WorkSpreadsheetDataValidationErrorStyle;
 export declare function boundedSpreadsheetDataValidationText(value: unknown, limit: number): string;

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/dist/styles.css

@@ -17939,6 +17939,27 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   display: grid;
 }
 
+.work-spreadsheet-data-validation-custom-formula {
+  gap: 8px;
+  display: grid;
+}
+
+.work-spreadsheet-data-validation-formula-note {
+  color: var(--a3s-muted);
+  align-items: flex-start;
+  gap: 6px;
+  margin: -2px 0 0;
+  font-size: 10px;
+  line-height: 1.45;
+  display: flex;
+}
+
+.work-spreadsheet-data-validation-formula-note svg {
+  color: var(--work-spreadsheet-accent, #159469);
+  flex: none;
+  margin-top: 1px;
+}
+
 .work-spreadsheet-data-validation-inline-error {
   color: var(--a3s-danger, #c23535);
   grid-column: 1 / -1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.41.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",