@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

package/dist/esm/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/esm/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/esm/api/table.js

@@ -1,11 +1,38 @@
-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";
 const isTableColumnToken = (token) => token.tokenType.name === tokenVocabulary.TableColumnName.name;
 const isTableNameToken = (token) => 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 const guessTableHasHeaders = ({ sheetId, range, getEffectiveExtendedValue, }) => {
+    if (range.endRowIndex <= range.startRowIndex) {
+        return false;
+    }
+    let sawText = false;
+    for (let columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+        const value = getEffectiveExtendedValue(sheetId, range.startRowIndex, columnIndex);
+        if (!value) {
+            continue;
+        }
+        if (!isNil(value.nv ?? value.numberValue) ||
+            !isNil(value.bv ?? value.boolValue)) {
+            return false;
+        }
+        const text = value.sv ?? value.stringValue;
+        if (!isNil(text) && text !== "") {
+            sawText = true;
+        }
+    }
+    return sawText;
+};
 /**
  * Get table column index
  * @param sheetId
@@ -63,14 +90,22 @@ export const findAdjacentTable = (sheetId, cell, tables, getUserEnteredValue) =>
                     endColumnIndex: cell.columnIndex,
                 }),
         };
+        // Excel never merges tables: a line that belongs to another table is not free to grow over.
+        if (tables?.some((other) => other.id !== table.id &&
+            other.sheetId === sheetId &&
+            areaIntersects(other.range, lookupRange))) {
+            return false;
+        }
         return (isAdjacent &&
             [...iterateCellsInRange(lookupRange)].every(([rowIndex, columnIndex]) => {
                 return isNil(getUserEnteredValue(sheetId, rowIndex, columnIndex));
             }));
     });
-    const totalRowOffset = 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.
     const isRowExpansion = adjacentTable
-        ? adjacentTable.range.endRowIndex + 1 - totalRowOffset === cell.rowIndex
+        ? adjacentTable.range.endRowIndex + 1 === cell.rowIndex &&
+            !adjacentTable.totalRow
         : false;
     const isColumnExpansion = adjacentTable
         ? adjacentTable.range.endColumnIndex + 1 === cell.columnIndex
@@ -122,62 +157,49 @@ export const findAdjacentBandedRange = (sheetId, cell, bandedRanges, getUserEnte
         : false;
     return [adjacentTable, isRowExpansion, isColumnExpansion];
 };
-// Check if table cells are fillable
-export const isTableColumnCellsFillable = (sheetId, range, excludeCell, existingColumnFormula, currentValue, activeSheetName, getUserEnteredValue) => {
-    const normalizedExistingFormula = normalizeFormulaString(existingColumnFormula);
-    const normalizedCurrentFormula = isAFormula(currentValue)
-        ? normalizeFormulaString(currentValue)
-        : undefined;
-    const templateFormula = normalizedExistingFormula ?? normalizedCurrentFormula;
-    if (!templateFormula) {
-        return false;
-    }
-    const normalizedTemplate = SheetCell.getRelativeFormula(templateFormula, excludeCell, excludeCell, activeSheetName) ?? templateFormula;
-    const templateHasReferences = formulaHasCellReferences(templateFormula);
-    const isAnchorCell = excludeCell.rowIndex === range.startRowIndex &&
-        excludeCell.columnIndex === range.startColumnIndex;
-    const 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 const isTableColumnCellsFillable = (sheetId, range, excludeCell, currentValue, activeSheetName, getUserEnteredValue) => {
+    if (!isAFormula(currentValue)) {
         return false;
     }
-    return [...iterateCellsInRange(range)].every(([rowIndex, columnIndex]) => {
+    // The column's existing formula, relativised to the edited cell — every
+    // non-empty body cell must agree on it.
+    let existingTemplate;
+    for (const [rowIndex, columnIndex] of iterateCellsInRange(range)) {
         if (rowIndex === excludeCell.rowIndex &&
             columnIndex === excludeCell.columnIndex) {
-            return true;
+            continue;
         }
         const userEnteredValue = getUserEnteredValue(sheetId, rowIndex, columnIndex);
         if (isNil(userEnteredValue) || userEnteredValue === "") {
-            return true;
+            continue;
         }
         if (!isAFormula(userEnteredValue)) {
             return false;
         }
-        const relativeFormula = SheetCell.getRelativeFormula(userEnteredValue, { rowIndex, columnIndex }, excludeCell, activeSheetName);
-        const comparable = relativeFormula ?? userEnteredValue;
-        return normalizedTemplate === comparable;
-    });
-};
-const formulaHasCellReferences = (formula) => {
-    if (!formula || typeof formula !== "string" || !formula.startsWith("=")) {
-        return false;
-    }
-    const { tokens } = lexify(formula);
-    return tokens.some((token) => CELL_REFERENCE_TOKEN_NAMES.has(token.tokenType.name));
-};
-const CELL_REFERENCE_TOKEN_NAMES = new Set([
-    tokenVocabulary.Cell?.name,
-    tokenVocabulary.Column?.name,
-    tokenVocabulary.TableColumnName?.name,
-].filter((tokenName) => Boolean(tokenName)));
-const normalizeFormulaString = (value) => {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return undefined;
+        // `$`-anchored references stay put from row to row (Excel), so they must
+        // not be shifted for the comparison.
+        const relativeFormula = SheetCell.getRelativeFormula(userEnteredValue, { rowIndex, columnIndex }, excludeCell, activeSheetName, undefined, false, undefined, undefined, true) ?? userEnteredValue;
+        if (existingTemplate === undefined) {
+            existingTemplate = relativeFormula;
+        }
+        else if (existingTemplate !== relativeFormula) {
+            return false;
+        }
     }
-    return trimmed.startsWith("=") ? trimmed : `=${trimmed}`;
+    return true;
 };
 // Add table name to formula
 export const addTableNameToTokens = (tokens, title) => {

package/dist/esm/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/esm/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";
 const 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])+)\])/;
 const URL_REGEX = /^https?:\/\/(?:www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_\+.~#?&\/=]*)$/;
@@ -144,6 +144,33 @@ export const checkBooleanRule = (rule, value, previousValue, getRangeValues, opt
                 const 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": {
+                const shift = type === "DATE_LAST_QUARTER" ? -3 : type === "DATE_NEXT_QUARTER" ? 3 : 0;
+                const firstMonth = Math.floor(today.getMonth() / 3) * 3 + shift;
+                const start = new Date(today.getFullYear(), firstMonth, 1);
+                const 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": {
+                const 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;
         }
@@ -159,9 +186,20 @@ export const checkBooleanRule = (rule, value, previousValue, getRangeValues, opt
     const { type, values } = condition;
     const valuesArray = values ?? [];
     const firstValue = valuesArray[0] ?? { userEnteredValue: "" };
+    // "All Dates in the Period" (`DATE_IN_Q1`..`Q4`, `DATE_IN_M1`..`M12`): the
+    // cell's quarter / month in any year.
+    const periodMatch = /^DATE_IN_([QM])(\d+)$/.exec(type);
+    if (periodMatch) {
+        const dateValue = toComparableDate(value);
+        if (!dateValue)
+            return false;
+        const month = dateValue.getMonth() + 1;
+        const 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":
@@ -205,17 +243,17 @@ export const checkBooleanRule = (rule, value, previousValue, getRangeValues, opt
         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) {
@@ -258,7 +296,14 @@ export const checkBooleanRule = (rule, value, previousValue, getRangeValues, opt
         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": {
             const dateValue = toComparableDate(value);
             if (!dateValue)
                 return false;

package/dist/esm/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/esm/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/esm/atoms/creating-table.atom.js

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

package/dist/esm/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/esm/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/esm/atoms/dialog-state.atom.js

@@ -6,6 +6,18 @@ export const dialogStateAtom = atomFamily(() => atom(false));
 // Edit Table Dialog
 export const useEditTableDialogState = () => useAtom(dialogStateAtom("editTable"));
 export const useSetEditTableDialogValue = () => useSetAtom(dialogStateAtom("editTable"));
+// Create Table Dialog (Ctrl+T / Insert → Table / Format as Table)
+export const useCreateTableDialogState = () => useAtom(dialogStateAtom("createTable"));
+export const useSetCreateTableDialogValue = () => useSetAtom(dialogStateAtom("createTable"));
+// Resize Table Dialog (Table Design → Resize Table)
+export const useResizeTableDialogState = () => useAtom(dialogStateAtom("resizeTable"));
+export const useSetResizeTableDialogValue = () => useSetAtom(dialogStateAtom("resizeTable"));
+// Insert Slicers Dialog (Table Design → Insert Slicer, Table → Insert Slicer…)
+export const useInsertSlicerDialogState = () => useAtom(dialogStateAtom("insertSlicer"));
+export const useSetInsertSlicerDialogValue = () => useSetAtom(dialogStateAtom("insertSlicer"));
+// Edit Slicer Dialog (Slicer → Slicer Settings…)
+export const useEditSlicerDialogState = () => useAtom(dialogStateAtom("editSlicer"));
+export const useSetEditSlicerDialogState = () => useSetAtom(dialogStateAtom("editSlicer"));
 // Delete Sheet Confirmation Dialog
 export const useDeletSheetConfirmationDialogState = () => useAtom(dialogStateAtom("deleteSheet"));
 // Edit Named Range Dialog

package/dist/esm/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/esm/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/esm/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 const editingSlicerAtom = atom(undefined);
+export const useEditingSlicer = () => useAtomValue(editingSlicerAtom);
+export const useSetEditingSlicer = () => useSetAtom(editingSlicerAtom);
+export const useEditingSlicerState = () => useAtom(editingSlicerAtom);

package/dist/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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 const insertingSlicerAtom = atom(undefined);
+export const useInsertingSlicer = () => useAtomValue(insertingSlicerAtom);
+export const useSetInsertingSlicer = () => useSetAtom(insertingSlicerAtom);

package/dist/esm/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/esm/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/esm/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 const resizingTableAtom = atom(undefined);
+export const useResizingTable = () => useAtomValue(resizingTableAtom);
+export const useSetResizingTable = () => useSetAtom(resizingTableAtom);