@bilig/headless 0.8.0 → 0.8.2

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

@@ -0,0 +1,71 @@
+import { parseFormula, serializeFormula } from '@bilig/formula';
+import { WorkPaperParseError } from './work-paper-errors.js';
+import { makeNamedExpressionKey, stripLeadingEquals, transformFormulaNode } from './work-paper-runtime-helpers.js';
+export function rewriteWorkPaperFormulaForStorage(input) {
+    if (input.namedExpressions.size === 0 && input.functionAliasLookup.size === 0) {
+        return input.formula;
+    }
+    try {
+        const transformed = transformFormulaNode(parseFormula(stripLeadingEquals(input.formula)), (node) => {
+            if (node.kind === 'NameRef') {
+                return rewriteNameRefForStorage(node, input.ownerSheetId, input.namedExpressions);
+            }
+            if (node.kind === 'CallExpr') {
+                return rewriteCallForStorage(node, input.functionAliasLookup);
+            }
+            return node;
+        });
+        return serializeFormula(transformed);
+    }
+    catch (error) {
+        throw new WorkPaperParseError(input.messageOf(error, 'Unable to store formula'));
+    }
+}
+export function restorePublicWorkPaperFormula(input) {
+    if (input.namedExpressions.size === 0 && input.internalFunctionLookup.size === 0) {
+        return input.formula;
+    }
+    const transformed = transformFormulaNode(parseFormula(input.formula), (node) => {
+        if (node.kind === 'NameRef') {
+            return rewriteNameRefForPublic(node, input.ownerSheetId, input.namedExpressions);
+        }
+        if (node.kind === 'CallExpr') {
+            return rewriteCallForPublic(node, input.internalFunctionLookup);
+        }
+        return node;
+    });
+    return serializeFormula(transformed);
+}
+function rewriteNameRefForStorage(node, ownerSheetId, namedExpressions) {
+    const scoped = namedExpressions.get(makeNamedExpressionKey(node.name, ownerSheetId));
+    if (scoped) {
+        return { ...node, name: scoped.internalName };
+    }
+    const workbookScoped = namedExpressions.get(makeNamedExpressionKey(node.name));
+    if (workbookScoped) {
+        return { ...node, name: workbookScoped.internalName };
+    }
+    return node;
+}
+function rewriteNameRefForPublic(node, ownerSheetId, namedExpressions) {
+    const exact = [...namedExpressions.values()].find((expression) => expression.internalName === node.name && expression.scope === ownerSheetId);
+    if (exact) {
+        return { ...node, name: exact.publicName };
+    }
+    return node;
+}
+function rewriteCallForStorage(node, functionAliasLookup) {
+    const binding = functionAliasLookup.get(node.callee.trim().toUpperCase());
+    if (!binding) {
+        return node;
+    }
+    return { ...node, callee: binding.internalName };
+}
+function rewriteCallForPublic(node, internalFunctionLookup) {
+    const binding = internalFunctionLookup.get(node.callee.trim().toUpperCase());
+    if (!binding) {
+        return node;
+    }
+    return { ...node, callee: binding.publicName };
+}
+//# sourceMappingURL=work-paper-formula-rewrite.js.map

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

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

package/dist/work-paper-function-registry.d.ts

@@ -0,0 +1,39 @@
+import type { CellValue } from '@bilig/protocol';
+import type { EvaluationResult } from '@bilig/formula';
+import type { WorkPaperFunctionPluginDefinition, WorkPaperLanguagePackage } from './work-paper-types.js';
+export type WorkPaperFunctionImplementation = (...args: CellValue[]) => EvaluationResult | CellValue | undefined;
+export interface InternalFunctionBinding {
+    pluginId: string;
+    publicName: string;
+    internalName: string;
+    implementation?: WorkPaperFunctionImplementation;
+}
+export declare function listCapturedWorkPaperFunctionNames(args: {
+    readonly functionSnapshot: Iterable<InternalFunctionBinding>;
+    readonly language: WorkPaperLanguagePackage | undefined;
+}): string[];
+export declare function getCapturedWorkPaperFunctionPlugin(args: {
+    readonly functionId: string;
+    readonly functionAliasLookup: ReadonlyMap<string, InternalFunctionBinding>;
+    readonly getPluginById: (pluginId: string) => WorkPaperFunctionPluginDefinition | undefined;
+}): WorkPaperFunctionPluginDefinition | undefined;
+export declare function getCapturedWorkPaperFunctionPlugins(args: {
+    readonly functionSnapshot: Iterable<InternalFunctionBinding>;
+    readonly getPluginsById: (pluginIds: Iterable<string>) => WorkPaperFunctionPluginDefinition[];
+}): WorkPaperFunctionPluginDefinition[];
+export declare function captureWorkPaperFunctionRegistry(args: {
+    readonly workbookId: number;
+    readonly configFunctionPlugins: readonly WorkPaperFunctionPluginDefinition[] | undefined;
+    readonly plugins: Iterable<WorkPaperFunctionPluginDefinition>;
+    readonly functionSnapshot: Map<string, InternalFunctionBinding>;
+    readonly functionAliasLookup: Map<string, InternalFunctionBinding>;
+    readonly internalFunctionLookup: Map<string, InternalFunctionBinding>;
+    readonly globalCustomFunctions: Map<string, WorkPaperFunctionImplementation>;
+}): void;
+export declare function clearWorkPaperFunctionBindings(args: {
+    readonly functionSnapshot: Map<string, InternalFunctionBinding>;
+    readonly functionAliasLookup: Map<string, InternalFunctionBinding>;
+    readonly internalFunctionLookup: Map<string, InternalFunctionBinding>;
+    readonly globalCustomFunctions: Map<string, WorkPaperFunctionImplementation>;
+    readonly preserveInternalFunctionLookup?: boolean;
+}): void;

package/dist/work-paper-function-registry.js

@@ -0,0 +1,66 @@
+import { compareSheetNames } from './work-paper-sheet-inspection.js';
+export function listCapturedWorkPaperFunctionNames(args) {
+    const functions = [...args.functionSnapshot]
+        .filter((binding) => binding.publicName === binding.publicName.toUpperCase())
+        .map((binding) => binding.publicName)
+        .toSorted(compareSheetNames);
+    if (!args.language?.functions) {
+        return functions;
+    }
+    return functions.map((name) => args.language?.functions?.[name] ?? name);
+}
+export function getCapturedWorkPaperFunctionPlugin(args) {
+    const binding = args.functionAliasLookup.get(args.functionId.trim().toUpperCase());
+    return binding ? args.getPluginById(binding.pluginId) : undefined;
+}
+export function getCapturedWorkPaperFunctionPlugins(args) {
+    const pluginIds = new Set([...args.functionSnapshot].map((binding) => binding.pluginId));
+    return args.getPluginsById(pluginIds);
+}
+export function captureWorkPaperFunctionRegistry(args) {
+    const allowedPluginIds = args.configFunctionPlugins && args.configFunctionPlugins.length > 0
+        ? new Set(args.configFunctionPlugins.map((plugin) => plugin.id))
+        : undefined;
+    for (const plugin of args.plugins) {
+        if (allowedPluginIds && !allowedPluginIds.has(plugin.id)) {
+            continue;
+        }
+        Object.keys(plugin.implementedFunctions).forEach((functionId) => {
+            const normalized = functionId.trim().toUpperCase();
+            const internalName = `__BILIG_WORKPAPER_FN_${args.workbookId}_${normalized}`;
+            const implementation = plugin.functions?.[normalized];
+            const binding = {
+                pluginId: plugin.id,
+                publicName: normalized,
+                internalName,
+            };
+            if (implementation !== undefined) {
+                binding.implementation = implementation;
+            }
+            args.functionSnapshot.set(normalized, binding);
+            args.functionAliasLookup.set(normalized, binding);
+            args.internalFunctionLookup.set(internalName, binding);
+            if (implementation) {
+                args.globalCustomFunctions.set(internalName, implementation);
+            }
+        });
+        Object.entries(plugin.aliases ?? {}).forEach(([alias, target]) => {
+            const binding = args.functionSnapshot.get(target.trim().toUpperCase());
+            if (!binding) {
+                return;
+            }
+            args.functionAliasLookup.set(alias.trim().toUpperCase(), binding);
+        });
+    }
+}
+export function clearWorkPaperFunctionBindings(args) {
+    args.internalFunctionLookup.forEach((_binding, internalName) => {
+        args.globalCustomFunctions.delete(internalName);
+    });
+    args.functionSnapshot.clear();
+    args.functionAliasLookup.clear();
+    if (args.preserveInternalFunctionLookup !== true) {
+        args.internalFunctionLookup.clear();
+    }
+}
+//# sourceMappingURL=work-paper-function-registry.js.map

package/dist/work-paper-function-registry.js.map

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

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

@@ -0,0 +1,15 @@
+import { type WorkPaperHistoryRecord } from './work-paper-history.js';
+import type { WorkPaperChange } from './work-paper-types.js';
+export declare function applyWorkPaperHistoryOperation(args: {
+    readonly getStack: () => readonly WorkPaperHistoryRecord[];
+    readonly canUseTrackedMutationFastPath: () => boolean;
+    readonly captureTrackedChangesWithoutVisibilityCache: (mutate: () => void, options: {
+        readonly preservePendingTrackedPositions?: boolean;
+    }) => WorkPaperChange[];
+    readonly captureChanges: (mutate: () => void, options: {
+        readonly preservePendingTrackedPositions?: boolean;
+    }) => WorkPaperChange[];
+    readonly applyOperation: () => boolean;
+    readonly createMissingOperationError: () => Error;
+    readonly invalidateAllSheetDimensions: () => void;
+}): WorkPaperChange[];

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

@@ -0,0 +1,14 @@
+import { workPaperHistoryTopIsCellMutations } from './work-paper-history.js';
+export function applyWorkPaperHistoryOperation(args) {
+    const preservesPositions = !workPaperHistoryTopIsCellMutations(args.getStack());
+    const mutate = () => {
+        if (!args.applyOperation()) {
+            throw args.createMissingOperationError();
+        }
+        args.invalidateAllSheetDimensions();
+    };
+    return args.canUseTrackedMutationFastPath()
+        ? args.captureTrackedChangesWithoutVisibilityCache(mutate, { preservePendingTrackedPositions: preservesPositions })
+        : args.captureChanges(mutate, { preservePendingTrackedPositions: preservesPositions });
+}
+//# sourceMappingURL=work-paper-history-operations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"work-paper-history-operations.js","sourceRoot":"","sources":["../src/work-paper-history-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kCAAkC,EAA+B,MAAM,yBAAyB,CAAA;AAGzG,MAAM,UAAU,8BAA8B,CAAC,IAW9C;IACC,MAAM,kBAAkB,GAAG,CAAC,kCAAkC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC/E,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,2BAA2B,EAAE,CAAA;QAC1C,CAAC;QACD,IAAI,CAAC,4BAA4B,EAAE,CAAA;IACrC,CAAC,CAAA;IACD,OAAO,IAAI,CAAC,6BAA6B,EAAE;QACzC,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,MAAM,EAAE,EAAE,+BAA+B,EAAE,kBAAkB,EAAE,CAAC;QACnH,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,+BAA+B,EAAE,kBAAkB,EAAE,CAAC,CAAA;AAC1F,CAAC"}

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

@@ -0,0 +1,50 @@
+import type { RawCellContent } from './work-paper-types.js';
+export type WorkPaperHistoryTransactionRecord = {
+    kind: 'ops';
+    ops: unknown[];
+    potentialNewCells?: number;
+} | {
+    kind: 'single-op';
+    op: unknown;
+    potentialNewCells?: number;
+} | {
+    kind: 'single-existing-numeric-cell-mutation';
+    sheetId: number;
+    row: number;
+    col: number;
+    cellIndex: number;
+    value: number;
+    potentialNewCells?: number;
+} | {
+    kind: 'cell-mutations';
+    refs: Array<{
+        sheetId: number;
+        mutation: {
+            kind: 'setCellValue';
+            row: number;
+            col: number;
+            value: RawCellContent;
+        } | {
+            kind: 'setCellFormula';
+            row: number;
+            col: number;
+            formula: string;
+        } | {
+            kind: 'clearCell';
+            row: number;
+            col: number;
+        };
+    }>;
+    potentialNewCells?: number;
+};
+export interface WorkPaperHistoryRecord {
+    forward: WorkPaperHistoryTransactionRecord;
+    inverse: WorkPaperHistoryTransactionRecord;
+}
+export type WorkPaperSheetNameResolver = (sheetId: number) => string | undefined;
+export declare function readWorkPaperHistoryStack(owner: object, propertyName: 'undoStack' | 'redoStack'): WorkPaperHistoryRecord[];
+export declare function workPaperHistoryTopIsCellMutations(stack: readonly WorkPaperHistoryRecord[]): boolean;
+export declare function clearWorkPaperHistoryStacks(undoStack: WorkPaperHistoryRecord[], redoStack: WorkPaperHistoryRecord[]): void;
+export declare function workPaperHistoryTransactionOps(record: WorkPaperHistoryTransactionRecord, resolveSheetName: WorkPaperSheetNameResolver): unknown[];
+export declare function tryMergeTypedCellMutationHistory(entries: readonly WorkPaperHistoryRecord[]): WorkPaperHistoryRecord | null;
+export declare function mergeWorkPaperUndoHistory(undoStack: WorkPaperHistoryRecord[], startIndex: number, resolveSheetName: WorkPaperSheetNameResolver): void;

package/dist/work-paper-history.js

@@ -0,0 +1,136 @@
+import { formatAddress } from '@bilig/formula';
+function isWorkPaperHistoryRecordArray(value) {
+    return Array.isArray(value);
+}
+export function readWorkPaperHistoryStack(owner, propertyName) {
+    const stack = Reflect.get(owner, propertyName);
+    if (!isWorkPaperHistoryRecordArray(stack)) {
+        return [];
+    }
+    return stack;
+}
+export function workPaperHistoryTopIsCellMutations(stack) {
+    const kind = stack.at(-1)?.forward.kind;
+    return kind === 'cell-mutations' || kind === 'single-existing-numeric-cell-mutation';
+}
+export function clearWorkPaperHistoryStacks(undoStack, redoStack) {
+    undoStack.length = 0;
+    redoStack.length = 0;
+}
+export function workPaperHistoryTransactionOps(record, resolveSheetName) {
+    switch (record.kind) {
+        case 'ops':
+            return record.ops;
+        case 'single-op':
+            return [record.op];
+        case 'single-existing-numeric-cell-mutation': {
+            const sheetName = resolveSheetName(record.sheetId);
+            return sheetName
+                ? [
+                    {
+                        kind: 'setCellValue',
+                        sheetName,
+                        address: formatAddress(record.row, record.col),
+                        value: record.value,
+                    },
+                ]
+                : [];
+        }
+        case 'cell-mutations':
+            return record.refs.flatMap((ref) => {
+                const sheetName = resolveSheetName(ref.sheetId);
+                if (!sheetName) {
+                    return [];
+                }
+                const address = formatAddress(ref.mutation.row, ref.mutation.col);
+                switch (ref.mutation.kind) {
+                    case 'setCellValue':
+                        return [
+                            {
+                                kind: 'setCellValue',
+                                sheetName,
+                                address,
+                                value: ref.mutation.value,
+                            },
+                        ];
+                    case 'setCellFormula':
+                        return [
+                            {
+                                kind: 'setCellFormula',
+                                sheetName,
+                                address,
+                                formula: ref.mutation.formula,
+                            },
+                        ];
+                    case 'clearCell':
+                        return [
+                            {
+                                kind: 'clearCell',
+                                sheetName,
+                                address,
+                            },
+                        ];
+                }
+            });
+    }
+}
+export function tryMergeTypedCellMutationHistory(entries) {
+    if (entries.length === 0 || entries.some((entry) => entry.forward.kind !== 'cell-mutations' || entry.inverse.kind !== 'cell-mutations')) {
+        return null;
+    }
+    const forward = {
+        kind: 'cell-mutations',
+        refs: entries.flatMap((entry) => (entry.forward.kind === 'cell-mutations' ? entry.forward.refs : [])),
+    };
+    const forwardPotentialNewCells = sumNumbers(entries.map((entry) => entry.forward.potentialNewCells));
+    if (forwardPotentialNewCells !== undefined) {
+        forward.potentialNewCells = forwardPotentialNewCells;
+    }
+    const inverse = {
+        kind: 'cell-mutations',
+        refs: entries.toReversed().flatMap((entry) => (entry.inverse.kind === 'cell-mutations' ? entry.inverse.refs : [])),
+    };
+    const inversePotentialNewCells = sumNumbers(entries.map((entry) => entry.inverse.potentialNewCells));
+    if (inversePotentialNewCells !== undefined) {
+        inverse.potentialNewCells = inversePotentialNewCells;
+    }
+    return {
+        forward,
+        inverse,
+    };
+}
+export function mergeWorkPaperUndoHistory(undoStack, startIndex, resolveSheetName) {
+    if (undoStack.length - startIndex <= 1) {
+        return;
+    }
+    const entries = undoStack.splice(startIndex);
+    const merged = tryMergeTypedCellMutationHistory(entries) ?? mergeWorkPaperOperationHistory(entries, resolveSheetName);
+    undoStack.push(merged);
+}
+function mergeWorkPaperOperationHistory(entries, resolveSheetName) {
+    const forward = {
+        kind: 'ops',
+        ops: entries.flatMap((entry) => workPaperHistoryTransactionOps(entry.forward, resolveSheetName)),
+    };
+    const forwardPotentialNewCells = sumNumbers(entries.map((entry) => entry.forward.potentialNewCells));
+    if (forwardPotentialNewCells !== undefined) {
+        forward.potentialNewCells = forwardPotentialNewCells;
+    }
+    const inverse = {
+        kind: 'ops',
+        ops: entries.toReversed().flatMap((entry) => workPaperHistoryTransactionOps(entry.inverse, resolveSheetName)),
+    };
+    const inversePotentialNewCells = sumNumbers(entries.map((entry) => entry.inverse.potentialNewCells));
+    if (inversePotentialNewCells !== undefined) {
+        inverse.potentialNewCells = inversePotentialNewCells;
+    }
+    return { forward, inverse };
+}
+function sumNumbers(values) {
+    const filtered = values.filter((value) => typeof value === 'number');
+    if (filtered.length === 0) {
+        return undefined;
+    }
+    return filtered.reduce((sum, value) => sum + value, 0);
+}
+//# sourceMappingURL=work-paper-history.js.map

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

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

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

@@ -0,0 +1,24 @@
+import { type CellValue } from '@bilig/protocol';
+import type { RawCellContent, WorkPaperAddressLike, WorkPaperCellAddress, WorkPaperCellRange, WorkPaperChange, WorkPaperDependencyRef, WorkPaperInternals, WorkPaperSheetDimensions } from './work-paper-types.js';
+export interface WorkPaperInternalsHooks {
+    readonly getCellDependents: (reference: WorkPaperAddressLike) => WorkPaperDependencyRef[];
+    readonly getCellFormula: (address: WorkPaperCellAddress) => string | undefined;
+    readonly getCellPrecedents: (reference: WorkPaperAddressLike) => WorkPaperDependencyRef[];
+    readonly getCellValue: (address: WorkPaperCellAddress) => CellValue;
+    readonly getNamedExpressionsFromFormula: (formula: string) => string[];
+    readonly getRangeSerialized: (range: WorkPaperCellRange) => RawCellContent[][];
+    readonly getRangeValues: (range: WorkPaperCellRange) => CellValue[][];
+    readonly getSheetDimensions: (sheetId: number) => WorkPaperSheetDimensions;
+    readonly getSheetId: (name: string) => number | undefined;
+    readonly getSheetName: (sheetId: number) => string | undefined;
+    readonly getSheetNames: () => string[];
+    readonly hasCellValueOrFormula: (address: WorkPaperCellAddress) => boolean;
+    readonly isCellPartOfArray: (address: WorkPaperCellAddress) => boolean;
+    readonly normalizeFormula: (formula: string) => string;
+    readonly recalculate: () => WorkPaperChange[];
+    readonly calculateFormula: (formula: string, scope?: number) => CellValue | CellValue[][];
+    readonly countSheets: () => number;
+    readonly validateFormula: (formula: string) => boolean;
+}
+export declare function createWorkPaperInternals(hooks: WorkPaperInternalsHooks): WorkPaperInternals;
+export declare function doesWorkPaperColumnSearchValueMatch(value: CellValue, matcher: string | ((value: CellValue) => boolean)): boolean;

package/dist/work-paper-internals.js

@@ -0,0 +1,59 @@
+import { ValueTag } from '@bilig/protocol';
+export function createWorkPaperInternals(hooks) {
+    return Object.freeze({
+        graph: Object.freeze({
+            getDependents: hooks.getCellDependents,
+            getPrecedents: hooks.getCellPrecedents,
+        }),
+        rangeMapping: Object.freeze({
+            getValues: hooks.getRangeValues,
+            getSerialized: hooks.getRangeSerialized,
+        }),
+        arrayMapping: Object.freeze({
+            isPartOfArray: hooks.isCellPartOfArray,
+            getFormula: hooks.getCellFormula,
+        }),
+        sheetMapping: Object.freeze({
+            getSheetName: hooks.getSheetName,
+            getSheetId: hooks.getSheetId,
+            getSheetNames: hooks.getSheetNames,
+            countSheets: hooks.countSheets,
+        }),
+        addressMapping: Object.freeze({
+            has: hooks.hasCellValueOrFormula,
+            getValue: hooks.getCellValue,
+            getFormula: hooks.getCellFormula,
+        }),
+        dependencyGraph: Object.freeze({
+            getCellDependents: hooks.getCellDependents,
+            getCellPrecedents: hooks.getCellPrecedents,
+        }),
+        evaluator: Object.freeze({
+            recalculate: hooks.recalculate,
+            calculateFormula: hooks.calculateFormula,
+        }),
+        columnSearch: Object.freeze({
+            find: (sheetId, column, matcher) => {
+                const dimensions = hooks.getSheetDimensions(sheetId);
+                const matches = [];
+                for (let row = 0; row < dimensions.height; row += 1) {
+                    const address = { sheet: sheetId, row, col: column };
+                    const value = hooks.getCellValue(address);
+                    if (doesWorkPaperColumnSearchValueMatch(value, matcher)) {
+                        matches.push(address);
+                    }
+                }
+                return matches;
+            },
+        }),
+        lazilyTransformingAstService: Object.freeze({
+            normalizeFormula: hooks.normalizeFormula,
+            validateFormula: hooks.validateFormula,
+            getNamedExpressionsFromFormula: hooks.getNamedExpressionsFromFormula,
+        }),
+    });
+}
+export function doesWorkPaperColumnSearchValueMatch(value, matcher) {
+    return typeof matcher === 'string' ? value.tag === ValueTag.String && value.value === matcher : matcher(value);
+}
+//# sourceMappingURL=work-paper-internals.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"work-paper-internals.js","sourceRoot":"","sources":["../src/work-paper-internals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkB,MAAM,iBAAiB,CAAA;AAiC1D,MAAM,UAAU,wBAAwB,CAAC,KAA8B;IACrE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,aAAa,EAAE,KAAK,CAAC,iBAAiB;YACtC,aAAa,EAAE,KAAK,CAAC,iBAAiB;SACvC,CAAC;QACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1B,SAAS,EAAE,KAAK,CAAC,cAAc;YAC/B,aAAa,EAAE,KAAK,CAAC,kBAAkB;SACxC,CAAC;QACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1B,aAAa,EAAE,KAAK,CAAC,iBAAiB;YACtC,UAAU,EAAE,KAAK,CAAC,cAAc;SACjC,CAAC;QACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;QACF,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;YAC5B,GAAG,EAAE,KAAK,CAAC,qBAAqB;YAChC,QAAQ,EAAE,KAAK,CAAC,YAAY;YAC5B,UAAU,EAAE,KAAK,CAAC,cAAc;SACjC,CAAC;QACF,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC;YAC7B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;YAC1C,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;SAC3C,CAAC;QACF,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;YACvB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;SACzC,CAAC;QACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1B,IAAI,EAAE,CAAC,OAAe,EAAE,MAAc,EAAE,OAAiD,EAA0B,EAAE;gBACnH,MAAM,UAAU,GAAG,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;gBACpD,MAAM,OAAO,GAA2B,EAAE,CAAA;gBAC1C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;oBACpD,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;oBACpD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;oBACzC,IAAI,mCAAmC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;wBACxD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;oBACvB,CAAC;gBACH,CAAC;gBACD,OAAO,OAAO,CAAA;YAChB,CAAC;SACF,CAAC;QACF,4BAA4B,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1C,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,8BAA8B,EAAE,KAAK,CAAC,8BAA8B;SACrE,CAAC;KACH,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,KAAgB,EAAE,OAAiD;IACrH,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAChH,CAAC"}

package/dist/work-paper-literal-mutation-queue.d.ts

@@ -0,0 +1,18 @@
+import type { EngineCellMutationRef } from '@bilig/core';
+import type { RawCellContent } from './work-paper-types.js';
+export declare function buildWorkPaperRawCellMutation(args: {
+    readonly row: number;
+    readonly col: number;
+    readonly content: RawCellContent;
+    readonly rewriteFormulaForStorage: (formula: string) => string;
+}): EngineCellMutationRef['mutation'];
+export declare function tryEnqueueWorkPaperLiteralMutation(args: {
+    readonly enabled: boolean;
+    readonly queue: EngineCellMutationRef[];
+    readonly sheetId: number;
+    readonly row: number;
+    readonly col: number;
+    readonly content: RawCellContent;
+    readonly cellIndex: number | undefined;
+    readonly addPotentialNewCell: () => void;
+}): boolean;

package/dist/work-paper-literal-mutation-queue.js

@@ -0,0 +1,40 @@
+import { isDeferredBatchLiteralContent, isFormulaContent, stripLeadingEquals } from './work-paper-runtime-helpers.js';
+export function buildWorkPaperRawCellMutation(args) {
+    if (args.content === null) {
+        return { kind: 'clearCell', row: args.row, col: args.col };
+    }
+    if (isFormulaContent(args.content)) {
+        return {
+            kind: 'setCellFormula',
+            row: args.row,
+            col: args.col,
+            formula: args.rewriteFormulaForStorage(stripLeadingEquals(args.content)),
+        };
+    }
+    return {
+        kind: 'setCellValue',
+        row: args.row,
+        col: args.col,
+        value: args.content,
+    };
+}
+export function tryEnqueueWorkPaperLiteralMutation(args) {
+    if (!args.enabled || !isDeferredBatchLiteralContent(args.content) || isFormulaContent(args.content)) {
+        return false;
+    }
+    args.queue.push({
+        sheetId: args.sheetId,
+        mutation: buildWorkPaperRawCellMutation({
+            row: args.row,
+            col: args.col,
+            content: args.content,
+            rewriteFormulaForStorage: (formula) => formula,
+        }),
+        ...(args.cellIndex !== undefined ? { cellIndex: args.cellIndex } : {}),
+    });
+    if (args.content !== null && args.cellIndex === undefined) {
+        args.addPotentialNewCell();
+    }
+    return true;
+}
+//# sourceMappingURL=work-paper-literal-mutation-queue.js.map

package/dist/work-paper-literal-mutation-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-paper-literal-mutation-queue.js","sourceRoot":"","sources":["../src/work-paper-literal-mutation-queue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAGrH,MAAM,UAAU,6BAA6B,CAAC,IAK7C;IACC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAA;IAC5D,CAAC;IACD,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SACzE,CAAA;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,OAAO;KACpB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,IASlD;IACC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACpG,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QACd,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,6BAA6B,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;SAC/C,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC,CAAA;IACF,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1D,IAAI,CAAC,mBAAmB,EAAE,CAAA;IAC5B,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/work-paper-matrix-application.d.ts

@@ -0,0 +1,31 @@
+import type { EngineCellMutationRef } from '@bilig/core';
+import type { RawCellContent, WorkPaperCellAddress, WorkPaperSheet } from './work-paper-types.js';
+export interface WorkPaperCellMutationApplyOptions {
+    captureUndo?: boolean;
+    potentialNewCells?: number;
+    source?: 'local' | 'restore';
+    returnUndoOps?: boolean;
+    reuseRefs?: boolean;
+}
+export interface WorkPaperMatrixApplyOptions {
+    captureUndo?: boolean;
+    deferLiteralAddresses?: ReadonlySet<string>;
+    skipNulls?: boolean;
+}
+export declare function applyWorkPaperSerializedMatrix(input: {
+    readonly applyCellMutationRefs: (refs: readonly EngineCellMutationRef[], options: WorkPaperCellMutationApplyOptions) => void;
+    readonly applyRawContent: (address: WorkPaperCellAddress, content: RawCellContent) => void;
+    readonly flushPendingBatchOps: () => void;
+    readonly rewriteFormulaForStorage: (formula: string, ownerSheetId: number) => string;
+    readonly serialized: RawCellContent[][];
+    readonly sourceAnchor: WorkPaperCellAddress;
+    readonly targetLeftCorner: WorkPaperCellAddress;
+}): void;
+export declare function applyWorkPaperMatrixContents(input: {
+    readonly address: WorkPaperCellAddress;
+    readonly applyCellMutationRefs: (refs: readonly EngineCellMutationRef[], options: WorkPaperCellMutationApplyOptions) => void;
+    readonly content: WorkPaperSheet;
+    readonly flushPendingBatchOps: () => void;
+    readonly options?: WorkPaperMatrixApplyOptions;
+    readonly rewriteFormulaForStorage: (formula: string, ownerSheetId: number) => string;
+}): void;