@bilig/headless 0.8.0 → 0.8.2

package/dist/work-paper-emitter.js

@@ -0,0 +1,130 @@
+export class WorkPaperEmitter {
+    listeners = {
+        sheetAdded: new Set(),
+        sheetRemoved: new Set(),
+        sheetRenamed: new Set(),
+        namedExpressionAdded: new Set(),
+        namedExpressionRemoved: new Set(),
+        valuesUpdated: new Set(),
+        evaluationSuspended: new Set(),
+        evaluationResumed: new Set(),
+    };
+    detailedListeners = {
+        sheetAdded: new Set(),
+        sheetRemoved: new Set(),
+        sheetRenamed: new Set(),
+        namedExpressionAdded: new Set(),
+        namedExpressionRemoved: new Set(),
+        valuesUpdated: new Set(),
+        evaluationSuspended: new Set(),
+        evaluationResumed: new Set(),
+    };
+    on(eventName, listener) {
+        this.listeners[eventName].add(listener);
+    }
+    off(eventName, listener) {
+        this.listeners[eventName].delete(listener);
+    }
+    once(eventName, listener) {
+        const wrapper = (...args) => {
+            this.off(eventName, wrapper);
+            listener(...args);
+        };
+        this.on(eventName, wrapper);
+    }
+    onDetailed(eventName, listener) {
+        this.detailedListeners[eventName].add(listener);
+    }
+    offDetailed(eventName, listener) {
+        this.detailedListeners[eventName].delete(listener);
+    }
+    onceDetailed(eventName, listener) {
+        const wrapper = (payload) => {
+            this.offDetailed(eventName, wrapper);
+            listener(payload);
+        };
+        this.onDetailed(eventName, wrapper);
+    }
+    hasListeners(eventName) {
+        return this.listeners[eventName].size > 0 || this.detailedListeners[eventName].size > 0;
+    }
+    hasAnyListeners() {
+        return (Object.values(this.listeners).some((listeners) => listeners.size > 0) ||
+            Object.values(this.detailedListeners).some((listeners) => listeners.size > 0));
+    }
+    emitDetailed(event) {
+        this.dispatchDetailed(event);
+    }
+    dispatchDetailed(event) {
+        switch (event.eventName) {
+            case 'sheetAdded':
+                this.listeners.sheetAdded.forEach((listener) => {
+                    listener(event.payload.sheetName);
+                });
+                this.detailedListeners.sheetAdded.forEach((listener) => {
+                    listener(event.payload);
+                });
+                return;
+            case 'sheetRemoved':
+                this.listeners.sheetRemoved.forEach((listener) => {
+                    listener(event.payload.sheetName, event.payload.changes);
+                });
+                this.detailedListeners.sheetRemoved.forEach((listener) => {
+                    listener(event.payload);
+                });
+                return;
+            case 'sheetRenamed':
+                this.listeners.sheetRenamed.forEach((listener) => {
+                    listener(event.payload.oldName, event.payload.newName);
+                });
+                this.detailedListeners.sheetRenamed.forEach((listener) => {
+                    listener(event.payload);
+                });
+                return;
+            case 'namedExpressionAdded':
+                this.listeners.namedExpressionAdded.forEach((listener) => {
+                    listener(event.payload.name, event.payload.changes);
+                });
+                this.detailedListeners.namedExpressionAdded.forEach((listener) => {
+                    listener(event.payload);
+                });
+                return;
+            case 'namedExpressionRemoved':
+                this.listeners.namedExpressionRemoved.forEach((listener) => {
+                    listener(event.payload.name, event.payload.changes);
+                });
+                this.detailedListeners.namedExpressionRemoved.forEach((listener) => {
+                    listener(event.payload);
+                });
+                return;
+            case 'valuesUpdated':
+                this.listeners.valuesUpdated.forEach((listener) => {
+                    listener(event.payload.changes);
+                });
+                this.detailedListeners.valuesUpdated.forEach((listener) => {
+                    listener(event.payload);
+                });
+                return;
+            case 'evaluationSuspended':
+                this.listeners.evaluationSuspended.forEach((listener) => {
+                    listener();
+                });
+                this.detailedListeners.evaluationSuspended.forEach((listener) => {
+                    listener(event.payload);
+                });
+                return;
+            case 'evaluationResumed':
+                this.listeners.evaluationResumed.forEach((listener) => {
+                    listener(event.payload.changes);
+                });
+                this.detailedListeners.evaluationResumed.forEach((listener) => {
+                    listener(event.payload);
+                });
+        }
+    }
+    clear() {
+        Object.values(this.listeners).forEach((listeners) => listeners.clear());
+        Object.values(this.detailedListeners).forEach((listeners) => listeners.clear());
+    }
+}
+//# sourceMappingURL=work-paper-emitter.js.map

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

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

package/dist/work-paper-engine-event-tracker.d.ts

@@ -0,0 +1,24 @@
+import type { SpreadsheetEngine } from '@bilig/core';
+import { type TrackedEngineEvent } from './tracked-engine-event-refs.js';
+import type { WorkPaperCellChange } from './work-paper-types.js';
+export declare class WorkPaperEngineEventTracker {
+    private trackedEvents;
+    private pendingLazyTrackedChanges;
+    private captureEnabled;
+    private retainedEventIndicesDepth;
+    private unsubscribe;
+    get hasTrackedEvents(): boolean;
+    get hasPendingLazyChanges(): boolean;
+    get isCaptureEnabled(): boolean;
+    setCaptureEnabled(enabled: boolean): void;
+    attach(engine: SpreadsheetEngine): void;
+    dispose(): void;
+    clearEvents(): void;
+    drain(): TrackedEngineEvent[];
+    withRetainedIndices<T>(callback: () => T): T;
+    withCaptureDisabled<T>(callback: () => T): T;
+    trackLazyChanges(changes: WorkPaperCellChange[]): void;
+    materializePendingLazyChanges(options?: {
+        readonly preservePositions?: boolean;
+    }): void;
+}

package/dist/work-paper-engine-event-tracker.js

@@ -0,0 +1,92 @@
+import { detachTrackedIndexChanges, hasDeferredTrackedIndexChanges } from './tracked-cell-index-changes.js';
+import { captureTrackedEngineEvent } from './tracked-engine-event-refs.js';
+import { WorkPaperOperationError } from './work-paper-errors.js';
+function hasTrackedEngineSubscription(value) {
+    return typeof value === 'object' && value !== null && typeof Reflect.get(value, 'subscribeTracked') === 'function';
+}
+export class WorkPaperEngineEventTracker {
+    trackedEvents = [];
+    pendingLazyTrackedChanges = [];
+    captureEnabled = true;
+    retainedEventIndicesDepth = 0;
+    unsubscribe = null;
+    get hasTrackedEvents() {
+        return this.trackedEvents.length > 0;
+    }
+    get hasPendingLazyChanges() {
+        return this.pendingLazyTrackedChanges.length > 0;
+    }
+    get isCaptureEnabled() {
+        return this.captureEnabled;
+    }
+    setCaptureEnabled(enabled) {
+        this.captureEnabled = enabled;
+    }
+    attach(engine) {
+        this.unsubscribe?.();
+        this.trackedEvents = [];
+        if (!hasTrackedEngineSubscription(engine.events)) {
+            throw new WorkPaperOperationError('Tracked engine event subscription is unavailable');
+        }
+        this.unsubscribe = engine.events.subscribeTracked((event) => {
+            if (!this.captureEnabled) {
+                return;
+            }
+            this.trackedEvents.push(captureTrackedEngineEvent(event, {
+                borrowChangedCellIndexViews: this.retainedEventIndicesDepth > 0,
+                cloneChangedCellIndices: this.retainedEventIndicesDepth === 0,
+            }));
+        });
+    }
+    dispose() {
+        this.materializePendingLazyChanges();
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        this.clearEvents();
+    }
+    clearEvents() {
+        this.trackedEvents = [];
+    }
+    drain() {
+        const events = this.trackedEvents;
+        this.trackedEvents = [];
+        return events;
+    }
+    withRetainedIndices(callback) {
+        this.retainedEventIndicesDepth += 1;
+        try {
+            return callback();
+        }
+        finally {
+            this.retainedEventIndicesDepth -= 1;
+        }
+    }
+    withCaptureDisabled(callback) {
+        const previous = this.captureEnabled;
+        this.captureEnabled = false;
+        this.trackedEvents = [];
+        try {
+            return callback();
+        }
+        finally {
+            this.captureEnabled = previous;
+            this.trackedEvents = [];
+        }
+    }
+    trackLazyChanges(changes) {
+        if (hasDeferredTrackedIndexChanges(changes)) {
+            this.pendingLazyTrackedChanges.push(changes);
+        }
+    }
+    materializePendingLazyChanges(options = {}) {
+        if (this.pendingLazyTrackedChanges.length === 0) {
+            return;
+        }
+        const pending = this.pendingLazyTrackedChanges;
+        this.pendingLazyTrackedChanges = [];
+        for (let index = 0; index < pending.length; index += 1) {
+            detachTrackedIndexChanges(pending[index], options.preservePositions === undefined ? {} : { preservePositions: options.preservePositions });
+        }
+    }
+}
+//# sourceMappingURL=work-paper-engine-event-tracker.js.map

package/dist/work-paper-engine-event-tracker.js.map

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

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

@@ -11,6 +11,10 @@ export declare class WorkPaperConfigValueTooSmallError extends BaseWorkPaperErro
 export declare class WorkPaperEvaluationSuspendedError extends BaseWorkPaperError {
     constructor(message?: string);
 }
+export declare class WorkPaperEvaluationTimeoutError extends BaseWorkPaperError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
 export declare class WorkPaperExpectedOneOfValuesError extends BaseWorkPaperError {
     constructor(values: string, paramName: string);
 }

package/dist/work-paper-errors.js

@@ -19,6 +19,13 @@ export class WorkPaperEvaluationSuspendedError extends BaseWorkPaperError {
         super('WorkPaperEvaluationSuspendedError', message);
     }
 }
+export class WorkPaperEvaluationTimeoutError extends BaseWorkPaperError {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super('WorkPaperEvaluationTimeoutError', `Workbook evaluation timed out after ${timeoutMs}ms`);
+        this.timeoutMs = timeoutMs;
+    }
+}
 export class WorkPaperExpectedOneOfValuesError extends BaseWorkPaperError {
     constructor(values, paramName) {
         super('WorkPaperExpectedOneOfValuesError', `Expected one of ${values} for config parameter: ${paramName}`);

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

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

package/dist/work-paper-existing-numeric-fast-path.d.ts

@@ -0,0 +1,31 @@
+import { type SheetRecord, type SpreadsheetEngine } from '@bilig/core';
+import type { TrackedEngineEvent } from './tracked-engine-event-refs.js';
+import type { WorkPaperCellAddress, WorkPaperCellChange, WorkPaperChange } from './work-paper-types.js';
+export interface WorkPaperExistingNumericFastPathRuntime {
+    readonly canUseTrackedMutationFastPath: () => boolean;
+    readonly getEngine: () => SpreadsheetEngine;
+    readonly hasPendingLazyTrackedChanges: () => boolean;
+    readonly materializePendingLazyTrackedChanges: () => void;
+    readonly hasTrackedEngineEvents: () => boolean;
+    readonly drainTrackedEngineEvents: () => readonly TrackedEngineEvent[];
+    readonly clearTrackedEngineEvents: () => void;
+    readonly getEngineEventCaptureEnabled: () => boolean;
+    readonly setEngineEventCaptureEnabled: (enabled: boolean) => void;
+    readonly hasPendingBatchOps: () => boolean;
+    readonly flushPendingBatchOps: () => void;
+    readonly messageOf: (error: unknown, fallback: string) => string;
+    readonly trackedA1: (row: number, col: number) => string;
+    readonly orderChanges: (changes: WorkPaperCellChange[], explicitChangedCount: number | undefined) => WorkPaperChange[];
+    readonly computeTrackedChangesWithoutVisibilityCache: (events: readonly TrackedEngineEvent[], options: {
+        readonly preferLazyPublicChanges?: boolean;
+    }) => WorkPaperChange[];
+    readonly hasValuesUpdatedListeners: () => boolean;
+    readonly emitValuesUpdated: (changes: WorkPaperChange[]) => void;
+}
+export interface ExistingNumericWorkPaperCellContentsRequest {
+    readonly sheet: SheetRecord;
+    readonly address: WorkPaperCellAddress;
+    readonly cellIndex: number;
+    readonly value: number;
+}
+export declare function trySetExistingNumericWorkPaperCellContentsWithTrackedFastPath(runtime: WorkPaperExistingNumericFastPathRuntime, request: ExistingNumericWorkPaperCellContentsRequest): WorkPaperChange[] | null;

package/dist/work-paper-existing-numeric-fast-path.js

@@ -0,0 +1,120 @@
+import { ValueTag } from '@bilig/protocol';
+import { WORKPAPER_PUBLIC_ERROR_NAMES } from './work-paper-config.js';
+import { WorkPaperOperationError } from './work-paper-errors.js';
+import { trackedEventFromExistingNumericMutationResult, tryBuildDirectExistingNumericTrackedChanges, } from './work-paper-tracked-event-helpers.js';
+const FAST_EXISTING_NUMERIC_LITERAL_FLAGS = 2 /* CellFlags.HasFormula */ | 4 /* CellFlags.JsOnly */ | 8 /* CellFlags.InCycle */ | 64 /* CellFlags.SpillChild */ | 128 /* CellFlags.PivotOutput */;
+export function trySetExistingNumericWorkPaperCellContentsWithTrackedFastPath(runtime, request) {
+    if (!runtime.canUseTrackedMutationFastPath() || request.sheet.structureVersion !== 1) {
+        return null;
+    }
+    const engine = runtime.getEngine();
+    const cellStore = engine.workbook.cellStore;
+    if (cellStore.sheetIds[request.cellIndex] !== request.address.sheet ||
+        cellStore.rows[request.cellIndex] !== request.address.row ||
+        cellStore.cols[request.cellIndex] !== request.address.col ||
+        (cellStore.formulaIds[request.cellIndex] ?? 0) !== 0 ||
+        ((cellStore.flags[request.cellIndex] ?? 0) & FAST_EXISTING_NUMERIC_LITERAL_FLAGS) !== 0 ||
+        cellStore.tags[request.cellIndex] !== ValueTag.Number) {
+        return null;
+    }
+    const existingNumericMutationEngine = engine;
+    if (typeof existingNumericMutationEngine.tryApplyExistingNumericCellMutationAt !== 'function') {
+        return null;
+    }
+    if (runtime.hasPendingLazyTrackedChanges()) {
+        runtime.materializePendingLazyTrackedChanges();
+    }
+    if (runtime.hasTrackedEngineEvents()) {
+        runtime.drainTrackedEngineEvents();
+    }
+    let result = null;
+    const oldNumericValue = cellStore.numbers[request.cellIndex] ?? 0;
+    const previousCaptureEnabled = runtime.getEngineEventCaptureEnabled();
+    runtime.setEngineEventCaptureEnabled(false);
+    try {
+        if (runtime.hasPendingBatchOps()) {
+            runtime.flushPendingBatchOps();
+        }
+        result = existingNumericMutationEngine.tryApplyExistingNumericCellMutationAt({
+            sheetId: request.address.sheet,
+            row: request.address.row,
+            col: request.address.col,
+            cellIndex: request.cellIndex,
+            value: request.value,
+            emitTracked: false,
+            trustedExistingNumericLiteral: true,
+            oldNumericValue,
+        });
+    }
+    catch (error) {
+        if (error instanceof Error && WORKPAPER_PUBLIC_ERROR_NAMES.has(error.name)) {
+            throw error;
+        }
+        throw new WorkPaperOperationError(runtime.messageOf(error, 'Mutation failed'));
+    }
+    finally {
+        runtime.setEngineEventCaptureEnabled(previousCaptureEnabled);
+    }
+    if (!result) {
+        return null;
+    }
+    if (runtime.hasTrackedEngineEvents()) {
+        runtime.clearTrackedEngineEvents();
+    }
+    if (result.changedCellIndices === undefined &&
+        result.changedCellCount === 2 &&
+        result.firstChangedCellIndex === request.cellIndex &&
+        result.secondChangedCellIndex !== undefined &&
+        result.secondChangedNumericValue !== undefined &&
+        result.secondChangedRow !== undefined &&
+        result.secondChangedCol !== undefined) {
+        const changes = [
+            {
+                kind: 'cell',
+                address: { sheet: request.address.sheet, row: request.address.row, col: request.address.col },
+                sheetName: request.sheet.name,
+                a1: runtime.trackedA1(request.address.row, request.address.col),
+                newValue: { tag: ValueTag.Number, value: request.value },
+            },
+            {
+                kind: 'cell',
+                address: { sheet: request.address.sheet, row: result.secondChangedRow, col: result.secondChangedCol },
+                sheetName: request.sheet.name,
+                a1: runtime.trackedA1(result.secondChangedRow, result.secondChangedCol),
+                newValue: { tag: ValueTag.Number, value: result.secondChangedNumericValue },
+            },
+        ];
+        if (runtime.hasValuesUpdatedListeners()) {
+            runtime.emitValuesUpdated(changes);
+        }
+        return changes;
+    }
+    let changes = tryBuildDirectExistingNumericTrackedChanges({
+        result,
+        address: request.address,
+        cellIndex: request.cellIndex,
+        isPhysicalSheet: true,
+        sheetName: request.sheet.name,
+        value: request.value,
+        cellStore,
+        strings: engine.strings,
+        trackedA1: (row, col) => runtime.trackedA1(row, col),
+        orderChanges: (changesToOrder, explicitChangedCount) => runtime.orderChanges(changesToOrder, explicitChangedCount),
+    });
+    if (changes === null) {
+        const shouldEmitValuesUpdated = runtime.hasValuesUpdatedListeners();
+        const events = [trackedEventFromExistingNumericMutationResult(result)];
+        changes = runtime.computeTrackedChangesWithoutVisibilityCache(events, {
+            preferLazyPublicChanges: !shouldEmitValuesUpdated,
+        });
+        if (changes.length > 0 && shouldEmitValuesUpdated) {
+            runtime.emitValuesUpdated(changes);
+        }
+        return changes;
+    }
+    if (changes.length > 0 && runtime.hasValuesUpdatedListeners()) {
+        runtime.emitValuesUpdated(changes);
+    }
+    return changes;
+}
+//# sourceMappingURL=work-paper-existing-numeric-fast-path.js.map

package/dist/work-paper-existing-numeric-fast-path.js.map

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

package/dist/work-paper-fill-helpers.d.ts

@@ -0,0 +1,8 @@
+import type { RawCellContent, WorkPaperCellRange } from './work-paper-types.js';
+export declare function buildWorkPaperNullMatrixForRange(range: WorkPaperCellRange): RawCellContent[][];
+export declare function buildWorkPaperFillRangeData(input: {
+    readonly source: WorkPaperCellRange;
+    readonly target: WorkPaperCellRange;
+    readonly sourceSerialized: RawCellContent[][];
+    readonly offsetsFromTarget: boolean;
+}): RawCellContent[][];

package/dist/work-paper-fill-helpers.js

@@ -0,0 +1,34 @@
+import { translateFormulaReferences } from '@bilig/formula';
+export function buildWorkPaperNullMatrixForRange(range) {
+    const height = range.end.row - range.start.row + 1;
+    const width = range.end.col - range.start.col + 1;
+    return Array.from({ length: height }, () => Array.from({ length: width }, () => null));
+}
+export function buildWorkPaperFillRangeData(input) {
+    const targetHeight = input.target.end.row - input.target.start.row + 1;
+    const targetWidth = input.target.end.col - input.target.start.col + 1;
+    const sourceHeight = Math.max(input.sourceSerialized.length, 1);
+    const sourceWidth = Math.max(input.sourceSerialized[0]?.length ?? 0, 1);
+    const output = [];
+    for (let rowOffset = 0; rowOffset < targetHeight; rowOffset += 1) {
+        const row = [];
+        for (let colOffset = 0; colOffset < targetWidth; colOffset += 1) {
+            const targetRow = input.target.start.row + rowOffset;
+            const targetCol = input.target.start.col + colOffset;
+            const sourceRow = (((targetRow - (input.offsetsFromTarget ? input.target.start.row : input.source.start.row)) % sourceHeight) + sourceHeight) %
+                sourceHeight;
+            const sourceCol = (((targetCol - (input.offsetsFromTarget ? input.target.start.col : input.source.start.col)) % sourceWidth) + sourceWidth) %
+                sourceWidth;
+            const raw = input.sourceSerialized[sourceRow]?.[sourceCol] ?? null;
+            if (typeof raw === 'string' && raw.startsWith('=')) {
+                row.push(`=${translateFormulaReferences(raw.slice(1), targetRow - (input.source.start.row + sourceRow), targetCol - (input.source.start.col + sourceCol))}`);
+            }
+            else {
+                row.push(raw);
+            }
+        }
+        output.push(row);
+    }
+    return output;
+}
+//# sourceMappingURL=work-paper-fill-helpers.js.map

package/dist/work-paper-fill-helpers.js.map

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

package/dist/work-paper-formula-analysis.d.ts

@@ -0,0 +1,18 @@
+import type { CellValue } from '@bilig/protocol';
+import { type WorkPaperScratchWorkbook } from './work-paper-scratch-evaluator.js';
+import type { SerializedWorkPaperNamedExpression, WorkPaperConfig, WorkPaperSheets } from './work-paper-types.js';
+export interface WorkPaperFormulaAnalysisHooks {
+    readonly messageOf: (error: unknown, fallback: string) => string;
+}
+export declare function normalizeWorkPaperFormula(formula: string, hooks: WorkPaperFormulaAnalysisHooks): string;
+export declare function calculateWorkPaperFormula(args: {
+    readonly createWorkbook: (config: WorkPaperConfig) => WorkPaperScratchWorkbook;
+    readonly config: WorkPaperConfig;
+    readonly serializedSheets: WorkPaperSheets;
+    readonly namedExpressions: readonly SerializedWorkPaperNamedExpression[];
+    readonly formula: string;
+    readonly scope?: number;
+    readonly messageOf: (error: unknown, fallback: string) => string;
+}): CellValue | CellValue[][];
+export declare function getWorkPaperNamedExpressionsFromFormula(formula: string, hooks: WorkPaperFormulaAnalysisHooks): string[];
+export declare function validateWorkPaperFormula(formula: string): boolean;

package/dist/work-paper-formula-analysis.js

@@ -0,0 +1,54 @@
+import { parseFormula, serializeFormula } from '@bilig/formula';
+import { WorkPaperNotAFormulaError, WorkPaperParseError } from './work-paper-errors.js';
+import { collectFormulaNameRefs, stripLeadingEquals } from './work-paper-runtime-helpers.js';
+import { compareSheetNames } from './work-paper-sheet-inspection.js';
+import { calculateWorkPaperFormulaInScratchWorkbook } from './work-paper-scratch-evaluator.js';
+export function normalizeWorkPaperFormula(formula, hooks) {
+    if (!formula.trim().startsWith('=')) {
+        throw new WorkPaperNotAFormulaError();
+    }
+    try {
+        return `=${serializeFormula(parseFormula(stripLeadingEquals(formula)))}`;
+    }
+    catch (error) {
+        throw new WorkPaperParseError(hooks.messageOf(error, 'Unable to normalize formula'));
+    }
+}
+export function calculateWorkPaperFormula(args) {
+    if (!args.formula.trim().startsWith('=')) {
+        throw new WorkPaperNotAFormulaError();
+    }
+    try {
+        return calculateWorkPaperFormulaInScratchWorkbook(args);
+    }
+    catch (error) {
+        throw new WorkPaperParseError(args.messageOf(error, 'Unable to calculate formula'));
+    }
+}
+export function getWorkPaperNamedExpressionsFromFormula(formula, hooks) {
+    if (!formula.trim().startsWith('=')) {
+        throw new WorkPaperNotAFormulaError();
+    }
+    try {
+        const parsed = parseFormula(stripLeadingEquals(formula));
+        const names = new Set();
+        collectFormulaNameRefs(parsed, names);
+        return [...names].toSorted(compareSheetNames);
+    }
+    catch (error) {
+        throw new WorkPaperParseError(hooks.messageOf(error, 'Unable to inspect formula'));
+    }
+}
+export function validateWorkPaperFormula(formula) {
+    if (!formula.trim().startsWith('=')) {
+        return false;
+    }
+    try {
+        parseFormula(stripLeadingEquals(formula));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=work-paper-formula-analysis.js.map

package/dist/work-paper-formula-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-paper-formula-analysis.js","sourceRoot":"","sources":["../src/work-paper-formula-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE/D,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACvF,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,0CAA0C,EAAiC,MAAM,mCAAmC,CAAA;AAO7H,MAAM,UAAU,yBAAyB,CAAC,OAAe,EAAE,KAAoC;IAC7F,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,yBAAyB,EAAE,CAAA;IACvC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,gBAAgB,CAAC,YAAY,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAA;IACtF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAQzC;IACC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,yBAAyB,EAAE,CAAA;IACvC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,0CAA0C,CAAC,IAAI,CAAC,CAAA;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAA;IACrF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uCAAuC,CAAC,OAAe,EAAE,KAAoC;IAC3G,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,yBAAyB,EAAE,CAAA;IACvC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAA;QACxD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;QAC/B,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACrC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAA;IACpF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,CAAC;QACH,YAAY,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAA;QACzC,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/work-paper-formula-rewrite.d.ts

@@ -0,0 +1,22 @@
+export interface WorkPaperFormulaNamedExpressionBinding {
+    readonly publicName: string;
+    readonly internalName: string;
+    readonly scope?: number;
+}
+export interface WorkPaperFormulaFunctionBinding {
+    readonly publicName: string;
+    readonly internalName: string;
+}
+export declare function rewriteWorkPaperFormulaForStorage(input: {
+    readonly formula: string;
+    readonly ownerSheetId: number;
+    readonly namedExpressions: ReadonlyMap<string, WorkPaperFormulaNamedExpressionBinding>;
+    readonly functionAliasLookup: ReadonlyMap<string, WorkPaperFormulaFunctionBinding>;
+    readonly messageOf: (error: unknown, fallback: string) => string;
+}): string;
+export declare function restorePublicWorkPaperFormula(input: {
+    readonly formula: string;
+    readonly ownerSheetId: number;
+    readonly namedExpressions: ReadonlyMap<string, WorkPaperFormulaNamedExpressionBinding>;
+    readonly internalFunctionLookup: ReadonlyMap<string, WorkPaperFormulaFunctionBinding>;
+}): string;