@bilig/formula 0.8.0 → 0.8.1

package/dist/formula-reference-translation.js

@@ -0,0 +1,273 @@
+import { formatRangeAddress, parseCellAddress, parseRangeAddress } from './addressing.js';
+import { formatAxisReference, formatCellReference, parseAxisReferenceParts, parseCellReferenceParts, quoteSheetNameIfNeeded, } from './translation-reference-utils.js';
+export function translateParsedCellReference(reference, rowDelta, colDelta) {
+    const parts = reference.rowAbsolute !== undefined && reference.colAbsolute !== undefined && reference.row !== undefined && reference.col !== undefined
+        ? {
+            row: reference.row,
+            col: reference.col,
+            rowAbsolute: reference.rowAbsolute,
+            colAbsolute: reference.colAbsolute,
+        }
+        : parseCellReferenceParts(reference.address);
+    if (!parts) {
+        return reference;
+    }
+    const nextRow = parts.rowAbsolute ? parts.row : parts.row + rowDelta;
+    const nextCol = parts.colAbsolute ? parts.col : parts.col + colDelta;
+    const nextLocalAddress = formatCellReference(parts, nextRow, nextCol);
+    const nextAddress = reference.explicitSheet || reference.sheetName !== undefined
+        ? formatQualifiedCellReference(reference.sheetName, nextLocalAddress)
+        : nextLocalAddress;
+    return {
+        ...reference,
+        address: nextAddress,
+        ...(reference.sheetName !== undefined ? { sheetName: reference.sheetName } : {}),
+        ...(reference.explicitSheet !== undefined ? { explicitSheet: reference.explicitSheet } : {}),
+        ...(reference.row !== undefined ? { row: nextRow } : {}),
+        ...(reference.col !== undefined ? { col: nextCol } : {}),
+        ...(reference.rowAbsolute !== undefined ? { rowAbsolute: parts.rowAbsolute } : {}),
+        ...(reference.colAbsolute !== undefined ? { colAbsolute: parts.colAbsolute } : {}),
+    };
+}
+export function translateParsedRangeReference(reference, rowDelta, colDelta) {
+    const nextRange = translateParsedRangeReferenceInfo(reference, rowDelta, colDelta);
+    const bounds = nextRange.refKind === 'cells'
+        ? {
+            startRow: nextRange.startRow,
+            endRow: nextRange.endRow,
+            startCol: nextRange.startCol,
+            endCol: nextRange.endCol,
+        }
+        : nextRange.refKind === 'rows'
+            ? {
+                startRow: nextRange.startRow,
+                endRow: nextRange.endRow,
+                startCol: 0,
+                endCol: 0,
+            }
+            : {
+                startRow: 0,
+                endRow: 0,
+                startCol: nextRange.startCol,
+                endCol: nextRange.endCol,
+            };
+    return {
+        ...reference,
+        address: formatParsedRangeReference(nextRange),
+        refKind: nextRange.refKind,
+        startAddress: nextRange.startAddress,
+        endAddress: nextRange.endAddress,
+        ...bounds,
+        ...(reference.explicitSheet !== undefined ? { explicitSheet: reference.explicitSheet } : {}),
+    };
+}
+export function translateParsedDependencyReference(reference, rowDelta, colDelta) {
+    return reference.kind === 'cell'
+        ? translateParsedCellReference(reference, rowDelta, colDelta)
+        : translateParsedRangeReference(reference, rowDelta, colDelta);
+}
+export function translateQualifiedCellReference(raw, rowDelta, colDelta) {
+    const explicitlyQualified = raw.includes('!');
+    const parsed = parseCellAddress(raw);
+    const nextAddress = translateCellReference(parsed.text, rowDelta, colDelta);
+    return explicitlyQualified ? formatQualifiedCellReference(parsed.sheetName, nextAddress) : nextAddress;
+}
+export function formatParsedCellReference(reference) {
+    const localAddress = formatParsedLocalCellReference(reference);
+    return reference.explicitSheet || reference.sheetName !== undefined
+        ? formatQualifiedCellReference(reference.sheetName, localAddress)
+        : localAddress;
+}
+export function formatParsedLocalCellReference(reference) {
+    const parts = reference.row !== undefined && reference.col !== undefined && reference.rowAbsolute !== undefined && reference.colAbsolute !== undefined
+        ? {
+            row: reference.row,
+            col: reference.col,
+            rowAbsolute: reference.rowAbsolute,
+            colAbsolute: reference.colAbsolute,
+        }
+        : parseCellReferenceParts(reference.address);
+    if (!parts) {
+        return stripSheetQualifier(reference.address);
+    }
+    return formatCellReference(parts, parts.row, parts.col);
+}
+export function formatParsedRangeReference(reference) {
+    return formatQualifiedRangeReference(reference.explicitSheet ? reference.sheetName : undefined, reference.startAddress, reference.endAddress);
+}
+export function translatedCellInstructionKey(sheetName, address) {
+    return `${sheetName ?? ''}\t${address}`;
+}
+export function translatedRangeInstructionKey(sheetName, refKind, start, end) {
+    return `${sheetName ?? ''}\t${refKind}\t${start}\t${end}`;
+}
+export function buildTranslatedCellReferenceMap(original, translated) {
+    const output = new Map();
+    if (!original || !translated || original.length !== translated.length) {
+        return output;
+    }
+    for (let index = 0; index < original.length; index += 1) {
+        const source = original[index];
+        const target = translated[index];
+        if (!source || !target) {
+            continue;
+        }
+        output.set(translatedCellInstructionKey(source.sheetName, formatParsedLocalCellReference(source)), target);
+    }
+    return output;
+}
+export function buildTranslatedRangeReferenceMap(original, translated) {
+    const output = new Map();
+    if (!original || !translated || original.length !== translated.length) {
+        return output;
+    }
+    for (let index = 0; index < original.length; index += 1) {
+        const source = original[index];
+        const target = translated[index];
+        if (!source || !target) {
+            continue;
+        }
+        output.set(translatedRangeInstructionKey(source.sheetName, source.refKind, source.startAddress, source.endAddress), target);
+    }
+    return output;
+}
+export function formatParsedDependencyReference(reference) {
+    return reference.kind === 'cell' ? formatParsedCellReference(reference) : formatParsedRangeReference(reference);
+}
+export function translateQualifiedDependencyReference(raw, rowDelta, colDelta) {
+    if (!raw.includes(':')) {
+        return translateQualifiedCellReference(raw, rowDelta, colDelta);
+    }
+    return translateQualifiedRangeReference(raw, rowDelta, colDelta);
+}
+export function translateQualifiedRangeReference(raw, rowDelta, colDelta) {
+    const explicitlyQualified = raw.includes('!');
+    const parsed = parseRangeAddress(raw);
+    const nextRange = translateRangeAddress(parsed, rowDelta, colDelta);
+    if (explicitlyQualified) {
+        return formatRangeAddress(nextRange);
+    }
+    return `${nextRange.start.text}:${nextRange.end.text}`;
+}
+export function translateRangeAddress(range, rowDelta, colDelta) {
+    switch (range.kind) {
+        case 'cells': {
+            const startAddress = translateCellReference(range.start.text, rowDelta, colDelta);
+            const endAddress = translateCellReference(range.end.text, rowDelta, colDelta);
+            return parseRangeAddress(formatQualifiedRangeReference(range.sheetName, startAddress, endAddress));
+        }
+        case 'rows': {
+            const start = translateRowReference(range.start.text, rowDelta);
+            const end = translateRowReference(range.end.text, rowDelta);
+            return parseRangeAddress(formatQualifiedRangeReference(range.sheetName, start, end));
+        }
+        case 'cols': {
+            const start = translateColumnReference(range.start.text, colDelta);
+            const end = translateColumnReference(range.end.text, colDelta);
+            return parseRangeAddress(formatQualifiedRangeReference(range.sheetName, start, end));
+        }
+    }
+}
+export function translateCellReference(ref, rowDelta, colDelta) {
+    const parsed = parseCellReferenceParts(ref);
+    if (!parsed) {
+        throw new Error(`Invalid cell reference '${ref}'`);
+    }
+    const nextCol = parsed.colAbsolute ? parsed.col : parsed.col + colDelta;
+    const nextRow = parsed.rowAbsolute ? parsed.row : parsed.row + rowDelta;
+    if (nextCol < 0 || nextRow < 0) {
+        throw new Error(`Translated reference moved outside worksheet bounds: ${ref}`);
+    }
+    return formatCellReference(parsed, nextRow, nextCol);
+}
+export function translateColumnReference(ref, colDelta) {
+    const parsed = parseAxisReferenceParts(ref, 'column');
+    if (!parsed) {
+        throw new Error(`Invalid column reference '${ref}'`);
+    }
+    const nextCol = parsed.absolute ? parsed.index : parsed.index + colDelta;
+    if (nextCol < 0) {
+        throw new Error(`Translated reference moved outside worksheet bounds: ${ref}`);
+    }
+    return formatAxisReference(parsed.absolute, nextCol, 'column');
+}
+export function translateRowReference(ref, rowDelta) {
+    const parsed = parseAxisReferenceParts(ref, 'row');
+    if (!parsed) {
+        throw new Error(`Invalid row reference '${ref}'`);
+    }
+    const nextRow = parsed.absolute ? parsed.index : parsed.index + rowDelta;
+    if (nextRow < 0) {
+        throw new Error(`Translated reference moved outside worksheet bounds: ${ref}`);
+    }
+    return formatAxisReference(parsed.absolute, nextRow, 'row');
+}
+function translateParsedRangeReferenceInfo(reference, rowDelta, colDelta) {
+    if (reference.refKind === 'cells') {
+        const startRow = (reference.startRowAbsolute ?? false) ? reference.startRow : reference.startRow + rowDelta;
+        const endRow = (reference.endRowAbsolute ?? false) ? reference.endRow : reference.endRow + rowDelta;
+        const startCol = (reference.startColAbsolute ?? false) ? reference.startCol : reference.startCol + colDelta;
+        const endCol = (reference.endColAbsolute ?? false) ? reference.endCol : reference.endCol + colDelta;
+        const startAddress = formatCellReference({
+            row: reference.startRow,
+            col: reference.startCol,
+            rowAbsolute: reference.startRowAbsolute ?? false,
+            colAbsolute: reference.startColAbsolute ?? false,
+        }, startRow, startCol);
+        const endAddress = formatCellReference({
+            row: reference.endRow,
+            col: reference.endCol,
+            rowAbsolute: reference.endRowAbsolute ?? false,
+            colAbsolute: reference.endColAbsolute ?? false,
+        }, endRow, endCol);
+        return {
+            ...reference,
+            startAddress,
+            endAddress,
+            startRow,
+            endRow,
+            startCol,
+            endCol,
+        };
+    }
+    if (reference.refKind === 'rows') {
+        const startRow = (reference.startRowAbsolute ?? false) ? reference.startRow : reference.startRow + rowDelta;
+        const endRow = (reference.endRowAbsolute ?? false) ? reference.endRow : reference.endRow + rowDelta;
+        return {
+            ...reference,
+            startAddress: formatAxisReference(reference.startRowAbsolute ?? false, startRow, 'row'),
+            endAddress: formatAxisReference(reference.endRowAbsolute ?? false, endRow, 'row'),
+            startRow,
+            endRow,
+            startCol: 0,
+            endCol: 0,
+        };
+    }
+    const startCol = (reference.startColAbsolute ?? false) ? reference.startCol : reference.startCol + colDelta;
+    const endCol = (reference.endColAbsolute ?? false) ? reference.endCol : reference.endCol + colDelta;
+    return {
+        ...reference,
+        startAddress: formatAxisReference(reference.startColAbsolute ?? false, startCol, 'column'),
+        endAddress: formatAxisReference(reference.endColAbsolute ?? false, endCol, 'column'),
+        startRow: 0,
+        endRow: 0,
+        startCol,
+        endCol,
+    };
+}
+function stripSheetQualifier(reference) {
+    const bang = reference.lastIndexOf('!');
+    return bang === -1 ? reference : reference.slice(bang + 1);
+}
+function formatQualifiedCellReference(sheetName, address) {
+    if (!sheetName) {
+        return address;
+    }
+    const parsed = parseCellAddress(address, sheetName);
+    return `${quoteSheetNameIfNeeded(sheetName)}!${parsed.text}`;
+}
+function formatQualifiedRangeReference(sheetName, start, end) {
+    const prefix = sheetName ? `${quoteSheetNameIfNeeded(sheetName)}!` : '';
+    return `${prefix}${start}:${end}`;
+}
+//# sourceMappingURL=formula-reference-translation.js.map

package/dist/formula-reference-translation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula-reference-translation.js","sourceRoot":"","sources":["../src/formula-reference-translation.ts"],"names":[],"mappings":"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"}

package/dist/formula-serializer.d.ts

@@ -0,0 +1,2 @@
+import type { FormulaNode } from './ast.js';
+export declare function serializeFormula(node: FormulaNode, parentPrecedence?: number, parentAssociativity?: 'left' | 'right' | null): string;

package/dist/formula-serializer.js

@@ -0,0 +1,74 @@
+import { ErrorCode } from '@bilig/protocol';
+import { formatSheetPrefix } from './translation-reference-utils.js';
+const BINARY_PRECEDENCE = {
+    '=': 1,
+    '<>': 1,
+    '>': 1,
+    '>=': 1,
+    '<': 1,
+    '<=': 1,
+    '&': 2,
+    '+': 3,
+    '-': 3,
+    '*': 4,
+    '/': 4,
+    '^': 5,
+};
+const ERROR_LITERAL_TEXT = {
+    [ErrorCode.Ref]: '#REF!',
+    [ErrorCode.Name]: '#NAME?',
+    [ErrorCode.Div0]: '#DIV/0!',
+    [ErrorCode.NA]: '#N/A',
+    [ErrorCode.Value]: '#VALUE!',
+    [ErrorCode.Cycle]: '#CYCLE!',
+    [ErrorCode.Spill]: '#SPILL!',
+    [ErrorCode.Blocked]: '#BLOCKED!',
+};
+export function serializeFormula(node, parentPrecedence = 0, parentAssociativity = null) {
+    switch (node.kind) {
+        case 'NumberLiteral':
+            return String(node.value);
+        case 'BooleanLiteral':
+            return node.value ? 'TRUE' : 'FALSE';
+        case 'StringLiteral':
+            return `"${node.value.replaceAll('"', '""')}"`;
+        case 'ErrorLiteral':
+            return ERROR_LITERAL_TEXT[node.code] ?? '#ERROR!';
+        case 'NameRef':
+            return node.name;
+        case 'StructuredRef':
+            return `${node.tableName}[${node.columnName}]`;
+        case 'CellRef':
+            return `${formatSheetPrefix(node.sheetName)}${node.ref}`;
+        case 'SpillRef':
+            return `${formatSheetPrefix(node.sheetName)}${node.ref}#`;
+        case 'ColumnRef':
+            return `${formatSheetPrefix(node.sheetName)}${node.ref}`;
+        case 'RowRef':
+            return `${formatSheetPrefix(node.sheetName)}${node.ref}`;
+        case 'RangeRef':
+            return `${formatSheetPrefix(node.sheetName)}${node.start}:${node.end}`;
+        case 'UnaryExpr':
+            return `${node.operator}${serializeFormula(node.argument, 6)}`;
+        case 'CallExpr':
+            return `${node.callee}(${node.args.map((arg) => serializeFormula(arg)).join(',')})`;
+        case 'InvokeExpr': {
+            const callee = node.callee.kind === 'CallExpr' || node.callee.kind === 'InvokeExpr'
+                ? serializeFormula(node.callee)
+                : `(${serializeFormula(node.callee)})`;
+            return `${callee}(${node.args.map((arg) => serializeFormula(arg)).join(',')})`;
+        }
+        case 'BinaryExpr': {
+            const precedence = BINARY_PRECEDENCE[node.operator];
+            const isRightAssociative = node.operator === '^';
+            const left = serializeFormula(node.left, precedence, 'left');
+            const right = serializeFormula(node.right, precedence, 'right');
+            const output = `${left}${node.operator}${right}`;
+            const needsParens = precedence < parentPrecedence ||
+                (precedence === parentPrecedence &&
+                    ((parentAssociativity === 'left' && isRightAssociative) || (parentAssociativity === 'right' && !isRightAssociative)));
+            return needsParens ? `(${output})` : output;
+        }
+    }
+}
+//# sourceMappingURL=formula-serializer.js.map

package/dist/formula-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula-serializer.js","sourceRoot":"","sources":["../src/formula-serializer.ts"],"names":[],"mappings":"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"}

package/dist/formula-sheet-rename.d.ts

@@ -0,0 +1,14 @@
+import type { CompiledFormula } from './compiler.js';
+export interface RenamedCompiledFormula {
+    source: string;
+    compiled: CompiledFormula;
+    reusedProgram: boolean;
+}
+export interface CompiledFormulaSheetRenameMetadataResult {
+    compiled: CompiledFormula;
+    sourceChanged: boolean;
+}
+export declare function renameFormulaSheetReferences(source: string, oldSheetName: string, newSheetName: string): string;
+export declare function renameCompiledFormulaSheetReferences(compiled: CompiledFormula, oldSheetName: string, newSheetName: string): RenamedCompiledFormula;
+export declare function renameCompiledFormulaSheetReferenceMetadata(compiled: CompiledFormula, oldSheetName: string, newSheetName: string): CompiledFormulaSheetRenameMetadataResult;
+export declare function renameCompiledFormulaSheetReferenceMetadataInPlace(compiled: CompiledFormula, oldSheetName: string, newSheetName: string): boolean;

package/dist/formula-sheet-rename.js

@@ -0,0 +1,243 @@
+import { parseFormula } from './parser.js';
+import { serializeFormula } from './formula-serializer.js';
+import { quoteSheetNameIfNeeded } from './translation-reference-utils.js';
+export function renameFormulaSheetReferences(source, oldSheetName, newSheetName) {
+    const ast = parseFormula(source);
+    return serializeFormula(renameNodeSheetReferences(ast, oldSheetName, newSheetName));
+}
+export function renameCompiledFormulaSheetReferences(compiled, oldSheetName, newSheetName) {
+    const currentAst = compiled.astMatchesSource === false ? parseFormula(compiled.source) : compiled.ast;
+    const currentOptimizedAst = compiled.astMatchesSource === false ? currentAst : compiled.optimizedAst === compiled.ast ? currentAst : compiled.optimizedAst;
+    const renamedAst = renameNodeSheetReferences(currentAst, oldSheetName, newSheetName);
+    const renamedOptimizedAst = currentOptimizedAst === currentAst ? renamedAst : renameNodeSheetReferences(currentOptimizedAst, oldSheetName, newSheetName);
+    const source = serializeFormula(renamedAst);
+    return {
+        source,
+        compiled: {
+            ...compiled,
+            source,
+            ast: renamedAst,
+            optimizedAst: renamedOptimizedAst,
+            astMatchesSource: true,
+            deps: compiled.deps.map((dependency) => renameQualifiedReferenceSheet(dependency, oldSheetName, newSheetName)),
+            ...(compiled.parsedDeps
+                ? {
+                    parsedDeps: compiled.parsedDeps.map((dependency) => renameParsedDependencySheet(dependency, oldSheetName, newSheetName)),
+                }
+                : {}),
+            jsPlan: renameJsPlanSheetReferences(compiled.jsPlan, oldSheetName, newSheetName),
+            symbolicRefs: compiled.symbolicRefs.map((reference) => renameQualifiedReferenceSheet(reference, oldSheetName, newSheetName)),
+            ...(compiled.parsedSymbolicRefs
+                ? {
+                    parsedSymbolicRefs: compiled.parsedSymbolicRefs.map((reference) => renameParsedCellReferenceSheet(reference, oldSheetName, newSheetName)),
+                }
+                : {}),
+            symbolicRanges: compiled.symbolicRanges.map((reference) => renameQualifiedReferenceSheet(reference, oldSheetName, newSheetName)),
+            ...(compiled.parsedSymbolicRanges
+                ? {
+                    parsedSymbolicRanges: compiled.parsedSymbolicRanges.map((reference) => renameParsedRangeReferenceSheet(reference, oldSheetName, newSheetName)),
+                }
+                : {}),
+        },
+        reusedProgram: true,
+    };
+}
+function renameArraySheetReferences(values, rename) {
+    let changed = false;
+    const next = values.map((value) => {
+        const renamed = rename(value);
+        if (renamed !== value) {
+            changed = true;
+        }
+        return renamed;
+    });
+    return { values: next, changed };
+}
+export function renameCompiledFormulaSheetReferenceMetadata(compiled, oldSheetName, newSheetName) {
+    const deps = renameArraySheetReferences(compiled.deps, (dependency) => renameQualifiedReferenceSheet(dependency, oldSheetName, newSheetName));
+    const symbolicRefs = renameArraySheetReferences(compiled.symbolicRefs, (reference) => renameQualifiedReferenceSheet(reference, oldSheetName, newSheetName));
+    const symbolicRanges = renameArraySheetReferences(compiled.symbolicRanges, (reference) => renameQualifiedReferenceSheet(reference, oldSheetName, newSheetName));
+    const parsedDeps = compiled.parsedDeps
+        ? renameArraySheetReferences(compiled.parsedDeps, (dependency) => renameParsedDependencySheet(dependency, oldSheetName, newSheetName))
+        : undefined;
+    const parsedSymbolicRefs = compiled.parsedSymbolicRefs
+        ? renameArraySheetReferences(compiled.parsedSymbolicRefs, (reference) => renameParsedCellReferenceSheet(reference, oldSheetName, newSheetName))
+        : undefined;
+    const parsedSymbolicRanges = compiled.parsedSymbolicRanges
+        ? renameArraySheetReferences(compiled.parsedSymbolicRanges, (reference) => renameParsedRangeReferenceSheet(reference, oldSheetName, newSheetName))
+        : undefined;
+    const jsPlan = renameJsPlanSheetReferences(compiled.jsPlan, oldSheetName, newSheetName);
+    return {
+        compiled: {
+            ...compiled,
+            astMatchesSource: false,
+            deps: deps.values,
+            ...(parsedDeps ? { parsedDeps: parsedDeps.values } : {}),
+            jsPlan,
+            symbolicRefs: symbolicRefs.values,
+            ...(parsedSymbolicRefs ? { parsedSymbolicRefs: parsedSymbolicRefs.values } : {}),
+            symbolicRanges: symbolicRanges.values,
+            ...(parsedSymbolicRanges ? { parsedSymbolicRanges: parsedSymbolicRanges.values } : {}),
+        },
+        sourceChanged: deps.changed ||
+            symbolicRefs.changed ||
+            symbolicRanges.changed ||
+            (parsedDeps?.changed ?? false) ||
+            (parsedSymbolicRefs?.changed ?? false) ||
+            (parsedSymbolicRanges?.changed ?? false),
+    };
+}
+export function renameCompiledFormulaSheetReferenceMetadataInPlace(compiled, oldSheetName, newSheetName) {
+    let sourceChanged = false;
+    const renameStringArrayInPlace = (values) => {
+        for (let index = 0; index < values.length; index += 1) {
+            const value = values[index];
+            const renamed = renameQualifiedReferenceSheet(value, oldSheetName, newSheetName);
+            if (renamed !== value) {
+                values[index] = renamed;
+                sourceChanged = true;
+            }
+        }
+    };
+    renameStringArrayInPlace(compiled.deps);
+    renameStringArrayInPlace(compiled.symbolicRefs);
+    renameStringArrayInPlace(compiled.symbolicRanges);
+    compiled.parsedDeps?.forEach((dependency) => {
+        const previousSheetName = dependency.sheetName;
+        if (previousSheetName === oldSheetName) {
+            dependency.sheetName = newSheetName;
+            sourceChanged = true;
+        }
+    });
+    compiled.parsedSymbolicRefs?.forEach((reference) => {
+        if (reference.sheetName === oldSheetName) {
+            reference.sheetName = newSheetName;
+            sourceChanged = true;
+        }
+    });
+    compiled.parsedSymbolicRanges?.forEach((reference) => {
+        if (reference.sheetName === oldSheetName) {
+            reference.sheetName = newSheetName;
+            sourceChanged = true;
+        }
+    });
+    if (compiled.jsPlan.length > 0) {
+        compiled.jsPlan = renameJsPlanSheetReferences(compiled.jsPlan, oldSheetName, newSheetName);
+    }
+    if (sourceChanged) {
+        compiled.astMatchesSource = false;
+    }
+    return sourceChanged;
+}
+function renameNodeSheetReferences(node, oldSheetName, newSheetName) {
+    switch (node.kind) {
+        case 'NumberLiteral':
+        case 'BooleanLiteral':
+        case 'StringLiteral':
+        case 'ErrorLiteral':
+        case 'NameRef':
+        case 'StructuredRef':
+            return node;
+        case 'CellRef':
+        case 'SpillRef':
+        case 'RowRef':
+        case 'ColumnRef':
+        case 'RangeRef':
+            return {
+                ...node,
+                ...(node.sheetName === oldSheetName ? { sheetName: newSheetName } : {}),
+            };
+        case 'UnaryExpr':
+            return {
+                ...node,
+                argument: renameNodeSheetReferences(node.argument, oldSheetName, newSheetName),
+            };
+        case 'BinaryExpr':
+            return {
+                ...node,
+                left: renameNodeSheetReferences(node.left, oldSheetName, newSheetName),
+                right: renameNodeSheetReferences(node.right, oldSheetName, newSheetName),
+            };
+        case 'CallExpr':
+            return {
+                ...node,
+                args: node.args.map((arg) => renameNodeSheetReferences(arg, oldSheetName, newSheetName)),
+            };
+        case 'InvokeExpr':
+            return {
+                ...node,
+                callee: renameNodeSheetReferences(node.callee, oldSheetName, newSheetName),
+                args: node.args.map((arg) => renameNodeSheetReferences(arg, oldSheetName, newSheetName)),
+            };
+    }
+}
+function renameQualifiedReferenceSheet(reference, oldSheetName, newSheetName) {
+    const quotedOldPrefix = `${quoteSheetNameIfNeeded(oldSheetName)}!`;
+    if (reference.startsWith(quotedOldPrefix)) {
+        return `${quoteSheetNameIfNeeded(newSheetName)}!${reference.slice(quotedOldPrefix.length)}`;
+    }
+    const rawOldPrefix = `${oldSheetName}!`;
+    return reference.startsWith(rawOldPrefix) ? `${quoteSheetNameIfNeeded(newSheetName)}!${reference.slice(rawOldPrefix.length)}` : reference;
+}
+function renameParsedCellReferenceSheet(reference, oldSheetName, newSheetName) {
+    return reference.sheetName === oldSheetName ? { ...reference, sheetName: newSheetName } : reference;
+}
+function renameParsedRangeReferenceSheet(reference, oldSheetName, newSheetName) {
+    return reference.sheetName === oldSheetName
+        ? {
+            ...reference,
+            sheetName: newSheetName,
+            address: formatQualifiedRangeReference(newSheetName, reference.startAddress, reference.endAddress),
+        }
+        : reference;
+}
+function renameParsedDependencySheet(dependency, oldSheetName, newSheetName) {
+    return dependency.kind === 'cell'
+        ? renameParsedCellReferenceSheet(dependency, oldSheetName, newSheetName)
+        : renameParsedRangeReferenceSheet(dependency, oldSheetName, newSheetName);
+}
+function renameReferenceOperandSheet(operand, oldSheetName, newSheetName) {
+    return operand?.sheetName === oldSheetName ? { ...operand, sheetName: newSheetName } : operand;
+}
+function renameJsPlanSheetReferences(plan, oldSheetName, newSheetName) {
+    return plan.map((instruction) => {
+        switch (instruction.opcode) {
+            case 'push-cell':
+            case 'push-range':
+            case 'lookup-exact-match':
+            case 'lookup-approximate-match':
+                return instruction.sheetName === oldSheetName ? { ...instruction, sheetName: newSheetName } : instruction;
+            case 'push-lambda':
+                return { ...instruction, body: renameJsPlanSheetReferences(instruction.body, oldSheetName, newSheetName) };
+            case 'call':
+                return instruction.argRefs
+                    ? {
+                        ...instruction,
+                        argRefs: instruction.argRefs.map((operand) => renameReferenceOperandSheet(operand, oldSheetName, newSheetName)),
+                    }
+                    : instruction;
+            case 'begin-scope':
+            case 'binary':
+            case 'bind-name':
+            case 'end-scope':
+            case 'invoke':
+            case 'jump':
+            case 'jump-if-false':
+            case 'push-boolean':
+            case 'push-error':
+            case 'push-name':
+            case 'push-number':
+            case 'push-string':
+            case 'return':
+            case 'unary':
+                return instruction;
+            default:
+                return instruction;
+        }
+    });
+}
+function formatQualifiedRangeReference(sheetName, start, end) {
+    const prefix = sheetName ? `${quoteSheetNameIfNeeded(sheetName)}!` : '';
+    return `${prefix}${start}:${end}`;
+}
+//# sourceMappingURL=formula-sheet-rename.js.map