@rowsncolumns/spreadsheet-state 28.0.68 → 28.0.70

package/dist/cjs/hooks/use-on-copy.d.ts

@@ -5,6 +5,13 @@ import type { BandedRange, TableView } from "@rowsncolumns/spreadsheet";
 import { type CellData, type CellFormat, type SelectionAttributes } from "@rowsncolumns/spreadsheet";
 import type { CellXfs, SharedStringValue, SharedStrings } from "../types";
 import type { useSheetProperties } from "./use-sheet-properties";
+/**
+ * Excel/Sheets copy a multi-area selection only when every area spans the same
+ * rows (areas sit side by side, left to right) or the same columns (areas stack,
+ * top to bottom). Returns the row and column indexes of the merged rectangle, or
+ * undefined for any other shape.
+ */
+export declare const getCopiedRowsAndColumns: (copiedSelections: SelectionArea<SelectionAttributes>[]) => [rows: number[], columns: number[]] | undefined;
 type UseOnCopyProps<T extends CellData> = {
     theme?: SpreadsheetTheme;
     merges?: GridRange[] | null;
@@ -43,7 +50,7 @@ export type CopySchema<T extends CellData> = {
  * @param param0
  * @returns
  */
-export declare const useOnCopy: <T extends CellData>({ theme, merges, tables: sheetTables, bandedRanges, getFormattedValue, getCellData, getColumnWidth, getRowHeight, cellXfs, sharedStrings, getEffectiveFormat, isHiddenRow, isColumnHidden, }: UseOnCopyProps<T>) => (e: ClipboardEvent | undefined, sheetId: number, copiedSelections: SelectionArea<SelectionAttributes>[]) => void;
+export declare const useOnCopy: <T extends CellData>({ theme, merges, tables: sheetTables, bandedRanges, getFormattedValue, getCellData, getColumnWidth, getRowHeight, cellXfs, sharedStrings, getEffectiveFormat, isHiddenRow, isColumnHidden, }: UseOnCopyProps<T>) => (e: ClipboardEvent | undefined, sheetId: number, copiedSelections: SelectionArea<SelectionAttributes>[], isCutOperation?: boolean) => boolean;
 export declare const useMergedCellMap: (merges?: GridRange[] | null) => Map<string, [isMasterCell: boolean, readonly [rowspan: number, colspan: number]]>;
 export {};
 //# sourceMappingURL=use-on-copy.d.ts.map

package/dist/cjs/hooks/use-on-copy.d.ts.map

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

package/dist/cjs/hooks/use-on-copy.js

@@ -1,8 +1,9 @@
-import { __assign, __read, __values } from "tslib";
+import { __assign, __read, __spreadArray, __values } from "tslib";
 import { areaInsideArea, cellIdentifier, } from "@rowsncolumns/grid";
 import { getBandedCells, getStringifiedColor, } from "@rowsncolumns/spreadsheet";
 import { cellToAddress, getStyleId, getCellUserEnteredValue, getExtendedValueFormula, isNil, iterateCellsInRange, } from "@rowsncolumns/utils";
 import { useCallback, useMemo } from "react";
+import { useShowError } from "../atoms/error-state.atom";
 import { isStyleReference } from "../sheet-cell";
 var escapeHtmlAttribute = function (value) {
     return value
@@ -12,6 +13,74 @@ var escapeHtmlAttribute = function (value) {
         .replace(/</g, "&lt;")
         .replace(/>/g, "&gt;");
 };
+var MULTIPLE_SELECTIONS_ERROR = "This action won't work on multiple selections.";
+/**
+ * Excel/Sheets copy a multi-area selection only when every area spans the same
+ * rows (areas sit side by side, left to right) or the same columns (areas stack,
+ * top to bottom). Returns the row and column indexes of the merged rectangle, or
+ * undefined for any other shape.
+ */
+export var getCopiedRowsAndColumns = function (copiedSelections) {
+    var e_1, _a, e_2, _b;
+    var ranges = copiedSelections.map(function (_a) {
+        var range = _a.range;
+        return range;
+    });
+    var _c = __read(ranges, 1), first = _c[0];
+    if (!first) {
+        return [[], []];
+    }
+    var sameRows = ranges.every(function (range) {
+        return range.startRowIndex === first.startRowIndex &&
+            range.endRowIndex === first.endRowIndex;
+    });
+    var sameColumns = ranges.every(function (range) {
+        return range.startColumnIndex === first.startColumnIndex &&
+            range.endColumnIndex === first.endColumnIndex;
+    });
+    if (!sameRows && !sameColumns) {
+        return undefined;
+    }
+    var rowRanges = sameRows
+        ? [first]
+        : __spreadArray([], __read(ranges), false).sort(function (a, b) { return a.startRowIndex - b.startRowIndex; });
+    var columnRanges = sameColumns
+        ? [first]
+        : __spreadArray([], __read(ranges), false).sort(function (a, b) { return a.startColumnIndex - b.startColumnIndex; });
+    var rows = [];
+    try {
+        for (var rowRanges_1 = __values(rowRanges), rowRanges_1_1 = rowRanges_1.next(); !rowRanges_1_1.done; rowRanges_1_1 = rowRanges_1.next()) {
+            var _d = rowRanges_1_1.value, startRowIndex = _d.startRowIndex, endRowIndex = _d.endRowIndex;
+            for (var rowIndex = startRowIndex; rowIndex <= endRowIndex; rowIndex++) {
+                rows.push(rowIndex);
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (rowRanges_1_1 && !rowRanges_1_1.done && (_a = rowRanges_1.return)) _a.call(rowRanges_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    var columns = [];
+    try {
+        for (var columnRanges_1 = __values(columnRanges), columnRanges_1_1 = columnRanges_1.next(); !columnRanges_1_1.done; columnRanges_1_1 = columnRanges_1.next()) {
+            var _e = columnRanges_1_1.value, startColumnIndex = _e.startColumnIndex, endColumnIndex = _e.endColumnIndex;
+            for (var columnIndex = startColumnIndex; columnIndex <= endColumnIndex; columnIndex++) {
+                columns.push(columnIndex);
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (columnRanges_1_1 && !columnRanges_1_1.done && (_b = columnRanges_1.return)) _b.call(columnRanges_1);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return [rows, columns];
+};
 /**
  * Called when user copies a selection from sheet
  * 1. User can copy from any cell
@@ -23,9 +92,20 @@ export var useOnCopy = function (_a) {
     var theme = _a.theme, merges = _a.merges, sheetTables = _a.tables, bandedRanges = _a.bandedRanges, getFormattedValue = _a.getFormattedValue, getCellData = _a.getCellData, getColumnWidth = _a.getColumnWidth, getRowHeight = _a.getRowHeight, cellXfs = _a.cellXfs, sharedStrings = _a.sharedStrings, getEffectiveFormat = _a.getEffectiveFormat, isHiddenRow = _a.isHiddenRow, isColumnHidden = _a.isColumnHidden;
     // Merge cell map
     var mergedCellMap = useMergedCellMap(merges);
-    return useCallback(function (e, sheetId, copiedSelections) {
-        var e_1, _a;
-        var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
+    var showError = useShowError();
+    return useCallback(function (e, sheetId, copiedSelections, isCutOperation) {
+        var e_3, _a, e_4, _b, e_5, _c;
+        var _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
+        // Excel refuses to cut a multi-area selection, and only copies one whose
+        // areas share the same rows or the same columns.
+        var rowsAndColumns = isCutOperation && copiedSelections.length > 1
+            ? undefined
+            : getCopiedRowsAndColumns(copiedSelections);
+        if (!rowsAndColumns) {
+            showError({ message: MULTIPLE_SELECTIONS_ERROR });
+            return false;
+        }
+        var _0 = __read(rowsAndColumns, 2), rows = _0[0], columns = _0[1];
         var isRowHidden = isHiddenRow !== null && isHiddenRow !== void 0 ? isHiddenRow : (function () { return false; });
         var isColHidden = isColumnHidden !== null && isColumnHidden !== void 0 ? isColumnHidden : (function () { return false; });
         // Table styling (header fill, banded row/column fills, table borders)
@@ -76,33 +156,42 @@ export var useOnCopy = function (_a) {
             }
         };
         var colGroups = "<colgroup>";
-        copiedSelections.forEach(function (_a) {
-            var range = _a.range;
-            var startColumnIndex = range.startColumnIndex, endColumnIndex = range.endColumnIndex;
-            for (var columnIndex = startColumnIndex; columnIndex <= endColumnIndex; columnIndex++) {
+        try {
+            for (var columns_1 = __values(columns), columns_1_1 = columns_1.next(); !columns_1_1.done; columns_1_1 = columns_1.next()) {
+                var columnIndex = columns_1_1.value;
                 if (isColHidden(sheetId, columnIndex))
                     continue;
                 var cellWidth = getColumnWidth(sheetId, columnIndex);
                 colGroups += "<col width=\"".concat(cellWidth, "\" />");
             }
-        });
+        }
+        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+        finally {
+            try {
+                if (columns_1_1 && !columns_1_1.done && (_a = columns_1.return)) _a.call(columns_1);
+            }
+            finally { if (e_3) throw e_3.error; }
+        }
         colGroups += "</colgroup>";
         var htmlString = "<html xmlns:v=\"urn:schemas-microsoft-com:vml\"\n        xmlns:o=\"urn:schemas-microsoft-com:office:office\"\n        xmlns:x=\"urn:schemas-microsoft-com:office:excel\"\n        xmlns=\"http://www.w3.org/TR/REC-html40\">\n            <meta http-equiv=Content-Type content=\"text/html; charset=utf-8\">\n            <style>\n              <!--table{mso-displayed-decimal-separator:\".\"; mso-displayed-thousand-separator:\",\";}tr{mso-height-source:auto;}col{mso-width-source:auto;}-->\n            </style>\n            <style type=\"text/css\"><!--td {border: 1px solid #cccccc;}br {mso-data-placement:same-cell;}--></style><body>\n          <table xmlns=\"http://www.w3.org/1999/xhtml\" cellspacing=\"0\" cellpadding=\"0\" dir=\"ltr\" border=\"1\" style=\"table-layout:fixed;font-size:10pt;font-family:Arial;width:0px;border-collapse:collapse;border:none\">".concat(colGroups, "<tbody>");
-        var _loop_1 = function (range) {
-            var startRowIndex = range.startRowIndex, startColumnIndex = range.startColumnIndex, endColumnIndex = range.endColumnIndex, endRowIndex = range.endRowIndex;
-            /* Check if user is copying a table */
+        /* Check if user is copying a table */
+        if (copiedSelections.length === 1) {
+            var range_1 = copiedSelections[0].range;
             var table = sheetTables === null || sheetTables === void 0 ? void 0 : sheetTables.find(function (table) {
-                return areaInsideArea(table.range, range) && table.sheetId === sheetId;
+                return areaInsideArea(table.range, range_1) && table.sheetId === sheetId;
             });
             if (table) {
                 // We need to set a rowDelta and colDelta
-                var rowDelta = table.range.startRowIndex - range.startRowIndex;
-                var colDelta = table.range.startColumnIndex - range.startColumnIndex;
+                var rowDelta = table.range.startRowIndex - range_1.startRowIndex;
+                var colDelta = table.range.startColumnIndex - range_1.startColumnIndex;
                 // Add table
                 tables.push(__assign(__assign({}, table), { rowDelta: rowDelta, colDelta: colDelta }));
             }
+        }
+        try {
             /* Iterate over all cells */
-            for (var rowIndex = startRowIndex; rowIndex <= endRowIndex; rowIndex++) {
+            for (var rows_1 = __values(rows), rows_1_1 = rows_1.next(); !rows_1_1.done; rows_1_1 = rows_1.next()) {
+                var rowIndex = rows_1_1.value;
                 if (isRowHidden(sheetId, rowIndex)) {
                     continue;
                 }
@@ -110,129 +199,139 @@ export var useOnCopy = function (_a) {
                 htmlString += "<tr style=\"height:".concat(rowHeight, "px\">");
                 var csvRow = [];
                 var jsonRow = [];
-                for (var columnIndex = startColumnIndex; columnIndex <= endColumnIndex; columnIndex++) {
-                    if (isColHidden(sheetId, columnIndex)) {
-                        continue;
-                    }
-                    var mergedCellInfo = mergedCellMap.get(cellIdentifier(rowIndex, columnIndex));
-                    var isMasterCell = mergedCellInfo ? mergedCellInfo[0] : true;
-                    if (!isMasterCell) {
+                try {
+                    for (var columns_2 = (e_5 = void 0, __values(columns)), columns_2_1 = columns_2.next(); !columns_2_1.done; columns_2_1 = columns_2.next()) {
+                        var columnIndex = columns_2_1.value;
+                        if (isColHidden(sheetId, columnIndex)) {
+                            continue;
+                        }
+                        var mergedCellInfo = mergedCellMap.get(cellIdentifier(rowIndex, columnIndex));
+                        var isMasterCell = mergedCellInfo ? mergedCellInfo[0] : true;
+                        if (!isMasterCell) {
+                            jsonRow.push({
+                                data: undefined,
+                            });
+                            continue;
+                        }
+                        var _1 = __read(mergedCellInfo
+                            ? mergedCellInfo[1]
+                            : [1, 1], 2), rowspan = _1[0], colspan = _1[1];
+                        var formattedValue = (_d = getFormattedValue(sheetId, rowIndex, columnIndex)) !== null && _d !== void 0 ? _d : "";
+                        var cellData = getCellData(sheetId, rowIndex, columnIndex);
+                        var normalizedCellData = cellData;
+                        if (cellData && typeof cellData === "object") {
+                            normalizedCellData = __assign({}, cellData);
+                            if (!isNil(normalizedCellData.ss)) {
+                                normalizedCellData.ss = collectSharedString(String(normalizedCellData.ss));
+                            }
+                            collectCellXfs(normalizedCellData.uf);
+                            collectCellXfs(normalizedCellData.ef);
+                        }
+                        var formula = getExtendedValueFormula(getCellUserEnteredValue(cellData));
+                        var origin_1 = (_e = cellToAddress({ rowIndex: rowIndex, columnIndex: columnIndex })) !== null && _e !== void 0 ? _e : "".concat(rowIndex, ":").concat(columnIndex);
+                        var formulaAttr = formula
+                            ? " data-sheets-formula=\"".concat(escapeHtmlAttribute(formula), "\" data-formula=\"").concat(escapeHtmlAttribute(formula), "\" data-sheets-formula-origin=\"").concat(escapeHtmlAttribute(origin_1), "\" data-formula-origin=\"").concat(escapeHtmlAttribute(origin_1), "\"")
+                            : "";
+                        var effectiveFormat = getEffectiveFormat === null || getEffectiveFormat === void 0 ? void 0 : getEffectiveFormat(sheetId, rowIndex, columnIndex);
+                        var bandedFormat = bandedCells === null || bandedCells === void 0 ? void 0 : bandedCells.get(cellIdentifier(rowIndex, columnIndex));
+                        var numberFormatType = (_f = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.numberFormat) === null || _f === void 0 ? void 0 : _f.type;
+                        var numberFormatPattern = (_g = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.numberFormat) === null || _g === void 0 ? void 0 : _g.pattern;
+                        var numberFormatAttr = numberFormatType
+                            ? " data-sheets-numberformat-type=\"".concat(escapeHtmlAttribute(numberFormatType), "\"").concat(numberFormatPattern
+                                ? " data-sheets-numberformat-pattern=\"".concat(escapeHtmlAttribute(numberFormatPattern), "\"")
+                                : "")
+                            : "";
+                        // Alignment is encoded as data attributes so paste doesn't have
+                        // to trust `getComputedStyle().textAlign`, which fabricates a
+                        // CSS-spec default of `"start"` even when the value was never set.
+                        var horizontalAlignment = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.horizontalAlignment;
+                        var verticalAlignment = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.verticalAlignment;
+                        var alignmentAttr = "".concat(horizontalAlignment
+                            ? " data-sheets-horizontal-alignment=\"".concat(escapeHtmlAttribute(horizontalAlignment), "\"")
+                            : "").concat(verticalAlignment
+                            ? " data-sheets-vertical-alignment=\"".concat(escapeHtmlAttribute(verticalAlignment), "\"")
+                            : "");
+                        // Csv
+                        csvRow.push(formattedValue);
+                        // Style
+                        var isItalic = (_h = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _h === void 0 ? void 0 : _h.italic;
+                        var isBold = (_j = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _j === void 0 ? void 0 : _j.bold;
+                        var isUnderline = (_k = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _k === void 0 ? void 0 : _k.underline;
+                        var isStrikeThrough = (_l = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _l === void 0 ? void 0 : _l.strikethrough;
+                        var baselineOffset = (_m = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _m === void 0 ? void 0 : _m.baselineOffset;
+                        // Cell-level formatting wins over the banded (table style) layer,
+                        // matching the canvas grid's merge order.
+                        var cellBorders = (_o = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.borders) !== null && _o !== void 0 ? _o : bandedFormat === null || bandedFormat === void 0 ? void 0 : bandedFormat.borders;
+                        var borderTop = cellBorders === null || cellBorders === void 0 ? void 0 : cellBorders.top;
+                        var borderBottom = cellBorders === null || cellBorders === void 0 ? void 0 : cellBorders.bottom;
+                        var borderLeft = cellBorders === null || cellBorders === void 0 ? void 0 : cellBorders.left;
+                        var borderRight = cellBorders === null || cellBorders === void 0 ? void 0 : cellBorders.right;
+                        var textDecoration = "".concat(isUnderline ? "underline" : "", " ").concat(isStrikeThrough ? "line-through" : "").trim();
+                        var wordWrap = (effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.wrapStrategy) === "wrap";
+                        var style = theme
+                            ? {
+                                "background-color": getStringifiedColor((_p = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.backgroundColor) !== null && _p !== void 0 ? _p : bandedFormat === null || bandedFormat === void 0 ? void 0 : bandedFormat.backgroundColor, theme),
+                                color: getStringifiedColor((_r = (_q = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _q === void 0 ? void 0 : _q.color) !== null && _r !== void 0 ? _r : (_s = bandedFormat === null || bandedFormat === void 0 ? void 0 : bandedFormat.textFormat) === null || _s === void 0 ? void 0 : _s.color, theme),
+                                padding: "2px 3px 2px 3px",
+                                overflow: "hidden",
+                                "font-weight": isBold ? "700" : "normal",
+                                "font-family": (_t = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _t === void 0 ? void 0 : _t.fontFamily,
+                                "font-style": isItalic ? "italic" : "normal",
+                                "text-decoration": textDecoration
+                                    ? textDecoration
+                                    : undefined,
+                                "font-size": "".concat((_v = (_u = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _u === void 0 ? void 0 : _u.fontSize) !== null && _v !== void 0 ? _v : 10, "pt"),
+                                "text-align": effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.horizontalAlignment,
+                                "vertical-align": effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.verticalAlignment,
+                                "border-top": borderTop
+                                    ? "".concat(borderTop.width, "px solid ").concat(getStringifiedColor(borderTop.color, theme))
+                                    : undefined,
+                                "border-left": borderLeft
+                                    ? "".concat(borderLeft.width, "px solid ").concat(getStringifiedColor(borderLeft.color, theme))
+                                    : undefined,
+                                "border-right": borderRight
+                                    ? "".concat(borderRight.width, "px solid ").concat(getStringifiedColor(borderRight.color, theme))
+                                    : undefined,
+                                "border-bottom": borderBottom
+                                    ? "".concat(borderBottom.width, "px solid ").concat(getStringifiedColor(borderBottom.color, theme))
+                                    : undefined,
+                                "text-wrap": wordWrap ? "wrap" : undefined,
+                            }
+                            : {};
+                        // html
+                        var innerHtml = baselineOffset === "superscript"
+                            ? "<sup>".concat(formattedValue, "</sup>")
+                            : baselineOffset === "subscript"
+                                ? "<sub>".concat(formattedValue, "</sub>")
+                                : formattedValue;
+                        htmlString +=
+                            "<td".concat(formulaAttr).concat(numberFormatAttr).concat(alignmentAttr, " ").concat(rowspan > 1 ? "rowspan=\"".concat(rowspan, "\"") : "", " ").concat(colspan > 1 ? "colspan=\"".concat(colspan, "\"") : "", " style='").concat(Object.entries(style)
+                                .filter(function (_a) {
+                                var _b = __read(_a, 2), _ = _b[0], v = _b[1];
+                                return !isNil(v);
+                            })
+                                .map(function (_a) {
+                                var _b = __read(_a, 2), k = _b[0], v = _b[1];
+                                return "".concat(k, ":").concat(v);
+                            })
+                                .join(";"), "'>") +
+                                innerHtml +
+                                "</td>";
+                        // json
                         jsonRow.push({
-                            data: undefined,
+                            data: normalizedCellData,
+                            sourceCell: { rowIndex: rowIndex, columnIndex: columnIndex },
+                            rowspan: rowspan,
+                            colspan: colspan,
                         });
-                        continue;
                     }
-                    var _y = __read(mergedCellInfo
-                        ? mergedCellInfo[1]
-                        : [1, 1], 2), rowspan = _y[0], colspan = _y[1];
-                    var formattedValue = (_b = getFormattedValue(sheetId, rowIndex, columnIndex)) !== null && _b !== void 0 ? _b : "";
-                    var cellData = getCellData(sheetId, rowIndex, columnIndex);
-                    var normalizedCellData = cellData;
-                    if (cellData && typeof cellData === "object") {
-                        normalizedCellData = __assign({}, cellData);
-                        if (!isNil(normalizedCellData.ss)) {
-                            normalizedCellData.ss = collectSharedString(String(normalizedCellData.ss));
-                        }
-                        collectCellXfs(normalizedCellData.uf);
-                        collectCellXfs(normalizedCellData.ef);
+                }
+                catch (e_5_1) { e_5 = { error: e_5_1 }; }
+                finally {
+                    try {
+                        if (columns_2_1 && !columns_2_1.done && (_c = columns_2.return)) _c.call(columns_2);
                     }
-                    var formula = getExtendedValueFormula(getCellUserEnteredValue(cellData));
-                    var origin_1 = (_c = cellToAddress({ rowIndex: rowIndex, columnIndex: columnIndex })) !== null && _c !== void 0 ? _c : "".concat(rowIndex, ":").concat(columnIndex);
-                    var formulaAttr = formula
-                        ? " data-sheets-formula=\"".concat(escapeHtmlAttribute(formula), "\" data-formula=\"").concat(escapeHtmlAttribute(formula), "\" data-sheets-formula-origin=\"").concat(escapeHtmlAttribute(origin_1), "\" data-formula-origin=\"").concat(escapeHtmlAttribute(origin_1), "\"")
-                        : "";
-                    var effectiveFormat = getEffectiveFormat === null || getEffectiveFormat === void 0 ? void 0 : getEffectiveFormat(sheetId, rowIndex, columnIndex);
-                    var bandedFormat = bandedCells === null || bandedCells === void 0 ? void 0 : bandedCells.get(cellIdentifier(rowIndex, columnIndex));
-                    var numberFormatType = (_d = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.numberFormat) === null || _d === void 0 ? void 0 : _d.type;
-                    var numberFormatPattern = (_e = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.numberFormat) === null || _e === void 0 ? void 0 : _e.pattern;
-                    var numberFormatAttr = numberFormatType
-                        ? " data-sheets-numberformat-type=\"".concat(escapeHtmlAttribute(numberFormatType), "\"").concat(numberFormatPattern
-                            ? " data-sheets-numberformat-pattern=\"".concat(escapeHtmlAttribute(numberFormatPattern), "\"")
-                            : "")
-                        : "";
-                    // Alignment is encoded as data attributes so paste doesn't have
-                    // to trust `getComputedStyle().textAlign`, which fabricates a
-                    // CSS-spec default of `"start"` even when the value was never set.
-                    var horizontalAlignment = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.horizontalAlignment;
-                    var verticalAlignment = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.verticalAlignment;
-                    var alignmentAttr = "".concat(horizontalAlignment
-                        ? " data-sheets-horizontal-alignment=\"".concat(escapeHtmlAttribute(horizontalAlignment), "\"")
-                        : "").concat(verticalAlignment
-                        ? " data-sheets-vertical-alignment=\"".concat(escapeHtmlAttribute(verticalAlignment), "\"")
-                        : "");
-                    // Csv
-                    csvRow.push(formattedValue);
-                    // Style
-                    var isItalic = (_f = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _f === void 0 ? void 0 : _f.italic;
-                    var isBold = (_g = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _g === void 0 ? void 0 : _g.bold;
-                    var isUnderline = (_h = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _h === void 0 ? void 0 : _h.underline;
-                    var isStrikeThrough = (_j = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _j === void 0 ? void 0 : _j.strikethrough;
-                    var baselineOffset = (_k = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _k === void 0 ? void 0 : _k.baselineOffset;
-                    // Cell-level formatting wins over the banded (table style) layer,
-                    // matching the canvas grid's merge order.
-                    var cellBorders = (_l = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.borders) !== null && _l !== void 0 ? _l : bandedFormat === null || bandedFormat === void 0 ? void 0 : bandedFormat.borders;
-                    var borderTop = cellBorders === null || cellBorders === void 0 ? void 0 : cellBorders.top;
-                    var borderBottom = cellBorders === null || cellBorders === void 0 ? void 0 : cellBorders.bottom;
-                    var borderLeft = cellBorders === null || cellBorders === void 0 ? void 0 : cellBorders.left;
-                    var borderRight = cellBorders === null || cellBorders === void 0 ? void 0 : cellBorders.right;
-                    var textDecoration = "".concat(isUnderline ? "underline" : "", " ").concat(isStrikeThrough ? "line-through" : "").trim();
-                    var wordWrap = (effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.wrapStrategy) === "wrap";
-                    var style = theme
-                        ? {
-                            "background-color": getStringifiedColor((_m = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.backgroundColor) !== null && _m !== void 0 ? _m : bandedFormat === null || bandedFormat === void 0 ? void 0 : bandedFormat.backgroundColor, theme),
-                            color: getStringifiedColor((_p = (_o = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _o === void 0 ? void 0 : _o.color) !== null && _p !== void 0 ? _p : (_q = bandedFormat === null || bandedFormat === void 0 ? void 0 : bandedFormat.textFormat) === null || _q === void 0 ? void 0 : _q.color, theme),
-                            padding: "2px 3px 2px 3px",
-                            overflow: "hidden",
-                            "font-weight": isBold ? "700" : "normal",
-                            "font-family": (_r = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _r === void 0 ? void 0 : _r.fontFamily,
-                            "font-style": isItalic ? "italic" : "normal",
-                            "text-decoration": textDecoration
-                                ? textDecoration
-                                : undefined,
-                            "font-size": "".concat((_t = (_s = effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.textFormat) === null || _s === void 0 ? void 0 : _s.fontSize) !== null && _t !== void 0 ? _t : 10, "pt"),
-                            "text-align": effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.horizontalAlignment,
-                            "vertical-align": effectiveFormat === null || effectiveFormat === void 0 ? void 0 : effectiveFormat.verticalAlignment,
-                            "border-top": borderTop
-                                ? "".concat(borderTop.width, "px solid ").concat(getStringifiedColor(borderTop.color, theme))
-                                : undefined,
-                            "border-left": borderLeft
-                                ? "".concat(borderLeft.width, "px solid ").concat(getStringifiedColor(borderLeft.color, theme))
-                                : undefined,
-                            "border-right": borderRight
-                                ? "".concat(borderRight.width, "px solid ").concat(getStringifiedColor(borderRight.color, theme))
-                                : undefined,
-                            "border-bottom": borderBottom
-                                ? "".concat(borderBottom.width, "px solid ").concat(getStringifiedColor(borderBottom.color, theme))
-                                : undefined,
-                            "text-wrap": wordWrap ? "wrap" : undefined,
-                        }
-                        : {};
-                    // html
-                    var innerHtml = baselineOffset === "superscript"
-                        ? "<sup>".concat(formattedValue, "</sup>")
-                        : baselineOffset === "subscript"
-                            ? "<sub>".concat(formattedValue, "</sub>")
-                            : formattedValue;
-                    htmlString +=
-                        "<td".concat(formulaAttr).concat(numberFormatAttr).concat(alignmentAttr, " ").concat(rowspan > 1 ? "rowspan=\"".concat(rowspan, "\"") : "", " ").concat(colspan > 1 ? "colspan=\"".concat(colspan, "\"") : "", " style='").concat(Object.entries(style)
-                            .filter(function (_a) {
-                            var _b = __read(_a, 2), _ = _b[0], v = _b[1];
-                            return !isNil(v);
-                        })
-                            .map(function (_a) {
-                            var _b = __read(_a, 2), k = _b[0], v = _b[1];
-                            return "".concat(k, ":").concat(v);
-                        })
-                            .join(";"), "'>") +
-                            innerHtml +
-                            "</td>";
-                    // json
-                    jsonRow.push({
-                        data: normalizedCellData,
-                        sourceCell: { rowIndex: rowIndex, columnIndex: columnIndex },
-                        rowspan: rowspan,
-                        colspan: colspan,
-                    });
+                    finally { if (e_5) throw e_5.error; }
                 }
                 /* Join with ',' for csv */
                 csv.push(csvRow.join(","));
@@ -243,21 +342,15 @@ export var useOnCopy = function (_a) {
                 // json
                 json.push(jsonRow);
             }
-            htmlString += "<tbody></table></body></html>";
-        };
-        try {
-            for (var copiedSelections_1 = __values(copiedSelections), copiedSelections_1_1 = copiedSelections_1.next(); !copiedSelections_1_1.done; copiedSelections_1_1 = copiedSelections_1.next()) {
-                var range = copiedSelections_1_1.value.range;
-                _loop_1(range);
-            }
         }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        catch (e_4_1) { e_4 = { error: e_4_1 }; }
         finally {
             try {
-                if (copiedSelections_1_1 && !copiedSelections_1_1.done && (_a = copiedSelections_1.return)) _a.call(copiedSelections_1);
+                if (rows_1_1 && !rows_1_1.done && (_b = rows_1.return)) _b.call(rows_1);
             }
-            finally { if (e_1) throw e_1.error; }
+            finally { if (e_4) throw e_4.error; }
         }
+        htmlString += "<tbody></table></body></html>";
         var csvStr = csv.join("\n");
         var plainTextStr = plainText.join("\n");
         if (copiedSharedStrings.size) {
@@ -267,11 +360,13 @@ export var useOnCopy = function (_a) {
         if (copiedCellXfs.size) {
             copiedSchema.cellXfs = Array.from(copiedCellXfs.entries());
         }
-        (_u = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _u === void 0 ? void 0 : _u.setData("text/html", htmlString);
-        (_v = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _v === void 0 ? void 0 : _v.setData("text/plain", plainTextStr);
-        (_w = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _w === void 0 ? void 0 : _w.setData("text/csv", csvStr);
-        (_x = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _x === void 0 ? void 0 : _x.setData("application/json", JSON.stringify(copiedSchema));
+        (_w = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _w === void 0 ? void 0 : _w.setData("text/html", htmlString);
+        (_x = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _x === void 0 ? void 0 : _x.setData("text/plain", plainTextStr);
+        (_y = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _y === void 0 ? void 0 : _y.setData("text/csv", csvStr);
+        (_z = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _z === void 0 ? void 0 : _z.setData("application/json", JSON.stringify(copiedSchema));
+        return true;
     }, [
+        showError,
         theme,
         sheetTables,
         bandedRanges,
@@ -290,14 +385,14 @@ export var useOnCopy = function (_a) {
 // Merge cell map
 export var useMergedCellMap = function (merges) {
     return useMemo(function () {
-        var e_2, _a;
+        var e_6, _a;
         var mergedCellMap = new Map();
         var finalMerges = merges !== null && merges !== void 0 ? merges : [];
         for (var i = 0; i < finalMerges.length; i++) {
             var range = finalMerges[i];
             var startRowIndex = range.startRowIndex, startColumnIndex = range.startColumnIndex, endColumnIndex = range.endColumnIndex, endRowIndex = range.endRowIndex;
             try {
-                for (var _b = (e_2 = void 0, __values(iterateCellsInRange(range))), _c = _b.next(); !_c.done; _c = _b.next()) {
+                for (var _b = (e_6 = void 0, __values(iterateCellsInRange(range))), _c = _b.next(); !_c.done; _c = _b.next()) {
                     var _d = __read(_c.value, 2), rowIndex = _d[0], columnIndex = _d[1];
                     var isMasterCell = rowIndex === startRowIndex && columnIndex === startColumnIndex;
                     var spans = isMasterCell
@@ -312,12 +407,12 @@ export var useMergedCellMap = function (merges) {
                     ]);
                 }
             }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            catch (e_6_1) { e_6 = { error: e_6_1 }; }
             finally {
                 try {
                     if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
                 }
-                finally { if (e_2) throw e_2.error; }
+                finally { if (e_6) throw e_6.error; }
             }
         }
         return mergedCellMap;

package/dist/cjs/hooks/use-spreadsheet-state.d.ts

@@ -525,7 +525,7 @@ export declare const useSpreadsheetState: <T extends CellData = CellData, S exte
     onInsertTableRow: (tableView: TableView, relativeRowIndex?: number, rowData?: Record<string, string | undefined | null>[]) => void;
     onDeleteTableColumn: (tableView: TableView, dimensionIndex: number) => void;
     onDeleteTableRow: (tableView: TableView, rowIndexes: number[]) => void;
-    onCopy: (e: ClipboardEvent | undefined, sheetId: number, copiedSelections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[]) => void;
+    onCopy: (e: ClipboardEvent | undefined, sheetId: number, copiedSelections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[], isCutOperation?: boolean) => boolean;
     onPaste: (e: ClipboardEvent | undefined, sourceSheetId: number | undefined, destinationSheetId: number, copiedSelections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[] | undefined, activeCell: import("@rowsncolumns/grid").CellInterface, selections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[] | undefined, finalSelections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[] | undefined, isCutOperation: boolean) => Promise<void>;
     onCreateBasicFilter: (sheetId: number, activeCell: import("@rowsncolumns/grid").CellInterface, selections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[], basicFilterSpec?: Partial<import("@rowsncolumns/spreadsheet").FilterView>) => void;
     onCreateTable: (sheetId: number, activeCell: import("@rowsncolumns/grid").CellInterface, selections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[], tableSpec?: Partial<TableView>, theme?: import("@rowsncolumns/spreadsheet").TableTheme, bandedRange?: BandedDefinition) => void;

package/dist/esm/hooks/use-on-copy.d.ts

@@ -5,6 +5,13 @@ import type { BandedRange, TableView } from "@rowsncolumns/spreadsheet";
 import { type CellData, type CellFormat, type SelectionAttributes } from "@rowsncolumns/spreadsheet";
 import type { CellXfs, SharedStringValue, SharedStrings } from "../types";
 import type { useSheetProperties } from "./use-sheet-properties";
+/**
+ * Excel/Sheets copy a multi-area selection only when every area spans the same
+ * rows (areas sit side by side, left to right) or the same columns (areas stack,
+ * top to bottom). Returns the row and column indexes of the merged rectangle, or
+ * undefined for any other shape.
+ */
+export declare const getCopiedRowsAndColumns: (copiedSelections: SelectionArea<SelectionAttributes>[]) => [rows: number[], columns: number[]] | undefined;
 type UseOnCopyProps<T extends CellData> = {
     theme?: SpreadsheetTheme;
     merges?: GridRange[] | null;
@@ -43,7 +50,7 @@ export type CopySchema<T extends CellData> = {
  * @param param0
  * @returns
  */
-export declare const useOnCopy: <T extends CellData>({ theme, merges, tables: sheetTables, bandedRanges, getFormattedValue, getCellData, getColumnWidth, getRowHeight, cellXfs, sharedStrings, getEffectiveFormat, isHiddenRow, isColumnHidden, }: UseOnCopyProps<T>) => (e: ClipboardEvent | undefined, sheetId: number, copiedSelections: SelectionArea<SelectionAttributes>[]) => void;
+export declare const useOnCopy: <T extends CellData>({ theme, merges, tables: sheetTables, bandedRanges, getFormattedValue, getCellData, getColumnWidth, getRowHeight, cellXfs, sharedStrings, getEffectiveFormat, isHiddenRow, isColumnHidden, }: UseOnCopyProps<T>) => (e: ClipboardEvent | undefined, sheetId: number, copiedSelections: SelectionArea<SelectionAttributes>[], isCutOperation?: boolean) => boolean;
 export declare const useMergedCellMap: (merges?: GridRange[] | null) => Map<string, [isMasterCell: boolean, readonly [rowspan: number, colspan: number]]>;
 export {};
 //# sourceMappingURL=use-on-copy.d.ts.map

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

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

package/dist/esm/hooks/use-on-copy.js

@@ -2,6 +2,7 @@ import { areaInsideArea, cellIdentifier, } from "@rowsncolumns/grid";
 import { getBandedCells, getStringifiedColor, } from "@rowsncolumns/spreadsheet";
 import { cellToAddress, getStyleId, getCellUserEnteredValue, getExtendedValueFormula, isNil, iterateCellsInRange, } from "@rowsncolumns/utils";
 import { useCallback, useMemo } from "react";
+import { useShowError } from "../atoms/error-state.atom";
 import { isStyleReference } from "../sheet-cell";
 const escapeHtmlAttribute = (value) => value
     .replace(/&/g, "&")
@@ -9,6 +10,46 @@ const escapeHtmlAttribute = (value) => value
     .replace(/'/g, "'")
     .replace(/</g, "&lt;")
     .replace(/>/g, "&gt;");
+const MULTIPLE_SELECTIONS_ERROR = "This action won't work on multiple selections.";
+/**
+ * Excel/Sheets copy a multi-area selection only when every area spans the same
+ * rows (areas sit side by side, left to right) or the same columns (areas stack,
+ * top to bottom). Returns the row and column indexes of the merged rectangle, or
+ * undefined for any other shape.
+ */
+export const getCopiedRowsAndColumns = (copiedSelections) => {
+    const ranges = copiedSelections.map(({ range }) => range);
+    const [first] = ranges;
+    if (!first) {
+        return [[], []];
+    }
+    const sameRows = ranges.every((range) => range.startRowIndex === first.startRowIndex &&
+        range.endRowIndex === first.endRowIndex);
+    const sameColumns = ranges.every((range) => range.startColumnIndex === first.startColumnIndex &&
+        range.endColumnIndex === first.endColumnIndex);
+    if (!sameRows && !sameColumns) {
+        return undefined;
+    }
+    const rowRanges = sameRows
+        ? [first]
+        : [...ranges].sort((a, b) => a.startRowIndex - b.startRowIndex);
+    const columnRanges = sameColumns
+        ? [first]
+        : [...ranges].sort((a, b) => a.startColumnIndex - b.startColumnIndex);
+    const rows = [];
+    for (const { startRowIndex, endRowIndex } of rowRanges) {
+        for (let rowIndex = startRowIndex; rowIndex <= endRowIndex; rowIndex++) {
+            rows.push(rowIndex);
+        }
+    }
+    const columns = [];
+    for (const { startColumnIndex, endColumnIndex } of columnRanges) {
+        for (let columnIndex = startColumnIndex; columnIndex <= endColumnIndex; columnIndex++) {
+            columns.push(columnIndex);
+        }
+    }
+    return [rows, columns];
+};
 /**
  * Called when user copies a selection from sheet
  * 1. User can copy from any cell
@@ -19,7 +60,18 @@ const escapeHtmlAttribute = (value) => value
 export const useOnCopy = ({ theme, merges, tables: sheetTables, bandedRanges, getFormattedValue, getCellData, getColumnWidth, getRowHeight, cellXfs, sharedStrings, getEffectiveFormat, isHiddenRow, isColumnHidden, }) => {
     // Merge cell map
     const mergedCellMap = useMergedCellMap(merges);
-    return useCallback((e, sheetId, copiedSelections) => {
+    const showError = useShowError();
+    return useCallback((e, sheetId, copiedSelections, isCutOperation) => {
+        // Excel refuses to cut a multi-area selection, and only copies one whose
+        // areas share the same rows or the same columns.
+        const rowsAndColumns = isCutOperation && copiedSelections.length > 1
+            ? undefined
+            : getCopiedRowsAndColumns(copiedSelections);
+        if (!rowsAndColumns) {
+            showError({ message: MULTIPLE_SELECTIONS_ERROR });
+            return false;
+        }
+        const [rows, columns] = rowsAndColumns;
         const isRowHidden = isHiddenRow ?? (() => false);
         const isColHidden = isColumnHidden ?? (() => false);
         // Table styling (header fill, banded row/column fills, table borders)
@@ -70,15 +122,12 @@ export const useOnCopy = ({ theme, merges, tables: sheetTables, bandedRanges, ge
             }
         };
         let colGroups = `<colgroup>`;
-        copiedSelections.forEach(({ range }) => {
-            const { startColumnIndex, endColumnIndex } = range;
-            for (let columnIndex = startColumnIndex; columnIndex <= endColumnIndex; columnIndex++) {
-                if (isColHidden(sheetId, columnIndex))
-                    continue;
-                const cellWidth = getColumnWidth(sheetId, columnIndex);
-                colGroups += `<col width="${cellWidth}" />`;
-            }
-        });
+        for (const columnIndex of columns) {
+            if (isColHidden(sheetId, columnIndex))
+                continue;
+            const cellWidth = getColumnWidth(sheetId, columnIndex);
+            colGroups += `<col width="${cellWidth}" />`;
+        }
         colGroups += `</colgroup>`;
         let htmlString = `<html xmlns:v="urn:schemas-microsoft-com:vml"
         xmlns:o="urn:schemas-microsoft-com:office:office"
@@ -90,9 +139,9 @@ export const useOnCopy = ({ theme, merges, tables: sheetTables, bandedRanges, ge
             </style>
             <style type="text/css"><!--td {border: 1px solid #cccccc;}br {mso-data-placement:same-cell;}--></style><body>
           <table xmlns="http://www.w3.org/1999/xhtml" cellspacing="0" cellpadding="0" dir="ltr" border="1" style="table-layout:fixed;font-size:10pt;font-family:Arial;width:0px;border-collapse:collapse;border:none">${colGroups}<tbody>`;
-        for (const { range } of copiedSelections) {
-            const { startRowIndex, startColumnIndex, endColumnIndex, endRowIndex } = range;
-            /* Check if user is copying a table */
+        /* Check if user is copying a table */
+        if (copiedSelections.length === 1) {
+            const { range } = copiedSelections[0];
             const table = sheetTables?.find((table) => areaInsideArea(table.range, range) && table.sheetId === sheetId);
             if (table) {
                 // We need to set a rowDelta and colDelta
@@ -105,147 +154,147 @@ export const useOnCopy = ({ theme, merges, tables: sheetTables, bandedRanges, ge
                     colDelta,
                 });
             }
-            /* Iterate over all cells */
-            for (let rowIndex = startRowIndex; rowIndex <= endRowIndex; rowIndex++) {
-                if (isRowHidden(sheetId, rowIndex)) {
+        }
+        /* Iterate over all cells */
+        for (const rowIndex of rows) {
+            if (isRowHidden(sheetId, rowIndex)) {
+                continue;
+            }
+            const rowHeight = getRowHeight(sheetId, rowIndex);
+            htmlString += `<tr style="height:${rowHeight}px">`;
+            const csvRow = [];
+            const jsonRow = [];
+            for (const columnIndex of columns) {
+                if (isColHidden(sheetId, columnIndex)) {
                     continue;
                 }
-                const rowHeight = getRowHeight(sheetId, rowIndex);
-                htmlString += `<tr style="height:${rowHeight}px">`;
-                const csvRow = [];
-                const jsonRow = [];
-                for (let columnIndex = startColumnIndex; columnIndex <= endColumnIndex; columnIndex++) {
-                    if (isColHidden(sheetId, columnIndex)) {
-                        continue;
-                    }
-                    const mergedCellInfo = mergedCellMap.get(cellIdentifier(rowIndex, columnIndex));
-                    const isMasterCell = mergedCellInfo ? mergedCellInfo[0] : true;
-                    if (!isMasterCell) {
-                        jsonRow.push({
-                            data: undefined,
-                        });
-                        continue;
-                    }
-                    const [rowspan, colspan] = mergedCellInfo
-                        ? mergedCellInfo[1]
-                        : [1, 1];
-                    const formattedValue = getFormattedValue(sheetId, rowIndex, columnIndex) ?? "";
-                    const cellData = getCellData(sheetId, rowIndex, columnIndex);
-                    let normalizedCellData = cellData;
-                    if (cellData && typeof cellData === "object") {
-                        normalizedCellData = { ...cellData };
-                        if (!isNil(normalizedCellData.ss)) {
-                            normalizedCellData.ss = collectSharedString(String(normalizedCellData.ss));
-                        }
-                        collectCellXfs(normalizedCellData.uf);
-                        collectCellXfs(normalizedCellData.ef);
-                    }
-                    const formula = getExtendedValueFormula(getCellUserEnteredValue(cellData));
-                    const origin = cellToAddress({ rowIndex, columnIndex }) ??
-                        `${rowIndex}:${columnIndex}`;
-                    const formulaAttr = formula
-                        ? ` data-sheets-formula="${escapeHtmlAttribute(formula)}" data-formula="${escapeHtmlAttribute(formula)}" data-sheets-formula-origin="${escapeHtmlAttribute(origin)}" data-formula-origin="${escapeHtmlAttribute(origin)}"`
-                        : "";
-                    const effectiveFormat = getEffectiveFormat?.(sheetId, rowIndex, columnIndex);
-                    const bandedFormat = bandedCells?.get(cellIdentifier(rowIndex, columnIndex));
-                    const numberFormatType = effectiveFormat?.numberFormat?.type;
-                    const numberFormatPattern = effectiveFormat?.numberFormat?.pattern;
-                    const numberFormatAttr = numberFormatType
-                        ? ` data-sheets-numberformat-type="${escapeHtmlAttribute(numberFormatType)}"${numberFormatPattern
-                            ? ` data-sheets-numberformat-pattern="${escapeHtmlAttribute(numberFormatPattern)}"`
-                            : ""}`
-                        : "";
-                    // Alignment is encoded as data attributes so paste doesn't have
-                    // to trust `getComputedStyle().textAlign`, which fabricates a
-                    // CSS-spec default of `"start"` even when the value was never set.
-                    const horizontalAlignment = effectiveFormat?.horizontalAlignment;
-                    const verticalAlignment = effectiveFormat?.verticalAlignment;
-                    const alignmentAttr = `${horizontalAlignment
-                        ? ` data-sheets-horizontal-alignment="${escapeHtmlAttribute(horizontalAlignment)}"`
-                        : ""}${verticalAlignment
-                        ? ` data-sheets-vertical-alignment="${escapeHtmlAttribute(verticalAlignment)}"`
-                        : ""}`;
-                    // Csv
-                    csvRow.push(formattedValue);
-                    // Style
-                    const isItalic = effectiveFormat?.textFormat?.italic;
-                    const isBold = effectiveFormat?.textFormat?.bold;
-                    const isUnderline = effectiveFormat?.textFormat?.underline;
-                    const isStrikeThrough = effectiveFormat?.textFormat?.strikethrough;
-                    const baselineOffset = effectiveFormat?.textFormat?.baselineOffset;
-                    // Cell-level formatting wins over the banded (table style) layer,
-                    // matching the canvas grid's merge order.
-                    const cellBorders = effectiveFormat?.borders ?? bandedFormat?.borders;
-                    const borderTop = cellBorders?.top;
-                    const borderBottom = cellBorders?.bottom;
-                    const borderLeft = cellBorders?.left;
-                    const borderRight = cellBorders?.right;
-                    const textDecoration = `${isUnderline ? "underline" : ""} ${isStrikeThrough ? "line-through" : ""}`.trim();
-                    const wordWrap = effectiveFormat?.wrapStrategy === "wrap";
-                    const style = theme
-                        ? {
-                            "background-color": getStringifiedColor(effectiveFormat?.backgroundColor ??
-                                bandedFormat?.backgroundColor, theme),
-                            color: getStringifiedColor(effectiveFormat?.textFormat?.color ??
-                                bandedFormat?.textFormat?.color, theme),
-                            padding: "2px 3px 2px 3px",
-                            overflow: "hidden",
-                            "font-weight": isBold ? "700" : "normal",
-                            "font-family": effectiveFormat?.textFormat?.fontFamily,
-                            "font-style": isItalic ? "italic" : "normal",
-                            "text-decoration": textDecoration
-                                ? textDecoration
-                                : undefined,
-                            "font-size": `${effectiveFormat?.textFormat?.fontSize ?? 10}pt`,
-                            "text-align": effectiveFormat?.horizontalAlignment,
-                            "vertical-align": effectiveFormat?.verticalAlignment,
-                            "border-top": borderTop
-                                ? `${borderTop.width}px solid ${getStringifiedColor(borderTop.color, theme)}`
-                                : undefined,
-                            "border-left": borderLeft
-                                ? `${borderLeft.width}px solid ${getStringifiedColor(borderLeft.color, theme)}`
-                                : undefined,
-                            "border-right": borderRight
-                                ? `${borderRight.width}px solid ${getStringifiedColor(borderRight.color, theme)}`
-                                : undefined,
-                            "border-bottom": borderBottom
-                                ? `${borderBottom.width}px solid ${getStringifiedColor(borderBottom.color, theme)}`
-                                : undefined,
-                            "text-wrap": wordWrap ? "wrap" : undefined,
-                        }
-                        : {};
-                    // html
-                    const innerHtml = baselineOffset === "superscript"
-                        ? `<sup>${formattedValue}</sup>`
-                        : baselineOffset === "subscript"
-                            ? `<sub>${formattedValue}</sub>`
-                            : formattedValue;
-                    htmlString +=
-                        `<td${formulaAttr}${numberFormatAttr}${alignmentAttr} ${rowspan > 1 ? `rowspan="${rowspan}"` : ""} ${colspan > 1 ? `colspan="${colspan}"` : ""} style='${Object.entries(style)
-                            .filter(([_, v]) => !isNil(v))
-                            .map(([k, v]) => `${k}:${v}`)
-                            .join(";")}'>` +
-                            innerHtml +
-                            "</td>";
-                    // json
+                const mergedCellInfo = mergedCellMap.get(cellIdentifier(rowIndex, columnIndex));
+                const isMasterCell = mergedCellInfo ? mergedCellInfo[0] : true;
+                if (!isMasterCell) {
                     jsonRow.push({
-                        data: normalizedCellData,
-                        sourceCell: { rowIndex, columnIndex },
-                        rowspan,
-                        colspan,
+                        data: undefined,
                     });
+                    continue;
                 }
-                /* Join with ',' for csv */
-                csv.push(csvRow.join(","));
-                // Plain text
-                plainText.push(csvRow.join("\t"));
+                const [rowspan, colspan] = mergedCellInfo
+                    ? mergedCellInfo[1]
+                    : [1, 1];
+                const formattedValue = getFormattedValue(sheetId, rowIndex, columnIndex) ?? "";
+                const cellData = getCellData(sheetId, rowIndex, columnIndex);
+                let normalizedCellData = cellData;
+                if (cellData && typeof cellData === "object") {
+                    normalizedCellData = { ...cellData };
+                    if (!isNil(normalizedCellData.ss)) {
+                        normalizedCellData.ss = collectSharedString(String(normalizedCellData.ss));
+                    }
+                    collectCellXfs(normalizedCellData.uf);
+                    collectCellXfs(normalizedCellData.ef);
+                }
+                const formula = getExtendedValueFormula(getCellUserEnteredValue(cellData));
+                const origin = cellToAddress({ rowIndex, columnIndex }) ??
+                    `${rowIndex}:${columnIndex}`;
+                const formulaAttr = formula
+                    ? ` data-sheets-formula="${escapeHtmlAttribute(formula)}" data-formula="${escapeHtmlAttribute(formula)}" data-sheets-formula-origin="${escapeHtmlAttribute(origin)}" data-formula-origin="${escapeHtmlAttribute(origin)}"`
+                    : "";
+                const effectiveFormat = getEffectiveFormat?.(sheetId, rowIndex, columnIndex);
+                const bandedFormat = bandedCells?.get(cellIdentifier(rowIndex, columnIndex));
+                const numberFormatType = effectiveFormat?.numberFormat?.type;
+                const numberFormatPattern = effectiveFormat?.numberFormat?.pattern;
+                const numberFormatAttr = numberFormatType
+                    ? ` data-sheets-numberformat-type="${escapeHtmlAttribute(numberFormatType)}"${numberFormatPattern
+                        ? ` data-sheets-numberformat-pattern="${escapeHtmlAttribute(numberFormatPattern)}"`
+                        : ""}`
+                    : "";
+                // Alignment is encoded as data attributes so paste doesn't have
+                // to trust `getComputedStyle().textAlign`, which fabricates a
+                // CSS-spec default of `"start"` even when the value was never set.
+                const horizontalAlignment = effectiveFormat?.horizontalAlignment;
+                const verticalAlignment = effectiveFormat?.verticalAlignment;
+                const alignmentAttr = `${horizontalAlignment
+                    ? ` data-sheets-horizontal-alignment="${escapeHtmlAttribute(horizontalAlignment)}"`
+                    : ""}${verticalAlignment
+                    ? ` data-sheets-vertical-alignment="${escapeHtmlAttribute(verticalAlignment)}"`
+                    : ""}`;
+                // Csv
+                csvRow.push(formattedValue);
+                // Style
+                const isItalic = effectiveFormat?.textFormat?.italic;
+                const isBold = effectiveFormat?.textFormat?.bold;
+                const isUnderline = effectiveFormat?.textFormat?.underline;
+                const isStrikeThrough = effectiveFormat?.textFormat?.strikethrough;
+                const baselineOffset = effectiveFormat?.textFormat?.baselineOffset;
+                // Cell-level formatting wins over the banded (table style) layer,
+                // matching the canvas grid's merge order.
+                const cellBorders = effectiveFormat?.borders ?? bandedFormat?.borders;
+                const borderTop = cellBorders?.top;
+                const borderBottom = cellBorders?.bottom;
+                const borderLeft = cellBorders?.left;
+                const borderRight = cellBorders?.right;
+                const textDecoration = `${isUnderline ? "underline" : ""} ${isStrikeThrough ? "line-through" : ""}`.trim();
+                const wordWrap = effectiveFormat?.wrapStrategy === "wrap";
+                const style = theme
+                    ? {
+                        "background-color": getStringifiedColor(effectiveFormat?.backgroundColor ??
+                            bandedFormat?.backgroundColor, theme),
+                        color: getStringifiedColor(effectiveFormat?.textFormat?.color ??
+                            bandedFormat?.textFormat?.color, theme),
+                        padding: "2px 3px 2px 3px",
+                        overflow: "hidden",
+                        "font-weight": isBold ? "700" : "normal",
+                        "font-family": effectiveFormat?.textFormat?.fontFamily,
+                        "font-style": isItalic ? "italic" : "normal",
+                        "text-decoration": textDecoration
+                            ? textDecoration
+                            : undefined,
+                        "font-size": `${effectiveFormat?.textFormat?.fontSize ?? 10}pt`,
+                        "text-align": effectiveFormat?.horizontalAlignment,
+                        "vertical-align": effectiveFormat?.verticalAlignment,
+                        "border-top": borderTop
+                            ? `${borderTop.width}px solid ${getStringifiedColor(borderTop.color, theme)}`
+                            : undefined,
+                        "border-left": borderLeft
+                            ? `${borderLeft.width}px solid ${getStringifiedColor(borderLeft.color, theme)}`
+                            : undefined,
+                        "border-right": borderRight
+                            ? `${borderRight.width}px solid ${getStringifiedColor(borderRight.color, theme)}`
+                            : undefined,
+                        "border-bottom": borderBottom
+                            ? `${borderBottom.width}px solid ${getStringifiedColor(borderBottom.color, theme)}`
+                            : undefined,
+                        "text-wrap": wordWrap ? "wrap" : undefined,
+                    }
+                    : {};
                 // html
-                htmlString += "</tr>";
+                const innerHtml = baselineOffset === "superscript"
+                    ? `<sup>${formattedValue}</sup>`
+                    : baselineOffset === "subscript"
+                        ? `<sub>${formattedValue}</sub>`
+                        : formattedValue;
+                htmlString +=
+                    `<td${formulaAttr}${numberFormatAttr}${alignmentAttr} ${rowspan > 1 ? `rowspan="${rowspan}"` : ""} ${colspan > 1 ? `colspan="${colspan}"` : ""} style='${Object.entries(style)
+                        .filter(([_, v]) => !isNil(v))
+                        .map(([k, v]) => `${k}:${v}`)
+                        .join(";")}'>` +
+                        innerHtml +
+                        "</td>";
                 // json
-                json.push(jsonRow);
+                jsonRow.push({
+                    data: normalizedCellData,
+                    sourceCell: { rowIndex, columnIndex },
+                    rowspan,
+                    colspan,
+                });
             }
-            htmlString += "<tbody></table></body></html>";
+            /* Join with ',' for csv */
+            csv.push(csvRow.join(","));
+            // Plain text
+            plainText.push(csvRow.join("\t"));
+            // html
+            htmlString += "</tr>";
+            // json
+            json.push(jsonRow);
         }
+        htmlString += "<tbody></table></body></html>";
         const csvStr = csv.join("\n");
         const plainTextStr = plainText.join("\n");
         if (copiedSharedStrings.size) {
@@ -259,7 +308,9 @@ export const useOnCopy = ({ theme, merges, tables: sheetTables, bandedRanges, ge
         e?.clipboardData?.setData("text/plain", plainTextStr);
         e?.clipboardData?.setData("text/csv", csvStr);
         e?.clipboardData?.setData("application/json", JSON.stringify(copiedSchema));
+        return true;
     }, [
+        showError,
         theme,
         sheetTables,
         bandedRanges,

package/dist/esm/hooks/use-spreadsheet-state.d.ts

@@ -525,7 +525,7 @@ export declare const useSpreadsheetState: <T extends CellData = CellData, S exte
     onInsertTableRow: (tableView: TableView, relativeRowIndex?: number, rowData?: Record<string, string | undefined | null>[]) => void;
     onDeleteTableColumn: (tableView: TableView, dimensionIndex: number) => void;
     onDeleteTableRow: (tableView: TableView, rowIndexes: number[]) => void;
-    onCopy: (e: ClipboardEvent | undefined, sheetId: number, copiedSelections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[]) => void;
+    onCopy: (e: ClipboardEvent | undefined, sheetId: number, copiedSelections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[], isCutOperation?: boolean) => boolean;
     onPaste: (e: ClipboardEvent | undefined, sourceSheetId: number | undefined, destinationSheetId: number, copiedSelections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[] | undefined, activeCell: import("@rowsncolumns/grid").CellInterface, selections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[] | undefined, finalSelections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[] | undefined, isCutOperation: boolean) => Promise<void>;
     onCreateBasicFilter: (sheetId: number, activeCell: import("@rowsncolumns/grid").CellInterface, selections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[], basicFilterSpec?: Partial<import("@rowsncolumns/spreadsheet").FilterView>) => void;
     onCreateTable: (sheetId: number, activeCell: import("@rowsncolumns/grid").CellInterface, selections: import("@rowsncolumns/grid").SelectionArea<SelectionAttributes>[], tableSpec?: Partial<TableView>, theme?: import("@rowsncolumns/spreadsheet").TableTheme, bandedRange?: BandedDefinition) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/spreadsheet-state",
-  "version": "28.0.68",
+  "version": "28.0.70",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/esm/index.d.ts",
@@ -55,23 +55,23 @@
     "@rowsncolumns/calculator": ">=7.2.30",
     "@rowsncolumns/common-types": ">=5.2.30",
     "@rowsncolumns/dag": ">=7.2.30",
-    "@rowsncolumns/fast-formula-parser": "6.2.33",
+    "@rowsncolumns/fast-formula-parser": "6.2.34",
     "@rowsncolumns/grid": ">=13.2.33",
     "@rowsncolumns/icons": ">=7.2.31",
-    "@rowsncolumns/spreadsheet": ">=10.2.68",
+    "@rowsncolumns/spreadsheet": ">=10.2.71",
     "@rowsncolumns/toolkit": ">=24.4.2",
-    "@rowsncolumns/ui": ">=15.0.39",
+    "@rowsncolumns/ui": ">=15.0.40",
     "@rowsncolumns/utils": ">=9.2.37"
   },
   "devDependencies": {
     "@rowsncolumns/calculator": ">=7.2.30",
     "@rowsncolumns/common-types": ">=5.2.30",
     "@rowsncolumns/dag": ">=7.2.30",
-    "@rowsncolumns/fast-formula-parser": ">=6.2.33",
+    "@rowsncolumns/fast-formula-parser": ">=6.2.34",
     "@rowsncolumns/grid": ">=13.2.33",
     "@rowsncolumns/icons": ">=7.2.31",
-    "@rowsncolumns/spreadsheet": ">=10.2.68",
-    "@rowsncolumns/ui": ">=15.0.39",
+    "@rowsncolumns/spreadsheet": ">=10.2.71",
+    "@rowsncolumns/ui": ">=15.0.40",
     "@rowsncolumns/utils": ">=9.2.37"
   },
   "dependencies": {