@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.1

package/dist/esm/components/editors/table-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-editor.d.ts","sourceRoot":"","sources":["../../../../components/editors/table-editor.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,2BAA2B,CAAC;AAqB7E,OAAO,KAAsB,MAAM,OAAO,CAAC;AAI3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAG7E,KAAK,gBAAgB,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;CACzE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,8CAKzB,gBAAgB,sBA2DlB,CAAC"}
+{"version":3,"file":"table-editor.d.ts","sourceRoot":"","sources":["../../../../components/editors/table-editor.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,SAAS,EACV,MAAM,2BAA2B,CAAC;AAqBnC,OAAO,KAAyC,MAAM,OAAO,CAAC;AAe9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAO7E,KAAK,gBAAgB,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IACxE;;;OAGG;IACH,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IACxE;;;OAGG;IACH,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC;IACxE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,iHAUzB,gBAAgB,sBAwElB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,oBAE/B;IACD,aAAa,EAAE,WAAW,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC;CAC/D,sBA2DA,CAAC;AAgEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,qHAC+E,CAAC;AAErH,eAAO,MAAM,wBAAwB,GACnC,OAAO,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAC/B,OAAO,SAAS,KACf,MAAM,GAAG,SAOX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,oBAE/B;IACD,aAAa,EAAE,WAAW,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC;CAC/D,sBAqDA,CAAC;AAmEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,qBAEhC;IACD,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC;CACjE,sBAiDA,CAAC"}

package/dist/esm/components/editors/table-editor.js

@@ -2,11 +2,15 @@ import { Cross2Icon } from "@rowsncolumns/icons";
 import { findMatchingBandProperty, FormulaInput, useFocusSheet, useFormulaInputState, useSetFormulaMode, useSetFormulaSelections, } from "@rowsncolumns/spreadsheet";
 import { Button, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogDescription, DialogTitle, Input, Stack, } from "@rowsncolumns/ui";
 import { useFormik } from "formik";
-import React, { useCallback } from "react";
-import { useEditTableDialogState } from "../../atoms/dialog-state.atom";
+import React, { useCallback, useMemo, useState } from "react";
+import { useCreatingTable, } from "../../atoms/creating-table.atom";
+import { useCreateTableDialogState, useEditTableDialogState, useInsertSlicerDialogState, useResizeTableDialogState, } from "../../atoms/dialog-state.atom";
 import { useEditingTable } from "../../atoms/editing-table.atom";
-import { tableSchema } from "../../validation-schema/table.schema";
-export const TableEditor = ({ sheetId, theme, onSubmit, onRemoveTable, }) => {
+import { useInsertingSlicer } from "../../atoms/inserting-slicer.atom";
+import { useResizingTable } from "../../atoms/resizing-table.atom";
+import { buildTableSlicers, getTableSlicerColumnNames, } from "../../interface/slicers";
+import { createTableSchema } from "../../validation-schema/table.schema";
+export const TableEditor = ({ sheetId, theme, tables, namedRanges, onSubmit, onRemoveTable, onCreateTable, onResizeTable, onCreateSlicer, }) => {
     const [isOpen, onOpenChange] = useEditTableDialogState();
     const setFormulaMode = useSetFormulaMode();
     const setFormulaSelections = useSetFormulaSelections();
@@ -22,24 +26,229 @@ export const TableEditor = ({ sheetId, theme, onSubmit, onRemoveTable, }) => {
         onSubmit?.(sheetId, tableId, table);
         closeDialog();
     }, [onSubmit, closeDialog]);
+    return (React.createElement(React.Fragment, null,
+        onCreateTable ? (React.createElement(CreateTableEditor, { onCreateTable: onCreateTable })) : null,
+        onResizeTable ? (React.createElement(ResizeTableEditor, { onResizeTable: onResizeTable })) : null,
+        onCreateSlicer ? (React.createElement(InsertSlicerEditor, { onCreateSlicer: onCreateSlicer })) : null,
+        React.createElement(Dialog, { modal: false, open: isOpen },
+            React.createElement(DialogContent, { onEscapeKeyDown: closeDialog, onCloseAutoFocus: (e) => {
+                    e.preventDefault();
+                    focusSheet?.();
+                } },
+                React.createElement(DialogTitle, { className: "rnc-drag-handle cursor-move" }, "Edit table"),
+                React.createElement(DialogDescription, null, "Update data range and table properties"),
+                React.createElement(DialogBody, null, table ? (React.createElement(TableEditorForm, { onSubmit: handleSubmit, table: table, tables: tables, namedRanges: namedRanges, sheetId: sheetId, theme: theme, onCancel: closeDialog, onRemoveTable: onRemoveTable })) : null),
+                React.createElement(DialogCloseButton, { onClick: () => {
+                        closeDialog();
+                    } },
+                    React.createElement(Cross2Icon, null))))));
+};
+/**
+ * Excel's "Create Table" dialog: the data range (pre-filled with the selection or the data region
+ * around the active cell) and "My table has headers". Unchecked, a `Column1..N` header row is
+ * inserted above the data (`CreateTableOptions.hasHeaders: false`).
+ */
+export const CreateTableEditor = ({ onCreateTable, }) => {
+    const [isOpen, onOpenChange] = useCreateTableDialogState();
+    const request = useCreatingTable();
+    const setFormulaMode = useSetFormulaMode();
+    const setFormulaSelections = useSetFormulaSelections();
+    const focusSheet = useFocusSheet();
+    const closeDialog = useCallback(() => {
+        setFormulaMode(false);
+        setFormulaSelections([]);
+        onOpenChange(false);
+    }, [setFormulaMode, setFormulaSelections, onOpenChange]);
+    const handleSubmit = useCallback((range, hasHeaders) => {
+        if (!request) {
+            return;
+        }
+        onCreateTable(request.sheetId, request.activeCell, [{ range }], { range }, request.theme, request.bandedRange, { hasHeaders });
+        closeDialog();
+    }, [request, onCreateTable, closeDialog]);
     return (React.createElement(Dialog, { modal: false, open: isOpen },
         React.createElement(DialogContent, { onEscapeKeyDown: closeDialog, onCloseAutoFocus: (e) => {
                 e.preventDefault();
                 focusSheet?.();
             } },
-            React.createElement(DialogTitle, { className: "rnc-drag-handle cursor-move" }, "Edit table"),
-            React.createElement(DialogDescription, null, "Update data range and table properties"),
-            React.createElement(DialogBody, null, table ? (React.createElement(TableEditorForm, { onSubmit: handleSubmit, table: table, sheetId: sheetId, theme: theme, onCancel: closeDialog, onRemoveTable: onRemoveTable })) : null),
-            React.createElement(DialogCloseButton, { onClick: () => {
-                    closeDialog();
-                } },
+            React.createElement(DialogTitle, { className: "rnc-drag-handle cursor-move" }, "Create Table"),
+            React.createElement(DialogDescription, null, "Where is the data for your table?"),
+            React.createElement(DialogBody, null, request && isOpen ? (React.createElement(CreateTableForm
+            // A fresh form per request: its fields are seeded from the request once.
+            , { 
+                // A fresh form per request: its fields are seeded from the request once.
+                key: `${request.sheetId}:${request.range.startRowIndex}:${request.range.startColumnIndex}:${request.range.endRowIndex}:${request.range.endColumnIndex}`, request: request, onSubmit: handleSubmit, onCancel: closeDialog })) : null),
+            React.createElement(DialogCloseButton, { onClick: closeDialog },
+                React.createElement(Cross2Icon, null)))));
+};
+const CreateTableForm = ({ request, onSubmit, onCancel, }) => {
+    const [range, setRange] = useState(request.range);
+    const [hasHeaders, setHasHeaders] = useState(request.hasHeaders);
+    const formulaInput = useFormulaInputState(request.sheetId, {
+        ...request.range,
+        sheetId: request.sheetId,
+    });
+    return (React.createElement("form", { onSubmit: (e) => {
+            e.preventDefault();
+            if (range) {
+                onSubmit(range, hasHeaders);
+            }
+        }, className: "m-0 p-0" },
+        React.createElement(Stack, { direction: "vertical", className: "pb-2 gap-2" },
+            React.createElement(FormulaInput, { onChange: (value) => {
+                    // An unparsable range disables OK until the text reads as a range again.
+                    setRange(undefined);
+                    formulaInput.onChange(value, (parsed) => {
+                        setRange(parsed);
+                    });
+                }, value: formulaInput.value, required: true }),
+            React.createElement("label", { className: "font-system text-sm flex items-center gap-1" },
+                React.createElement("input", { type: "checkbox", id: "rnc-table-has-headers-element", checked: hasHeaders, name: "hasHeaders", onChange: (e) => setHasHeaders(e.target.checked) }),
+                "My table has headers")),
+        React.createElement("div", { className: "flex gap-1 pt-2" },
+            React.createElement(Button, { type: "submit", variant: "primary", size: "xs", disabled: !range }, "OK"),
+            React.createElement(Button, { size: "xs", onClick: onCancel, type: "button" }, "Cancel"))));
+};
+/**
+ * Excel's rule for a resized table: the header row stays where it is and the new range must
+ * overlap the original one. Overlaps with other tables or merged cells are refused by the engines
+ * themselves (`onResizeTable`).
+ */
+export const RESIZE_TABLE_RANGE_ERROR = "The header row must remain in the same row, and the resulting table range must overlap the original table range.";
+export const getResizeTableRangeError = (table, range) => {
+    const overlapsColumns = range.startColumnIndex <= table.range.endColumnIndex &&
+        range.endColumnIndex >= table.range.startColumnIndex;
+    return range.startRowIndex === table.range.startRowIndex && overlapsColumns
+        ? undefined
+        : RESIZE_TABLE_RANGE_ERROR;
+};
+/**
+ * Excel's "Resize Table" dialog: the table's range, editable, submitted through
+ * `onResizeTable` once it keeps the header row and overlaps the original range.
+ */
+export const ResizeTableEditor = ({ onResizeTable, }) => {
+    const [isOpen, onOpenChange] = useResizeTableDialogState();
+    const table = useResizingTable();
+    const setFormulaMode = useSetFormulaMode();
+    const setFormulaSelections = useSetFormulaSelections();
+    const focusSheet = useFocusSheet();
+    const closeDialog = useCallback(() => {
+        setFormulaMode(false);
+        setFormulaSelections([]);
+        onOpenChange(false);
+    }, [setFormulaMode, setFormulaSelections, onOpenChange]);
+    const handleSubmit = useCallback((range) => {
+        if (!table) {
+            return;
+        }
+        onResizeTable(table.sheetId, table, range);
+        closeDialog();
+    }, [table, onResizeTable, closeDialog]);
+    return (React.createElement(Dialog, { modal: false, open: isOpen },
+        React.createElement(DialogContent, { onEscapeKeyDown: closeDialog, onCloseAutoFocus: (e) => {
+                e.preventDefault();
+                focusSheet?.();
+            } },
+            React.createElement(DialogTitle, { className: "rnc-drag-handle cursor-move" }, "Resize Table"),
+            React.createElement(DialogDescription, null, "Select the new data range for your table:"),
+            React.createElement(DialogBody, null, table && isOpen ? (React.createElement(ResizeTableForm
+            // A fresh form per table: its field is seeded from the table once.
+            , { 
+                // A fresh form per table: its field is seeded from the table once.
+                key: `${table.sheetId}:${table.id}:${table.range.startRowIndex}:${table.range.startColumnIndex}:${table.range.endRowIndex}:${table.range.endColumnIndex}`, table: table, onSubmit: handleSubmit, onCancel: closeDialog })) : null),
+            React.createElement(DialogCloseButton, { onClick: closeDialog },
+                React.createElement(Cross2Icon, null)))));
+};
+const ResizeTableForm = ({ table, onSubmit, onCancel, }) => {
+    const [range, setRange] = useState(table.range);
+    const [error, setError] = useState();
+    const formulaInput = useFormulaInputState(table.sheetId, {
+        ...table.range,
+        sheetId: table.sheetId,
+    });
+    return (React.createElement("form", { onSubmit: (e) => {
+            e.preventDefault();
+            if (!range) {
+                return;
+            }
+            const rangeError = getResizeTableRangeError(table, range);
+            setError(rangeError);
+            if (!rangeError) {
+                onSubmit(range);
+            }
+        }, className: "m-0 p-0" },
+        React.createElement(Stack, { direction: "vertical", className: "pb-2 gap-2" },
+            React.createElement(FormulaInput, { onChange: (value) => {
+                    // An unparsable range disables OK until the text reads as a range again.
+                    setRange(undefined);
+                    setError(undefined);
+                    formulaInput.onChange(value, (parsed) => {
+                        setRange(parsed);
+                    });
+                }, value: formulaInput.value, required: true }),
+            React.createElement("p", { className: "font-system text-xs text-rnc-muted-foreground m-0" }, "Note: The headers must remain in the same row, and the resulting table range must overlap the original table range."),
+            error ? (React.createElement("p", { role: "alert", className: "font-system text-xs text-rnc-destructive m-0" }, error)) : null),
+        React.createElement("div", { className: "flex gap-1 pt-2" },
+            React.createElement(Button, { type: "submit", variant: "primary", size: "xs", disabled: !range }, "OK"),
+            React.createElement(Button, { size: "xs", onClick: onCancel, type: "button" }, "Cancel"))));
+};
+/**
+ * Excel's "Insert Slicers" dialog: the table's columns as checkboxes; OK creates one table-bound
+ * slicer per checked column (`buildTableSlicers`), placed right of the table.
+ */
+export const InsertSlicerEditor = ({ onCreateSlicer, }) => {
+    const [isOpen, onOpenChange] = useInsertSlicerDialogState();
+    const table = useInsertingSlicer();
+    const focusSheet = useFocusSheet();
+    const closeDialog = useCallback(() => onOpenChange(false), [onOpenChange]);
+    const handleSubmit = useCallback((columnIndexes) => {
+        if (!table) {
+            return;
+        }
+        for (const slicer of buildTableSlicers(table, columnIndexes)) {
+            onCreateSlicer(slicer);
+        }
+        closeDialog();
+    }, [table, onCreateSlicer, closeDialog]);
+    return (React.createElement(Dialog, { modal: false, open: isOpen },
+        React.createElement(DialogContent, { onEscapeKeyDown: closeDialog, onCloseAutoFocus: (e) => {
+                e.preventDefault();
+                focusSheet?.();
+            } },
+            React.createElement(DialogTitle, { className: "rnc-drag-handle cursor-move" }, "Insert Slicers"),
+            React.createElement(DialogDescription, null, "Choose the columns to filter the table by:"),
+            React.createElement(DialogBody, null, table && isOpen ? (React.createElement(InsertSlicerForm
+            // A fresh form per table: its checkboxes are seeded from the table once.
+            , { 
+                // A fresh form per table: its checkboxes are seeded from the table once.
+                key: `${table.sheetId}:${table.id}`, table: table, onSubmit: handleSubmit, onCancel: closeDialog })) : null),
+            React.createElement(DialogCloseButton, { onClick: closeDialog },
                 React.createElement(Cross2Icon, null)))));
 };
-const TableEditorForm = ({ table, sheetId, theme, onSubmit, onCancel, onRemoveTable, }) => {
-    const { values: { title, showRowStripes = true, showColumnStripes = false, filterButton = true, range, totalRow = false, }, errors, handleChange, handleSubmit, setFieldValue, resetForm, } = useFormik({
+const InsertSlicerForm = ({ table, onSubmit, onCancel, }) => {
+    const names = useMemo(() => getTableSlicerColumnNames(table), [table]);
+    const [checked, setChecked] = useState([]);
+    return (React.createElement("form", { onSubmit: (e) => {
+            e.preventDefault();
+            if (checked.length) {
+                onSubmit([...checked].sort((a, b) => a - b));
+            }
+        }, className: "m-0 p-0" },
+        React.createElement(Stack, { direction: "vertical", className: "pb-2 gap-1" }, names.map((name, index) => (React.createElement("label", { key: index, className: "font-system text-sm flex items-center gap-1" },
+            React.createElement("input", { type: "checkbox", name: "slicerColumn", value: index, checked: checked.includes(index), onChange: (e) => setChecked((prev) => e.target.checked
+                    ? [...prev, index]
+                    : prev.filter((i) => i !== index)) }),
+            name)))),
+        React.createElement("div", { className: "flex gap-1 pt-2" },
+            React.createElement(Button, { type: "submit", variant: "primary", size: "xs", disabled: !checked.length }, "OK"),
+            React.createElement(Button, { size: "xs", onClick: onCancel, type: "button" }, "Cancel"))));
+};
+const TableEditorForm = ({ table, tables, namedRanges, sheetId, theme, onSubmit, onCancel, onRemoveTable, }) => {
+    const validationSchema = useMemo(() => createTableSchema(tables?.filter((t) => t.id !== table.id).map((t) => t.title) ?? [], namedRanges?.map((namedRange) => namedRange.name) ?? []), [tables, namedRanges, table.id]);
+    const { values: { title, showRowStripes = true, showColumnStripes = false, showFirstColumn = false, showLastColumn = false, filterButton = true, range, headerRow = true, totalRow = false, }, errors, handleChange, handleSubmit, setFieldValue, resetForm, } = useFormik({
         initialValues: table,
         enableReinitialize: true,
-        validationSchema: tableSchema,
+        validationSchema,
         onSubmit(values) {
             const tableTheme = values.theme ?? "TableStyleLight1";
             let bandedRange = values.bandedRange;
@@ -76,6 +285,16 @@ const TableEditorForm = ({ table, sheetId, theme, onSubmit, onCancel, onRemoveTa
                         });
                     }, value: formulaInput.value, required: true })),
             React.createElement(Stack, { direction: "horizontal", className: "grid grid-cols-2 gap-2" },
+                React.createElement("label", { className: "font-system text-sm flex items-center gap-1" },
+                    React.createElement("input", { type: "checkbox", id: "rnc-header-row-element", checked: headerRow ?? true, name: "headerRow", onChange: (e) => {
+                            setFieldValue("headerRow", e.target.checked);
+                        } }),
+                    "Header row"),
+                React.createElement("label", { className: "font-system text-sm flex items-center gap-1" },
+                    React.createElement("input", { type: "checkbox", id: "rnc-total-row-element", checked: totalRow ?? false, name: "totalRow", onChange: (e) => {
+                            setFieldValue("totalRow", e.target.checked);
+                        } }),
+                    "Show total row"),
                 React.createElement("label", { className: "font-system text-sm flex items-center gap-1" },
                     React.createElement("input", { type: "checkbox", checked: showRowStripes ?? undefined, name: "showRowStripes", onChange: (e) => {
                             setFieldValue("showRowStripes", e.target.checked);
@@ -87,15 +306,20 @@ const TableEditorForm = ({ table, sheetId, theme, onSubmit, onCancel, onRemoveTa
                         } }),
                     "Banded columns"),
                 React.createElement("label", { className: "font-system text-sm flex items-center gap-1" },
-                    React.createElement("input", { type: "checkbox", id: "rnc-filter-button-element", checked: filterButton ?? undefined, name: "filterButton", onChange: (e) => {
-                            setFieldValue("filterButton", e.target.checked);
+                    React.createElement("input", { type: "checkbox", id: "rnc-first-column-element", checked: showFirstColumn ?? false, name: "showFirstColumn", onChange: (e) => {
+                            setFieldValue("showFirstColumn", e.target.checked);
                         } }),
-                    "Show filter button"),
+                    "First column"),
                 React.createElement("label", { className: "font-system text-sm flex items-center gap-1" },
-                    React.createElement("input", { type: "checkbox", id: "rnc-total-row-element", checked: totalRow ?? false, name: "totalRow", onChange: (e) => {
-                            setFieldValue("totalRow", e.target.checked);
+                    React.createElement("input", { type: "checkbox", id: "rnc-last-column-element", checked: showLastColumn ?? false, name: "showLastColumn", onChange: (e) => {
+                            setFieldValue("showLastColumn", e.target.checked);
+                        } }),
+                    "Last column"),
+                React.createElement("label", { className: "font-system text-sm flex items-center gap-1" },
+                    React.createElement("input", { type: "checkbox", id: "rnc-filter-button-element", checked: filterButton ?? undefined, name: "filterButton", disabled: headerRow === false, onChange: (e) => {
+                            setFieldValue("filterButton", e.target.checked);
                         } }),
-                    "Show total row"))),
+                    "Show filter button"))),
         React.createElement("div", { className: "flex gap-1 pt-2" },
             React.createElement(Button, { type: "submit", variant: "primary", size: "xs" }, "Save"),
             React.createElement(Button, { size: "xs", onClick: () => {

package/dist/esm/components/index.d.ts

@@ -10,4 +10,5 @@ export * from "./editors/insert-image-editor";
 export * from "./editors/insert-link-editor";
 export * from "./editors/data-validation-editor";
 export * from "./editors/embed-editor";
+export * from "./editors/slicer-editor";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../components/index.tsx"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../components/index.tsx"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC"}

package/dist/esm/components/index.js

@@ -10,3 +10,4 @@ export * from "./editors/insert-image-editor";
 export * from "./editors/insert-link-editor";
 export * from "./editors/data-validation-editor";
 export * from "./editors/embed-editor";
+export * from "./editors/slicer-editor";

package/dist/esm/constants.d.ts

@@ -13,8 +13,16 @@ export declare const MERGED_CELL_REFUSAL_MESSAGE = "We can't do that to a merged
 export declare const TABLE_SHIFT_REFUSAL_MESSAGE = "This won't work because it would move cells in a table on your worksheet.";
 /** ANC-14 — the shifted band covers only part of a CSE / dynamic array. */
 export declare const ARRAY_REFUSAL_MESSAGE = "You can't change part of an array.";
+/** T-42 — a merge whose region touches a table (Excel refuses every merge inside a table). */
+export declare const TABLE_MERGE_REFUSAL_MESSAGE = "This operation is not allowed. The operation is attempting to shift cells in a table on your worksheet.";
+/** T-17 — a table resize whose new range would overlap another table on the sheet. */
+export declare const TABLE_OVERLAP_REFUSAL_MESSAGE = "A table cannot overlap another table.";
+/** T-17 — a table resize whose new range would cover a merged cell. */
+export declare const TABLE_MERGED_CELLS_REFUSAL_MESSAGE = "A table cannot overlap a range that contains a PivotTable report, query results, protected cells or merged cells.";
+/** T-81 — a fill whose target reaches a table's totals row (Excel's fill handle never extends over it). */
+export declare const TABLE_TOTALS_FILL_REFUSAL_MESSAGE = "This won't work because it would overwrite the totals row of a table on your worksheet.";
 /** Machine-readable refusal codes — the rnc engine's `CommitResult.rejected.code` uses the same set. */
-export type StructuralRefusalCode = "off-sheet-push" | "torn-merge" | "torn-table" | "torn-array";
+export type StructuralRefusalCode = "off-sheet-push" | "torn-merge" | "torn-table" | "torn-array" | "table-merge" | "table-overlap" | "table-merged-cells" | "table-totals-fill";
 export type StructuralRefusal = {
     code: StructuralRefusalCode;
     title: string;

package/dist/esm/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAE1D,2GAA2G;AAC3G,eAAO,MAAM,sBAAsB,ySACqQ,CAAC;AAEzS,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,uCAAuC,CAAC;AAEhF,0DAA0D;AAC1D,eAAO,MAAM,2BAA2B,8EACqC,CAAC;AAE9E,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,uCAAuC,CAAC;AAE1E,wGAAwG;AACxG,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAK7E,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,qBAAqB,KAC1B,iBAID,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAE1D,2GAA2G;AAC3G,eAAO,MAAM,sBAAsB,ySACqQ,CAAC;AAEzS,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,uCAAuC,CAAC;AAEhF,0DAA0D;AAC1D,eAAO,MAAM,2BAA2B,8EACqC,CAAC;AAE9E,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,uCAAuC,CAAC;AAE1E,8FAA8F;AAC9F,eAAO,MAAM,2BAA2B,4GACmE,CAAC;AAE5G,sFAAsF;AACtF,eAAO,MAAM,6BAA6B,0CACD,CAAC;AAE1C,uEAAuE;AACvE,eAAO,MAAM,kCAAkC,sHACsE,CAAC;AAEtH,2GAA2G;AAC3G,eAAO,MAAM,iCAAiC,4FAC6C,CAAC;AAE5F,wGAAwG;AACxG,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,eAAe,GACf,oBAAoB,GACpB,mBAAmB,CAAC;AAExB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAS7E,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,qBAAqB,KAC1B,iBAID,CAAC"}

package/dist/esm/constants.js

@@ -13,11 +13,23 @@ export const MERGED_CELL_REFUSAL_MESSAGE = "We can't do that to a merged cell.";
 export const TABLE_SHIFT_REFUSAL_MESSAGE = "This won't work because it would move cells in a table on your worksheet.";
 /** ANC-14 — the shifted band covers only part of a CSE / dynamic array. */
 export const ARRAY_REFUSAL_MESSAGE = "You can't change part of an array.";
+/** T-42 — a merge whose region touches a table (Excel refuses every merge inside a table). */
+export const TABLE_MERGE_REFUSAL_MESSAGE = "This operation is not allowed. The operation is attempting to shift cells in a table on your worksheet.";
+/** T-17 — a table resize whose new range would overlap another table on the sheet. */
+export const TABLE_OVERLAP_REFUSAL_MESSAGE = "A table cannot overlap another table.";
+/** T-17 — a table resize whose new range would cover a merged cell. */
+export const TABLE_MERGED_CELLS_REFUSAL_MESSAGE = "A table cannot overlap a range that contains a PivotTable report, query results, protected cells or merged cells.";
+/** T-81 — a fill whose target reaches a table's totals row (Excel's fill handle never extends over it). */
+export const TABLE_TOTALS_FILL_REFUSAL_MESSAGE = "This won't work because it would overwrite the totals row of a table on your worksheet.";
 export const STRUCTURAL_REFUSAL_MESSAGES = {
     "off-sheet-push": OFF_SHEET_PUSH_MESSAGE,
     "torn-merge": MERGED_CELL_REFUSAL_MESSAGE,
     "torn-table": TABLE_SHIFT_REFUSAL_MESSAGE,
     "torn-array": ARRAY_REFUSAL_MESSAGE,
+    "table-merge": TABLE_MERGE_REFUSAL_MESSAGE,
+    "table-overlap": TABLE_OVERLAP_REFUSAL_MESSAGE,
+    "table-merged-cells": TABLE_MERGED_CELLS_REFUSAL_MESSAGE,
+    "table-totals-fill": TABLE_TOTALS_FILL_REFUSAL_MESSAGE,
 };
 export const structuralRefusal = (code) => ({
     code,

package/dist/esm/generated-names.d.ts

@@ -1,5 +1,5 @@
 /**
- * Formatters for auto-generated names such as "Sheet1", "Table 1",
+ * Formatters for auto-generated names such as "Sheet1", "Table1",
  * "Column1" and "Copy of Sheet1".
  *
  * Pass `generatedNames` to `useSpreadsheetState` to customize or
@@ -31,11 +31,19 @@ export interface GeneratedNames {
      */
     sheetCopy?: (title: string) => string | undefined;
     /**
-     * Title for a newly created table. Default: `Table ${index}`
+     * Title for a chartsheet created by "Move Chart → New sheet". Default:
+     * `Chart${index}` (Excel's pattern — the first unused number is picked).
+     */
+    chartSheet?: (index: number) => string | undefined;
+    /**
+     * Title for a newly created table. Default: `Table${index}` (Excel's
+     * pattern — no space; the first unused number is picked).
      */
     table?: (index: number) => string | undefined;
     /**
-     * Title for a pasted (copied) table. Default: `Copy of ${title}`
+     * @deprecated No longer applied: a pasted table is named like a new one
+     * (the next free `Table${index}`, via `table`), as in Excel — `Copy of
+     * ${title}` is not a valid table name.
      */
     tableCopy?: (title: string) => string | undefined;
     /**
@@ -45,7 +53,9 @@ export interface GeneratedNames {
 }
 export declare const getGeneratedSheetName: (index: number, generatedNames?: GeneratedNames) => string;
 export declare const getGeneratedSheetCopyName: (title: string, generatedNames?: GeneratedNames) => string;
+export declare const getGeneratedChartSheetName: (index: number, generatedNames?: GeneratedNames) => string;
 export declare const getGeneratedTableName: (index: number, generatedNames?: GeneratedNames) => string;
+/** @deprecated See `GeneratedNames.tableCopy`. */
 export declare const getGeneratedTableCopyName: (title: string, generatedNames?: GeneratedNames) => string;
 export declare const getGeneratedTableColumnName: (index: number, generatedNames?: GeneratedNames) => string;
 //# sourceMappingURL=generated-names.d.ts.map

package/dist/esm/generated-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-names.d.ts","sourceRoot":"","sources":["../../generated-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9C;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9C;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACrD;AAED,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAA2D,CAAC;AAE/D,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAAkE,CAAC;AAEtE,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAA4D,CAAC;AAEhE,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAAkE,CAAC;AAEtE,eAAO,MAAM,2BAA2B,GACtC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAAkE,CAAC"}
+{"version":3,"file":"generated-names.d.ts","sourceRoot":"","sources":["../../generated-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9C;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACnD;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9C;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACrD;AAED,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAA2D,CAAC;AAE/D,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAAkE,CAAC;AAEtE,eAAO,MAAM,0BAA0B,GACrC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAAgE,CAAC;AAEpE,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAA2D,CAAC;AAE/D,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAAkE,CAAC;AAEtE,eAAO,MAAM,2BAA2B,GACtC,OAAO,MAAM,EACb,iBAAiB,cAAc,KAC9B,MAAkE,CAAC"}

package/dist/esm/generated-names.js

@@ -1,5 +1,7 @@
 export const getGeneratedSheetName = (index, generatedNames) => generatedNames?.sheet?.(index) ?? `Sheet${index}`;
 export const getGeneratedSheetCopyName = (title, generatedNames) => generatedNames?.sheetCopy?.(title) ?? `Copy of ${title}`;
-export const getGeneratedTableName = (index, generatedNames) => generatedNames?.table?.(index) ?? `Table ${index}`;
+export const getGeneratedChartSheetName = (index, generatedNames) => generatedNames?.chartSheet?.(index) ?? `Chart${index}`;
+export const getGeneratedTableName = (index, generatedNames) => generatedNames?.table?.(index) ?? `Table${index}`;
+/** @deprecated See `GeneratedNames.tableCopy`. */
 export const getGeneratedTableCopyName = (title, generatedNames) => generatedNames?.tableCopy?.(title) ?? `Copy of ${title}`;
 export const getGeneratedTableColumnName = (index, generatedNames) => generatedNames?.tableColumn?.(index) ?? `Column${index}`;

package/dist/esm/helpers.d.ts

@@ -28,6 +28,11 @@ export declare function combineMapIterators<K, V>(...mapIterators: IterableItera
  * @returns
  */
 export declare function combineMapIteratorsWithFormatting<K, V, F>(...mapIterators: IterableIterator<[K, V, formatting?: F]>[]): IterableIterator<[K, V, formatting?: F]>;
+/**
+ * Default title for a new table — `Table1`, `Table2`, … with the lowest
+ * number no existing table uses (case-insensitive), like Excel.
+ */
+export declare const getNextTableTitle: (tables?: Pick<TableView, "title">[] | null, generatedNames?: GeneratedNames) => string;
 /**
  * Get unique table column name
  * @param columns

package/dist/esm/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EACvD,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,EACnE,gBAAwB,KACvB,OAAO,CAAC,CAAC,CAAC,EAeZ,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,UAAU,GAAG,SAAS,KAC7B,MAAM,IAAI,SAEZ,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,GAAG,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAC1C,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAkB1B;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACvD,GAAG,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAC1D,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAkB1C;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAAE,GAAG,IAAI,EACzB,iBAAiB,cAAc,WAYhC,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,SAAS,EAAE,GAAG,SAAS,EAC/B,aAAa,SAAS,0BAsBvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,WA6BxD,CAAC;AAEF,eAAO,MAAM,oBAAoB,WAAW,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAI7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQxD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EACvD,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,EACnE,gBAAwB,KACvB,OAAO,CAAC,CAAC,CAAC,EAeZ,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,UAAU,GAAG,SAAS,KAC7B,MAAM,IAAI,SAEZ,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,GAAG,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAC1C,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAkB1B;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACvD,GAAG,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAC1D,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAkB1C;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAC1C,iBAAiB,cAAc,WAK9B,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAAE,GAAG,IAAI,EACzB,iBAAiB,cAAc,WAYhC,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,SAAS,EAAE,GAAG,SAAS,EAC/B,aAAa,SAAS,0BAsBvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,WA6BxD,CAAC;AAEF,eAAO,MAAM,oBAAoB,WAAW,CAAC"}

package/dist/esm/helpers.js

@@ -1,4 +1,5 @@
-import { getGeneratedTableColumnName } from "./generated-names";
+import { getNextTableName } from "@rowsncolumns/utils";
+import { getGeneratedTableColumnName, getGeneratedTableName, } from "./generated-names";
 import { defaultCellCoords, defaultSheetId, SheetCell } from "./sheet-cell";
 /**
  * Convert
@@ -77,6 +78,11 @@ export function combineMapIteratorsWithFormatting(...mapIterators) {
         },
     };
 }
+/**
+ * Default title for a new table — `Table1`, `Table2`, … with the lowest
+ * number no existing table uses (case-insensitive), like Excel.
+ */
+export const getNextTableTitle = (tables, generatedNames) => getNextTableName(tables?.map((table) => table.title) ?? [], (index) => getGeneratedTableName(index, generatedNames));
 /**
  * Get unique table column name
  * @param columns

package/dist/esm/hooks/use-on-change-batch.d.ts

@@ -33,11 +33,12 @@ export type UseOnChangeBatchProps<T extends CellData, S extends Sheet = Sheet> =
     onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
     onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
     onChangeTables?: UseSpreadsheetProps<T, S>["onChangeTables"];
+    onChangeCharts?: UseSpreadsheetProps<T, S>["onChangeCharts"];
     onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
     onChangeTableColumn?: (sheetId: number, coords: {
         rowIndex: number;
         columnIndex: number;
-    }, value: string | boolean | undefined, currentTable: TableView | undefined, isRowExpansion: boolean, isColumnExpansion: boolean, range: GridRange) => void;
+    }, value: string | boolean | undefined, currentTable: TableView | undefined, isRowExpansion: boolean, isColumnExpansion: boolean, range: GridRange, headerValues?: (string | boolean | number | null | undefined)[]) => void;
     onChangeCalculatedColumn?: (sheetId: number, coords: {
         rowIndex: number;
         columnIndex: number;
@@ -49,6 +50,22 @@ export type UseOnChangeBatchProps<T extends CellData, S extends Sheet = Sheet> =
     tokenizer?(value: string): ParsedToken[];
     onCommand?: OnCommand;
     generatedNames?: GeneratedNames;
+    /** `useUndoRedo`'s `batchHistory`: the writes and the table growth they trigger undo as one step when wired. */
+    batchHistory?: <R>(action: () => R) => R;
+    /**
+     * Excel's "Include new rows and columns in table" AutoCorrect option: a value typed, pasted or
+     * filled into the row below / column right of a table grows the table. `false` turns the
+     * auto-expansion off (the "Stop Automatically Expanding Tables" smart-tag action).
+     * @default true
+     */
+    autoExpandTables?: boolean;
+    /**
+     * Excel's "Fill formulas in tables to create calculated columns" AutoCorrect option. `false`
+     * leaves a formula typed into a table column a one-cell edit (the "Stop automatically creating
+     * calculated columns" smart-tag action).
+     * @default true
+     */
+    autoCalculatedColumns?: boolean;
 };
-export declare const useOnChangeBatch: <T extends CellData, K extends CellFormat, S extends Sheet = Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, enqueueCalculation, onChangeSheetData, onChangeSheets, onChangeTables, tables, createHistory, getFormattedValue, getUserEnteredValue, getCellDimensions, getRowHeight, isMergedCell, enqueueGraphOperation, getDependents, getSheetName, onChangeCitations, onCommand, generatedNames, }: UseOnChangeBatchProps<T, S>) => (sheetId: number, ranges: GridRange[] | GridRange, values: (string | boolean | number | null | undefined)[][] | string | boolean | number | null | undefined, formatting?: (K | undefined | null)[][] | K | null | undefined, citations?: (string | undefined | null)[][] | string | null | undefined, changeBatchOptions?: ChangeBatchOptions) => void;
+export declare const useOnChangeBatch: <T extends CellData, K extends CellFormat, S extends Sheet = Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, enqueueCalculation, onChangeSheetData, onChangeSheets, onChangeTables, onChangeCharts, tables, createHistory, getFormattedValue, getUserEnteredValue, getCellDimensions, getRowHeight, isMergedCell, enqueueGraphOperation, getDependents, getSheetName, onChangeCitations, onCommand, generatedNames, batchHistory, autoExpandTables, autoCalculatedColumns, }: UseOnChangeBatchProps<T, S>) => (sheetId: number, ranges: GridRange[] | GridRange, values: (string | boolean | number | null | undefined)[][] | string | boolean | number | null | undefined, formatting?: (K | undefined | null)[][] | K | null | undefined, citations?: (string | undefined | null)[][] | string | null | undefined, changeBatchOptions?: ChangeBatchOptions) => void;
 //# sourceMappingURL=use-on-change-batch.d.ts.map

package/dist/esm/hooks/use-on-change-batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-change-batch.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-batch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-on-change-batch.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-change-batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EACV,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,KAAK,EACL,SAAS,EACV,MAAM,2BAA2B,CAAC;AAKnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,GAAG,KAAK,IACrB;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,qBAAqB,CAAC,EAAE,CACtB,EAAE,EAAE,wBAAwB,CAAC,IAAI,CAAC,KAC/B,wBAAwB,GAAG,SAAS,CAAC;IAC1C,iBAAiB,CAAC,EAAE,UAAU,CAC5B,OAAO,kBAAkB,CAC1B,CAAC,mBAAmB,CAAC,CAAC;IACvB,mBAAmB,EAAE,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,CAAC;IACxB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,OAAO,GAAG,SAAS,CAAC;IACzB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IAC3D,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,qBAAqB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC7D,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,cAAc,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,cAAc,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,mBAAmB,CAAC,EAAE,CACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EACjD,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EACnC,YAAY,EAAE,SAAS,GAAG,SAAS,EACnC,cAAc,EAAE,OAAO,EACvB,iBAAiB,EAAE,OAAO,EAC1B,KAAK,EAAE,SAAS,EAChB,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,KAC5D,IAAI,CAAC;IACV,wBAAwB,CAAC,EAAE,CACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EACjD,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EACnC,YAAY,EAAE,SAAS,GAAG,SAAS,KAChC,IAAI,CAAC;IACV,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAChE,2BAA2B,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,EAAE,CAAC;IACpE,YAAY,CAAC,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC;IACjD,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gHAAgH;IAChH,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACzC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,UAAU,EACpB,CAAC,SAAS,KAAK,GAAG,KAAK,EACvB,yaA0BC,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,eAoCf,MAAM,UACP,SAAS,EAAE,GAAG,SAAS,UAE3B,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,GAClD,MAAM,GACN,OAAO,GACP,MAAM,GACN,IAAI,GACJ,SAAS,eACA,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,cAClD,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,uBAClD,kBAAkB,SAgG5C,CAAC"}

package/dist/esm/hooks/use-on-change-batch.js

@@ -4,7 +4,7 @@ import { changeBatch } from "../interface/change-batch";
 import { useCanEditCellRange } from "./use-can-edit-cellrange";
 import { useOnChangeCalculatedColumn } from "./use-on-change-calculated-column";
 import { useOnChangeTableColumn } from "./use-on-change-table-column";
-export const useOnChangeBatch = ({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, enqueueCalculation, onChangeSheetData, onChangeSheets, onChangeTables, tables, createHistory, getFormattedValue, getUserEnteredValue, getCellDimensions, getRowHeight, isMergedCell, enqueueGraphOperation, getDependents, getSheetName, onChangeCitations, onCommand, generatedNames, }) => {
+export const useOnChangeBatch = ({ locale, cellXfsRegistry, sharedStringRegistry, getDataValidationById, enqueueCalculation, onChangeSheetData, onChangeSheets, onChangeTables, onChangeCharts, tables, createHistory, getFormattedValue, getUserEnteredValue, getCellDimensions, getRowHeight, isMergedCell, enqueueGraphOperation, getDependents, getSheetName, onChangeCitations, onCommand, generatedNames, batchHistory = (action) => action(), autoExpandTables = true, autoCalculatedColumns = true, }) => {
     // Allowed values
     const getEffectiveValuesFromRange = useGetEffectiveValuesFromRange();
     const tokenizer = useTokenizer();
@@ -15,12 +15,14 @@ export const useOnChangeBatch = ({ locale, cellXfsRegistry, sharedStringRegistry
         sharedStringRegistry,
         onChangeSheetData,
         onChangeTables,
+        onChangeCharts,
         getDependents,
         enqueueCalculation,
         enqueueGraphOperation,
         createHistory,
         onCommand,
         generatedNames,
+        tables,
     });
     const onChangeCalculatedColumn = useOnChangeCalculatedColumn({
         locale,
@@ -33,6 +35,7 @@ export const useOnChangeBatch = ({ locale, cellXfsRegistry, sharedStringRegistry
         createHistory,
         enqueueCalculation,
         onCommand,
+        autoCalculatedColumns,
     });
     return useCallback((sheetId, ranges, values, formatting, citations, changeBatchOptions) => {
         // Protection enforcement — block batch edits that overlap any
@@ -47,7 +50,12 @@ export const useOnChangeBatch = ({ locale, cellXfsRegistry, sharedStringRegistry
                 return;
             }
         }
-        changeBatch({
+        // A batch that records history opens ONE undo entry: the writes and the table growth /
+        // calculated-column fill they trigger undo together.
+        const runBatch = changeBatchOptions?.enableHistory === false
+            ? (action) => action()
+            : batchHistory;
+        runBatch(() => changeBatch({
             createHistory,
             enqueueCalculation,
             onChangeSheetData,
@@ -71,7 +79,9 @@ export const useOnChangeBatch = ({ locale, cellXfsRegistry, sharedStringRegistry
             getSheetName,
             tables,
             onChangeCitations,
-        })(sheetId, ranges, values, formatting, citations, changeBatchOptions);
+            autoExpandTables,
+            autoCalculatedColumns,
+        })(sheetId, ranges, values, formatting, citations, changeBatchOptions));
         onCommand?.({
             command: "change-batch",
             sheetId,
@@ -80,6 +90,8 @@ export const useOnChangeBatch = ({ locale, cellXfsRegistry, sharedStringRegistry
             formatting,
             citations,
             options: changeBatchOptions,
+            ...(autoExpandTables ? {} : { autoExpandTables }),
+            ...(autoCalculatedColumns ? {} : { autoCalculatedColumns }),
         });
     }, [
         locale,
@@ -95,6 +107,7 @@ export const useOnChangeBatch = ({ locale, cellXfsRegistry, sharedStringRegistry
         onChangeSheets,
         getEffectiveValuesFromRange,
         onChangeTables,
+        onChangeCharts,
         getRowHeight,
         isMergedCell,
         tables,
@@ -107,5 +120,8 @@ export const useOnChangeBatch = ({ locale, cellXfsRegistry, sharedStringRegistry
         onChangeCitations,
         onCommand,
         canEditCellRange,
+        batchHistory,
+        autoExpandTables,
+        autoCalculatedColumns,
     ]);
 };