@bilig/headless 0.1.28 → 0.1.29

package/dist/work-paper-errors.js

@@ -0,0 +1,194 @@
+class BaseWorkPaperError extends Error {
+    constructor(name, message) {
+        super(message);
+        this.name = name;
+    }
+}
+export class WorkPaperConfigValueTooBigError extends BaseWorkPaperError {
+    constructor(paramName, maximum) {
+        super("WorkPaperConfigValueTooBigError", `Config parameter ${paramName} should be at most ${maximum}`);
+    }
+}
+export class WorkPaperConfigValueTooSmallError extends BaseWorkPaperError {
+    constructor(paramName, minimum) {
+        super("WorkPaperConfigValueTooSmallError", `Config parameter ${paramName} should be at least ${minimum}`);
+    }
+}
+export class WorkPaperEvaluationSuspendedError extends BaseWorkPaperError {
+    constructor(message = "Computations are suspended") {
+        super("WorkPaperEvaluationSuspendedError", message);
+    }
+}
+export class WorkPaperExpectedOneOfValuesError extends BaseWorkPaperError {
+    constructor(values, paramName) {
+        super("WorkPaperExpectedOneOfValuesError", `Expected one of ${values} for config parameter: ${paramName}`);
+    }
+}
+export class WorkPaperExpectedValueOfTypeError extends BaseWorkPaperError {
+    constructor(expectedType, paramName) {
+        super("WorkPaperExpectedValueOfTypeError", `Expected value of type: ${expectedType} for config parameter: ${paramName}`);
+    }
+}
+export class WorkPaperFunctionPluginValidationError extends BaseWorkPaperError {
+    constructor(message) {
+        super("WorkPaperFunctionPluginValidationError", message);
+    }
+    static functionNotDeclaredInPlugin(functionId, pluginName) {
+        return new WorkPaperFunctionPluginValidationError(`Function with id ${functionId} not declared in plugin ${pluginName}`);
+    }
+    static functionMethodNotFound(functionName, pluginName) {
+        return new WorkPaperFunctionPluginValidationError(`Function method ${functionName} not found in plugin ${pluginName}`);
+    }
+}
+export class WorkPaperInvalidAddressError extends BaseWorkPaperError {
+    constructor(address) {
+        super("WorkPaperInvalidAddressError", `Address (row = ${address.row}, col = ${address.col}) is invalid`);
+    }
+}
+export class WorkPaperInvalidArgumentsError extends BaseWorkPaperError {
+    constructor(expectedArguments) {
+        super("WorkPaperInvalidArgumentsError", `Invalid arguments, expected ${expectedArguments}`);
+    }
+}
+export class WorkPaperLanguageAlreadyRegisteredError extends BaseWorkPaperError {
+    constructor(languageCode) {
+        super("WorkPaperLanguageAlreadyRegisteredError", languageCode
+            ? `Language '${languageCode}' is already registered`
+            : "Language already registered.");
+    }
+}
+export class WorkPaperLanguageNotRegisteredError extends BaseWorkPaperError {
+    constructor(languageCode) {
+        super("WorkPaperLanguageNotRegisteredError", languageCode ? `Language '${languageCode}' is not registered` : "Language not registered.");
+    }
+}
+export class WorkPaperMissingTranslationError extends BaseWorkPaperError {
+    constructor(key) {
+        super("WorkPaperMissingTranslationError", `Translation for ${key} is missing in the translation package you're using.`);
+    }
+}
+export class WorkPaperNamedExpressionDoesNotExistError extends BaseWorkPaperError {
+    constructor(expressionName) {
+        super("WorkPaperNamedExpressionDoesNotExistError", `Named Expression '${expressionName}' does not exist`);
+    }
+}
+export class WorkPaperNamedExpressionNameIsAlreadyTakenError extends BaseWorkPaperError {
+    constructor(expressionName) {
+        super("WorkPaperNamedExpressionNameIsAlreadyTakenError", `Name of Named Expression '${expressionName}' is already present`);
+    }
+}
+export class WorkPaperNamedExpressionNameIsInvalidError extends BaseWorkPaperError {
+    constructor(expressionName) {
+        super("WorkPaperNamedExpressionNameIsInvalidError", `Name of Named Expression '${expressionName}' is invalid`);
+    }
+}
+export class WorkPaperNoOperationToRedoError extends BaseWorkPaperError {
+    constructor() {
+        super("WorkPaperNoOperationToRedoError", "There is no operation to redo");
+    }
+}
+export class WorkPaperNoOperationToUndoError extends BaseWorkPaperError {
+    constructor() {
+        super("WorkPaperNoOperationToUndoError", "There is no operation to undo");
+    }
+}
+export class WorkPaperNoRelativeAddressesAllowedError extends BaseWorkPaperError {
+    constructor() {
+        super("WorkPaperNoRelativeAddressesAllowedError", "Relative addresses not allowed in named expressions.");
+    }
+}
+export class WorkPaperNoSheetWithIdError extends BaseWorkPaperError {
+    constructor(sheetId) {
+        super("WorkPaperNoSheetWithIdError", `There's no sheet with id = ${sheetId}`);
+    }
+}
+export class WorkPaperNoSheetWithNameError extends BaseWorkPaperError {
+    constructor(sheetName) {
+        super("WorkPaperNoSheetWithNameError", `There's no sheet with name '${sheetName}'`);
+    }
+}
+export class WorkPaperNotAFormulaError extends BaseWorkPaperError {
+    constructor() {
+        super("WorkPaperNotAFormulaError", "This is not a formula");
+    }
+}
+export class WorkPaperNothingToPasteError extends BaseWorkPaperError {
+    constructor() {
+        super("WorkPaperNothingToPasteError", "There is nothing to paste");
+    }
+}
+export class WorkPaperProtectedFunctionTranslationError extends BaseWorkPaperError {
+    constructor(functionId) {
+        super("WorkPaperProtectedFunctionTranslationError", `Cannot register translation for function with id: ${functionId}`);
+    }
+}
+export class WorkPaperSheetNameAlreadyTakenError extends BaseWorkPaperError {
+    constructor(sheetName) {
+        super("WorkPaperSheetNameAlreadyTakenError", `Sheet with name ${sheetName} already exists`);
+    }
+}
+export class WorkPaperSheetSizeLimitExceededError extends BaseWorkPaperError {
+    constructor() {
+        super("WorkPaperSheetSizeLimitExceededError", "Sheet size limit exceeded");
+    }
+}
+export class WorkPaperSourceLocationHasArrayError extends BaseWorkPaperError {
+    constructor() {
+        super("WorkPaperSourceLocationHasArrayError", "Cannot perform this operation, source location has an array inside.");
+    }
+}
+export class WorkPaperTargetLocationHasArrayError extends BaseWorkPaperError {
+    constructor() {
+        super("WorkPaperTargetLocationHasArrayError", "Cannot perform this operation, target location has an array inside.");
+    }
+}
+function serializeParseValue(value) {
+    return JSON.stringify(value, (_key, current) => {
+        if (typeof current === "function" || typeof current === "symbol") {
+            return String(current);
+        }
+        if (typeof current === "bigint") {
+            return `BigInt(${current.toString()})`;
+        }
+        if (current instanceof RegExp) {
+            return `RegExp(${current.toString()})`;
+        }
+        return current;
+    }, 4);
+}
+export class WorkPaperUnableToParseError extends BaseWorkPaperError {
+    constructor(value) {
+        super("WorkPaperUnableToParseError", `Unable to parse value: ${serializeParseValue(value)}`);
+    }
+}
+export class WorkPaperConfigError extends BaseWorkPaperError {
+    constructor(message) {
+        super("WorkPaperConfigError", message);
+    }
+}
+export class WorkPaperSheetError extends BaseWorkPaperError {
+    constructor(message) {
+        super("WorkPaperSheetError", message);
+    }
+}
+export class WorkPaperNamedExpressionError extends BaseWorkPaperError {
+    constructor(message) {
+        super("WorkPaperNamedExpressionError", message);
+    }
+}
+export class WorkPaperClipboardError extends BaseWorkPaperError {
+    constructor(message) {
+        super("WorkPaperClipboardError", message);
+    }
+}
+export class WorkPaperParseError extends BaseWorkPaperError {
+    constructor(message) {
+        super("WorkPaperParseError", message);
+    }
+}
+export class WorkPaperOperationError extends BaseWorkPaperError {
+    constructor(message) {
+        super("WorkPaperOperationError", message);
+    }
+}
+//# sourceMappingURL=work-paper-errors.js.map

package/dist/work-paper-errors.js.map

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

package/dist/work-paper-runtime.d.ts

@@ -0,0 +1,253 @@
+import { type CellValue } from "@bilig/protocol";
+import type { WorkPaperAddressMappingAdapter, WorkPaperAddressFormatOptions, WorkPaperAddressLike, WorkPaperArrayMappingAdapter, WorkPaperAxisInterval, WorkPaperAxisSwapMapping, WorkPaperCellAddress, WorkPaperCellRange, WorkPaperCellType, WorkPaperCellValueDetailedType, WorkPaperCellValueType, WorkPaperChange, WorkPaperColumnSearchAdapter, WorkPaperConfig, WorkPaperDateTime, WorkPaperDependencyGraphAdapter, WorkPaperDependencyRef, WorkPaperEvaluatorAdapter, WorkPaperFunctionPluginDefinition, WorkPaperFunctionTranslationsPackage, WorkPaperGraphAdapter, WorkPaperLanguagePackage, WorkPaperLazilyTransformingAstServiceAdapter, WorkPaperLicenseKeyValidityState, WorkPaperNamedExpression, WorkPaperRangeMappingAdapter, WorkPaperSheet, WorkPaperSheetDimensions, WorkPaperSheetMappingAdapter, WorkPaperSheets, WorkPaperStats, WorkPaperDetailedListener, WorkPaperEventName, WorkPaperInternals, WorkPaperListener, RawCellContent, SerializedWorkPaperNamedExpression } from "./work-paper-types.js";
+export declare class WorkPaper {
+    static version: string;
+    static buildDate: string;
+    static releaseDate: string;
+    static readonly languages: Record<string, WorkPaperLanguagePackage>;
+    static readonly defaultConfig: WorkPaperConfig;
+    private static readonly languageRegistry;
+    private static readonly functionPluginRegistry;
+    readonly workbookId: number;
+    private engine;
+    private readonly emitter;
+    private readonly namedExpressions;
+    private readonly functionSnapshot;
+    private readonly functionAliasLookup;
+    private readonly internalFunctionLookup;
+    readonly internals: WorkPaperInternals;
+    private config;
+    private clipboard;
+    private visibilityCache;
+    private namedExpressionValueCache;
+    private batchDepth;
+    private batchStartVisibility;
+    private batchStartNamedValues;
+    private batchUndoStackLength;
+    private pendingBatchOps;
+    private pendingBatchPotentialNewCells;
+    private evaluationSuspended;
+    private suspendedVisibility;
+    private suspendedNamedValues;
+    private queuedEvents;
+    private trackedEngineEvents;
+    private engineEventCaptureEnabled;
+    private unsubscribeEngineEvents;
+    private disposed;
+    private constructor();
+    static buildEmpty(configInput?: WorkPaperConfig, namedExpressions?: readonly SerializedWorkPaperNamedExpression[]): WorkPaper;
+    static buildFromArray(sheet: WorkPaperSheet, configInput?: WorkPaperConfig, namedExpressions?: readonly SerializedWorkPaperNamedExpression[]): WorkPaper;
+    static buildFromSheets(sheets: WorkPaperSheets, configInput?: WorkPaperConfig, namedExpressions?: readonly SerializedWorkPaperNamedExpression[]): WorkPaper;
+    static getLanguage(languageCode: string): WorkPaperLanguagePackage;
+    static registerLanguage(languageCode: string, languagePackage: WorkPaperLanguagePackage): void;
+    static unregisterLanguage(languageCode: string): void;
+    static getRegisteredLanguagesCodes(): string[];
+    static registerFunctionPlugin(plugin: WorkPaperFunctionPluginDefinition, translations?: WorkPaperFunctionTranslationsPackage): void;
+    static unregisterFunctionPlugin(plugin: WorkPaperFunctionPluginDefinition | string): void;
+    static registerFunction(functionId: string, plugin: WorkPaperFunctionPluginDefinition, translations?: WorkPaperFunctionTranslationsPackage): void;
+    static unregisterFunction(functionId: string): void;
+    static unregisterAllFunctions(): void;
+    static getRegisteredFunctionNames(languageCode?: string): string[];
+    static getFunctionPlugin(functionId: string): WorkPaperFunctionPluginDefinition | undefined;
+    static getAllFunctionPlugins(): WorkPaperFunctionPluginDefinition[];
+    private static loadFunctionTranslations;
+    on<EventName extends WorkPaperEventName>(eventName: EventName, listener: WorkPaperListener<EventName>): void;
+    once<EventName extends WorkPaperEventName>(eventName: EventName, listener: WorkPaperListener<EventName>): void;
+    off<EventName extends WorkPaperEventName>(eventName: EventName, listener: WorkPaperListener<EventName>): void;
+    onDetailed<EventName extends WorkPaperEventName>(eventName: EventName, listener: WorkPaperDetailedListener<EventName>): void;
+    onceDetailed<EventName extends WorkPaperEventName>(eventName: EventName, listener: WorkPaperDetailedListener<EventName>): void;
+    offDetailed<EventName extends WorkPaperEventName>(eventName: EventName, listener: WorkPaperDetailedListener<EventName>): void;
+    getConfig(): WorkPaperConfig;
+    get graph(): WorkPaperGraphAdapter;
+    get rangeMapping(): WorkPaperRangeMappingAdapter;
+    get arrayMapping(): WorkPaperArrayMappingAdapter;
+    get sheetMapping(): WorkPaperSheetMappingAdapter;
+    get addressMapping(): WorkPaperAddressMappingAdapter;
+    get dependencyGraph(): WorkPaperDependencyGraphAdapter;
+    get evaluator(): WorkPaperEvaluatorAdapter;
+    get columnSearch(): WorkPaperColumnSearchAdapter;
+    get lazilyTransformingAstService(): WorkPaperLazilyTransformingAstServiceAdapter;
+    get licenseKeyValidityState(): WorkPaperLicenseKeyValidityState;
+    updateConfig(next: WorkPaperConfig): void;
+    getStats(): WorkPaperStats;
+    rebuildAndRecalculate(): WorkPaperChange[];
+    batch(batchOperations: () => void): WorkPaperChange[];
+    suspendEvaluation(): void;
+    resumeEvaluation(): WorkPaperChange[];
+    isEvaluationSuspended(): boolean;
+    undo(): WorkPaperChange[];
+    redo(): WorkPaperChange[];
+    isThereSomethingToUndo(): boolean;
+    isThereSomethingToRedo(): boolean;
+    clearUndoStack(): void;
+    clearRedoStack(): void;
+    copy(range: WorkPaperCellRange): CellValue[][];
+    cut(range: WorkPaperCellRange): CellValue[][];
+    paste(targetLeftCorner: WorkPaperCellAddress): WorkPaperChange[];
+    isClipboardEmpty(): boolean;
+    clearClipboard(): void;
+    getFillRangeData(source: WorkPaperCellRange, target: WorkPaperCellRange, offsetsFromTarget?: boolean): RawCellContent[][];
+    getCellValue(address: WorkPaperCellAddress): CellValue;
+    getCellFormula(address: WorkPaperCellAddress): string | undefined;
+    getCellHyperlink(address: WorkPaperCellAddress): string | undefined;
+    getCellSerialized(address: WorkPaperCellAddress): RawCellContent;
+    getRangeValues(range: WorkPaperCellRange): CellValue[][];
+    getRangeFormulas(range: WorkPaperCellRange): Array<Array<string | undefined>>;
+    getRangeSerialized(range: WorkPaperCellRange): RawCellContent[][];
+    getSheetValues(sheetId: number): CellValue[][];
+    getSheetFormulas(sheetId: number): Array<Array<string | undefined>>;
+    getSheetSerialized(sheetId: number): RawCellContent[][];
+    getAllSheetsValues(): Record<string, CellValue[][]>;
+    getAllSheetsFormulas(): Record<string, Array<Array<string | undefined>>>;
+    getAllSheetsSerialized(): Record<string, RawCellContent[][]>;
+    getAllSheetsDimensions(): Record<string, WorkPaperSheetDimensions>;
+    getSheetDimensions(sheetId: number): WorkPaperSheetDimensions;
+    simpleCellAddressFromString(value: string, defaultSheetId?: number): WorkPaperCellAddress | undefined;
+    simpleCellRangeFromString(value: string, defaultSheetId?: number): WorkPaperCellRange | undefined;
+    simpleCellAddressToString(address: WorkPaperCellAddress, optionsOrContextSheetId?: WorkPaperAddressFormatOptions | number): string;
+    simpleCellRangeToString(range: WorkPaperCellRange, optionsOrContextSheetId?: WorkPaperAddressFormatOptions | number): string;
+    getCellDependents(address: WorkPaperAddressLike): WorkPaperDependencyRef[];
+    getCellPrecedents(address: WorkPaperAddressLike): WorkPaperDependencyRef[];
+    getSheetName(sheetId: number): string | undefined;
+    getSheetNames(): string[];
+    getSheetId(name: string): number | undefined;
+    doesSheetExist(name: string): boolean;
+    countSheets(): number;
+    getCellType(address: WorkPaperCellAddress): WorkPaperCellType;
+    doesCellHaveSimpleValue(address: WorkPaperCellAddress): boolean;
+    doesCellHaveFormula(address: WorkPaperCellAddress): boolean;
+    isCellEmpty(address: WorkPaperCellAddress): boolean;
+    isCellPartOfArray(address: WorkPaperCellAddress): boolean;
+    getCellValueType(address: WorkPaperCellAddress): WorkPaperCellValueType;
+    getCellValueDetailedType(address: WorkPaperCellAddress): WorkPaperCellValueDetailedType;
+    getCellValueFormat(address: WorkPaperCellAddress): string | undefined;
+    getNamedExpressionValue(name: string, scope?: number): CellValue | CellValue[][] | undefined;
+    getNamedExpressionFormula(name: string, scope?: number): string | undefined;
+    getNamedExpression(name: string, scope?: number): WorkPaperNamedExpression | undefined;
+    addNamedExpression(expressionName: string, expression: RawCellContent, scope?: number, options?: Record<string, string | number | boolean>): WorkPaperChange[];
+    changeNamedExpression(expressionName: string, expression: RawCellContent, scope?: number, options?: Record<string, string | number | boolean>): WorkPaperChange[];
+    removeNamedExpression(expressionName: string, scope?: number): WorkPaperChange[];
+    listNamedExpressions(scope?: number): string[];
+    getAllNamedExpressionsSerialized(): SerializedWorkPaperNamedExpression[];
+    normalizeFormula(formula: string): string;
+    calculateFormula(formula: string, scope?: number): CellValue | CellValue[][];
+    getNamedExpressionsFromFormula(formula: string): string[];
+    validateFormula(formula: string): boolean;
+    getRegisteredFunctionNames(languageCode?: string): string[];
+    getFunctionPlugin(functionId: string): WorkPaperFunctionPluginDefinition | undefined;
+    getAllFunctionPlugins(): WorkPaperFunctionPluginDefinition[];
+    numberToDateTime(value: number): WorkPaperDateTime | undefined;
+    numberToDate(value: number): Omit<WorkPaperDateTime, "hours" | "minutes" | "seconds"> | undefined;
+    numberToTime(value: number): Pick<WorkPaperDateTime, "hours" | "minutes" | "seconds"> | undefined;
+    setCellContents(address: WorkPaperCellAddress, content: RawCellContent | WorkPaperSheet): WorkPaperChange[];
+    swapRowIndexes(sheetId: number, rowA: number, rowB: number): WorkPaperChange[];
+    swapRowIndexes(sheetId: number, rowMappings: readonly WorkPaperAxisSwapMapping[]): WorkPaperChange[];
+    setRowOrder(sheetId: number, rowOrder: readonly number[]): WorkPaperChange[];
+    swapColumnIndexes(sheetId: number, columnA: number, columnB: number): WorkPaperChange[];
+    swapColumnIndexes(sheetId: number, columnMappings: readonly WorkPaperAxisSwapMapping[]): WorkPaperChange[];
+    setColumnOrder(sheetId: number, columnOrder: readonly number[]): WorkPaperChange[];
+    addRows(sheetId: number, start: number, count?: number): WorkPaperChange[];
+    addRows(sheetId: number, ...indexes: readonly WorkPaperAxisInterval[]): WorkPaperChange[];
+    removeRows(sheetId: number, start: number, count?: number): WorkPaperChange[];
+    removeRows(sheetId: number, ...indexes: readonly WorkPaperAxisInterval[]): WorkPaperChange[];
+    addColumns(sheetId: number, start: number, count?: number): WorkPaperChange[];
+    addColumns(sheetId: number, ...indexes: readonly WorkPaperAxisInterval[]): WorkPaperChange[];
+    removeColumns(sheetId: number, start: number, count?: number): WorkPaperChange[];
+    removeColumns(sheetId: number, ...indexes: readonly WorkPaperAxisInterval[]): WorkPaperChange[];
+    moveCells(source: WorkPaperCellRange, target: WorkPaperCellAddress): WorkPaperChange[];
+    moveRows(sheetId: number, start: number, count: number, target: number): WorkPaperChange[];
+    moveColumns(sheetId: number, start: number, count: number, target: number): WorkPaperChange[];
+    addSheet(sheetName?: string): string;
+    removeSheet(sheetId: number): WorkPaperChange[];
+    clearSheet(sheetId: number): WorkPaperChange[];
+    setSheetContent(sheetId: number, content: WorkPaperSheet): WorkPaperChange[];
+    renameSheet(sheetId: number, nextName: string): WorkPaperChange[];
+    isItPossibleToSetCellContents(address: WorkPaperCellAddress, content?: RawCellContent | WorkPaperSheet): boolean;
+    isItPossibleToSetCellContents(range: WorkPaperCellRange): boolean;
+    isItPossibleToSwapRowIndexes(sheetId: number, rowA: number, rowB: number): boolean;
+    isItPossibleToSwapRowIndexes(sheetId: number, rowMappings: readonly WorkPaperAxisSwapMapping[]): boolean;
+    isItPossibleToSetRowOrder(sheetId: number, rowOrder: readonly number[]): boolean;
+    isItPossibleToSwapColumnIndexes(sheetId: number, columnA: number, columnB: number): boolean;
+    isItPossibleToSwapColumnIndexes(sheetId: number, columnMappings: readonly WorkPaperAxisSwapMapping[]): boolean;
+    isItPossibleToSetColumnOrder(sheetId: number, columnOrder: readonly number[]): boolean;
+    isItPossibleToAddRows(sheetId: number, start: number, count?: number): boolean;
+    isItPossibleToAddRows(sheetId: number, ...indexes: readonly WorkPaperAxisInterval[]): boolean;
+    isItPossibleToRemoveRows(sheetId: number, start: number, count?: number): boolean;
+    isItPossibleToRemoveRows(sheetId: number, ...indexes: readonly WorkPaperAxisInterval[]): boolean;
+    isItPossibleToAddColumns(sheetId: number, start: number, count?: number): boolean;
+    isItPossibleToAddColumns(sheetId: number, ...indexes: readonly WorkPaperAxisInterval[]): boolean;
+    isItPossibleToRemoveColumns(sheetId: number, start: number, count?: number): boolean;
+    isItPossibleToRemoveColumns(sheetId: number, ...indexes: readonly WorkPaperAxisInterval[]): boolean;
+    isItPossibleToMoveCells(source: WorkPaperCellRange, target: WorkPaperCellAddress): boolean;
+    isItPossibleToMoveRows(sheetId: number, start: number, count: number, target: number): boolean;
+    isItPossibleToMoveColumns(sheetId: number, start: number, count: number, target: number): boolean;
+    isItPossibleToAddSheet(sheetName: string): boolean;
+    isItPossibleToRemoveSheet(sheetId: number): boolean;
+    isItPossibleToClearSheet(sheetId: number): boolean;
+    isItPossibleToReplaceSheetContent(sheetId: number, content: WorkPaperSheet): boolean;
+    isItPossibleToRenameSheet(sheetId: number, nextName: string): boolean;
+    isItPossibleToAddNamedExpression(expressionName: string, expression: RawCellContent, scope?: number): boolean;
+    isItPossibleToChangeNamedExpression(expressionName: string, expression: RawCellContent, scope?: number): boolean;
+    isItPossibleToRemoveNamedExpression(expressionName: string, scope?: number): boolean;
+    destroy(): void;
+    dispose(): void;
+    private attachEngineEventTracking;
+    private withEngineEventCaptureDisabled;
+    private drainTrackedEngineEvents;
+    private primeChangeTrackingCaches;
+    private ensureVisibilityCache;
+    private ensureNamedExpressionValueCache;
+    private flushPendingBatchOps;
+    private enqueueDeferredBatchLiteral;
+    private prepareReadableState;
+    private assertNotDisposed;
+    private assertReadable;
+    private sheetRecord;
+    private sheetName;
+    private requireSheetId;
+    private a1;
+    private rangeRef;
+    private getDirectPrecedentStrings;
+    private getDirectPrecedentRefs;
+    private listSheetRecords;
+    private getDenseRange;
+    private captureVisibilitySnapshot;
+    private captureNamedExpressionValueSnapshot;
+    private computeCellChanges;
+    private computeCellChangesFromTrackedEvents;
+    private computeNamedExpressionChanges;
+    private computeChangesAfterMutation;
+    private captureChanges;
+    private shouldSuppressEvents;
+    private flushQueuedEvents;
+    private getUndoStack;
+    private getRedoStack;
+    private clearHistoryStacks;
+    private mergeUndoHistory;
+    private nextSheetName;
+    private buildNullMatrixForRange;
+    private applySerializedMatrix;
+    private applyMatrixContents;
+    private replaceSheetContentInternal;
+    private applyRawContent;
+    private captureFunctionRegistry;
+    private clearFunctionBindings;
+    private rebuildWithConfig;
+    private normalizeAxisIntervals;
+    private normalizeAxisSwapMappings;
+    private collectRangeDependencies;
+    private rewriteFormulaForStorage;
+    private restorePublicFormula;
+    private rewriteNameRefForStorage;
+    private rewriteNameRefForPublic;
+    private rewriteCallForStorage;
+    private rewriteCallForPublic;
+    private validateNamedExpression;
+    private upsertNamedExpressionInternal;
+    private toDefinedNameSnapshot;
+    private namedExpressionRecord;
+    private evaluateNamedExpression;
+    private cellSnapshotToRawContent;
+    private toDependencyRefs;
+    private messageOf;
+}