@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

package/dist/cjs/api/insert-cut-cells.js

@@ -0,0 +1,60 @@
+import { __assign, __read } from "tslib";
+import { areaIntersects } from "@rowsncolumns/grid";
+var LAST_INDEX = Number.MAX_SAFE_INTEGER;
+/**
+ * Excel "Insert Cut Cells" / Shift+drag of a cell block, as the three structural steps the
+ * legacy hooks already own: open the destination band (`insertCells…` at `to`), move the block
+ * into the opening, then close the gap the block left (`deleteCells…` on the vacated source).
+ * The sheet keeps its cell count — Shift+drag A5 to A2 over r1..r6 gives r1 r5 r2 r3 r4 r6, never
+ * a blank — and a forward move within its own lanes lands `size` lines before `to`, Excel's
+ * pre-removal reference (cut A2, drop at row 6 → r1 r3 r4 r5 r2 r6), because the closing shift
+ * pulls the landed block up. `null` when the move is a no-op (the drop is inside the block or
+ * right after it) or cannot land the block whole (destination lanes overlapping the source
+ * lanes only partially — the closing shift would tear the block); the rnc engine's
+ * `move-range { insert }` applies the same rules.
+ */
+export var planInsertCutCells = function (from, to) {
+    if (areaIntersects(from, to)) {
+        return null;
+    }
+    var shift = to.startRowIndex === from.startRowIndex ? "right" : "down";
+    var vertical = shift === "down";
+    // (line, lane): the axis the bands shift along, and the perpendicular index.
+    var _a = __read(vertical
+        ? [
+            from.startRowIndex,
+            from.endRowIndex,
+            from.startColumnIndex,
+            from.endColumnIndex,
+            to.startRowIndex,
+            to.startColumnIndex,
+        ]
+        : [
+            from.startColumnIndex,
+            from.endColumnIndex,
+            from.startRowIndex,
+            from.endRowIndex,
+            to.startColumnIndex,
+            to.startRowIndex,
+        ], 6), l1 = _a[0], l2 = _a[1], k1 = _a[2], k2 = _a[3], t = _a[4], tk1 = _a[5];
+    var size = l2 - l1 + 1;
+    var tk2 = tk1 + (k2 - k1);
+    var lanesMeet = tk1 <= k2 && tk2 >= k1;
+    if (lanesMeet && tk1 !== k1) {
+        return null;
+    }
+    if (lanesMeet && t > l1 && t <= l2 + 1) {
+        return null;
+    }
+    // Opening the destination band above the block slides the block along with it.
+    var slides = lanesMeet && t < l1;
+    var shiftedSource = !slides
+        ? from
+        : vertical
+            ? __assign(__assign({}, from), { startRowIndex: from.startRowIndex + size, endRowIndex: from.endRowIndex + size }) : __assign(__assign({}, from), { startColumnIndex: from.startColumnIndex + size, endColumnIndex: from.endColumnIndex + size });
+    var band = function (range) {
+        return vertical
+            ? __assign(__assign({}, range), { endRowIndex: LAST_INDEX }) : __assign(__assign({}, range), { endColumnIndex: LAST_INDEX });
+    };
+    return { shift: shift, shiftedSource: shiftedSource, bands: [band(to), band(from)] };
+};

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

@@ -1,4 +1,12 @@
 import type { GridRange } from "@rowsncolumns/common-types";
+/** Excel's refusal when a move / cut-paste / shift would tear a merged cell. */
+export declare const MERGED_CELL_MOVE_ERROR = "We can't do that to a merged cell.";
+/**
+ * The first merge that `range` covers only PARTIALLY (it intersects the range without being
+ * wholly inside it). Excel refuses any move, cut + paste or cell shift whose source or destination
+ * does that ("We can't do that to a merged cell."); merges wholly inside the range travel intact.
+ */
+export declare const findPartiallyCoveredMerge: (range: GridRange, merges: GridRange[] | undefined | null) => GridRange | undefined;
 export declare const moveMergedCells: (mergedCells: GridRange[] | undefined | null, op: "column-insert" | "row-insert" | "column-remove" | "row-remove", referenceIndex: number, count?: number, condition?: (area: GridRange) => boolean) => GridRange[] | null | undefined;
 export declare const shrinkMergesOnRowDelete: (merges: GridRange[], deleteStart: number, deleteCount: number) => GridRange[];
 export declare const shrinkMergesOnColumnDelete: (merges: GridRange[], deleteStart: number, deleteCount: number) => GridRange[];

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

@@ -1 +1 @@
-{"version":3,"file":"merges.d.ts","sourceRoot":"","sources":["../../../api/merges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAY5D,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EAC3C,IAAI,eAAe,GAAG,YAAY,GAAG,eAAe,GAAG,YAAY,EACnE,gBAAgB,MAAM,EACtB,cAAS,EACT,YAAY,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,mCA2DzC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EACtC,MAAM,KAAK,GAAG,QAAQ,EACtB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,QAAQ,OAAO,EACf,WAAW,MAAM,EACjB,SAAS,MAAM,mCAkDhB,CAAC"}
+{"version":3,"file":"merges.d.ts","sourceRoot":"","sources":["../../../api/merges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,uCAAuC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,SAAS,EAChB,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,KACrC,SAAS,GAAG,SAGZ,CAAC;AAYJ,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EAC3C,IAAI,eAAe,GAAG,YAAY,GAAG,eAAe,GAAG,YAAY,EACnE,gBAAgB,MAAM,EACtB,cAAS,EACT,YAAY,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,mCA2DzC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EACtC,MAAM,KAAK,GAAG,QAAQ,EACtB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,QAAQ,OAAO,EACf,WAAW,MAAM,EACjB,SAAS,MAAM,mCAkDhB,CAAC"}

package/dist/cjs/api/merges.js

@@ -1,4 +1,15 @@
 import { __assign, __values } from "tslib";
+import { areaInsideArea, areaIntersects } from "@rowsncolumns/grid";
+/** Excel's refusal when a move / cut-paste / shift would tear a merged cell. */
+export var MERGED_CELL_MOVE_ERROR = "We can't do that to a merged cell.";
+/**
+ * The first merge that `range` covers only PARTIALLY (it intersects the range without being
+ * wholly inside it). Excel refuses any move, cut + paste or cell shift whose source or destination
+ * does that ("We can't do that to a merged cell."); merges wholly inside the range travel intact.
+ */
+export var findPartiallyCoveredMerge = function (range, merges) {
+    return merges === null || merges === void 0 ? void 0 : merges.find(function (merge) { return areaIntersects(merge, range) && !areaInsideArea(merge, range); });
+};
 /**
  * Move merged cells when user is inserts, deletes row and columns
  * @param mergedCells

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

@@ -1,4 +1,9 @@
 import type { CellFormat, CellInterface, GridRange } from "@rowsncolumns/common-types";
+import type { CellData } from "@rowsncolumns/spreadsheet";
+import type { Draft } from "immer";
+import type { CellXfsRegistry } from "../hooks/use-cellxfs-registry";
+import type { SheetData } from "../hooks/use-spreadsheet-state";
+import type { SharedStringRegistry } from "../hooks/use-ss-registry";
 /**
  * Format-painter pattern shared by both engines: the captured 2-D format grid plus the
  * source block's merge configuration, re-based to the block's top-left so it can be tiled
@@ -49,7 +54,23 @@ export declare const getBandedCellFormat: (bandedCells: Map<string, CellFormat>
  * Layer a cell's explicit format over the banded format the grid would paint beneath it, so the
  * captured pattern carries the VISIBLE look (Sheets copies the alternating colours as static cell
  * fills — it does not create a table or banding at the target). Explicit keys win; an explicit
- * `undefined` never clobbers a banded value.
+ * `undefined` never clobbers a banded value. `textFormat` merges key-wise: an explicitly bold
+ * header keeps the contrast text colour the band paints it with.
  */
 export declare const layerBandedFormat: (explicit: CellFormat | null | undefined, banded: CellFormat | undefined) => CellFormat | null | undefined;
+/**
+ * Write the banded (table stripe) formats the grid paints under `range` into the cells as
+ * static formats — Excel's Convert to Range bakes the table style into the cell formats — each
+ * cell's explicit format layered on top exactly as the format painter captures it. Runs inside
+ * the caller's sheet-data draft; cells without a band are untouched.
+ */
+export declare const bakeBandedFormats: <T extends CellData>({ draft, sheetId, range, bandedCells, locale, cellXfsRegistry, sharedStringRegistry, }: {
+    draft: Draft<SheetData<T>>;
+    sheetId: number;
+    range: GridRange;
+    bandedCells: Map<string, CellFormat> | undefined | null;
+    locale?: string;
+    cellXfsRegistry?: CellXfsRegistry;
+    sharedStringRegistry?: SharedStringRegistry;
+}) => void;
 //# sourceMappingURL=paint-format.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"paint-format.d.ts","sourceRoot":"","sources":["../../../api/paint-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AAGpC;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;IAC7C,kFAAkF;IAClF,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAQF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,QAAQ,SAAS,KAChB,SAAS,EAaX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,YAAY,aAAa,KACxB,SAkBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,EAC5C,gBAAgB,SAAS,EAAE,KAC1B,IAYF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,SAAS,EAAE,EAC3B,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,QAAQ,SAAS,KAChB,SAAS,EAqBX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,IAAI,EACvD,UAAU,MAAM,EAChB,aAAa,MAAM,KAClB,UAAU,GAAG,SACyC,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,UAAU,GAAG,IAAI,GAAG,SAAS,EACvC,QAAQ,UAAU,GAAG,SAAS,KAC7B,UAAU,GAAG,IAAI,GAAG,SAWtB,CAAC"}
+{"version":3,"file":"paint-format.d.ts","sourceRoot":"","sources":["../../../api/paint-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACV,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIrE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC;IAC7C,kFAAkF;IAClF,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAQF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,QAAQ,SAAS,KAChB,SAAS,EAaX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,YAAY,aAAa,KACxB,SAkBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,EAC5C,gBAAgB,SAAS,EAAE,KAC1B,IAYF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,SAAS,EAAE,EAC3B,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,QAAQ,SAAS,KAChB,SAAS,EAqBX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,IAAI,EACvD,UAAU,MAAM,EAChB,aAAa,MAAM,KAClB,UAAU,GAAG,SACyC,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,UAAU,GAAG,IAAI,GAAG,SAAS,EACvC,QAAQ,UAAU,GAAG,SAAS,KAC7B,UAAU,GAAG,IAAI,GAAG,SActB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,QAAQ,EAAE,wFAQnD;IACD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C,SA6CA,CAAC"}

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

@@ -1,5 +1,7 @@
 import { __assign, __read, __values } from "tslib";
 import { cellIdentifier, isCellWithinBounds } from "@rowsncolumns/grid";
+import { SheetCell } from "../sheet-cell";
+import { createSheetDraft } from "./immer-utils";
 var rangeContains = function (outer, inner) {
     return inner.startRowIndex >= outer.startRowIndex &&
         inner.endRowIndex <= outer.endRowIndex &&
@@ -146,7 +148,8 @@ export var getBandedCellFormat = function (bandedCells, rowIndex, columnIndex) {
  * Layer a cell's explicit format over the banded format the grid would paint beneath it, so the
  * captured pattern carries the VISIBLE look (Sheets copies the alternating colours as static cell
  * fills — it does not create a table or banding at the target). Explicit keys win; an explicit
- * `undefined` never clobbers a banded value.
+ * `undefined` never clobbers a banded value. `textFormat` merges key-wise: an explicitly bold
+ * header keeps the contrast text colour the band paints it with.
  */
 export var layerBandedFormat = function (explicit, banded) {
     var e_4, _a;
@@ -169,6 +172,59 @@ export var layerBandedFormat = function (explicit, banded) {
             }
             finally { if (e_4) throw e_4.error; }
         }
+        if (explicit.textFormat && banded.textFormat) {
+            merged.textFormat = __assign(__assign({}, banded.textFormat), explicit.textFormat);
+        }
     }
     return merged;
 };
+/**
+ * Write the banded (table stripe) formats the grid paints under `range` into the cells as
+ * static formats — Excel's Convert to Range bakes the table style into the cell formats — each
+ * cell's explicit format layered on top exactly as the format painter captures it. Runs inside
+ * the caller's sheet-data draft; cells without a band are untouched.
+ */
+export var bakeBandedFormats = function (_a) {
+    var e_5, _b;
+    var _c, _d;
+    var draft = _a.draft, sheetId = _a.sheetId, range = _a.range, bandedCells = _a.bandedCells, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry;
+    if (!(bandedCells === null || bandedCells === void 0 ? void 0 : bandedCells.size))
+        return;
+    var sheetCell = new SheetCell();
+    for (var rowIndex = range.startRowIndex; rowIndex <= range.endRowIndex; rowIndex++) {
+        for (var columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+            var banded = getBandedCellFormat(bandedCells, rowIndex, columnIndex);
+            if (!banded)
+                continue;
+            var currentSheet = createSheetDraft(draft, sheetId, rowIndex);
+            sheetCell.assign(sheetId, { rowIndex: rowIndex, columnIndex: columnIndex }, (_d = (_c = currentSheet[rowIndex]) === null || _c === void 0 ? void 0 : _c.values) === null || _d === void 0 ? void 0 : _d[columnIndex], { locale: locale, cellXfsRegistry: cellXfsRegistry, sharedStringRegistry: sharedStringRegistry });
+            var baked = layerBandedFormat(sheetCell.userEnteredFormat, banded);
+            sheetCell.clearUserEnteredFormat();
+            try {
+                for (var _e = (e_5 = void 0, __values(Object.entries(baked !== null && baked !== void 0 ? baked : {}))), _f = _e.next(); !_f.done; _f = _e.next()) {
+                    var _g = __read(_f.value, 2), key = _g[0], value = _g[1];
+                    // A band carries `undefined` for the parts it does not paint (no border, no text
+                    // colour) — those must not land as empty `{}` formats on the cell.
+                    if (value === undefined)
+                        continue;
+                    if (typeof value === "object" &&
+                        value !== null &&
+                        Object.values(value).every(function (part) { return part === undefined; })) {
+                        continue;
+                    }
+                    sheetCell.setUserEnteredFormat(key, value);
+                }
+            }
+            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+            finally {
+                try {
+                    if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+                }
+                finally { if (e_5) throw e_5.error; }
+            }
+            currentSheet[rowIndex].values[columnIndex] =
+                sheetCell.getCellData();
+            cellXfsRegistry === null || cellXfsRegistry === void 0 ? void 0 : cellXfsRegistry.registerCellXfs(sheetCell);
+        }
+    }
+};

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

@@ -1,3 +1,25 @@
 import type { SortOrder } from "@rowsncolumns/spreadsheet";
-export declare const cellValueSorter: (left: string | number | boolean | undefined | null, right: string | number | boolean | undefined | null, sortOrder: SortOrder) => number;
+/**
+ * A cell whose effective value is an error (`#DIV/0!`, `#N/A`, …). Errors
+ * form the last value tier and keep their relative order, as in Excel.
+ */
+export type SortErrorValue = {
+    readonly sortError: string;
+};
+export type SortCellValue = string | number | boolean | SortErrorValue | undefined | null;
+export declare const isSortErrorValue: (value: unknown) => value is SortErrorValue;
+/**
+ * The value a sort compares for a cell: its error when it has one, else the
+ * effective value, else the display text.
+ */
+export declare const getCellSortValue: (cell: {
+    readonly error: unknown;
+    getEffectiveValue(): string | number | boolean | undefined;
+    readonly formattedValue: string | undefined | null;
+}) => SortCellValue;
+/**
+ * Excel's sort order: numbers < text < logicals < errors, blanks last in
+ * BOTH directions, text compared case-insensitively through the collator.
+ */
+export declare const cellValueSorter: (left: SortCellValue, right: SortCellValue, sortOrder: SortOrder) => number;
 //# sourceMappingURL=sort.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../api/sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAQ3D,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,EAClD,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,EACnD,WAAW,SAAS,WAiCrB,CAAC"}
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../api/sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAa3D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,OAAO,GACP,cAAc,GACd,SAAS,GACT,IAAI,CAAC;AAET,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cACU,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,iBAAiB,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;CACpD,KAAG,aAGmD,CAAC;AAYxD;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,aAAa,EACnB,OAAO,aAAa,EACpB,WAAW,SAAS,WA8CrB,CAAC"}

package/dist/cjs/api/sort.js

@@ -1,8 +1,40 @@
 import { isNil } from "@rowsncolumns/utils";
+/**
+ * The text order both engines sort with: case- and accent-insensitive,
+ * digit runs by numeric value ("a2" < "a10"). `rnc_cellmodel::collate_text`
+ * is its Rust twin.
+ */
 var comparator = new Intl.Collator("en", {
     numeric: true,
     sensitivity: "base",
 }).compare;
+export var isSortErrorValue = function (value) {
+    return typeof value === "object" && value !== null && "sortError" in value;
+};
+/**
+ * The value a sort compares for a cell: its error when it has one, else the
+ * effective value, else the display text.
+ */
+export var getCellSortValue = function (cell) {
+    var _a, _b;
+    return cell.error
+        ? { sortError: (_a = cell.formattedValue) !== null && _a !== void 0 ? _a : "" }
+        : ((_b = cell.getEffectiveValue()) !== null && _b !== void 0 ? _b : cell.formattedValue);
+};
+/** Excel's ascending order of value types: numbers < text < logicals < errors. */
+var tierOf = function (value) {
+    return typeof value === "number"
+        ? 0
+        : typeof value === "string"
+            ? 1
+            : typeof value === "boolean"
+                ? 2
+                : 3;
+};
+/**
+ * Excel's sort order: numbers < text < logicals < errors, blanks last in
+ * BOTH directions, text compared case-insensitively through the collator.
+ */
 export var cellValueSorter = function (left, right, sortOrder) {
     var isEmpty = function (value) {
         if (isNil(value)) {
@@ -12,7 +44,7 @@ export var cellValueSorter = function (left, right, sortOrder) {
     };
     var leftEmpty = isEmpty(left);
     var rightEmpty = isEmpty(right);
-    // Ignore empty rows
+    // Blanks stay last regardless of direction.
     if (leftEmpty && rightEmpty) {
         return 0;
     }
@@ -22,12 +54,26 @@ export var cellValueSorter = function (left, right, sortOrder) {
     if (rightEmpty) {
         return -1;
     }
-    var isNumbers = typeof left === "number" && typeof right === "number";
-    var comparisonResult = isNumbers
-        ? left - right
-        : comparator(String(left), String(right));
+    var direction = sortOrder === "ASCENDING" ? 1 : -1;
+    var leftTier = tierOf(left);
+    var rightTier = tierOf(right);
+    if (leftTier !== rightTier) {
+        return direction * Math.sign(leftTier - rightTier);
+    }
+    var comparisonResult = 0;
+    if (typeof left === "number" && typeof right === "number") {
+        comparisonResult = left - right;
+    }
+    else if (typeof left === "string" && typeof right === "string") {
+        comparisonResult = comparator(left, right);
+    }
+    else if (typeof left === "boolean" && typeof right === "boolean") {
+        // FALSE before TRUE.
+        comparisonResult = Number(left) - Number(right);
+    }
+    // Errors compare equal: Excel keeps them in their original order.
     if (comparisonResult !== 0) {
-        return (sortOrder === "ASCENDING" ? 1 : -1) * Math.sign(comparisonResult);
+        return direction * Math.sign(comparisonResult);
     }
     return 0;
 };

package/dist/cjs/api/structural-guards.d.ts

@@ -46,6 +46,24 @@ export declare const findTornArray: (arrayRanges: readonly GridRange[] | undefin
  * inside the deleted block. */
 export declare const isRangeInsideBand: (range: GridRange, band: StructuralBand) => boolean;
 export declare const isRangeInsideBlock: (outer: GridRange, inner: GridRange) => boolean;
+/**
+ * T-07 — the Excel refusal for defining a table over `range` (create / update): another table on
+ * the sheet (`table-overlap`, judged first) or a merged cell (`table-merged-cells`). `excludeTableId`
+ * leaves the table being edited out. `insertedRows`, when given, is a one-or-more-row insert that
+ * runs first (the Create Table dialog's header row): tables and merges wholly inside its band are
+ * judged at their shifted position.
+ */
+export declare const getTableRangeRefusal: ({ sheetId, range, tables, merges, excludeTableId, insertedRows, }: {
+    sheetId: number;
+    range: GridRange;
+    tables?: readonly TableView[] | null;
+    merges?: readonly GridRange[] | null;
+    excludeTableId?: TableView["id"];
+    insertedRows?: {
+        band: StructuralBand;
+        count: number;
+    };
+}) => StructuralRefusal | undefined;
 /**
  * The Excel refusal (if any) for an insert/delete-cells shift of `range`. Checks run in Excel's
  * order: array tear, merge tear, table tear, off-sheet push. `undefined` means the edit may proceed.
@@ -63,6 +81,45 @@ export declare const getShiftCellsRefusal: <T extends CellData>({ direction, ran
     tables?: readonly TableView[] | null;
     arrayRanges?: readonly GridRange[] | null;
 }) => StructuralRefusal | undefined;
+/**
+ * T-46 — the refusal (if any) for a drag-move / cut of `from` onto `to`. Excel moves a table whole
+ * when the block contains it, but refuses to move PART of a table (the block covers some of its
+ * cells) and refuses a block landing on another table's cells; a block that is a whole table
+ * landing on another table is a table overlap. A same-table column reorder is decided before this.
+ */
+export declare const getMoveRangeRefusal: ({ sheetId, from, to, toSheetId, tables, }: {
+    sheetId: number;
+    from: GridRange;
+    to: GridRange;
+    /** The destination sheet — a cut + paste can land on another sheet; defaults to `sheetId`. */
+    toSheetId?: number;
+    tables?: readonly TableView[] | null;
+}) => StructuralRefusal | undefined;
+/**
+ * T-81 — the refusal for a fill whose filled cells (`target` minus `source`) reach a table's totals
+ * row. Excel's fill handle never extends over a totals row (the row is derived, not data), so the
+ * whole fill is refused and nothing is written. A fill whose source IS the totals row (filling away
+ * from the table) is not affected.
+ */
+export declare const getFillTotalsRowRefusal: ({ sheetId, source, target, tables, }: {
+    sheetId: number;
+    source: GridRange;
+    target: GridRange;
+    tables?: readonly TableView[] | null;
+}) => StructuralRefusal | undefined;
+/**
+ * T-47 — the refusal (if any) for Insert / Delete Table Rows (`axis: "row"`) or Table Columns
+ * (`axis: "column"`) on `table`. The edit shifts the cells of the table's band — its columns from
+ * the table down to the sheet edge, or its rows from the table right to the sheet edge. Another
+ * table wholly inside that band moves with it; one the band reaches but does not contain would be
+ * torn apart, so Excel refuses the edit.
+ */
+export declare const getTableEditRefusal: ({ sheetId, table, axis, tables, }: {
+    sheetId: number;
+    table: TableView;
+    axis: "row" | "column";
+    tables?: readonly TableView[] | null;
+}) => StructuralRefusal | undefined;
 /**
  * INS-06 / INS-09 — the refusal for a whole-row (`axis: "row"`) or whole-column insert of `count`
  * lines before `referenceIndex`, given the hard grid cap (`maxRowCount` / `maxColumnCount`). Blank

package/dist/cjs/api/structural-guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structural-guards.d.ts","sourceRoot":"","sources":["../../../api/structural-guards.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"structural-guards.d.ts","sourceRoot":"","sources":["../../../api/structural-guards.ts"],"names":[],"mappings":"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"}

package/dist/cjs/api/structural-guards.js

@@ -1,4 +1,4 @@
-import { __read } from "tslib";
+import { __assign, __read } from "tslib";
 import { selectionFromActiveCell } from "@rowsncolumns/utils";
 import { structuralRefusal, } from "../constants";
 /** The selection a cell shift operates on — the LAST selection, or the active cell as a 1×1. The
@@ -140,6 +140,31 @@ export var isRangeInsideBand = function (range, band) {
     return rangeContains(band, range);
 };
 export var isRangeInsideBlock = rangeContains;
+/**
+ * T-07 — the Excel refusal for defining a table over `range` (create / update): another table on
+ * the sheet (`table-overlap`, judged first) or a merged cell (`table-merged-cells`). `excludeTableId`
+ * leaves the table being edited out. `insertedRows`, when given, is a one-or-more-row insert that
+ * runs first (the Create Table dialog's header row): tables and merges wholly inside its band are
+ * judged at their shifted position.
+ */
+export var getTableRangeRefusal = function (_a) {
+    var sheetId = _a.sheetId, range = _a.range, tables = _a.tables, merges = _a.merges, excludeTableId = _a.excludeTableId, insertedRows = _a.insertedRows;
+    var shifted = function (candidate) {
+        return insertedRows && isRangeInsideBand(candidate, insertedRows.band)
+            ? __assign(__assign({}, candidate), { startRowIndex: candidate.startRowIndex + insertedRows.count, endRowIndex: candidate.endRowIndex + insertedRows.count }) : candidate;
+    };
+    if (tables === null || tables === void 0 ? void 0 : tables.some(function (table) {
+        return table.sheetId === sheetId &&
+            table.id !== excludeTableId &&
+            rangesIntersect(shifted(table.range), range);
+    })) {
+        return structuralRefusal("table-overlap");
+    }
+    if (merges === null || merges === void 0 ? void 0 : merges.some(function (merge) { return rangesIntersect(shifted(merge), range); })) {
+        return structuralRefusal("table-merged-cells");
+    }
+    return undefined;
+};
 /**
  * The Excel refusal (if any) for an insert/delete-cells shift of `range`. Checks run in Excel's
  * order: array tear, merge tear, table tear, off-sheet push. `undefined` means the edit may proceed.
@@ -176,6 +201,73 @@ export var getShiftCellsRefusal = function (_a) {
     }
     return undefined;
 };
+/**
+ * T-46 — the refusal (if any) for a drag-move / cut of `from` onto `to`. Excel moves a table whole
+ * when the block contains it, but refuses to move PART of a table (the block covers some of its
+ * cells) and refuses a block landing on another table's cells; a block that is a whole table
+ * landing on another table is a table overlap. A same-table column reorder is decided before this.
+ */
+export var getMoveRangeRefusal = function (_a) {
+    var _b;
+    var sheetId = _a.sheetId, from = _a.from, to = _a.to, _c = _a.toSheetId, toSheetId = _c === void 0 ? sheetId : _c, tables = _a.tables;
+    var sheetTables = tables === null || tables === void 0 ? void 0 : tables.filter(function (table) { return table.sheetId === sheetId; });
+    var destinationTables = toSheetId === sheetId
+        ? sheetTables
+        : tables === null || tables === void 0 ? void 0 : tables.filter(function (table) { return table.sheetId === toSheetId; });
+    if (!(sheetTables === null || sheetTables === void 0 ? void 0 : sheetTables.length) && !(destinationTables === null || destinationTables === void 0 ? void 0 : destinationTables.length))
+        return undefined;
+    var moved = (_b = sheetTables === null || sheetTables === void 0 ? void 0 : sheetTables.filter(function (table) { return rangeContains(from, table.range); })) !== null && _b !== void 0 ? _b : [];
+    if (sheetTables === null || sheetTables === void 0 ? void 0 : sheetTables.some(function (table) {
+        return !moved.includes(table) && rangesIntersect(table.range, from);
+    })) {
+        return structuralRefusal("torn-table");
+    }
+    if (destinationTables === null || destinationTables === void 0 ? void 0 : destinationTables.some(function (table) { return !moved.includes(table) && rangesIntersect(table.range, to); })) {
+        return structuralRefusal(moved.length ? "table-overlap" : "torn-table");
+    }
+    return undefined;
+};
+/**
+ * T-81 — the refusal for a fill whose filled cells (`target` minus `source`) reach a table's totals
+ * row. Excel's fill handle never extends over a totals row (the row is derived, not data), so the
+ * whole fill is refused and nothing is written. A fill whose source IS the totals row (filling away
+ * from the table) is not affected.
+ */
+export var getFillTotalsRowRefusal = function (_a) {
+    var sheetId = _a.sheetId, source = _a.source, target = _a.target, tables = _a.tables;
+    return (tables === null || tables === void 0 ? void 0 : tables.some(function (table) {
+        if (table.sheetId !== sheetId || !table.totalRow)
+            return false;
+        var totalsRow = table.range.endRowIndex;
+        if (totalsRow < target.startRowIndex || totalsRow > target.endRowIndex) {
+            return false;
+        }
+        var hit = {
+            startRowIndex: totalsRow,
+            endRowIndex: totalsRow,
+            startColumnIndex: Math.max(table.range.startColumnIndex, target.startColumnIndex),
+            endColumnIndex: Math.min(table.range.endColumnIndex, target.endColumnIndex),
+        };
+        return hit.startColumnIndex <= hit.endColumnIndex && !rangeContains(source, hit);
+    }))
+        ? structuralRefusal("table-totals-fill")
+        : undefined;
+};
+/**
+ * T-47 — the refusal (if any) for Insert / Delete Table Rows (`axis: "row"`) or Table Columns
+ * (`axis: "column"`) on `table`. The edit shifts the cells of the table's band — its columns from
+ * the table down to the sheet edge, or its rows from the table right to the sheet edge. Another
+ * table wholly inside that band moves with it; one the band reaches but does not contain would be
+ * torn apart, so Excel refuses the edit.
+ */
+export var getTableEditRefusal = function (_a) {
+    var sheetId = _a.sheetId, table = _a.table, axis = _a.axis, tables = _a.tables;
+    var band = axis === "row"
+        ? __assign(__assign({}, table.range), { endRowIndex: Number.POSITIVE_INFINITY }) : __assign(__assign({}, table.range), { endColumnIndex: Number.POSITIVE_INFINITY });
+    return findTornTable(tables === null || tables === void 0 ? void 0 : tables.filter(function (other) { return other.id !== table.id; }), sheetId, band)
+        ? structuralRefusal("torn-table")
+        : undefined;
+};
 /**
  * INS-06 / INS-09 — the refusal for a whole-row (`axis: "row"`) or whole-column insert of `count`
  * lines before `referenceIndex`, given the hard grid cap (`maxRowCount` / `maxColumnCount`). Blank

package/dist/cjs/api/structural-table-refs.d.ts

@@ -27,9 +27,10 @@ export type RemovedTableParts = {
     }>;
 };
 /**
- * Which tables / table columns `deleteRow` (a table goes with its header row)
- * or `deleteColumn` (a table goes when every column is deleted; otherwise the
- * covered columns are spliced out) removes for the band
+ * Which tables / table columns `deleteRow` (a table goes only when every one
+ * of its rows is deleted — losing its header row keeps it, the next row
+ * becomes the header) or `deleteColumn` (a table goes when every column is
+ * deleted; otherwise the covered columns are spliced out) removes for the band
  * `[minIndex, maxIndex]` on `sheetId`. Mirrors the table updates those
  * interfaces apply to `tables`.
  */
@@ -59,6 +60,60 @@ export type BreakStructuredRefsParams<T extends CellData> = {
  * when it is available (cost O(formula cells)); without one the draft is swept.
  */
 export declare const breakStructuredRefsForRemovedTableParts: <T extends CellData>({ draft, sheetId, axis, referenceIndex, count, removed, getGraphNodes, enqueueCalculation, enqueueGraphOperation, recalcCells, locale, cellXfsRegistry, sharedStringRegistry, }: BreakStructuredRefsParams<T>) => void;
+export type RewriteFormulasParams<T extends CellData> = Pick<BreakStructuredRefsParams<T>, "draft" | "getGraphNodes" | "enqueueCalculation" | "enqueueGraphOperation" | "recalcCells" | "locale" | "cellXfsRegistry" | "sharedStringRegistry">;
+/**
+ * Column `oldName` of `table` was renamed `newName` (a header-cell edit):
+ * rewrite every structured reference to it across the workbook, including the
+ * bare `[@Old]` forms of the formulas that sit inside the table.
+ */
+export declare const renameTableColumnInFormulas: <T extends CellData>({ table, oldName, newName, ...params }: RewriteFormulasParams<T> & {
+    table: Pick<TableView, "title" | "sheetId" | "range">;
+    oldName: string;
+    newName: string;
+}) => void;
+/**
+ * Several columns of `table` were renamed at once (a header row re-derived
+ * after a row delete, several header cells written by one paste /
+ * change-batch): `renames` maps each LOWER-CASED old name to its new name and
+ * every formula is rewritten in ONE pass, so `Name` → `Qty` and `Qty` → `Name`
+ * swap instead of chaining into the same column.
+ */
+export declare const renameTableColumnsInFormulas: <T extends CellData>({ table, renames, ...params }: RewriteFormulasParams<T> & {
+    table: Pick<TableView, "title" | "sheetId" | "range">;
+    renames: ReadonlyMap<string, string>;
+}) => void;
+/**
+ * The header cells one write renamed (`planHeaderCellRenames`), applied per
+ * table as a single multi-column rename.
+ */
+export declare const renameHeaderCellsInFormulas: <T extends CellData>({ headerRenames, ...params }: RewriteFormulasParams<T> & {
+    headerRenames: readonly {
+        table: Pick<TableView, "id" | "title" | "sheetId" | "range">;
+        oldName: string | undefined;
+        newName: string;
+    }[];
+}) => void;
+/**
+ * `table` is being converted to a range (Excel's Convert to Range): rewrite
+ * every structured reference into it across the workbook to the A1 reference
+ * it resolves to — `T[Col]` → `$B$2:$B$9`, `[@Col]` → `B3`,
+ * `T[[#Headers],[Col]]` → `$B$1`, qualified with the table's sheet from another
+ * sheet — so the formulas keep their values once the table is gone. Runs
+ * BEFORE the table is removed; the bare `[@Col]` forms belong to the formulas
+ * that sit inside the table.
+ */
+export declare const convertTableReferencesToA1InFormulas: <T extends CellData>({ table, getSheetName, ...params }: RewriteFormulasParams<T> & {
+    table: Pick<TableView, "title" | "sheetId" | "range" | "headerRow" | "totalRow" | "columns">;
+    getSheetName(sheetId: number): string;
+}) => void;
+/**
+ * Table `oldName` was renamed `newName` (the Edit Table dialog / `updateTable`):
+ * rewrite `Old[…]` → `New[…]` in every formula across the workbook.
+ */
+export declare const renameTableInFormulas: <T extends CellData>({ oldName, newName, ...params }: RewriteFormulasParams<T> & {
+    oldName: string;
+    newName: string;
+}) => void;
 /**
  * Drop the materialised spill cells of every dynamic-array anchor that sits
  * inside the deleted band `[minIndex, maxIndex]` (rows or columns) of

package/dist/cjs/api/structural-table-refs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structural-table-refs.d.ts","sourceRoot":"","sources":["../../../api/structural-table-refs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"structural-table-refs.d.ts","sourceRoot":"","sources":["../../../api/structural-table-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAMrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAarD,KAAK,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,2EAA2E;QAC3E,KAAK,EAAE,SAAS,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;CACJ,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,SAAS,EAAE,GAAG,SAAS,EAC/B,SAAS,MAAM,EACf,MAAM,cAAc,EACpB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,iBAkCF,CAAC;AAeF,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,QAAQ,IAAI;IAC1D,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,iBAAiB,CAAC;IAC3B,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IACnE,kBAAkB,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC7E,qBAAqB,CAAC,EAAE,UAAU,CAChC,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uCAAuC,GAAI,CAAC,SAAS,QAAQ,EAAE,iLAczE,yBAAyB,CAAC,CAAC,CAAC,SA+D9B,CAAC;AAIF,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,QAAQ,IAAI,IAAI,CAC1D,yBAAyB,CAAC,CAAC,CAAC,EAC1B,OAAO,GACP,eAAe,GACf,oBAAoB,GACpB,uBAAuB,GACvB,aAAa,GACb,QAAQ,GACR,iBAAiB,GACjB,sBAAsB,CACzB,CAAC;AAqDF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,QAAQ,EAAE,wCAK7D,qBAAqB,CAAC,CAAC,CAAC,GAAG;IAC5B,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,SAOA,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GAAI,CAAC,SAAS,QAAQ,EAAE,+BAI9D,qBAAqB,CAAC,CAAC,CAAC,GAAG;IAC5B,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;IACtD,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,SAcA,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,QAAQ,EAAE,8BAG7D,qBAAqB,CAAC,CAAC,CAAC,GAAG;IAC5B,aAAa,EAAE,SAAS;QACtB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;QAC7D,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;CACL,SAiBA,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,oCAAoC,GAAI,CAAC,SAAS,QAAQ,EAAE,oCAItE,qBAAqB,CAAC,CAAC,CAAC,GAAG;IAC5B,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC,CAAC;IAC7F,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC,SAoBA,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,iCAIvD,qBAAqB,CAAC,CAAC,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,SAKjE,CAAC;AAiDF;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,KAAK,UAAU,GAAG,SAAS,CAAC;AAE7B,eAAO,MAAM,4BAA4B,GAAI,CAAC,SAAS,QAAQ,EAAE,6GAU9D;IACD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C,SAwEA,CAAC"}