@a3s-lab/office 0.40.0 → 0.42.0

package/README.md

@@ -309,6 +309,32 @@ and [CLI reference](./docs/latest/en/cli-reference.md).
 
 ## Current release
 
+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:
+
+- Stop blocks an invalid edit with an accessible notice. Warning and
+  Information ask whether the invalid value should be kept, using the authored
+  title and message plus the current input so the decision is explicit.
+- Keeping a Warning or Information value commits it once through the controlled
+  workbook API; cancelling restores the original value. Selection, focus,
+  Undo, and collaboration remain on the same bounded edit path, and native
+  XLSX `errorStyle` metadata remains lossless on reopen.
+
 Version `0.40.0` extends Writer's local, testable review workflow with atomic
 ordered-list numbering revisions:
 

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

@@ -4,12 +4,13 @@ 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 { 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 { 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";
@@ -8036,7 +8037,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 +8122,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 +8154,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 +8266,7 @@ function spreadsheetDataValidationDialogValue(value) {
 }
 function spreadsheetDataValidationType(value) {
     return [
+        'custom',
         'date',
         'dropdown',
         'number',
@@ -8443,6 +8454,7 @@ function cloneSpreadsheetCellRange(range) {
 }
 function spreadsheetDataValidationError(code) {
     const messages = {
+        'invalid-custom-formula': '自定义公式必须是 255 个字符以内的本地公式，且不能包含控制字符。',
         'invalid-date': '请输入有效的日期、Excel 日期序号或 DATE(...) 表达式。',
         'invalid-list-source': '请输入不超过 255 个字符的逗号分隔列表，或有效的单行/单列区域。',
         'invalid-number': '请输入有效的数字；整数验证不能使用小数边界。',
@@ -26523,6 +26535,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 +26695,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 +26757,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,
@@ -26838,7 +26861,7 @@ function SpreadsheetDataValidationDialog({ source, restoreFocusTarget, onApply,
                             children: [
                                 /*#__PURE__*/ jsx(field_Field, {
                                     label: "错误警告样式",
-                                    description: "三种样式会写入原生文件；当前浏览器网格统一阻止无效值。",
+                                    description: "停止会阻止无效输入；警告和信息会询问是否保留。三种样式都会写入原生文件。",
                                     children: /*#__PURE__*/ jsxs("select", {
                                         "aria-label": "错误警告样式",
                                         value: value.errorStyle,
@@ -26900,6 +26923,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';
@@ -27073,6 +27135,219 @@ function use_spreadsheet_data_validation_spreadsheetDataValidationError(content,
         value
     }) ?? fallback;
 }
+function spreadsheetDataValidationErrorStyle(item) {
+    return 'warning' === item.errorStyle || 'information' === item.errorStyle ? item.errorStyle : 'stop';
+}
+function spreadsheetDataValidationInteraction(style) {
+    return 'stop' === style ? 'notice' : 'confirm';
+}
+function spreadsheetDataValidationDialogTitle(item) {
+    const customTitle = item.errorTitle?.trim();
+    if (customTitle) return customTitle;
+    switch(spreadsheetDataValidationErrorStyle(item)){
+        case 'warning':
+            return '数据验证警告';
+        case 'information':
+            return '数据验证提示';
+        default:
+            return '数据验证错误';
+    }
+}
+function spreadsheetDataValidationDialogDescription(failureText, value, item) {
+    const customTitle = item?.errorTitle?.trim();
+    const customMessage = item?.errorMessage?.trim();
+    let message = customMessage || failureText.trim();
+    if (customTitle && message.startsWith(`${customTitle}\n`)) message = message.slice(customTitle.length + 1).trim();
+    message ||= '当前输入不符合此单元格的数据验证规则。';
+    const valueText = spreadsheetDataValidationValueText(value);
+    return valueText ? `${message}\n\n当前输入：${valueText}` : message;
+}
+function spreadsheetDataValidationConfirmLabels(style) {
+    return 'warning' === style ? {
+        cancelLabel: '取消',
+        confirmLabel: '继续输入'
+    } : {
+        cancelLabel: '返回修改',
+        confirmLabel: '保留输入'
+    };
+}
+function spreadsheetDataValidationValueText(value) {
+    if ('string' == typeof value) return value.trim();
+    if ('number' == typeof value || 'boolean' == typeof value) return String(value);
+    return '';
+}
+function cloneSpreadsheetDataValidationItem(item) {
+    return {
+        ...item,
+        errorTitle: item.errorTitle,
+        errorMessage: item.errorMessage,
+        hintTitle: item.hintTitle
+    };
+}
+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('找不到自定义公式所在的工作表。');
+    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 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;
+    }
+}
+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 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;
+    return 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,
+        valid: false,
+        message
+    };
+}
 const spreadsheetCellFormatAttributes = [
     'bl',
     'it',
@@ -29935,6 +30210,49 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
     const activeSheetId = viewActiveSheetId && content.sheets.some((sheet)=>sheet.id === viewActiveSheetId && 1 !== sheet.hide) ? viewActiveSheetId : contentActiveSheetId;
     const activeSheetIdRef = useRef(activeSheetId);
     const focusedSheetIdRef = useRef(null);
+    const pendingDataValidationRef = useRef(null);
+    const [pendingDataValidation, setPendingDataValidation] = useState(null);
+    const queueDataValidationEdit = useCallback((row, column, value, item, failureText, sheetId)=>{
+        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,
+            failureText,
+            interaction: spreadsheetDataValidationInteraction(style),
+            item: cloneSpreadsheetDataValidationItem(validationItem),
+            row,
+            sheetId: requestSheetId,
+            value
+        };
+        pendingDataValidationRef.current = request;
+        queueMicrotask(()=>{
+            if (pendingDataValidationRef.current === request) setPendingDataValidation(request);
+        });
+        return false;
+    }, []);
     contentRef.current = materializedContent;
     previewRef.current = preview;
     const controlledHistory = useOfficeHistory({
@@ -29992,6 +30310,100 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
     }, [
         activeSheetId
     ]);
+    useEffect(()=>{
+        const request = pendingDataValidation;
+        if (!request) return;
+        let cancelled = false;
+        const style = spreadsheetDataValidationErrorStyle(request.item);
+        const description = spreadsheetDataValidationDialogDescription(request.failureText, request.value, request.item);
+        const restoreValidationSelection = ()=>{
+            const selection = {
+                row: [
+                    request.row,
+                    request.row
+                ],
+                column: [
+                    request.column,
+                    request.column
+                ],
+                row_focus: request.row,
+                column_focus: request.column
+            };
+            const nextSelection = {
+                sheetId: request.sheetId,
+                selection
+            };
+            selectionStateRef.current.current = nextSelection;
+            selectionStateRef.current.requested = {
+                sheetId: request.sheetId,
+                selection: {
+                    ...selection,
+                    row: [
+                        ...selection.row
+                    ],
+                    column: [
+                        ...selection.column
+                    ]
+                }
+            };
+            setSelectionState(nextSelection);
+            try {
+                workbookRef.current?.setSelection([
+                    {
+                        row: selection.row,
+                        column: selection.column
+                    }
+                ], {
+                    id: request.sheetId
+                });
+            } catch  {}
+        };
+        const finish = (accepted)=>{
+            if (cancelled || pendingDataValidationRef.current !== request) return;
+            pendingDataValidationRef.current = null;
+            setPendingDataValidation(null);
+            if (accepted) try {
+                workbookRef.current?.setCellValue(request.row, request.column, request.value, {
+                    id: request.sheetId,
+                    skipDataValidation: true
+                });
+            } catch  {
+                showToast('无法保留此输入，请重试。', 'error');
+            }
+            restoreValidationSelection();
+        };
+        const showValidationDialog = async ()=>{
+            if ('notice' === request.interaction) {
+                await officeDialog.notice({
+                    title: spreadsheetDataValidationDialogTitle(request.item),
+                    description,
+                    confirmLabel: '知道了',
+                    restoreFocusTarget: getSpreadsheetDialogGridFocusTarget
+                });
+                finish(false);
+                return;
+            }
+            const labels = spreadsheetDataValidationConfirmLabels(style);
+            const accepted = await officeDialog.confirm({
+                title: spreadsheetDataValidationDialogTitle(request.item),
+                description,
+                confirmLabel: labels.confirmLabel,
+                cancelLabel: labels.cancelLabel,
+                confirmTone: 'warning' === style ? 'primary' : 'secondary',
+                restoreFocusTarget: getSpreadsheetDialogGridFocusTarget
+            });
+            finish(accepted);
+        };
+        showValidationDialog();
+        return ()=>{
+            cancelled = true;
+        };
+    }, [
+        getSpreadsheetDialogGridFocusTarget,
+        officeDialog.confirm,
+        officeDialog.notice,
+        pendingDataValidation
+    ]);
     useEffect(()=>{
         if (preview || !activeSheetId || focusedSheetIdRef.current === activeSheetId) return;
         const initialFocus = null === focusedSheetIdRef.current;
@@ -30077,6 +30489,7 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                 const sheet = contentRef.current.sheets.find((candidate)=>candidate.id === activeSheetIdRef.current);
                 return !sheet || !spreadsheetPivotOutputContains(sheet, row, column);
             },
+            beforeDataValidation: queueDataValidationEdit,
             beforePaste: (selections)=>{
                 const sheet = contentRef.current.sheets.find((candidate)=>candidate.id === activeSheetIdRef.current);
                 if (!sheet) return true;
@@ -30116,7 +30529,8 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
                 }
             }
         }), [
-        collaborationView
+        collaborationView,
+        queueDataValidationEdit
     ]);
     const conditionalFormatKey = useMemo(()=>content.sheets.map((sheet)=>`${sheet.id}:${JSON.stringify(sheet.luckysheet_conditionformat_save ?? [])}`).join('|'), [
         content.sheets

package/dist/4121.js

@@ -2902,7 +2902,7 @@ const WORK_TEMPLATES = [
         id: 'data-validation',
         kind: 'spreadsheet',
         name: '数据验证',
-        description: '下拉列表、输入提示与错误警告',
+        description: '自定义公式、下拉列表、输入提示与错误警告',
         accent: '#13795b'
     },
     {
@@ -3566,6 +3566,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: [

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-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-interaction.d.ts

@@ -0,0 +1,23 @@
+import type { WorkSpreadsheetDataValidationErrorStyle, WorkSpreadsheetDataValidationItem } from '../work-types';
+export type SpreadsheetDataValidationInteraction = 'notice' | 'confirm';
+export interface SpreadsheetDataValidationEditRequest {
+    column: number;
+    failureText: string;
+    interaction: SpreadsheetDataValidationInteraction;
+    item: WorkSpreadsheetDataValidationItem;
+    row: number;
+    sheetId: string;
+    value: unknown;
+}
+type SpreadsheetDataValidationMessageSource = Pick<WorkSpreadsheetDataValidationItem, 'errorMessage' | 'errorTitle'>;
+export declare function spreadsheetDataValidationErrorStyle(item: Pick<WorkSpreadsheetDataValidationItem, 'errorStyle'>): WorkSpreadsheetDataValidationErrorStyle;
+export declare function spreadsheetDataValidationInteraction(style: WorkSpreadsheetDataValidationErrorStyle): SpreadsheetDataValidationInteraction;
+export declare function spreadsheetDataValidationDialogTitle(item: Pick<WorkSpreadsheetDataValidationItem, 'errorStyle' | 'errorTitle'>): string;
+export declare function spreadsheetDataValidationDialogDescription(failureText: string, value: unknown, item?: SpreadsheetDataValidationMessageSource): string;
+export declare function spreadsheetDataValidationConfirmLabels(style: WorkSpreadsheetDataValidationErrorStyle): {
+    cancelLabel: string;
+    confirmLabel: string;
+};
+export declare function spreadsheetDataValidationValueText(value: unknown): string;
+export declare function cloneSpreadsheetDataValidationItem(item: WorkSpreadsheetDataValidationItem): WorkSpreadsheetDataValidationItem;
+export {};

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-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/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.40.0",
+  "version": "0.42.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",