@a3s-lab/office 0.34.0 → 0.36.0

package/dist/8715.js

@@ -1,4 +1,269 @@
 import { createOfficeId as createWorkId, directChild, attribute } from "./4121.js";
+function sparseArrayIndexes(values) {
+    if (!values) return [];
+    return Object.keys(values).flatMap((key)=>{
+        const index = Number(key);
+        return Number.isSafeInteger(index) && index >= 0 && index < values.length ? [
+            index
+        ] : [];
+    });
+}
+function sparseArrayEntries(values) {
+    if (!values) return [];
+    return sparseArrayIndexes(values).flatMap((index)=>{
+        const value = values[index];
+        return void 0 === value ? [] : [
+            [
+                index,
+                value
+            ]
+        ];
+    });
+}
+function sparseMatrixColumnCount(matrix) {
+    let maximum = 0;
+    for (const [, row] of sparseArrayEntries(matrix))maximum = Math.max(maximum, row.length);
+    return maximum;
+}
+function spreadsheetGridSize(sheet) {
+    if (!sheet) return null;
+    return {
+        rowCount: Math.max(sheet.row ?? 0, sheet.data?.length ?? 0),
+        columnCount: Math.max(sheet.column ?? 0, sparseMatrixColumnCount(sheet.data))
+    };
+}
+function cloneSparseMatrix(source) {
+    const clone = [];
+    if (!source) return clone;
+    clone.length = source.length;
+    for (const [rowIndex, sourceRow] of sparseArrayEntries(source)){
+        const row = [];
+        row.length = sourceRow.length;
+        for (const columnIndex of sparseArrayIndexes(sourceRow))row[columnIndex] = sourceRow[columnIndex];
+        clone[rowIndex] = row;
+    }
+    return clone;
+}
+const DEFAULT_SPREADSHEET_CALCULATION_SETTINGS = {
+    mode: 'automatic',
+    fullCalculationOnLoad: false,
+    forceFullCalculation: false,
+    iterativeCalculation: false,
+    maximumIterations: 100,
+    maximumChange: 0.001,
+    fullPrecision: true
+};
+const VOLATILE_FUNCTIONS = new Set([
+    'CELL',
+    'INFO',
+    'INDIRECT',
+    'NOW',
+    'OFFSET',
+    'RAND',
+    'RANDBETWEEN',
+    'TODAY'
+]);
+const FUTURE_FUNCTIONS = new Set([
+    'ARRAYTOTEXT',
+    'BYCOL',
+    'BYROW',
+    'CHOOSECOLS',
+    'CHOOSEROWS',
+    'DROP',
+    'EXPAND',
+    'FIELDVALUE',
+    'FILTER',
+    'HSTACK',
+    'IMAGE',
+    'ISOMITTED',
+    'LAMBDA',
+    'LET',
+    'MAKEARRAY',
+    'MAP',
+    'RANDARRAY',
+    'REDUCE',
+    'SCAN',
+    'SEQUENCE',
+    'SORT',
+    'SORTBY',
+    'STOCKHISTORY',
+    'TAKE',
+    'TEXTAFTER',
+    'TEXTBEFORE',
+    'TEXTSPLIT',
+    'TOCOL',
+    'TOROW',
+    'UNIQUE',
+    'VALUETOTEXT',
+    'VSTACK',
+    'WRAPCOLS',
+    'WRAPROWS',
+    'XLOOKUP',
+    'XMATCH'
+]);
+const FUTURE_FUNCTION_PREFIXES = new Map([
+    [
+        'FILTER',
+        '_xlfn._xlws.'
+    ],
+    [
+        'SORT',
+        '_xlfn._xlws.'
+    ],
+    [
+        'SORTBY',
+        '_xlfn._xlws.'
+    ],
+    [
+        'UNIQUE',
+        '_xlfn.'
+    ],
+    ...Array.from(FUTURE_FUNCTIONS).filter((name)=>![
+            'FILTER',
+            'SORT',
+            'SORTBY',
+            'UNIQUE'
+        ].includes(name)).map((name)=>[
+            name,
+            '_xlfn.'
+        ])
+]);
+function effectiveSpreadsheetCalculationSettings(settings) {
+    if (!settings) return {
+        ...DEFAULT_SPREADSHEET_CALCULATION_SETTINGS
+    };
+    return {
+        mode: settings.mode,
+        fullCalculationOnLoad: Boolean(settings.fullCalculationOnLoad),
+        forceFullCalculation: Boolean(settings.forceFullCalculation),
+        iterativeCalculation: Boolean(settings.iterativeCalculation),
+        maximumIterations: clampedInteger(settings.maximumIterations, 1, 10000, 100),
+        maximumChange: positiveNumber(settings.maximumChange, 0.001),
+        fullPrecision: false !== settings.fullPrecision
+    };
+}
+function editableSpreadsheetFormula(source) {
+    return transformFormulaOutsideStrings(source, (segment)=>segment.replace(/_xlfn\._xlws\.(?=[A-Z][A-Z0-9_.]*\s*\()/gi, '').replace(/_xlfn\.(?=[A-Z][A-Z0-9_.]*\s*\()/gi, '').replace(/_xlws\.(?=[A-Z][A-Z0-9_.]*\s*\()/gi, ''));
+}
+function spreadsheetFormulaForXlsx(currentFormula, sourceFormula) {
+    const current = currentFormula.trim().replace(/^=/, '');
+    const source = sourceFormula?.trim().replace(/^=/, '');
+    if (source && comparableFormula(source) === comparableFormula(current)) return source;
+    return futureFunctionPrefixes(current, source);
+}
+function spreadsheetFormulaRangeForCell(sheet, row, column) {
+    const address = spreadsheetCellAddress(row, column);
+    return (sheet.formulaMetadata?.ranges ?? []).find((range)=>range.anchor.toUpperCase().replaceAll('$', '') === address);
+}
+function spreadsheetFormulaRangesForSelection(sheet, selection) {
+    return (sheet.formulaMetadata?.ranges ?? []).filter((range)=>rangesOverlap(selection, parseSpreadsheetFormulaRange(range.reference)));
+}
+function spreadsheetFormulaRangeConflict(sheet, range) {
+    const bounds = parseSpreadsheetFormulaRange(range.reference);
+    if (!bounds) return '引用范围无效';
+    const anchor = parseSpreadsheetCellAddress(range.anchor);
+    if (!anchor || !containsCell(bounds, anchor.row, anchor.column)) return '锚点不在引用范围内';
+    const anchorCell = sheet.data?.[anchor.row]?.[anchor.column];
+    if (!anchorCell) return '锚点单元格不存在';
+    const overlaps = (sheet.formulaMetadata?.ranges ?? []).filter((candidate)=>candidate !== range && rangesOverlap(bounds, parseSpreadsheetFormulaRange(candidate.reference)));
+    if (overlaps.length) return '与其他公式范围重叠';
+    for (const [row, cells] of sparseArrayEntries(sheet.data))if (!(row < bounds.startRow) && !(row > bounds.endRow)) {
+        for (const [column, cell] of sparseArrayEntries(cells))if (!(column < bounds.startColumn) && !(column > bounds.endColumn)) {
+            if (row !== anchor.row || column !== anchor.column) {
+                if (cell?.f) return `${spreadsheetCellAddress(row, column)} 包含独立公式`;
+            }
+        }
+    }
+    if (Object.values(sheet.config?.merge ?? {}).some((merge)=>rangesOverlap(bounds, {
+            startRow: merge.r,
+            endRow: merge.r + merge.rs - 1,
+            startColumn: merge.c,
+            endColumn: merge.c + merge.cs - 1
+        }))) return '范围内包含合并单元格';
+    if ('data-table' !== range.type && !anchorCell.f) return '锚点公式已被删除';
+    return null;
+}
+function spreadsheetFormulaFunctions(formula) {
+    const withoutStrings = formula.replace(/"(?:[^"]|"")*"/g, '""');
+    const functions = new Set();
+    for (const match of withoutStrings.matchAll(/(?:_xlfn\.)?(?:_xlws\.)?([A-Z][A-Z0-9_.]*)\s*\(/gi))if (match[1]) functions.add(match[1].toUpperCase());
+    return Array.from(functions);
+}
+function formulaHasExternalReference(formula) {
+    return /\[[^\]]+\][^!]*!/i.test(formula.replace(/"(?:[^"]|"")*"/g, '""'));
+}
+function formulaHasStructuredReference(formula) {
+    const withoutExternalReferences = formula.replace(/"(?:[^"]|"")*"/g, '""').replace(/\[[^\]]+\][^!]*!/gi, '');
+    return /\[(?:@|#)[^\]]+\]/i.test(withoutExternalReferences) || /\b[A-Z_\\][A-Z0-9_.]*\s*\[[^\]]+\]/i.test(withoutExternalReferences);
+}
+function volatileSpreadsheetFormulaFunctions(formula) {
+    return spreadsheetFormulaFunctions(formula).filter((name)=>VOLATILE_FUNCTIONS.has(name));
+}
+function spreadsheetCellAddress(row, column) {
+    let value = column + 1;
+    let label = '';
+    while(value > 0){
+        value -= 1;
+        label = String.fromCharCode(65 + value % 26) + label;
+        value = Math.floor(value / 26);
+    }
+    return `${label}${row + 1}`;
+}
+function parseSpreadsheetFormulaRange(reference) {
+    const normalized = reference.trim().replaceAll('$', '').split('!').at(-1) ?? '';
+    const [startText, endText = startText] = normalized.split(':');
+    const start = parseSpreadsheetCellAddress(startText);
+    const end = parseSpreadsheetCellAddress(endText);
+    if (!start || !end) return null;
+    return {
+        startRow: Math.min(start.row, end.row),
+        endRow: Math.max(start.row, end.row),
+        startColumn: Math.min(start.column, end.column),
+        endColumn: Math.max(start.column, end.column)
+    };
+}
+function parseSpreadsheetCellAddress(address) {
+    const match = /^([A-Z]{1,3})([1-9]\d*)$/i.exec(address.trim().replaceAll('$', ''));
+    if (!match) return null;
+    let column = 0;
+    for (const character of match[1].toUpperCase())column = 26 * column + character.charCodeAt(0) - 64;
+    const row = Number(match[2]) - 1;
+    if (row > 1048575 || column > 16384) return null;
+    return {
+        row,
+        column: column - 1
+    };
+}
+function containsCell(bounds, row, column) {
+    return row >= bounds.startRow && row <= bounds.endRow && column >= bounds.startColumn && column <= bounds.endColumn;
+}
+function rangesOverlap(first, second) {
+    if (!second) return false;
+    return first.startRow <= second.endRow && first.endRow >= second.startRow && first.startColumn <= second.endColumn && first.endColumn >= second.startColumn;
+}
+function comparableFormula(formula) {
+    return editableSpreadsheetFormula(formula).trim();
+}
+function futureFunctionPrefixes(formula, sourceFormula) {
+    const sourcePrefixes = new Map();
+    const sourceFunctions = (sourceFormula ?? '').replace(/"(?:[^"]|"")*"/g, '""');
+    for (const match of sourceFunctions.matchAll(/(_xlfn\.(?:_xlws\.)?)([A-Z][A-Z0-9_.]*)\s*(?=\()/gi))if (match[1] && match[2]) sourcePrefixes.set(match[2].toUpperCase(), match[1]);
+    return transformFormulaOutsideStrings(formula, (segment)=>segment.replace(/(?<![A-Z0-9_.])([A-Z][A-Z0-9_.]*)\s*(?=\()/gi, (match, functionName)=>{
+            const normalized = functionName.toUpperCase();
+            const prefix = sourcePrefixes.get(normalized) ?? FUTURE_FUNCTION_PREFIXES.get(normalized);
+            return prefix ? `${prefix}${match}` : match;
+        }));
+}
+function clampedInteger(value, minimum, maximum, fallback) {
+    if (!Number.isFinite(value)) return fallback;
+    return Math.min(maximum, Math.max(minimum, Math.round(value)));
+}
+function positiveNumber(value, fallback) {
+    return Number.isFinite(value) && value > 0 ? value : fallback;
+}
+function transformFormulaOutsideStrings(formula, transform) {
+    return formula.split(/("(?:[^"]|"")*")/).map((segment, index)=>index % 2 ? segment : transform(segment)).join('');
+}
 const CELL_REFERENCE = /\$?([A-Z]{1,3})\$?([1-9]\d*)/i;
 const CELL_OR_RANGE = new RegExp(`^${CELL_REFERENCE.source}(?::${CELL_REFERENCE.source})?$`, 'i');
 const COLUMN_RANGE = /^\$?([A-Z]{1,3}):\$?([A-Z]{1,3})$/i;
@@ -126,79 +391,34 @@ function splitRangeList(value) {
     if (current.trim()) parts.push(current.trim());
     return parts;
 }
-function unqualifiedReference(value) {
-    const reference = value.trim().replace(/^=/, '');
-    const separator = reference.lastIndexOf('!');
-    return separator >= 0 ? reference.slice(separator + 1) : reference;
-}
-function decodeCell(column, row) {
-    return {
-        row: Math.max(0, Number(row) - 1),
-        column: decodeColumn(column)
-    };
-}
-function decodeColumn(value) {
-    let result = 0;
-    for (const character of value.toUpperCase())result = 26 * result + character.charCodeAt(0) - 64;
-    return Math.max(0, result - 1);
-}
-function encodeCell(row, column) {
-    return `${encodeColumn(column)}${Math.max(0, row) + 1}`;
-}
-function encodeColumn(column) {
-    let value = Math.max(0, column) + 1;
-    let label = '';
-    while(value > 0){
-        value -= 1;
-        label = String.fromCharCode(65 + value % 26) + label;
-        value = Math.floor(value / 26);
-    }
-    return label;
-}
-function sparseArrayIndexes(values) {
-    if (!values) return [];
-    return Object.keys(values).flatMap((key)=>{
-        const index = Number(key);
-        return Number.isSafeInteger(index) && index >= 0 && index < values.length ? [
-            index
-        ] : [];
-    });
-}
-function sparseArrayEntries(values) {
-    if (!values) return [];
-    return sparseArrayIndexes(values).flatMap((index)=>{
-        const value = values[index];
-        return void 0 === value ? [] : [
-            [
-                index,
-                value
-            ]
-        ];
-    });
-}
-function sparseMatrixColumnCount(matrix) {
-    let maximum = 0;
-    for (const [, row] of sparseArrayEntries(matrix))maximum = Math.max(maximum, row.length);
-    return maximum;
+function unqualifiedReference(value) {
+    const reference = value.trim().replace(/^=/, '');
+    const separator = reference.lastIndexOf('!');
+    return separator >= 0 ? reference.slice(separator + 1) : reference;
 }
-function spreadsheetGridSize(sheet) {
-    if (!sheet) return null;
+function decodeCell(column, row) {
     return {
-        rowCount: Math.max(sheet.row ?? 0, sheet.data?.length ?? 0),
-        columnCount: Math.max(sheet.column ?? 0, sparseMatrixColumnCount(sheet.data))
+        row: Math.max(0, Number(row) - 1),
+        column: decodeColumn(column)
     };
 }
-function cloneSparseMatrix(source) {
-    const clone = [];
-    if (!source) return clone;
-    clone.length = source.length;
-    for (const [rowIndex, sourceRow] of sparseArrayEntries(source)){
-        const row = [];
-        row.length = sourceRow.length;
-        for (const columnIndex of sparseArrayIndexes(sourceRow))row[columnIndex] = sourceRow[columnIndex];
-        clone[rowIndex] = row;
+function decodeColumn(value) {
+    let result = 0;
+    for (const character of value.toUpperCase())result = 26 * result + character.charCodeAt(0) - 64;
+    return Math.max(0, result - 1);
+}
+function encodeCell(row, column) {
+    return `${encodeColumn(column)}${Math.max(0, row) + 1}`;
+}
+function encodeColumn(column) {
+    let value = Math.max(0, column) + 1;
+    let label = '';
+    while(value > 0){
+        value -= 1;
+        label = String.fromCharCode(65 + value % 26) + label;
+        value = Math.floor(value / 26);
     }
-    return clone;
+    return label;
 }
 function spreadsheetPivotCellValue(cell) {
     return cell?.v ?? cell?.m ?? null;
@@ -723,13 +943,13 @@ function spreadsheetPivotValidation(content, ownerSheetId, pivot) {
 function spreadsheetPivotOutputContains(sheet, row, column) {
     return (sheet.pivotTables ?? []).some((pivot)=>{
         const bounds = singleRange(pivot.outputReference ?? '');
-        return Boolean(bounds && containsCell(bounds, row, column));
+        return Boolean(bounds && work_spreadsheet_pivots_containsCell(bounds, row, column));
     });
 }
 function spreadsheetPivotIntersects(sheet, range) {
     return (sheet.pivotTables ?? []).filter((pivot)=>{
         const bounds = singleRange(pivot.outputReference ?? '');
-        return Boolean(bounds && rangesOverlap(bounds, range));
+        return Boolean(bounds && work_spreadsheet_pivots_rangesOverlap(bounds, range));
     });
 }
 function resolvePivot(content, ownerSheetId, pivot) {
@@ -751,14 +971,14 @@ function resolvePivot(content, ownerSheetId, pivot) {
     const outputReference = formatBounds(outputBounds);
     if (output.length * output[0].length > MAXIMUM_OUTPUT_CELLS) return null;
     if (outputBounds.endRow > MAXIMUM_XLSX_ROW || outputBounds.endColumn > MAXIMUM_XLSX_COLUMN) return null;
-    if (ownerSheet.id === sourceSheet.id && rangesOverlap(sourceBounds, outputBounds)) return null;
+    if (ownerSheet.id === sourceSheet.id && work_spreadsheet_pivots_rangesOverlap(sourceBounds, outputBounds)) return null;
     const oldOutput = singleRange(pivot.outputReference ?? '');
     for (const other of ownerSheet.pivotTables ?? []){
         if (other.id === pivot.id) continue;
         const otherOutput = singleRange(other.outputReference ?? '');
-        if (otherOutput && rangesOverlap(otherOutput, outputBounds)) return null;
+        if (otherOutput && work_spreadsheet_pivots_rangesOverlap(otherOutput, outputBounds)) return null;
     }
-    for(let row = outputBounds.startRow; row <= outputBounds.endRow; row += 1)for(let column = outputBounds.startColumn; column <= outputBounds.endColumn; column += 1)if (!(oldOutput && containsCell(oldOutput, row, column))) {
+    for(let row = outputBounds.startRow; row <= outputBounds.endRow; row += 1)for(let column = outputBounds.startColumn; column <= outputBounds.endColumn; column += 1)if (!(oldOutput && work_spreadsheet_pivots_containsCell(oldOutput, row, column))) {
         if (ownerSheet.data?.[row]?.[column]) return null;
     }
     return {
@@ -805,8 +1025,8 @@ function pivotFailure(content, ownerSheetId, pivot) {
         endColumn: anchor.startColumn + output[0].length - 1
     };
     if (outputBounds.endRow > MAXIMUM_XLSX_ROW || outputBounds.endColumn > MAXIMUM_XLSX_COLUMN) return invalid('pivot.output-out-of-bounds', '透视表结果超出 XLSX 工作表边界。');
-    if (ownerSheet.id === sourceSheet.id && rangesOverlap(sourceBounds, outputBounds)) return invalid('pivot.output-overlaps-source', '透视表输出区域与源数据重叠，请改用其他位置或工作表。');
-    if (Object.values(ownerSheet.config?.merge ?? {}).some((merge)=>rangesOverlap(outputBounds, {
+    if (ownerSheet.id === sourceSheet.id && work_spreadsheet_pivots_rangesOverlap(sourceBounds, outputBounds)) return invalid('pivot.output-overlaps-source', '透视表输出区域与源数据重叠，请改用其他位置或工作表。');
+    if (Object.values(ownerSheet.config?.merge ?? {}).some((merge)=>work_spreadsheet_pivots_rangesOverlap(outputBounds, {
             startRow: merge.r,
             endRow: merge.r + merge.rs - 1,
             startColumn: merge.c,
@@ -816,9 +1036,9 @@ function pivotFailure(content, ownerSheetId, pivot) {
     for (const other of ownerSheet.pivotTables ?? []){
         if (other.id === pivot.id) continue;
         const otherOutput = singleRange(other.outputReference ?? '');
-        if (otherOutput && rangesOverlap(otherOutput, outputBounds)) return invalid('pivot.output-overlaps-pivot', '透视表输出区域与另一个透视表重叠。');
+        if (otherOutput && work_spreadsheet_pivots_rangesOverlap(otherOutput, outputBounds)) return invalid('pivot.output-overlaps-pivot', '透视表输出区域与另一个透视表重叠。');
     }
-    for(let row = outputBounds.startRow; row <= outputBounds.endRow; row += 1)for(let column = outputBounds.startColumn; column <= outputBounds.endColumn; column += 1)if (!(oldOutput && containsCell(oldOutput, row, column))) {
+    for(let row = outputBounds.startRow; row <= outputBounds.endRow; row += 1)for(let column = outputBounds.startColumn; column <= outputBounds.endColumn; column += 1)if (!(oldOutput && work_spreadsheet_pivots_containsCell(oldOutput, row, column))) {
         if (ownerSheet.data?.[row]?.[column]) return invalid('pivot.output-not-empty', '透视表输出区域包含现有内容，请选择空白位置。');
     }
     return null;
@@ -846,10 +1066,10 @@ function selectionBounds(selection) {
         endColumn: Math.max(0, Math.max(selection.column[0], selection.column[1]))
     };
 }
-function containsCell(bounds, row, column) {
+function work_spreadsheet_pivots_containsCell(bounds, row, column) {
     return row >= bounds.startRow && row <= bounds.endRow && column >= bounds.startColumn && column <= bounds.endColumn;
 }
-function rangesOverlap(left, right) {
+function work_spreadsheet_pivots_rangesOverlap(left, right) {
     return left.startRow <= right.endRow && left.endRow >= right.startRow && left.startColumn <= right.endColumn && left.endColumn >= right.startColumn;
 }
 function formatBounds(bounds) {
@@ -905,226 +1125,6 @@ function invalid(code, message) {
         message
     };
 }
-const DEFAULT_SPREADSHEET_CALCULATION_SETTINGS = {
-    mode: 'automatic',
-    fullCalculationOnLoad: false,
-    forceFullCalculation: false,
-    iterativeCalculation: false,
-    maximumIterations: 100,
-    maximumChange: 0.001,
-    fullPrecision: true
-};
-const VOLATILE_FUNCTIONS = new Set([
-    'CELL',
-    'INFO',
-    'INDIRECT',
-    'NOW',
-    'OFFSET',
-    'RAND',
-    'RANDBETWEEN',
-    'TODAY'
-]);
-const FUTURE_FUNCTIONS = new Set([
-    'ARRAYTOTEXT',
-    'BYCOL',
-    'BYROW',
-    'CHOOSECOLS',
-    'CHOOSEROWS',
-    'DROP',
-    'EXPAND',
-    'FIELDVALUE',
-    'FILTER',
-    'HSTACK',
-    'IMAGE',
-    'ISOMITTED',
-    'LAMBDA',
-    'LET',
-    'MAKEARRAY',
-    'MAP',
-    'RANDARRAY',
-    'REDUCE',
-    'SCAN',
-    'SEQUENCE',
-    'SORT',
-    'SORTBY',
-    'STOCKHISTORY',
-    'TAKE',
-    'TEXTAFTER',
-    'TEXTBEFORE',
-    'TEXTSPLIT',
-    'TOCOL',
-    'TOROW',
-    'UNIQUE',
-    'VALUETOTEXT',
-    'VSTACK',
-    'WRAPCOLS',
-    'WRAPROWS',
-    'XLOOKUP',
-    'XMATCH'
-]);
-const FUTURE_FUNCTION_PREFIXES = new Map([
-    [
-        'FILTER',
-        '_xlfn._xlws.'
-    ],
-    [
-        'SORT',
-        '_xlfn._xlws.'
-    ],
-    [
-        'SORTBY',
-        '_xlfn._xlws.'
-    ],
-    [
-        'UNIQUE',
-        '_xlfn.'
-    ],
-    ...Array.from(FUTURE_FUNCTIONS).filter((name)=>![
-            'FILTER',
-            'SORT',
-            'SORTBY',
-            'UNIQUE'
-        ].includes(name)).map((name)=>[
-            name,
-            '_xlfn.'
-        ])
-]);
-function effectiveSpreadsheetCalculationSettings(settings) {
-    if (!settings) return {
-        ...DEFAULT_SPREADSHEET_CALCULATION_SETTINGS
-    };
-    return {
-        mode: settings.mode,
-        fullCalculationOnLoad: Boolean(settings.fullCalculationOnLoad),
-        forceFullCalculation: Boolean(settings.forceFullCalculation),
-        iterativeCalculation: Boolean(settings.iterativeCalculation),
-        maximumIterations: clampedInteger(settings.maximumIterations, 1, 10000, 100),
-        maximumChange: positiveNumber(settings.maximumChange, 0.001),
-        fullPrecision: false !== settings.fullPrecision
-    };
-}
-function editableSpreadsheetFormula(source) {
-    return transformFormulaOutsideStrings(source, (segment)=>segment.replace(/_xlfn\._xlws\.(?=[A-Z][A-Z0-9_.]*\s*\()/gi, '').replace(/_xlfn\.(?=[A-Z][A-Z0-9_.]*\s*\()/gi, '').replace(/_xlws\.(?=[A-Z][A-Z0-9_.]*\s*\()/gi, ''));
-}
-function spreadsheetFormulaForXlsx(currentFormula, sourceFormula) {
-    const current = currentFormula.trim().replace(/^=/, '');
-    const source = sourceFormula?.trim().replace(/^=/, '');
-    if (source && comparableFormula(source) === comparableFormula(current)) return source;
-    return futureFunctionPrefixes(current, source);
-}
-function spreadsheetFormulaRangeForCell(sheet, row, column) {
-    const address = spreadsheetCellAddress(row, column);
-    return (sheet.formulaMetadata?.ranges ?? []).find((range)=>range.anchor.toUpperCase().replaceAll('$', '') === address);
-}
-function spreadsheetFormulaRangesForSelection(sheet, selection) {
-    return (sheet.formulaMetadata?.ranges ?? []).filter((range)=>work_spreadsheet_formulas_rangesOverlap(selection, parseSpreadsheetFormulaRange(range.reference)));
-}
-function spreadsheetFormulaRangeConflict(sheet, range) {
-    const bounds = parseSpreadsheetFormulaRange(range.reference);
-    if (!bounds) return '引用范围无效';
-    const anchor = parseSpreadsheetCellAddress(range.anchor);
-    if (!anchor || !work_spreadsheet_formulas_containsCell(bounds, anchor.row, anchor.column)) return '锚点不在引用范围内';
-    const anchorCell = sheet.data?.[anchor.row]?.[anchor.column];
-    if (!anchorCell) return '锚点单元格不存在';
-    const overlaps = (sheet.formulaMetadata?.ranges ?? []).filter((candidate)=>candidate !== range && work_spreadsheet_formulas_rangesOverlap(bounds, parseSpreadsheetFormulaRange(candidate.reference)));
-    if (overlaps.length) return '与其他公式范围重叠';
-    for (const [row, cells] of sparseArrayEntries(sheet.data))if (!(row < bounds.startRow) && !(row > bounds.endRow)) {
-        for (const [column, cell] of sparseArrayEntries(cells))if (!(column < bounds.startColumn) && !(column > bounds.endColumn)) {
-            if (row !== anchor.row || column !== anchor.column) {
-                if (cell?.f) return `${spreadsheetCellAddress(row, column)} 包含独立公式`;
-            }
-        }
-    }
-    if (Object.values(sheet.config?.merge ?? {}).some((merge)=>work_spreadsheet_formulas_rangesOverlap(bounds, {
-            startRow: merge.r,
-            endRow: merge.r + merge.rs - 1,
-            startColumn: merge.c,
-            endColumn: merge.c + merge.cs - 1
-        }))) return '范围内包含合并单元格';
-    if ('data-table' !== range.type && !anchorCell.f) return '锚点公式已被删除';
-    return null;
-}
-function spreadsheetFormulaFunctions(formula) {
-    const withoutStrings = formula.replace(/"(?:[^"]|"")*"/g, '""');
-    const functions = new Set();
-    for (const match of withoutStrings.matchAll(/(?:_xlfn\.)?(?:_xlws\.)?([A-Z][A-Z0-9_.]*)\s*\(/gi))if (match[1]) functions.add(match[1].toUpperCase());
-    return Array.from(functions);
-}
-function formulaHasExternalReference(formula) {
-    return /\[[^\]]+\][^!]*!/i.test(formula.replace(/"(?:[^"]|"")*"/g, '""'));
-}
-function formulaHasStructuredReference(formula) {
-    const withoutExternalReferences = formula.replace(/"(?:[^"]|"")*"/g, '""').replace(/\[[^\]]+\][^!]*!/gi, '');
-    return /\[(?:@|#)[^\]]+\]/i.test(withoutExternalReferences) || /\b[A-Z_\\][A-Z0-9_.]*\s*\[[^\]]+\]/i.test(withoutExternalReferences);
-}
-function volatileSpreadsheetFormulaFunctions(formula) {
-    return spreadsheetFormulaFunctions(formula).filter((name)=>VOLATILE_FUNCTIONS.has(name));
-}
-function spreadsheetCellAddress(row, column) {
-    let value = column + 1;
-    let label = '';
-    while(value > 0){
-        value -= 1;
-        label = String.fromCharCode(65 + value % 26) + label;
-        value = Math.floor(value / 26);
-    }
-    return `${label}${row + 1}`;
-}
-function parseSpreadsheetFormulaRange(reference) {
-    const normalized = reference.trim().replaceAll('$', '').split('!').at(-1) ?? '';
-    const [startText, endText = startText] = normalized.split(':');
-    const start = parseSpreadsheetCellAddress(startText);
-    const end = parseSpreadsheetCellAddress(endText);
-    if (!start || !end) return null;
-    return {
-        startRow: Math.min(start.row, end.row),
-        endRow: Math.max(start.row, end.row),
-        startColumn: Math.min(start.column, end.column),
-        endColumn: Math.max(start.column, end.column)
-    };
-}
-function parseSpreadsheetCellAddress(address) {
-    const match = /^([A-Z]{1,3})([1-9]\d*)$/i.exec(address.trim().replaceAll('$', ''));
-    if (!match) return null;
-    let column = 0;
-    for (const character of match[1].toUpperCase())column = 26 * column + character.charCodeAt(0) - 64;
-    const row = Number(match[2]) - 1;
-    if (row > 1048575 || column > 16384) return null;
-    return {
-        row,
-        column: column - 1
-    };
-}
-function work_spreadsheet_formulas_containsCell(bounds, row, column) {
-    return row >= bounds.startRow && row <= bounds.endRow && column >= bounds.startColumn && column <= bounds.endColumn;
-}
-function work_spreadsheet_formulas_rangesOverlap(first, second) {
-    if (!second) return false;
-    return first.startRow <= second.endRow && first.endRow >= second.startRow && first.startColumn <= second.endColumn && first.endColumn >= second.startColumn;
-}
-function comparableFormula(formula) {
-    return editableSpreadsheetFormula(formula).trim();
-}
-function futureFunctionPrefixes(formula, sourceFormula) {
-    const sourcePrefixes = new Map();
-    const sourceFunctions = (sourceFormula ?? '').replace(/"(?:[^"]|"")*"/g, '""');
-    for (const match of sourceFunctions.matchAll(/(_xlfn\.(?:_xlws\.)?)([A-Z][A-Z0-9_.]*)\s*(?=\()/gi))if (match[1] && match[2]) sourcePrefixes.set(match[2].toUpperCase(), match[1]);
-    return transformFormulaOutsideStrings(formula, (segment)=>segment.replace(/(?<![A-Z0-9_.])([A-Z][A-Z0-9_.]*)\s*(?=\()/gi, (match, functionName)=>{
-            const normalized = functionName.toUpperCase();
-            const prefix = sourcePrefixes.get(normalized) ?? FUTURE_FUNCTION_PREFIXES.get(normalized);
-            return prefix ? `${prefix}${match}` : match;
-        }));
-}
-function clampedInteger(value, minimum, maximum, fallback) {
-    if (!Number.isFinite(value)) return fallback;
-    return Math.min(maximum, Math.max(minimum, Math.round(value)));
-}
-function positiveNumber(value, fallback) {
-    return Number.isFinite(value) && value > 0 ? value : fallback;
-}
-function transformFormulaOutsideStrings(formula, transform) {
-    return formula.split(/("(?:[^"]|"")*")/).map((segment, index)=>index % 2 ? segment : transform(segment)).join('');
-}
 const XLSX_EMU_PER_PIXEL = 9525;
 const DEFAULT_COLUMN_WIDTH = 96;
 const DEFAULT_ROW_HEIGHT = 24;