@bilig/headless 0.8.0 → 0.8.2

package/dist/work-paper-named-expression-operations.js

@@ -0,0 +1,82 @@
+import { isFormulaContent } from './work-paper-runtime-helpers.js';
+import { createSerializedWorkPaperNamedExpression, listWorkPaperNamedExpressions, publicWorkPaperNamedExpressionFromInternal, serializeWorkPaperNamedExpressions, } from './work-paper-named-expression-helpers.js';
+import { WorkPaperNamedExpressionDoesNotExistError, WorkPaperNamedExpressionNameIsAlreadyTakenError } from './work-paper-errors.js';
+export function createWorkPaperNamedExpressionOperations(runtime) {
+    return {
+        getNamedExpressionValue(name, scope) {
+            runtime.assertReadable();
+            const expression = runtime.getNamedExpression(name, scope);
+            return expression ? runtime.evaluateNamedExpression(expression) : undefined;
+        },
+        getNamedExpressionFormula(name, scope) {
+            const expression = runtime.getNamedExpression(name, scope);
+            if (!expression) {
+                return undefined;
+            }
+            return isFormulaContent(expression.expression) ? expression.expression : undefined;
+        },
+        getNamedExpression(name, scope) {
+            const expression = runtime.getNamedExpression(name, scope);
+            if (!expression) {
+                return undefined;
+            }
+            return publicWorkPaperNamedExpressionFromInternal(expression);
+        },
+        addNamedExpression(expressionName, expression, scope, options) {
+            if (!runtime.isItPossibleToAddNamedExpression(expressionName, expression, scope)) {
+                throw new WorkPaperNamedExpressionNameIsAlreadyTakenError(expressionName);
+            }
+            return runtime.captureChanges({
+                eventName: 'namedExpressionAdded',
+                payload: {
+                    name: expressionName.trim(),
+                    changes: [],
+                    ...(scope !== undefined ? { scope } : {}),
+                },
+            }, () => {
+                runtime.upsertNamedExpressionInternal(createSerializedWorkPaperNamedExpression({ name: expressionName, expression, scope, options }), { duringInitialization: false });
+            });
+        },
+        changeNamedExpression(expressionName, expression, scope, options) {
+            runtime.validateNamedExpression(expressionName, expression, scope);
+            const existing = runtime.getNamedExpression(expressionName, scope);
+            if (!existing) {
+                throw new WorkPaperNamedExpressionDoesNotExistError(expressionName);
+            }
+            const fastPathChanges = runtime.tryCaptureNamedExpressionChangeWithoutSnapshots(existing, expressionName, expression, scope, options);
+            if (fastPathChanges) {
+                return fastPathChanges;
+            }
+            return runtime.captureChanges(undefined, () => {
+                runtime.upsertNamedExpressionInternal(createSerializedWorkPaperNamedExpression({ name: expressionName, expression, scope, options }), { duringInitialization: false });
+            });
+        },
+        removeNamedExpression(expressionName, scope) {
+            if (!runtime.isItPossibleToRemoveNamedExpression(expressionName, scope)) {
+                throw new WorkPaperNamedExpressionDoesNotExistError(expressionName);
+            }
+            const existing = runtime.getNamedExpression(expressionName, scope);
+            if (!existing) {
+                throw new WorkPaperNamedExpressionDoesNotExistError(expressionName);
+            }
+            return runtime.captureChanges({
+                eventName: 'namedExpressionRemoved',
+                payload: {
+                    name: existing.publicName,
+                    changes: [],
+                    ...(existing.scope !== undefined ? { scope: existing.scope } : {}),
+                },
+            }, () => {
+                runtime.deleteNamedExpressionRecord(expressionName, scope);
+                runtime.deleteDefinedName(existing.internalName);
+            });
+        },
+        listNamedExpressions(scope) {
+            return listWorkPaperNamedExpressions(runtime.getNamedExpressionValues(), scope);
+        },
+        getAllNamedExpressionsSerialized() {
+            return serializeWorkPaperNamedExpressions(runtime.getNamedExpressionValues());
+        },
+    };
+}
+//# sourceMappingURL=work-paper-named-expression-operations.js.map

package/dist/work-paper-named-expression-operations.js.map

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

package/dist/work-paper-public-surface.d.ts

@@ -0,0 +1,73 @@
+import type { SpreadsheetEngine } from '@bilig/core';
+import type { CellValue } from '@bilig/protocol';
+import type { WorkPaperEmitter } from './work-paper-emitter.js';
+import { type InternalFunctionBinding } from './work-paper-function-registry.js';
+import type { RawCellContent, SerializedWorkPaperNamedExpression, WorkPaperAddressMappingAdapter, WorkPaperArrayMappingAdapter, WorkPaperCellAddress, WorkPaperCellRange, WorkPaperColumnSearchAdapter, WorkPaperConfig, WorkPaperDateTime, WorkPaperDependencyGraphAdapter, WorkPaperEvaluatorAdapter, WorkPaperFunctionPluginDefinition, WorkPaperFunctionTranslationsPackage, WorkPaperGraphAdapter, WorkPaperLanguagePackage, WorkPaperLazilyTransformingAstServiceAdapter, WorkPaperLicenseKeyValidityState, WorkPaperRangeMappingAdapter, WorkPaperSheet, WorkPaperSheetMappingAdapter, WorkPaperEngineCounters, WorkPaperDetailedListener, WorkPaperEventName, WorkPaperInternals, WorkPaperListener } from './work-paper-types.js';
+import { WorkPaperCapabilitySurface } from './work-paper-capability-surface.js';
+export declare abstract class WorkPaperPublicSurface extends WorkPaperCapabilitySurface {
+    static version: string;
+    static buildDate: string;
+    static releaseDate: string;
+    static readonly languages: Record<string, WorkPaperLanguagePackage>;
+    static readonly defaultConfig: WorkPaperConfig;
+    protected abstract readonly emitter: WorkPaperEmitter;
+    protected abstract readonly functionSnapshot: Map<string, InternalFunctionBinding>;
+    protected abstract readonly functionAliasLookup: Map<string, InternalFunctionBinding>;
+    protected abstract readonly internals: WorkPaperInternals;
+    protected abstract engine: SpreadsheetEngine;
+    protected abstract config: WorkPaperConfig;
+    protected abstract assertNotDisposed(): void;
+    protected abstract createScratchWorkbook(config: WorkPaperConfig): {
+        readonly engine: SpreadsheetEngine;
+        readonly registerNamedExpression: (expression: SerializedWorkPaperNamedExpression) => void;
+        readonly requireSheetId: (sheetName: string) => number;
+        readonly replaceSheetContent: (sheetId: number, sheet: WorkPaperSheet) => void;
+        readonly clearHistoryStacks: () => void;
+        readonly applyRawContent: (address: WorkPaperCellAddress, content: RawCellContent) => void;
+        readonly getRangeValues: (range: WorkPaperCellRange) => CellValue[][];
+        readonly getCellValue: (address: WorkPaperCellAddress) => CellValue;
+        readonly dispose: () => void;
+    };
+    protected abstract messageOf(error: unknown, fallback: string): string;
+    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[];
+    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;
+    getPerformanceCounters(): WorkPaperEngineCounters;
+    resetPerformanceCounters(): void;
+    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;
+}

package/dist/work-paper-public-surface.js

@@ -0,0 +1,165 @@
+import { checkWorkPaperLicenseKeyValidity, cloneConfig, DEFAULT_CONFIG } from './work-paper-config.js';
+import { numberToWorkPaperDate, numberToWorkPaperDateTime, numberToWorkPaperTime } from './work-paper-date-time.js';
+import { calculateWorkPaperFormula, getWorkPaperNamedExpressionsFromFormula, normalizeWorkPaperFormula, validateWorkPaperFormula, } from './work-paper-formula-analysis.js';
+import { getCapturedWorkPaperFunctionPlugin, getCapturedWorkPaperFunctionPlugins, listCapturedWorkPaperFunctionNames, } from './work-paper-function-registry.js';
+import { getRegisteredWorkPaperFunctionPluginById, getRegisteredWorkPaperFunctionPluginsById, readRegisteredWorkPaperLanguage, } from './work-paper-static-registry.js';
+import { DEFAULT_WORKPAPER_CONFIG, getAllWorkPaperStaticFunctionPlugins, getRegisteredWorkPaperStaticFunctionNames, getRegisteredWorkPaperStaticLanguageCodes, getWorkPaperStaticFunctionPlugin, getWorkPaperStaticLanguage, registerWorkPaperStaticFunction, registerWorkPaperStaticFunctionPlugin, registerWorkPaperStaticLanguage, unregisterAllWorkPaperStaticFunctions, unregisterWorkPaperStaticFunction, unregisterWorkPaperStaticFunctionPlugin, unregisterWorkPaperStaticLanguage, workPaperLanguages, WORKPAPER_BUILD_DATE, WORKPAPER_RELEASE_DATE, WORKPAPER_VERSION, } from './work-paper-static-api.js';
+import { WorkPaperCapabilitySurface } from './work-paper-capability-surface.js';
+export class WorkPaperPublicSurface extends WorkPaperCapabilitySurface {
+    static version = WORKPAPER_VERSION;
+    static buildDate = WORKPAPER_BUILD_DATE;
+    static releaseDate = WORKPAPER_RELEASE_DATE;
+    static languages = workPaperLanguages;
+    static defaultConfig = DEFAULT_WORKPAPER_CONFIG;
+    static getLanguage(languageCode) {
+        return getWorkPaperStaticLanguage(languageCode);
+    }
+    static registerLanguage(languageCode, languagePackage) {
+        registerWorkPaperStaticLanguage(languageCode, languagePackage);
+    }
+    static unregisterLanguage(languageCode) {
+        unregisterWorkPaperStaticLanguage(languageCode);
+    }
+    static getRegisteredLanguagesCodes() {
+        return getRegisteredWorkPaperStaticLanguageCodes();
+    }
+    static registerFunctionPlugin(plugin, translations) {
+        registerWorkPaperStaticFunctionPlugin(plugin, translations);
+    }
+    static unregisterFunctionPlugin(plugin) {
+        unregisterWorkPaperStaticFunctionPlugin(plugin);
+    }
+    static registerFunction(functionId, plugin, translations) {
+        registerWorkPaperStaticFunction(functionId, plugin, translations);
+    }
+    static unregisterFunction(functionId) {
+        unregisterWorkPaperStaticFunction(functionId);
+    }
+    static unregisterAllFunctions() {
+        unregisterAllWorkPaperStaticFunctions();
+    }
+    static getRegisteredFunctionNames(languageCode) {
+        return getRegisteredWorkPaperStaticFunctionNames(languageCode);
+    }
+    static getFunctionPlugin(functionId) {
+        return getWorkPaperStaticFunctionPlugin(functionId);
+    }
+    static getAllFunctionPlugins() {
+        return getAllWorkPaperStaticFunctionPlugins();
+    }
+    on(eventName, listener) {
+        this.assertNotDisposed();
+        this.emitter.on(eventName, listener);
+    }
+    once(eventName, listener) {
+        this.assertNotDisposed();
+        this.emitter.once(eventName, listener);
+    }
+    off(eventName, listener) {
+        this.emitter.off(eventName, listener);
+    }
+    onDetailed(eventName, listener) {
+        this.assertNotDisposed();
+        this.emitter.onDetailed(eventName, listener);
+    }
+    onceDetailed(eventName, listener) {
+        this.assertNotDisposed();
+        this.emitter.onceDetailed(eventName, listener);
+    }
+    offDetailed(eventName, listener) {
+        this.emitter.offDetailed(eventName, listener);
+    }
+    getConfig() {
+        return cloneConfig(this.config);
+    }
+    get graph() {
+        return this.internals.graph;
+    }
+    get rangeMapping() {
+        return this.internals.rangeMapping;
+    }
+    get arrayMapping() {
+        return this.internals.arrayMapping;
+    }
+    get sheetMapping() {
+        return this.internals.sheetMapping;
+    }
+    get addressMapping() {
+        return this.internals.addressMapping;
+    }
+    get dependencyGraph() {
+        return this.internals.dependencyGraph;
+    }
+    get evaluator() {
+        return this.internals.evaluator;
+    }
+    get columnSearch() {
+        return this.internals.columnSearch;
+    }
+    get lazilyTransformingAstService() {
+        return this.internals.lazilyTransformingAstService;
+    }
+    get licenseKeyValidityState() {
+        return checkWorkPaperLicenseKeyValidity(this.config.licenseKey);
+    }
+    getPerformanceCounters() {
+        this.assertNotDisposed();
+        const counterAwareEngine = this.engine;
+        return structuredClone(counterAwareEngine.getPerformanceCounters());
+    }
+    resetPerformanceCounters() {
+        this.assertNotDisposed();
+        const counterAwareEngine = this.engine;
+        counterAwareEngine.resetPerformanceCounters();
+    }
+    normalizeFormula(formula) {
+        return normalizeWorkPaperFormula(formula, { messageOf: (error, fallback) => this.messageOf(error, fallback) });
+    }
+    calculateFormula(formula, scope) {
+        return calculateWorkPaperFormula({
+            createWorkbook: (config) => this.createScratchWorkbook(config),
+            config: this.getConfig(),
+            serializedSheets: this.getAllSheetsSerialized(),
+            namedExpressions: this.getAllNamedExpressionsSerialized(),
+            formula,
+            ...(scope !== undefined ? { scope } : {}),
+            messageOf: (error, fallback) => this.messageOf(error, fallback),
+        });
+    }
+    getNamedExpressionsFromFormula(formula) {
+        return getWorkPaperNamedExpressionsFromFormula(formula, { messageOf: (error, fallback) => this.messageOf(error, fallback) });
+    }
+    validateFormula(formula) {
+        return validateWorkPaperFormula(formula);
+    }
+    getRegisteredFunctionNames(languageCode) {
+        const code = languageCode ?? this.config.language ?? DEFAULT_CONFIG.language ?? 'enGB';
+        return listCapturedWorkPaperFunctionNames({
+            functionSnapshot: this.functionSnapshot.values(),
+            language: readRegisteredWorkPaperLanguage(code),
+        });
+    }
+    getFunctionPlugin(functionId) {
+        return getCapturedWorkPaperFunctionPlugin({
+            functionId,
+            functionAliasLookup: this.functionAliasLookup,
+            getPluginById: getRegisteredWorkPaperFunctionPluginById,
+        });
+    }
+    getAllFunctionPlugins() {
+        return getCapturedWorkPaperFunctionPlugins({
+            functionSnapshot: this.functionSnapshot.values(),
+            getPluginsById: getRegisteredWorkPaperFunctionPluginsById,
+        });
+    }
+    numberToDateTime(value) {
+        return numberToWorkPaperDateTime(value);
+    }
+    numberToDate(value) {
+        return numberToWorkPaperDate(value);
+    }
+    numberToTime(value) {
+        return numberToWorkPaperTime(value);
+    }
+}
+//# sourceMappingURL=work-paper-public-surface.js.map

package/dist/work-paper-public-surface.js.map

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

package/dist/work-paper-read-operations.d.ts

@@ -0,0 +1,52 @@
+import type { SpreadsheetEngine, SheetRecord } from '@bilig/core';
+import { type CellRangeRef, type CellSnapshot, type CellValue } from '@bilig/protocol';
+import { type WorkPaperSheetFormulas, type WorkPaperSheetValues } from './work-paper-sheet-read.js';
+import type { WorkPaperSheetDimensionCache } from './work-paper-sheet-dimension-cache.js';
+import type { RawCellContent, WorkPaperAddressFormatOptions, WorkPaperCellAddress, WorkPaperCellRange, WorkPaperCellType, WorkPaperCellValueDetailedType, WorkPaperCellValueType, WorkPaperSheetDimensions } from './work-paper-types.js';
+export interface WorkPaperReadOperations {
+    readonly getCellValue: (address: WorkPaperCellAddress) => CellValue;
+    readonly getCellFormula: (address: WorkPaperCellAddress) => string | undefined;
+    readonly getCellHyperlink: (address: WorkPaperCellAddress) => string | undefined;
+    readonly getCellSerialized: (address: WorkPaperCellAddress) => RawCellContent;
+    readonly getRangeValues: (range: WorkPaperCellRange) => CellValue[][];
+    readonly getRangeFormulas: (range: WorkPaperCellRange) => WorkPaperSheetFormulas;
+    readonly getRangeSerialized: (range: WorkPaperCellRange) => RawCellContent[][];
+    readonly getSheetValues: (sheetId: number) => WorkPaperSheetValues;
+    readonly getSheetFormulas: (sheetId: number) => WorkPaperSheetFormulas;
+    readonly getSheetSerialized: (sheetId: number) => RawCellContent[][];
+    readonly getAllSheetsValues: () => Record<string, CellValue[][]>;
+    readonly getAllSheetsFormulas: () => Record<string, WorkPaperSheetFormulas>;
+    readonly getAllSheetsSerialized: () => Record<string, RawCellContent[][]>;
+    readonly getAllSheetsDimensions: () => Record<string, WorkPaperSheetDimensions>;
+    readonly getSheetDimensions: (sheetId: number) => WorkPaperSheetDimensions;
+    readonly simpleCellAddressFromString: (value: string, defaultSheetId?: number) => WorkPaperCellAddress | undefined;
+    readonly simpleCellRangeFromString: (value: string, defaultSheetId?: number) => WorkPaperCellRange | undefined;
+    readonly simpleCellAddressToString: (address: WorkPaperCellAddress, optionsOrContextSheetId?: WorkPaperAddressFormatOptions | number) => string;
+    readonly simpleCellRangeToString: (range: WorkPaperCellRange, optionsOrContextSheetId?: WorkPaperAddressFormatOptions | number) => string;
+    readonly getCellType: (address: WorkPaperCellAddress) => WorkPaperCellType;
+    readonly doesCellHaveSimpleValue: (address: WorkPaperCellAddress) => boolean;
+    readonly doesCellHaveFormula: (address: WorkPaperCellAddress) => boolean;
+    readonly isCellEmpty: (address: WorkPaperCellAddress) => boolean;
+    readonly isCellPartOfArray: (address: WorkPaperCellAddress) => boolean;
+    readonly getCellValueType: (address: WorkPaperCellAddress) => WorkPaperCellValueType;
+    readonly getCellValueDetailedType: (address: WorkPaperCellAddress) => WorkPaperCellValueDetailedType;
+    readonly getCellValueFormat: (address: WorkPaperCellAddress) => string | undefined;
+}
+interface WorkPaperReadOperationsRuntime {
+    readonly getEngine: () => SpreadsheetEngine;
+    readonly getSheetDimensionCache: () => WorkPaperSheetDimensionCache;
+    readonly assertReadable: () => void;
+    readonly assertNotDisposed: () => void;
+    readonly prepareReadableState: () => void;
+    readonly flushPendingBatchOps: () => void;
+    readonly sheetRecord: (sheetId: number) => SheetRecord;
+    readonly sheetName: (sheetId: number) => string;
+    readonly a1: (address: Pick<WorkPaperCellAddress, 'row' | 'col'>) => string;
+    readonly rangeRef: (range: WorkPaperCellRange) => CellRangeRef;
+    readonly listSheetRecords: () => readonly SheetRecord[];
+    readonly requireSheetId: (name: string) => number;
+    readonly restorePublicFormula: (formula: string, ownerSheetId: number) => string;
+    readonly cellSnapshotToRawContent: (cell: CellSnapshot, ownerSheetId: number) => RawCellContent;
+}
+export declare function createWorkPaperReadOperations(runtime: WorkPaperReadOperationsRuntime): WorkPaperReadOperations;
+export {};

package/dist/work-paper-read-operations.js

@@ -0,0 +1,185 @@
+import { ValueTag } from '@bilig/protocol';
+import { buildWorkPaperDenseRange, collectSerializedWorkPaperSheets, collectWorkPaperSheetsByName, readWorkPaperSheetRange, } from './work-paper-sheet-read.js';
+import { formatWorkPaperCellAddressText, formatWorkPaperCellRangeText, parseWorkPaperCellAddressText, parseWorkPaperCellRangeText, resolveDefaultWorkPaperSheetName, } from './work-paper-address-format.js';
+import { readWorkPaperCellClassification, readWorkPaperCellFormula, readWorkPaperCellHasSimpleValue, readWorkPaperCellHyperlink, readWorkPaperCellPartOfArray, readWorkPaperCellValue, readWorkPaperCellValueDetailedType, readWorkPaperCellValueType, readWorkPaperRangeValues, } from './work-paper-cell-read.js';
+export function createWorkPaperReadOperations(runtime) {
+    const engine = () => runtime.getEngine();
+    const getCellValue = (address) => {
+        runtime.assertReadable();
+        return readWorkPaperCellValue({ engine: engine(), sheet: runtime.sheetRecord(address.sheet), address });
+    };
+    const getCellFormula = (address) => {
+        runtime.prepareReadableState();
+        return readWorkPaperCellFormula({
+            engine: engine(),
+            sheetName: runtime.sheetName(address.sheet),
+            a1: runtime.a1(address),
+            ownerSheetId: address.sheet,
+            restorePublicFormula: (formula, ownerSheetId) => runtime.restorePublicFormula(formula, ownerSheetId),
+        });
+    };
+    const getCellSerialized = (address) => {
+        runtime.prepareReadableState();
+        return runtime.cellSnapshotToRawContent(engine().getCell(runtime.sheetName(address.sheet), runtime.a1(address)), address.sheet);
+    };
+    const getRangeValues = (range) => {
+        runtime.assertReadable();
+        return readWorkPaperRangeValues({ engine: engine(), range, rangeRef: () => runtime.rangeRef(range) });
+    };
+    const getRangeFormulas = (range) => buildWorkPaperDenseRange(range, (address) => getCellFormula(address));
+    const getRangeSerialized = (range) => buildWorkPaperDenseRange(range, (address) => getCellSerialized(address));
+    const getSheetDimensions = (sheetId) => {
+        runtime.prepareReadableState();
+        const sheet = runtime.sheetRecord(sheetId);
+        const sheetDimensionCache = runtime.getSheetDimensionCache();
+        const cached = sheetDimensionCache.get(sheetId);
+        if (cached) {
+            return { width: cached.width, height: cached.height };
+        }
+        const dimensions = sheetDimensionCache.scan(sheet);
+        sheetDimensionCache.cache(sheetId, dimensions);
+        return dimensions;
+    };
+    const getCellValueFormat = (address) => {
+        runtime.flushPendingBatchOps();
+        return engine().getCell(runtime.sheetName(address.sheet), runtime.a1(address)).format;
+    };
+    const isCellEmpty = (address) => {
+        runtime.flushPendingBatchOps();
+        return engine().getCellValue(runtime.sheetName(address.sheet), runtime.a1(address)).tag === ValueTag.Empty;
+    };
+    const isCellPartOfArray = (address) => {
+        runtime.flushPendingBatchOps();
+        return readWorkPaperCellPartOfArray({
+            address,
+            spillRanges: engine().getSpillRanges(),
+            requireSheetId: (sheetName) => runtime.requireSheetId(sheetName),
+        });
+    };
+    return {
+        getCellValue,
+        getCellFormula,
+        getCellHyperlink(address) {
+            return readWorkPaperCellHyperlink(getCellFormula(address));
+        },
+        getCellSerialized,
+        getRangeValues,
+        getRangeFormulas,
+        getRangeSerialized,
+        getSheetValues(sheetId) {
+            return readWorkPaperSheetRange({
+                sheetId,
+                dimensions: getSheetDimensions(sheetId),
+                readRange: (range) => getRangeValues(range),
+            });
+        },
+        getSheetFormulas(sheetId) {
+            return readWorkPaperSheetRange({
+                sheetId,
+                dimensions: getSheetDimensions(sheetId),
+                readRange: (range) => getRangeFormulas(range),
+            });
+        },
+        getSheetSerialized(sheetId) {
+            return readWorkPaperSheetRange({
+                sheetId,
+                dimensions: getSheetDimensions(sheetId),
+                readRange: (range) => getRangeSerialized(range),
+            });
+        },
+        getAllSheetsValues() {
+            runtime.assertReadable();
+            return collectWorkPaperSheetsByName(runtime.listSheetRecords(), (sheet) => this.getSheetValues(sheet.id));
+        },
+        getAllSheetsFormulas() {
+            return collectWorkPaperSheetsByName(runtime.listSheetRecords(), (sheet) => this.getSheetFormulas(sheet.id));
+        },
+        getAllSheetsSerialized() {
+            return collectSerializedWorkPaperSheets({
+                sheets: runtime.listSheetRecords(),
+                readSheet: (sheet) => this.getSheetSerialized(sheet.id),
+                runtimeSnapshot: engine().exportSnapshot(),
+            });
+        },
+        getAllSheetsDimensions() {
+            return collectWorkPaperSheetsByName(runtime.listSheetRecords(), (sheet) => getSheetDimensions(sheet.id));
+        },
+        getSheetDimensions,
+        simpleCellAddressFromString(value, defaultSheetId) {
+            runtime.assertNotDisposed();
+            const defaultSheetName = resolveDefaultWorkPaperSheetName({
+                ...(defaultSheetId !== undefined ? { defaultSheetId } : {}),
+                sheets: runtime.listSheetRecords(),
+                sheetName: (sheetId) => runtime.sheetName(sheetId),
+            });
+            return parseWorkPaperCellAddressText({
+                value,
+                ...(defaultSheetName !== undefined ? { defaultSheetName } : {}),
+                requireSheetId: (sheetName) => runtime.requireSheetId(sheetName),
+            });
+        },
+        simpleCellRangeFromString(value, defaultSheetId) {
+            runtime.assertNotDisposed();
+            const defaultSheetName = resolveDefaultWorkPaperSheetName({
+                ...(defaultSheetId !== undefined ? { defaultSheetId } : {}),
+                sheets: runtime.listSheetRecords(),
+                sheetName: (sheetId) => runtime.sheetName(sheetId),
+            });
+            return parseWorkPaperCellRangeText({
+                value,
+                ...(defaultSheetName !== undefined ? { defaultSheetName } : {}),
+                requireSheetId: (sheetName) => runtime.requireSheetId(sheetName),
+            });
+        },
+        simpleCellAddressToString(address, optionsOrContextSheetId = {}) {
+            runtime.assertNotDisposed();
+            return formatWorkPaperCellAddressText({
+                address,
+                optionsOrContextSheetId,
+                sheetName: (sheetId) => runtime.sheetName(sheetId),
+            });
+        },
+        simpleCellRangeToString(range, optionsOrContextSheetId = {}) {
+            return formatWorkPaperCellRangeText({
+                range,
+                optionsOrContextSheetId,
+                sheetName: (sheetId) => runtime.sheetName(sheetId),
+            });
+        },
+        getCellType(address) {
+            runtime.flushPendingBatchOps();
+            const cell = engine().getCell(runtime.sheetName(address.sheet), runtime.a1(address));
+            return readWorkPaperCellClassification({
+                hasFormula: cell.formula !== undefined,
+                isEmpty: isCellEmpty(address),
+                isPartOfArray: isCellPartOfArray(address),
+            });
+        },
+        doesCellHaveSimpleValue(address) {
+            runtime.flushPendingBatchOps();
+            const cell = engine().getCell(runtime.sheetName(address.sheet), runtime.a1(address));
+            return readWorkPaperCellHasSimpleValue({
+                hasFormula: cell.formula !== undefined,
+                isEmpty: isCellEmpty(address),
+            });
+        },
+        doesCellHaveFormula(address) {
+            runtime.flushPendingBatchOps();
+            return engine().getCell(runtime.sheetName(address.sheet), runtime.a1(address)).formula !== undefined;
+        },
+        isCellEmpty,
+        isCellPartOfArray,
+        getCellValueType(address) {
+            return readWorkPaperCellValueType(getCellValue(address));
+        },
+        getCellValueDetailedType(address) {
+            const value = getCellValue(address);
+            return readWorkPaperCellValueDetailedType({
+                value,
+                format: value.tag === ValueTag.Number ? getCellValueFormat(address) : undefined,
+            });
+        },
+        getCellValueFormat,
+    };
+}
+//# sourceMappingURL=work-paper-read-operations.js.map

package/dist/work-paper-read-operations.js.map

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