@bilig/headless 0.8.0 → 0.8.2

package/dist/work-paper-tracked-event-helpers.js

@@ -0,0 +1,366 @@
+import { ValueTag } from '@bilig/protocol';
+import { scalarValueFromLiteral } from './work-paper-runtime-helpers.js';
+export const TRUSTED_TRACKED_PHYSICAL_SHEET_ID_PROPERTY = '__biligTrackedPhysicalSheetId';
+export const TRUSTED_TRACKED_PHYSICAL_SORTED_SPLIT_PROPERTY = '__biligTrackedPhysicalSortedSliceSplit';
+export const TINY_TRACKED_CHANGE_LIMIT = 4;
+export function readTrustedPhysicalTrackedChangeMetadata(changedCellIndices) {
+    const trustedPhysicalSheetId = Reflect.get(changedCellIndices, TRUSTED_TRACKED_PHYSICAL_SHEET_ID_PROPERTY);
+    if (typeof trustedPhysicalSheetId !== 'number' || !Number.isInteger(trustedPhysicalSheetId) || trustedPhysicalSheetId < 0) {
+        return undefined;
+    }
+    const trustedSortedSliceSplit = Reflect.get(changedCellIndices, TRUSTED_TRACKED_PHYSICAL_SORTED_SPLIT_PROPERTY);
+    return typeof trustedSortedSliceSplit === 'number' && Number.isInteger(trustedSortedSliceSplit) && trustedSortedSliceSplit > 0
+        ? { trustedPhysicalSheetId, trustedSortedSliceSplit }
+        : { trustedPhysicalSheetId };
+}
+export function trackedEventHasNoValueChanges(event) {
+    return (event.invalidation !== 'full' &&
+        event.changedCellIndices.length === 0 &&
+        !(event.patches?.some((patch) => patch.kind === 'cell') ?? false));
+}
+export function countPotentialNewTrackedCellMutations(refs) {
+    let count = 0;
+    for (let index = 0; index < refs.length; index += 1) {
+        const ref = refs[index];
+        if (ref && ref.cellIndex === undefined && ref.mutation.kind !== 'clearCell') {
+            count += 1;
+        }
+    }
+    return count;
+}
+export function canSkipDimensionUpdateAfterLiteralMutation(refs, potentialNewCells) {
+    if (potentialNewCells !== 0 || refs.length === 0) {
+        return false;
+    }
+    for (let index = 0; index < refs.length; index += 1) {
+        const ref = refs[index];
+        if (ref?.cellIndex === undefined || ref.mutation.kind !== 'setCellValue' || ref.mutation.value === null) {
+            return false;
+        }
+    }
+    return true;
+}
+export function readTrackedRuntimeCellValue(cellStore, cellIndex, strings) {
+    const tag = cellStore.tags[cellIndex] ?? ValueTag.Empty;
+    switch (tag) {
+        case ValueTag.Number:
+            return { tag: ValueTag.Number, value: cellStore.numbers[cellIndex] ?? 0 };
+        case ValueTag.Boolean:
+            return { tag: ValueTag.Boolean, value: (cellStore.numbers[cellIndex] ?? 0) !== 0 };
+        case ValueTag.String:
+            return cellStore.getValue(cellIndex, (stringId) => strings.get(stringId));
+        case ValueTag.Error:
+            return { tag: ValueTag.Error, code: cellStore.errors[cellIndex] };
+        case ValueTag.Empty:
+        default:
+            return { tag: ValueTag.Empty };
+    }
+}
+export function existingNumericMutationChangedCellCount(result) {
+    return result.changedCellIndices?.length ?? result.changedCellCount ?? 0;
+}
+export function existingNumericMutationChangedCellAt(result, index) {
+    if (result.changedCellIndices) {
+        return result.changedCellIndices[index];
+    }
+    if (index === 0) {
+        return result.firstChangedCellIndex;
+    }
+    if (index === 1) {
+        return result.secondChangedCellIndex;
+    }
+    return undefined;
+}
+export function materializeExistingNumericMutationChangedCellIndices(result) {
+    if (result.changedCellIndices) {
+        return result.changedCellIndices;
+    }
+    const count = existingNumericMutationChangedCellCount(result);
+    const changed = new Uint32Array(count);
+    for (let index = 0; index < count; index += 1) {
+        changed[index] = existingNumericMutationChangedCellAt(result, index) ?? 0;
+    }
+    return changed;
+}
+export function trackedEventFromExistingNumericMutationResult(result) {
+    let sortedDisjoint = true;
+    let previous = -1;
+    let firstChangedCellIndex;
+    let lastChangedCellIndex;
+    const changedCellCount = existingNumericMutationChangedCellCount(result);
+    for (let index = 0; index < changedCellCount; index += 1) {
+        const cellIndex = existingNumericMutationChangedCellAt(result, index) ?? -1;
+        if (index === 0) {
+            firstChangedCellIndex = cellIndex;
+        }
+        if (!Number.isInteger(cellIndex) || cellIndex < 0 || cellIndex <= previous) {
+            sortedDisjoint = false;
+        }
+        previous = cellIndex;
+        lastChangedCellIndex = cellIndex;
+    }
+    return {
+        invalidation: 'cells',
+        changedCellIndices: materializeExistingNumericMutationChangedCellIndices(result),
+        changedInputCount: 1,
+        explicitChangedCount: result.explicitChangedCount,
+        changedCellIndicesSortedDisjoint: sortedDisjoint,
+        ...(firstChangedCellIndex === undefined ? {} : { firstChangedCellIndex }),
+        ...(lastChangedCellIndex === undefined ? {} : { lastChangedCellIndex }),
+        hasInvalidatedRanges: false,
+        hasInvalidatedRows: false,
+        hasInvalidatedColumns: false,
+    };
+}
+export function readTrackedCellChange(input) {
+    const { cellIndex, strings, trackedA1, workbook } = input;
+    const cellStore = workbook.cellStore;
+    const sheetId = cellStore.sheetIds[cellIndex];
+    if (sheetId === undefined) {
+        return undefined;
+    }
+    const sheet = workbook.getSheetById(sheetId);
+    const sheetName = sheet?.name ?? workbook.getSheetNameById(sheetId);
+    if (sheetName === undefined) {
+        return undefined;
+    }
+    let row;
+    let col;
+    if (!sheet || sheet.structureVersion === 1) {
+        const physicalRow = cellStore.rows[cellIndex];
+        const physicalCol = cellStore.cols[cellIndex];
+        if (physicalRow === undefined || physicalCol === undefined) {
+            return undefined;
+        }
+        row = physicalRow;
+        col = physicalCol;
+    }
+    else {
+        const position = workbook.getCellPosition(cellIndex);
+        if (!position) {
+            return undefined;
+        }
+        row = position.row;
+        col = position.col;
+    }
+    return {
+        kind: 'cell',
+        address: { sheet: sheetId, row, col },
+        sheetName,
+        a1: trackedA1(row, col),
+        newValue: readTrackedRuntimeCellValue(cellStore, cellIndex, strings),
+    };
+}
+export function readTinySortedPhysicalTrackedEventChanges(input) {
+    const { event, strings, trackedA1, workbook } = input;
+    if (!event.changedCellIndicesSortedDisjoint) {
+        return null;
+    }
+    const cellStore = workbook.cellStore;
+    const firstCellIndex = event.changedCellIndices[0];
+    if (firstCellIndex === undefined) {
+        return [];
+    }
+    const sheetId = cellStore.sheetIds[firstCellIndex];
+    if (sheetId === undefined) {
+        return [];
+    }
+    const sheet = workbook.getSheetById(sheetId);
+    if (sheet && sheet.structureVersion !== 1) {
+        return null;
+    }
+    const sheetName = sheet?.name ?? workbook.getSheetNameById(sheetId);
+    if (sheetName === undefined) {
+        return null;
+    }
+    const changes = [];
+    let previousRow = -1;
+    let previousCol = -1;
+    for (let index = 0; index < event.changedCellIndices.length; index += 1) {
+        const cellIndex = event.changedCellIndices[index];
+        if (cellStore.sheetIds[cellIndex] !== sheetId) {
+            return null;
+        }
+        const row = cellStore.rows[cellIndex];
+        const col = cellStore.cols[cellIndex];
+        if (row === undefined || col === undefined) {
+            return null;
+        }
+        if (row < previousRow || (row === previousRow && col < previousCol)) {
+            return null;
+        }
+        changes.push({
+            kind: 'cell',
+            address: { sheet: sheetId, row, col },
+            sheetName,
+            a1: trackedA1(row, col),
+            newValue: readTrackedRuntimeCellValue(cellStore, cellIndex, strings),
+        });
+        previousRow = row;
+        previousCol = col;
+    }
+    return changes;
+}
+export function tryBuildDirectSingleLiteralTrackedChange(input) {
+    const { cellStore, events, expected, strings, trackedA1 } = input;
+    if (expected === undefined || expected.cellIndex === undefined || events.length !== 1) {
+        return null;
+    }
+    const event = events[0];
+    if (event.invalidation === 'full' ||
+        event.patches !== undefined ||
+        event.changedCellIndices.length < 1 ||
+        event.changedCellIndices.length > 2 ||
+        event.changedCellIndices[0] !== expected.cellIndex ||
+        event.hasInvalidatedRanges ||
+        event.hasInvalidatedRows ||
+        event.hasInvalidatedColumns) {
+        return null;
+    }
+    const literalChange = {
+        kind: 'cell',
+        address: { sheet: expected.address.sheet, row: expected.address.row, col: expected.address.col },
+        sheetName: expected.sheetName,
+        a1: trackedA1(expected.address.row, expected.address.col),
+        newValue: scalarValueFromLiteral(expected.value),
+    };
+    if (event.changedCellIndices.length === 1) {
+        return [literalChange];
+    }
+    const formulaCellIndex = event.changedCellIndices[1];
+    if (cellStore.sheetIds[formulaCellIndex] !== expected.address.sheet || !expected.isPhysicalSheet) {
+        return null;
+    }
+    const formulaRow = cellStore.rows[formulaCellIndex];
+    const formulaCol = cellStore.cols[formulaCellIndex];
+    if (formulaRow === undefined ||
+        formulaCol === undefined ||
+        formulaRow < expected.address.row ||
+        (formulaRow === expected.address.row && formulaCol < expected.address.col)) {
+        return null;
+    }
+    return [
+        literalChange,
+        {
+            kind: 'cell',
+            address: { sheet: expected.address.sheet, row: formulaRow, col: formulaCol },
+            sheetName: expected.sheetName,
+            a1: trackedA1(formulaRow, formulaCol),
+            newValue: readTrackedRuntimeCellValue(cellStore, formulaCellIndex, strings),
+        },
+    ];
+}
+export function tryBuildDirectExistingNumericTrackedChanges(input) {
+    const { address, cellIndex, cellStore, isPhysicalSheet, orderChanges, result, sheetName, strings, trackedA1, value } = input;
+    const changedCellCount = result.changedCellIndices?.length ?? result.changedCellCount ?? 0;
+    const firstChangedCellIndex = result.changedCellIndices?.[0] ?? result.firstChangedCellIndex;
+    if (changedCellCount < 1 || firstChangedCellIndex !== cellIndex) {
+        return null;
+    }
+    const literalChange = {
+        kind: 'cell',
+        address: { sheet: address.sheet, row: address.row, col: address.col },
+        sheetName,
+        a1: trackedA1(address.row, address.col),
+        newValue: { tag: ValueTag.Number, value },
+    };
+    if (changedCellCount === 1) {
+        return [literalChange];
+    }
+    if (!isPhysicalSheet) {
+        return null;
+    }
+    if (changedCellCount > 2) {
+        const changedCellIndices = result.changedCellIndices;
+        if (changedCellIndices === undefined) {
+            return null;
+        }
+        const changes = [];
+        changes.length = changedCellCount;
+        changes[0] = literalChange;
+        let alreadySorted = true;
+        let previousRow = address.row;
+        let previousCol = address.col;
+        for (let index = 1; index < changedCellCount; index += 1) {
+            const changedCellIndex = changedCellIndices[index];
+            if (cellStore.sheetIds[changedCellIndex] !== address.sheet) {
+                return null;
+            }
+            const row = cellStore.rows[changedCellIndex];
+            const col = cellStore.cols[changedCellIndex];
+            if (row === undefined || col === undefined) {
+                return null;
+            }
+            if (row < previousRow || (row === previousRow && col < previousCol)) {
+                alreadySorted = false;
+            }
+            changes[index] = {
+                kind: 'cell',
+                address: { sheet: address.sheet, row, col },
+                sheetName,
+                a1: trackedA1(row, col),
+                newValue: readTrackedRuntimeCellValue(cellStore, changedCellIndex, strings),
+            };
+            previousRow = row;
+            previousCol = col;
+        }
+        return alreadySorted ? changes : orderChanges(changes, result.explicitChangedCount);
+    }
+    const formulaCellIndex = result.changedCellIndices?.[1] ?? result.secondChangedCellIndex;
+    if (formulaCellIndex === undefined || cellStore.sheetIds[formulaCellIndex] !== address.sheet) {
+        return null;
+    }
+    const formulaRow = result.secondChangedRow ?? cellStore.rows[formulaCellIndex];
+    const formulaCol = result.secondChangedCol ?? cellStore.cols[formulaCellIndex];
+    if (formulaRow === undefined ||
+        formulaCol === undefined ||
+        formulaRow < address.row ||
+        (formulaRow === address.row && formulaCol < address.col)) {
+        return null;
+    }
+    return [
+        literalChange,
+        {
+            kind: 'cell',
+            address: { sheet: address.sheet, row: formulaRow, col: formulaCol },
+            sheetName,
+            a1: trackedA1(formulaRow, formulaCol),
+            newValue: result.secondChangedNumericValue === undefined
+                ? readTrackedRuntimeCellValue(cellStore, formulaCellIndex, strings)
+                : { tag: ValueTag.Number, value: result.secondChangedNumericValue },
+        },
+    ];
+}
+export function withEventChanges(event, changes) {
+    switch (event.eventName) {
+        case 'sheetAdded':
+            return event;
+        case 'sheetRemoved':
+            return {
+                eventName: 'sheetRemoved',
+                payload: {
+                    ...event.payload,
+                    changes,
+                },
+            };
+        case 'sheetRenamed':
+            return event;
+        case 'namedExpressionAdded':
+            return {
+                eventName: 'namedExpressionAdded',
+                payload: {
+                    ...event.payload,
+                    changes,
+                },
+            };
+        case 'namedExpressionRemoved':
+            return {
+                eventName: 'namedExpressionRemoved',
+                payload: {
+                    ...event.payload,
+                    changes,
+                },
+            };
+    }
+}
+//# sourceMappingURL=work-paper-tracked-event-helpers.js.map

package/dist/work-paper-tracked-event-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-paper-tracked-event-helpers.js","sourceRoot":"","sources":["../src/work-paper-tracked-event-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAqC,MAAM,iBAAiB,CAAA;AAI7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AAExE,MAAM,CAAC,MAAM,0CAA0C,GAAG,+BAA+B,CAAA;AACzF,MAAM,CAAC,MAAM,8CAA8C,GAAG,wCAAwC,CAAA;AACtG,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAA;AA8C1C,MAAM,UAAU,wCAAwC,CACtD,kBAA+B;IAE/B,MAAM,sBAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,0CAA0C,CAAC,CAAA;IAC1G,IAAI,OAAO,sBAAsB,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,sBAAsB,CAAC,IAAI,sBAAsB,GAAG,CAAC,EAAE,CAAC;QAC1H,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,uBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,8CAA8C,CAAC,CAAA;IAC/G,OAAO,OAAO,uBAAuB,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,uBAAuB,CAAC,IAAI,uBAAuB,GAAG,CAAC;QAC5H,CAAC,CAAC,EAAE,sBAAsB,EAAE,uBAAuB,EAAE;QACrD,CAAC,CAAC,EAAE,sBAAsB,EAAE,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAyB;IACrE,OAAO,CACL,KAAK,CAAC,YAAY,KAAK,MAAM;QAC7B,KAAK,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC;QACrC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,CAClE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,IAAsC;IAC1F,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC5E,KAAK,IAAI,CAAC,CAAA;QACZ,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,IAAsC,EACtC,iBAAqC;IAErC,IAAI,iBAAiB,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,IAAI,GAAG,EAAE,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxG,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,SAA2C,EAC3C,SAAiB,EACjB,OAAmC;IAEnC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAA;IACvD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAA;QAC3E,KAAK,QAAQ,CAAC,OAAO;YACnB,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAA;QACpF,KAAK,QAAQ,CAAC,MAAM;YAClB,OAAO,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC3E,KAAK,QAAQ,CAAC,KAAK;YACjB,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS,CAAE,EAAE,CAAA;QACpE,KAAK,QAAQ,CAAC,KAAK,CAAC;QACpB;YACE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAA;IAClC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uCAAuC,CAAC,MAA+C;IACrG,OAAO,MAAM,CAAC,kBAAkB,EAAE,MAAM,IAAI,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,MAA+C,EAAE,KAAa;IACjH,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC,qBAAqB,CAAA;IACrC,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC,sBAAsB,CAAA;IACtC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,oDAAoD,CAAC,MAA+C;IAClH,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,kBAAkB,CAAA;IAClC,CAAC;IACD,MAAM,KAAK,GAAG,uCAAuC,CAAC,MAAM,CAAC,CAAA;IAC7D,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAA;IACtC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,GAAG,oCAAoC,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3E,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,6CAA6C,CAAC,MAA+C;IAC3G,IAAI,cAAc,GAAG,IAAI,CAAA;IACzB,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAA;IACjB,IAAI,qBAAyC,CAAA;IAC7C,IAAI,oBAAwC,CAAA;IAC5C,MAAM,gBAAgB,GAAG,uCAAuC,CAAC,MAAM,CAAC,CAAA;IACxE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,gBAAgB,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,SAAS,GAAG,oCAAoC,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QAC3E,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,qBAAqB,GAAG,SAAS,CAAA;QACnC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;YAC3E,cAAc,GAAG,KAAK,CAAA;QACxB,CAAC;QACD,QAAQ,GAAG,SAAS,CAAA;QACpB,oBAAoB,GAAG,SAAS,CAAA;IAClC,CAAC;IACD,OAAO;QACL,YAAY,EAAE,OAAO;QACrB,kBAAkB,EAAE,oDAAoD,CAAC,MAAM,CAAC;QAChF,iBAAiB,EAAE,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,gCAAgC,EAAE,cAAc;QAChD,GAAG,CAAC,qBAAqB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;QACzE,GAAG,CAAC,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC;QACvE,oBAAoB,EAAE,KAAK;QAC3B,kBAAkB,EAAE,KAAK;QACzB,qBAAqB,EAAE,KAAK;KAC7B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAKrC;IACC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;IACzD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAA;IACpC,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IAC5C,MAAM,SAAS,GAAG,KAAK,EAAE,IAAI,IAAI,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACnE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,GAAW,CAAA;IACf,IAAI,GAAW,CAAA;IACf,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,gBAAgB,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC7C,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC3D,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,GAAG,GAAG,WAAW,CAAA;QACjB,GAAG,GAAG,WAAW,CAAA;IACnB,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAA;QAClB,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAA;IACpB,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE;QACrC,SAAS;QACT,EAAE,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;QACvB,QAAQ,EAAE,2BAA2B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;KACrE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,yCAAyC,CAAC,KAKzD;IACC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;IACrD,IAAI,CAAC,KAAK,CAAC,gCAAgC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAA;IACpC,MAAM,cAAc,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAA;IAClD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,EAAE,CAAA;IACX,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;IAClD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IAC5C,IAAI,KAAK,IAAI,KAAK,CAAC,gBAAgB,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,EAAE,IAAI,IAAI,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACnE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,OAAO,GAA0B,EAAE,CAAA;IACzC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAA;IACpB,IAAI,WAAW,GAAG,CAAC,CAAC,CAAA;IACpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,kBAAkB,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxE,MAAM,SAAS,GAAG,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAE,CAAA;QAClD,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,OAAO,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACrC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACrC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,GAAG,GAAG,WAAW,IAAI,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,GAAG,WAAW,CAAC,EAAE,CAAC;YACpE,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE;YACrC,SAAS;YACT,EAAE,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;YACvB,QAAQ,EAAE,2BAA2B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;SACrE,CAAC,CAAA;QACF,WAAW,GAAG,GAAG,CAAA;QACjB,WAAW,GAAG,GAAG,CAAA;IACnB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,wCAAwC,CAAC,KAMxD;IACC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAA;IACjE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtF,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAA;IACxB,IACE,KAAK,CAAC,YAAY,KAAK,MAAM;QAC7B,KAAK,CAAC,OAAO,KAAK,SAAS;QAC3B,KAAK,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;QACnC,KAAK,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;QACnC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,SAAS;QAClD,KAAK,CAAC,oBAAoB;QAC1B,KAAK,CAAC,kBAAkB;QACxB,KAAK,CAAC,qBAAqB,EAC3B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,aAAa,GAAwB;QACzC,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE;QAChG,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC;QACzD,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC;KACjD,CAAA;IACD,IAAI,KAAK,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,aAAa,CAAC,CAAA;IACxB,CAAC;IACD,MAAM,gBAAgB,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAE,CAAA;IACrD,IAAI,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QACjG,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACnD,IACE,UAAU,KAAK,SAAS;QACxB,UAAU,KAAK,SAAS;QACxB,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG;QACjC,CAAC,UAAU,KAAK,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAC1E,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO;QACL,aAAa;QACb;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE;YAC5E,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,EAAE,EAAE,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;YACrC,QAAQ,EAAE,2BAA2B,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC;SAC5E;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,2CAA2C,CAAC,KAW3D;IACC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IAC5H,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,EAAE,MAAM,IAAI,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAA;IAC1F,MAAM,qBAAqB,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,qBAAqB,CAAA;IAC5F,IAAI,gBAAgB,GAAG,CAAC,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;QAChE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,aAAa,GAAwB;QACzC,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QACrE,SAAS;QACT,EAAE,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;QACvC,QAAQ,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE;KAC1C,CAAA;IACD,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,aAAa,CAAC,CAAA;IACxB,CAAC;IACD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAA;QACpD,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,OAAO,GAA0B,EAAE,CAAA;QACzC,OAAO,CAAC,MAAM,GAAG,gBAAgB,CAAA;QACjC,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAA;QAC1B,IAAI,aAAa,GAAG,IAAI,CAAA;QACxB,IAAI,WAAW,GAAG,OAAO,CAAC,GAAG,CAAA;QAC7B,IAAI,WAAW,GAAG,OAAO,CAAC,GAAG,CAAA;QAC7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,gBAAgB,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,KAAK,CAAE,CAAA;YACnD,IAAI,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC3D,OAAO,IAAI,CAAA;YACb,CAAC;YACD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;YAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;YAC5C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC3C,OAAO,IAAI,CAAA;YACb,CAAC;YACD,IAAI,GAAG,GAAG,WAAW,IAAI,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,GAAG,WAAW,CAAC,EAAE,CAAC;gBACpE,aAAa,GAAG,KAAK,CAAA;YACvB,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,GAAG;gBACf,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;gBAC3C,SAAS;gBACT,EAAE,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;gBACvB,QAAQ,EAAE,2BAA2B,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC;aAC5E,CAAA;YACD,WAAW,GAAG,GAAG,CAAA;YACjB,WAAW,GAAG,GAAG,CAAA;QACnB,CAAC;QACD,OAAO,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAA;IACrF,CAAC;IACD,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,sBAAsB,CAAA;IACxF,IAAI,gBAAgB,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7F,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,gBAAgB,IAAI,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,gBAAgB,IAAI,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC9E,IACE,UAAU,KAAK,SAAS;QACxB,UAAU,KAAK,SAAS;QACxB,UAAU,GAAG,OAAO,CAAC,GAAG;QACxB,CAAC,UAAU,KAAK,OAAO,CAAC,GAAG,IAAI,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,EACxD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO;QACL,aAAa;QACb;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE;YACnE,SAAS;YACT,EAAE,EAAE,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;YACrC,QAAQ,EACN,MAAM,CAAC,yBAAyB,KAAK,SAAS;gBAC5C,CAAC,CAAC,2BAA2B,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC;gBACnE,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,yBAAyB,EAAE;SACxE;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAkB,EAAE,OAA0B;IAC7E,QAAQ,KAAK,CAAC,SAAS,EAAE,CAAC;QACxB,KAAK,YAAY;YACf,OAAO,KAAK,CAAA;QACd,KAAK,cAAc;YACjB,OAAO;gBACL,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE;oBACP,GAAG,KAAK,CAAC,OAAO;oBAChB,OAAO;iBACR;aACF,CAAA;QACH,KAAK,cAAc;YACjB,OAAO,KAAK,CAAA;QACd,KAAK,sBAAsB;YACzB,OAAO;gBACL,SAAS,EAAE,sBAAsB;gBACjC,OAAO,EAAE;oBACP,GAAG,KAAK,CAAC,OAAO;oBAChB,OAAO;iBACR;aACF,CAAA;QACH,KAAK,wBAAwB;YAC3B,OAAO;gBACL,SAAS,EAAE,wBAAwB;gBACnC,OAAO,EAAE;oBACP,GAAG,KAAK,CAAC,OAAO;oBAChB,OAAO;iBACR;aACF,CAAA;IACL,CAAC;AACH,CAAC"}

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

@@ -112,13 +112,14 @@ export interface WorkPaperConfig {
     accentSensitive?: boolean;
     caseSensitive?: boolean;
     caseFirst?: 'upper' | 'lower' | 'false';
-    chooseAddressMappingPolicy?: WorkPaperChooseAddressMappingPolicy;
-    context?: WorkPaperContextValue;
+    chooseAddressMappingPolicy?: WorkPaperChooseAddressMappingPolicy | undefined;
+    context?: WorkPaperContextValue | undefined;
     currencySymbol?: string[];
     dateFormats?: string[];
     functionArgSeparator?: string;
     decimalSeparator?: '.' | ',';
     evaluateNullToZero?: boolean;
+    evaluationTimeoutMs?: number | undefined;
     functionPlugins?: WorkPaperFunctionPluginDefinition[];
     ignorePunctuation?: boolean;
     language?: string;
@@ -137,11 +138,11 @@ export interface WorkPaperConfig {
         day: number;
     };
     nullYear?: number;
-    parseDateTime?: WorkPaperParseDateTime;
+    parseDateTime?: WorkPaperParseDateTime | undefined;
     precisionEpsilon?: number;
     precisionRounding?: number;
-    stringifyDateTime?: WorkPaperStringifyDateTime;
-    stringifyDuration?: WorkPaperStringifyDuration;
+    stringifyDateTime?: WorkPaperStringifyDateTime | undefined;
+    stringifyDuration?: WorkPaperStringifyDuration | undefined;
     smartRounding?: boolean;
     thousandSeparator?: '' | ',' | '.';
     timeFormats?: string[];

package/dist/work-paper-visibility-snapshot.d.ts

@@ -0,0 +1,36 @@
+import { type CellValue } from '@bilig/protocol';
+import type { WorkPaperChange } from './work-paper-types.js';
+export interface WorkPaperVisibilityCellStore {
+    readonly getValue: (cellIndex: number, readString: (id: number) => string) => CellValue;
+}
+export interface WorkPaperVisibilityStringPool {
+    readonly get: (id: number) => string;
+}
+export interface WorkPaperVisibilitySheetRecord {
+    readonly id: number;
+    readonly name: string;
+    readonly order: number;
+    readonly grid: {
+        readonly forEachCellEntry: (visit: (cellIndex: number, row: number, col: number) => void) => void;
+    };
+}
+export interface SheetStateSnapshot {
+    readonly sheetId: number;
+    readonly sheetName: string;
+    readonly order: number;
+    readonly cells: Map<number, CellValue>;
+}
+export type VisibilitySnapshot = Map<number, SheetStateSnapshot>;
+export declare function captureWorkPaperVisibilitySnapshot(input: {
+    readonly sheets: readonly WorkPaperVisibilitySheetRecord[];
+    readonly cellStore: WorkPaperVisibilityCellStore;
+    readonly strings: WorkPaperVisibilityStringPool;
+}): VisibilitySnapshot;
+export declare function computeWorkPaperCellChangesFromVisibilitySnapshots(input: {
+    readonly beforeVisibility: VisibilitySnapshot;
+    readonly afterVisibility: VisibilitySnapshot;
+    readonly sheets: readonly {
+        readonly id: number;
+        readonly order: number;
+    }[];
+}): WorkPaperChange[];

package/dist/work-paper-visibility-snapshot.js

@@ -0,0 +1,62 @@
+import { MAX_COLS, MAX_ROWS, ValueTag } from '@bilig/protocol';
+import { formatAddress } from '@bilig/formula';
+import { orderWorkPaperCellChanges } from './change-order.js';
+import { emptyValue, valuesEqual } from './work-paper-runtime-helpers.js';
+const VISIBILITY_SHEET_STRIDE = MAX_ROWS * MAX_COLS;
+export function captureWorkPaperVisibilitySnapshot(input) {
+    const snapshot = new Map();
+    input.sheets.forEach((sheet) => {
+        const cells = new Map();
+        sheet.grid.forEachCellEntry((cellIndex, row, col) => {
+            const value = input.cellStore.getValue(cellIndex, (id) => input.strings.get(id));
+            if (value.tag === ValueTag.Empty) {
+                return;
+            }
+            cells.set(sheetCellVisibilityKey(sheet.id, row, col), value);
+        });
+        snapshot.set(sheet.id, {
+            sheetId: sheet.id,
+            sheetName: sheet.name,
+            order: sheet.order,
+            cells,
+        });
+    });
+    return snapshot;
+}
+export function computeWorkPaperCellChangesFromVisibilitySnapshots(input) {
+    const cellChanges = [];
+    input.afterVisibility.forEach((afterSheet, sheetId) => {
+        const beforeSheet = input.beforeVisibility.get(sheetId);
+        const cellKeys = new Set([...(beforeSheet?.cells.keys() ?? []), ...afterSheet.cells.keys()]);
+        [...cellKeys]
+            .toSorted((left, right) => left - right)
+            .forEach((cellKey) => {
+            const beforeValue = beforeSheet?.cells.get(cellKey) ?? emptyValue();
+            const afterValue = afterSheet.cells.get(cellKey) ?? emptyValue();
+            if (valuesEqual(beforeValue, afterValue)) {
+                return;
+            }
+            const { row, col } = visibilityKeyPosition(afterSheet.sheetId, cellKey);
+            const address = formatAddress(row, col);
+            cellChanges.push({
+                kind: 'cell',
+                address: { sheet: sheetId, row, col },
+                sheetName: afterSheet.sheetName,
+                a1: address,
+                newValue: afterValue,
+            });
+        });
+    });
+    return orderWorkPaperCellChanges(cellChanges, input.sheets);
+}
+function sheetCellVisibilityKey(sheetId, row, col) {
+    return sheetId * VISIBILITY_SHEET_STRIDE + row * MAX_COLS + col;
+}
+function visibilityKeyPosition(sheetId, cellKey) {
+    const localKey = cellKey - sheetId * VISIBILITY_SHEET_STRIDE;
+    return {
+        row: Math.floor(localKey / MAX_COLS),
+        col: localKey % MAX_COLS,
+    };
+}
+//# sourceMappingURL=work-paper-visibility-snapshot.js.map

package/dist/work-paper-visibility-snapshot.js.map

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

package/package.json

@@ -1,12 +1,20 @@
 {
   "name": "@bilig/headless",
-  "version": "0.8.0",
-  "description": "WorkPaper spreadsheet workbook facade for bilig with HyperFormula-style workflows.",
+  "version": "0.8.2",
+  "description": "Headless spreadsheet engine and WorkPaper workbook facade for Node services, coding agents, and HyperFormula-style workflows.",
   "keywords": [
+    "agent",
+    "automation",
     "bilig",
     "formula",
+    "formula-engine",
     "headless",
+    "headless-spreadsheet",
+    "hyperformula",
+    "local-first",
+    "node",
     "spreadsheet",
+    "spreadsheet-engine",
     "workbook"
   ],
   "homepage": "https://github.com/proompteng/bilig/tree/main/packages/headless#readme",
@@ -41,9 +49,9 @@
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@bilig/core": "0.8.0",
-    "@bilig/formula": "0.8.0",
-    "@bilig/protocol": "0.8.0"
+    "@bilig/core": "0.8.2",
+    "@bilig/formula": "0.8.2",
+    "@bilig/protocol": "0.8.2"
   },
   "engines": {
     "node": ">=24.0.0"