@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

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

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../api/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAiBpF,KAAK,mBAAmB,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,SAAS,GACT;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAoBxC,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,SA6BlD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,kBAAkB,GAAG,SAAS,EACrC,QAAQ,mBAAmB,EAC3B,gBAAgB,mBAAmB,EACnC,iBAAiB,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,EAAE,EACtD,UAAU,uBAAuB,wBAsTlC,CAAC"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../api/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAkBpF,KAAK,mBAAmB,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,SAAS,GACT;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAoBxC,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,SA6BlD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,kBAAkB,GAAG,SAAS,EACrC,QAAQ,mBAAmB,EAC3B,gBAAgB,mBAAmB,EACnC,iBAAiB,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,EAAE,EACtD,UAAU,uBAAuB,wBA2WlC,CAAC"}

package/dist/cjs/api/validation.js

@@ -1,4 +1,4 @@
-import { checkIfStringIsReference, escapeCharacters, isNil, stripDataValidationTextPrefix, toDate, toSerial, } from "@rowsncolumns/utils";
+import { checkIfStringIsReference, escapeCharacters, isNil, matchesWildcardPattern, stripDataValidationTextPrefix, toDate, toSerial, } from "@rowsncolumns/utils";
 import { convertToNumber } from "./datatype";
 var EMAIL_REGEX = /(?:[a-z0-9!#$%&'*+\/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+\/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9]))\.){3}(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9])|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])/;
 var URL_REGEX = /^https?:\/\/(?:www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_\+.~#?&\/=]*)$/;
@@ -151,6 +151,33 @@ export var checkBooleanRule = function (rule, value, previousValue, getRangeValu
                 var end = new Date(today.getFullYear(), today.getMonth() + 2, 0);
                 return { start: startOfDay(start), end: endOfDay(end) };
             }
+            // Calendar quarters / years, like Excel's Date Filters. `new Date` rolls a
+            // month index past December (or before January) into the adjacent year.
+            case "DATE_THIS_QUARTER":
+            case "DATE_LAST_QUARTER":
+            case "DATE_NEXT_QUARTER": {
+                var shift = type === "DATE_LAST_QUARTER" ? -3 : type === "DATE_NEXT_QUARTER" ? 3 : 0;
+                var firstMonth = Math.floor(today.getMonth() / 3) * 3 + shift;
+                var start = new Date(today.getFullYear(), firstMonth, 1);
+                var end = new Date(today.getFullYear(), firstMonth + 3, 0);
+                return { start: startOfDay(start), end: endOfDay(end) };
+            }
+            case "DATE_THIS_YEAR":
+            case "DATE_LAST_YEAR":
+            case "DATE_NEXT_YEAR": {
+                var year = today.getFullYear() +
+                    (type === "DATE_LAST_YEAR" ? -1 : type === "DATE_NEXT_YEAR" ? 1 : 0);
+                return {
+                    start: startOfDay(new Date(year, 0, 1)),
+                    end: endOfDay(new Date(year, 11, 31)),
+                };
+            }
+            case "DATE_YEAR_TO_DATE": {
+                return {
+                    start: startOfDay(new Date(today.getFullYear(), 0, 1)),
+                    end: endOfDay(today),
+                };
+            }
             default:
                 return undefined;
         }
@@ -166,9 +193,20 @@ export var checkBooleanRule = function (rule, value, previousValue, getRangeValu
     var type = condition.type, values = condition.values;
     var valuesArray = values !== null && values !== void 0 ? values : [];
     var firstValue = (_a = valuesArray[0]) !== null && _a !== void 0 ? _a : { userEnteredValue: "" };
+    // "All Dates in the Period" (`DATE_IN_Q1`..`Q4`, `DATE_IN_M1`..`M12`): the
+    // cell's quarter / month in any year.
+    var periodMatch = /^DATE_IN_([QM])(\d+)$/.exec(type);
+    if (periodMatch) {
+        var dateValue = toComparableDate(value);
+        if (!dateValue)
+            return false;
+        var month = dateValue.getMonth() + 1;
+        var period = periodMatch[1] === "Q" ? Math.ceil(month / 3) : month;
+        return period === Number(periodMatch[2]);
+    }
     switch (type) {
         case "TEXT_EQ":
-            return new RegExp("^" + escapeCharacters(firstValue.userEnteredValue) + "$", "gi").test(String(value));
+            return matchesWildcardPattern(firstValue.userEnteredValue, String(value), "equals");
         case "BLANK":
             return value === "" || isNil(value);
         case "BOOLEAN":
@@ -212,17 +250,17 @@ export var checkBooleanRule = function (rule, value, previousValue, getRangeValu
         case "NUMBER_NOT_EQ":
             return parseNumber(value) !== parseNumber(firstValue.userEnteredValue);
         case "TEXT_CONTAINS":
-            return new RegExp(escapeCharacters(firstValue.userEnteredValue), "gi").test(String(value));
+            return matchesWildcardPattern(firstValue.userEnteredValue, String(value), "contains");
         case "TEXT_ENDS_WITH":
-            return new RegExp(escapeCharacters(firstValue.userEnteredValue) + "$", "gi").test(String(value));
+            return matchesWildcardPattern(firstValue.userEnteredValue, String(value), "endsWith");
         case "TEXT_NOT_CONTAINS":
-            return !new RegExp(escapeCharacters(firstValue.userEnteredValue), "gi").test(String(value));
+            return !matchesWildcardPattern(firstValue.userEnteredValue, String(value), "contains");
         case "NOT_BLANK":
             return !(isNil(value) || value === "");
         case "TEXT_NOT_EQ":
-            return !new RegExp(escapeCharacters(firstValue.userEnteredValue), "gi").test(String(value));
+            return !matchesWildcardPattern(firstValue.userEnteredValue, String(value), "equals");
         case "TEXT_STARTS_WITH":
-            return new RegExp("^" + escapeCharacters(firstValue.userEnteredValue), "gi").test(String(value));
+            return matchesWildcardPattern(firstValue.userEnteredValue, String(value), "startsWith");
         case "ONE_OF_RANGE":
         case "ONE_OF_LIST": {
             if (allowBlank && !value) {
@@ -267,7 +305,14 @@ export var checkBooleanRule = function (rule, value, previousValue, getRangeValu
         case "DATE_NEXT_WEEK":
         case "DATE_LAST_MONTH":
         case "DATE_THIS_MONTH":
-        case "DATE_NEXT_MONTH": {
+        case "DATE_NEXT_MONTH":
+        case "DATE_THIS_QUARTER":
+        case "DATE_LAST_QUARTER":
+        case "DATE_NEXT_QUARTER":
+        case "DATE_THIS_YEAR":
+        case "DATE_LAST_YEAR":
+        case "DATE_NEXT_YEAR":
+        case "DATE_YEAR_TO_DATE": {
             var dateValue = toComparableDate(value);
             if (!dateValue)
                 return false;

package/dist/cjs/atoms/creating-table.atom.d.ts

@@ -0,0 +1,22 @@
+import type { CellInterface, GridRange, SelectionArea } from "@rowsncolumns/common-types";
+import type { BandedDefinition, SelectionAttributes, TableTheme } from "@rowsncolumns/spreadsheet";
+/**
+ * What the Create Table dialog was opened for: the selection it came from, the range it
+ * pre-fills (the selection, else the data region around the active cell), Excel's guess for
+ * "My table has headers", and the style the entry point chose (Format as Table / context menu).
+ */
+export type CreateTableRequest = {
+    sheetId: number;
+    activeCell: CellInterface;
+    selections: SelectionArea<SelectionAttributes>[];
+    range: GridRange;
+    hasHeaders: boolean;
+    theme?: TableTheme;
+    bandedRange?: BandedDefinition;
+};
+export declare const creatingTableAtom: import("jotai").PrimitiveAtom<CreateTableRequest | undefined> & {
+    init: CreateTableRequest | undefined;
+};
+export declare const useCreatingTable: () => CreateTableRequest | undefined;
+export declare const useSetCreatingTable: () => (args_0: CreateTableRequest | ((prev: CreateTableRequest | undefined) => CreateTableRequest | undefined) | undefined) => void;
+//# sourceMappingURL=creating-table.atom.d.ts.map

package/dist/cjs/atoms/creating-table.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creating-table.atom.d.ts","sourceRoot":"","sources":["../../../atoms/creating-table.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACX,MAAM,2BAA2B,CAAC;AAGnC;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACjD,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,sCAAwC,CAAC;AACtE,eAAO,MAAM,mBAAmB,qIAAsC,CAAC"}

package/dist/cjs/atoms/creating-table.atom.js

@@ -0,0 +1,4 @@
+import { atom, useAtomValue, useSetAtom } from "jotai";
+export var creatingTableAtom = atom(undefined);
+export var useCreatingTable = function () { return useAtomValue(creatingTableAtom); };
+export var useSetCreatingTable = function () { return useSetAtom(creatingTableAtom); };

package/dist/cjs/atoms/dialog-state.atom.d.ts

@@ -3,6 +3,14 @@ export declare const dialogStateAtom: import("jotai/vanilla/utils/atomFamily").A
 }>;
 export declare const useEditTableDialogState: () => [boolean, (args_0: boolean | ((prev: boolean) => boolean)) => void];
 export declare const useSetEditTableDialogValue: () => (args_0: boolean | ((prev: boolean) => boolean)) => void;
+export declare const useCreateTableDialogState: () => [boolean, (args_0: boolean | ((prev: boolean) => boolean)) => void];
+export declare const useSetCreateTableDialogValue: () => (args_0: boolean | ((prev: boolean) => boolean)) => void;
+export declare const useResizeTableDialogState: () => [boolean, (args_0: boolean | ((prev: boolean) => boolean)) => void];
+export declare const useSetResizeTableDialogValue: () => (args_0: boolean | ((prev: boolean) => boolean)) => void;
+export declare const useInsertSlicerDialogState: () => [boolean, (args_0: boolean | ((prev: boolean) => boolean)) => void];
+export declare const useSetInsertSlicerDialogValue: () => (args_0: boolean | ((prev: boolean) => boolean)) => void;
+export declare const useEditSlicerDialogState: () => [boolean, (args_0: boolean | ((prev: boolean) => boolean)) => void];
+export declare const useSetEditSlicerDialogState: () => (args_0: boolean | ((prev: boolean) => boolean)) => void;
 export declare const useDeletSheetConfirmationDialogState: () => [boolean, (args_0: boolean | ((prev: boolean) => boolean)) => void];
 export declare const useEditNamedRangeDialogState: () => [boolean, (args_0: boolean | ((prev: boolean) => boolean)) => void];
 export declare const useSetEditNamedRangeDialogState: () => (args_0: boolean | ((prev: boolean) => boolean)) => void;

package/dist/cjs/atoms/dialog-state.atom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dialog-state.atom.d.ts","sourceRoot":"","sources":["../../../atoms/dialog-state.atom.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe;;EAAyC,CAAC;AAGtE,eAAO,MAAM,uBAAuB,2EACG,CAAC;AAExC,eAAO,MAAM,0BAA0B,gEACG,CAAC;AAG3C,eAAO,MAAM,oCAAoC,2EACR,CAAC;AAG1C,eAAO,MAAM,4BAA4B,2EACG,CAAC;AAE7C,eAAO,MAAM,+BAA+B,gEACG,CAAC;AAGhD,eAAO,MAAM,uBAAuB,2EACG,CAAC;AAExC,eAAO,MAAM,0BAA0B,gEACG,CAAC;AAG3C,eAAO,MAAM,6BAA6B,2EACG,CAAC;AAE9C,eAAO,MAAM,gCAAgC,gEACG,CAAC;AAGjD,eAAO,MAAM,yBAAyB,2EACG,CAAC;AAE1C,eAAO,MAAM,4BAA4B,gEACG,CAAC;AAG7C,eAAO,MAAM,+BAA+B,2EACG,CAAC;AAEhD,eAAO,MAAM,kCAAkC,gEACG,CAAC;AAGnD,eAAO,MAAM,yBAAyB,2EACG,CAAC;AAE1C,eAAO,MAAM,4BAA4B,gEACG,CAAC;AAG7C,eAAO,MAAM,wBAAwB,2EACG,CAAC;AAEzC,eAAO,MAAM,2BAA2B,gEACG,CAAC;AAG5C,eAAO,MAAM,4BAA4B,2EACG,CAAC;AAE7C,eAAO,MAAM,gCAAgC,gEACE,CAAC"}
+{"version":3,"file":"dialog-state.atom.d.ts","sourceRoot":"","sources":["../../../atoms/dialog-state.atom.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe;;EAAyC,CAAC;AAGtE,eAAO,MAAM,uBAAuB,2EACG,CAAC;AAExC,eAAO,MAAM,0BAA0B,gEACG,CAAC;AAG3C,eAAO,MAAM,yBAAyB,2EACG,CAAC;AAE1C,eAAO,MAAM,4BAA4B,gEACG,CAAC;AAG7C,eAAO,MAAM,yBAAyB,2EACG,CAAC;AAE1C,eAAO,MAAM,4BAA4B,gEACG,CAAC;AAG7C,eAAO,MAAM,0BAA0B,2EACG,CAAC;AAE3C,eAAO,MAAM,6BAA6B,gEACG,CAAC;AAG9C,eAAO,MAAM,wBAAwB,2EACG,CAAC;AAEzC,eAAO,MAAM,2BAA2B,gEACG,CAAC;AAG5C,eAAO,MAAM,oCAAoC,2EACR,CAAC;AAG1C,eAAO,MAAM,4BAA4B,2EACG,CAAC;AAE7C,eAAO,MAAM,+BAA+B,gEACG,CAAC;AAGhD,eAAO,MAAM,uBAAuB,2EACG,CAAC;AAExC,eAAO,MAAM,0BAA0B,gEACG,CAAC;AAG3C,eAAO,MAAM,6BAA6B,2EACG,CAAC;AAE9C,eAAO,MAAM,gCAAgC,gEACG,CAAC;AAGjD,eAAO,MAAM,yBAAyB,2EACG,CAAC;AAE1C,eAAO,MAAM,4BAA4B,gEACG,CAAC;AAG7C,eAAO,MAAM,+BAA+B,2EACG,CAAC;AAEhD,eAAO,MAAM,kCAAkC,gEACG,CAAC;AAGnD,eAAO,MAAM,yBAAyB,2EACG,CAAC;AAE1C,eAAO,MAAM,4BAA4B,gEACG,CAAC;AAG7C,eAAO,MAAM,wBAAwB,2EACG,CAAC;AAEzC,eAAO,MAAM,2BAA2B,gEACG,CAAC;AAG5C,eAAO,MAAM,4BAA4B,2EACG,CAAC;AAE7C,eAAO,MAAM,gCAAgC,gEACE,CAAC"}

package/dist/cjs/atoms/dialog-state.atom.js

@@ -10,6 +10,34 @@ export var useEditTableDialogState = function () {
 export var useSetEditTableDialogValue = function () {
     return useSetAtom(dialogStateAtom("editTable"));
 };
+// Create Table Dialog (Ctrl+T / Insert → Table / Format as Table)
+export var useCreateTableDialogState = function () {
+    return useAtom(dialogStateAtom("createTable"));
+};
+export var useSetCreateTableDialogValue = function () {
+    return useSetAtom(dialogStateAtom("createTable"));
+};
+// Resize Table Dialog (Table Design → Resize Table)
+export var useResizeTableDialogState = function () {
+    return useAtom(dialogStateAtom("resizeTable"));
+};
+export var useSetResizeTableDialogValue = function () {
+    return useSetAtom(dialogStateAtom("resizeTable"));
+};
+// Insert Slicers Dialog (Table Design → Insert Slicer, Table → Insert Slicer…)
+export var useInsertSlicerDialogState = function () {
+    return useAtom(dialogStateAtom("insertSlicer"));
+};
+export var useSetInsertSlicerDialogValue = function () {
+    return useSetAtom(dialogStateAtom("insertSlicer"));
+};
+// Edit Slicer Dialog (Slicer → Slicer Settings…)
+export var useEditSlicerDialogState = function () {
+    return useAtom(dialogStateAtom("editSlicer"));
+};
+export var useSetEditSlicerDialogState = function () {
+    return useSetAtom(dialogStateAtom("editSlicer"));
+};
 // Delete Sheet Confirmation Dialog
 export var useDeletSheetConfirmationDialogState = function () {
     return useAtom(dialogStateAtom("deleteSheet"));

package/dist/cjs/atoms/editing-slicer.atom.d.ts

@@ -0,0 +1,9 @@
+import type { Slicer } from "@rowsncolumns/spreadsheet";
+/** The slicer Excel's "Slicer Settings" dialog was opened for (`onRequestEditSlicer`). */
+export declare const editingSlicerAtom: import("jotai").PrimitiveAtom<Slicer | undefined> & {
+    init: Slicer | undefined;
+};
+export declare const useEditingSlicer: () => Slicer | undefined;
+export declare const useSetEditingSlicer: () => (args_0: Slicer | ((prev: Slicer | undefined) => Slicer | undefined) | undefined) => void;
+export declare const useEditingSlicerState: () => [Slicer | undefined, (args_0: Slicer | ((prev: Slicer | undefined) => Slicer | undefined) | undefined) => void];
+//# sourceMappingURL=editing-slicer.atom.d.ts.map

package/dist/cjs/atoms/editing-slicer.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing-slicer.atom.d.ts","sourceRoot":"","sources":["../../../atoms/editing-slicer.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGxD,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB;;CAAsC,CAAC;AAErE,eAAO,MAAM,gBAAgB,0BAAwC,CAAC;AACtE,eAAO,MAAM,mBAAmB,iGAAsC,CAAC;AACvE,eAAO,MAAM,qBAAqB,uHAAmC,CAAC"}

package/dist/cjs/atoms/editing-slicer.atom.js

@@ -0,0 +1,6 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+/** The slicer Excel's "Slicer Settings" dialog was opened for (`onRequestEditSlicer`). */
+export var editingSlicerAtom = atom(undefined);
+export var useEditingSlicer = function () { return useAtomValue(editingSlicerAtom); };
+export var useSetEditingSlicer = function () { return useSetAtom(editingSlicerAtom); };
+export var useEditingSlicerState = function () { return useAtom(editingSlicerAtom); };

package/dist/cjs/atoms/index.d.ts

@@ -1,5 +1,9 @@
 export * from "./error-state.atom";
 export * from "./dialog-state.atom";
 export * from "./editing-embed.atom";
+export * from "./creating-table.atom";
+export * from "./resizing-table.atom";
+export * from "./inserting-slicer.atom";
+export * from "./editing-slicer.atom";
 export * from "./sheet-observer.atom";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/atoms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/cjs/atoms/index.js

@@ -1,4 +1,8 @@
 export * from "./error-state.atom";
 export * from "./dialog-state.atom";
 export * from "./editing-embed.atom";
+export * from "./creating-table.atom";
+export * from "./resizing-table.atom";
+export * from "./inserting-slicer.atom";
+export * from "./editing-slicer.atom";
 export * from "./sheet-observer.atom";

package/dist/cjs/atoms/inserting-slicer.atom.d.ts

@@ -0,0 +1,8 @@
+import type { TableView } from "@rowsncolumns/spreadsheet";
+/** The table Excel's "Insert Slicers" dialog was opened for. */
+export declare const insertingSlicerAtom: import("jotai").PrimitiveAtom<TableView | undefined> & {
+    init: TableView | undefined;
+};
+export declare const useInsertingSlicer: () => TableView | undefined;
+export declare const useSetInsertingSlicer: () => (args_0: TableView | ((prev: TableView | undefined) => TableView | undefined) | undefined) => void;
+//# sourceMappingURL=inserting-slicer.atom.d.ts.map

package/dist/cjs/atoms/inserting-slicer.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inserting-slicer.atom.d.ts","sourceRoot":"","sources":["../../../atoms/inserting-slicer.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3D,gEAAgE;AAChE,eAAO,MAAM,mBAAmB;;CAAyC,CAAC;AAE1E,eAAO,MAAM,kBAAkB,6BAA0C,CAAC;AAC1E,eAAO,MAAM,qBAAqB,0GAAwC,CAAC"}

package/dist/cjs/atoms/inserting-slicer.atom.js

@@ -0,0 +1,5 @@
+import { atom, useAtomValue, useSetAtom } from "jotai";
+/** The table Excel's "Insert Slicers" dialog was opened for. */
+export var insertingSlicerAtom = atom(undefined);
+export var useInsertingSlicer = function () { return useAtomValue(insertingSlicerAtom); };
+export var useSetInsertingSlicer = function () { return useSetAtom(insertingSlicerAtom); };

package/dist/cjs/atoms/resizing-table.atom.d.ts

@@ -0,0 +1,8 @@
+import type { TableView } from "@rowsncolumns/spreadsheet";
+/** The table Excel's "Resize Table" dialog was opened for. */
+export declare const resizingTableAtom: import("jotai").PrimitiveAtom<TableView | undefined> & {
+    init: TableView | undefined;
+};
+export declare const useResizingTable: () => TableView | undefined;
+export declare const useSetResizingTable: () => (args_0: TableView | ((prev: TableView | undefined) => TableView | undefined) | undefined) => void;
+//# sourceMappingURL=resizing-table.atom.d.ts.map

package/dist/cjs/atoms/resizing-table.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizing-table.atom.d.ts","sourceRoot":"","sources":["../../../atoms/resizing-table.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3D,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB;;CAAyC,CAAC;AAExE,eAAO,MAAM,gBAAgB,6BAAwC,CAAC;AACtE,eAAO,MAAM,mBAAmB,0GAAsC,CAAC"}

package/dist/cjs/atoms/resizing-table.atom.js

@@ -0,0 +1,5 @@
+import { atom, useAtomValue, useSetAtom } from "jotai";
+/** The table Excel's "Resize Table" dialog was opened for. */
+export var resizingTableAtom = atom(undefined);
+export var useResizingTable = function () { return useAtomValue(resizingTableAtom); };
+export var useSetResizingTable = function () { return useSetAtom(resizingTableAtom); };

package/dist/cjs/commands.d.ts

@@ -1,5 +1,5 @@
 import type { CellData, CellInterface, Citation, Color, Direction, GridRange, SelectionArea, SheetRange, SortOrder } from "@rowsncolumns/common-types";
-import type { AXIS, BandedDefinition, BandedRange, BorderLocation, BorderStyle, CellFormat, ColorFilterCriteria, ConditionalFormatRule, ConditionType, ConditionValue, DataValidationRuleRecord, EmbeddedChart, EmbeddedObject, FillModifier, FillSeriesSpec, FilterView, IconFilterCriteria, NamedRange, PivotTable, ProtectedRange, SelectionAttributes, Sheet, Slicer, SpreadsheetTheme, TableTheme, TableView, TextFormatRun } from "@rowsncolumns/spreadsheet";
+import type { AXIS, BandedDefinition, BandedRange, BorderLocation, BorderStyle, CellFormat, ColorFilterCriteria, ConditionalFormatRule, ConditionType, ConditionValue, DataValidationRuleRecord, EmbeddedChart, EmbeddedObject, FillModifier, FillSeriesSpec, FilterView, IconFilterCriteria, NamedRange, PivotTable, ProtectedRange, SelectionAttributes, Sheet, Slicer, SortSpecs, SpreadsheetTheme, CalculatedColumnPreviousCell, TableAutoExpansionWrites, TableTheme, TableView, TextFormatRun, BooleanCondition, FilterConditionJoin, CustomTableStyle } from "@rowsncolumns/spreadsheet";
 import type { AutoFillType } from "./api/fill";
 import type { ChangeBatchOptions } from "./interface/change-batch";
 import type { ClearType } from "./interface/delete-cells";
@@ -25,6 +25,14 @@ export type Command = {
     textFormatRuns: TextFormatRun[] | undefined | null;
     previousValue?: string | boolean | undefined;
     isDirty?: boolean;
+    /**
+     * `false` when the host turned Excel's "Include new rows and columns in table" AutoCorrect
+     * option off (`autoExpandTables: false`): an engine executing the command must not
+     * auto-expand a table over the written cells. Omitted = expand.
+     */
+    autoExpandTables?: boolean;
+    /** `false` when the host turned Excel's "Fill formulas in tables to create calculated columns" option off (#668 T-51). */
+    autoCalculatedColumns?: boolean;
 } | {
     command: "delete-cells";
     sheetId: number;
@@ -39,6 +47,14 @@ export type Command = {
     formatting?: (CellFormat | undefined | null)[][] | CellFormat | null | undefined;
     citations?: (string | undefined | null)[][] | string | null | undefined;
     options?: ChangeBatchOptions;
+    /**
+     * `false` when the host turned Excel's "Include new rows and columns in table" AutoCorrect
+     * option off (`autoExpandTables: false`): an engine executing the command must not
+     * auto-expand a table over the written cells. Omitted = expand.
+     */
+    autoExpandTables?: boolean;
+    /** `false` when the host turned Excel's "Fill formulas in tables to create calculated columns" option off (#668 T-51). */
+    autoCalculatedColumns?: boolean;
 } | {
     command: "paste";
     sheetId: number;
@@ -53,6 +69,8 @@ export type Command = {
         value: string | null;
         format?: CellFormat | null;
         hyperlink?: string | null;
+        /** The cell's note — carried on copy, moved on cut (Excel parity). */
+        note?: string | null;
         /** Paste Special "Skip blanks": leave the destination untouched (value, format,
          *  hyperlink) — unlike `null`, which clears it. The other fields are then only a
          *  fallback for an engine build predating `skip`. */
@@ -65,6 +83,14 @@ export type Command = {
     } | null;
     /** Paste Special "formatting only": apply each cell's `format`, leave destination values intact. */
     formatOnly?: boolean;
+    /**
+     * `false` when the host turned Excel's "Include new rows and columns in table" AutoCorrect
+     * option off (`autoExpandTables: false`): an engine executing the command must not
+     * auto-expand a table over the written cells. Omitted = expand.
+     */
+    autoExpandTables?: boolean;
+    /** `false` when the host turned Excel's "Fill formulas in tables to create calculated columns" option off (#668 T-51). */
+    autoCalculatedColumns?: boolean;
 } | {
     command: "fill";
     sheetId: number;
@@ -83,6 +109,14 @@ export type Command = {
      * engine that executes the command (the legacy engine resolves them in-process).
      */
     customLists?: string[][];
+    /**
+     * `false` when the host turned Excel's "Include new rows and columns in table" AutoCorrect
+     * option off (`autoExpandTables: false`): an engine executing the command must not
+     * auto-expand a table over the written cells. Omitted = expand.
+     */
+    autoExpandTables?: boolean;
+    /** `false` when the host turned Excel's "Fill formulas in tables to create calculated columns" option off (#668 T-51). */
+    autoCalculatedColumns?: boolean;
 } | {
     command: "remove-duplicates";
     sheetId: number;
@@ -206,16 +240,23 @@ export type Command = {
     sheetId: number;
     rows: number[];
     referenceRowIndex: number;
+    insertBefore?: boolean;
 } | {
     command: "move-columns";
     sheetId: number;
     columns: number[];
     referenceColumnIndex: number;
+    insertBefore?: boolean;
 } | {
     command: "move-range";
     sheetId: number;
     from: GridRange;
     to: GridRange;
+    /** Excel Shift+drag / Insert Cut Cells: open the destination band (down for a vertical move,
+     *  right for a horizontal one), place the block there and close the gap it left — nothing is
+     *  overwritten, no blank remains; a forward move within its own lanes lands `size` lines
+     *  before `to` (Excel's pre-removal reference). */
+    insert?: boolean;
 } | {
     command: "hide-row";
     sheetId: number;
@@ -363,8 +404,17 @@ export type Command = {
     command: "sort-table";
     sheetId: number;
     filter: TableView | FilterView;
+    /** The primary level's column (offset from the filter range's first column). */
     dimensionIndex: number;
     sortOrder: SortOrder;
+    /**
+     * The full ordered level list (primary first, then tiebreakers) — the custom-sort dialog's
+     * `SortSpecs[]`, with `sortBy` (value / cellColor / fontColor / icon), the chosen
+     * `sortColor` / `sortIcon` and any `customList`. Authoritative when present;
+     * `dimensionIndex` / `sortOrder` mirror its first entry. Persisted on the table / basic
+     * filter as `sortSpecs`.
+     */
+    sortSpecs?: SortSpecs[];
 } | {
     command: "filter-table";
     sheetId: number;
@@ -377,11 +427,19 @@ export type Command = {
     colorFilter?: ColorFilterCriteria | null;
     /** Filter-by-CF-icon criterion. Absent → carry the column's existing one; `null` → clear. */
     iconFilter?: IconFilterCriteria | null;
+    /** Custom AutoFilter second clause + join. Absent → carry the existing one; `null` → clear. */
+    condition2?: BooleanCondition | null;
+    conditionJoin?: FilterConditionJoin | null;
 } | {
     command: "delete-filter";
     sheetId: number;
     filter: TableView | FilterView;
-    columnIndex: number;
+    /**
+     * Filter-relative column (like `filter-table`'s) whose criteria are
+     * cleared — Excel's "Clear Filter From <column>". Omitted → the whole
+     * filter is removed.
+     */
+    columnIndex?: number;
 } | {
     command: "create-basic-filter";
     sheetId: number;
@@ -396,6 +454,8 @@ export type Command = {
     tableSpec?: Partial<TableView>;
     theme?: TableTheme;
     bandedRange?: BandedDefinition;
+    /** Excel's "My table has headers" (`CreateTableOptions.hasHeaders`); `false` inserts a `Column1..N` header row above the data. */
+    hasHeaders?: boolean;
 } | {
     command: "remove-table";
     tableView: TableView;
@@ -407,6 +467,12 @@ export type Command = {
 } | {
     command: "insert-table-row";
     tableView: TableView;
+    /**
+     * Insert position counted from `range.startRowIndex` (the header row when
+     * the table has one): `activeCell.rowIndex - range.startRowIndex` inserts
+     * at the active row. Clamped to the body; with a totals row the new row
+     * goes above it. Absent = after the last data row.
+     */
     relativeRowIndex?: number;
     rowData?: Record<string, string | undefined | null>[];
 } | {
@@ -418,6 +484,8 @@ export type Command = {
     tableView: TableView;
     dimensionIndex: number;
     direction: Direction.Left | Direction.Right;
+    /** Columns to insert (Excel inserts as many as are selected); default 1. */
+    count?: number;
 } | {
     command: "delete-table-column";
     tableView: TableView;
@@ -427,6 +495,30 @@ export type Command = {
     sheetId: number;
     table: TableView;
     range: GridRange;
+}
+/**
+ * The AutoCorrect smart tag's "Undo Table AutoExpansion": the table resizes back to
+ * `previousRange` and the cells the growth itself wrote (`writes` — calculated-column
+ * formulas, generated headers, inherited formats) are cleared, in one undo step. The user's
+ * own value stays.
+ */
+ | {
+    command: "undo-table-auto-expansion";
+    sheetId: number;
+    tableId: TableView["id"];
+    previousRange: GridRange;
+    writes: TableAutoExpansionWrites;
+}
+/**
+ * The AutoCorrect smart tag's "Undo Calculated Column": restore the body cells the fill
+ * overwrote (`previous`) and drop the column's calculated formula — the typed cell stays.
+ */
+ | {
+    command: "undo-calculated-column";
+    sheetId: number;
+    tableId: TableView["id"];
+    columnIndex: number;
+    previous: CalculatedColumnPreviousCell[];
 } | {
     command: "move-table-columns";
     sheetId: number;
@@ -548,6 +640,10 @@ export type Command = {
     command: "add-banded-range";
     sheetId: number;
     bandedRange: BandedRange;
+} | {
+    /** Excel's New Table Style: a workbook-level custom table style (#668 T-103). */
+    command: "create-table-style";
+    style: CustomTableStyle;
 } | {
     command: "remove-banded-range";
     sheetId: number;
@@ -583,6 +679,10 @@ export type Command = {
     anchorCell: CellInterface;
     offsetXPixels: number;
     offsetYPixels: number;
+    /** `moveAndSize` objects — the cell the bottom-right corner landed in. */
+    toCell?: CellInterface;
+    toOffsetXPixels?: number;
+    toOffsetYPixels?: number;
 } | {
     command: "resize-embed";
     embedId: EmbeddedObject["embedId"];
@@ -592,6 +692,10 @@ export type Command = {
     offsetYPixels: number;
     width: number;
     height: number;
+    /** `moveAndSize` objects — the cell the bottom-right corner landed in. */
+    toCell?: CellInterface;
+    toOffsetXPixels?: number;
+    toOffsetYPixels?: number;
 } | {
     command: "create-slicer";
     slicer: Slicer;
@@ -608,6 +712,10 @@ export type Command = {
     anchorCell: CellInterface;
     offsetXPixels: number;
     offsetYPixels: number;
+    /** `moveAndSize` slicers — the cell the bottom-right corner landed in. */
+    toCell?: CellInterface;
+    toOffsetXPixels?: number;
+    toOffsetYPixels?: number;
 } | {
     command: "resize-slicer";
     slicerId: Slicer["slicerId"];
@@ -617,6 +725,10 @@ export type Command = {
     offsetYPixels: number;
     width: number;
     height: number;
+    /** `moveAndSize` slicers — the cell the bottom-right corner landed in. */
+    toCell?: CellInterface;
+    toOffsetXPixels?: number;
+    toOffsetYPixels?: number;
 } | {
     command: "change-theme";
     theme: SpreadsheetTheme;
@@ -632,6 +744,14 @@ export type Command = {
 } | {
     command: "delete-chart";
     chartId: EmbeddedChart["chartId"];
+} | {
+    /** Excel's "Move Chart…" (#668 C-17). */
+    command: "move-chart-to-sheet";
+    chartId: EmbeddedChart["chartId"];
+    /** "Object in" — the worksheet to land on (at A1). Absent = "New sheet". */
+    sheetId?: number;
+    /** "New sheet" — the chartsheet's name; absent or taken = the first free `Chart{n}`. */
+    title?: string;
 } | {
     command: "move-chart";
     chartId: EmbeddedChart["chartId"];
@@ -639,6 +759,10 @@ export type Command = {
     anchorCell: CellInterface;
     offsetXPixels: number;
     offsetYPixels: number;
+    /** `moveAndSize` objects — the cell the bottom-right corner landed in. */
+    toCell?: CellInterface;
+    toOffsetXPixels?: number;
+    toOffsetYPixels?: number;
 } | {
     command: "resize-chart";
     chartId: EmbeddedChart["chartId"];
@@ -648,6 +772,10 @@ export type Command = {
     offsetYPixels: number;
     width: number;
     height: number;
+    /** `moveAndSize` objects — the cell the bottom-right corner landed in. */
+    toCell?: CellInterface;
+    toOffsetXPixels?: number;
+    toOffsetYPixels?: number;
 } | {
     command: "create-pivot-table";
     pivotTable: PivotTable;
@@ -688,6 +816,14 @@ export type Command = {
         rowIndex: number;
         columnIndex: number;
     };
+} | {
+    /** Several commands as ONE user action: applied in order, streamed as one merged change-set
+     *  and recorded as a single undo step (Excel undoes Data → Subtotal — row inserts, total-row
+     *  writes, outline groups — in one Ctrl+Z). `undo` / `redo` members are skipped; a nested
+     *  batch flattens into the outer step. Handled by the Rust engine (`@rowsncolumns/rnc-engine`);
+     *  `useSpreadsheetState` composes the same actions through `batchHistory`. */
+    command: "batch";
+    commands: Command[];
 } | {
     command: "undo";
 } | {