@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.0

package/dist/cjs/components/editors/table-editor.d.ts

@@ -1,12 +1,68 @@
-import type { SpreadsheetTheme } from "@rowsncolumns/spreadsheet";
+import type { GridRange } from "@rowsncolumns/common-types";
+import type { NamedRange, Slicer, SpreadsheetTheme, TableView } from "@rowsncolumns/spreadsheet";
 import React from "react";
 import type { useSpreadsheetState } from "../../hooks/use-spreadsheet-state";
 type TableEditorProps = {
     sheetId: number;
     theme: SpreadsheetTheme;
+    /**
+     * Every table in the workbook — the name field refuses a rename that
+     * collides with another table's name (case-insensitive, like Excel).
+     */
+    tables?: TableView[];
+    /**
+     * The workbook's defined names — a table name that collides with one is
+     * refused inline, the way the engines refuse it on submit.
+     */
+    namedRanges?: NamedRange[];
     onSubmit: ReturnType<typeof useSpreadsheetState>["onUpdateTable"];
     onRemoveTable?: ReturnType<typeof useSpreadsheetState>["onRemoveTable"];
+    /**
+     * Submits the Create Table dialog (opened by `onRequestCreateTable` — Ctrl+T, Insert → Table,
+     * Format as Table). Without it the create dialog is not rendered.
+     */
+    onCreateTable?: ReturnType<typeof useSpreadsheetState>["onCreateTable"];
+    /**
+     * Submits the Resize Table dialog (opened by `onRequestResizeTable` — Table Design → Resize
+     * Table, the context menu's Table → Resize Table…). Without it the resize dialog is not rendered.
+     */
+    onResizeTable?: ReturnType<typeof useSpreadsheetState>["onResizeTable"];
+    /**
+     * Submits the Insert Slicers dialog (opened by `onRequestInsertSlicer` — Table Design → Insert
+     * Slicer, the context menu's Table → Insert Slicer…): one slicer per checked column. Without it
+     * the dialog is not rendered.
+     */
+    onCreateSlicer?: (slicer: Slicer) => void;
 };
-export declare const TableEditor: ({ sheetId, theme, onSubmit, onRemoveTable, }: TableEditorProps) => React.JSX.Element;
+export declare const TableEditor: ({ sheetId, theme, tables, namedRanges, onSubmit, onRemoveTable, onCreateTable, onResizeTable, onCreateSlicer, }: TableEditorProps) => React.JSX.Element;
+/**
+ * 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 declare const CreateTableEditor: ({ onCreateTable, }: {
+    onCreateTable: NonNullable<TableEditorProps["onCreateTable"]>;
+}) => React.JSX.Element;
+/**
+ * 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 declare 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 declare const getResizeTableRangeError: (table: Pick<TableView, "range">, range: GridRange) => string | undefined;
+/**
+ * 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 declare const ResizeTableEditor: ({ onResizeTable, }: {
+    onResizeTable: NonNullable<TableEditorProps["onResizeTable"]>;
+}) => React.JSX.Element;
+/**
+ * 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 declare const InsertSlicerEditor: ({ onCreateSlicer, }: {
+    onCreateSlicer: NonNullable<TableEditorProps["onCreateSlicer"]>;
+}) => React.JSX.Element;
 export {};
 //# sourceMappingURL=table-editor.d.ts.map

package/dist/cjs/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/cjs/components/editors/table-editor.js

@@ -1,14 +1,18 @@
-import { __assign, __read } from "tslib";
+import { __assign, __read, __spreadArray, __values } from "tslib";
 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";
+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 var TableEditor = function (_a) {
-    var sheetId = _a.sheetId, theme = _a.theme, onSubmit = _a.onSubmit, onRemoveTable = _a.onRemoveTable;
+    var sheetId = _a.sheetId, theme = _a.theme, tables = _a.tables, namedRanges = _a.namedRanges, onSubmit = _a.onSubmit, onRemoveTable = _a.onRemoveTable, onCreateTable = _a.onCreateTable, onResizeTable = _a.onResizeTable, onCreateSlicer = _a.onCreateSlicer;
     var _b = __read(useEditTableDialogState(), 2), isOpen = _b[0], onOpenChange = _b[1];
     var setFormulaMode = useSetFormulaMode();
     var setFormulaSelections = useSetFormulaSelections();
@@ -24,25 +28,247 @@ export var TableEditor = function (_a) {
         onSubmit === null || onSubmit === void 0 ? void 0 : 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: function (e) {
+                    e.preventDefault();
+                    focusSheet === null || focusSheet === void 0 ? void 0 : 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: function () {
+                        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 var CreateTableEditor = function (_a) {
+    var onCreateTable = _a.onCreateTable;
+    var _b = __read(useCreateTableDialogState(), 2), isOpen = _b[0], onOpenChange = _b[1];
+    var request = useCreatingTable();
+    var setFormulaMode = useSetFormulaMode();
+    var setFormulaSelections = useSetFormulaSelections();
+    var focusSheet = useFocusSheet();
+    var closeDialog = useCallback(function () {
+        setFormulaMode(false);
+        setFormulaSelections([]);
+        onOpenChange(false);
+    }, [setFormulaMode, setFormulaSelections, onOpenChange]);
+    var handleSubmit = useCallback(function (range, hasHeaders) {
+        if (!request) {
+            return;
+        }
+        onCreateTable(request.sheetId, request.activeCell, [{ range: range }], { range: range }, request.theme, request.bandedRange, { hasHeaders: hasHeaders });
+        closeDialog();
+    }, [request, onCreateTable, closeDialog]);
     return (React.createElement(Dialog, { modal: false, open: isOpen },
         React.createElement(DialogContent, { onEscapeKeyDown: closeDialog, onCloseAutoFocus: function (e) {
                 e.preventDefault();
                 focusSheet === null || focusSheet === void 0 ? void 0 : 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: function () {
-                    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: "".concat(request.sheetId, ":").concat(request.range.startRowIndex, ":").concat(request.range.startColumnIndex, ":").concat(request.range.endRowIndex, ":").concat(request.range.endColumnIndex), request: request, onSubmit: handleSubmit, onCancel: closeDialog })) : null),
+            React.createElement(DialogCloseButton, { onClick: closeDialog },
+                React.createElement(Cross2Icon, null)))));
+};
+var CreateTableForm = function (_a) {
+    var request = _a.request, onSubmit = _a.onSubmit, onCancel = _a.onCancel;
+    var _b = __read(useState(request.range), 2), range = _b[0], setRange = _b[1];
+    var _c = __read(useState(request.hasHeaders), 2), hasHeaders = _c[0], setHasHeaders = _c[1];
+    var formulaInput = useFormulaInputState(request.sheetId, __assign(__assign({}, request.range), { sheetId: request.sheetId }));
+    return (React.createElement("form", { onSubmit: function (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: function (value) {
+                    // An unparsable range disables OK until the text reads as a range again.
+                    setRange(undefined);
+                    formulaInput.onChange(value, function (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: function (e) { return 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 var 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 var getResizeTableRangeError = function (table, range) {
+    var 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 var ResizeTableEditor = function (_a) {
+    var onResizeTable = _a.onResizeTable;
+    var _b = __read(useResizeTableDialogState(), 2), isOpen = _b[0], onOpenChange = _b[1];
+    var table = useResizingTable();
+    var setFormulaMode = useSetFormulaMode();
+    var setFormulaSelections = useSetFormulaSelections();
+    var focusSheet = useFocusSheet();
+    var closeDialog = useCallback(function () {
+        setFormulaMode(false);
+        setFormulaSelections([]);
+        onOpenChange(false);
+    }, [setFormulaMode, setFormulaSelections, onOpenChange]);
+    var handleSubmit = useCallback(function (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: function (e) {
+                e.preventDefault();
+                focusSheet === null || focusSheet === void 0 ? void 0 : 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: "".concat(table.sheetId, ":").concat(table.id, ":").concat(table.range.startRowIndex, ":").concat(table.range.startColumnIndex, ":").concat(table.range.endRowIndex, ":").concat(table.range.endColumnIndex), table: table, onSubmit: handleSubmit, onCancel: closeDialog })) : null),
+            React.createElement(DialogCloseButton, { onClick: closeDialog },
+                React.createElement(Cross2Icon, null)))));
+};
+var ResizeTableForm = function (_a) {
+    var table = _a.table, onSubmit = _a.onSubmit, onCancel = _a.onCancel;
+    var _b = __read(useState(table.range), 2), range = _b[0], setRange = _b[1];
+    var _c = __read(useState(), 2), error = _c[0], setError = _c[1];
+    var formulaInput = useFormulaInputState(table.sheetId, __assign(__assign({}, table.range), { sheetId: table.sheetId }));
+    return (React.createElement("form", { onSubmit: function (e) {
+            e.preventDefault();
+            if (!range) {
+                return;
+            }
+            var 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: function (value) {
+                    // An unparsable range disables OK until the text reads as a range again.
+                    setRange(undefined);
+                    setError(undefined);
+                    formulaInput.onChange(value, function (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 var InsertSlicerEditor = function (_a) {
+    var onCreateSlicer = _a.onCreateSlicer;
+    var _b = __read(useInsertSlicerDialogState(), 2), isOpen = _b[0], onOpenChange = _b[1];
+    var table = useInsertingSlicer();
+    var focusSheet = useFocusSheet();
+    var closeDialog = useCallback(function () { return onOpenChange(false); }, [onOpenChange]);
+    var handleSubmit = useCallback(function (columnIndexes) {
+        var e_1, _a;
+        if (!table) {
+            return;
+        }
+        try {
+            for (var _b = __values(buildTableSlicers(table, columnIndexes)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var slicer = _c.value;
+                onCreateSlicer(slicer);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        closeDialog();
+    }, [table, onCreateSlicer, closeDialog]);
+    return (React.createElement(Dialog, { modal: false, open: isOpen },
+        React.createElement(DialogContent, { onEscapeKeyDown: closeDialog, onCloseAutoFocus: function (e) {
+                e.preventDefault();
+                focusSheet === null || focusSheet === void 0 ? void 0 : 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: "".concat(table.sheetId, ":").concat(table.id), table: table, onSubmit: handleSubmit, onCancel: closeDialog })) : null),
+            React.createElement(DialogCloseButton, { onClick: closeDialog },
                 React.createElement(Cross2Icon, null)))));
 };
+var InsertSlicerForm = function (_a) {
+    var table = _a.table, onSubmit = _a.onSubmit, onCancel = _a.onCancel;
+    var names = useMemo(function () { return getTableSlicerColumnNames(table); }, [table]);
+    var _b = __read(useState([]), 2), checked = _b[0], setChecked = _b[1];
+    return (React.createElement("form", { onSubmit: function (e) {
+            e.preventDefault();
+            if (checked.length) {
+                onSubmit(__spreadArray([], __read(checked), false).sort(function (a, b) { return a - b; }));
+            }
+        }, className: "m-0 p-0" },
+        React.createElement(Stack, { direction: "vertical", className: "pb-2 gap-1" }, names.map(function (name, index) { return (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: function (e) {
+                    return setChecked(function (prev) {
+                        return e.target.checked
+                            ? __spreadArray(__spreadArray([], __read(prev), false), [index], false) : prev.filter(function (i) { return 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"))));
+};
 var TableEditorForm = function (_a) {
-    var table = _a.table, sheetId = _a.sheetId, theme = _a.theme, onSubmit = _a.onSubmit, onCancel = _a.onCancel, onRemoveTable = _a.onRemoveTable;
+    var table = _a.table, tables = _a.tables, namedRanges = _a.namedRanges, sheetId = _a.sheetId, theme = _a.theme, onSubmit = _a.onSubmit, onCancel = _a.onCancel, onRemoveTable = _a.onRemoveTable;
+    var validationSchema = useMemo(function () {
+        var _a, _b;
+        return createTableSchema((_a = tables === null || tables === void 0 ? void 0 : tables.filter(function (t) { return t.id !== table.id; }).map(function (t) { return t.title; })) !== null && _a !== void 0 ? _a : [], (_b = namedRanges === null || namedRanges === void 0 ? void 0 : namedRanges.map(function (namedRange) { return namedRange.name; })) !== null && _b !== void 0 ? _b : []);
+    }, [tables, namedRanges, table.id]);
     var _b = useFormik({
         initialValues: table,
         enableReinitialize: true,
-        validationSchema: tableSchema,
+        validationSchema: validationSchema,
         onSubmit: function (values) {
             var _a;
             var tableTheme = (_a = values.theme) !== null && _a !== void 0 ? _a : "TableStyleLight1";
@@ -61,7 +287,7 @@ var TableEditorForm = function (_a) {
                 onSubmit === null || onSubmit === void 0 ? void 0 : onSubmit(sheetId, newTable.id, newTable);
             }
         },
-    }), _c = _b.values, title = _c.title, _d = _c.showRowStripes, showRowStripes = _d === void 0 ? true : _d, _e = _c.showColumnStripes, showColumnStripes = _e === void 0 ? false : _e, _f = _c.filterButton, filterButton = _f === void 0 ? true : _f, range = _c.range, _g = _c.totalRow, totalRow = _g === void 0 ? false : _g, errors = _b.errors, handleChange = _b.handleChange, handleSubmit = _b.handleSubmit, setFieldValue = _b.setFieldValue, resetForm = _b.resetForm;
+    }), _c = _b.values, title = _c.title, _d = _c.showRowStripes, showRowStripes = _d === void 0 ? true : _d, _e = _c.showColumnStripes, showColumnStripes = _e === void 0 ? false : _e, _f = _c.showFirstColumn, showFirstColumn = _f === void 0 ? false : _f, _g = _c.showLastColumn, showLastColumn = _g === void 0 ? false : _g, _h = _c.filterButton, filterButton = _h === void 0 ? true : _h, range = _c.range, _j = _c.headerRow, headerRow = _j === void 0 ? true : _j, _k = _c.totalRow, totalRow = _k === void 0 ? false : _k, errors = _b.errors, handleChange = _b.handleChange, handleSubmit = _b.handleSubmit, setFieldValue = _b.setFieldValue, resetForm = _b.resetForm;
     // Formula input helper
     var formulaInput = useFormulaInputState(sheetId, __assign(__assign({}, range), { sheetId: sheetId }));
     return (React.createElement("form", { onSubmit: handleSubmit, className: "m-0 p-0" },
@@ -77,6 +303,16 @@ var TableEditorForm = function (_a) {
                         });
                     }, 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 !== null && headerRow !== void 0 ? headerRow : true, name: "headerRow", onChange: function (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 !== null && totalRow !== void 0 ? totalRow : false, name: "totalRow", onChange: function (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 !== null && showRowStripes !== void 0 ? showRowStripes : undefined, name: "showRowStripes", onChange: function (e) {
                             setFieldValue("showRowStripes", e.target.checked);
@@ -88,15 +324,20 @@ var TableEditorForm = function (_a) {
                         } }),
                     "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 !== null && filterButton !== void 0 ? filterButton : undefined, name: "filterButton", onChange: function (e) {
-                            setFieldValue("filterButton", e.target.checked);
+                    React.createElement("input", { type: "checkbox", id: "rnc-first-column-element", checked: showFirstColumn !== null && showFirstColumn !== void 0 ? showFirstColumn : false, name: "showFirstColumn", onChange: function (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 !== null && totalRow !== void 0 ? totalRow : false, name: "totalRow", onChange: function (e) {
-                            setFieldValue("totalRow", e.target.checked);
+                    React.createElement("input", { type: "checkbox", id: "rnc-last-column-element", checked: showLastColumn !== null && showLastColumn !== void 0 ? showLastColumn : false, name: "showLastColumn", onChange: function (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 !== null && filterButton !== void 0 ? filterButton : undefined, name: "filterButton", disabled: headerRow === false, onChange: function (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: function () {

package/dist/cjs/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/cjs/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/cjs/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/cjs/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/cjs/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/cjs/constants.js

@@ -13,11 +13,23 @@ export var MERGED_CELL_REFUSAL_MESSAGE = "We can't do that to a merged cell.";
 export var 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 var 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 var 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 var TABLE_OVERLAP_REFUSAL_MESSAGE = "A table cannot overlap another table.";
+/** T-17 — a table resize whose new range would cover a merged cell. */
+export var 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 var TABLE_TOTALS_FILL_REFUSAL_MESSAGE = "This won't work because it would overwrite the totals row of a table on your worksheet.";
 export var 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 var structuralRefusal = function (code) { return ({
     code: code,

package/dist/cjs/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/cjs/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/cjs/generated-names.js

@@ -1,5 +1,7 @@
 export var getGeneratedSheetName = function (index, generatedNames) { var _a, _b; return (_b = (_a = generatedNames === null || generatedNames === void 0 ? void 0 : generatedNames.sheet) === null || _a === void 0 ? void 0 : _a.call(generatedNames, index)) !== null && _b !== void 0 ? _b : "Sheet".concat(index); };
 export var getGeneratedSheetCopyName = function (title, generatedNames) { var _a, _b; return (_b = (_a = generatedNames === null || generatedNames === void 0 ? void 0 : generatedNames.sheetCopy) === null || _a === void 0 ? void 0 : _a.call(generatedNames, title)) !== null && _b !== void 0 ? _b : "Copy of ".concat(title); };
-export var getGeneratedTableName = function (index, generatedNames) { var _a, _b; return (_b = (_a = generatedNames === null || generatedNames === void 0 ? void 0 : generatedNames.table) === null || _a === void 0 ? void 0 : _a.call(generatedNames, index)) !== null && _b !== void 0 ? _b : "Table ".concat(index); };
+export var getGeneratedChartSheetName = function (index, generatedNames) { var _a, _b; return (_b = (_a = generatedNames === null || generatedNames === void 0 ? void 0 : generatedNames.chartSheet) === null || _a === void 0 ? void 0 : _a.call(generatedNames, index)) !== null && _b !== void 0 ? _b : "Chart".concat(index); };
+export var getGeneratedTableName = function (index, generatedNames) { var _a, _b; return (_b = (_a = generatedNames === null || generatedNames === void 0 ? void 0 : generatedNames.table) === null || _a === void 0 ? void 0 : _a.call(generatedNames, index)) !== null && _b !== void 0 ? _b : "Table".concat(index); };
+/** @deprecated See `GeneratedNames.tableCopy`. */
 export var getGeneratedTableCopyName = function (title, generatedNames) { var _a, _b; return (_b = (_a = generatedNames === null || generatedNames === void 0 ? void 0 : generatedNames.tableCopy) === null || _a === void 0 ? void 0 : _a.call(generatedNames, title)) !== null && _b !== void 0 ? _b : "Copy of ".concat(title); };
 export var getGeneratedTableColumnName = function (index, generatedNames) { var _a, _b; return (_b = (_a = generatedNames === null || generatedNames === void 0 ? void 0 : generatedNames.tableColumn) === null || _a === void 0 ? void 0 : _a.call(generatedNames, index)) !== null && _b !== void 0 ? _b : "Column".concat(index); };

package/dist/cjs/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/cjs/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/cjs/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
@@ -88,6 +89,14 @@ export function combineMapIteratorsWithFormatting() {
         },
         _a;
 }
+/**
+ * Default title for a new table — `Table1`, `Table2`, … with the lowest
+ * number no existing table uses (case-insensitive), like Excel.
+ */
+export var getNextTableTitle = function (tables, generatedNames) {
+    var _a;
+    return getNextTableName((_a = tables === null || tables === void 0 ? void 0 : tables.map(function (table) { return table.title; })) !== null && _a !== void 0 ? _a : [], function (index) { return getGeneratedTableName(index, generatedNames); });
+};
 /**
  * Get unique table column name
  * @param columns