@rowsncolumns/rnc-engine 1.2.17 → 1.2.19

package/dist/esm/use-engine-core.d.ts

@@ -178,6 +178,31 @@ export interface EngineSpreadsheet extends EngineRenderState, EngineSpreadsheetH
      * decided NOT to apply the preview: the user rejected the suggestion, or the request failed. A
      * preview the host does apply needs no call; the applying write retires it. */
     clearStreamPreview: () => void;
+    /** HOLD cells at what the grid drew before the latest commit, so a host can reveal a batch of
+     * changes later (agent replay). Display-only: the document and engine hold the new values
+     * throughout, and only the painted accessors (`getCellData`, `getFormattedValue`,
+     * `getEffectiveValue`, `getEffectiveExtendedValue`, `getEffectiveFormat`, …) show the held copy.
+     * `getUserEnteredValue` / `getUserEnteredExtendedValue` (the editor and formula bar) ignore it.
+     * Precedence: held, then stream preview, then committed.
+     *
+     * The copy is the render state captured when the latest commit BEGAN, so call this right after
+     * `engine.applyRemoteUpdate` (synchronously is safest: a later local command or commit moves that
+     * point). A cell already held keeps its first copy. Skipped and not counted: a cell with an active
+     * stream preview (the chat preview wins), a cell outside the loaded window (windowed mode: it was
+     * never drawn), and every cell on a sheet the latest commit changed structurally. A loaded cell
+     * that was empty is held blank. Returns how many of `cells` are held after the call.
+     *
+     * Released by `releaseCells`, by any local command covering the cell (one without ranges, and
+     * undo / redo / load / import, release everything), and by a commit that moves the sheet's
+     * coordinates: `fullResyncSheets` or a changed merge set. A REMOTE row/column insert or delete is
+     * not detectable here (it arrives as a whole-document reprojection); the host calls
+     * `releaseCells(sheetId)` for it. */
+    holdCells: (sheetId: number, cells: ReadonlyArray<CellInterface>) => number;
+    /** Release held cells: no arguments releases everything, a `sheetId` alone releases that sheet,
+     * and `ranges` narrows it to the cells inside them. */
+    releaseCells: (sheetId?: number, ranges?: GridRange[]) => void;
+    /** Whether a cell is held (see `holdCells`). Reads the live hold set, not the rendered one. */
+    isCellHeld: (sheetId: number, rowIndex: number, columnIndex: number) => boolean;
     undo: () => void;
     redo: () => void;
     /** Run `action` with every command it issues collected and applied afterwards as ONE `batch` —

package/dist/esm/use-engine-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-engine-core.d.ts","sourceRoot":"","sources":["../../src/use-engine-core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-engine-core.d.ts","sourceRoot":"","sources":["../../src/use-engine-core.ts"],"names":[],"mappings":"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"}

package/dist/esm/use-engine-core.js

@@ -39,7 +39,10 @@ const WINDOW_REFRESH_MARGIN_COLS = 2;
  * the viewport, but every accessor answering that read (`getUserEnteredValue`, `getTextFormatRuns`,
  * `getCellFormat`, …) resolves through the windowed `getCellData` — so an evicted active cell blanked
  * the formula bar on scroll. A 1×1 range piggybacking on a read that's already crossing into wasm is
- * free; skipped when the cell is inside the window or a frozen band. */
+ * free; skipped when the cell is inside the window or a frozen band.
+ *
+ * Returns the ranges read beside their snapshots: they are what the render state holds, which
+ * `holdCells` needs to tell a blank cell from one that was never loaded. */
 function readWindowWithFrozenBands(engine, w, frozenRowCount, frozenColumnCount, pinnedCell) {
     const ranges = [w, ...frozenBandRanges(w, frozenRowCount, frozenColumnCount)];
     if (pinnedCell) {
@@ -58,7 +61,10 @@ function readWindowWithFrozenBands(engine, w, frozenRowCount, frozenColumnCount,
             });
         }
     }
-    return ranges.map((r) => engine.readWindow(r.sheetId, r.startRow, r.startCol, r.endRow, r.endCol));
+    return {
+        ranges,
+        snapshots: ranges.map((r) => engine.readWindow(r.sheetId, r.startRow, r.startCol, r.endRow, r.endCol)),
+    };
 }
 /** Display text for a cell whose custom-function eval is in flight — the same transient
  * placeholder the JS engine's `SheetCell` shows (`LOADING_VALUE`). */
@@ -132,6 +138,81 @@ function previewFormulaCellData(engine, sheetId, rowIndex, columnIndex, text) {
         return { ue: { fv: formula }, ev: { sv }, fv: sv };
     return previewCellData(text);
 }
+/** Whether a cell's coordinates fall inside `range` — one rule for holds and their release. */
+function gridRangeContains(range, rowIndex, columnIndex) {
+    return (rowIndex >= range.startRowIndex &&
+        rowIndex <= range.endRowIndex &&
+        columnIndex >= range.startColumnIndex &&
+        columnIndex <= range.endColumnIndex);
+}
+/** `cells` (keyed by {@link cellKey}) without the entries a LOCAL `command` covers: the retirement rule
+ * both display-only shadows share, the stream preview and held cells. A `batch` retires what each
+ * member covers, `change-theme` covers no cell, and a command without a sheet and `range`/`ranges`
+ * to scope it (a structural edit, a write at `coords`, …) retires everything. Returns `cells` itself
+ * when nothing is covered, so a caller can skip republishing. */
+function withoutCoveredCells(cells, command) {
+    if (command.command === "batch") {
+        let next = cells;
+        for (const member of command.commands)
+            next = withoutCoveredCells(next, member);
+        return next;
+    }
+    const cmd = command;
+    if (!cells.size || cmd.command === "change-theme")
+        return cells;
+    const ranges = cmd.ranges ?? (cmd.range ? [cmd.range] : null);
+    if (!ranges?.length || cmd.sheetId == null)
+        return new Map();
+    let next = null;
+    for (const key of cells.keys()) {
+        const parsed = parseCellKey(key);
+        if (!parsed || parsed.sheetId !== cmd.sheetId)
+            continue;
+        if (ranges.some((r) => gridRangeContains(r, parsed.rowIndex, parsed.columnIndex))) {
+            next ??= new Map(cells);
+            next.delete(key);
+        }
+    }
+    return next ?? cells;
+}
+/** The effective format the grid drew for `key` in `state`: the cell's own style over its derived
+ * format, as `getEffectiveFormat` layers them. */
+function drawnFormat(state, key) {
+    const own = state.cellStyles.get(key);
+    const derived = state.derivedFormats.get(key);
+    if (!derived)
+        return own;
+    if (!own)
+        return derived;
+    return { ...derived, ...own };
+}
+const mergeKey = (m) => `${m.startRowIndex}:${m.endRowIndex}:${m.startColumnIndex}:${m.endColumnIndex}`;
+/** The sheets whose coordinates `commit` may have moved, so their held cells are no longer where they
+ * were drawn: every sheet in `fullResyncSheets` (a local row/column insert or delete, or the undo of
+ * one) and every sheet whose merge set changed against what was drawn (`drawn`). The merge check
+ * compares rather than trusting the channel, because a remote sync re-sends a sheet's WHOLE merge list
+ * on every commit; for the same reason a remote UNMERGE is not seen (the list just omits it).
+ *
+ * A remote row/column shift is not seen either: the engine answers it with a whole-document
+ * reprojection that carries neither signal, so the host releases that sheet itself. */
+function structurallyChangedSheets(commit, drawn) {
+    const changed = new Set(commit.fullResyncSheets ?? []);
+    const drawnMerges = new Map();
+    for (const m of commit.merges ?? []) {
+        if (changed.has(m.sheetId))
+            continue;
+        let keys = drawnMerges.get(m.sheetId);
+        if (!keys) {
+            const sheet = drawn.find((s) => s.sheetId === m.sheetId);
+            keys = new Set((sheet?.merges ?? []).map(mergeKey));
+            drawnMerges.set(m.sheetId, keys);
+        }
+        const present = keys.has(mergeKey(m));
+        if (m.removed ? present : !present)
+            changed.add(m.sheetId);
+    }
+    return changed;
+}
 /** Seed for the parsed facets before the first commit (stable reference). */
 const EMPTY_FACETS = {
     conditionalFormats: [],
@@ -308,6 +389,56 @@ export function useEngineCore(options) {
     // tiny top-left placeholder would leave everything past the first few columns unfetched until a
     // manual scroll. Null until the first viewport report.
     const lastViewportRef = useRef(null);
+    // Held cells (see `holdCells`). `loadedRangesRef` is the windowed reads the render state was built
+    // from (`null` when not windowed: every cell is resident), recorded at each read. `drawnRef` is
+    // what the last render drew, reassigned every render (a reference to the immutable state, no
+    // copy). The engine subscriber moves it into `commitBaseRef` when a commit BEGINS, so a hold
+    // copies the pre-commit cells even after the commit has rendered.
+    const loadedRangesRef = useRef(options.windowed ? [] : null);
+    const drawnRef = useRef({
+        state,
+        ranges: loadedRangesRef.current,
+    });
+    if (drawnRef.current.state !== state ||
+        drawnRef.current.ranges !== loadedRangesRef.current)
+        drawnRef.current = { state, ranges: loadedRangesRef.current };
+    const commitBaseRef = useRef(null);
+    // The held cells themselves: `null` whenever nothing is held, so the painted accessors are the
+    // plain ones (see `getCellData`). Immutable: each hold or release publishes a new map, and that
+    // identity change is what re-creates the accessors and clears the grid's cell cache.
+    const [heldCells, setHeldCells] = useState(null);
+    const heldCellsRef = useRef(null);
+    const publishHeldCells = useCallback((next) => {
+        const value = next?.size ? next : null;
+        if (value === heldCellsRef.current)
+            return;
+        heldCellsRef.current = value;
+        setHeldCells(value);
+    }, []);
+    const structuralSheetsOf = useCallback((base) => {
+        if (!base.commit)
+            return new Set();
+        base.structural ??= structurallyChangedSheets(base.commit, base.state.sheets);
+        return base.structural;
+    }, []);
+    // Release the holds on every sheet whose coordinates the commit that began from `base` moved.
+    const releaseHeldOnStructuralCommit = useCallback((base) => {
+        const held = heldCellsRef.current;
+        if (!held)
+            return;
+        const sheets = structuralSheetsOf(base);
+        if (!sheets.size)
+            return;
+        let next = null;
+        for (const [key, cell] of held) {
+            if (!sheets.has(cell.sheetId))
+                continue;
+            next ??= new Map(held);
+            next.delete(key);
+        }
+        if (next)
+            publishHeldCells(next);
+    }, [publishHeldCells, structuralSheetsOf]);
     // Live refs for the windowed frozen-band reads (read inside stable callbacks + the mount effect).
     // The host getter is authoritative (a collab host answers from its doc plane); the hook's own folded
     // per-sheet counts are the fallback. Latest-ref pattern: reassigned every render.
@@ -337,7 +468,9 @@ export function useEngineCore(options) {
     const readWindowedSnapshots = useCallback((engine, w) => {
         const host = getWindowFrozenCountsRef.current?.(w.sheetId);
         const sheet = stateSheetsRef.current.find((s) => s.sheetId === w.sheetId);
-        return readWindowWithFrozenBands(engine, w, host?.frozenRowCount ?? sheet?.frozenRowCount ?? 0, host?.frozenColumnCount ?? sheet?.frozenColumnCount ?? 0, activeCellBySheetIdRef.current[w.sheetId] ?? DEFAULT_ACTIVE_CELL);
+        const { ranges, snapshots } = readWindowWithFrozenBands(engine, w, host?.frozenRowCount ?? sheet?.frozenRowCount ?? 0, host?.frozenColumnCount ?? sheet?.frozenColumnCount ?? 0, activeCellBySheetIdRef.current[w.sheetId] ?? DEFAULT_ACTIVE_CELL);
+        loadedRangesRef.current = ranges;
+        return snapshots;
     }, []);
     // Engine data extents `[sheetId, rowCount, colCount][]` → the grid's scroll extent in windowed mode
     // (so it scrolls the full sheet while JS holds only the window). Empty until the engine reports them.
@@ -513,6 +646,16 @@ export function useEngineCore(options) {
                 setState((prev) => foldWindows(prev, snaps));
             };
             unsubscribe = engine.onChanges((commit) => {
+                // Before anything folds: what the grid drew when this commit began is what a `holdCells`
+                // right after it copies. Then release holds whose sheet this commit moved.
+                const drawn = drawnRef.current;
+                const base = {
+                    state: drawn.state,
+                    ranges: drawn.ranges,
+                    commit,
+                };
+                commitBaseRef.current = base;
+                releaseHeldOnStructuralCommit(base);
                 // Reconcile the tab list with the engine's authoritative sheet set/order/titles after every
                 // commit — so create / rename / delete / reorder / hide / color update the tabs (and a new
                 // sheet renders). The engine owns lifecycle (it generates `create-sheet` ids), so this can't
@@ -675,6 +818,7 @@ export function useEngineCore(options) {
                     };
                     const w = windowRef.current;
                     const snap = engine.readWindow(w.sheetId, w.startRow, w.startCol, w.endRow, w.endCol);
+                    loadedRangesRef.current = [w];
                     setState((prev) => foldWindow(prev, snap));
                 }
                 refreshExtents();
@@ -714,39 +858,11 @@ export function useEngineCore(options) {
         const preview = streamPreviewRef.current;
         if (!preview?.size)
             return;
-        // A batch retires what each of its members covers.
-        if (command.command === "batch") {
-            for (const member of command.commands)
-                retireStreamPreviewForCommand(member);
-            return;
-        }
-        const cmd = command;
-        if (cmd.command === "change-theme")
-            return;
-        const ranges = cmd.ranges ?? (cmd.range ? [cmd.range] : null);
-        if (!ranges?.length || cmd.sheetId == null) {
-            streamPreviewRef.current = null;
-            setStreamPreview(null);
+        const next = withoutCoveredCells(preview, command);
+        if (next === preview)
             return;
-        }
-        let removed = false;
-        for (const key of Array.from(preview.keys())) {
-            const parsed = parseCellKey(key);
-            if (!parsed || parsed.sheetId !== cmd.sheetId)
-                continue;
-            const covered = ranges.some((r) => parsed.rowIndex >= r.startRowIndex &&
-                parsed.rowIndex <= r.endRowIndex &&
-                parsed.columnIndex >= r.startColumnIndex &&
-                parsed.columnIndex <= r.endColumnIndex);
-            if (covered) {
-                preview.delete(key);
-                removed = true;
-            }
-        }
-        if (!removed)
-            return;
-        streamPreviewRef.current = preview.size ? preview : null;
-        setStreamPreview(preview.size ? new Map(preview) : null);
+        streamPreviewRef.current = next.size ? next : null;
+        setStreamPreview(next.size ? new Map(next) : null);
     }, []);
     // The committed `fv` a preview is standing on. Read through a ref so the streaming callback
     // (created once) always sees fresh values.
@@ -754,6 +870,89 @@ export function useEngineCore(options) {
     sheetDataRef.current = state.sheetData;
     const committedFvAt = useCallback((sheetId, rowIndex, columnIndex) => sheetDataRef.current?.[sheetId]?.[rowIndex]?.values?.[columnIndex]?.fv ??
         undefined, []);
+    // Held cells (see `holdCells` on `EngineSpreadsheet`): a display-only copy of what the grid drew,
+    // taken from the render state captured when the latest commit began (`commitBaseRef`).
+    const holdCells = useCallback((sheetId, cells) => {
+        if (!cells.length)
+            return 0;
+        const base = commitBaseRef.current ?? drawnRef.current;
+        if (structuralSheetsOf(base).has(sheetId))
+            return 0;
+        const { state: drawn, ranges } = base;
+        const preview = streamPreviewRef.current;
+        const prev = heldCellsRef.current;
+        let next = null;
+        const counted = new Set();
+        for (const { rowIndex, columnIndex } of cells) {
+            const key = cellKey(sheetId, rowIndex, columnIndex);
+            if (counted.has(key))
+                continue;
+            // Already held: it is drawn from its held copy, so keep that one.
+            if (prev?.has(key)) {
+                counted.add(key);
+                continue;
+            }
+            // Windowed: a cell outside the reads the render state came from was never drawn.
+            if (ranges &&
+                !ranges.some((r) => r.sheetId === sheetId &&
+                    rowIndex >= r.startRow &&
+                    rowIndex <= r.endRow &&
+                    columnIndex >= r.startCol &&
+                    columnIndex <= r.endCol))
+                continue;
+            const data = drawn.sheetData?.[sheetId]?.[rowIndex]?.values?.[columnIndex] ??
+                undefined;
+            // An active stream preview (the same "until the real value lands" rule `getCellData` uses)
+            // wins: the chat preview hands straight over to the committed value.
+            const previewEntry = preview?.get(key);
+            if (previewEntry && data?.fv === previewEntry.basis)
+                continue;
+            next ??= new Map(prev ?? undefined);
+            next.set(key, {
+                sheetId,
+                rowIndex,
+                columnIndex,
+                data,
+                format: drawnFormat(drawn, key),
+            });
+            counted.add(key);
+        }
+        if (next)
+            publishHeldCells(next);
+        return counted.size;
+    }, [publishHeldCells, structuralSheetsOf]);
+    const releaseCells = useCallback((sheetId, ranges) => {
+        const held = heldCellsRef.current;
+        if (!held)
+            return;
+        if (sheetId == null) {
+            publishHeldCells(null);
+            return;
+        }
+        let next = null;
+        for (const [key, cell] of held) {
+            if (cell.sheetId !== sheetId)
+                continue;
+            if (ranges &&
+                !ranges.some((r) => gridRangeContains(r, cell.rowIndex, cell.columnIndex)))
+                continue;
+            next ??= new Map(held);
+            next.delete(key);
+        }
+        if (next)
+            publishHeldCells(next);
+    }, [publishHeldCells]);
+    const isCellHeld = useCallback((sheetId, rowIndex, columnIndex) => heldCellsRef.current?.has(cellKey(sheetId, rowIndex, columnIndex)) ??
+        false, []);
+    // A local command shows the user what they did: it releases the held cells it covers.
+    const releaseHeldForCommand = useCallback((command) => {
+        const held = heldCellsRef.current;
+        if (!held)
+            return;
+        const next = withoutCoveredCells(held, command);
+        if (next !== held)
+            publishHeldCells(next);
+    }, [publishHeldCells]);
     // Commands issued while a `batchHistory` action runs, applied together when it returns.
     const batchCommandsRef = useRef(null);
     const onCommand = useCallback((command) => {
@@ -766,8 +965,9 @@ export function useEngineCore(options) {
         }
         // The host's apply (or any other local write) is the authority — retire the preview for the cells
         // it covers in this same render, so the committed value replaces the previewed one with no blank
-        // frame in between.
+        // frame in between. Held cells it covers are released for the same reason.
         retireStreamPreviewForCommand(command);
+        releaseHeldForCommand(command);
         // Remember the last SINGLE formatting action so `onRepeatFormatting` can replay it onto a new
         // target (a 2-D paint-format array is not a repeatable single action, so it's excluded).
         if ((command.command === "change-formatting" &&
@@ -834,6 +1034,7 @@ export function useEngineCore(options) {
         return commit;
     }, [
         retireStreamPreviewForCommand,
+        releaseHeldForCommand,
         showError,
         focusEmbedOrChart,
         setTableAutoExpansion,
@@ -947,6 +1148,8 @@ export function useEngineCore(options) {
         const engine = engineRef.current;
         if (!engine)
             return;
+        // An undo rewrites cells no command range names: show them all.
+        releaseCells();
         const prevDepth = engine.undoDepth();
         const commit = engine.undo();
         if (engine.undoDepth() < prevDepth) {
@@ -958,11 +1161,12 @@ export function useEngineCore(options) {
         }
         lastUndoDepth.current = engine.undoDepth();
         restoreChartSelection(commit);
-    }, [applyView, restoreChartSelection]);
+    }, [applyView, restoreChartSelection, releaseCells]);
     const redo = useCallback(() => {
         const engine = engineRef.current;
         if (!engine)
             return;
+        releaseCells();
         const prevRedoDepth = engine.redoDepth();
         const commit = engine.redo();
         if (engine.redoDepth() < prevRedoDepth) {
@@ -974,10 +1178,11 @@ export function useEngineCore(options) {
         }
         lastUndoDepth.current = engine.undoDepth();
         restoreChartSelection(commit);
-    }, [applyView, restoreChartSelection]);
+    }, [applyView, restoreChartSelection, releaseCells]);
     const load = useCallback((document) => {
+        releaseCells();
         engineRef.current?.load(document);
-    }, []);
+    }, [releaseCells]);
     /**
      * Import an `.xlsx` workbook through the native Rust engine, REPLACING the current document (sheets,
      * cell data, facets, history) — not merging into it. Render state is cleared first so nothing from
@@ -996,6 +1201,12 @@ export function useEngineCore(options) {
         const commit = engine.importXlsx(bytes);
         if (!commit)
             return false;
+        // A replaced document holds nothing from the old one.
+        if (heldCellsRef.current) {
+            heldCellsRef.current = null;
+            setHeldCells(null);
+        }
+        commitBaseRef.current = null;
         const engineSheets = engine.sheets?.() ?? [];
         const seedSheets = engineSheets.map((es) => ({
             sheetId: es.sheetId,
@@ -1034,6 +1245,7 @@ export function useEngineCore(options) {
                     next = foldCommitStructuralOnly(next, commit);
                 if (windowRef.current) {
                     const w = windowRef.current;
+                    loadedRangesRef.current = [w];
                     next = foldWindow(next, engine.readWindow(w.sheetId, w.startRow, w.startCol, w.endRow, w.endCol));
                 }
             }
@@ -1142,7 +1354,9 @@ export function useEngineCore(options) {
         setSelectionsBySheetId(next);
     }, []);
     const { sheetData, cellStyles, derivedFormats, notes } = state;
-    const getCellData = useCallback((sheetId, rowIndex, columnIndex) => {
+    // The cell beneath any hold: the stream preview, else the committed cell. What the editor and the
+    // formula bar read (`getUserEnteredValue` / `getUserEnteredExtendedValue`).
+    const getUnheldCellData = useCallback((sheetId, rowIndex, columnIndex) => {
         const committed = sheetData?.[sheetId]?.[rowIndex]?.values?.[columnIndex] ?? undefined;
         // A previewing stream shadows the committed cell — until the real value lands, which is any
         // change to what was committed when the preview was painted (`basis`). That covers a local
@@ -1152,12 +1366,23 @@ export function useEngineCore(options) {
             return preview.data;
         return committed;
     }, [sheetData, streamPreview]);
+    // The painted cell: a held cell first (see `holdCells`). With nothing held this IS
+    // `getUnheldCellData`, so the common case pays nothing; a hold or release swaps the identity, which
+    // is what clears the grid's cell cache.
+    const getCellData = useMemo(() => heldCells
+        ? (sheetId, rowIndex, columnIndex) => {
+            const held = heldCells.get(cellKey(sheetId, rowIndex, columnIndex));
+            return held
+                ? held.data
+                : getUnheldCellData(sheetId, rowIndex, columnIndex);
+        }
+        : getUnheldCellData, [heldCells, getUnheldCellData]);
     // Stable-identity cache for the user⊕derived merge: a 2-level `WeakMap<userFmt, WeakMap<derivedFmt,
     // merged>>`, so the SAME merged object is returned across renders unless an input actually changes.
     // Mirrors `use-sheet-properties`'s `getEffectiveFormat`, keeping the grid from re-rendering on
     // identity churn. GC-friendly: keyed on the format objects themselves (no manual eviction).
     const mergedFormatCache = useRef(new WeakMap());
-    const getEffectiveFormat = useCallback((sheetId, rowIndex, columnIndex) => {
+    const getUnheldEffectiveFormat = useCallback((sheetId, rowIndex, columnIndex) => {
         const key = cellKey(sheetId, rowIndex, columnIndex);
         // The cell's OWN consolidated style. Conditional formatting is NOT layered here — CanvasGrid
         // computes it from the rules (`useConditionalFormatting`); CF overlays don't ride on the format.
@@ -1189,6 +1414,15 @@ export function useEngineCore(options) {
         }
         return merged;
     }, [cellStyles, derivedFormats, streamPreview, sheetData]);
+    // A held cell's drawn format first, under the same zero-cost rule as `getCellData`.
+    const getEffectiveFormat = useMemo(() => heldCells
+        ? (sheetId, rowIndex, columnIndex) => {
+            const held = heldCells.get(cellKey(sheetId, rowIndex, columnIndex));
+            return held
+                ? held.format
+                : getUnheldEffectiveFormat(sheetId, rowIndex, columnIndex);
+        }
+        : getUnheldEffectiveFormat, [heldCells, getUnheldEffectiveFormat]);
     const getNote = useCallback((sheetId, rowIndex, columnIndex) => notes.get(cellKey(sheetId, rowIndex, columnIndex)), [notes]);
     const getFormattedValue = useCallback((sheetId, rowIndex, columnIndex) => {
         const cell = getCellData(sheetId, rowIndex, columnIndex);
@@ -1264,7 +1498,8 @@ export function useEngineCore(options) {
         return ev;
     }, [getCellData]);
     const getUserEnteredValue = useCallback((sheetId, rowIndex, columnIndex) => {
-        const ue = getCellData(sheetId, rowIndex, columnIndex)?.ue;
+        // Ignores holds: the editor and formula bar open on the real value.
+        const ue = getUnheldCellData(sheetId, rowIndex, columnIndex)?.ue;
         if (!ue)
             return undefined;
         if (ue.fv != null)
@@ -1274,13 +1509,13 @@ export function useEngineCore(options) {
         if (ue.bv != null)
             return ue.bv ? "TRUE" : "FALSE";
         return ue.sv ?? undefined;
-    }, [getCellData]);
+    }, [getUnheldCellData]);
     const getHyperlink = useCallback((sheetId, rowIndex, columnIndex) => getCellData(sheetId, rowIndex, columnIndex)?.hyperlink, [getCellData]);
     // ── Additional cell accessors (mirror useSheetProperties / useSpreadsheetState, typed via SS) ──
     // Rich-text runs ride on the cell (`textFormatRuns`, emitted by the engine from the imported
     // rich shared string). Surface them so the grid renders mixed in-cell formatting.
     const getTextFormatRuns = useCallback((sheetId, rowIndex, columnIndex) => getCellData(sheetId, rowIndex, columnIndex)?.textFormatRuns, [getCellData]);
-    const getUserEnteredExtendedValue = useCallback((sheetId, rowIndex, columnIndex) => getCellData(sheetId, rowIndex, columnIndex)?.ue, [getCellData]);
+    const getUserEnteredExtendedValue = useCallback((sheetId, rowIndex, columnIndex) => getUnheldCellData(sheetId, rowIndex, columnIndex)?.ue, [getUnheldCellData]);
     const getUserEnteredFormat = useCallback((sheetId, rowIndex, columnIndex) => cellStyles.get(cellKey(sheetId, rowIndex, columnIndex)), [cellStyles]);
     const getErrorValue = useCallback((sheetId, rowIndex, columnIndex) => {
         const cell = getCellData(sheetId, rowIndex, columnIndex);
@@ -2671,6 +2906,9 @@ export function useEngineCore(options) {
         onRequestAddRows,
         onChangeBatchStream,
         clearStreamPreview,
+        holdCells,
+        releaseCells,
+        isCellHeld,
         onDeleteDataValidationRules,
         onCopy,
         onPaste,
@@ -2779,6 +3017,9 @@ export function useEngineCore(options) {
         onUpdateSheet,
         onChangeBatchStream,
         clearStreamPreview,
+        holdCells,
+        releaseCells,
+        isCellHeld,
         onRequestAddRows,
         onDeleteDataValidationRules,
         onClearHistory,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/rnc-engine",
-  "version": "1.2.17",
+  "version": "1.2.19",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "description": "Typed JS/TS interop for the Rust→WASM spreadsheet calc engine (rnc-wasm). Ergonomic JSON-in/out wrapper over the wasm-bindgen surface: applyCommand(Command)→CommitResult, readWindow→WindowSnapshot, and Map<\"sheet!A1\",CellFormat> style folding. Pluggable backend — single-user `SpreadsheetEngine` (default) or collaborative `CollabSpreadsheetEngine` (Yjs sync) — plus the Option-B `useSpreadsheetEngine` React hook.",
@@ -51,10 +51,10 @@
   "devDependencies": {
     "@rowsncolumns/common-types": ">=5.3.3",
     "@rowsncolumns/dag": ">=7.2.31",
-    "@rowsncolumns/grid": ">=13.2.35",
-    "@rowsncolumns/spreadsheet": ">=10.5.2",
-    "@rowsncolumns/spreadsheet-state": ">=29.1.10",
-    "@rowsncolumns/toolkit": ">=24.5.14",
+    "@rowsncolumns/grid": ">=13.2.36",
+    "@rowsncolumns/spreadsheet": ">=10.5.3",
+    "@rowsncolumns/spreadsheet-state": ">=29.1.11",
+    "@rowsncolumns/toolkit": ">=24.5.15",
     "@rowsncolumns/utils": ">=9.5.4",
     "fflate": "^0.8.2"
   }