@bilig/headless 0.8.0 → 0.8.2

package/dist/work-paper-tracked-change-reducer.js

@@ -0,0 +1,281 @@
+import { makeCellKey } from '@bilig/core';
+import { ValueTag } from '@bilig/protocol';
+import { orderWorkPaperCellChanges } from './change-order.js';
+import { TINY_TRACKED_CHANGE_LIMIT } from './work-paper-tracked-event-helpers.js';
+export function tryReadTinyTrackedEventChangesWithoutVisibility(input) {
+    const event = input.event;
+    if (event.patches !== undefined &&
+        event.invalidation !== 'full' &&
+        event.patches.length <= TINY_TRACKED_CHANGE_LIMIT &&
+        !event.hasInvalidatedRanges &&
+        !event.hasInvalidatedRows &&
+        !event.hasInvalidatedColumns) {
+        return tryReadTinyPatchTrackedEventChanges(input, event.patches, event.explicitChangedCount);
+    }
+    if (event.invalidation === 'full' ||
+        event.patches !== undefined ||
+        event.changedCellIndices.length > TINY_TRACKED_CHANGE_LIMIT ||
+        event.hasInvalidatedRanges ||
+        event.hasInvalidatedRows ||
+        event.hasInvalidatedColumns) {
+        return null;
+    }
+    if (event.changedCellIndices.length === 0) {
+        return [];
+    }
+    const sortedPhysicalChanges = input.readTinySortedPhysicalTrackedEventChanges(event);
+    if (sortedPhysicalChanges) {
+        return sortedPhysicalChanges;
+    }
+    return (readSmallTrackedEventChanges({
+        event,
+        listSheets: input.listSheets,
+        readSingleTrackedCellChange: input.readSingleTrackedCellChange,
+        sheetOrder: input.sheetOrder,
+        updateVisibility: false,
+    })?.changes ?? null);
+}
+export function computeWorkPaperTrackedCellChangesFromEvents(input) {
+    const updateVisibility = input.updateVisibility ?? true;
+    if (input.events.some((event) => event.invalidation === 'full')) {
+        return null;
+    }
+    const nextVisibility = input.beforeVisibility;
+    const sheetOrders = new Map();
+    const sheetOrderFor = (sheetId) => {
+        const existing = sheetOrders.get(sheetId);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const order = input.sheetOrder(sheetId);
+        sheetOrders.set(sheetId, order);
+        return order;
+    };
+    const ensureMutableSheet = (sheetId, sheetName) => {
+        const existing = nextVisibility.get(sheetId);
+        if (existing) {
+            return existing;
+        }
+        const created = {
+            sheetId,
+            sheetName,
+            order: input.sheetOrder(sheetId),
+            cells: new Map(),
+        };
+        nextVisibility.set(sheetId, created);
+        return created;
+    };
+    if (input.events.length === 1) {
+        const event = input.events[0];
+        if (!input.preferLazyPublicChanges) {
+            const smallChanges = readSmallTrackedEventChanges({
+                event,
+                ensureMutableSheet,
+                listSheets: input.listSheets,
+                readSingleTrackedCellChange: input.readSingleTrackedCellChange,
+                sheetOrder: sheetOrderFor,
+                updateVisibility,
+            });
+            if (smallChanges) {
+                return { changes: smallChanges.changes, nextVisibility };
+            }
+        }
+        const materializedEventChanges = input.materializeTrackedEventChanges(event, !updateVisibility);
+        const eventChanges = materializedEventChanges.changes;
+        if (!updateVisibility && materializedEventChanges.canReusePublicChanges && materializedEventChanges.ordered) {
+            return {
+                changes: eventChanges,
+                nextVisibility,
+            };
+        }
+        const directChanges = reduceSingleEventChanges({
+            event,
+            eventChanges,
+            ensureMutableSheet,
+            listSheets: input.listSheets,
+            materializedEventChanges,
+            sheetOrder: sheetOrderFor,
+            updateVisibility,
+        });
+        if (directChanges) {
+            return { changes: directChanges, nextVisibility };
+        }
+    }
+    const materializedSources = updateVisibility
+        ? null
+        : (input.materializeTrackedEventSources?.(input.events, input.preferLazyPublicChanges === undefined ? {} : { preferLazyPublicChanges: input.preferLazyPublicChanges }) ?? null);
+    if (materializedSources) {
+        return {
+            changes: materializedSources.ordered
+                ? materializedSources.changes
+                : orderWorkPaperCellChanges(materializedSources.changes, input.listSheets()),
+            nextVisibility,
+        };
+    }
+    const latestChangesByKey = new Map();
+    for (const event of input.events) {
+        const eventChanges = input.materializeTrackedEventChanges(event).changes;
+        for (let index = 0; index < eventChanges.length; index += 1) {
+            const change = eventChanges[index];
+            const cellKey = makeCellKey(change.address.sheet, change.address.row, change.address.col);
+            latestChangesByKey.delete(cellKey);
+            latestChangesByKey.set(cellKey, toPublicCellChange(change));
+        }
+    }
+    if (updateVisibility) {
+        for (const change of latestChangesByKey.values()) {
+            applyTrackedChangeToVisibility(ensureMutableSheet(change.address.sheet, change.sheetName), change);
+        }
+    }
+    const directChanges = [...latestChangesByKey.values()];
+    return {
+        changes: orderWorkPaperCellChanges(directChanges, input.listSheets()),
+        nextVisibility,
+    };
+}
+function tryReadTinyPatchTrackedEventChanges(input, patches, explicitChangedCount) {
+    const changes = [];
+    let alreadySorted = true;
+    let previousSheetId = -1;
+    let previousSheetOrder = -1;
+    let previousRow = -1;
+    let previousCol = -1;
+    for (let index = 0; index < patches.length; index += 1) {
+        const patch = patches[index];
+        if (!patch || patch.kind !== 'cell') {
+            return null;
+        }
+        const sheetOrder = patch.address.sheet === previousSheetId ? previousSheetOrder : input.sheetOrder(patch.address.sheet);
+        if (sheetOrder < previousSheetOrder ||
+            (sheetOrder === previousSheetOrder &&
+                (patch.address.row < previousRow || (patch.address.row === previousRow && patch.address.col < previousCol)))) {
+            alreadySorted = false;
+        }
+        changes.push(toPublicCellChange(patch));
+        previousSheetId = patch.address.sheet;
+        previousSheetOrder = sheetOrder;
+        previousRow = patch.address.row;
+        previousCol = patch.address.col;
+    }
+    return alreadySorted ? changes : orderWorkPaperCellChanges(changes, input.listSheets(), explicitChangedCount);
+}
+function readSmallTrackedEventChanges(input) {
+    const event = input.event;
+    if (event.invalidation === 'full' ||
+        event.patches !== undefined ||
+        event.changedCellIndices.length > TINY_TRACKED_CHANGE_LIMIT ||
+        event.hasInvalidatedRanges ||
+        event.hasInvalidatedRows ||
+        event.hasInvalidatedColumns) {
+        return null;
+    }
+    if (event.changedCellIndices.length === 0) {
+        return { changes: [] };
+    }
+    const changes = [];
+    const cellKeys = [];
+    let alreadySorted = true;
+    let previousSheetOrder = -1;
+    let previousRow = -1;
+    let previousCol = -1;
+    for (let index = 0; index < event.changedCellIndices.length; index += 1) {
+        const change = input.readSingleTrackedCellChange(event.changedCellIndices[index]);
+        if (!change) {
+            continue;
+        }
+        const cellKey = makeCellKey(change.address.sheet, change.address.row, change.address.col);
+        for (let priorIndex = 0; priorIndex < cellKeys.length; priorIndex += 1) {
+            if (cellKeys[priorIndex] === cellKey) {
+                return null;
+            }
+        }
+        cellKeys.push(cellKey);
+        const sheet = input.updateVisibility ? input.ensureMutableSheet?.(change.address.sheet, change.sheetName) : undefined;
+        const sheetOrder = sheet?.order ?? input.sheetOrder(change.address.sheet);
+        if (sheetOrder < previousSheetOrder ||
+            (sheetOrder === previousSheetOrder &&
+                (change.address.row < previousRow || (change.address.row === previousRow && change.address.col < previousCol)))) {
+            alreadySorted = false;
+        }
+        if (sheet) {
+            applyTrackedChangeToVisibility(sheet, change);
+        }
+        changes.push(change);
+        previousSheetOrder = sheetOrder;
+        previousRow = change.address.row;
+        previousCol = change.address.col;
+    }
+    return {
+        changes: alreadySorted ? changes : orderWorkPaperCellChanges(changes, input.listSheets(), event.explicitChangedCount),
+    };
+}
+function reduceSingleEventChanges(input) {
+    const directChanges = [];
+    const seenCellKeys = input.eventChanges.length > 4 && input.eventChanges.length <= 64 ? new Set() : undefined;
+    const smallCellKeys = input.eventChanges.length > 1 && input.eventChanges.length <= 4 ? [] : undefined;
+    let hasDuplicateCellKey = false;
+    let alreadySorted = true;
+    let previousSheetOrder = -1;
+    let previousRow = -1;
+    let previousCol = -1;
+    for (let index = 0; index < input.eventChanges.length; index += 1) {
+        const change = input.eventChanges[index];
+        const cellKey = makeCellKey(change.address.sheet, change.address.row, change.address.col);
+        if (seenCellKeys) {
+            if (seenCellKeys.has(cellKey)) {
+                hasDuplicateCellKey = true;
+                break;
+            }
+            seenCellKeys.add(cellKey);
+        }
+        else if (smallCellKeys) {
+            for (let priorIndex = 0; priorIndex < index; priorIndex += 1) {
+                if (smallCellKeys[priorIndex] === cellKey) {
+                    hasDuplicateCellKey = true;
+                    break;
+                }
+            }
+            if (hasDuplicateCellKey) {
+                break;
+            }
+            smallCellKeys[index] = cellKey;
+        }
+        const sheet = input.updateVisibility ? input.ensureMutableSheet(change.address.sheet, change.sheetName) : undefined;
+        const sheetOrder = sheet?.order ?? input.sheetOrder(change.address.sheet);
+        if (sheetOrder < previousSheetOrder ||
+            (sheetOrder === previousSheetOrder &&
+                (change.address.row < previousRow || (change.address.row === previousRow && change.address.col < previousCol)))) {
+            alreadySorted = false;
+        }
+        if (sheet) {
+            applyTrackedChangeToVisibility(sheet, change);
+        }
+        directChanges[index] = input.materializedEventChanges.canReusePublicChanges ? change : toPublicCellChange(change);
+        previousSheetOrder = sheetOrder;
+        previousRow = change.address.row;
+        previousCol = change.address.col;
+    }
+    if (hasDuplicateCellKey) {
+        return null;
+    }
+    return alreadySorted ? directChanges : orderWorkPaperCellChanges(directChanges, input.listSheets(), input.event.explicitChangedCount);
+}
+function applyTrackedChangeToVisibility(sheet, change) {
+    const cellKey = makeCellKey(change.address.sheet, change.address.row, change.address.col);
+    if (change.newValue.tag === ValueTag.Empty) {
+        sheet.cells.delete(cellKey);
+    }
+    else {
+        sheet.cells.set(cellKey, change.newValue);
+    }
+}
+function toPublicCellChange(change) {
+    return {
+        kind: 'cell',
+        address: change.address,
+        sheetName: change.sheetName,
+        a1: change.a1,
+        newValue: change.newValue,
+    };
+}
+//# sourceMappingURL=work-paper-tracked-change-reducer.js.map

package/dist/work-paper-tracked-change-reducer.js.map

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

package/dist/work-paper-tracked-event-helpers.d.ts

@@ -0,0 +1,89 @@
+import type { EngineCellMutationRef, EngineExistingNumericCellMutationResult } from '@bilig/core';
+import { ValueTag, type CellValue, type LiteralInput } from '@bilig/protocol';
+import type { WorkPaperDetailedEvent } from './work-paper-emitter.js';
+import type { WorkPaperCellAddress, WorkPaperCellChange, WorkPaperChange } from './work-paper-types.js';
+import type { TrackedEngineEvent } from './tracked-engine-event-refs.js';
+export declare const TRUSTED_TRACKED_PHYSICAL_SHEET_ID_PROPERTY = "__biligTrackedPhysicalSheetId";
+export declare const TRUSTED_TRACKED_PHYSICAL_SORTED_SPLIT_PROPERTY = "__biligTrackedPhysicalSortedSliceSplit";
+export declare const TINY_TRACKED_CHANGE_LIMIT = 4;
+export interface WorkPaperTrackedRuntimeCellStore {
+    readonly tags: ArrayLike<ValueTag | undefined>;
+    readonly numbers: ArrayLike<number | undefined>;
+    readonly errors: ArrayLike<number | undefined>;
+    readonly getValue: (cellIndex: number, readString: (stringId: number) => string) => CellValue;
+}
+export interface WorkPaperTrackedStringPool {
+    readonly get: (id: number) => string;
+}
+export interface WorkPaperTrackedSheetRecord {
+    readonly name: string;
+    readonly structureVersion: number;
+}
+export interface WorkPaperTrackedWorkbookAccess {
+    readonly cellStore: WorkPaperTrackedAddressedCellStore;
+    readonly getCellPosition: (cellIndex: number) => {
+        readonly row: number;
+        readonly col: number;
+    } | undefined;
+    readonly getSheetById: (sheetId: number) => WorkPaperTrackedSheetRecord | undefined;
+    readonly getSheetNameById: (sheetId: number) => string | undefined;
+}
+export interface WorkPaperTrackedAddressedCellStore extends WorkPaperTrackedRuntimeCellStore {
+    readonly sheetIds: ArrayLike<number | undefined>;
+    readonly rows: ArrayLike<number | undefined>;
+    readonly cols: ArrayLike<number | undefined>;
+}
+export interface DirectSingleLiteralTrackedChangeExpectation {
+    readonly address: WorkPaperCellAddress;
+    readonly cellIndex?: number;
+    readonly isPhysicalSheet: boolean;
+    readonly sheetName: string;
+    readonly value: LiteralInput;
+}
+export type QueuedEvent = Extract<WorkPaperDetailedEvent, {
+    eventName: 'sheetAdded' | 'sheetRemoved' | 'sheetRenamed' | 'namedExpressionAdded' | 'namedExpressionRemoved';
+}>;
+export declare function readTrustedPhysicalTrackedChangeMetadata(changedCellIndices: Uint32Array): {
+    readonly trustedPhysicalSheetId: number;
+    readonly trustedSortedSliceSplit?: number;
+} | undefined;
+export declare function trackedEventHasNoValueChanges(event: TrackedEngineEvent): boolean;
+export declare function countPotentialNewTrackedCellMutations(refs: readonly EngineCellMutationRef[]): number;
+export declare function canSkipDimensionUpdateAfterLiteralMutation(refs: readonly EngineCellMutationRef[], potentialNewCells: number | undefined): boolean;
+export declare function readTrackedRuntimeCellValue(cellStore: WorkPaperTrackedRuntimeCellStore, cellIndex: number, strings: WorkPaperTrackedStringPool): CellValue;
+export declare function existingNumericMutationChangedCellCount(result: EngineExistingNumericCellMutationResult): number;
+export declare function existingNumericMutationChangedCellAt(result: EngineExistingNumericCellMutationResult, index: number): number | undefined;
+export declare function materializeExistingNumericMutationChangedCellIndices(result: EngineExistingNumericCellMutationResult): Uint32Array;
+export declare function trackedEventFromExistingNumericMutationResult(result: EngineExistingNumericCellMutationResult): TrackedEngineEvent;
+export declare function readTrackedCellChange(input: {
+    readonly cellIndex: number;
+    readonly workbook: WorkPaperTrackedWorkbookAccess;
+    readonly strings: WorkPaperTrackedStringPool;
+    readonly trackedA1: (row: number, col: number) => string;
+}): WorkPaperCellChange | undefined;
+export declare function readTinySortedPhysicalTrackedEventChanges(input: {
+    readonly event: TrackedEngineEvent;
+    readonly workbook: WorkPaperTrackedWorkbookAccess;
+    readonly strings: WorkPaperTrackedStringPool;
+    readonly trackedA1: (row: number, col: number) => string;
+}): WorkPaperCellChange[] | null;
+export declare function tryBuildDirectSingleLiteralTrackedChange(input: {
+    readonly events: readonly TrackedEngineEvent[];
+    readonly expected?: DirectSingleLiteralTrackedChangeExpectation;
+    readonly cellStore: WorkPaperTrackedAddressedCellStore;
+    readonly strings: WorkPaperTrackedStringPool;
+    readonly trackedA1: (row: number, col: number) => string;
+}): WorkPaperChange[] | null;
+export declare function tryBuildDirectExistingNumericTrackedChanges(input: {
+    readonly result: EngineExistingNumericCellMutationResult;
+    readonly address: WorkPaperCellAddress;
+    readonly cellIndex: number;
+    readonly isPhysicalSheet: boolean;
+    readonly sheetName: string;
+    readonly value: number;
+    readonly cellStore: WorkPaperTrackedAddressedCellStore;
+    readonly strings: WorkPaperTrackedStringPool;
+    readonly trackedA1: (row: number, col: number) => string;
+    readonly orderChanges: (changes: WorkPaperCellChange[], explicitChangedCount: number | undefined) => WorkPaperChange[];
+}): WorkPaperChange[] | null;
+export declare function withEventChanges(event: QueuedEvent, changes: WorkPaperChange[]): QueuedEvent;