@bilig/headless 0.8.0 → 0.8.2

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

@@ -0,0 +1,305 @@
+import { ValueTag } from '@bilig/protocol';
+import { isArrayValue } from '@bilig/formula';
+import { WorkPaperInvalidArgumentsError } from './work-paper-errors.js';
+export function emptyValue() {
+    return { tag: ValueTag.Empty };
+}
+export function errorValue(code) {
+    return { tag: ValueTag.Error, code };
+}
+export function scalarValueFromLiteral(value) {
+    if (value === null) {
+        return emptyValue();
+    }
+    if (typeof value === 'number') {
+        return { tag: ValueTag.Number, value };
+    }
+    if (typeof value === 'boolean') {
+        return { tag: ValueTag.Boolean, value };
+    }
+    return { tag: ValueTag.String, value, stringId: 0 };
+}
+export function scalarFromResult(result) {
+    if (!isArrayValue(result)) {
+        return result;
+    }
+    return result.values[0] ?? emptyValue();
+}
+const SIMPLE_NUMERIC_FORMULA_RE = /^[+-]?(?:(?:\d+(?:\.\d*)?)|(?:\.\d+))(?:[Ee][+-]?\d+)?$/;
+export function tryReadSimpleScalarFormulaBody(raw) {
+    if (typeof raw !== 'string') {
+        return undefined;
+    }
+    const trimmed = raw.trim();
+    if (!trimmed.startsWith('=')) {
+        return undefined;
+    }
+    const body = trimmed.slice(1).trim();
+    return body.length === 0 ? undefined : body;
+}
+export function tryEvaluateSimpleScalarFormulaBody(body) {
+    if (SIMPLE_NUMERIC_FORMULA_RE.test(body)) {
+        const value = Number(body);
+        return Number.isFinite(value) ? { tag: ValueTag.Number, value: Object.is(value, -0) ? 0 : value } : undefined;
+    }
+    const upper = body.toUpperCase();
+    if (upper === 'TRUE') {
+        return { tag: ValueTag.Boolean, value: true };
+    }
+    if (upper === 'FALSE') {
+        return { tag: ValueTag.Boolean, value: false };
+    }
+    if (body.length >= 2 && body.startsWith('"') && body.endsWith('"')) {
+        return { tag: ValueTag.String, value: body.slice(1, -1).replaceAll('""', '"'), stringId: 0 };
+    }
+    return undefined;
+}
+export function tryEvaluateSimpleNamedExpression(raw) {
+    if (raw === null || typeof raw === 'number' || typeof raw === 'boolean') {
+        return scalarValueFromLiteral(raw);
+    }
+    if (typeof raw === 'string' && !raw.trim().startsWith('=')) {
+        return scalarValueFromLiteral(raw);
+    }
+    const body = tryReadSimpleScalarFormulaBody(raw);
+    return body === undefined ? undefined : tryEvaluateSimpleScalarFormulaBody(body);
+}
+export function valuesEqual(left, right) {
+    if (left.tag !== right.tag) {
+        return false;
+    }
+    switch (left.tag) {
+        case ValueTag.Number:
+            return right.tag === ValueTag.Number && left.value === right.value;
+        case ValueTag.Boolean:
+            return right.tag === ValueTag.Boolean && left.value === right.value;
+        case ValueTag.String:
+            return right.tag === ValueTag.String && left.value === right.value;
+        case ValueTag.Error:
+            return right.tag === ValueTag.Error && left.code === right.code;
+        case ValueTag.Empty:
+            return true;
+        default:
+            return false;
+    }
+}
+function isCellValueMatrix(value) {
+    return Array.isArray(value);
+}
+export function matrixValuesEqual(left, right) {
+    if (!left && !right) {
+        return true;
+    }
+    if (!left || !right) {
+        return false;
+    }
+    if (isCellValueMatrix(left) !== isCellValueMatrix(right)) {
+        return false;
+    }
+    if (!isCellValueMatrix(left) && !isCellValueMatrix(right)) {
+        return valuesEqual(left, right);
+    }
+    if (!isCellValueMatrix(left) || !isCellValueMatrix(right)) {
+        return false;
+    }
+    const leftMatrix = left;
+    const rightMatrix = right;
+    if (leftMatrix.length !== rightMatrix.length) {
+        return false;
+    }
+    return leftMatrix.every((row, rowIndex) => {
+        const otherRow = rightMatrix[rowIndex];
+        if (!otherRow || row.length !== otherRow.length) {
+            return false;
+        }
+        return row.every((value, columnIndex) => {
+            const otherValue = otherRow[columnIndex];
+            if (!otherValue) {
+                return false;
+            }
+            return valuesEqual(value, otherValue);
+        });
+    });
+}
+export function normalizeName(name) {
+    return name.trim().toUpperCase();
+}
+export function makeNamedExpressionKey(name, scope) {
+    return `${scope ?? 'workbook'}:${normalizeName(name)}`;
+}
+export function makeInternalScopedName(scope, name) {
+    return `__BILIG_WORKPAPER_SCOPE_${scope}_${normalizeName(name)}`;
+}
+export function isFormulaContent(content) {
+    return typeof content === 'string' && content.trim().startsWith('=');
+}
+export function isWorkPaperSheetMatrix(value) {
+    return Array.isArray(value);
+}
+export function matrixContainsFormulaContent(content) {
+    return content.some((row) => row.some((cell) => isFormulaContent(cell)));
+}
+export function isDeferredBatchLiteralContent(content) {
+    return content === null || typeof content === 'boolean' || typeof content === 'number' || typeof content === 'string';
+}
+export function stripLeadingEquals(formula) {
+    return formula.trim().startsWith('=') ? formula.trim().slice(1) : formula.trim();
+}
+export function assertRowAndColumn(value, label) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new WorkPaperInvalidArgumentsError(`${label} to be a non-negative integer`);
+    }
+}
+export function assertRange(range) {
+    assertRowAndColumn(range.start.sheet, 'start.sheet');
+    assertRowAndColumn(range.start.row, 'start.row');
+    assertRowAndColumn(range.start.col, 'start.col');
+    assertRowAndColumn(range.end.sheet, 'end.sheet');
+    assertRowAndColumn(range.end.row, 'end.row');
+    assertRowAndColumn(range.end.col, 'end.col');
+    if (range.start.sheet !== range.end.sheet) {
+        throw new WorkPaperInvalidArgumentsError('Ranges must stay on a single sheet');
+    }
+}
+export function isCellRange(value) {
+    return 'start' in value && 'end' in value;
+}
+export function cloneCellValue(value) {
+    switch (value.tag) {
+        case ValueTag.Empty:
+            return emptyValue();
+        case ValueTag.Number:
+            return { tag: ValueTag.Number, value: value.value };
+        case ValueTag.Boolean:
+            return { tag: ValueTag.Boolean, value: value.value };
+        case ValueTag.String:
+            return { tag: ValueTag.String, value: value.value, stringId: value.stringId };
+        case ValueTag.Error:
+            return { tag: ValueTag.Error, code: value.code };
+        default:
+            return emptyValue();
+    }
+}
+export function transformFormulaNode(node, transform) {
+    const current = transform(node);
+    switch (current.kind) {
+        case 'BooleanLiteral':
+        case 'CellRef':
+        case 'ColumnRef':
+        case 'ErrorLiteral':
+        case 'NameRef':
+        case 'NumberLiteral':
+        case 'RangeRef':
+        case 'RowRef':
+        case 'SpillRef':
+        case 'StringLiteral':
+        case 'StructuredRef':
+            return current;
+        case 'UnaryExpr':
+            return {
+                ...current,
+                argument: transformFormulaNode(current.argument, transform),
+            };
+        case 'BinaryExpr':
+            return {
+                ...current,
+                left: transformFormulaNode(current.left, transform),
+                right: transformFormulaNode(current.right, transform),
+            };
+        case 'CallExpr':
+            return {
+                ...current,
+                args: current.args.map((argument) => transformFormulaNode(argument, transform)),
+            };
+        case 'InvokeExpr':
+            return {
+                ...current,
+                callee: transformFormulaNode(current.callee, transform),
+                args: current.args.map((argument) => transformFormulaNode(argument, transform)),
+            };
+        default:
+            return current;
+    }
+}
+export function collectFormulaNameRefs(node, output) {
+    switch (node.kind) {
+        case 'BooleanLiteral':
+        case 'CellRef':
+        case 'ColumnRef':
+        case 'ErrorLiteral':
+        case 'NameRef':
+            if (node.kind === 'NameRef') {
+                output.add(node.name);
+            }
+            return;
+        case 'NumberLiteral':
+        case 'RangeRef':
+        case 'RowRef':
+        case 'SpillRef':
+        case 'StringLiteral':
+        case 'StructuredRef':
+            return;
+        case 'UnaryExpr':
+            collectFormulaNameRefs(node.argument, output);
+            return;
+        case 'BinaryExpr':
+            collectFormulaNameRefs(node.left, output);
+            collectFormulaNameRefs(node.right, output);
+            return;
+        case 'CallExpr':
+            node.args.forEach((argument) => collectFormulaNameRefs(argument, output));
+            return;
+        case 'InvokeExpr':
+            collectFormulaNameRefs(node.callee, output);
+            node.args.forEach((argument) => collectFormulaNameRefs(argument, output));
+            return;
+        default:
+            return;
+    }
+}
+function isAbsoluteCellReference(value) {
+    return /^\$[A-Z]+\$[1-9][0-9]*$/.test(value.toUpperCase());
+}
+function isAbsoluteRowReference(value) {
+    return /^\$[1-9][0-9]*$/.test(value);
+}
+function isAbsoluteColumnReference(value) {
+    return /^\$[A-Z]+$/.test(value.toUpperCase());
+}
+export function formulaHasRelativeReferences(node) {
+    switch (node.kind) {
+        case 'BooleanLiteral':
+        case 'ErrorLiteral':
+        case 'NameRef':
+        case 'NumberLiteral':
+        case 'StringLiteral':
+        case 'StructuredRef':
+            return false;
+        case 'CellRef':
+        case 'SpillRef':
+            return !isAbsoluteCellReference(node.ref);
+        case 'RowRef':
+            return !isAbsoluteRowReference(node.ref);
+        case 'ColumnRef':
+            return !isAbsoluteColumnReference(node.ref);
+        case 'RangeRef':
+            if (node.refKind === 'cells') {
+                return !isAbsoluteCellReference(node.start) || !isAbsoluteCellReference(node.end);
+            }
+            if (node.refKind === 'rows') {
+                return !isAbsoluteRowReference(node.start) || !isAbsoluteRowReference(node.end);
+            }
+            return !isAbsoluteColumnReference(node.start) || !isAbsoluteColumnReference(node.end);
+        case 'UnaryExpr':
+            return formulaHasRelativeReferences(node.argument);
+        case 'BinaryExpr':
+            return formulaHasRelativeReferences(node.left) || formulaHasRelativeReferences(node.right);
+        case 'CallExpr':
+            return node.args.some((argument) => formulaHasRelativeReferences(argument));
+        case 'InvokeExpr':
+            return formulaHasRelativeReferences(node.callee) || node.args.some((argument) => formulaHasRelativeReferences(argument));
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=work-paper-runtime-helpers.js.map

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

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

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

@@ -0,0 +1,137 @@
+import type { EngineCellMutationRef, SheetRecord } from '@bilig/core';
+import type { CellRangeRef, LiteralInput } from '@bilig/protocol';
+import { type WorkPaperHistoryRecord } from './work-paper-history.js';
+import type { WorkPaperSheetDimensionCache } from './work-paper-sheet-dimension-cache.js';
+import { type InternalNamedExpression, type WorkPaperNamedExpressionValueSnapshot } from './work-paper-named-expression-helpers.js';
+import type { WorkPaperEngineEventTracker } from './work-paper-engine-event-tracker.js';
+import type { WorkPaperMutationQueues } from './work-paper-mutation-queues.js';
+import { type VisibilitySnapshot } from './work-paper-visibility-snapshot.js';
+import type { TrackedEngineEvent } from './tracked-engine-event-refs.js';
+import { type MaterializedTrackedEventChanges } from './work-paper-tracked-change-reducer.js';
+import { type QueuedEvent } from './work-paper-tracked-event-helpers.js';
+import type { RawCellContent, WorkPaperAddressLike, WorkPaperCellAddress, WorkPaperCellChange, WorkPaperCellRange, WorkPaperChange, WorkPaperDependencyRef, WorkPaperStats } from './work-paper-types.js';
+import { WorkPaperPublicSurface } from './work-paper-public-surface.js';
+type NamedExpressionValueSnapshot = WorkPaperNamedExpressionValueSnapshot;
+export declare const EMPTY_NAMED_EXPRESSION_VALUES: NamedExpressionValueSnapshot;
+export declare abstract class WorkPaperRuntimeSurface extends WorkPaperPublicSurface {
+    protected abstract readonly namedExpressions: Map<string, InternalNamedExpression>;
+    protected abstract readonly engineEvents: WorkPaperEngineEventTracker;
+    protected abstract readonly mutationQueues: WorkPaperMutationQueues;
+    protected abstract readonly sheetDimensionCache: WorkPaperSheetDimensionCache;
+    protected abstract visibilityCache: VisibilitySnapshot | null;
+    protected abstract namedExpressionValueCache: NamedExpressionValueSnapshot | null;
+    protected abstract sheetRecordsCache: readonly SheetRecord[] | null;
+    protected abstract batchDepth: number;
+    protected abstract batchStartVisibility: VisibilitySnapshot | null;
+    protected abstract batchStartNamedValues: NamedExpressionValueSnapshot | null;
+    protected abstract batchUsesTrackedFastPath: boolean;
+    protected abstract batchUndoStackLength: number;
+    protected abstract evaluationSuspended: boolean;
+    protected abstract suspendedVisibility: VisibilitySnapshot | null;
+    protected abstract suspendedNamedValues: NamedExpressionValueSnapshot | null;
+    protected abstract suspendedUsesTrackedFastPath: boolean;
+    protected abstract queuedEvents: QueuedEvent[];
+    protected abstract disposed: boolean;
+    protected abstract evaluateNamedExpression(expression: InternalNamedExpression): ReturnType<WorkPaperPublicSurface['calculateFormula']>;
+    getStats(): WorkPaperStats;
+    rebuildAndRecalculate(): WorkPaperChange[];
+    batch(batchOperations: () => void): WorkPaperChange[];
+    suspendEvaluation(): void;
+    resumeEvaluation(): WorkPaperChange[];
+    isEvaluationSuspended(): boolean;
+    undo(): WorkPaperChange[];
+    redo(): WorkPaperChange[];
+    isThereSomethingToUndo(): boolean;
+    isThereSomethingToRedo(): boolean;
+    clearUndoStack(): void;
+    clearRedoStack(): void;
+    getCellDependents(address: WorkPaperAddressLike): WorkPaperDependencyRef[];
+    getCellPrecedents(address: WorkPaperAddressLike): WorkPaperDependencyRef[];
+    getSheetName(sheetId: number): string | undefined;
+    getSheetNames(): string[];
+    getSheetId(name: string): number | undefined;
+    doesSheetExist(name: string): boolean;
+    countSheets(): number;
+    moveCells(source: WorkPaperCellRange, target: WorkPaperCellAddress): WorkPaperChange[];
+    protected applyHistoryOperation(kind: 'undo' | 'redo'): WorkPaperChange[];
+    protected resetChangeTrackingCaches(): void;
+    protected ensureVisibilityCache(): VisibilitySnapshot;
+    protected ensureNamedExpressionValueCache(): NamedExpressionValueSnapshot;
+    protected flushPendingBatchOps(): void;
+    protected applyCellMutationRefs(refs: readonly EngineCellMutationRef[], options: {
+        captureUndo?: boolean;
+        potentialNewCells?: number;
+        source?: 'local' | 'restore';
+        returnUndoOps?: boolean;
+        reuseRefs?: boolean;
+    }): void;
+    protected flushSuspendedCellMutations(): void;
+    protected enqueueSuspendedLiteralMutation(sheetId: number, row: number, col: number, content: RawCellContent, cellIndex: number | undefined): boolean;
+    protected enqueueDeferredBatchLiteral(sheetId: number, row: number, col: number, content: RawCellContent, cellIndex: number | undefined): boolean;
+    protected prepareReadableState(): void;
+    protected assertNotDisposed(): void;
+    protected assertReadable(): void;
+    protected sheetRecord(sheetId: number): SheetRecord;
+    protected sheetName(sheetId: number): string;
+    protected capabilityContext(): {
+        config: import("./work-paper-types.js").WorkPaperConfig;
+        requireSheet: (sheetId: number) => void;
+        doesSheetExist: (sheetName: string) => boolean;
+        getSheetIdByName: (sheetName: string) => number | undefined;
+    };
+    protected requireSheetId(name: string): number;
+    protected a1(address: Pick<WorkPaperCellAddress, 'row' | 'col'>): string;
+    protected trackedA1(row: number, col: number): string;
+    protected rangeRef(range: WorkPaperCellRange): CellRangeRef;
+    protected getDirectPrecedentStrings(address: WorkPaperCellAddress): string[];
+    protected getDirectPrecedentRefs(address: WorkPaperCellAddress): WorkPaperDependencyRef[];
+    protected listSheetRecords(): readonly SheetRecord[];
+    protected captureVisibilitySnapshot(): VisibilitySnapshot;
+    protected captureNamedExpressionValueSnapshot(): NamedExpressionValueSnapshot;
+    protected computeCellChanges(beforeVisibility: VisibilitySnapshot, afterVisibility: VisibilitySnapshot): WorkPaperChange[];
+    protected materializeTrackedEventChanges(event: TrackedEngineEvent, lazy?: boolean): MaterializedTrackedEventChanges;
+    protected readSingleTrackedCellChange(cellIndex: number): WorkPaperCellChange | undefined;
+    protected readTinySortedPhysicalTrackedEventChanges(event: TrackedEngineEvent): WorkPaperCellChange[] | null;
+    protected tryReadTinyTrackedEventChangesWithoutVisibility(event: TrackedEngineEvent): WorkPaperChange[] | null;
+    protected computeCellChangesFromTrackedEvents(beforeVisibility: VisibilitySnapshot, events: readonly TrackedEngineEvent[], updateVisibility?: boolean, options?: {
+        readonly preferLazyPublicChanges?: boolean;
+    }): {
+        changes: WorkPaperChange[];
+        nextVisibility: VisibilitySnapshot;
+    } | null;
+    protected computeNamedExpressionChanges(beforeNames: NamedExpressionValueSnapshot, afterNames: NamedExpressionValueSnapshot): WorkPaperChange[];
+    protected canUseTrackedStructuralFastPath(): boolean;
+    protected canUseTrackedMutationFastPath(): boolean;
+    protected canUseNamedExpressionChangeFastPath(): boolean;
+    protected canUseMetadataOnlySheetRenameFastPath(): boolean;
+    protected downgradeTrackedBatchFastPath(): void;
+    protected computeTrackedChangesWithoutVisibilityCache(events: readonly TrackedEngineEvent[], options?: {
+        readonly preferLazyPublicChanges?: boolean;
+    }): WorkPaperChange[];
+    protected tryRenameSheetWithoutVisibilitySnapshots(oldName: string, newName: string): WorkPaperChange[] | null;
+    protected captureTrackedChangesWithoutVisibilityCache(mutate: () => void, options?: {
+        readonly preservePendingTrackedPositions?: boolean;
+        readonly singleLiteralChange?: {
+            readonly address: WorkPaperCellAddress;
+            readonly cellIndex?: number;
+            readonly isPhysicalSheet: boolean;
+            readonly sheetName: string;
+            readonly value: LiteralInput;
+        };
+    }): WorkPaperChange[];
+    protected batchStructuralChanges(batchOperations: () => void): WorkPaperChange[];
+    protected computeChangesAfterMutation(beforeVisibility: VisibilitySnapshot, beforeNames: NamedExpressionValueSnapshot): WorkPaperChange[];
+    protected captureChanges(semanticEvent: QueuedEvent | undefined, mutate: () => void, options?: {
+        readonly preservePendingTrackedPositions?: boolean;
+    }): WorkPaperChange[];
+    protected shouldSuppressEvents(): boolean;
+    protected flushQueuedEvents(): void;
+    protected getUndoStack(): WorkPaperHistoryRecord[];
+    protected getRedoStack(): WorkPaperHistoryRecord[];
+    protected clearHistoryStacks(): void;
+    protected mergeUndoHistory(startIndex: number): void;
+    protected nextSheetName(): string;
+    protected collectRangeDependencies(range: WorkPaperCellRange, readDependencies: (address: WorkPaperCellAddress) => readonly string[]): WorkPaperDependencyRef[];
+    protected toDependencyRefs(values: readonly string[]): WorkPaperDependencyRef[];
+}
+export {};