@rowsncolumns/spreadsheet-state 28.0.73 → 28.0.75

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

@@ -50,8 +50,7 @@ var isGenericNumberFormatType = function (type) { return !type || type === "NUMB
  * Date-family types — when the derived (resolved) type is one of these
  * and the precedent's type is also in this set, we preserve the
  * precedent's exact custom pattern instead of synthesizing a locale
- * default. Mirrors Excel's behaviour for date-arithmetic functions
- * (EDATE, EOMONTH, …) where `=EDATE(A1, 1)` keeps A1's custom pattern.
+ * default (`=DATE(YEAR(A1), MONTH(A1), 1)` keeps A1's custom pattern).
  */
 var isDateFamilyType = function (type) { return type === "DATE" || type === "TIME" || type === "DATE_TIME"; };
 var customNumberFormatMap = {
@@ -70,6 +69,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 },
@@ -163,18 +163,21 @@ var functionReturnTypes = {
     NETWORKDAYS: "NUMBER",
     "NETWORKDAYS.INTL": "NUMBER",
     DAYS360: "NUMBER",
+    // The date-arithmetic functions return date serials, but Excel does
+    // NOT auto-format them: `=EDATE(DATE(2026,1,31),1)` shows 46081 in a
+    // General cell until the user formats it (rowsncolumns/spreadsheet#642
+    // B-09). NUMBER — like DATEVALUE — rather than absent, so a nested
+    // DATE()/TODAY() argument cannot promote the result to a date (the
+    // outermost function decides, as in `=YEAR(TODAY())`).
+    EDATE: "NUMBER",
+    EOMONTH: "NUMBER",
+    WORKDAY: "NUMBER",
+    "WORKDAY.INTL": "NUMBER",
     // ─── Date/time — date producers (must render as DATE/TIME/DATE_TIME) ─
     NOW: "DATE_TIME",
     TODAY: "DATE",
     DATE: "DATE",
     TIME: "TIME",
-    EDATE: "DATE",
-    EOMONTH: "DATE",
-    // WORKDAY returns a date serial number — must render as DATE, not
-    // raw NUMBER (was a bug: cells showed e.g. "45292" instead of the
-    // calendar date).
-    WORKDAY: "DATE",
-    "WORKDAY.INTL": "DATE",
     // ─── Aggregation / rounding (return NUMBER; CURRENCY precedent
     //     preserved via the "expectedOutputType === NUMBER + numFormat
     //     CURRENCY → keep numFormat" branch) ──────────────────────────
@@ -321,7 +324,10 @@ var currencyDecimalAdjustmentFunctions = new Set([
     "QUOTIENT",
 ]);
 // Get all function names from formula
-var functionRegex = /([A-Za-z0-9_]+)\s*\(/g;
+// Function names may be dotted (`WORKDAY.INTL`, `PERCENTILE.INC`, `FORECAST.ETS`); without the
+// `.` the match stopped at the suffix (`INTL(`) and the dotted keys of `functionReturnTypes` /
+// `formatDerivationRules` never applied.
+var functionRegex = /([A-Za-z0-9_.]+)\s*\(/g;
 export var getFunctionNamesFromFormula = function (formula) {
     var match;
     var matches = [];
@@ -521,7 +527,7 @@ resolvePrecedentNumberFormat) {
     effectivePrecedents = filterPrecedentsByBounds(effectivePrecedents, directBounds);
     var upperFormula = formula === null || formula === void 0 ? void 0 : formula.trim().toUpperCase();
     if (upperFormula) {
-        var functionNameMatch = upperFormula.match(/^=([A-Z0-9_]+)\(/);
+        var functionNameMatch = upperFormula.match(/^=([A-Z0-9_.]+)\(/);
         topLevelFunctionName = functionNameMatch ? functionNameMatch[1] : undefined;
         var rule = topLevelFunctionName
             ? formatDerivationRules[topLevelFunctionName]
@@ -700,10 +706,10 @@ resolvePrecedentNumberFormat) {
         // Date/time types need a concrete pattern — without one the renderer
         // falls back to "General" and shows the serial number (the
         // =TODAY() bug). When the precedent itself is a date-family format
-        // with a pattern, inherit that pattern (e.g. `=EDATE(A1, 1)` keeps
-        // A1's custom `yyyy-mm-dd` instead of falling back to the locale
-        // default). Otherwise mirror the format toolbar's default for the
-        // type.
+        // with a pattern, inherit that pattern (e.g. `=DATE(YEAR(A1),
+        // MONTH(A1), 1)` keeps A1's custom `yyyy-mm-dd` instead of falling
+        // back to the locale default). Otherwise mirror the format toolbar's
+        // default for the type.
         if (isDateFamilyType(resolvedNumberFormat.type) &&
             isDateFamilyType(numFormat === null || numFormat === void 0 ? void 0 : numFormat.type) &&
             (numFormat === null || numFormat === void 0 ? void 0 : numFormat.pattern)) {

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

@@ -1 +1 @@
-{"version":3,"file":"intl.d.ts","sourceRoot":"","sources":["../../../api/intl.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,gBAAc,WAK5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM;;;;;CA2ClD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM;eA1E5B,MAAM;YAAU,OAAO;YAAU,OAAO;iBAAe,OAAO;CAqH5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM;UAtHxC,MAAM;YAAU,OAAO;YAAU,OAAO;CAkJjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM;aA/JlC,MAAM;eAAa,MAAM;WAAS,MAAM;aAgMpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,wBAkBhD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,YAuBnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,aAAa,MAAM,gBA0BtD,CAAC"}
+{"version":3,"file":"intl.d.ts","sourceRoot":"","sources":["../../../api/intl.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,gBAAc,WAK5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM;WAlCxC,MAAM;aAAW,MAAM;eAAa,MAAM;iBAAe,MAAM;CA6EzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM;eA1E5B,MAAM;YAAU,OAAO;YAAU,OAAO;iBAAe,OAAO;CAqH5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM;UAtHxC,MAAM;YAAU,OAAO;YAAU,OAAO;CAkJjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM;aA/JlC,MAAM;eAAa,MAAM;WAAS,MAAM;aAgMpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,wBAkBhD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,YAuBnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,aAAa,MAAM,gBA0BtD,CAAC"}

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

@@ -0,0 +1,55 @@
+import type { CellFormat, CellInterface, 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[];
+/**
+ * The block the painter captures when it is armed WITHOUT a drag selection. A plain click on a
+ * merged cell selects the whole merged area in Excel and Sheets, but the grid reports it as the
+ * anchor active cell plus an empty selection list — so the source is the merge containing the
+ * active cell when there is one, otherwise the single cell.
+ */
+export declare const paintSourceForActiveCell: (merges: GridRange[] | null | undefined, activeCell: CellInterface) => GridRange;
+/**
+ * Excel stores a merged area's style on every constituent cell, and the grid paints a merge with
+ * its anchor's format. Copy the anchor's captured format over the covered cells of every merge in
+ * the pattern (in place) so the painted target carries the fill on all of them — an unmerge at the
+ * target, or a partial tile that drops the merge, still leaves every cell looking as it did.
+ */
+export declare const spreadMergeAnchorFormats: (formats: (CellFormat | null | undefined)[][], relativeMerges: GridRange[]) => void;
+/**
+ * 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,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"}

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

@@ -0,0 +1,174 @@
+import { __assign, __read, __values } from "tslib";
+import { cellIdentifier, isCellWithinBounds } 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;
+};
+/**
+ * The block the painter captures when it is armed WITHOUT a drag selection. A plain click on a
+ * merged cell selects the whole merged area in Excel and Sheets, but the grid reports it as the
+ * anchor active cell plus an empty selection list — so the source is the merge containing the
+ * active cell when there is one, otherwise the single cell.
+ */
+export var paintSourceForActiveCell = function (merges, activeCell) {
+    var merge = merges === null || merges === void 0 ? void 0 : merges.find(function (candidate) {
+        return isCellWithinBounds(activeCell, candidate);
+    });
+    if (merge) {
+        return {
+            startRowIndex: merge.startRowIndex,
+            endRowIndex: merge.endRowIndex,
+            startColumnIndex: merge.startColumnIndex,
+            endColumnIndex: merge.endColumnIndex,
+        };
+    }
+    return {
+        startRowIndex: activeCell.rowIndex,
+        endRowIndex: activeCell.rowIndex,
+        startColumnIndex: activeCell.columnIndex,
+        endColumnIndex: activeCell.columnIndex,
+    };
+};
+/**
+ * Excel stores a merged area's style on every constituent cell, and the grid paints a merge with
+ * its anchor's format. Copy the anchor's captured format over the covered cells of every merge in
+ * the pattern (in place) so the painted target carries the fill on all of them — an unmerge at the
+ * target, or a partial tile that drops the merge, still leaves every cell looking as it did.
+ */
+export var spreadMergeAnchorFormats = function (formats, relativeMerges) {
+    var e_2, _a;
+    var _b;
+    try {
+        for (var relativeMerges_1 = __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 anchor = (_b = formats[merge.startRowIndex]) === null || _b === void 0 ? void 0 : _b[merge.startColumnIndex];
+            for (var r = merge.startRowIndex; r <= merge.endRowIndex; r++) {
+                var row = formats[r];
+                if (!row)
+                    continue;
+                for (var c = merge.startColumnIndex; c <= merge.endColumnIndex; c++) {
+                    if (r === merge.startRowIndex && c === merge.startColumnIndex)
+                        continue;
+                    if (c < row.length)
+                        row[c] = anchor;
+                }
+            }
+        }
+    }
+    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; }
+    }
+};
+/**
+ * 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_3, _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_2 = (e_3 = void 0, __values(relativeMerges)), relativeMerges_2_1 = relativeMerges_2.next(); !relativeMerges_2_1.done; relativeMerges_2_1 = relativeMerges_2.next()) {
+                    var merge = relativeMerges_2_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_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (relativeMerges_2_1 && !relativeMerges_2_1.done && (_a = relativeMerges_2.return)) _a.call(relativeMerges_2);
+                }
+                finally { if (e_3) throw e_3.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_4, _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_4_1) { e_4 = { error: e_4_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_4) throw e_4.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;
+    });
+};