@rowsncolumns/spreadsheet-state 29.0.0 → 29.1.0

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

@@ -1,6 +1,17 @@
 import { type ParsedToken } from "@rowsncolumns/calculator";
-import type { CellInterface, GridRange } from "@rowsncolumns/common-types";
+import type { CellInterface, ExtendedValue, GridRange } from "@rowsncolumns/common-types";
 import type { BandedRange, FilterView, TableView } from "@rowsncolumns/spreadsheet";
+/**
+ * Excel's default for the Create Table dialog's "My table has headers": checked when the
+ * range's first row reads as a header row — it holds at least one value, every value in it is
+ * text (a number or boolean there means the data starts on the first row), and at least one row
+ * of data lies below it. A single-row range defaults to unchecked.
+ */
+export declare const guessTableHasHeaders: ({ sheetId, range, getEffectiveExtendedValue, }: {
+    sheetId: number;
+    range: GridRange;
+    getEffectiveExtendedValue: (sheetId: number, rowIndex: number, columnIndex: number) => ExtendedValue | null | undefined;
+}) => boolean;
 /**
  * Get table column index
  * @param sheetId
@@ -25,7 +36,20 @@ export declare const findAdjacentTable: (sheetId: number, cell: CellInterface, t
  * @returns
  */
 export declare const findAdjacentBandedRange: (sheetId: number, cell: CellInterface, bandedRanges: BandedRange[] | undefined, getUserEnteredValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined) => readonly [BandedRange | undefined, boolean, boolean];
-export declare const isTableColumnCellsFillable: (sheetId: number, range: GridRange, excludeCell: CellInterface, existingColumnFormula: string | undefined, currentValue: string | boolean | undefined, activeSheetName: string, getUserEnteredValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined) => boolean;
+/**
+ * Excel's calculated-column fill decision, shared with the Rust engine's
+ * `auto_fill_calculated_column` (rowsncolumns/spreadsheet#681): a formula just
+ * written into a table body cell fills the whole column when every OTHER body
+ * cell of that column is either empty (a fresh column) or holds the same
+ * formula relative to its row (a consistent calculated column, which the new
+ * formula overwrites). A literal anywhere, or two rows that disagree, leave
+ * the edit a one-cell exception. The column's cells are the reference — not
+ * the formula recorded on `columns[].formula`, which has no row of its own —
+ * so the overwrite works from any row, not only the one the column was
+ * created from (#668 T-50). A consistent column is a calculated column
+ * whatever its formula references (`=TODAY()`, `=1`), like Excel (#668 T-29).
+ */
+export declare const isTableColumnCellsFillable: (sheetId: number, range: GridRange, excludeCell: CellInterface, currentValue: string | boolean | undefined, activeSheetName: string, getUserEnteredValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined) => boolean;
 export declare const addTableNameToTokens: (tokens: ParsedToken[], title: string) => string;
 export declare const removeTableName: (tokens: ParsedToken[], title: string) => string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../api/table.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACV,MAAM,2BAA2B,CAAC;AAkBnC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,uBAiBhC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,0BAMvC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,EAC/B,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,uDAgDxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,cAAc,WAAW,EAAE,GAAG,SAAS,EACvC,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,yDA8CxB,CAAC;AAGF,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,EACf,OAAO,SAAS,EAChB,aAAa,aAAa,EAC1B,uBAAuB,MAAM,GAAG,SAAS,EACzC,cAAc,MAAM,GAAG,OAAO,GAAG,SAAS,EAC1C,iBAAiB,MAAM,EACvB,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,YAsExB,CAAC;AAiCF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,WAAW,EAAE,EAAE,OAAO,MAAM,WAyBxE,CAAC;AAcF,eAAO,MAAM,eAAe,GAAI,QAAQ,WAAW,EAAE,EAAE,OAAO,MAAM,WA2BnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,GAAG,UAAU,EAC7B,MAAM,MAAM,EAAE,EACd,gBAAgB,MAAM,SAoDvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,SAAS,GAAG,UAAU,EAC7B,MAAM,MAAM,EAAE,EACd,gBAAgB,MAAM,SAoDvB,CAAC"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../api/table.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAEjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACV,MAAM,2BAA2B,CAAC;AAmBnC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,gDAIlC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,yBAAyB,EAAE,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;CACvC,KAAG,OA8BH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,uBAiBhC,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,0BAMvC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,EAC/B,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,uDA8DxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,cAAc,WAAW,EAAE,GAAG,SAAS,EACvC,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,yDA8CxB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,EACf,OAAO,SAAS,EAChB,aAAa,aAAa,EAC1B,cAAc,MAAM,GAAG,OAAO,GAAG,SAAS,EAC1C,iBAAiB,MAAM,EACvB,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,YAuDxB,CAAC;AAGF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,WAAW,EAAE,EAAE,OAAO,MAAM,WAyBxE,CAAC;AAcF,eAAO,MAAM,eAAe,GAAI,QAAQ,WAAW,EAAE,EAAE,OAAO,MAAM,WA2BnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,GAAG,UAAU,EAC7B,MAAM,MAAM,EAAE,EACd,gBAAgB,MAAM,SAoDvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,SAAS,GAAG,UAAU,EAC7B,MAAM,MAAM,EAAE,EACd,gBAAgB,MAAM,SAoDvB,CAAC"}

package/dist/cjs/api/table.js

@@ -1,8 +1,7 @@
-var _a, _b, _c;
 import { __assign, __read, __spreadArray, __values } from "tslib";
-import { lexify, tokenVocabulary, } from "@rowsncolumns/calculator";
+import { tokenVocabulary, } from "@rowsncolumns/calculator";
 import { Direction } from "@rowsncolumns/common-types";
-import { isAFormula, isCellWithinBounds, isNil, iterateCellsInRange, } from "@rowsncolumns/utils";
+import { areaIntersects, isAFormula, isCellWithinBounds, isNil, iterateCellsInRange, } from "@rowsncolumns/utils";
 import { SheetCell } from "../sheet-cell";
 import { detokenize } from "./formula";
 import { moveFilterView, moveRange } from "./selection";
@@ -12,6 +11,35 @@ var isTableColumnToken = function (token) {
 var isTableNameToken = function (token) {
     return token.tokenType.name === tokenVocabulary.TableName.name;
 };
+/**
+ * Excel's default for the Create Table dialog's "My table has headers": checked when the
+ * range's first row reads as a header row — it holds at least one value, every value in it is
+ * text (a number or boolean there means the data starts on the first row), and at least one row
+ * of data lies below it. A single-row range defaults to unchecked.
+ */
+export var guessTableHasHeaders = function (_a) {
+    var _b, _c, _d;
+    var sheetId = _a.sheetId, range = _a.range, getEffectiveExtendedValue = _a.getEffectiveExtendedValue;
+    if (range.endRowIndex <= range.startRowIndex) {
+        return false;
+    }
+    var sawText = false;
+    for (var columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+        var value = getEffectiveExtendedValue(sheetId, range.startRowIndex, columnIndex);
+        if (!value) {
+            continue;
+        }
+        if (!isNil((_b = value.nv) !== null && _b !== void 0 ? _b : value.numberValue) ||
+            !isNil((_c = value.bv) !== null && _c !== void 0 ? _c : value.boolValue)) {
+            return false;
+        }
+        var text = (_d = value.sv) !== null && _d !== void 0 ? _d : value.stringValue;
+        if (!isNil(text) && text !== "") {
+            sawText = true;
+        }
+    }
+    return sawText;
+};
 /**
  * Get table column index
  * @param sheetId
@@ -75,15 +103,25 @@ export var findAdjacentTable = function (sheetId, cell, tables, getUserEnteredVa
                 startColumnIndex: cell.columnIndex,
                 endColumnIndex: cell.columnIndex,
             }));
+        // Excel never merges tables: a line that belongs to another table is not free to grow over.
+        if (tables === null || tables === void 0 ? void 0 : tables.some(function (other) {
+            return other.id !== table.id &&
+                other.sheetId === sheetId &&
+                areaIntersects(other.range, lookupRange);
+        })) {
+            return false;
+        }
         return (isAdjacent &&
             __spreadArray([], __read(iterateCellsInRange(lookupRange)), false).every(function (_a) {
                 var _b = __read(_a, 2), rowIndex = _b[0], columnIndex = _b[1];
                 return isNil(getUserEnteredValue(sheetId, rowIndex, columnIndex));
             }));
     });
-    var totalRowOffset = (adjacentTable === null || adjacentTable === void 0 ? void 0 : adjacentTable.totalRow) ? 1 : 0;
+    // A table with a totals row never grows by rows (Excel): the cell right of its totals row is
+    // a column expansion only.
     var isRowExpansion = adjacentTable
-        ? adjacentTable.range.endRowIndex + 1 - totalRowOffset === cell.rowIndex
+        ? adjacentTable.range.endRowIndex + 1 === cell.rowIndex &&
+            !adjacentTable.totalRow
         : false;
     var isColumnExpansion = adjacentTable
         ? adjacentTable.range.endColumnIndex + 1 === cell.columnIndex
@@ -129,66 +167,61 @@ export var findAdjacentBandedRange = function (sheetId, cell, bandedRanges, getU
         : false;
     return [adjacentTable, isRowExpansion, isColumnExpansion];
 };
-// Check if table cells are fillable
-export var isTableColumnCellsFillable = function (sheetId, range, excludeCell, existingColumnFormula, currentValue, activeSheetName, getUserEnteredValue) {
-    var _a;
-    var normalizedExistingFormula = normalizeFormulaString(existingColumnFormula);
-    var normalizedCurrentFormula = isAFormula(currentValue)
-        ? normalizeFormulaString(currentValue)
-        : undefined;
-    var templateFormula = normalizedExistingFormula !== null && normalizedExistingFormula !== void 0 ? normalizedExistingFormula : normalizedCurrentFormula;
-    if (!templateFormula) {
-        return false;
-    }
-    var normalizedTemplate = (_a = SheetCell.getRelativeFormula(templateFormula, excludeCell, excludeCell, activeSheetName)) !== null && _a !== void 0 ? _a : templateFormula;
-    var templateHasReferences = formulaHasCellReferences(templateFormula);
-    var isAnchorCell = excludeCell.rowIndex === range.startRowIndex &&
-        excludeCell.columnIndex === range.startColumnIndex;
-    var normalizedCurrentLiteral = normalizeFormulaString(typeof currentValue === "string" ? currentValue : undefined);
-    if (normalizedExistingFormula && !templateHasReferences) {
+/**
+ * Excel's calculated-column fill decision, shared with the Rust engine's
+ * `auto_fill_calculated_column` (rowsncolumns/spreadsheet#681): a formula just
+ * written into a table body cell fills the whole column when every OTHER body
+ * cell of that column is either empty (a fresh column) or holds the same
+ * formula relative to its row (a consistent calculated column, which the new
+ * formula overwrites). A literal anywhere, or two rows that disagree, leave
+ * the edit a one-cell exception. The column's cells are the reference — not
+ * the formula recorded on `columns[].formula`, which has no row of its own —
+ * so the overwrite works from any row, not only the one the column was
+ * created from (#668 T-50). A consistent column is a calculated column
+ * whatever its formula references (`=TODAY()`, `=1`), like Excel (#668 T-29).
+ */
+export var isTableColumnCellsFillable = function (sheetId, range, excludeCell, currentValue, activeSheetName, getUserEnteredValue) {
+    var e_2, _a;
+    var _b;
+    if (!isAFormula(currentValue)) {
         return false;
     }
-    return __spreadArray([], __read(iterateCellsInRange(range)), false).every(function (_a) {
-        var _b = __read(_a, 2), rowIndex = _b[0], columnIndex = _b[1];
-        if (rowIndex === excludeCell.rowIndex &&
-            columnIndex === excludeCell.columnIndex) {
-            return true;
-        }
-        var userEnteredValue = getUserEnteredValue(sheetId, rowIndex, columnIndex);
-        if (isNil(userEnteredValue) || userEnteredValue === "") {
-            return true;
-        }
-        if (!isAFormula(userEnteredValue)) {
-            return false;
+    // The column's existing formula, relativised to the edited cell — every
+    // non-empty body cell must agree on it.
+    var existingTemplate;
+    try {
+        for (var _c = __values(iterateCellsInRange(range)), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var _e = __read(_d.value, 2), rowIndex = _e[0], columnIndex = _e[1];
+            if (rowIndex === excludeCell.rowIndex &&
+                columnIndex === excludeCell.columnIndex) {
+                continue;
+            }
+            var userEnteredValue = getUserEnteredValue(sheetId, rowIndex, columnIndex);
+            if (isNil(userEnteredValue) || userEnteredValue === "") {
+                continue;
+            }
+            if (!isAFormula(userEnteredValue)) {
+                return false;
+            }
+            // `$`-anchored references stay put from row to row (Excel), so they must
+            // not be shifted for the comparison.
+            var relativeFormula = (_b = SheetCell.getRelativeFormula(userEnteredValue, { rowIndex: rowIndex, columnIndex: columnIndex }, excludeCell, activeSheetName, undefined, false, undefined, undefined, true)) !== null && _b !== void 0 ? _b : userEnteredValue;
+            if (existingTemplate === undefined) {
+                existingTemplate = relativeFormula;
+            }
+            else if (existingTemplate !== relativeFormula) {
+                return false;
+            }
         }
-        var relativeFormula = SheetCell.getRelativeFormula(userEnteredValue, { rowIndex: rowIndex, columnIndex: columnIndex }, excludeCell, activeSheetName);
-        var comparable = relativeFormula !== null && relativeFormula !== void 0 ? relativeFormula : userEnteredValue;
-        return normalizedTemplate === comparable;
-    });
-};
-var formulaHasCellReferences = function (formula) {
-    if (!formula || typeof formula !== "string" || !formula.startsWith("=")) {
-        return false;
-    }
-    var tokens = lexify(formula).tokens;
-    return tokens.some(function (token) {
-        return CELL_REFERENCE_TOKEN_NAMES.has(token.tokenType.name);
-    });
-};
-var CELL_REFERENCE_TOKEN_NAMES = new Set([
-    (_a = tokenVocabulary.Cell) === null || _a === void 0 ? void 0 : _a.name,
-    (_b = tokenVocabulary.Column) === null || _b === void 0 ? void 0 : _b.name,
-    (_c = tokenVocabulary.TableColumnName) === null || _c === void 0 ? void 0 : _c.name,
-].filter(function (tokenName) { return Boolean(tokenName); }));
-var normalizeFormulaString = function (value) {
-    if (typeof value !== "string") {
-        return undefined;
     }
-    var trimmed = value.trim();
-    if (!trimmed) {
-        return undefined;
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+        }
+        finally { if (e_2) throw e_2.error; }
     }
-    return trimmed.startsWith("=") ? trimmed : "=".concat(trimmed);
+    return true;
 };
 // Add table name to formula
 export var addTableNameToTokens = function (tokens, title) {

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); };