@rowsncolumns/rnc-engine 1.5.2 → 1.6.1

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

@@ -3,7 +3,7 @@
 import { CellNode, CellRangeNode, isCellCoordinate, isCellNode, makeKey, } from "@rowsncolumns/dag";
 import { DEFAULT_ACTIVE_CELL, DEFAULT_ARRAY, defaultSpreadsheetTheme, getBandedCells, getInitialActiveSheetId, ICON_SET_COLORS, ICON_SET_GLYPHS, useFocusEmbedOrChart, useFonts, useGetSheetDimensions, useSetTableAutoExpansion, useSetCalculatedColumnFill, } from "@rowsncolumns/spreadsheet";
 import { applyAdvancedFilterPlan, applySubtotalPlan, CellXfsRegistry, collectPaintMerges, generateDataFromClipboard, getBandedCellFormat, layerBandedFormat, paintSourceForActiveCell, pickFormula, pickValue, planAdvancedFilter, planSubtotals, resolvePasteSpecialOptions, SharedStringRegistry, spreadMergeAnchorFormats, tilePaintMerges, transpose, useOnCopy, previewTableStyle, useOnTraceDependentsPrecedents, useShowError, CIRCULAR_REFERENCE_WARNING_TITLE, CircularReferenceTracker, formatCircularReferenceWarning, getDefaultCellFormat, } from "@rowsncolumns/spreadsheet-state";
-import { getFormulaLocale, normalizeExternalUrl, resolveDefaultHorizontalAlignment, } from "@rowsncolumns/utils";
+import { getFormulaLocale, normalizeExternalUrl, resolveDefaultHorizontalAlignment, uuidString, } from "@rowsncolumns/utils";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { createCommandHandlers, rejectionDialog, } from "./command-handlers";
 import { emptyRenderState, foldCommit, foldCommitStructuralOnly, foldWindow, foldWindows, frozenBandRanges, reconcileSheets, } from "./fold";
@@ -11,10 +11,14 @@ import { RncEngine, } from "./index";
 import { cellKey, parseCellKey } from "./keys";
 import { fallbackSheetAfterDelete } from "./sheet-fallback";
 import { rescopeRulesAfterMove } from "./move-rescope";
-import { applyPasteSpecialToTiles, clipboardCellToPasteCell, isSkippedPasteCell, } from "./paste-special";
+import { applyPasteSpecialToTiles, clipboardCellToPasteCell, clipboardFormats, columnWidthCopies, isSkippedPasteCell, noteCopies, pasteLinkCells, reattachClipboardFormats, validationCopies, withoutBorders, } from "./paste-special";
 import { pastedMerges } from "./paste-merges";
+import { replayPasteEvent, snapshotClipboard } from "./paste-reapply";
 import { tileClipboardToSelection } from "./paste-tiling";
 import { windowRectReader } from "./rect-reader";
+/** The width a column at no stored width takes (the grid's default, as `onCopy` reads it). */
+const DEFAULT_PASTE_COLUMN_WIDTH = 100;
+const EMPTY_ALLOW_EDIT_RANGES = [];
 /** Minimum extra rows/columns to read on EACH side of the visible range so a small scroll reveals
  * already-loaded cells (no flash) before the next `readWindow`. The buffer actually used scales with
  * the viewport (see {@link windowBuffer}) and is never smaller than this. The window size stays
@@ -1683,6 +1687,8 @@ export function useEngineCore(options) {
             endColumnIndex: right,
         };
     }, []);
+    // Stable identity: reads through `engineRef`, so the grid's formula-bar effect never re-runs for it.
+    const getArrayFormula = useCallback((sheetId, rowIndex, columnIndex) => engineRef.current?.arrayFormulaAt(sheetId, rowIndex, columnIndex), []);
     const getDataColumnCount = useCallback((sheetId) => {
         const rows = sheetData[String(sheetId)];
         let max = 0;
@@ -2333,6 +2339,7 @@ export function useEngineCore(options) {
                 showFirstColumn: t.showFirstColumn,
                 showLastColumn: t.showLastColumn,
                 totalRow: t.totalRow ?? false,
+                headerRow: t.headerRow !== false,
                 range: { ...t.range, sheetId },
                 ...t.bandedRange,
             })),
@@ -2571,6 +2578,7 @@ export function useEngineCore(options) {
     paintFacetsRef.current = { bandedRanges: facets.bandedRanges, tables };
     const namedRanges = facets.namedRanges;
     const protectedRanges = facets.protectedRanges;
+    const allowEditRanges = facets.allowEditRanges ?? EMPTY_ALLOW_EDIT_RANGES;
     const embeds = facets.embeds;
     const slicers = facets.slicers;
     // Citations (workbook-level collection; a cell links to one via `citationId`). The grid renders the
@@ -2680,7 +2688,79 @@ export function useEngineCore(options) {
     // cellXfs style-refs to an inline `CellFormat` on each parsed cell, which we forward per cell below;
     // the engine applies it via `set_style` (streams on `styleChanges`). Only a still-unresolved
     // `StyleReference` (no matching cellXfs entry) is skipped, since a bare ref can't cross to the engine.
-    const onPaste = useCallback(async (e, sourceSheetId, destinationSheetId, copiedSelections, pasteActiveCell, pasteSelections, _finalSelections, isCutOperation) => {
+    const pasteInto = useCallback(async (e, sourceSheetId, destinationSheetId, copiedSelections, pasteActiveCell, pasteSelections, _finalSelections, isCutOperation) => {
+        // Paste Special. The grid stashes the request under synthetic clipboard keys (same as
+        // `useSpreadsheetState`; `resolvePasteSpecialOptions` reads both the legacy single mode and the
+        // full options).
+        const pasteSpecial = resolvePasteSpecialOptions(e?.clipboardData);
+        // The copied range, kept for Paste Link, the notes / validation / column widths and the cut
+        // source-clear below. A foreign clipboard (another app) has none.
+        const from = copiedSelections?.[0]?.range;
+        const pasteSource = from && sourceSheetId != null
+            ? { sheetId: sourceSheetId, sheetName: getSheetName(sourceSheetId), range: from }
+            : undefined;
+        // Destination top-left = the paste selection's start (else the active cell).
+        const to = pasteSelections?.[pasteSelections.length - 1]?.range;
+        const target = to
+            ? { rowIndex: to.startRowIndex, columnIndex: to.startColumnIndex }
+            : pasteActiveCell;
+        // Excel's Column widths / Keep Source Column Widths: each destination column takes the width
+        // of the copied column it stands for (a source column at the sheet default takes that default).
+        const copySourceColumnWidths = (source) => {
+            const defaultWidth = state.sheets.find((s) => s.sheetId === source.sheetId)?.defaultColumnWidth ??
+                DEFAULT_PASTE_COLUMN_WIDTH;
+            for (const copy of columnWidthCopies(source.range, target.columnIndex)) {
+                onCommand({
+                    command: "resize",
+                    sheetId: destinationSheetId,
+                    indexes: [copy.columnIndex],
+                    dimension: getColumnWidth(source.sheetId, copy.sourceColumnIndex) ?? defaultWidth,
+                    axis: "y",
+                });
+            }
+        };
+        // Paste Special → Comments and Notes / Validation / Column widths paste no cells: only the
+        // copied range's notes, data-validation rules or column widths travel, in one undo step.
+        // They need a copied range (Excel offers them only after a copy, never after a cut).
+        if (pasteSpecial.notesOnly ||
+            pasteSpecial.validationOnly ||
+            pasteSpecial.columnWidths === "only") {
+            if (!pasteSource || isCutOperation)
+                return;
+            batchHistory(() => {
+                if (pasteSpecial.notesOnly) {
+                    const notes = noteCopies(pasteSource.range, target, (r, c) => getNote(pasteSource.sheetId, r, c), pasteSpecial.transpose);
+                    for (const { cell, note } of notes) {
+                        onCommand({
+                            command: "update-note",
+                            sheetId: destinationSheetId,
+                            activeCell: cell,
+                            note,
+                        });
+                    }
+                }
+                else if (pasteSpecial.validationOnly) {
+                    const rules = validationCopies(facets.dataValidations, pasteSource, destinationSheetId, target);
+                    for (const rule of rules) {
+                        onCommand({
+                            command: "create-data-validation",
+                            sheetId: destinationSheetId,
+                            range: rule.ranges[0],
+                            rule: { ...rule, id: uuidString() },
+                        });
+                    }
+                }
+                else {
+                    copySourceColumnWidths(pasteSource);
+                }
+            });
+            return;
+        }
+        // Paste Link refers back to the copied cells, so it needs a copied range — Excel greys it out
+        // after a cut.
+        const pasteLink = Boolean(pasteSpecial.link);
+        if (pasteLink && (!pasteSource || isCutOperation))
+            return;
         // A cut is a MOVE: Excel keeps the moved formulas' text verbatim (`=B1*2` cut from A1 to A5
         // still reads `=B1*2`) and only repoints references INTO the moved block — the engine does
         // that remap (`repoint_formulas_into_moved_block`), so the clipboard parse must not
@@ -2692,7 +2772,7 @@ export function useEngineCore(options) {
         // Pasted image FILES arrive as floating pictures anchored at the active cell (Excel /
         // Google Sheets Ctrl+V of a picture) — the same lossless `create-embed` the Insert → Image
         // dialog emits, one undo entry for all of them, the first one selected like a new chart.
-        const pastedEmbeds = parsed?.embeds ?? [];
+        const pastedEmbeds = pasteLink ? [] : parsed?.embeds ?? [];
         if (pastedEmbeds.length) {
             batchHistory(() => {
                 for (const spec of pastedEmbeds) {
@@ -2701,35 +2781,42 @@ export function useEngineCore(options) {
             });
             focusEmbedOrChart(pastedEmbeds[0].embedId);
         }
-        let results = parsed?.results ?? [];
+        // Paste Link: one reference formula per copied cell instead of the copied cells.
+        let results = pasteLink && pasteSource
+            ? pasteLinkCells(pasteSource, destinationSheetId)
+            : parsed?.results ?? [];
         if (!results.length)
             return;
         // The clipboard's own size and merges, before Paste Special / tiling reshape `results`.
         const clipRows = results.length;
         const clipCols = Math.max(0, ...results.map((row) => row.length));
         const clipboardMerges = parsed?.merges ?? [];
-        // Paste Special. The grid stashes the request under synthetic clipboard keys (same as
-        // `useSpreadsheetState`; `resolvePasteSpecialOptions` reads both the legacy single mode and the
-        // full options). Transpose/Values/Formulas transform the parsed cells UI-side (the engine can't
-        // "resolve a formula to its value"); Formats rides a `format_only` flag the engine honors (apply
-        // each cell's format, leave destination values intact); Operation / Skip blanks need the
+        // Transpose/Values/Formulas transform the parsed cells UI-side (the engine can't "resolve a
+        // formula to its value"); Formats rides a `format_only` flag the engine honors (apply each
+        // cell's format, leave destination values intact); Operation / Skip blanks need the
         // destination cells and are folded in after tiling (see `applyPasteSpecialToTiles`).
-        const pasteSpecial = resolvePasteSpecialOptions(e?.clipboardData);
         if (pasteSpecial.transpose) {
             results = transpose(results);
         }
+        // Values & Number Formatting, Formulas & Number Formatting, Values & Source Formatting: the
+        // source formats are read before the pick, which strips them.
+        const keptFormats = pasteSpecial.numberFormats || pasteSpecial.sourceFormats
+            ? clipboardFormats(results)
+            : undefined;
         if (pasteSpecial.paste === "values") {
             results = pickValue(results, destinationSheetId, initial.current.locale);
         }
         else if (pasteSpecial.paste === "formulas") {
             results = pickFormula(results, destinationSheetId, initial.current.locale);
         }
+        if (keptFormats) {
+            results = reattachClipboardFormats(results, keptFormats, pasteSpecial.sourceFormats ? "sourceFormats" : "numberFormats");
+        }
+        // All except borders (Paste Options ▸ No Borders): the destination keeps its own borders.
+        if (pasteSpecial.noBorders) {
+            results = withoutBorders(results);
+        }
         const formatOnly = pasteSpecial.paste === "formats";
-        // Destination top-left = the paste selection's start (else the active cell).
-        const to = pasteSelections?.[pasteSelections.length - 1]?.range;
-        const target = to
-            ? { rowIndex: to.startRowIndex, columnIndex: to.startColumnIndex }
-            : pasteActiveCell;
         // A paste selection larger than the clipboard tiles it (copy G1, select G2:G5, paste fills all
         // four), wrapping like `useOnPaste`. Tiling UI-side keeps the engine's `paste` a plain rectangle
         // and the whole paste ONE undo entry; the tiles' formulas are shifted here (see `paste-tiling`).
@@ -2739,8 +2826,6 @@ export function useEngineCore(options) {
             results = tileClipboardToSelection(results, to, pasteActiveCell, destinationSheetId, getSheetName(destinationSheetId), initial.current.locale);
         }
         const tiles = applyPasteSpecialToTiles(results, target, destinationSheetId, pasteSpecial, { getCellData, getUserEnteredFormat }, initial.current.locale);
-        // The copied range top-left, kept for the cut source-clear below.
-        const from = copiedSelections?.[0]?.range;
         const cutMove = isCutOperation && from && sourceSheetId != null;
         // COPY: `generateDataFromClipboard` has ALREADY re-anchored each relative formula ref to its
         // destination (its `moveFormula(sourceCell → destinationCell)` pass overwrites the cell's `fv`), so
@@ -2759,8 +2844,9 @@ export function useEngineCore(options) {
         // The clipboard rectangle is row-major from the copied range's top-left, so the note of the
         // tile's source cell is looked up by offset; tiled repeats (copy only) reuse the modular offset.
         const noteAt = (i, j) => {
-            // A transposed paste no longer maps tiles back to source cells by offset.
-            if (!from || sourceSheetId == null || pasteSpecial.transpose)
+            // A transposed paste no longer maps tiles back to source cells by offset; a link carries
+            // only the reference.
+            if (!from || sourceSheetId == null || pasteSpecial.transpose || pasteLink)
                 return undefined;
             const height = from.endRowIndex - from.startRowIndex + 1;
             const width = from.endColumnIndex - from.startColumnIndex + 1;
@@ -2790,10 +2876,11 @@ export function useEngineCore(options) {
         // and a cut moves its own merges in the engine (rowsncolumns/spreadsheet#1234).
         const merges = !isCutOperation &&
             !pasteSpecial.transpose &&
+            !pasteLink &&
             (pasteSpecial.paste === "all" || formatOnly)
             ? pastedMerges(clipboardMerges, pasteActiveCell, target, clipRows, clipCols, tiles.length, Math.max(0, ...tiles.map((row) => row.length)))
             : [];
-        onCommand({
+        const pasteCommand = {
             command: "paste",
             sheetId: destinationSheetId,
             target,
@@ -2810,17 +2897,99 @@ export function useEngineCore(options) {
             ...(autoCalculatedColumnsRef.current === false
                 ? { autoCalculatedColumns: false }
                 : {}),
-        });
+        };
+        // Keep Source Column Widths: the cells and the widths are one undo step. A transposed block
+        // no longer lines its columns up with the copied ones, so it takes no widths.
+        if (pasteSpecial.columnWidths === "also" && pasteSource && !pasteSpecial.transpose) {
+            batchHistory(() => {
+                onCommand(pasteCommand);
+                copySourceColumnWidths(pasteSource);
+            });
+        }
+        else {
+            onCommand(pasteCommand);
+        }
     }, [
         getSheetName,
         getCellData,
         getUserEnteredFormat,
         getNote,
+        getColumnWidth,
         onCommand,
         batchHistory,
         focusEmbedOrChart,
         getSheetDimensions,
+        facets,
+        state.sheets,
     ]);
+    // The last paste, kept for Excel's Paste Options button (`onReapplyPaste`): its clipboard, its
+    // placement arguments and the undo depth right after it. A cut is a move and has no Paste Options.
+    const lastPasteRef = useRef(null);
+    const onPaste = useCallback(async (e, sourceSheetId, destinationSheetId, copiedSelections, pasteActiveCell, pasteSelections, finalSelections, isCutOperation) => {
+        // Read the clipboard before the first await: a browser paste event's data is gone after it.
+        const entries = isCutOperation ? null : snapshotClipboard(e?.clipboardData);
+        const depthBefore = engineRef.current?.undoDepth() ?? 0;
+        lastPasteRef.current = null;
+        await pasteInto(e, sourceSheetId, destinationSheetId, copiedSelections, pasteActiveCell, pasteSelections, finalSelections, isCutOperation);
+        const depth = engineRef.current?.undoDepth() ?? 0;
+        if (entries && depth > depthBefore) {
+            lastPasteRef.current = {
+                entries,
+                args: [
+                    sourceSheetId,
+                    destinationSheetId,
+                    copiedSelections,
+                    pasteActiveCell,
+                    pasteSelections,
+                    finalSelections,
+                ],
+                depth,
+            };
+        }
+    }, [pasteInto]);
+    // Paste Options: undo the last paste and paste its clipboard again as `options`, at the same place.
+    // The undone paste only moves to the redo stack, and the new paste clears it, so the result is ONE
+    // undo step. Refused (false) once anything else has been written since the paste.
+    const onReapplyPaste = useCallback(async (options) => {
+        const last = lastPasteRef.current;
+        const engine = engineRef.current;
+        if (!last || !engine || engine.undoDepth() !== last.depth) {
+            lastPasteRef.current = null;
+            return false;
+        }
+        // The pasted range stays selected, as after the paste (the undo alone would restore the
+        // selection from before it).
+        const view = viewRef.current;
+        undo();
+        await onPaste(replayPasteEvent(last.entries, options), ...last.args, false);
+        if (view)
+            applyView(view);
+        return lastPasteRef.current !== null;
+    }, [onPaste, undo, applyView]);
+    // Insert-copy. Two commits, the insert first: the engine refuses a band that would tear a merge /
+    // table / array or push data off the sheet, and a refused insert must not let the paste overwrite
+    // the destination (a `batch` runs every member whatever the one before it refused).
+    const onInsertCopiedCells = useCallback(async (e, sheetId, from, to, shift) => {
+        const direction = shift ??
+            (to.range.startRowIndex === from.range.startRowIndex ? "right" : "down");
+        const target = {
+            rowIndex: to.range.startRowIndex,
+            columnIndex: to.range.startColumnIndex,
+        };
+        const commit = onCommand({
+            command: direction === "down"
+                ? "insert-cells-shift-down"
+                : "insert-cells-shift-right",
+            sheetId,
+            activeCell: target,
+            selections: [to],
+        });
+        if (!commit || commit.rejections?.length)
+            return;
+        // Opening the band slides a source that sits wholly in it; the paste reads the source's
+        // notes from where they now are (the cells themselves already ride on the clipboard).
+        await pasteInto(e, sheetId, sheetId, [{ ...from, range: rangeAfterInsertBand(from.range, to.range, direction) }], target, [to], [to], false);
+    }, [onCommand, pasteInto]);
     return useMemo(() => ({
         ...state,
         ...handlers,
@@ -2890,6 +3059,7 @@ export function useEngineCore(options) {
         getSheetColumnCount,
         getDataRowCount,
         getDataRegion,
+        getArrayFormula,
         findAll,
         getSeriesValuesFromRange,
         getDomainValuesFromRange,
@@ -2929,6 +3099,7 @@ export function useEngineCore(options) {
         tables,
         namedRanges,
         protectedRanges,
+        allowEditRanges,
         customTableStyles: facets.customTableStyles,
         embeds,
         slicers,
@@ -2988,6 +3159,8 @@ export function useEngineCore(options) {
         onDeleteDataValidationRules,
         onCopy,
         onPaste,
+        onInsertCopiedCells,
+        onReapplyPaste,
     }), [
         formulaLocale,
         state,
@@ -3051,6 +3224,7 @@ export function useEngineCore(options) {
         getSheetColumnCount,
         getDataRowCount,
         getDataRegion,
+        getArrayFormula,
         findAll,
         getSeriesValuesFromRange,
         getDomainValuesFromRange,
@@ -3074,6 +3248,7 @@ export function useEngineCore(options) {
         tables,
         namedRanges,
         protectedRanges,
+        allowEditRanges,
         facets.customTableStyles,
         embeds,
         slicers,
@@ -3102,5 +3277,33 @@ export function useEngineCore(options) {
         onClearHistory,
         onCopy,
         onPaste,
+        onInsertCopiedCells,
+        onReapplyPaste,
     ]);
 }
+/** Where `range` sits once cells open at `band` and shift `direction` (a range wholly in the band's
+ * lanes, at or past its first line, slides by the band's size; anything else stays put). */
+export const rangeAfterInsertBand = (range, band, direction) => {
+    if (direction === "down") {
+        const inLanes = range.startColumnIndex >= band.startColumnIndex &&
+            range.endColumnIndex <= band.endColumnIndex;
+        if (!inLanes || range.startRowIndex < band.startRowIndex)
+            return range;
+        const size = band.endRowIndex - band.startRowIndex + 1;
+        return {
+            ...range,
+            startRowIndex: range.startRowIndex + size,
+            endRowIndex: range.endRowIndex + size,
+        };
+    }
+    const inLanes = range.startRowIndex >= band.startRowIndex &&
+        range.endRowIndex <= band.endRowIndex;
+    if (!inLanes || range.startColumnIndex < band.startColumnIndex)
+        return range;
+    const size = band.endColumnIndex - band.startColumnIndex + 1;
+    return {
+        ...range,
+        startColumnIndex: range.startColumnIndex + size,
+        endColumnIndex: range.endColumnIndex + size,
+    };
+};

package/dist/esm/wasm/rnc_wasm.d.ts

@@ -17,6 +17,11 @@ export class CollabSpreadsheetEngine {
      * `syncRemote()` to rebuild the engine and get a `CommitResult` for the UI.
      */
     applyUpdate(update: Uint8Array): void;
+    /**
+     * The legacy Ctrl+Shift+Enter array covering a 1-based cell (see the single-user engine's
+     * `arrayFormulaAt`), or `null`.
+     */
+    arrayFormulaAt(sheet_id: number, row: number, col: number): string;
     canRedo(): boolean;
     canUndo(): boolean;
     clearHistory(): void;
@@ -131,6 +136,13 @@ export class SpreadsheetEngine {
      * Apply a `commands.ts` JSON command; returns `CommitResult` JSON.
      */
     applyCommand(command_json: string): string;
+    /**
+     * The legacy Ctrl+Shift+Enter array covering a 1-based cell, as JSON
+     * `{"range":{startRowIndex,endRowIndex,startColumnIndex,endColumnIndex},"formula":"=…"}` —
+     * the formula every cell of the array shows (Excel's formula bar wraps it in `{…}`) and the
+     * range a re-entry replaces — or `null` outside every CSE array.
+     */
+    arrayFormulaAt(sheet_id: number, row: number, col: number): string;
     canRedo(): boolean;
     /**
      * Whether an undo / redo is currently available (for enabling toolbar buttons).
@@ -350,9 +362,47 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly __wbg_collabspreadsheetengine_free: (a: number, b: number) => void;
+    readonly collabspreadsheetengine_addSheet: (a: number, b: number, c: number, d: number) => void;
+    readonly collabspreadsheetengine_applyCommand: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_applyUpdate: (a: number, b: number, c: number) => [number, number];
+    readonly collabspreadsheetengine_arrayFormulaAt: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly collabspreadsheetengine_canRedo: (a: number) => number;
+    readonly collabspreadsheetengine_canUndo: (a: number) => number;
+    readonly collabspreadsheetengine_clearHistory: (a: number) => void;
+    readonly collabspreadsheetengine_dataRegion: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_dependents: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_documentFacets: (a: number) => [number, number];
+    readonly collabspreadsheetengine_encodeDiffV1: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_encodeStateAsUpdate: (a: number) => [number, number];
+    readonly collabspreadsheetengine_encodeStateVector: (a: number) => [number, number];
+    readonly collabspreadsheetengine_exportCsv: (a: number, b: number) => [number, number];
+    readonly collabspreadsheetengine_exportXlsx: (a: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_hostOwnedCells: (a: number, b: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_initGrid: (a: number, b: number, c: number, d: number) => void;
+    readonly collabspreadsheetengine_loadDocument: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_new: () => number;
+    readonly collabspreadsheetengine_newWithClientId: (a: number) => number;
+    readonly collabspreadsheetengine_precedents: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_rangeStats: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_readWindow: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_redo: (a: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_redoDepth: (a: number) => number;
+    readonly collabspreadsheetengine_registerCustomFunction: (a: number, b: number, c: number) => void;
+    readonly collabspreadsheetengine_setWindowed: (a: number, b: number) => void;
+    readonly collabspreadsheetengine_sheetExtents: (a: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_sheetIds: (a: number) => [number, number];
+    readonly collabspreadsheetengine_sheets: (a: number) => [number, number];
+    readonly collabspreadsheetengine_streamBegin: (a: number) => void;
+    readonly collabspreadsheetengine_streamEnd: (a: number) => void;
+    readonly collabspreadsheetengine_streamWrite: (a: number, b: number, c: number) => void;
+    readonly collabspreadsheetengine_syncRemote: (a: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_undo: (a: number) => [number, number, number, number];
+    readonly collabspreadsheetengine_undoDepth: (a: number) => number;
     readonly __wbg_spreadsheetengine_free: (a: number, b: number) => void;
     readonly spreadsheetengine_addSheet: (a: number, b: number, c: number, d: number) => void;
     readonly spreadsheetengine_applyCommand: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly spreadsheetengine_arrayFormulaAt: (a: number, b: number, c: number, d: number) => [number, number];
     readonly spreadsheetengine_canRedo: (a: number) => number;
     readonly spreadsheetengine_canUndo: (a: number) => number;
     readonly spreadsheetengine_clearHistory: (a: number) => void;
@@ -393,42 +443,6 @@ export interface InitOutput {
     readonly spreadsheetengine_validationSourceValues: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly spreadsheetengine_wasmMemoryBytes: (a: number) => number;
     readonly transformRangeThroughOps: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
-    readonly __wbg_collabspreadsheetengine_free: (a: number, b: number) => void;
-    readonly collabspreadsheetengine_addSheet: (a: number, b: number, c: number, d: number) => void;
-    readonly collabspreadsheetengine_applyCommand: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_applyUpdate: (a: number, b: number, c: number) => [number, number];
-    readonly collabspreadsheetengine_canRedo: (a: number) => number;
-    readonly collabspreadsheetengine_canUndo: (a: number) => number;
-    readonly collabspreadsheetengine_clearHistory: (a: number) => void;
-    readonly collabspreadsheetengine_dataRegion: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_dependents: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_documentFacets: (a: number) => [number, number];
-    readonly collabspreadsheetengine_encodeDiffV1: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_encodeStateAsUpdate: (a: number) => [number, number];
-    readonly collabspreadsheetengine_encodeStateVector: (a: number) => [number, number];
-    readonly collabspreadsheetengine_exportCsv: (a: number, b: number) => [number, number];
-    readonly collabspreadsheetengine_exportXlsx: (a: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_hostOwnedCells: (a: number, b: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_initGrid: (a: number, b: number, c: number, d: number) => void;
-    readonly collabspreadsheetengine_loadDocument: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_new: () => number;
-    readonly collabspreadsheetengine_newWithClientId: (a: number) => number;
-    readonly collabspreadsheetengine_precedents: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_rangeStats: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_readWindow: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_redo: (a: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_redoDepth: (a: number) => number;
-    readonly collabspreadsheetengine_registerCustomFunction: (a: number, b: number, c: number) => void;
-    readonly collabspreadsheetengine_setWindowed: (a: number, b: number) => void;
-    readonly collabspreadsheetengine_sheetExtents: (a: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_sheetIds: (a: number) => [number, number];
-    readonly collabspreadsheetengine_sheets: (a: number) => [number, number];
-    readonly collabspreadsheetengine_streamBegin: (a: number) => void;
-    readonly collabspreadsheetengine_streamEnd: (a: number) => void;
-    readonly collabspreadsheetengine_streamWrite: (a: number, b: number, c: number) => void;
-    readonly collabspreadsheetengine_syncRemote: (a: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_undo: (a: number) => [number, number, number, number];
-    readonly collabspreadsheetengine_undoDepth: (a: number) => number;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __wbindgen_exn_store: (a: number) => void;
     readonly __externref_table_alloc: () => number;

package/dist/esm/wasm/rnc_wasm.js

@@ -69,6 +69,26 @@ export class CollabSpreadsheetEngine {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * The legacy Ctrl+Shift+Enter array covering a 1-based cell (see the single-user engine's
+     * `arrayFormulaAt`), or `null`.
+     * @param {number} sheet_id
+     * @param {number} row
+     * @param {number} col
+     * @returns {string}
+     */
+    arrayFormulaAt(sheet_id, row, col) {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.collabspreadsheetengine_arrayFormulaAt(this.__wbg_ptr, sheet_id, row, col);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * @returns {boolean}
      */
@@ -592,6 +612,28 @@ export class SpreadsheetEngine {
             wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
         }
     }
+    /**
+     * The legacy Ctrl+Shift+Enter array covering a 1-based cell, as JSON
+     * `{"range":{startRowIndex,endRowIndex,startColumnIndex,endColumnIndex},"formula":"=…"}` —
+     * the formula every cell of the array shows (Excel's formula bar wraps it in `{…}`) and the
+     * range a re-entry replaces — or `null` outside every CSE array.
+     * @param {number} sheet_id
+     * @param {number} row
+     * @param {number} col
+     * @returns {string}
+     */
+    arrayFormulaAt(sheet_id, row, col) {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.spreadsheetengine_arrayFormulaAt(this.__wbg_ptr, sheet_id, row, col);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * @returns {boolean}
      */