@rowsncolumns/spreadsheet 10.3.1 → 10.4.0

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,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,0BAMvC,CAAC"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../api/table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAc,SAAS,EAAsB,MAAM,oBAAoB,CAAC;AAE/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,0BAMvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,SAAS,EAChB,YAAY,SAAS,MAAM,EAAE,KAC5B,MAAM,EAOR,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,SAAS,EAChB,MAAM,aAAa,EACnB,WAAW,SAAS,EACpB,cAAc,UAAU,EACxB,iBAAiB,UAAU,KAC1B,cAAc,GAAG,IAwDnB,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,GAAI,OAAO,SAAS,KAAG,SAUpD,CAAC;AAcF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,SAAS,EAChB,SAAS,SAAS,GAAG,SAAS,KAC7B,SAAS,GAAG,IASd,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,SAAS,EAChB,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACvC,SAAS,SAAS,GAAG,SAAS,KAC7B,SAAS,GAAG,IA4Bd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,SAAS,EAChB,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACpC,SAAS,SAAS,GAAG,SAAS,KAC7B,SAAS,GAAG,IAed,CAAC"}

package/dist/esm/api/table.js

@@ -1,4 +1,4 @@
-import { isCellWithinBounds } from "@rowsncolumns/grid";
+import { clampIndex, Direction, isCellWithinBounds } from "@rowsncolumns/grid";
 /**
  * Find table withing a cell
  * @param sheetId
@@ -9,3 +9,140 @@ import { isCellWithinBounds } from "@rowsncolumns/grid";
 export const findActiveTableWithinCell = (sheetId, cell, tables) => {
     return tables?.find((table) => table.sheetId === sheetId && isCellWithinBounds(cell, table.range));
 };
+/**
+ * The rows of `rowIndexes` that "Delete table rows" may remove: the table's body rows. Excel never
+ * deletes the header row or the totals row this way — both are dropped from the request.
+ */
+export const getDeletableTableRowIndexes = (table, rowIndexes) => {
+    const firstBodyRow = table.range.startRowIndex + ((table.headerRow ?? true) ? 1 : 0);
+    const lastBodyRow = table.range.endRowIndex - (table.totalRow ? 1 : 0);
+    return rowIndexes.filter((rowIndex) => rowIndex >= firstBodyRow && rowIndex <= lastBodyRow);
+};
+/**
+ * Excel's Tab / Shift+Tab inside a table. Tab walks the table's columns and
+ * wraps to the first column of the next row; on the last cell of the last
+ * data row it adds a data row and lands in its first column. Shift+Tab walks
+ * back and wraps to the last column of the row above. Returns null when the
+ * table has no opinion — the totals row, Shift+Tab off the table's first
+ * cell and every other direction navigate the sheet as usual.
+ */
+export const getNextCellInTable = (table, cell, direction, isHiddenRow, isHiddenColumn) => {
+    const { range } = table;
+    const lastDataRowIndex = table.totalRow
+        ? range.endRowIndex - 1
+        : range.endRowIndex;
+    if (cell.rowIndex > lastDataRowIndex) {
+        return null;
+    }
+    if (direction === Direction.Right) {
+        const columnIndex = clampIndex(cell.columnIndex + 1, isHiddenColumn, Direction.Right);
+        if (columnIndex <= range.endColumnIndex) {
+            return { cell: { rowIndex: cell.rowIndex, columnIndex } };
+        }
+        const firstColumnIndex = clampIndex(range.startColumnIndex, isHiddenColumn, Direction.Right);
+        const rowIndex = clampIndex(cell.rowIndex + 1, isHiddenRow, Direction.Down);
+        if (rowIndex <= lastDataRowIndex) {
+            return { cell: { rowIndex, columnIndex: firstColumnIndex } };
+        }
+        return {
+            cell: { rowIndex: lastDataRowIndex + 1, columnIndex: firstColumnIndex },
+            insertRow: true,
+        };
+    }
+    if (direction === Direction.Left) {
+        const columnIndex = clampIndex(cell.columnIndex - 1, isHiddenColumn, Direction.Left);
+        if (columnIndex >= range.startColumnIndex) {
+            return { cell: { rowIndex: cell.rowIndex, columnIndex } };
+        }
+        const rowIndex = clampIndex(cell.rowIndex - 1, isHiddenRow, Direction.Up);
+        if (rowIndex < range.startRowIndex) {
+            return null;
+        }
+        return {
+            cell: {
+                rowIndex,
+                columnIndex: clampIndex(range.endColumnIndex, isHiddenColumn, Direction.Left),
+            },
+        };
+    }
+    return null;
+};
+/** The table's data body: its rows without the header and totals rows. */
+export const getTableBodyRange = (table) => {
+    const { range } = table;
+    const firstBodyRow = range.startRowIndex + ((table.headerRow ?? true) ? 1 : 0);
+    const lastDataRow = range.endRowIndex - (table.totalRow ? 1 : 0);
+    return {
+        ...range,
+        startRowIndex: Math.min(firstBodyRow, range.endRowIndex),
+        endRowIndex: Math.max(lastDataRow, firstBodyRow),
+    };
+};
+const isSameRange = (a, b) => !!a &&
+    a.startRowIndex === b.startRowIndex &&
+    a.endRowIndex === b.endRowIndex &&
+    a.startColumnIndex === b.startColumnIndex &&
+    a.endColumnIndex === b.endColumnIndex;
+const clipSpan = (start, end, lo, hi) => ({
+    start: Math.max(Math.min(start, end), lo),
+    end: Math.min(Math.max(start, end), hi),
+});
+/**
+ * Excel's Ctrl+A inside a table cycles data body → whole table (header and
+ * totals included) → whole sheet. `current` is the single selected area, if
+ * any; `null` means "select the whole sheet".
+ */
+export const getTableSelectAllRange = (table, current) => {
+    const body = getTableBodyRange(table);
+    if (isSameRange(current, table.range)) {
+        return null;
+    }
+    if (isSameRange(current, body)) {
+        return { ...table.range };
+    }
+    return body;
+};
+/**
+ * Excel's Ctrl+Space inside a table: the table column data first, the entire
+ * table column (header and totals included) second, the sheet column third
+ * (`null`). `columns` is the selected column span.
+ */
+export const getTableColumnSelectRange = (table, columns, current) => {
+    const { range } = table;
+    const span = clipSpan(columns.start, columns.end, range.startColumnIndex, range.endColumnIndex);
+    const body = getTableBodyRange(table);
+    const data = {
+        startRowIndex: body.startRowIndex,
+        endRowIndex: body.endRowIndex,
+        startColumnIndex: span.start,
+        endColumnIndex: span.end,
+    };
+    const entire = {
+        startRowIndex: range.startRowIndex,
+        endRowIndex: range.endRowIndex,
+        startColumnIndex: span.start,
+        endColumnIndex: span.end,
+    };
+    if (isSameRange(current, entire)) {
+        return null;
+    }
+    if (isSameRange(current, data)) {
+        return entire;
+    }
+    return data;
+};
+/**
+ * Excel's Shift+Space inside a table: the table row(s) first, the sheet
+ * row(s) second (`null`). `rows` is the selected row span.
+ */
+export const getTableRowSelectRange = (table, rows, current) => {
+    const { range } = table;
+    const span = clipSpan(rows.start, rows.end, range.startRowIndex, range.endRowIndex);
+    const tableRow = {
+        startRowIndex: span.start,
+        endRowIndex: span.end,
+        startColumnIndex: range.startColumnIndex,
+        endColumnIndex: range.endColumnIndex,
+    };
+    return isSameRange(current, tableRow) ? null : tableRow;
+};

package/dist/esm/api/validation.d.ts

@@ -1,5 +1,5 @@
 import type { CellInterface, GridRange } from "@rowsncolumns/grid";
-import type { CellData, ConditionType, ConditionValue, CustomFormulaResult, DataValidationRule, DataValidationRuleAlert, FilterCriteria, Maybe, ProtectedRange, SheetProtection, TimePeriodTypes } from "../types";
+import type { BooleanCondition, CellData, ConditionType, ConditionValue, CustomFormulaResult, DataValidationRule, DataValidationRuleAlert, FilterCriteria, Maybe, ProtectedRange, SheetProtection, TimePeriodTypes } from "../types";
 export type CheckBooleanRuleOptions = {
     locale?: string;
 };
@@ -11,6 +11,31 @@ export type CheckBooleanRuleOptions = {
  */
 export declare const checkBooleanRule: <T extends CellData>(rule?: DataValidationRule | undefined, value?: CustomFormulaResult, previousValue?: CustomFormulaResult, getRangeValues?: (address: string) => ConditionValue[], options?: CheckBooleanRuleOptions) => boolean | undefined;
 export declare const checkFilterRule: (filterCriteria: FilterCriteria, value?: CustomFormulaResult) => boolean | undefined;
+/** One AutoFilter clause (`filterCriteria.condition` or `.condition2`) against a cell value. */
+export declare const checkFilterCondition: (condition: BooleanCondition, value?: CustomFormulaResult) => boolean | undefined;
+/**
+ * Filter conditions decided against the whole column rather than one cell:
+ * Excel's "Top 10…" (N items / N percent, largest or smallest) and Above /
+ * Below Average. Only numeric cells take part — text, blanks, booleans and
+ * errors never rank and are hidden while such a filter is active.
+ */
+export declare const AGGREGATE_FILTER_CONDITION_TYPES: ReadonlySet<ConditionType>;
+export declare const isAggregateFilterCondition: (condition: Maybe<BooleanCondition> | undefined) => boolean;
+export type AggregateFilterThreshold = {
+    op: ">" | ">=" | "<" | "<=";
+    bound: number;
+};
+/**
+ * The per-column cutoff an aggregate filter compares every cell against,
+ * computed once from the column's numeric values. Top/Bottom N keep the N
+ * largest/smallest items including ties at the boundary (Excel keeps every
+ * row equal to the Nth value); the percent variants convert N% of the
+ * numeric count to an item count, rounded up to at least one. `undefined`
+ * when the column holds no numbers or N is not a positive number — nothing
+ * passes then (`passesAggregateFilterThreshold` is `false`).
+ */
+export declare const resolveAggregateFilterThreshold: (condition: BooleanCondition, columnValues: readonly number[]) => AggregateFilterThreshold | undefined;
+export declare const passesAggregateFilterThreshold: (threshold: AggregateFilterThreshold | undefined, value: unknown) => boolean;
 export declare const validationValueToDate: (value: string | TimePeriodTypes) => Date;
 /**
  * A small helper function for list validation

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

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../api/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AASnE,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EAEvB,cAAc,EACd,KAAK,EACL,cAAc,EACd,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AA6CF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EACjD,OAAO,kBAAkB,GAAG,SAAS,EACrC,QAAQ,mBAAmB,EAC3B,gBAAgB,mBAAmB,EACnC,iBAAiB,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,EAAE,EACtD,UAAU,uBAAuB,wBAgVlC,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,gBAAgB,cAAc,EAC9B,QAAQ,mBAAmB,wBAM5B,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,GAAG,eAAe,SA+BpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,kBAAkB,GAAG,IAAI,GAAG,SAAS,YAO7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EACf,MAAM,aAAa,EACnB,iBAAiB,cAAc,EAAE,YA2BlC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,MAAM,EACf,kBAAkB,cAAc,EAAE,YAcnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,eAAe,GACf,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,kBAAkB,GAClB,eAAe,GACf,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,aAAa,GACb,YAAY,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,kBAAkB,KAAK,CAAC,eAAe,CAAC,KACvC,OAA0C,CAAC;AAE9C;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,GAC3C,iBAAiB,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,EACnD,QAAQ,qBAAqB,KAC5B,OAQF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GACtC,iBAAiB,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,EACnD,gBAAgB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,KACzE,OAC2E,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,MAAM,EACf,OAAO,SAAS,EAChB,iBAAiB,cAAc,EAAE,GAAG,SAAS,GAAG,IAAI,wBAWrD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,OAAO,SAAS,EAChB,iBAAiB,cAAc,EAAE,GAAG,SAAS,+BAW9C,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,OAAO,KAAK,CAAC,aAAa,CAAC,YAGjE,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,KAAK,CAAC,uBAAuB,CAAC,EACrC,SAAS,OAAO,KACf,wBAKF,CAAC"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../api/validation.ts"],"names":[],"mappings":"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"}

package/dist/esm/api/validation.js

@@ -1,5 +1,5 @@
 import { isCellWithinBounds } from "@rowsncolumns/grid";
-import { escapeCharacters, isNil, toDate, toSerial } from "@rowsncolumns/utils";
+import { escapeCharacters, isNil, matchesWildcardPattern, toDate, toSerial, } from "@rowsncolumns/utils";
 import { EMAIL_REGEX, URL_REGEX } from "../config";
 import { checkIfStringIsReference, splitDataValidationListValues, } from "../helpers";
 /**
@@ -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;
         }
@@ -162,9 +189,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":
@@ -209,17 +247,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": {
             // Validate allowBlank
@@ -262,7 +300,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;
@@ -300,10 +345,75 @@ export const checkBooleanRule = (rule, value, previousValue, getRangeValues, opt
 };
 export const checkFilterRule = (filterCriteria, value) => {
     if (filterCriteria.condition) {
-        return checkBooleanRule({ condition: filterCriteria.condition }, value);
+        return checkFilterCondition(filterCriteria.condition, value);
     }
     return false;
 };
+/** One AutoFilter clause (`filterCriteria.condition` or `.condition2`) against a cell value. */
+export const checkFilterCondition = (condition, value) => checkBooleanRule({ condition }, value);
+/**
+ * Filter conditions decided against the whole column rather than one cell:
+ * Excel's "Top 10…" (N items / N percent, largest or smallest) and Above /
+ * Below Average. Only numeric cells take part — text, blanks, booleans and
+ * errors never rank and are hidden while such a filter is active.
+ */
+export const AGGREGATE_FILTER_CONDITION_TYPES = new Set([
+    "NUMBER_TOP_N",
+    "NUMBER_BOTTOM_N",
+    "NUMBER_TOP_PERCENT",
+    "NUMBER_BOTTOM_PERCENT",
+    "NUMBER_ABOVE_AVERAGE",
+    "NUMBER_BELOW_AVERAGE",
+]);
+export const isAggregateFilterCondition = (condition) => !!condition?.type && AGGREGATE_FILTER_CONDITION_TYPES.has(condition.type);
+/**
+ * The per-column cutoff an aggregate filter compares every cell against,
+ * computed once from the column's numeric values. Top/Bottom N keep the N
+ * largest/smallest items including ties at the boundary (Excel keeps every
+ * row equal to the Nth value); the percent variants convert N% of the
+ * numeric count to an item count, rounded up to at least one. `undefined`
+ * when the column holds no numbers or N is not a positive number — nothing
+ * passes then (`passesAggregateFilterThreshold` is `false`).
+ */
+export const resolveAggregateFilterThreshold = (condition, columnValues) => {
+    const numbers = columnValues.filter((n) => Number.isFinite(n));
+    if (!numbers.length || !condition.type)
+        return undefined;
+    const type = condition.type;
+    if (type === "NUMBER_ABOVE_AVERAGE" || type === "NUMBER_BELOW_AVERAGE") {
+        const mean = numbers.reduce((sum, n) => sum + n, 0) / numbers.length;
+        return { op: type === "NUMBER_ABOVE_AVERAGE" ? ">" : "<", bound: mean };
+    }
+    const n = Number(condition.values?.[0]?.userEnteredValue);
+    if (!Number.isFinite(n) || n <= 0)
+        return undefined;
+    const top = type === "NUMBER_TOP_N" || type === "NUMBER_TOP_PERCENT";
+    const percent = type === "NUMBER_TOP_PERCENT" || type === "NUMBER_BOTTOM_PERCENT";
+    const count = Math.min(numbers.length, Math.max(1, percent ? Math.ceil((numbers.length * n) / 100) : Math.floor(n)));
+    const sorted = [...numbers].sort((a, b) => (top ? b - a : a - b));
+    return { op: top ? ">=" : "<=", bound: sorted[count - 1] };
+};
+export const passesAggregateFilterThreshold = (threshold, value) => {
+    if (!threshold)
+        return false;
+    const num = typeof value === "number"
+        ? value
+        : typeof value === "string" && value.trim() !== ""
+            ? Number(value)
+            : NaN;
+    if (!Number.isFinite(num))
+        return false;
+    switch (threshold.op) {
+        case ">":
+            return num > threshold.bound;
+        case ">=":
+            return num >= threshold.bound;
+        case "<":
+            return num < threshold.bound;
+        default:
+            return num <= threshold.bound;
+    }
+};
 export const validationValueToDate = (value) => {
     switch (value) {
         case "today":

package/dist/esm/atoms/calculated-column-fill.atom.d.ts

@@ -0,0 +1,15 @@
+import type { CalculatedColumnFill } from "../api/calculated-column-fill";
+/**
+ * The calculated column a typed formula just created (or could create), waiting for Excel's
+ * AutoCorrect smart tag ("Undo Calculated Column" / "Overwrite all cells in this column with this
+ * formula" / "Stop automatically creating calculated columns"). Set by the engines' calculated-column
+ * path (`useOnChangeCalculatedColumn` in `@rowsncolumns/spreadsheet-state`; the rnc engine's commit
+ * fold), read by `CanvasGrid`. Dropped when the user moves away from the column or switches sheet.
+ */
+export declare const calculatedColumnFillAtom: import("jotai").PrimitiveAtom<CalculatedColumnFill | null> & {
+    init: CalculatedColumnFill | null;
+};
+export declare const useCalculatedColumnFillState: () => [CalculatedColumnFill | null, (args_0: CalculatedColumnFill | ((prev: CalculatedColumnFill | null) => CalculatedColumnFill | null) | null) => void];
+export declare const useCalculatedColumnFillValue: () => CalculatedColumnFill | null;
+export declare const useSetCalculatedColumnFill: () => (args_0: CalculatedColumnFill | ((prev: CalculatedColumnFill | null) => CalculatedColumnFill | null) | null) => void;
+//# sourceMappingURL=calculated-column-fill.atom.d.ts.map

package/dist/esm/atoms/calculated-column-fill.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculated-column-fill.atom.d.ts","sourceRoot":"","sources":["../../../atoms/calculated-column-fill.atom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;CAA0C,CAAC;AAEhF,eAAO,MAAM,4BAA4B,2JAA0C,CAAC;AACpF,eAAO,MAAM,4BAA4B,mCAA+C,CAAC;AACzF,eAAO,MAAM,0BAA0B,4HAA6C,CAAC"}

package/dist/esm/atoms/calculated-column-fill.atom.js

@@ -0,0 +1,12 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+/**
+ * The calculated column a typed formula just created (or could create), waiting for Excel's
+ * AutoCorrect smart tag ("Undo Calculated Column" / "Overwrite all cells in this column with this
+ * formula" / "Stop automatically creating calculated columns"). Set by the engines' calculated-column
+ * path (`useOnChangeCalculatedColumn` in `@rowsncolumns/spreadsheet-state`; the rnc engine's commit
+ * fold), read by `CanvasGrid`. Dropped when the user moves away from the column or switches sheet.
+ */
+export const calculatedColumnFillAtom = atom(null);
+export const useCalculatedColumnFillState = () => useAtom(calculatedColumnFillAtom);
+export const useCalculatedColumnFillValue = () => useAtomValue(calculatedColumnFillAtom);
+export const useSetCalculatedColumnFill = () => useSetAtom(calculatedColumnFillAtom);

package/dist/esm/atoms/chart-actions.atom.d.ts

@@ -0,0 +1,40 @@
+import type { EmbeddedChart } from "../types";
+/**
+ * Actions only the chart renderer can perform (they need the live chart
+ * instance or the host's editor). A renderer registers them per chart so
+ * the grid's right-click menu can offer them without knowing the renderer.
+ */
+export type EmbeddedChartActions = {
+    /** Open the host's chart editor for this chart. */
+    requestEdit?(): void;
+    /** Rasterise the chart as it is drawn and download it as a PNG. */
+    downloadPng?(): void;
+    /**
+     * Rasterise the chart as it is drawn to a PNG blob — Copy as Picture and
+     * the print preview draw from it. Resolves `undefined` when the renderer
+     * has no live instance to capture.
+     */
+    exportPng?(): Promise<Blob | undefined>;
+    /**
+     * Excel's "Switch Row/Column": re-derive the series the other way
+     * through the data range and persist the chart. Absent when the chart's
+     * sources cannot be transposed or the host gave the renderer no update
+     * callback.
+     */
+    switchRowColumn?(): void;
+};
+export declare const chartActionsAtom: import("jotai").PrimitiveAtom<Record<string, EmbeddedChartActions | undefined>> & {
+    init: Record<string, EmbeddedChartActions | undefined>;
+};
+/**
+ * Register the renderer-side actions of a chart for the lifetime of the
+ * component. Callers pass fresh closures every render; the registered
+ * entry only changes when an action appears or disappears.
+ */
+export declare const useRegisterChartActions: (chartId: EmbeddedChart["chartId"], actions: EmbeddedChartActions) => void;
+/**
+ * Non-subscribing reader: the grid looks actions up when a menu opens, so
+ * registrations never re-render the grid.
+ */
+export declare const useGetChartActions: () => (chartId: EmbeddedChart["chartId"]) => EmbeddedChartActions | undefined;
+//# sourceMappingURL=chart-actions.atom.d.ts.map

package/dist/esm/atoms/chart-actions.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-actions.atom.d.ts","sourceRoot":"","sources":["../../../atoms/chart-actions.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,mDAAmD;IACnD,WAAW,CAAC,IAAI,IAAI,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,IAAI,IAAI,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IACxC;;;;;OAKG;IACH,eAAe,CAAC,IAAI,IAAI,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;CAExB,CAAC;AAEN;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,aAAa,CAAC,SAAS,CAAC,EACjC,SAAS,oBAAoB,SA4C9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,kBAGjB,aAAa,CAAC,SAAS,CAAC,KAAG,oBAAoB,GAAG,SAI/D,CAAC"}

package/dist/esm/atoms/chart-actions.atom.js

@@ -0,0 +1,58 @@
+import { atom, useSetAtom, useStore } from "jotai";
+import { useCallback, useEffect, useRef } from "react";
+export const chartActionsAtom = atom({});
+/**
+ * Register the renderer-side actions of a chart for the lifetime of the
+ * component. Callers pass fresh closures every render; the registered
+ * entry only changes when an action appears or disappears.
+ */
+export const useRegisterChartActions = (chartId, actions) => {
+    const setChartActions = useSetAtom(chartActionsAtom);
+    const actionsRef = useRef(actions);
+    actionsRef.current = actions;
+    const hasRequestEdit = !!actions.requestEdit;
+    const hasDownloadPng = !!actions.downloadPng;
+    const hasExportPng = !!actions.exportPng;
+    const hasSwitchRowColumn = !!actions.switchRowColumn;
+    useEffect(() => {
+        const key = String(chartId);
+        setChartActions((prev) => ({
+            ...prev,
+            [key]: {
+                requestEdit: hasRequestEdit
+                    ? () => actionsRef.current.requestEdit?.()
+                    : undefined,
+                downloadPng: hasDownloadPng
+                    ? () => actionsRef.current.downloadPng?.()
+                    : undefined,
+                exportPng: hasExportPng
+                    ? () => actionsRef.current.exportPng?.() ?? Promise.resolve(undefined)
+                    : undefined,
+                switchRowColumn: hasSwitchRowColumn
+                    ? () => actionsRef.current.switchRowColumn?.()
+                    : undefined,
+            },
+        }));
+        return () => {
+            setChartActions((prev) => {
+                const { [key]: _removed, ...rest } = prev;
+                return rest;
+            });
+        };
+    }, [
+        chartId,
+        hasRequestEdit,
+        hasDownloadPng,
+        hasExportPng,
+        hasSwitchRowColumn,
+        setChartActions,
+    ]);
+};
+/**
+ * Non-subscribing reader: the grid looks actions up when a menu opens, so
+ * registrations never re-render the grid.
+ */
+export const useGetChartActions = () => {
+    const store = useStore();
+    return useCallback((chartId) => store.get(chartActionsAtom)[String(chartId)], [store]);
+};

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

@@ -10,6 +10,7 @@ export * from "./sheet-status-display.atom";
 export * from "./spreadsheet-api.atom";
 export { useLoadingIndicator } from "./loading-indicator.atom";
 export * from "./selected-chart-embed.atom";
+export * from "./selected-chart-series.atom";
 export * from "./popover.atom";
 export * from "./paste-menu.atom";
 export * from "./fill-options.atom";
@@ -25,4 +26,8 @@ export * from "./remove-duplicates-dialog.atom";
 export * from "./watch-window.atom";
 export * from "./insert-cells-dialog.atom";
 export * from "./insert-options.atom";
+export * from "./chart-actions.atom";
+export * from "./table-auto-expansion.atom";
+export * from "./calculated-column-fill.atom";
+export * from "./sparkline-dialog.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,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC"}

package/dist/esm/atoms/index.js

@@ -10,6 +10,7 @@ export * from "./sheet-status-display.atom";
 export * from "./spreadsheet-api.atom";
 export { useLoadingIndicator } from "./loading-indicator.atom";
 export * from "./selected-chart-embed.atom";
+export * from "./selected-chart-series.atom";
 export * from "./popover.atom";
 export * from "./paste-menu.atom";
 export * from "./fill-options.atom";
@@ -25,3 +26,7 @@ export * from "./remove-duplicates-dialog.atom";
 export * from "./watch-window.atom";
 export * from "./insert-cells-dialog.atom";
 export * from "./insert-options.atom";
+export * from "./chart-actions.atom";
+export * from "./table-auto-expansion.atom";
+export * from "./calculated-column-fill.atom";
+export * from "./sparkline-dialog.atom";

package/dist/esm/atoms/move-chart-dialog.atom.d.ts

@@ -0,0 +1,28 @@
+import type { EmbeddedChart } from "../types";
+/**
+ * Open-state + payload for Excel's "Move Chart…" dialog (chart context menu /
+ * chart editor). The grid opens it with the chart; the host-mounted dialog
+ * routes the chosen target through the host's `onMoveChartToSheet`.
+ */
+export type MoveChartDialogRequest = {
+    chart: EmbeddedChart;
+};
+export declare const moveChartDialogAtom: import("jotai").PrimitiveAtom<MoveChartDialogRequest | null> & {
+    init: MoveChartDialogRequest | null;
+};
+export declare const useMoveChartDialogState: () => [MoveChartDialogRequest | null, (args_0: MoveChartDialogRequest | ((prev: MoveChartDialogRequest | null) => MoveChartDialogRequest | null) | null) => void];
+/**
+ * Number of mounted `MoveChartDialogHost`s. The chart context menu only
+ * offers "Move chart…" while a host is mounted, so a host that has not
+ * adopted the dialog never gets a dead item.
+ */
+export declare const moveChartDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `MoveChartDialogHost` is mounted. */
+export declare const useIsMoveChartDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterMoveChartDialogHost: () => void;
+/** Returns a function that opens the host-mounted "Move Chart…" dialog. */
+export declare const useOpenMoveChartDialog: () => (request: MoveChartDialogRequest) => void;
+//# sourceMappingURL=move-chart-dialog.atom.d.ts.map

package/dist/esm/atoms/move-chart-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-chart-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/move-chart-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9D,eAAO,MAAM,mBAAmB;;CAA4C,CAAC;AAE7E,eAAO,MAAM,uBAAuB,mKAAqC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;CAAU,CAAC;AAEpD,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,eACQ,CAAC;AAEjD,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,YAM1C,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,kBAGrB,sBAAsB,SAGnC,CAAC"}

package/dist/esm/atoms/move-chart-dialog.atom.js

@@ -0,0 +1,25 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+import { useCallback, useEffect } from "react";
+export const moveChartDialogAtom = atom(null);
+export const useMoveChartDialogState = () => useAtom(moveChartDialogAtom);
+/**
+ * Number of mounted `MoveChartDialogHost`s. The chart context menu only
+ * offers "Move chart…" while a host is mounted, so a host that has not
+ * adopted the dialog never gets a dead item.
+ */
+export const moveChartDialogHostCountAtom = atom(0);
+/** True when at least one `MoveChartDialogHost` is mounted. */
+export const useIsMoveChartDialogMounted = () => useAtomValue(moveChartDialogHostCountAtom) > 0;
+/** Registers the calling component as a dialog host for its lifetime. */
+export const useRegisterMoveChartDialogHost = () => {
+    const setCount = useSetAtom(moveChartDialogHostCountAtom);
+    useEffect(() => {
+        setCount((count) => count + 1);
+        return () => setCount((count) => count - 1);
+    }, [setCount]);
+};
+/** Returns a function that opens the host-mounted "Move Chart…" dialog. */
+export const useOpenMoveChartDialog = () => {
+    const setRequest = useSetAtom(moveChartDialogAtom);
+    return useCallback((request) => setRequest(request), [setRequest]);
+};

package/dist/esm/atoms/selected-chart-embed.atom.d.ts

@@ -1,6 +1,14 @@
+import type { SetStateAction } from "react";
+import type { EmbeddedObject } from "../types";
 export declare const selectedChartEmbedAtom: import("jotai").PrimitiveAtom<string | number | undefined> & {
     init: string | number | undefined;
 };
 export declare const useSelectedChartEmbed: () => [string | number | undefined, (args_0: string | number | ((prev: string | number | undefined) => string | number | undefined) | undefined) => void];
-export declare const useFocusEmbedOrChart: () => (args_0: string | number | ((prev: string | number | undefined) => string | number | undefined) | undefined) => void;
+/**
+ * Select a chart / picture the way Excel does after inserting or restoring one: the object is
+ * selected and scrolled into view (`CanvasGridMethods.scrollToChart`, once the grid renders it).
+ * A functional update only re-derives the selection (an undo step deselecting a removed object)
+ * and clearing it never scrolls.
+ */
+export declare const useFocusEmbedOrChart: () => (update: SetStateAction<EmbeddedObject["embedId"] | undefined>) => void;
 //# sourceMappingURL=selected-chart-embed.atom.d.ts.map

package/dist/esm/atoms/selected-chart-embed.atom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selected-chart-embed.atom.d.ts","sourceRoot":"","sources":["../../../atoms/selected-chart-embed.atom.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB;;CAEvB,CAAC;AAEb,eAAO,MAAM,qBAAqB,2JAAwC,CAAC;AAE3E,eAAO,MAAM,oBAAoB,4HAA2C,CAAC"}
+{"version":3,"file":"selected-chart-embed.atom.d.ts","sourceRoot":"","sources":["../../../atoms/selected-chart-embed.atom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,eAAO,MAAM,sBAAsB;;CAEvB,CAAC;AAEb,eAAO,MAAM,qBAAqB,2JAAwC,CAAC;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,iBAIpB,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,SAQjE,CAAC"}