@rowsncolumns/rnc-engine 1.0.0 → 1.1.1

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

@@ -16,7 +16,7 @@
  * the folded render state plus the read accessors a grid needs (`getCellData`/`getEffectiveFormat`/…).
  */
 import type { CellData, CellFormat, CellInterface, Citation, GridRange, NamedCellStyle, SelectionArea, SheetCoordinate, SheetRange } from "@rowsncolumns/common-types";
-import { type AvailableIcon, type ConditionalFormatRule, type EmbeddedChart, type EmbeddedObject, type HIDDEN_DIMENSION_STRATEGY, type NamedRange, type ProtectedRange, type Sheet, type Slicer, type SpreadsheetTheme, type TableView } from "@rowsncolumns/spreadsheet";
+import { type AvailableIcon, type ConditionalFormatRule, type EmbeddedChart, type MoveChartTarget, type OverlayToAnchor, type EmbeddedObject, type HIDDEN_DIMENSION_STRATEGY, type NamedRange, type ProtectedRange, type Sheet, type Slicer, type SpreadsheetTheme, type TableView } from "@rowsncolumns/spreadsheet";
 import { type useSpreadsheetState } from "@rowsncolumns/spreadsheet-state";
 import { type FormulaLocale, type FormulaLocaleInput } from "@rowsncolumns/utils";
 import { type EngineSpreadsheetHandlers } from "./command-handlers";
@@ -103,6 +103,18 @@ export interface UseEngineSpreadsheetOptions {
      * direction, case-insensitive) ahead of the locale month/weekday lists. Read through a live ref —
      * the identity may change freely. */
     customAutofillLists?: string[][];
+    /** Excel's "Include new rows and columns in table" AutoCorrect option — the same option as
+     * `useSpreadsheetState({ autoExpandTables })`. `false` makes every `set-value` / `change-batch` /
+     * `fill` / `paste` command carry `autoExpandTables: false`, so the engine never grows a table over
+     * the written cells (the smart tag's "Stop Automatically Expanding Tables"). Read through a live
+     * ref. @default true */
+    autoExpandTables?: boolean;
+    /** Excel's "Fill formulas in tables to create calculated columns" AutoCorrect option — the same
+     * option as `useSpreadsheetState({ autoCalculatedColumns })`. `false` makes every `set-value` /
+     * `change-batch` / `paste` command carry `autoCalculatedColumns: false`, so the engine never fills a table
+     * column from a typed formula (the smart tag's "Stop automatically creating calculated columns").
+     * Read through a live ref. @default true */
+    autoCalculatedColumns?: boolean;
     /** Windowed mode only: the EFFECTIVE frozen-pane counts for a sheet, so every window read also loads
      * the frozen top/left bands (which must never be evicted — frozen panes stay on screen at any scroll
      * position). A collab host should answer from its authoritative source (e.g. the `rncSheetMeta` doc
@@ -158,6 +170,12 @@ export interface EngineSpreadsheet extends EngineRenderState, EngineSpreadsheetH
     clearStreamPreview: () => void;
     undo: () => void;
     redo: () => void;
+    /** Run `action` with every command it issues collected and applied afterwards as ONE `batch` —
+     * one commit, one undo step, one view snapshot (the same shape as `SS["batchHistory"]`, which
+     * folds the legacy hooks' history entries). The engine is unchanged while `action` runs, so
+     * `action` must not read back what it just wrote — the data tools' plan-then-apply flows
+     * (Data → Subtotal) never do. A batch started inside another joins the outer one. */
+    batchHistory: SS["batchHistory"];
     /** Toolbar aliases for {@link undo}/{@link redo} (the reference toolbar consumes `onUndo`/`onRedo`). */
     onUndo: () => void;
     onRedo: () => void;
@@ -187,8 +205,11 @@ export interface EngineSpreadsheet extends EngineRenderState, EngineSpreadsheetH
     /** Data → Advanced filter: the shared criteria planner over an engine window read, applied
      * through hide-row / show-row / change-batch (same shape as `SS["onAdvancedFilter"]`). */
     onAdvancedFilter: SS["onAdvancedFilter"];
-    onMoveChart: (chartId: EmbeddedChart["chartId"], anchorCell: CellInterface, offsetXPixels: number, offsetYPixels: number) => void;
-    onResizeChart: (chartId: EmbeddedChart["chartId"], anchorCell: CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number) => void;
+    onMoveChart: (chartId: EmbeddedChart["chartId"], anchorCell: CellInterface, offsetXPixels: number, offsetYPixels: number, toAnchor?: OverlayToAnchor) => void;
+    onResizeChart: (chartId: EmbeddedChart["chartId"], anchorCell: CellInterface, offsetXPixels: number, offsetYPixels: number, width: number, height: number, toAnchor?: OverlayToAnchor) => void;
+    /** Excel's "Move Chart…" (#668 C-17): to a new chartsheet or onto another worksheet at A1. Returns
+     * the destination sheet id (undefined when nothing moved) and follows the chart there. */
+    onMoveChartToSheet: (chart: EmbeddedChart, target: MoveChartTarget) => number | undefined;
     onCreateConditionalFormattingRule: (rule: ConditionalFormatRule) => void;
     onSavePaintFormat: SS["onSavePaintFormat"];
     onApplyPaintFormat: SS["onApplyPaintFormat"];
@@ -304,12 +325,16 @@ export interface EngineSpreadsheet extends EngineRenderState, EngineSpreadsheetH
     isDarkMode: SS["isDarkMode"];
     namedCellStyles: SS["namedCellStyles"];
     bandedRanges: SS["bandedRanges"];
+    /** Gallery live preview: paint `preview`'s style over its table in `bandedRanges` (UI state, no command). */
+    onPreviewTableStyle: SS["onPreviewTableStyle"];
     basicFilter: SS["basicFilter"];
     arrows: SS["arrows"];
     conditionalFormats: ConditionalFormatRule[];
     tables: TableView[];
     namedRanges: NamedRange[];
     protectedRanges: ProtectedRange[];
+    /** Custom table styles (Excel's New Table Style) — the workbook facet the gallery lists (#668 T-103). */
+    customTableStyles: SS["customTableStyles"];
     embeds: EmbeddedObject[];
     slicers: Slicer[];
     /** The data-validation rule covering a cell (resolved by range membership). */

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

@@ -1,11 +1,11 @@
 // Lightweight dependency-graph NODE classes (data holders — NOT the JS calculator) used to shape the
 // real `getPrecedents`/`getDependents` results, which the engine now backs with actual graph data.
 import { CellNode, CellRangeNode, isCellCoordinate, isCellNode, makeKey, } from "@rowsncolumns/dag";
-import { DEFAULT_ACTIVE_CELL, DEFAULT_ARRAY, defaultSpreadsheetTheme, getBandedCells, getInitialActiveSheetId, ICON_SET_COLORS, ICON_SET_GLYPHS, useFonts, } from "@rowsncolumns/spreadsheet";
-import { applyAdvancedFilterPlan, applySubtotalPlan, CellXfsRegistry, collectPaintMerges, generateDataFromClipboard, getBandedCellFormat, isStyleReference, layerBandedFormat, paintSourceForActiveCell, pickFormula, pickValue, planAdvancedFilter, planSubtotals, resolvePasteSpecialOptions, SharedStringRegistry, spreadMergeAnchorFormats, STRUCTURAL_REFUSAL_MESSAGES, STRUCTURAL_REFUSAL_TITLE, tilePaintMerges, transpose, useOnCopy, useOnTraceDependentsPrecedents, useShowError, } from "@rowsncolumns/spreadsheet-state";
+import { DEFAULT_ACTIVE_CELL, DEFAULT_ARRAY, defaultSpreadsheetTheme, getBandedCells, getInitialActiveSheetId, ICON_SET_COLORS, ICON_SET_GLYPHS, useFocusEmbedOrChart, useFonts, useSetTableAutoExpansion, useSetCalculatedColumnFill, } from "@rowsncolumns/spreadsheet";
+import { applyAdvancedFilterPlan, applySubtotalPlan, CellXfsRegistry, collectPaintMerges, generateDataFromClipboard, getBandedCellFormat, isStyleReference, layerBandedFormat, paintSourceForActiveCell, pickFormula, pickValue, planAdvancedFilter, planSubtotals, resolvePasteSpecialOptions, SharedStringRegistry, spreadMergeAnchorFormats, tilePaintMerges, transpose, useOnCopy, previewTableStyle, useOnTraceDependentsPrecedents, useShowError, } from "@rowsncolumns/spreadsheet-state";
 import { getCellUserEnteredFormat, getCellUserEnteredValue, getExtendedValueBool, getExtendedValueFormula, getExtendedValueNumber, getExtendedValueString, getFormulaLocale, normalizeExternalUrl, resolveDefaultHorizontalAlignment, } from "@rowsncolumns/utils";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { createCommandHandlers, } from "./command-handlers";
+import { createCommandHandlers, rejectionDialog, } from "./command-handlers";
 import { emptyRenderState, foldCommit, foldCommitStructuralOnly, foldWindow, foldWindows, frozenBandRanges, reconcileSheets, } from "./fold";
 import { RncEngine, } from "./index";
 import { cellKey, parseCellKey } from "./keys";
@@ -140,6 +140,7 @@ const EMPTY_FACETS = {
     embeds: [],
     slicers: [],
     bandedRanges: [],
+    customTableStyles: [],
     protectedRanges: [],
     basicFilters: [],
     citations: [],
@@ -252,9 +253,6 @@ function parseInternalLocation(location) {
         },
     };
 }
-/** The rnc engine's structural-edit refusals (`off-sheet-push`, `torn-merge`, `torn-table`,
- * `torn-array`) — the codes the legacy engine's `constants.ts` defines, surfaced as a dialog. */
-const isStructuralRejection = (rejection) => rejection.code in STRUCTURAL_REFUSAL_MESSAGES;
 // `useEngineCore` is the engine-only surface (data / calc / commands / accessors) — NOT a standalone
 // drop-in for `useSpreadsheetState`. The chrome (dialogs + host intents) lives in `useSpreadsheetUI`;
 // the drop-in parity lock is asserted on their composition, `useSpreadsheetEngine`.
@@ -284,6 +282,7 @@ export function useEngineCore(options) {
     const onCustomEvalCancelRef = useRef(options.onCustomEvalCancel);
     onCustomEvalCancelRef.current = options.onCustomEvalCancel;
     const showError = useShowError();
+    const focusEmbedOrChart = useFocusEmbedOrChart();
     // Latest-refs for the streaming batch-write observers (identities may change every render).
     const onStreamStartRef = useRef(options.onStreamStart);
     onStreamStartRef.current = options.onStreamStart;
@@ -313,6 +312,16 @@ export function useEngineCore(options) {
     stateSheetsRef.current = state.sheets;
     const customAutofillListsRef = useRef(options.customAutofillLists);
     customAutofillListsRef.current = options.customAutofillLists;
+    const autoExpandTablesRef = useRef(options.autoExpandTables);
+    autoExpandTablesRef.current = options.autoExpandTables;
+    const autoCalculatedColumnsRef = useRef(options.autoCalculatedColumns);
+    autoCalculatedColumnsRef.current = options.autoCalculatedColumns;
+    // Excel's AutoCorrect smart tag after a table auto-expanded — armed from the commit's
+    // `tableAutoExpansion` record when a value-writing command grew a table; `CanvasGrid` renders it.
+    const setTableAutoExpansion = useSetTableAutoExpansion();
+    // Excel's AutoCorrect smart tag after a formula typed into a table column — armed from the
+    // commit's `calculatedColumnFill` record; `CanvasGrid` renders it.
+    const setCalculatedColumnFill = useSetCalculatedColumnFill();
     // One windowed read = the buffered window + the sheet's frozen bands + the sheet's active cell
     // (pinned so the formula bar's active-cell read survives scrolling it out of the window — see
     // `readWindowWithFrozenBands`). Frozen counts come from the host's getter when provided (see
@@ -653,6 +662,12 @@ 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;
@@ -687,10 +702,16 @@ export function useEngineCore(options) {
     sheetDataRef.current = state.sheetData;
     const committedFvAt = useCallback((sheetId, rowIndex, columnIndex) => sheetDataRef.current?.[sheetId]?.[rowIndex]?.values?.[columnIndex]?.fv ??
         undefined, []);
+    // Commands issued while a `batchHistory` action runs, applied together when it returns.
+    const batchCommandsRef = useRef(null);
     const onCommand = useCallback((command) => {
         const engine = engineRef.current;
         if (!engine)
             return;
+        if (batchCommandsRef.current) {
+            batchCommandsRef.current.push(command);
+            return;
+        }
         // 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.
@@ -705,17 +726,22 @@ export function useEngineCore(options) {
         // Snapshot the view BEFORE applying — that's where undo should return the user.
         const before = viewRef.current;
         const commit = engine.applyCommand(command);
-        // Excel's structural refusals (rowsncolumns/spreadsheet#647): the engine wrote nothing — show
-        // the user Excel's dialog text through the same channel the legacy engine's hooks use
-        // (`useShowError`). Other refusals keep riding `commit.rejections` to the command handlers.
+        // A value-writing command grew a table over the written cells: arm the AutoCorrect smart tag
+        // with the engine's record of the growth (rowsncolumns/spreadsheet#668 T-12) — "Undo Table
+        // AutoExpansion" resizes back and clears the cells the growth wrote (`writes`, T-89).
+        if (commit.tableAutoExpansion) {
+            setTableAutoExpansion(commit.tableAutoExpansion);
+        }
+        if (commit.calculatedColumnFill) {
+            setCalculatedColumnFill(commit.calculatedColumnFill);
+        }
+        // A refusal wrote nothing — show the user Excel's dialog text through the same channel the
+        // legacy engine's hooks use (`useShowError`), once: `createCommandHandlers` skips the
+        // refusals that have a dialog here. The rest keep riding `commit.rejections` to it.
         for (const rejection of commit.rejections ?? []) {
-            if (isStructuralRejection(rejection)) {
-                showError({ title: STRUCTURAL_REFUSAL_TITLE, message: rejection.message });
-            }
-            else if (rejection.code === "merged-cell-move") {
-                // A refused move / cut + paste ("We can't do that to a merged cell.") wrote nothing; the
-                // legacy engine's move / paste hooks open the shared error dialog for it, so do the same.
-                showError({ message: rejection.message });
+            const dialog = rejectionDialog(rejection);
+            if (dialog) {
+                showError(dialog);
             }
         }
         // Only record a view snapshot if the command actually pushed a document undo entry (skips
@@ -725,6 +751,12 @@ export function useEngineCore(options) {
             viewRedo.current = [];
         }
         lastUndoDepth.current = engine.undoDepth();
+        // Excel selects a freshly inserted chart; a batch ends up on the last one it inserted.
+        for (const member of command.command === "batch" ? command.commands : [command]) {
+            if (member.command === "create-chart") {
+                focusEmbedOrChart(member.spec.chartId);
+            }
+        }
         // The engine's move-range relocates cells but never re-scopes range-scoped CF/DV rules —
         // carry the touched rules to the destination right after the move (Excel/Sheets behavior).
         if (command.command === "move-range") {
@@ -734,7 +766,25 @@ export function useEngineCore(options) {
         }
         // Handed back so the command handlers can surface an engine refusal (`commit.rejections`).
         return commit;
-    }, [retireStreamPreviewForCommand, showError]);
+    }, [retireStreamPreviewForCommand, showError, focusEmbedOrChart, setTableAutoExpansion, setCalculatedColumnFill]);
+    const batchHistory = useCallback((action) => {
+        if (batchCommandsRef.current) {
+            return action();
+        }
+        const commands = [];
+        batchCommandsRef.current = commands;
+        let result;
+        try {
+            result = action();
+        }
+        finally {
+            batchCommandsRef.current = null;
+        }
+        if (commands.length) {
+            onCommand({ command: "batch", commands });
+        }
+        return result;
+    }, [onCommand]);
     // "Calculate Now" (F9): force a full recalculation so volatile functions (NOW/TODAY/RAND/…) refresh.
     // The engine re-evaluates + streams the changed cells through the normal commit (folded like any edit);
     // it mutates no document state, so it isn't undoable. The reference's `options` (reset-graph /
@@ -803,6 +853,19 @@ export function useEngineCore(options) {
         customFnsRef.current.set(name, impl);
         engineRef.current?.registerCustomFunction(name);
     }, []);
+    // Chart selection after an undo/redo step (Excel: the chart an undo brings back, or a redo
+    // re-creates / re-positions, ends up selected; one whose step removed it is deselected). The
+    // engine's chart deltas are the signal — same as the legacy history's `selectedEmbedOrChart`.
+    const restoreChartSelection = useCallback((commit) => {
+        for (const change of commit.chartChanges) {
+            if (change.chart) {
+                focusEmbedOrChart(change.chartId);
+            }
+            else {
+                focusEmbedOrChart((prev) => prev === change.chartId ? undefined : prev);
+            }
+        }
+    }, [focusEmbedOrChart]);
     // Undo AND redo of an edit both return the cursor to the EDIT location — mirroring the reference's
     // `{ activeCell: { undo: coords, redo: coords } }`. So when an entry crosses between the undo/redo
     // stacks we move the SAME stored view, NOT the live cursor (pushing the live cursor would make redo
@@ -812,7 +875,7 @@ export function useEngineCore(options) {
         if (!engine)
             return;
         const prevDepth = engine.undoDepth();
-        engine.undo();
+        const commit = engine.undo();
         if (engine.undoDepth() < prevDepth) {
             const restore = viewUndo.current.pop();
             if (restore) {
@@ -821,13 +884,14 @@ export function useEngineCore(options) {
             }
         }
         lastUndoDepth.current = engine.undoDepth();
-    }, [applyView]);
+        restoreChartSelection(commit);
+    }, [applyView, restoreChartSelection]);
     const redo = useCallback(() => {
         const engine = engineRef.current;
         if (!engine)
             return;
         const prevRedoDepth = engine.redoDepth();
-        engine.redo();
+        const commit = engine.redo();
         if (engine.redoDepth() < prevRedoDepth) {
             const restore = viewRedo.current.pop();
             if (restore) {
@@ -836,7 +900,8 @@ export function useEngineCore(options) {
             }
         }
         lastUndoDepth.current = engine.undoDepth();
-    }, [applyView]);
+        restoreChartSelection(commit);
+    }, [applyView, restoreChartSelection]);
     const load = useCallback((document) => {
         engineRef.current?.load(document);
     }, []);
@@ -865,6 +930,9 @@ export function useEngineCore(options) {
             hidden: es.hidden,
             tabColor: es.tabColor,
             defaultRowHeight: es.defaultRowHeight,
+            defaultColumnWidth: es.defaultColumnWidth,
+            type: es.type,
+            chartId: es.chartId,
         }));
         const firstId = engineSheets[0]?.sheetId ?? viewRef.current.activeSheetId;
         windowRef.current = windowedRef.current
@@ -1763,6 +1831,8 @@ export function useEngineCore(options) {
     // handler→command mapping; nothing here touches the document directly.
     const handlers = useMemo(() => createCommandHandlers(onCommand, {
         getCustomAutofillLists: () => customAutofillListsRef.current,
+        getAutoExpandTables: () => autoExpandTablesRef.current,
+        getAutoCalculatedColumns: () => autoCalculatedColumnsRef.current,
     }), [onCommand]);
     // Data tools composed over the streamed commands. The planners need the WHOLE list range (a
     // windowed host holds only the viewport), so they read it straight from the engine in one
@@ -1782,15 +1852,18 @@ export function useEngineCore(options) {
         });
         if (!plan)
             return undefined;
-        applySubtotalPlan(sheetId, plan, {
+        // Excel undoes a Subtotal in ONE step: the plan's row deletes / inserts, total-row writes and
+        // outline groups apply as one `batch` — one commit to fold, one undo entry on either history
+        // backend, one view snapshot — instead of ten Ctrl+Z presses.
+        batchHistory(() => applySubtotalPlan(sheetId, plan, {
             onDeleteRow: handlers.onDeleteRow,
             onInsertRow: handlers.onInsertRow,
             onChangeBatch: (s, range, values) => handlers.onChangeBatch(s, range, values),
             onGroupRows: handlers.onGroupRows,
             onUngroupRows: handlers.onUngroupRows,
-        });
+        }));
         return plan;
-    }, [handlers, readRect, dimMeta]);
+    }, [batchHistory, handlers, readRect, dimMeta]);
     const onAdvancedFilter = useCallback((sheetId, options) => {
         const list = readRect(sheetId, options.listRange, "raw");
         const criteria = readRect(sheetId, options.criteriaRange, "raw");
@@ -1818,15 +1891,46 @@ export function useEngineCore(options) {
     // (the live active sheet) instead of closing over `activeSheetId`, so identity never changes. The
     // grid omits sheetId from chart move/resize (charts live on the active sheet) and passes just the rule
     // to create-conditional-format.
-    const onMoveChart = useCallback((chartId, anchorCell, offsetXPixels, offsetYPixels) => onCommand({
+    const onMoveChart = useCallback((chartId, anchorCell, offsetXPixels, offsetYPixels, toAnchor) => onCommand({
         command: "move-chart",
         chartId,
         sheetId: viewRef.current.activeSheetId,
         anchorCell,
         offsetXPixels,
         offsetYPixels,
+        ...toAnchor,
     }), [onCommand]);
-    const onResizeChart = useCallback((chartId, anchorCell, offsetXPixels, offsetYPixels, width, height) => onCommand({
+    // Excel's "Move Chart…" (#668 C-17): the engine relocates the chart (minting / deleting the
+    // chartsheet); the view follows the chart to its destination sheet and keeps it selected.
+    const onMoveChartToSheet = useCallback((chart, target) => {
+        const engine = engineRef.current;
+        if (!engine)
+            return undefined;
+        const sourceSheetId = chart.position.sheetId;
+        if (target.kind === "sheet" && target.sheetId === sourceSheetId) {
+            return undefined;
+        }
+        onCommand({
+            command: "move-chart-to-sheet",
+            chartId: chart.chartId,
+            ...(target.kind === "sheet"
+                ? { sheetId: target.sheetId }
+                : { title: target.title }),
+        });
+        const destination = target.kind === "sheet"
+            ? target.sheetId
+            : engine
+                .sheets?.()
+                .find((sheet) => sheet.type === "chartsheet" &&
+                String(sheet.chartId) === String(chart.chartId))?.sheetId;
+        if (destination === undefined || destination === sourceSheetId) {
+            return undefined;
+        }
+        onChangeActiveSheet(destination);
+        focusEmbedOrChart(chart.chartId);
+        return destination;
+    }, [onCommand, onChangeActiveSheet, focusEmbedOrChart]);
+    const onResizeChart = useCallback((chartId, anchorCell, offsetXPixels, offsetYPixels, width, height, toAnchor) => onCommand({
         command: "resize-chart",
         chartId,
         sheetId: viewRef.current.activeSheetId,
@@ -1835,6 +1939,7 @@ export function useEngineCore(options) {
         offsetYPixels,
         width,
         height,
+        ...toAnchor,
     }), [onCommand]);
     const onCreateConditionalFormattingRule = useCallback((rule) => onCommand({
         command: "create-conditional-format",
@@ -1860,6 +1965,9 @@ export function useEngineCore(options) {
                 .filter((t) => t.sheetId === sheetId && t.bandedRange != null)
                 .map((t) => ({
                 bandedRangeId: `${t.id}-${t.theme}`,
+                showFirstColumn: t.showFirstColumn,
+                showLastColumn: t.showLastColumn,
+                totalRow: t.totalRow ?? false,
                 range: { ...t.range, sheetId },
                 ...t.bandedRange,
             })),
@@ -1909,6 +2017,44 @@ export function useEngineCore(options) {
             }
         }
     }, [onCommand]);
+    // Convert to Range keeps the table's look (Excel bakes the table style into the cell formats):
+    // the banded formats the grid painted under the table become static cell formats — the same
+    // capture the format painter makes (#620) — replayed over the table's range in one batch with
+    // the removal, so one undo restores the table and the unbaked cells together.
+    const onRemoveTable = useCallback((tableView) => {
+        const { sheetId, range } = tableView;
+        const banded = paintBandedCells(sheetId);
+        batchHistory(() => {
+            if (banded?.size) {
+                let baked = false;
+                const grid = [];
+                for (let r = range.startRowIndex; r <= range.endRowIndex; r++) {
+                    const row = [];
+                    for (let c = range.startColumnIndex; c <= range.endColumnIndex; c++) {
+                        // The hook's own formats are consolidated `CellFormat`s (never a style reference).
+                        const own = getUserEnteredFormat(sheetId, r, c);
+                        const band = getBandedCellFormat(banded, r, c);
+                        if (band)
+                            baked = true;
+                        // `replace` re-writes every cell of the range: a cell without a band keeps its own format.
+                        row.push((band ? layerBandedFormat(own, band) : own) ?? null);
+                    }
+                    grid.push(row);
+                }
+                if (baked) {
+                    onCommand({
+                        command: "change-formatting",
+                        sheetId,
+                        activeCell: { rowIndex: range.startRowIndex, columnIndex: range.startColumnIndex },
+                        selections: [{ range }],
+                        cellFormat: grid,
+                        options: { replace: true },
+                    });
+                }
+            }
+            handlers.onRemoveTable(tableView);
+        });
+    }, [paintBandedCells, getUserEnteredFormat, batchHistory, onCommand, handlers]);
     const onSavePaintFormat = useCallback((sheetId, activeCell, selections) => {
         // A plain click on a merged cell arms the painter with the anchor and NO selection (the
         // grid clears the list) — Excel treats that click as the whole merged area.
@@ -2059,11 +2205,22 @@ export function useEngineCore(options) {
     // style is materialized on its facet entry as `bandedRange` (never as per-cell format), so derive
     // those here exactly like `useSpreadsheetState` — this single array is what the grid paints and the
     // copy path serializes table styling from.
+    // The gallery's hovered style paints over the table's own while the pointer rests on the
+    // swatch — UI state only, never a command.
+    const [tableStylePreview, setTableStylePreview] = useState(null);
+    const onPreviewTableStyle = useCallback((preview) => setTableStylePreview(preview), []);
     const bandedRanges = useMemo(() => {
         const tableBands = (tables ?? [])
-            .filter((t) => t.sheetId === activeSheetId && t.bandedRange != null)
+            .filter((t) => t.sheetId === activeSheetId)
+            .map((t) => tableStylePreview?.sheetId === t.sheetId && tableStylePreview.tableId === t.id
+            ? previewTableStyle(t, tableStylePreview)
+            : t)
+            .filter((t) => t.bandedRange != null)
             .map((t) => ({
             bandedRangeId: `${t.id}-${t.theme}`,
+            showFirstColumn: t.showFirstColumn,
+            showLastColumn: t.showLastColumn,
+            totalRow: t.totalRow ?? false,
             range: { ...t.range, sheetId: activeSheetId },
             ...t.bandedRange,
         }));
@@ -2071,7 +2228,7 @@ export function useEngineCore(options) {
             ...facets.bandedRanges.filter((b) => b.range?.sheetId === activeSheetId),
             ...tableBands,
         ];
-    }, [facets, tables, activeSheetId]);
+    }, [facets, tables, activeSheetId, tableStylePreview]);
     const basicFilter = useMemo(() => facets.basicFilters.find((f) => f.sheetId === activeSheetId)?.filter, [facets, activeSheetId]);
     // Body rows the engine hid for the active sheet (basic filter OR a table-column filter), as compact
     // [start,end] 1-based inclusive ranges. CanvasGrid derives `visibleRowRanges` from these — the
@@ -2151,7 +2308,7 @@ export function useEngineCore(options) {
         // 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
         // relativize cut formulas the way it does copied ones.
-        const parsed = await generateDataFromClipboard(e, pasteActiveCell, destinationSheetId, getSheetName(destinationSheetId), true, initial.current.locale, undefined, undefined, undefined, undefined, { relocateFormulas: !isCutOperation });
+        const parsed = await generateDataFromClipboard(e, pasteActiveCell, destinationSheetId, getSheetName(destinationSheetId), true, initial.current.locale, undefined, undefined, undefined, { relocateFormulas: !isCutOperation });
         let results = parsed?.results ?? [];
         if (!results.length)
             return;
@@ -2266,11 +2423,16 @@ export function useEngineCore(options) {
                 ? { sheetId: sourceSheetId, range: from }
                 : null,
             formatOnly,
+            ...(autoExpandTablesRef.current === false ? { autoExpandTables: false } : {}),
+            ...(autoCalculatedColumnsRef.current === false
+                ? { autoCalculatedColumns: false }
+                : {}),
         });
     }, [getSheetName, getCellData, getUserEnteredFormat, getNote, onCommand]);
     return useMemo(() => ({
         ...state,
         ...handlers,
+        onRemoveTable,
         ready,
         engine: engineRef.current,
         canUndo: hist.canUndo,
@@ -2282,6 +2444,7 @@ export function useEngineCore(options) {
         onUndo: undo,
         onRedo: redo,
         onMoveChart,
+        onMoveChartToSheet,
         onResizeChart,
         onCreateConditionalFormattingRule,
         // Repeat last formatting (the action itself is recorded in `onCommand`).
@@ -2356,8 +2519,11 @@ export function useEngineCore(options) {
         // Undefined when the file didn't specify — CanvasGrid falls back to its own default.
         defaultRowHeight: state.sheets.find((s) => s.sheetId === activeSheetId)
             ?.defaultRowHeight ?? undefined,
+        defaultColumnWidth: state.sheets.find((s) => s.sheetId === activeSheetId)
+            ?.defaultColumnWidth ?? undefined,
         isDarkMode: false,
         bandedRanges,
+        onPreviewTableStyle,
         basicFilter,
         hostHiddenRowRanges,
         arrows,
@@ -2365,6 +2531,7 @@ export function useEngineCore(options) {
         tables,
         namedRanges,
         protectedRanges,
+        customTableStyles: facets.customTableStyles,
         embeds,
         slicers,
         getDataValidation,
@@ -2401,6 +2568,7 @@ export function useEngineCore(options) {
         applyPatch,
         generateStatePatches,
         createHistory,
+        batchHistory,
         onClearHistory,
         getFormattingFromRange,
         getFormulasFromRange,
@@ -2420,12 +2588,15 @@ export function useEngineCore(options) {
         formulaLocale,
         state,
         handlers,
+        onRemoveTable,
         ready,
         hist,
         onCommand,
         undo,
         redo,
+        batchHistory,
         onMoveChart,
+        onMoveChartToSheet,
         onResizeChart,
         onCreateConditionalFormattingRule,
         onRepeatFormatting,
@@ -2488,6 +2659,7 @@ export function useEngineCore(options) {
         onSelectNextSheet,
         onSelectPreviousSheet,
         bandedRanges,
+        onPreviewTableStyle,
         basicFilter,
         hostHiddenRowRanges,
         arrows,
@@ -2495,6 +2667,7 @@ export function useEngineCore(options) {
         tables,
         namedRanges,
         protectedRanges,
+        facets.customTableStyles,
         embeds,
         slicers,
         getDataValidation,

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

@@ -1,7 +1,16 @@
+/**
+ * `useSpreadsheetEngine` — the batteries-included **Option B** hook: the engine-backed data/calc core
+ * ({@link useEngineCore}) composed with the backend-agnostic chrome ({@link useSpreadsheetUI}). It's
+ * the Option-B peer of `useSpreadsheetState` — one hook a component drives the whole grid + dialogs
+ * from. The core owns the engine surface (data/calc/commands/accessors); the chrome owns the dialogs +
+ * host intents (clipboard/citations/comments/…). Their UNION is what makes this a structural drop-in
+ * for `useSpreadsheetState` — the parity lock below is asserted here, not on either layer alone.
+ */
+import { type SparklineGroupHandlers } from "@rowsncolumns/spreadsheet-state";
 import { type EngineSpreadsheet, type UseEngineSpreadsheetOptions } from "./use-engine-core";
 import { type SpreadsheetUI } from "./use-spreadsheet-ui";
 /** The composed surface: the engine core (data/calc/commands/accessors) + the chrome (dialogs + host
  * intents). This — not `useEngineCore` alone — is the drop-in replacement for `useSpreadsheetState`. */
-export type SpreadsheetEngine = EngineSpreadsheet & SpreadsheetUI;
+export type SpreadsheetEngine = EngineSpreadsheet & SpreadsheetUI & SparklineGroupHandlers;
 export declare function useSpreadsheetEngine(options: UseEngineSpreadsheetOptions): SpreadsheetEngine;
 //# sourceMappingURL=use-spreadsheet-engine.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-spreadsheet-engine.d.ts","sourceRoot":"","sources":["../../src/use-spreadsheet-engine.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,2BAA2B,EACjC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AAE5E;wGACwG;AACxG,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAalE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,iBAAiB,CA6BnB"}
+{"version":3,"file":"use-spreadsheet-engine.d.ts","sourceRoot":"","sources":["../../src/use-spreadsheet-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,KAAK,sBAAsB,EAQ5B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,2BAA2B,EACjC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AAE5E;wGACwG;AACxG,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAC/C,aAAa,GACb,sBAAsB,CAAC;AAazB,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,iBAAiB,CA0GnB"}