@bilig/headless 0.8.0 → 0.8.2

package/dist/work-paper-matrix-application.js

@@ -0,0 +1,85 @@
+import { translateFormulaReferences } from '@bilig/formula';
+import { buildMatrixMutationPlan } from './matrix-mutation-plan.js';
+import { matrixContainsFormulaContent, stripLeadingEquals } from './work-paper-runtime-helpers.js';
+export function applyWorkPaperSerializedMatrix(input) {
+    const { serialized, sourceAnchor, targetLeftCorner } = input;
+    input.flushPendingBatchOps();
+    if (matrixContainsFormulaContent(serialized)) {
+        serialized.forEach((row, rowOffset) => {
+            row.forEach((raw, columnOffset) => {
+                const destination = {
+                    sheet: targetLeftCorner.sheet,
+                    row: targetLeftCorner.row + rowOffset,
+                    col: targetLeftCorner.col + columnOffset,
+                };
+                let nextValue = raw;
+                if (typeof raw === 'string' && raw.startsWith('=')) {
+                    nextValue = `=${translateFormulaReferences(raw.slice(1), destination.row - (sourceAnchor.row + rowOffset), destination.col - (sourceAnchor.col + columnOffset))}`;
+                }
+                input.applyRawContent(destination, nextValue);
+            });
+        });
+        return;
+    }
+    const { refs, potentialNewCells } = buildMatrixMutationPlan({
+        target: targetLeftCorner,
+        content: serialized,
+        rewriteFormula: (formula, destination, rowOffset, columnOffset) => input.rewriteFormulaForStorage(translateFormulaReferences(stripLeadingEquals(formula), destination.row - (sourceAnchor.row + rowOffset), destination.col - (sourceAnchor.col + columnOffset)), destination.sheet),
+    });
+    if (refs.length === 0) {
+        return;
+    }
+    input.applyCellMutationRefs(refs, {
+        captureUndo: true,
+        potentialNewCells,
+        source: 'local',
+        returnUndoOps: false,
+        reuseRefs: true,
+    });
+}
+export function applyWorkPaperMatrixContents(input) {
+    const options = input.options ?? {};
+    input.flushPendingBatchOps();
+    const planInput = {
+        target: input.address,
+        content: input.content,
+        rewriteFormula: (formula, destination) => input.rewriteFormulaForStorage(stripLeadingEquals(formula), destination.sheet),
+    };
+    if (options.deferLiteralAddresses !== undefined) {
+        planInput.deferLiteralAddresses = options.deferLiteralAddresses;
+    }
+    if (options.skipNulls !== undefined) {
+        planInput.skipNulls = options.skipNulls;
+    }
+    const { leadingRefs, formulaRefs, refs, potentialNewCells, trailingLiteralRefs } = buildMatrixMutationPlan(planInput);
+    if (refs.length === 0) {
+        return;
+    }
+    const applyPlannedRefs = (phaseRefs, applyOptions) => {
+        if (phaseRefs.length === 0) {
+            return;
+        }
+        input.applyCellMutationRefs(phaseRefs, applyOptions);
+    };
+    const phaseSource = options.captureUndo === false ? 'restore' : 'local';
+    const createApplyOptions = () => {
+        const applyOptions = {
+            potentialNewCells,
+            source: phaseSource,
+            returnUndoOps: false,
+            reuseRefs: true,
+        };
+        if (options.captureUndo !== undefined) {
+            applyOptions.captureUndo = options.captureUndo;
+        }
+        return applyOptions;
+    };
+    if (formulaRefs.length === 0) {
+        applyPlannedRefs(refs, createApplyOptions());
+        return;
+    }
+    applyPlannedRefs(leadingRefs, createApplyOptions());
+    applyPlannedRefs(formulaRefs, createApplyOptions());
+    applyPlannedRefs(trailingLiteralRefs, createApplyOptions());
+}
+//# sourceMappingURL=work-paper-matrix-application.js.map

package/dist/work-paper-matrix-application.js.map

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

package/dist/work-paper-mutation-queues.d.ts

@@ -0,0 +1,29 @@
+import type { EngineCellMutationRef } from '@bilig/core';
+import { type WorkPaperCellMutationApplyOptions } from './work-paper-cell-mutation-refs.js';
+import type { RawCellContent } from './work-paper-types.js';
+export interface WorkPaperMutationQueuesRuntime {
+    readonly applyCellMutationsAtWithOptions: (refs: readonly EngineCellMutationRef[], options: WorkPaperCellMutationApplyOptions) => void;
+    readonly updateSheetDimensionsAfterCellMutationRefs: (refs: readonly EngineCellMutationRef[]) => void;
+}
+export interface WorkPaperLiteralMutationQueueInput {
+    readonly sheetId: number;
+    readonly row: number;
+    readonly col: number;
+    readonly content: RawCellContent;
+    readonly cellIndex: number | undefined;
+}
+export declare class WorkPaperMutationQueues {
+    private readonly runtime;
+    private pendingBatchOps;
+    private pendingBatchPotentialNewCells;
+    private suspendedCellMutationRefs;
+    private suspendedCellMutationPotentialNewCells;
+    constructor(runtime: WorkPaperMutationQueuesRuntime);
+    hasPendingBatchOps(): boolean;
+    appendSuspendedCellMutationRefs(refs: readonly EngineCellMutationRef[]): void;
+    addSuspendedCellMutationPotentialNewCells(amount: number): void;
+    flushPendingBatchOps(): void;
+    flushSuspendedCellMutations(): void;
+    enqueueSuspendedLiteralMutation(input: WorkPaperLiteralMutationQueueInput): boolean;
+    enqueueDeferredBatchLiteral(input: WorkPaperLiteralMutationQueueInput): boolean;
+}

package/dist/work-paper-mutation-queues.js

@@ -0,0 +1,72 @@
+import { applyQueuedWorkPaperCellMutationRefs } from './work-paper-cell-mutation-refs.js';
+import { tryEnqueueWorkPaperLiteralMutation } from './work-paper-literal-mutation-queue.js';
+export class WorkPaperMutationQueues {
+    runtime;
+    pendingBatchOps = [];
+    pendingBatchPotentialNewCells = 0;
+    suspendedCellMutationRefs = [];
+    suspendedCellMutationPotentialNewCells = 0;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    hasPendingBatchOps() {
+        return this.pendingBatchOps.length > 0;
+    }
+    appendSuspendedCellMutationRefs(refs) {
+        this.suspendedCellMutationRefs.push(...refs);
+    }
+    addSuspendedCellMutationPotentialNewCells(amount) {
+        this.suspendedCellMutationPotentialNewCells += amount;
+    }
+    flushPendingBatchOps() {
+        if (this.pendingBatchOps.length === 0) {
+            return;
+        }
+        const refs = this.pendingBatchOps;
+        const potentialNewCells = this.pendingBatchPotentialNewCells;
+        this.pendingBatchOps = [];
+        this.pendingBatchPotentialNewCells = 0;
+        applyQueuedWorkPaperCellMutationRefs({
+            refs,
+            potentialNewCells,
+            applyCellMutationsAtWithOptions: this.runtime.applyCellMutationsAtWithOptions,
+            updateSheetDimensionsAfterCellMutationRefs: this.runtime.updateSheetDimensionsAfterCellMutationRefs,
+        });
+    }
+    flushSuspendedCellMutations() {
+        if (this.suspendedCellMutationRefs.length === 0) {
+            return;
+        }
+        const refs = this.suspendedCellMutationRefs;
+        const potentialNewCells = this.suspendedCellMutationPotentialNewCells;
+        this.suspendedCellMutationRefs = [];
+        this.suspendedCellMutationPotentialNewCells = 0;
+        applyQueuedWorkPaperCellMutationRefs({
+            refs,
+            potentialNewCells,
+            applyCellMutationsAtWithOptions: this.runtime.applyCellMutationsAtWithOptions,
+            updateSheetDimensionsAfterCellMutationRefs: this.runtime.updateSheetDimensionsAfterCellMutationRefs,
+        });
+    }
+    enqueueSuspendedLiteralMutation(input) {
+        return tryEnqueueWorkPaperLiteralMutation({
+            enabled: true,
+            queue: this.suspendedCellMutationRefs,
+            ...input,
+            addPotentialNewCell: () => {
+                this.suspendedCellMutationPotentialNewCells += 1;
+            },
+        });
+    }
+    enqueueDeferredBatchLiteral(input) {
+        return tryEnqueueWorkPaperLiteralMutation({
+            enabled: true,
+            queue: this.pendingBatchOps,
+            ...input,
+            addPotentialNewCell: () => {
+                this.pendingBatchPotentialNewCells += 1;
+            },
+        });
+    }
+}
+//# sourceMappingURL=work-paper-mutation-queues.js.map

package/dist/work-paper-mutation-queues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-paper-mutation-queues.js","sourceRoot":"","sources":["../src/work-paper-mutation-queues.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oCAAoC,EAA0C,MAAM,oCAAoC,CAAA;AACjI,OAAO,EAAE,kCAAkC,EAAE,MAAM,wCAAwC,CAAA;AAgB3F,MAAM,OAAO,uBAAuB;IAML;IALrB,eAAe,GAA4B,EAAE,CAAA;IAC7C,6BAA6B,GAAG,CAAC,CAAA;IACjC,yBAAyB,GAA4B,EAAE,CAAA;IACvD,sCAAsC,GAAG,CAAC,CAAA;IAElD,YAA6B,OAAuC;QAAvC,YAAO,GAAP,OAAO,CAAgC;IAAG,CAAC;IAExE,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAA;IACxC,CAAC;IAED,+BAA+B,CAAC,IAAsC;QACpE,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,yCAAyC,CAAC,MAAc;QACtD,IAAI,CAAC,sCAAsC,IAAI,MAAM,CAAA;IACvD,CAAC;IAED,oBAAoB;QAClB,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAA;QACjC,MAAM,iBAAiB,GAAG,IAAI,CAAC,6BAA6B,CAAA;QAC5D,IAAI,CAAC,eAAe,GAAG,EAAE,CAAA;QACzB,IAAI,CAAC,6BAA6B,GAAG,CAAC,CAAA;QACtC,oCAAoC,CAAC;YACnC,IAAI;YACJ,iBAAiB;YACjB,+BAA+B,EAAE,IAAI,CAAC,OAAO,CAAC,+BAA+B;YAC7E,0CAA0C,EAAE,IAAI,CAAC,OAAO,CAAC,0CAA0C;SACpG,CAAC,CAAA;IACJ,CAAC;IAED,2BAA2B;QACzB,IAAI,IAAI,CAAC,yBAAyB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,yBAAyB,CAAA;QAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,sCAAsC,CAAA;QACrE,IAAI,CAAC,yBAAyB,GAAG,EAAE,CAAA;QACnC,IAAI,CAAC,sCAAsC,GAAG,CAAC,CAAA;QAC/C,oCAAoC,CAAC;YACnC,IAAI;YACJ,iBAAiB;YACjB,+BAA+B,EAAE,IAAI,CAAC,OAAO,CAAC,+BAA+B;YAC7E,0CAA0C,EAAE,IAAI,CAAC,OAAO,CAAC,0CAA0C;SACpG,CAAC,CAAA;IACJ,CAAC;IAED,+BAA+B,CAAC,KAAyC;QACvE,OAAO,kCAAkC,CAAC;YACxC,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI,CAAC,yBAAyB;YACrC,GAAG,KAAK;YACR,mBAAmB,EAAE,GAAG,EAAE;gBACxB,IAAI,CAAC,sCAAsC,IAAI,CAAC,CAAA;YAClD,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;IAED,2BAA2B,CAAC,KAAyC;QACnE,OAAO,kCAAkC,CAAC;YACxC,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI,CAAC,eAAe;YAC3B,GAAG,KAAK;YACR,mBAAmB,EAAE,GAAG,EAAE;gBACxB,IAAI,CAAC,6BAA6B,IAAI,CAAC,CAAA;YACzC,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/work-paper-named-expression-fast-path.d.ts

@@ -0,0 +1,37 @@
+import { type CellValue, type WorkbookDefinedNameValueSnapshot } from '@bilig/protocol';
+import { type InternalNamedExpression } from './work-paper-named-expression-helpers.js';
+import type { TrackedEngineEvent } from './tracked-engine-event-refs.js';
+import type { RawCellContent, SerializedWorkPaperNamedExpression, WorkPaperCellChange, WorkPaperChange } from './work-paper-types.js';
+type NamedExpressionValue = CellValue | CellValue[][];
+export interface WorkPaperNamedExpressionFastPathRuntime {
+    readonly canUseNamedExpressionChangeFastPath: () => boolean;
+    readonly assertNotDisposed: () => void;
+    readonly materializePendingLazyTrackedChanges: () => void;
+    readonly downgradeTrackedBatchFastPath: () => void;
+    readonly getCachedNamedExpressionValue: (key: string) => NamedExpressionValue | undefined;
+    readonly setCachedNamedExpressionValue: (key: string, value: NamedExpressionValue) => void;
+    readonly evaluateNamedExpression: (expression: InternalNamedExpression) => NamedExpressionValue;
+    readonly hasAnyListeners: () => boolean;
+    readonly toDefinedNameSnapshot: (expression: RawCellContent, scope: number | undefined) => WorkbookDefinedNameValueSnapshot;
+    readonly upsertNumericDefinedNameFast: (name: string, value: WorkbookDefinedNameValueSnapshot, numericValue: number) => readonly number[] | null;
+    readonly setNamedExpressionRecord: (key: string, record: InternalNamedExpression) => void;
+    readonly readSingleTrackedCellChange: (cellIndex: number) => WorkPaperCellChange | undefined;
+    readonly orderCellChanges: (changes: WorkPaperCellChange[], explicitChangedCount: number | undefined) => WorkPaperChange[];
+    readonly drainTrackedEngineEvents: () => readonly TrackedEngineEvent[];
+    readonly withRetainedTrackedEngineEventIndices: (callback: () => void) => void;
+    readonly upsertNamedExpressionInternal: (expression: SerializedWorkPaperNamedExpression) => void;
+    readonly namedExpressionRecord: (name: string, scope: number | undefined) => InternalNamedExpression;
+    readonly computeTrackedChangesWithoutVisibilityCache: (events: readonly TrackedEngineEvent[], options: {
+        readonly preferLazyPublicChanges?: boolean;
+    }) => WorkPaperChange[];
+    readonly messageOf: (error: unknown, fallback: string) => string;
+}
+export interface WorkPaperNamedExpressionFastPathRequest {
+    readonly existing: InternalNamedExpression;
+    readonly expressionName: string;
+    readonly expression: RawCellContent;
+    readonly scope?: number;
+    readonly options?: Record<string, string | number | boolean>;
+}
+export declare function tryCaptureWorkPaperNamedExpressionChangeWithoutSnapshots(runtime: WorkPaperNamedExpressionFastPathRuntime, request: WorkPaperNamedExpressionFastPathRequest): WorkPaperChange[] | null;
+export {};

package/dist/work-paper-named-expression-fast-path.js

@@ -0,0 +1,100 @@
+import { ValueTag } from '@bilig/protocol';
+import { WORKPAPER_PUBLIC_ERROR_NAMES } from './work-paper-config.js';
+import { WorkPaperOperationError } from './work-paper-errors.js';
+import { cloneNamedExpressionValue, createInternalNamedExpressionRecord, createSerializedWorkPaperNamedExpression, createWorkPaperNamedExpressionChange, } from './work-paper-named-expression-helpers.js';
+import { makeNamedExpressionKey, matrixValuesEqual, tryEvaluateSimpleNamedExpression } from './work-paper-runtime-helpers.js';
+export function tryCaptureWorkPaperNamedExpressionChangeWithoutSnapshots(runtime, request) {
+    if (!runtime.canUseNamedExpressionChangeFastPath()) {
+        return null;
+    }
+    runtime.assertNotDisposed();
+    runtime.materializePendingLazyTrackedChanges();
+    runtime.downgradeTrackedBatchFastPath();
+    if (!runtime.canUseNamedExpressionChangeFastPath()) {
+        return null;
+    }
+    const key = makeNamedExpressionKey(request.existing.publicName, request.existing.scope);
+    const cachedBeforeValue = runtime.getCachedNamedExpressionValue(key);
+    const beforeValue = cachedBeforeValue ?? runtime.evaluateNamedExpression(request.existing);
+    const afterScalarValue = tryEvaluateSimpleNamedExpression(request.expression);
+    if (afterScalarValue?.tag === ValueTag.Number && !runtime.hasAnyListeners()) {
+        const directChanges = tryCaptureNumericNamedExpressionChange(runtime, request, key, beforeValue, afterScalarValue.value);
+        if (directChanges) {
+            return directChanges;
+        }
+    }
+    runtime.drainTrackedEngineEvents();
+    try {
+        runtime.withRetainedTrackedEngineEventIndices(() => {
+            runtime.upsertNamedExpressionInternal({
+                ...createSerializedWorkPaperNamedExpression({
+                    name: request.expressionName,
+                    expression: request.expression,
+                    scope: request.scope,
+                    options: request.options,
+                }),
+            });
+        });
+    }
+    catch (error) {
+        throw publicOrOperationError(runtime, error);
+    }
+    const updated = runtime.namedExpressionRecord(request.expressionName, request.scope);
+    const afterValue = cloneNamedExpressionValue(runtime.evaluateNamedExpression(updated));
+    runtime.setCachedNamedExpressionValue(key, cloneNamedExpressionValue(afterValue));
+    const cellChanges = runtime.computeTrackedChangesWithoutVisibilityCache(runtime.drainTrackedEngineEvents(), {
+        preferLazyPublicChanges: !runtime.hasAnyListeners(),
+    });
+    if (matrixValuesEqual(beforeValue, afterValue)) {
+        return cellChanges;
+    }
+    return [
+        ...cellChanges,
+        createWorkPaperNamedExpressionChange({
+            name: updated.publicName,
+            scope: updated.scope,
+            newValue: cloneNamedExpressionValue(afterValue),
+        }),
+    ];
+}
+function tryCaptureNumericNamedExpressionChange(runtime, request, cacheKey, beforeValue, afterValue) {
+    const record = createInternalNamedExpressionRecord(createSerializedWorkPaperNamedExpression({
+        name: request.expressionName,
+        expression: request.expression,
+        scope: request.scope,
+        options: request.options,
+    }));
+    const definedNameSnapshot = runtime.toDefinedNameSnapshot(request.expression, request.scope);
+    try {
+        const changedCellIndices = runtime.upsertNumericDefinedNameFast(record.internalName, definedNameSnapshot, afterValue);
+        if (changedCellIndices) {
+            runtime.setNamedExpressionRecord(makeNamedExpressionKey(record.publicName, record.scope), record);
+            runtime.setCachedNamedExpressionValue(cacheKey, cloneNamedExpressionValue({ tag: ValueTag.Number, value: afterValue }));
+            const cellChanges = changedCellIndices
+                .map((cellIndex) => runtime.readSingleTrackedCellChange(cellIndex))
+                .filter((change) => change !== undefined);
+            const orderedCellChanges = cellChanges.length > 1 ? runtime.orderCellChanges(cellChanges, cellChanges.length) : cellChanges;
+            return matrixValuesEqual(beforeValue, { tag: ValueTag.Number, value: afterValue })
+                ? orderedCellChanges
+                : [
+                    ...orderedCellChanges,
+                    createWorkPaperNamedExpressionChange({
+                        name: record.publicName,
+                        scope: record.scope,
+                        newValue: cloneNamedExpressionValue({ tag: ValueTag.Number, value: afterValue }),
+                    }),
+                ];
+        }
+    }
+    catch (error) {
+        throw publicOrOperationError(runtime, error);
+    }
+    return null;
+}
+function publicOrOperationError(runtime, error) {
+    if (error instanceof Error && WORKPAPER_PUBLIC_ERROR_NAMES.has(error.name)) {
+        return error;
+    }
+    return new WorkPaperOperationError(runtime.messageOf(error, 'Mutation failed'));
+}
+//# sourceMappingURL=work-paper-named-expression-fast-path.js.map

package/dist/work-paper-named-expression-fast-path.js.map

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

package/dist/work-paper-named-expression-helpers.d.ts

@@ -0,0 +1,54 @@
+import { type CellSnapshot, type CellValue, type WorkbookDefinedNameValueSnapshot } from '@bilig/protocol';
+import type { RawCellContent, SerializedWorkPaperNamedExpression, WorkPaperChange, WorkPaperNamedExpression } from './work-paper-types.js';
+export interface InternalNamedExpression {
+    publicName: string;
+    normalizedName: string;
+    internalName: string;
+    scope?: number;
+    expression: RawCellContent;
+    options?: Record<string, string | number | boolean>;
+}
+export type WorkPaperNamedExpressionValue = CellValue | CellValue[][];
+export type WorkPaperNamedExpressionValueSnapshot = Map<string, WorkPaperNamedExpressionValue>;
+export declare function cloneNamedExpressionValue(value: CellValue | CellValue[][]): CellValue | CellValue[][];
+export declare function captureWorkPaperNamedExpressionValueSnapshot(expressions: Iterable<InternalNamedExpression>, evaluateExpression: (expression: InternalNamedExpression) => WorkPaperNamedExpressionValue): WorkPaperNamedExpressionValueSnapshot;
+export declare function compareWorkPaperNamedExpressionChanges(left: WorkPaperChange, right: WorkPaperChange): number;
+export declare function createWorkPaperNamedExpressionChange(args: {
+    readonly name: string;
+    readonly scope: number | undefined;
+    readonly newValue: CellValue | CellValue[][];
+}): WorkPaperChange;
+export declare function createSerializedWorkPaperNamedExpression(args: {
+    readonly name: string;
+    readonly expression: RawCellContent;
+    readonly scope: number | undefined;
+    readonly options: Record<string, string | number | boolean> | undefined;
+}): SerializedWorkPaperNamedExpression;
+export declare function publicWorkPaperNamedExpressionFromInternal(expression: InternalNamedExpression): WorkPaperNamedExpression;
+export declare function computeWorkPaperNamedExpressionChanges(args: {
+    readonly beforeNames: WorkPaperNamedExpressionValueSnapshot;
+    readonly afterNames: WorkPaperNamedExpressionValueSnapshot;
+    readonly expressionsByKey: ReadonlyMap<string, InternalNamedExpression>;
+}): WorkPaperChange[];
+export declare function validateWorkPaperNamedExpression(args: {
+    readonly expressionName: string;
+    readonly expression: RawCellContent;
+    readonly scope?: number;
+    readonly requireScope: (scope: number) => void;
+    readonly messageOf: (error: unknown, fallback: string) => string;
+}): void;
+export declare function createInternalNamedExpressionRecord(expression: SerializedWorkPaperNamedExpression): InternalNamedExpression;
+export declare function listWorkPaperNamedExpressions(expressions: Iterable<InternalNamedExpression>, scope?: number): string[];
+export declare function serializeWorkPaperNamedExpressions(expressions: Iterable<InternalNamedExpression>): SerializedWorkPaperNamedExpression[];
+export declare function workPaperNamedExpressionToDefinedNameSnapshot(args: {
+    readonly expression: RawCellContent;
+    readonly scope?: number;
+    readonly defaultScopeId: number;
+    readonly rewriteFormulaForStorage: (formula: string, ownerSheetId: number) => string;
+}): WorkbookDefinedNameValueSnapshot;
+export declare function evaluateWorkPaperNamedExpression(expression: InternalNamedExpression, calculateFormula: (formula: string, scope?: number) => CellValue | CellValue[][]): CellValue | CellValue[][];
+export declare function workPaperCellSnapshotToRawContent(args: {
+    readonly cell: CellSnapshot;
+    readonly ownerSheetId: number;
+    readonly restorePublicFormula: (formula: string, ownerSheetId: number) => string;
+}): RawCellContent;

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

@@ -0,0 +1,179 @@
+import { isCellReferenceText, parseFormula } from '@bilig/formula';
+import { ValueTag } from '@bilig/protocol';
+import { WorkPaperNamedExpressionNameIsInvalidError, WorkPaperNoRelativeAddressesAllowedError, WorkPaperUnableToParseError, } from './work-paper-errors.js';
+import { cloneCellValue, formulaHasRelativeReferences, isFormulaContent, makeInternalScopedName, makeNamedExpressionKey, matrixValuesEqual, normalizeName, scalarValueFromLiteral, stripLeadingEquals, tryEvaluateSimpleNamedExpression, tryEvaluateSimpleScalarFormulaBody, tryReadSimpleScalarFormulaBody, } from './work-paper-runtime-helpers.js';
+import { compareSheetNames } from './work-paper-sheet-inspection.js';
+export function cloneNamedExpressionValue(value) {
+    if (!Array.isArray(value)) {
+        return cloneCellValue(value);
+    }
+    return value.map((row) => row.map((cell) => cloneCellValue(cell)));
+}
+export function captureWorkPaperNamedExpressionValueSnapshot(expressions, evaluateExpression) {
+    const snapshot = new Map();
+    [...expressions].forEach((expression) => {
+        snapshot.set(makeNamedExpressionKey(expression.publicName, expression.scope), cloneNamedExpressionValue(evaluateExpression(expression)));
+    });
+    return snapshot;
+}
+export function compareWorkPaperNamedExpressionChanges(left, right) {
+    if (left.kind !== 'named-expression' || right.kind !== 'named-expression') {
+        return 0;
+    }
+    return (left.scope ?? -1) - (right.scope ?? -1) || left.name.localeCompare(right.name);
+}
+export function createWorkPaperNamedExpressionChange(args) {
+    const change = {
+        kind: 'named-expression',
+        name: args.name,
+        newValue: args.newValue,
+    };
+    if (args.scope !== undefined) {
+        change.scope = args.scope;
+    }
+    return change;
+}
+export function createSerializedWorkPaperNamedExpression(args) {
+    const expression = {
+        name: args.name,
+        expression: args.expression,
+    };
+    if (args.scope !== undefined) {
+        expression.scope = args.scope;
+    }
+    if (args.options !== undefined) {
+        expression.options = structuredClone(args.options);
+    }
+    return expression;
+}
+export function publicWorkPaperNamedExpressionFromInternal(expression) {
+    return createSerializedWorkPaperNamedExpression({
+        name: expression.publicName,
+        expression: expression.expression,
+        scope: expression.scope,
+        options: expression.options,
+    });
+}
+export function computeWorkPaperNamedExpressionChanges(args) {
+    const namedExpressionChanges = [];
+    args.afterNames.forEach((afterValue, key) => {
+        const beforeValue = args.beforeNames.get(key);
+        if (matrixValuesEqual(beforeValue, afterValue)) {
+            return;
+        }
+        const expression = args.expressionsByKey.get(key);
+        if (!expression) {
+            return;
+        }
+        namedExpressionChanges.push(createWorkPaperNamedExpressionChange({
+            name: expression.publicName,
+            scope: expression.scope,
+            newValue: cloneNamedExpressionValue(afterValue),
+        }));
+    });
+    return namedExpressionChanges.toSorted(compareWorkPaperNamedExpressionChanges);
+}
+export function validateWorkPaperNamedExpression(args) {
+    const trimmed = args.expressionName.trim();
+    if (!/^[A-Za-z_][A-Za-z0-9_.]*$/.test(trimmed) || isCellReferenceText(trimmed)) {
+        throw new WorkPaperNamedExpressionNameIsInvalidError(args.expressionName);
+    }
+    if (args.scope !== undefined) {
+        args.requireScope(args.scope);
+    }
+    if (isFormulaContent(args.expression)) {
+        const simpleBody = tryReadSimpleScalarFormulaBody(args.expression);
+        if (simpleBody !== undefined && tryEvaluateSimpleScalarFormulaBody(simpleBody) !== undefined) {
+            return;
+        }
+        try {
+            const parsed = parseFormula(stripLeadingEquals(args.expression));
+            if (formulaHasRelativeReferences(parsed)) {
+                throw new WorkPaperNoRelativeAddressesAllowedError();
+            }
+        }
+        catch (error) {
+            if (error instanceof WorkPaperNoRelativeAddressesAllowedError) {
+                throw error;
+            }
+            throw new WorkPaperUnableToParseError({
+                expressionName: args.expressionName,
+                reason: args.messageOf(error, `Invalid named expression formula for '${args.expressionName}'`),
+            });
+        }
+    }
+}
+export function createInternalNamedExpressionRecord(expression) {
+    const trimmed = expression.name.trim();
+    const record = {
+        publicName: trimmed,
+        normalizedName: normalizeName(trimmed),
+        internalName: expression.scope === undefined ? trimmed : makeInternalScopedName(expression.scope, trimmed),
+        expression: expression.expression,
+    };
+    if (expression.scope !== undefined) {
+        record.scope = expression.scope;
+    }
+    if (expression.options !== undefined) {
+        record.options = structuredClone(expression.options);
+    }
+    return record;
+}
+export function listWorkPaperNamedExpressions(expressions, scope) {
+    return [...expressions]
+        .filter((expression) => expression.scope === scope)
+        .map((expression) => expression.publicName)
+        .toSorted(compareSheetNames);
+}
+export function serializeWorkPaperNamedExpressions(expressions) {
+    return [...expressions]
+        .map((expression) => publicWorkPaperNamedExpressionFromInternal(expression))
+        .toSorted((left, right) => (left.scope ?? -1) - (right.scope ?? -1) || left.name.localeCompare(right.name));
+}
+export function workPaperNamedExpressionToDefinedNameSnapshot(args) {
+    if (args.expression === null || typeof args.expression === 'number' || typeof args.expression === 'boolean') {
+        return args.expression;
+    }
+    if (typeof args.expression === 'string' && args.expression.trim().startsWith('=')) {
+        const simpleBody = tryReadSimpleScalarFormulaBody(args.expression);
+        if (simpleBody !== undefined && tryEvaluateSimpleScalarFormulaBody(simpleBody) !== undefined) {
+            return {
+                kind: 'formula',
+                formula: `=${simpleBody}`,
+            };
+        }
+        return {
+            kind: 'formula',
+            formula: `=${args.rewriteFormulaForStorage(stripLeadingEquals(args.expression), args.scope ?? args.defaultScopeId)}`,
+        };
+    }
+    return args.expression;
+}
+export function evaluateWorkPaperNamedExpression(expression, calculateFormula) {
+    const raw = expression.expression;
+    const simpleValue = tryEvaluateSimpleNamedExpression(raw);
+    if (simpleValue !== undefined) {
+        return simpleValue;
+    }
+    return typeof raw === 'string' ? calculateFormula(raw, expression.scope) : scalarValueFromLiteral(raw);
+}
+export function workPaperCellSnapshotToRawContent(args) {
+    if (args.cell.formula) {
+        return `=${args.restorePublicFormula(args.cell.formula, args.ownerSheetId)}`;
+    }
+    if (args.cell.input !== undefined) {
+        return args.cell.input;
+    }
+    switch (args.cell.value.tag) {
+        case ValueTag.Empty:
+        case ValueTag.Error:
+            return null;
+        case ValueTag.Number:
+            return args.cell.value.value;
+        case ValueTag.Boolean:
+            return args.cell.value.value;
+        case ValueTag.String:
+            return args.cell.value.value;
+    }
+}
+//# sourceMappingURL=work-paper-named-expression-helpers.js.map

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

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

package/dist/work-paper-named-expression-operations.d.ts

@@ -0,0 +1,39 @@
+import type { CellValue } from '@bilig/protocol';
+import { type InternalNamedExpression } from './work-paper-named-expression-helpers.js';
+import type { RawCellContent, SerializedWorkPaperNamedExpression, WorkPaperChange, WorkPaperDetailedEventMap, WorkPaperNamedExpression } from './work-paper-types.js';
+type NamedExpressionEvent = {
+    readonly eventName: 'namedExpressionAdded';
+    readonly payload: WorkPaperDetailedEventMap['namedExpressionAdded'];
+} | {
+    readonly eventName: 'namedExpressionRemoved';
+    readonly payload: WorkPaperDetailedEventMap['namedExpressionRemoved'];
+};
+export interface WorkPaperNamedExpressionOperationsRuntime {
+    readonly assertReadable: () => void;
+    readonly getNamedExpression: (name: string, scope?: number) => InternalNamedExpression | undefined;
+    readonly getNamedExpressionValues: () => Iterable<InternalNamedExpression>;
+    readonly evaluateNamedExpression: (expression: InternalNamedExpression) => CellValue | CellValue[][];
+    readonly isItPossibleToAddNamedExpression: (expressionName: string, expression: RawCellContent, scope?: number) => boolean;
+    readonly isItPossibleToRemoveNamedExpression: (expressionName: string, scope?: number) => boolean;
+    readonly validateNamedExpression: (expressionName: string, expression: RawCellContent, scope?: number) => void;
+    readonly tryCaptureNamedExpressionChangeWithoutSnapshots: (existing: InternalNamedExpression, expressionName: string, expression: RawCellContent, scope?: number, options?: Record<string, string | number | boolean>) => WorkPaperChange[] | null;
+    readonly captureChanges: (event: NamedExpressionEvent | undefined, mutate: () => void) => WorkPaperChange[];
+    readonly upsertNamedExpressionInternal: (expression: SerializedWorkPaperNamedExpression, options: {
+        readonly duringInitialization: boolean;
+        readonly skipValidation?: boolean;
+    }) => void;
+    readonly deleteNamedExpressionRecord: (name: string, scope?: number) => void;
+    readonly deleteDefinedName: (internalName: string) => void;
+}
+export interface WorkPaperNamedExpressionOperations {
+    readonly getNamedExpressionValue: (name: string, scope?: number) => CellValue | CellValue[][] | undefined;
+    readonly getNamedExpressionFormula: (name: string, scope?: number) => string | undefined;
+    readonly getNamedExpression: (name: string, scope?: number) => WorkPaperNamedExpression | undefined;
+    readonly addNamedExpression: (expressionName: string, expression: RawCellContent, scope?: number, options?: Record<string, string | number | boolean>) => WorkPaperChange[];
+    readonly changeNamedExpression: (expressionName: string, expression: RawCellContent, scope?: number, options?: Record<string, string | number | boolean>) => WorkPaperChange[];
+    readonly removeNamedExpression: (expressionName: string, scope?: number) => WorkPaperChange[];
+    readonly listNamedExpressions: (scope?: number) => string[];
+    readonly getAllNamedExpressionsSerialized: () => SerializedWorkPaperNamedExpression[];
+}
+export declare function createWorkPaperNamedExpressionOperations(runtime: WorkPaperNamedExpressionOperationsRuntime): WorkPaperNamedExpressionOperations;
+export {};