@rowsncolumns/spreadsheet-state 28.0.66

package/LICENSE.md

@@ -0,0 +1,100 @@
+# Rows n' Columns Commercial License Agreement
+
+This Rows n' Columns Commercial License Agreement (the "Agreement") governs
+the use of the Rows n' Columns software packages published under the
+`@rowsncolumns` npm scope, including associated JavaScript, WebAssembly
+binaries, stylesheets, type definitions and documentation (the "Software").
+
+The Software is **not** open source. Downloading or installing the Software
+from a public package registry does not grant any right to use it beyond the
+evaluation use described below.
+
+## 1. Definitions
+
+- **"Licensor"** means Rows n' Columns (rowsncolumns.app).
+- **"Licensee"** means the individual or legal entity identified in an Order.
+- **"Order"** means a purchase of a license for the Software from Licensor,
+  identified by an order ID and associated with a License Key.
+- **"License Key"** means the signed key issued by Licensor that identifies
+  the Licensee, license tier, and Update Window.
+- **"Update Window"** means the period stated in the Order during which
+  Software versions released by Licensor are covered by the License Key.
+
+## 2. License Grant
+
+Subject to payment of the applicable fees and compliance with this Agreement,
+Licensor grants Licensee a non-exclusive, non-transferable, worldwide license
+to use, and to distribute in compiled form as an embedded component of
+Licensee's own applications, any version of the Software released during the
+Update Window, in accordance with the license tier stated in the Order.
+
+This grant is perpetual for versions released during the Update Window:
+Licensee may continue to use those versions after the Update Window ends.
+Versions released after the Update Window ends require a new or renewed
+Order.
+
+## 3. Evaluation Use
+
+The Software may be used without a License Key solely for internal
+evaluation and development purposes. Evaluation use in production, or
+removal or suppression of evaluation notices, is not permitted.
+
+## 4. Restrictions
+
+Except as expressly permitted by this Agreement or by applicable law that
+cannot be contractually waived, Licensee shall not:
+
+1. redistribute, resell, sublicense, or otherwise make the Software
+   available as a standalone product, library, or development component;
+2. use the Software to build a product that competes with the Software;
+3. remove, alter, or circumvent License Key validation, evaluation notices,
+   watermarks, or copyright notices in the Software;
+4. share License Keys with any third party, or use a License Key outside
+   the scope of the tier stated in the Order;
+5. reverse engineer, decompile, or disassemble the Software except to the
+   extent permitted by applicable law.
+
+## 5. Ownership
+
+The Software is licensed, not sold. Licensor and its licensors retain all
+right, title, and interest in and to the Software, including all
+intellectual property rights.
+
+## 6. Third-Party Components
+
+The Software may include third-party open-source components. Those
+components remain governed by their own license terms, which are included
+with the applicable component and are not limited by this Agreement.
+
+## 7. Termination
+
+This Agreement terminates automatically upon material breach by Licensee
+that remains uncured 30 days after written notice. Upon termination,
+Licensee must cease use and distribution of the Software, except that
+end-user copies of Licensee applications already distributed in compliance
+with this Agreement are unaffected.
+
+## 8. Warranty Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+## 9. Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL LICENSOR BE LIABLE
+FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES,
+OR ANY LOSS OF PROFITS, DATA, OR GOODWILL, ARISING OUT OF OR RELATED TO THIS
+AGREEMENT, AND LICENSOR'S AGGREGATE LIABILITY SHALL NOT EXCEED THE FEES PAID
+BY LICENSEE IN THE TWELVE MONTHS PRECEDING THE CLAIM.
+
+## 10. General
+
+This Agreement constitutes the entire agreement between the parties
+concerning the Software and supersedes any prior agreements. If any
+provision is held unenforceable, the remainder remains in effect. Failure to
+enforce a provision is not a waiver.
+
+For licensing inquiries, visit <https://www.rowsncolumns.app/pricing>.
+
+Copyright © Rows n' Columns. All rights reserved.

package/Readme.md

@@ -0,0 +1,65 @@
+# UseSpreadSheetState
+
+Provides hooks to manage Spreadsheet state.
+
+## Features
+
+1. Use your own State management library, can be `useState` or `recoil` etc.
+2. Undo/redo functionality using immer patches
+3. Calculation hook built-in
+
+
+## Installation
+
+````js
+yarn add @rowsncolumns/spreadsheet-state
+````
+
+## Usage
+
+````ts
+import { SpreadsheetProvider, CanvasGrid } from "@rowsncolumns/spreadsheet"
+import type { SheetData, RowData } from "@rowsncolumns/spreadsheet-state";
+import { useSpreadsheetState } from "@rowsncolumns/spreadsheet-state";
+
+const MySpreadsheet = () => {
+  const {
+    activeCell,
+    activeSheetId,
+    selections,
+    rowCount,
+    columnCount,
+    frozenColumnCount,
+    frozenRowCount,
+    rowMetadata,
+    columnMetadata,
+    merges,
+    isDarkMode,
+    spreadsheetColors,
+    canRedo,
+    canUndo,
+    ...rest
+  } = useSpreadsheetState({
+    sheets,
+    sheetData,
+    onChangeSheets,
+    onChangeSheetData
+  })
+
+  return (
+    <CanvasGrid
+    />
+  )
+}
+
+export const App = () => {
+  <SpreadsheetProvider>
+    <MySpreadsheet>
+  </SpreadsheetProvider>
+}
+````
+
+
+## Notes about immer
+
+Immer 10+ does not support Sparse arrays, So keep fixing the immer version to ^9, till we find a suitable solution

package/dist/cjs/api/border.d.ts

@@ -0,0 +1,9 @@
+import type { BorderStyle } from "@rowsncolumns/spreadsheet";
+/**
+ * Get border width from border style
+ * @param style
+ * @returns
+ */
+export declare const getBorderWidthFromStyle: (style: BorderStyle) => 1 | 2 | 3;
+export declare const getCSSBorderStyleFromStyle: (style: BorderStyle) => "dotted" | "dashed" | "solid" | "thin" | "double" | "hair" | "mediumDashed" | "mediumDashDot" | "dashDot" | "dashDotDot" | "slantDashDot";
+//# sourceMappingURL=border.d.ts.map

package/dist/cjs/api/border.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"border.d.ts","sourceRoot":"","sources":["../../../api/border.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,WAAW,cAWzD,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,OAAO,WAAW,8IAS5D,CAAC"}

package/dist/cjs/api/border.js

@@ -0,0 +1,25 @@
+/**
+ * Get border width from border style
+ * @param style
+ * @returns
+ */
+export var getBorderWidthFromStyle = function (style) {
+    if (style === "solid") {
+        return 1;
+    }
+    if (style === "solid_medium") {
+        return 2;
+    }
+    if (style === "solid_thick" || style === "double") {
+        return 3;
+    }
+    return 1;
+};
+export var getCSSBorderStyleFromStyle = function (style) {
+    if (style === "solid" ||
+        style === "solid_medium" ||
+        style === "solid_thick") {
+        return "solid";
+    }
+    return style;
+};

package/dist/cjs/api/conditional-format.d.ts

@@ -0,0 +1,2 @@
+export { isConditionalFormatFormulaRule, buildConditionalFormatExpression, } from "@rowsncolumns/utils";
+//# sourceMappingURL=conditional-format.d.ts.map

package/dist/cjs/api/conditional-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional-format.d.ts","sourceRoot":"","sources":["../../../api/conditional-format.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,qBAAqB,CAAC"}

package/dist/cjs/api/conditional-format.js

@@ -0,0 +1,5 @@
+// The implementation has moved to `@rowsncolumns/utils` so it can be
+// shared between this package and `@rowsncolumns/spreadsheet` without
+// creating a circular dependency. Re-exported here for backward
+// compatibility with existing internal imports.
+export { isConditionalFormatFormulaRule, buildConditionalFormatExpression, } from "@rowsncolumns/utils";

package/dist/cjs/api/copy-paste.d.ts

@@ -0,0 +1,20 @@
+import type { CellInterface, GridRange } from "@rowsncolumns/common-types";
+import type { CellData, EmbeddedObject, TableView } from "@rowsncolumns/spreadsheet";
+import type { GeneratedNames } from "../generated-names";
+import type { UseSpreadsheetProps } from "../hooks/use-spreadsheet-state";
+export type ClipBoardFormat = "text/html" | "text/csv" | "text/plain" | "application/json" | "image/apng" | "image/bmp" | "image/gif" | "image/jpeg" | "image/pjpeg" | "image/png" | "image/svg+xml" | "image/tiff" | "image/webp" | "image/x-icon";
+export declare const SUPPORTED_IMAGE_TYPES: string[];
+export declare const generateDataFromClipboard: <T extends CellData>(e: ClipboardEvent | undefined, activeCell: CellInterface, sheetId: number, activeSheetName: string, preserveFormatting?: boolean, locale?: string, idCreationStrategy?: UseSpreadsheetProps<T>["idCreationStrategy"], forcePlainText?: boolean, sanitizeHtml?: (html: string) => string, generatedNames?: GeneratedNames) => Promise<{
+    results?: (CellData | null | undefined)[][];
+    merges?: GridRange[];
+    embeds?: EmbeddedObject[];
+    tables?: TableView[];
+    rowHeights?: number[];
+    columnWidths?: number[];
+} | undefined>;
+export declare function transpose<T>(matrix: T[][]): T[][];
+export declare function pickFormatting<T extends CellData>(matrix: (CellData | T | undefined | null)[][]): (CellData | T | null | undefined)[][];
+export declare function pickValue<T extends CellData>(matrix: (CellData | T | undefined | null)[][], sheetId: number, locale?: string): (CellData | T | null | undefined)[][];
+export declare function pickFormula<T extends CellData>(matrix: (CellData | T | undefined | null)[][], sheetId: number, locale?: string): (CellData | T | null | undefined)[][];
+export declare const extractFontFamily: <T extends CellData = CellData>(data: (string | T | CellData | undefined | null)[][]) => string[];
+//# sourceMappingURL=copy-paste.d.ts.map

package/dist/cjs/api/copy-paste.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-paste.d.ts","sourceRoot":"","sources":["../../../api/copy-paste.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EAEV,MAAM,2BAA2B,CAAC;AAanC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAW1E,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,UAAU,GACV,YAAY,GACZ,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,YAAY,GACZ,aAAa,GACb,WAAW,GACX,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,cAAc,CAAC;AAEnB,eAAO,MAAM,qBAAqB,UAWjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAU,CAAC,SAAS,QAAQ,EAChE,GAAG,cAAc,GAAG,SAAS,EAC7B,YAAY,aAAa,EACzB,SAAS,MAAM,EACf,iBAAiB,MAAM,EACvB,qBAAqB,OAAO,EAC5B,SAAS,MAAM,EACf,qBAAqB,mBAAmB,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,EACjE,iBAAiB,OAAO,EACxB,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACvC,iBAAiB,cAAc,KAC9B,OAAO,CACN;IACE,OAAO,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACD,SAAS,CAqQZ,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,SAazC;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,yCAwB9C;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAC1C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAkChB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,MAAM,EAAE,CAAC,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EAC7C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,yCAwBhB;AAED,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,KACnD,MAAM,EAmBR,CAAC"}

package/dist/cjs/api/copy-paste.js

@@ -0,0 +1,384 @@
+import { __assign, __awaiter, __generator, __read, __rest, __spreadArray, __values } from "tslib";
+import { createCellDataArrayFromCSVString, readImageFileAsDataUri, } from "@rowsncolumns/toolkit";
+import { getCellEffectiveFormat, isAFormula, isNil, log, } from "@rowsncolumns/utils";
+import { uuid } from "@rowsncolumns/utils";
+import { getGeneratedTableCopyName } from "../generated-names";
+import { defaultCellCoords, defaultSheetId, isStyleReference, SheetCell, } from "../sheet-cell";
+import { isRichSharedString } from "../types";
+import { isBoolean, isValidURLorEmail } from "./datatype";
+import { parseHtml } from "./parse-html";
+export var SUPPORTED_IMAGE_TYPES = [
+    "image/apng",
+    "image/bmp",
+    "image/gif",
+    "image/jpeg",
+    "image/pjpeg",
+    "image/png",
+    "image/svg+xml",
+    "image/tiff",
+    "image/webp",
+    "image/x-icon",
+];
+export var generateDataFromClipboard = function (e, activeCell, sheetId, activeSheetName, preserveFormatting, locale, idCreationStrategy, forcePlainText, sanitizeHtml, generatedNames) { return __awaiter(void 0, void 0, void 0, function () {
+    var items, files, formatOrder, plainTextValue, isFormula, format, rows, filesArray, filesArray_1, filesArray_1_1, file, _a, imageUrl, e_1_1, clipboardValue, sheetCell, clipboard, isPlainTextOnly, _b, parsed, sheetData, tables, cellXfs, parsedSharedStrings, sharedStrings_1, tables_1, tables_1_1, table, rowDelta, colDelta, rowSpan, colSpan, merges_1, cellXfsMap_1, results, itemsArray, itemsArray_1, itemsArray_1_1, item, e_2_1, results, results;
+    var e_1, _c, e_3, _d, e_2, _e;
+    var _f, _g, _h, _j, _k, _l, _m;
+    return __generator(this, function (_o) {
+        switch (_o.label) {
+            case 0:
+                items = (_f = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _f === void 0 ? void 0 : _f.items;
+                files = (_g = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _g === void 0 ? void 0 : _g.files;
+                formatOrder = __spreadArray(__spreadArray([], __read(SUPPORTED_IMAGE_TYPES), false), [
+                    "application/json",
+                    "text/html",
+                    "text/csv",
+                    "text/plain",
+                ], false);
+                plainTextValue = (_h = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _h === void 0 ? void 0 : _h.getData("text/plain");
+                isFormula = false;
+                format = isFormula
+                    ? "text/plain"
+                    : formatOrder.find(function (type) { var _a; return (_a = e === null || e === void 0 ? void 0 : e.clipboardData) === null || _a === void 0 ? void 0 : _a.getData(type); });
+                if (!((files === null || files === void 0 ? void 0 : files.length) && !format)) return [3 /*break*/, 9];
+                rows = [];
+                filesArray = Array.from(files);
+                _o.label = 1;
+            case 1:
+                _o.trys.push([1, 6, 7, 8]);
+                filesArray_1 = __values(filesArray), filesArray_1_1 = filesArray_1.next();
+                _o.label = 2;
+            case 2:
+                if (!!filesArray_1_1.done) return [3 /*break*/, 5];
+                file = filesArray_1_1.value;
+                if (SUPPORTED_IMAGE_TYPES.indexOf(file.type) === -1) {
+                    return [3 /*break*/, 4];
+                }
+                return [4 /*yield*/, readImageFileAsDataUri(file)];
+            case 3:
+                _a = __read.apply(void 0, [_o.sent(), 1]), imageUrl = _a[0];
+                rows.push([
+                    {
+                        imageUrl: imageUrl,
+                    },
+                ]);
+                _o.label = 4;
+            case 4:
+                filesArray_1_1 = filesArray_1.next();
+                return [3 /*break*/, 2];
+            case 5: return [3 /*break*/, 8];
+            case 6:
+                e_1_1 = _o.sent();
+                e_1 = { error: e_1_1 };
+                return [3 /*break*/, 8];
+            case 7:
+                try {
+                    if (filesArray_1_1 && !filesArray_1_1.done && (_c = filesArray_1.return)) _c.call(filesArray_1);
+                }
+                finally { if (e_1) throw e_1.error; }
+                return [7 /*endfinally*/];
+            case 8: return [2 /*return*/, {
+                    results: rows,
+                }];
+            case 9:
+                if (!items || !format) {
+                    return [2 /*return*/, { results: [] }];
+                }
+                clipboardValue = e === null || e === void 0 ? void 0 : e.clipboardData.getData(format);
+                sheetCell = new SheetCell();
+                sheetCell.setLocale(locale);
+                clipboard = e === null || e === void 0 ? void 0 : e.clipboardData;
+                isPlainTextOnly = ((_j = clipboard === null || clipboard === void 0 ? void 0 : clipboard.types) === null || _j === void 0 ? void 0 : _j.length) === 1 && clipboard.types[0] === "text/plain";
+                _b = format;
+                switch (_b) {
+                    case "application/json": return [3 /*break*/, 10];
+                    case "text/html": return [3 /*break*/, 11];
+                    case "image/png": return [3 /*break*/, 13];
+                    case "text/csv": return [3 /*break*/, 22];
+                    case "text/plain": return [3 /*break*/, 24];
+                }
+                return [3 /*break*/, 24];
+            case 10:
+                {
+                    try {
+                        parsed = JSON.parse(clipboardValue);
+                        sheetData = parsed.sheetData, tables = parsed.tables, cellXfs = parsed.cellXfs;
+                        parsedSharedStrings = parsed.sharedStrings;
+                        sharedStrings_1 = parsedSharedStrings instanceof Map
+                            ? parsedSharedStrings
+                            : parsed.sharedStrings
+                                ? new Map(Object.entries(parsed.sharedStrings))
+                                : undefined;
+                        // Modify table ids
+                        if (tables) {
+                            try {
+                                for (tables_1 = __values(tables), tables_1_1 = tables_1.next(); !tables_1_1.done; tables_1_1 = tables_1.next()) {
+                                    table = tables_1_1.value;
+                                    rowDelta = (_k = table.rowDelta) !== null && _k !== void 0 ? _k : 0;
+                                    colDelta = (_l = table.colDelta) !== null && _l !== void 0 ? _l : 0;
+                                    rowSpan = table.range.endRowIndex - table.range.startRowIndex;
+                                    colSpan = table.range.endColumnIndex - table.range.startColumnIndex;
+                                    table.id = (_m = idCreationStrategy === null || idCreationStrategy === void 0 ? void 0 : idCreationStrategy("table")) !== null && _m !== void 0 ? _m : uuid();
+                                    table.title = getGeneratedTableCopyName(table.title, generatedNames);
+                                    // Update sheet id
+                                    table.sheetId = sheetId;
+                                    table.range.startRowIndex = activeCell.rowIndex + rowDelta;
+                                    table.range.endRowIndex = rowSpan + activeCell.rowIndex + rowDelta;
+                                    table.range.startColumnIndex = activeCell.columnIndex + colDelta;
+                                    table.range.endColumnIndex =
+                                        colSpan + activeCell.columnIndex + colDelta;
+                                }
+                            }
+                            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                            finally {
+                                try {
+                                    if (tables_1_1 && !tables_1_1.done && (_d = tables_1.return)) _d.call(tables_1);
+                                }
+                                finally { if (e_3) throw e_3.error; }
+                            }
+                        }
+                        merges_1 = [];
+                        cellXfsMap_1 = (cellXfs === null || cellXfs === void 0 ? void 0 : cellXfs.length) ? new Map(cellXfs) : undefined;
+                        results = sheetData.map(function (rows, i) {
+                            return rows.map(function (_a, j) {
+                                var _b, _c;
+                                var _d = _a.rowspan, rowspan = _d === void 0 ? 1 : _d, _e = _a.colspan, colspan = _e === void 0 ? 1 : _e, data = _a.data, sourceCell = _a.sourceCell;
+                                if (rowspan > 1 || colspan > 1) {
+                                    var startRowIndex = activeCell.rowIndex + i;
+                                    var startColumnIndex = activeCell.columnIndex + j;
+                                    // Anti pattern.. but skips one more loop
+                                    merges_1.push({
+                                        startRowIndex: startRowIndex,
+                                        startColumnIndex: startColumnIndex,
+                                        endRowIndex: startRowIndex + rowspan - 1,
+                                        endColumnIndex: startColumnIndex + colspan - 1,
+                                    });
+                                }
+                                if (data && typeof data === "object") {
+                                    if (typeof data.ss === "number" ||
+                                        typeof data.ss === "string") {
+                                        var value = sharedStrings_1 === null || sharedStrings_1 === void 0 ? void 0 : sharedStrings_1.get(String(data.ss));
+                                        if (typeof value === "string") {
+                                            data.ss = undefined;
+                                            data.ue = { sv: value };
+                                            data.ev = { sv: value };
+                                            data.fv = value;
+                                        }
+                                        else if (isRichSharedString(value)) {
+                                            data.ss = undefined;
+                                            data.ue = { sv: value.text };
+                                            data.ev = { sv: value.text };
+                                            data.fv = value.text;
+                                            data.tf = value.runs.map(function (run) { return (__assign({}, run)); });
+                                        }
+                                    }
+                                    if (cellXfsMap_1) {
+                                        var resolveStyleReference = function (value) {
+                                            var _a, _b;
+                                            if (!value) {
+                                                return value;
+                                            }
+                                            if (!isStyleReference(value)) {
+                                                return value;
+                                            }
+                                            var key = (_a = value.sid) !== null && _a !== void 0 ? _a : value.styleId;
+                                            if (!key) {
+                                                return value;
+                                            }
+                                            return (_b = cellXfsMap_1.get(key)) !== null && _b !== void 0 ? _b : value;
+                                        };
+                                        data.uf = resolveStyleReference(data.uf);
+                                        data.ef = resolveStyleReference(data.ef);
+                                    }
+                                }
+                                // Delete structured
+                                (_b = data === null || data === void 0 ? void 0 : data.ev) === null || _b === void 0 ? true : delete _b.structuredValue;
+                                // Move formulas if source cell is present
+                                if (((_c = data === null || data === void 0 ? void 0 : data.ue) === null || _c === void 0 ? void 0 : _c.fv) && sourceCell) {
+                                    var destinationCell = {
+                                        rowIndex: activeCell.rowIndex + i,
+                                        columnIndex: activeCell.columnIndex + j,
+                                    };
+                                    sheetCell.assign(sheetId, sourceCell, data);
+                                    sheetCell.moveFormula(sourceCell, destinationCell, activeSheetName, { preserveAbsolutes: true, ignoreCircular: true });
+                                    data.ue.fv = sheetCell.formula;
+                                }
+                                return data;
+                            });
+                        });
+                        return [2 /*return*/, { results: results, merges: merges_1, tables: tables }];
+                    }
+                    catch (err) {
+                        log("Error parsing json", err);
+                        return [2 /*return*/, { results: [] }];
+                    }
+                }
+                _o.label = 11;
+            case 11: return [4 /*yield*/, parseHtml(clipboardValue, plainTextValue, activeCell, sheetId, preserveFormatting, idCreationStrategy, locale, sanitizeHtml)];
+            case 12: return [2 /*return*/, _o.sent()];
+            case 13:
+                itemsArray = Array.from(items);
+                _o.label = 14;
+            case 14:
+                _o.trys.push([14, 19, 20, 21]);
+                itemsArray_1 = __values(itemsArray), itemsArray_1_1 = itemsArray_1.next();
+                _o.label = 15;
+            case 15:
+                if (!!itemsArray_1_1.done) return [3 /*break*/, 18];
+                item = itemsArray_1_1.value;
+                if (!(item.type.indexOf("text/html") !== -1)) return [3 /*break*/, 17];
+                return [4 /*yield*/, parseHtml(e.clipboardData.getData(item.type), plainTextValue, activeCell, sheetId, preserveFormatting, idCreationStrategy, locale, sanitizeHtml)];
+            case 16: return [2 /*return*/, _o.sent()];
+            case 17:
+                itemsArray_1_1 = itemsArray_1.next();
+                return [3 /*break*/, 15];
+            case 18: return [3 /*break*/, 21];
+            case 19:
+                e_2_1 = _o.sent();
+                e_2 = { error: e_2_1 };
+                return [3 /*break*/, 21];
+            case 20:
+                try {
+                    if (itemsArray_1_1 && !itemsArray_1_1.done && (_e = itemsArray_1.return)) _e.call(itemsArray_1);
+                }
+                finally { if (e_2) throw e_2.error; }
+                return [7 /*endfinally*/];
+            case 21: return [3 /*break*/, 25];
+            case 22: return [4 /*yield*/, createCellDataArrayFromCSVString(clipboardValue, locale)];
+            case 23:
+                results = _o.sent();
+                return [2 /*return*/, { results: results }];
+            case 24:
+                {
+                    results = clipboardValue.split("\n").map(function (cellValues) {
+                        return cellValues.split("\t").map(function (value) {
+                            var trimmedValue = value.trim();
+                            var isFormula = isAFormula(trimmedValue);
+                            var isEmptyValue = trimmedValue.length === 0;
+                            // Force text for formulas (prevent execution), and when forcePlainText
+                            // is enabled, also for booleans (prevent coercion) and URLs (prevent auto-linking)
+                            var needsTextPrefix = isFormula ||
+                                (forcePlainText &&
+                                    (isBoolean(trimmedValue) || isValidURLorEmail(trimmedValue)));
+                            var shouldForceText = isPlainTextOnly &&
+                                !isEmptyValue &&
+                                needsTextPrefix &&
+                                !value.startsWith("'");
+                            var normalizedValue = shouldForceText ? "'".concat(value) : value;
+                            var cell = new SheetCell(defaultSheetId, defaultCellCoords, undefined, { locale: locale });
+                            cell.setUserEnteredValue(normalizedValue);
+                            return cell.getCellData();
+                        });
+                    });
+                    return [2 /*return*/, { results: results }];
+                }
+                _o.label = 25;
+            case 25: return [2 /*return*/];
+        }
+    });
+}); };
+export function transpose(matrix) {
+    var rows = matrix.length, cols = matrix[0].length;
+    var grid = [];
+    for (var j = 0; j < cols; j++) {
+        grid[j] = Array(rows);
+    }
+    for (var i = 0; i < rows; i++) {
+        for (var j = 0; j < cols; j++) {
+            grid[j][i] = matrix[i][j];
+        }
+    }
+    return grid;
+}
+export function pickFormatting(matrix) {
+    for (var rowIndex = 0; rowIndex < matrix.length; rowIndex++) {
+        for (var columnIndex = 0; columnIndex < matrix[rowIndex].length; columnIndex++) {
+            var cellData = matrix[rowIndex][columnIndex];
+            if (typeof cellData === "object" && !isNil(cellData)) {
+                var formattedValue = cellData.formattedValue, effectiveValue = cellData.effectiveValue, userEnteredValue = cellData.userEnteredValue, fv = cellData.fv, ev = cellData.ev, ue = cellData.ue, rest = __rest(cellData, ["formattedValue", "effectiveValue", "userEnteredValue", "fv", "ev", "ue"]);
+                matrix[rowIndex][columnIndex] = rest;
+            }
+        }
+    }
+    return matrix;
+}
+export function pickValue(matrix, sheetId, locale) {
+    var sheetCell = new SheetCell();
+    sheetCell.setLocale(locale);
+    for (var rowIndex = 0; rowIndex < matrix.length; rowIndex++) {
+        for (var columnIndex = 0; columnIndex < matrix[rowIndex].length; columnIndex++) {
+            var cellData = matrix[rowIndex][columnIndex];
+            if (typeof cellData === "object" && !isNil(cellData)) {
+                sheetCell.assign(sheetId, defaultCellCoords, cellData);
+                if (sheetCell.isFormula()) {
+                    var effectiveValue = sheetCell.getEffectiveValue();
+                    if (!isNil(effectiveValue)) {
+                        sheetCell.setUserEnteredValue(effectiveValue);
+                    }
+                    else if (!isNil(sheetCell.formattedValue)) {
+                        sheetCell.setUserEnteredValue(sheetCell.formattedValue);
+                    }
+                    else {
+                        sheetCell.setUserEnteredValue(undefined);
+                    }
+                }
+                // Remove formatting
+                sheetCell.clearFormatting();
+                sheetCell.clearHyperlink();
+                matrix[rowIndex][columnIndex] = sheetCell.getCellData();
+            }
+        }
+    }
+    return matrix;
+}
+export function pickFormula(matrix, sheetId, locale) {
+    for (var rowIndex = 0; rowIndex < matrix.length; rowIndex++) {
+        for (var columnIndex = 0; columnIndex < matrix[rowIndex].length; columnIndex++) {
+            var cellData = matrix[rowIndex][columnIndex];
+            if (typeof cellData === "object" && !isNil(cellData)) {
+                var sourceCell = new SheetCell(sheetId, { rowIndex: rowIndex, columnIndex: columnIndex }, cellData);
+                var formula = sourceCell.formula;
+                sourceCell.deleteContents();
+                sourceCell.setUserEnteredValue(formula);
+                matrix[rowIndex][columnIndex] = sourceCell.getCellData();
+            }
+        }
+    }
+    return matrix;
+}
+export var extractFontFamily = function (data) {
+    var e_4, _a, e_5, _b;
+    var _c, _d, _e, _f, _g, _h, _j, _k;
+    var families = new Set();
+    try {
+        for (var data_1 = __values(data), data_1_1 = data_1.next(); !data_1_1.done; data_1_1 = data_1.next()) {
+            var row = data_1_1.value;
+            try {
+                for (var row_1 = (e_5 = void 0, __values(row)), row_1_1 = row_1.next(); !row_1_1.done; row_1_1 = row_1.next()) {
+                    var cell = row_1_1.value;
+                    if (typeof cell === "string" || isNil(cell)) {
+                        continue;
+                    }
+                    // `ef` is no longer persisted; prefer `uf`, fall back to legacy `ef`.
+                    var fontFamily = (_h = (_e = (_d = (_c = cell.uf) === null || _c === void 0 ? void 0 : _c.textFormat) === null || _d === void 0 ? void 0 : _d.fontFamily) !== null && _e !== void 0 ? _e : (_g = (_f = cell.userEnteredFormat) === null || _f === void 0 ? void 0 : _f.textFormat) === null || _g === void 0 ? void 0 : _g.fontFamily) !== null && _h !== void 0 ? _h : (_k = (_j = getCellEffectiveFormat(cell)) === null || _j === void 0 ? void 0 : _j.textFormat) === null || _k === void 0 ? void 0 : _k.fontFamily;
+                    if (fontFamily)
+                        families.add(fontFamily);
+                }
+            }
+            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+            finally {
+                try {
+                    if (row_1_1 && !row_1_1.done && (_b = row_1.return)) _b.call(row_1);
+                }
+                finally { if (e_5) throw e_5.error; }
+            }
+        }
+    }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    finally {
+        try {
+            if (data_1_1 && !data_1_1.done && (_a = data_1.return)) _a.call(data_1);
+        }
+        finally { if (e_4) throw e_4.error; }
+    }
+    return __spreadArray([], __read(families), false);
+};

package/dist/cjs/api/data-validation.d.ts

@@ -0,0 +1,2 @@
+export { isDataValidationFormulaRule, buildDataValidationExpression, } from "@rowsncolumns/utils";
+//# sourceMappingURL=data-validation.d.ts.map

package/dist/cjs/api/data-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-validation.d.ts","sourceRoot":"","sources":["../../../api/data-validation.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC"}

package/dist/cjs/api/data-validation.js

@@ -0,0 +1,5 @@
+// The implementation has moved to `@rowsncolumns/utils` so it can be
+// shared between this package and `@rowsncolumns/spreadsheet` without
+// creating a circular dependency. Re-exported here for backward
+// compatibility with existing internal imports.
+export { isDataValidationFormulaRule, buildDataValidationExpression, } from "@rowsncolumns/utils";