@rowsncolumns/spreadsheet-state 28.0.73 → 28.0.74

package/dist/cjs/api/advanced-filter.d.ts

@@ -0,0 +1,72 @@
+import type { GridRange } from "@rowsncolumns/common-types";
+import type { AdvancedFilterAction, AdvancedFilterOptions } from "@rowsncolumns/spreadsheet";
+/**
+ * Excel's Data → Sort & Filter → Advanced: a list range (header row + records)
+ * filtered by a CRITERIA RANGE — a header row naming list columns, then one
+ * or more criteria rows. Conditions on one criteria row AND together; the
+ * rows OR together. A criterion cell is an Excel comparison string:
+ *
+ *   `>100` `<=5` `<>done` `=apple`  operator + value
+ *   `app`                            text begins with "app" (case-insensitive)
+ *   `="=apple"` → `=apple`           exact text match
+ *   `a*e` `?at` `~*`                 `*` any run, `?` one char, `~` escapes
+ *   blank                            no condition (a fully blank criteria row
+ *                                    matches every record, as in Excel)
+ *
+ * Numbers compare numerically when both sides are numeric; text compares
+ * case-insensitively. A criteria header that matches no list header is a
+ * computed criterion in Excel — those need a formula per record and are not
+ * evaluated here (the condition is ignored; see the compatibility doc).
+ */
+export type { AdvancedFilterAction, AdvancedFilterOptions };
+export type CellValueReader = (rowIndex: number, columnIndex: number) => string | number | boolean | null | undefined;
+type Operator = "=" | "<>" | "<" | "<=" | ">" | ">=" | "begins";
+export type Criterion = {
+    columnIndex: number;
+    operator: Operator;
+    value: string;
+};
+/** Excel wildcard pattern → anchored RegExp (`~` escapes `*`, `?`, `~`). */
+export declare const wildcardToRegExp: (pattern: string, anchorEnd?: boolean) => RegExp;
+/** Whether one record cell satisfies one criterion. */
+export declare const matchesCriterion: (cellValue: string | number | boolean | null | undefined, criterion: Criterion) => boolean;
+/**
+ * One OR-branch of the criteria range: the AND-ed criteria of one criteria
+ * row. An empty array is a blank criteria row — it matches every record.
+ */
+export type CriteriaRow = Criterion[];
+/**
+ * Reads the criteria range against the list's header row. Criteria headers
+ * resolve to list columns case-insensitively; a header without a list match
+ * (a computed criterion) is skipped.
+ */
+export declare const parseCriteriaRange: (listRange: GridRange, criteriaRange: GridRange, getValue: CellValueReader) => CriteriaRow[];
+/** A record matches when any criteria row's conditions all hold. */
+export declare const matchesCriteria: (rowIndex: number, criteriaRows: CriteriaRow[], getValue: CellValueReader) => boolean;
+export type AdvancedFilterPlan = {
+    /** Record rows that satisfy the criteria (absolute indexes, ascending). */
+    matchingRows: number[];
+    /** `filter`: record rows to hide (non-matching). */
+    hideRows: number[];
+    /** `filter`: record rows to show (matching — undoes an earlier in-place filter). */
+    showRows: number[];
+    /** `copy`: the header row + matching records to write at `copyTo`. */
+    copy?: {
+        range: GridRange;
+        values: (string | number | boolean | null)[][];
+    };
+};
+/**
+ * Plans an Advanced Filter over the list range. Returns `undefined` when the
+ * list has no records, or `copy` was asked for without a destination.
+ */
+export declare const planAdvancedFilter: (options: AdvancedFilterOptions, getValue: CellValueReader) => AdvancedFilterPlan | undefined;
+/** The state callbacks a plan is applied through — the same in both engines. */
+export type AdvancedFilterPlanExecutor = {
+    onHideRow: (sheetId: number, rowIndexes: number[]) => void;
+    onShowRow: (sheetId: number, rowIndexes: number[]) => void;
+    onChangeBatch: (sheetId: number, range: GridRange, values: (string | number | boolean | null)[][]) => void;
+};
+/** Applies an {@link AdvancedFilterPlan}: show the matches, hide the rest, or write the copy. */
+export declare const applyAdvancedFilterPlan: (sheetId: number, plan: AdvancedFilterPlan, executor: AdvancedFilterPlanExecutor) => void;
+//# sourceMappingURL=advanced-filter.d.ts.map

package/dist/cjs/api/advanced-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-filter.d.ts","sourceRoot":"","sources":["../../../api/advanced-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;;GAiBG;AACH,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAElD,KAAK,QAAQ,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,QAAQ,CAAC;AAEhE,MAAM,MAAM,SAAS,GAAG;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAkBF,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,mBAAgB,KAAG,MAepE,CAAC;AAqBF,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,GAC3B,WAAW,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACvD,WAAW,SAAS,KACnB,OA6CF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,EAAE,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,WAAW,SAAS,EACpB,eAAe,SAAS,EACxB,UAAU,eAAe,KACxB,WAAW,EAuCb,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,cAAc,WAAW,EAAE,EAC3B,UAAU,eAAe,KACxB,OAOF,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,2EAA2E;IAC3E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sEAAsE;IACtE,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;KAAE,CAAC;CAC7E,CAAC;AAkBF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,qBAAqB,EAC9B,UAAU,eAAe,KACxB,kBAAkB,GAAG,SAsDvB,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC3D,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC3D,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,KAC3C,IAAI,CAAC;CACX,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,MAAM,kBAAkB,EACxB,UAAU,0BAA0B,SAQrC,CAAC"}

package/dist/cjs/api/goal-seek.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Excel's Data → What-If Analysis → Goal Seek solver.
+ *
+ * Excel's defaults are 100 iterations and a change-tolerance of 0.001 (its
+ * Calculation options → "Maximum Iterations" / "Maximum Change"). The
+ * search is a secant method — Excel's own is a secant/Newton hybrid — with
+ * bisection whenever a sign change has been bracketed and the secant step
+ * would leave the bracket, so a monotone target converges in a handful of
+ * evaluations while a badly scaled one still narrows a bracket.
+ *
+ * `evaluate(trial)` returns the set cell's value with the changing cell at
+ * `trial`; `undefined` means the trial produced an error (`#DIV/0!`, text…),
+ * which the solver treats as "step somewhere else".
+ */
+import type { GoalSeekResult, GoalSeekStatus } from "@rowsncolumns/spreadsheet";
+export declare const GOAL_SEEK_MAX_ITERATIONS = 100;
+export declare const GOAL_SEEK_TOLERANCE = 0.001;
+export type GoalSeekEvaluate = (trial: number) => Promise<number | undefined>;
+export type { GoalSeekResult, GoalSeekStatus };
+export type GoalSeekOptions = {
+    evaluate: GoalSeekEvaluate;
+    targetValue: number;
+    /** Starting trial — the changing cell's current value (0 when blank). */
+    initialValue?: number;
+    maxIterations?: number;
+    tolerance?: number;
+};
+export declare const goalSeek: ({ evaluate, targetValue, initialValue, maxIterations, tolerance, }: GoalSeekOptions) => Promise<GoalSeekResult>;
+//# sourceMappingURL=goal-seek.d.ts.map

package/dist/cjs/api/goal-seek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-seek.d.ts","sourceRoot":"","sources":["../../../api/goal-seek.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhF,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9E,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAE/C,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAKF,eAAO,MAAM,QAAQ,GAAU,oEAM5B,eAAe,KAAG,OAAO,CAAC,cAAc,CAqG1C,CAAC"}

package/dist/cjs/api/goal-seek.js

@@ -0,0 +1,131 @@
+import { __awaiter, __generator } from "tslib";
+export var GOAL_SEEK_MAX_ITERATIONS = 100;
+export var GOAL_SEEK_TOLERANCE = 0.001;
+var isUsable = function (value) {
+    return typeof value === "number" && Number.isFinite(value);
+};
+export var goalSeek = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+    var iterations, best, residualAt, finish, negative, positive, bracket, x0, f0, nudges, x1, shrinks, backoffs, f1, x2, slope, lo, hi;
+    var evaluate = _b.evaluate, targetValue = _b.targetValue, _c = _b.initialValue, initialValue = _c === void 0 ? 0 : _c, _d = _b.maxIterations, maxIterations = _d === void 0 ? GOAL_SEEK_MAX_ITERATIONS : _d, _e = _b.tolerance, tolerance = _e === void 0 ? GOAL_SEEK_TOLERANCE : _e;
+    return __generator(this, function (_f) {
+        switch (_f.label) {
+            case 0:
+                iterations = 0;
+                best = {
+                    value: initialValue,
+                    currentValue: undefined,
+                    residual: Number.POSITIVE_INFINITY,
+                };
+                residualAt = function (trial) { return __awaiter(void 0, void 0, void 0, function () {
+                    var current, residual;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                iterations++;
+                                return [4 /*yield*/, evaluate(trial)];
+                            case 1:
+                                current = _a.sent();
+                                if (!isUsable(current))
+                                    return [2 /*return*/, undefined];
+                                residual = current - targetValue;
+                                if (Math.abs(residual) < best.residual) {
+                                    best = { value: trial, currentValue: current, residual: Math.abs(residual) };
+                                }
+                                return [2 /*return*/, residual];
+                        }
+                    });
+                }); };
+                finish = function (status) { return ({
+                    status: status,
+                    value: best.value,
+                    currentValue: best.currentValue,
+                    targetValue: targetValue,
+                    iterations: iterations,
+                }); };
+                bracket = function (x, f) {
+                    if (f < 0)
+                        negative = x;
+                    else
+                        positive = x;
+                };
+                x0 = initialValue;
+                return [4 /*yield*/, residualAt(x0)];
+            case 1:
+                f0 = _f.sent();
+                nudges = 0;
+                _f.label = 2;
+            case 2:
+                if (!(f0 === undefined && iterations < maxIterations && nudges < 8)) return [3 /*break*/, 4];
+                x0 = x0 === 0 ? 1 : x0 * 2;
+                return [4 /*yield*/, residualAt(x0)];
+            case 3:
+                f0 = _f.sent();
+                nudges++;
+                return [3 /*break*/, 2];
+            case 4:
+                if (f0 === undefined)
+                    return [2 /*return*/, finish("not-found")];
+                if (Math.abs(f0) <= tolerance)
+                    return [2 /*return*/, finish("found")];
+                bracket(x0, f0);
+                x1 = x0 === 0 ? 0.01 : x0 * 1.01;
+                shrinks = 0;
+                backoffs = 0;
+                _f.label = 5;
+            case 5:
+                if (!(iterations < maxIterations)) return [3 /*break*/, 7];
+                return [4 /*yield*/, residualAt(x1)];
+            case 6:
+                f1 = _f.sent();
+                if (f1 === undefined) {
+                    // Errored trial: pull it halfway back toward the last good point.
+                    if (++shrinks > 16)
+                        return [2 /*return*/, finish("not-found")];
+                    x1 = x0 + (x1 - x0) / 2;
+                    return [3 /*break*/, 5];
+                }
+                shrinks = 0;
+                if (Math.abs(f1) <= tolerance)
+                    return [2 /*return*/, finish("found")];
+                bracket(x1, f1);
+                // A secant step that made things worse with no sign change in sight is
+                // heading away from the root (a flat or curving function such as =1/A1):
+                // back off — half the step, in the opposite direction — instead of
+                // following it to infinity. The bracketed case below never needs this.
+                if ((negative === undefined || positive === undefined) &&
+                    Math.abs(f1) > Math.abs(f0)) {
+                    if (++backoffs > 24)
+                        return [2 /*return*/, finish("not-found")];
+                    x1 = x0 - (x1 - x0) / 2;
+                    return [3 /*break*/, 5];
+                }
+                backoffs = 0;
+                x2 = void 0;
+                slope = f1 - f0;
+                if (slope === 0 || !Number.isFinite(slope)) {
+                    // Flat: widen the step in the same direction to find any change.
+                    x2 = x1 + (x1 - x0 || 0.01) * 2;
+                }
+                else {
+                    x2 = x1 - (f1 * (x1 - x0)) / slope;
+                }
+                if (negative !== undefined && positive !== undefined) {
+                    lo = Math.min(negative, positive);
+                    hi = Math.max(negative, positive);
+                    if (!Number.isFinite(x2) || x2 <= lo || x2 >= hi) {
+                        x2 = (lo + hi) / 2;
+                    }
+                }
+                else if (!Number.isFinite(x2)) {
+                    return [2 /*return*/, finish("not-found")];
+                }
+                if (x2 === x1)
+                    return [2 /*return*/, finish(Math.abs(f1) <= tolerance ? "found" : "not-found")];
+                x0 = x1;
+                f0 = f1;
+                x1 = x2;
+                return [3 /*break*/, 5];
+            case 7: return [2 /*return*/, finish("not-found")];
+        }
+    });
+}); };

package/dist/cjs/api/immer-utils.d.ts.map

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

package/dist/cjs/api/immer-utils.js

@@ -70,6 +70,7 @@ var formatDerivationRules = {
     UNIQUE: { type: "fixed_index", index: 0 },
     TAKE: { type: "fixed_index", index: 0 },
     DROP: { type: "fixed_index", index: 0 },
+    TRIMRANGE: { type: "fixed_index", index: 0 },
     EXPAND: { type: "fixed_index", index: 0 },
     TOCOL: { type: "fixed_index", index: 0 },
     TOROW: { type: "fixed_index", index: 0 },

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

@@ -0,0 +1,41 @@
+import type { CellFormat, GridRange } from "@rowsncolumns/common-types";
+/**
+ * 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
+ * onto any target (Google Sheets copies merges with the format; Excel's painter does too).
+ */
+export type PaintPattern = {
+    formats: (CellFormat | null | undefined)[][];
+    /** Merges fully inside the source block, as 0-based offsets from its top-left. */
+    merges: GridRange[];
+    /** Source block size — the tiling period. */
+    rows: number;
+    cols: number;
+};
+/**
+ * The merges the painter carries from a source block: every merge that lies FULLY inside
+ * `source`, re-based to 0-based offsets from the block's top-left. A merge reaching outside the
+ * block is not part of its pattern (Sheets/Excel behave the same — the painter copies the look of
+ * the selected cells, not of the cells around them).
+ */
+export declare const collectPaintMerges: (merges: GridRange[] | null | undefined, source: GridRange) => GridRange[];
+/**
+ * Tile a pattern's relative merges across `target` with the pattern's period (`rows` × `cols`),
+ * the same way the format grid itself is tiled by the formatting applier. A merge that a partial
+ * trailing tile would push past the target's edge is dropped — the painter never creates a merge
+ * that the user did not drag over.
+ */
+export declare const tilePaintMerges: (relativeMerges: GridRange[], rows: number, cols: number, target: GridRange) => GridRange[];
+/**
+ * The banded (table stripe / alternating-colour) format the grid paints under a cell, looked up
+ * in the map `getBandedCells` builds for a sheet.
+ */
+export declare const getBandedCellFormat: (bandedCells: Map<string, CellFormat> | undefined | null, rowIndex: number, columnIndex: number) => CellFormat | undefined;
+/**
+ * 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.
+ */
+export declare const layerBandedFormat: (explicit: CellFormat | null | undefined, banded: CellFormat | undefined) => CellFormat | null | undefined;
+//# sourceMappingURL=paint-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paint-format.d.ts","sourceRoot":"","sources":["../../../api/paint-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGxE;;;;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,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"}

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

@@ -0,0 +1,115 @@
+import { __assign, __read, __values } from "tslib";
+import { cellIdentifier } from "@rowsncolumns/grid";
+var rangeContains = function (outer, inner) {
+    return inner.startRowIndex >= outer.startRowIndex &&
+        inner.endRowIndex <= outer.endRowIndex &&
+        inner.startColumnIndex >= outer.startColumnIndex &&
+        inner.endColumnIndex <= outer.endColumnIndex;
+};
+/**
+ * The merges the painter carries from a source block: every merge that lies FULLY inside
+ * `source`, re-based to 0-based offsets from the block's top-left. A merge reaching outside the
+ * block is not part of its pattern (Sheets/Excel behave the same — the painter copies the look of
+ * the selected cells, not of the cells around them).
+ */
+export var collectPaintMerges = function (merges, source) {
+    var e_1, _a;
+    if (!(merges === null || merges === void 0 ? void 0 : merges.length))
+        return [];
+    var out = [];
+    try {
+        for (var merges_1 = __values(merges), merges_1_1 = merges_1.next(); !merges_1_1.done; merges_1_1 = merges_1.next()) {
+            var merge = merges_1_1.value;
+            if (!rangeContains(source, merge))
+                continue;
+            out.push({
+                startRowIndex: merge.startRowIndex - source.startRowIndex,
+                endRowIndex: merge.endRowIndex - source.startRowIndex,
+                startColumnIndex: merge.startColumnIndex - source.startColumnIndex,
+                endColumnIndex: merge.endColumnIndex - source.startColumnIndex,
+            });
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (merges_1_1 && !merges_1_1.done && (_a = merges_1.return)) _a.call(merges_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return out;
+};
+/**
+ * Tile a pattern's relative merges across `target` with the pattern's period (`rows` × `cols`),
+ * the same way the format grid itself is tiled by the formatting applier. A merge that a partial
+ * trailing tile would push past the target's edge is dropped — the painter never creates a merge
+ * that the user did not drag over.
+ */
+export var tilePaintMerges = function (relativeMerges, rows, cols, target) {
+    var e_2, _a;
+    if (!relativeMerges.length || rows <= 0 || cols <= 0)
+        return [];
+    var out = [];
+    for (var top_1 = target.startRowIndex; top_1 <= target.endRowIndex; top_1 += rows) {
+        for (var left = target.startColumnIndex; left <= target.endColumnIndex; left += cols) {
+            try {
+                for (var relativeMerges_1 = (e_2 = void 0, __values(relativeMerges)), relativeMerges_1_1 = relativeMerges_1.next(); !relativeMerges_1_1.done; relativeMerges_1_1 = relativeMerges_1.next()) {
+                    var merge = relativeMerges_1_1.value;
+                    var placed = {
+                        startRowIndex: top_1 + merge.startRowIndex,
+                        endRowIndex: top_1 + merge.endRowIndex,
+                        startColumnIndex: left + merge.startColumnIndex,
+                        endColumnIndex: left + merge.endColumnIndex,
+                    };
+                    if (rangeContains(target, placed))
+                        out.push(placed);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (relativeMerges_1_1 && !relativeMerges_1_1.done && (_a = relativeMerges_1.return)) _a.call(relativeMerges_1);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        }
+    }
+    return out;
+};
+/**
+ * The banded (table stripe / alternating-colour) format the grid paints under a cell, looked up
+ * in the map `getBandedCells` builds for a sheet.
+ */
+export var getBandedCellFormat = function (bandedCells, rowIndex, columnIndex) {
+    return bandedCells === null || bandedCells === void 0 ? void 0 : bandedCells.get(cellIdentifier(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.
+ */
+export var layerBandedFormat = function (explicit, banded) {
+    var e_3, _a;
+    if (!banded)
+        return explicit;
+    var merged = __assign({}, banded);
+    if (explicit) {
+        try {
+            for (var _b = __values(Object.entries(explicit)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
+                if (value !== undefined) {
+                    merged[key] = value;
+                }
+            }
+        }
+        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_3) throw e_3.error; }
+        }
+    }
+    return merged;
+};

package/dist/cjs/api/split-text.d.ts

@@ -1,2 +1,14 @@
+import type { SplitTextOptions } from "@rowsncolumns/spreadsheet";
 export declare const splitTextToColumns: (values: (string | null | undefined)[], delimiter?: string) => string[][];
+export type { SplitTextOptions };
+/** Normalized, ascending, de-duplicated positive break positions. */
+export declare const normalizeColumnBreaks: (columnBreaks: number[]) => number[];
+/**
+ * Excel's Text to Columns → Fixed width: cut each cell at the given
+ * character positions. Fields are trimmed like the delimited path (Excel's
+ * General column data format drops the padding spaces fixed-width data is
+ * aligned with). Cells without breaks inside their text still split — the
+ * trailing fields are empty — so the resulting block is rectangular.
+ */
+export declare const splitTextFixedWidth: (values: (string | null | undefined)[], columnBreaks: number[]) => string[][];
 //# sourceMappingURL=split-text.d.ts.map

package/dist/cjs/api/split-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"split-text.d.ts","sourceRoot":"","sources":["../../../api/split-text.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACrC,YAAW,MAAY,KACtB,MAAM,EAAE,EAwBV,CAAC"}
+{"version":3,"file":"split-text.d.ts","sourceRoot":"","sources":["../../../api/split-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACrC,YAAW,MAAY,KACtB,MAAM,EAAE,EAwBV,CAAC;AAEF,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,GAAI,cAAc,MAAM,EAAE,KAAG,MAAM,EAG3C,CAAC;AAE3B;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACrC,cAAc,MAAM,EAAE,KACrB,MAAM,EAAE,EAgBV,CAAC"}

package/dist/cjs/api/split-text.js

@@ -1,3 +1,4 @@
+import { __read, __spreadArray, __values } from "tslib";
 import { isNil } from "@rowsncolumns/utils";
 // Split text to columns - takes a single column and returns 2D array
 export var splitTextToColumns = function (values, delimiter) {
@@ -23,3 +24,43 @@ export var splitTextToColumns = function (values, delimiter) {
         return trimmedParts;
     });
 };
+/** Normalized, ascending, de-duplicated positive break positions. */
+export var normalizeColumnBreaks = function (columnBreaks) {
+    return __spreadArray([], __read(new Set(columnBreaks)), false).filter(function (position) { return Number.isInteger(position) && position > 0; })
+        .sort(function (a, b) { return a - b; });
+};
+/**
+ * Excel's Text to Columns → Fixed width: cut each cell at the given
+ * character positions. Fields are trimmed like the delimited path (Excel's
+ * General column data format drops the padding spaces fixed-width data is
+ * aligned with). Cells without breaks inside their text still split — the
+ * trailing fields are empty — so the resulting block is rectangular.
+ */
+export var splitTextFixedWidth = function (values, columnBreaks) {
+    var breaks = normalizeColumnBreaks(columnBreaks);
+    return values.map(function (cell) {
+        var e_1, _a;
+        if (isNil(cell)) {
+            return [""];
+        }
+        var text = String(cell);
+        var parts = [];
+        var start = 0;
+        try {
+            for (var breaks_1 = __values(breaks), breaks_1_1 = breaks_1.next(); !breaks_1_1.done; breaks_1_1 = breaks_1.next()) {
+                var position = breaks_1_1.value;
+                parts.push(text.slice(start, position).trim());
+                start = position;
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (breaks_1_1 && !breaks_1_1.done && (_a = breaks_1.return)) _a.call(breaks_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        parts.push(text.slice(start).trim());
+        return parts;
+    });
+};

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

@@ -0,0 +1,85 @@
+import type { GridRange } from "@rowsncolumns/common-types";
+import { SUBTOTAL_FUNCTIONS, type SubtotalFunction, type SubtotalOptions } from "@rowsncolumns/spreadsheet";
+export { SUBTOTAL_FUNCTIONS };
+export type { SubtotalFunction, SubtotalOptions };
+/**
+ * The `SUBTOTAL(function_num, …)` code each "Use function" entry writes.
+ * Codes 1–11 (not 101–111): the subtotal rows Excel inserts count manually
+ * hidden rows.
+ */
+export declare const SUBTOTAL_FUNCTION_NUMBERS: Record<SubtotalFunction, number>;
+/** Excel's total-row labels: "<group> Total" per group, "Grand Total" at the bottom. */
+export declare const SUBTOTAL_GRAND_TOTAL_LABEL = "Grand Total";
+export declare const subtotalGroupLabel: (groupValue: string) => string;
+/**
+ * Reads a cell of the data range. `getValue` should return the DISPLAYED text
+ * when the host has one (Excel groups and labels on what the cells show —
+ * `1/1/2024 Total`, not `45292 Total`). `getFormula` returns the `=…` text for
+ * a formula cell. `getOutlineLevel` returns a row's current outline level so
+ * "Replace current subtotals" can rebuild the outline from level 0.
+ */
+export type SubtotalReader = {
+    getValue: (rowIndex: number, columnIndex: number) => string | number | boolean | null | undefined;
+    getFormula: (rowIndex: number, columnIndex: number) => string | undefined;
+    getOutlineLevel?: (rowIndex: number) => number | undefined;
+};
+/** One `change-batch` write: a single row segment at final coordinates. */
+export type SubtotalWrite = {
+    rowIndex: number;
+    startColumnIndex: number;
+    values: (string | null)[];
+};
+/**
+ * The plan applies in this order, every index already in FINAL coordinates
+ * (the sheet after all removals and insertions):
+ *   1. `deleteRows` (descending original indexes — existing subtotal rows),
+ *   2. `insertRows` ascending: inserting at final row `r` shifts the not-yet
+ *      final rows below it, so ascending order lands each new row exactly
+ *      where the plan expects it,
+ *   3. `writes` (labels + SUBTOTAL formulas),
+ *   4. `ungroupRows`: one `ungroup-rows` call per entry — the outline reset of
+ *      "Replace current subtotals". Group / ungroup are ±1 steps in both
+ *      engines, so pass `k` lists the surviving data rows that were deeper
+ *      than level `k`; after the passes every row of the range is back at
+ *      level 0 (empty when nothing was outlined or when not replacing), then
+ *   5. `outlineGroups`: one `group-rows` call per entry (Excel's levels — the
+ *      first spans every row above the grand total, the second the detail
+ *      rows of each group, so detail rows end at level 2 and subtotal rows
+ *      at level 1 — the same three-level outline on every re-apply).
+ */
+export type SubtotalPlan = {
+    deleteRows: number[];
+    insertRows: number[];
+    writes: SubtotalWrite[];
+    ungroupRows: number[][];
+    outlineGroups: number[][];
+    /** Number of groups found. */
+    groupCount: number;
+    /** The range after the plan is applied (header row included when present). */
+    resultRange: GridRange;
+};
+/**
+ * Plans Excel's Subtotal command over `options.range`. Consecutive rows with
+ * the same group-column value form a group (Excel does not sort — it expects
+ * the data sorted and totals each run of equal values). Each group gets a
+ * total row right below it holding "<value> Total" in the group column and
+ * `=SUBTOTAL(n, first:last)` over the group's data rows in every aggregate
+ * column; a grand-total row closes the range with `SUBTOTAL` over the whole
+ * data block (SUBTOTAL ignores the nested subtotal rows, like Excel). With
+ * `replaceCurrent` the range's existing outline is cleared too, so a re-apply
+ * yields Excel's fresh detail 2 / subtotal 1 / grand total 0 levels instead
+ * of nesting deeper; without it the new levels stack on the old ones (Excel's
+ * nested subtotals). Returns `undefined` when the range has no data rows.
+ */
+export declare const planSubtotals: (options: SubtotalOptions, reader: SubtotalReader) => SubtotalPlan | undefined;
+/** The state callbacks a plan is applied through — the same in both engines. */
+export type SubtotalPlanExecutor = {
+    onDeleteRow: (sheetId: number, rowIndexes: number[]) => void;
+    onInsertRow: (sheetId: number, referenceRowIndex: number, numRows?: number) => void;
+    onChangeBatch: (sheetId: number, range: GridRange, values: (string | null)[][]) => void;
+    onGroupRows: (sheetId: number, rowIndexes: number[]) => void;
+    onUngroupRows: (sheetId: number, rowIndexes: number[]) => void;
+};
+/** Applies a {@link SubtotalPlan} in its documented order. */
+export declare const applySubtotalPlan: (sheetId: number, plan: SubtotalPlan, executor: SubtotalPlanExecutor) => void;
+//# sourceMappingURL=subtotal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subtotal.d.ts","sourceRoot":"","sources":["../../../api/subtotal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAYtE,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AACxD,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,WACP,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAClG,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1E,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC5D,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,EAAE,SAAS,CAAC;CACxB,CAAC;AAcF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,eAAe,EACxB,QAAQ,cAAc,KACrB,YAAY,GAAG,SAyHjB,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpF,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,KACxB,IAAI,CAAC;IACV,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7D,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,MAAM,YAAY,EAClB,UAAU,oBAAoB,SAwB/B,CAAC"}