@rowsncolumns/utils 9.2.35

package/dist/cjs/date.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toDate = exports.toSerial = exports.toSerialWithMode = void 0;
+var DAY_TO_MS = 24 * 60 * 60 * 1000;
+var EXCEL_LEAP_BUG_SERIAL = 60;
+/**
+ * Convert date to serial with explicit time zone behavior.
+ * - local: interpret date components in local time (UI entry behavior).
+ * - excel-utc: treat Date as UTC (formula engine behavior).
+ */
+var toSerialWithMode = function (date, use1904, mode) {
+    if (use1904 === void 0) { use1904 = false; }
+    if (mode === void 0) { mode = "local"; }
+    var utcMillis = mode === "excel-utc"
+        ? date.getTime()
+        : Date.UTC(date.getFullYear(), date.getMonth(), date.getDate(), date.getHours(), date.getMinutes(), date.getSeconds(), date.getMilliseconds());
+    if (use1904) {
+        var baseUtc_1 = Date.UTC(1904, 0, 1);
+        return (utcMillis - baseUtc_1) / DAY_TO_MS;
+    }
+    var baseUtc = Date.UTC(1899, 11, 31);
+    var dayCount = (utcMillis - baseUtc) / DAY_TO_MS;
+    if (utcMillis >= Date.UTC(1900, 2, 1)) {
+        dayCount += 1;
+    }
+    return dayCount;
+};
+exports.toSerialWithMode = toSerialWithMode;
+var toSerial = function (date, use1904) {
+    if (use1904 === void 0) { use1904 = false; }
+    return (0, exports.toSerialWithMode)(date, use1904, "local");
+};
+exports.toSerial = toSerial;
+/**
+ * Convert serial to date
+ * @param serial
+ * @returns
+ */
+var toDate = function (serial, use1904) {
+    if (use1904 === void 0) { use1904 = false; }
+    if (use1904) {
+        var baseUtc_2 = Date.UTC(1904, 0, 1);
+        var utcMillis_1 = baseUtc_2 + serial * DAY_TO_MS;
+        var utcDate_1 = new Date(utcMillis_1);
+        return new Date(utcDate_1.getUTCFullYear(), utcDate_1.getUTCMonth(), utcDate_1.getUTCDate(), utcDate_1.getUTCHours(), utcDate_1.getUTCMinutes(), utcDate_1.getUTCSeconds(), utcDate_1.getUTCMilliseconds());
+    }
+    if (serial === EXCEL_LEAP_BUG_SERIAL) {
+        return new Date(1900, 1, 28);
+    }
+    var baseUtc = Date.UTC(1899, 11, 31);
+    var dayCount = serial < EXCEL_LEAP_BUG_SERIAL ? serial : serial - 1;
+    var utcMillis = baseUtc + dayCount * DAY_TO_MS;
+    var utcDate = new Date(utcMillis);
+    return new Date(utcDate.getUTCFullYear(), utcDate.getUTCMonth(), utcDate.getUTCDate(), utcDate.getUTCHours(), utcDate.getUTCMinutes(), utcDate.getUTCSeconds(), utcDate.getUTCMilliseconds());
+};
+exports.toDate = toDate;

package/dist/cjs/dom.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Check if its being rendered in Browser or SSR
+ */
+export declare const canUseDOM: boolean;
+export declare const moveSelectionToEndOfActiveInput: () => void;
+export declare const moveSelectionToEndOfTextArea: () => void;
+export declare const scheduleAfterPaint: (callback: () => void) => () => void;
+export declare const focusableNodeNames: Set<string>;
+export declare const isFocusable: (el: Element | null) => boolean;
+//# sourceMappingURL=dom.d.ts.map

package/dist/cjs/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../dom.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS,SAGkB,CAAC;AAEzC,eAAO,MAAM,+BAA+B,YAsB3C,CAAC;AAEF,eAAO,MAAM,4BAA4B,YAiBxC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,IAAI,eAmCtD,CAAC;AAGF,eAAO,MAAM,kBAAkB,aAA2C,CAAC;AAE3E,eAAO,MAAM,WAAW,GAAI,IAAI,OAAO,GAAG,IAAI,YAQ7C,CAAC"}

package/dist/cjs/dom.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFocusable = exports.focusableNodeNames = exports.scheduleAfterPaint = exports.moveSelectionToEndOfTextArea = exports.moveSelectionToEndOfActiveInput = exports.canUseDOM = void 0;
+/**
+ * Check if its being rendered in Browser or SSR
+ */
+exports.canUseDOM = typeof window !== "undefined" &&
+    typeof document !== "undefined" &&
+    typeof window.document !== "undefined";
+var moveSelectionToEndOfActiveInput = function () {
+    try {
+        if (!exports.canUseDOM) {
+            return;
+        }
+        /* Move to end */
+        requestAnimationFrame(function () {
+            if (document.activeElement) {
+                var range = document.createRange();
+                range.selectNodeContents(document.activeElement);
+                range.collapse(false);
+                var selection = typeof window !== "undefined" ? window.getSelection() : undefined;
+                if (selection) {
+                    selection.removeAllRanges();
+                    selection.addRange(range);
+                }
+            }
+        });
+    }
+    catch (err) {
+        console.log("Failed to collapse selection", err);
+    }
+};
+exports.moveSelectionToEndOfActiveInput = moveSelectionToEndOfActiveInput;
+var moveSelectionToEndOfTextArea = function () {
+    try {
+        if (!exports.canUseDOM) {
+            return;
+        }
+        if (document.activeElement &&
+            document.activeElement.tagName === "TEXTAREA") {
+            var textarea = document.activeElement;
+            var end = textarea.value.length;
+            // ✅ Move focus to End of textarea
+            textarea.setSelectionRange(end, end);
+            textarea.focus();
+        }
+    }
+    catch (err) { }
+};
+exports.moveSelectionToEndOfTextArea = moveSelectionToEndOfTextArea;
+var scheduleAfterPaint = function (callback) {
+    if (typeof requestAnimationFrame === "function") {
+        if (typeof MessageChannel !== "undefined") {
+            var channel_1 = new MessageChannel();
+            channel_1.port1.onmessage = function () {
+                channel_1.port1.onmessage = null;
+                callback();
+            };
+            requestAnimationFrame(function () {
+                channel_1.port2.postMessage(null);
+            });
+            return function () {
+                channel_1.port1.onmessage = null;
+            };
+        }
+        var frameId_1 = requestAnimationFrame(function () { return callback(); });
+        return function () {
+            if (typeof cancelAnimationFrame === "function") {
+                cancelAnimationFrame(frameId_1);
+            }
+        };
+    }
+    if (typeof MessageChannel !== "undefined") {
+        var channel_2 = new MessageChannel();
+        channel_2.port1.onmessage = function () {
+            channel_2.port1.onmessage = null;
+            callback();
+        };
+        channel_2.port2.postMessage(null);
+        return function () {
+            channel_2.port1.onmessage = null;
+        };
+    }
+    callback();
+    return function () { };
+};
+exports.scheduleAfterPaint = scheduleAfterPaint;
+/* Focusable node names */
+exports.focusableNodeNames = new Set(["INPUT", "TEXTAREA", "SELECT"]);
+var isFocusable = function (el) {
+    if (!el) {
+        return false;
+    }
+    return (Boolean(el.getAttribute("contenteditable")) ||
+        exports.focusableNodeNames.has(el.nodeName));
+};
+exports.isFocusable = isFocusable;

package/dist/cjs/formatter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pattern-based type inference (Excel parity). xlsx files routinely carry
+ * a `numberFormat.pattern` without an accompanying `type` field — these
+ * helpers let callers classify such cells from the pattern alone.
+ *
+ * Notes:
+ *  - `isDateFormat` from numfmt returns true for any pattern containing
+ *    date *or* time tokens. We split that into DATE (date only) vs
+ *    DATE_TIME (has a time component) using `getFormatDateInfo`, mirroring
+ *    Excel's `CELL("format")` distinctions.
+ *  - `isTextFormat` only flags patterns whose entire body is the `@`
+ *    placeholder. Multi-section formats with an `@` text section
+ *    (`#,##0;-#,##0;0;[Magenta]@`) are NOT text formats — they're number
+ *    formats whose text section happens to be reachable for string values.
+ */
+export declare const isDatePattern: (pattern: string | undefined | null) => boolean;
+export declare const isDateTimePattern: (pattern: string | undefined | null) => boolean;
+export declare const isTimePattern: (pattern: string | undefined | null) => boolean;
+export declare const isTextPattern: (pattern: string | undefined | null) => boolean;
+export declare const ssfFormat: (pattern: string, value: any, locale?: string) => string;
+export declare const ssfFormatColor: (pattern: string, value: any) => string | undefined;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/cjs/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../formatter.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OASlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KACjC,OAWF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAWlE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAOlE,CAAC;AAMF,eAAO,MAAM,SAAS,GACpB,SAAS,MAAM,EACf,OAAO,GAAG,EACV,SAAS,MAAM,KACd,MAeF,CAAC;AAmLF,eAAO,MAAM,cAAc,GACzB,SAAS,MAAM,EACf,OAAO,GAAG,KACT,MAAM,GAAG,SAoBX,CAAC"}

package/dist/cjs/formatter.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ssfFormatColor = exports.ssfFormat = exports.isTextPattern = exports.isTimePattern = exports.isDateTimePattern = exports.isDatePattern = void 0;
+var numfmt_1 = require("numfmt");
+var colors_1 = require("./colors");
+/**
+ * Pattern-based type inference (Excel parity). xlsx files routinely carry
+ * a `numberFormat.pattern` without an accompanying `type` field — these
+ * helpers let callers classify such cells from the pattern alone.
+ *
+ * Notes:
+ *  - `isDateFormat` from numfmt returns true for any pattern containing
+ *    date *or* time tokens. We split that into DATE (date only) vs
+ *    DATE_TIME (has a time component) using `getFormatDateInfo`, mirroring
+ *    Excel's `CELL("format")` distinctions.
+ *  - `isTextFormat` only flags patterns whose entire body is the `@`
+ *    placeholder. Multi-section formats with an `@` text section
+ *    (`#,##0;-#,##0;0;[Magenta]@`) are NOT text formats — they're number
+ *    formats whose text section happens to be reachable for string values.
+ */
+var isDatePattern = function (pattern) {
+    if (!pattern)
+        return false;
+    try {
+        if (!(0, numfmt_1.isDateFormat)(pattern))
+            return false;
+        var info = (0, numfmt_1.getFormatDateInfo)(pattern);
+        return info.day || info.month || info.year;
+    }
+    catch (_a) {
+        return false;
+    }
+};
+exports.isDatePattern = isDatePattern;
+var isDateTimePattern = function (pattern) {
+    if (!pattern)
+        return false;
+    try {
+        if (!(0, numfmt_1.isDateFormat)(pattern))
+            return false;
+        var info = (0, numfmt_1.getFormatDateInfo)(pattern);
+        var hasDate = info.day || info.month || info.year;
+        var hasTime = info.hours || info.minutes || info.seconds;
+        return hasDate && hasTime;
+    }
+    catch (_a) {
+        return false;
+    }
+};
+exports.isDateTimePattern = isDateTimePattern;
+var isTimePattern = function (pattern) {
+    if (!pattern)
+        return false;
+    try {
+        if (!(0, numfmt_1.isDateFormat)(pattern))
+            return false;
+        var info = (0, numfmt_1.getFormatDateInfo)(pattern);
+        var hasDate = info.day || info.month || info.year;
+        var hasTime = info.hours || info.minutes || info.seconds;
+        return hasTime && !hasDate;
+    }
+    catch (_a) {
+        return false;
+    }
+};
+exports.isTimePattern = isTimePattern;
+var isTextPattern = function (pattern) {
+    if (!pattern)
+        return false;
+    try {
+        return (0, numfmt_1.isTextFormat)(pattern);
+    }
+    catch (_a) {
+        return false;
+    }
+};
+exports.isTextPattern = isTextPattern;
+var isSingleSectionElapsedTimePattern = function (pattern) {
+    return !pattern.includes(";") &&
+        /\[(?:h+|m+|s+)\]/i.test(pattern.replace(/\[\$[^\]]+\]/g, ""));
+};
+var ssfFormat = function (pattern, value, locale) {
+    try {
+        var isNegativeElapsedTime = typeof value === "number" &&
+            value < 0 &&
+            isSingleSectionElapsedTimePattern(pattern);
+        var formatted = (0, numfmt_1.format)(pattern, isNegativeElapsedTime ? Math.abs(value) : value, { locale: locale });
+        return isNegativeElapsedTime ? "-".concat(formatted) : formatted;
+    }
+    catch (err) {
+        return String(value);
+    }
+};
+exports.ssfFormat = ssfFormat;
+/**
+ * Excel's legacy fixed 56-color palette used by `[ColorN]` directives
+ * inside number format patterns (1-indexed). This palette is INDEPENDENT
+ * of the workbook's `<indexedColors>` block — `[ColorN]` always refers
+ * to Excel's hard-coded legacy palette, even in files that override the
+ * indexed colors.
+ *
+ * Excel's `[ColorN]` (1-56) resolves to indexed-palette entry `N + 7`
+ * (indices 8–63 of the 64-entry legacy palette; entries 0–7 are the
+ * "EGA duplicate" block that `[ColorN]` never addresses).
+ *
+ * `numfmt` instead resolves `[ColorN]` as its `indexColors[N - 1]` — a
+ * straight off-by-8 against Excel. That happens to agree for N=1..8
+ * (the palette's first 8 entries repeat at 8..15) but is wrong for 28
+ * of the remaining 48 indices: `[Color11]` (Excel navy `#000080`)
+ * renders pure red, as do `[Color17]` and `[Color38]`. We therefore
+ * resolve `[ColorN]` ourselves whenever the matched format segment
+ * carries one (see `ssfFormatColor`).
+ *
+ * Source: ECMA-376 §18.8.27 (indexedColors) and Excel's documented
+ * legacy palette. Note `[ColorN]` always refers to Excel's hard-coded
+ * legacy palette, never a workbook's custom `<indexedColors>` block.
+ */
+var LEGACY_COLOR_PALETTE = {};
+for (var n = 1; n <= 56; n++) {
+    LEGACY_COLOR_PALETTE[n] = colors_1.IndexedColors[n + 7];
+}
+var COLOR_DIRECTIVE_REGEX = /\[Color(\d+)\]/i;
+var COLOR_OVERRIDE_CACHE = new Map();
+var COLOR_OVERRIDE_CACHE_LIMIT = 256;
+/**
+ * Extract a `[ColorN]` directive resolution for each segment of a
+ * SpreadsheetML pattern. Returns `null` (cached) if the pattern
+ * contains no `[ColorN]` at all — short-circuits any further work
+ * for the vast majority of patterns. Walks the pattern once,
+ * scanning for `;` separators outside string literals and `[ColorN]`
+ * tokens; no `String#split` allocation.
+ */
+var PATTERNS_WITHOUT_COLOR = new Set();
+var getPerSegmentColorOverrides = function (pattern) {
+    if (PATTERNS_WITHOUT_COLOR.has(pattern))
+        return null;
+    var cached = COLOR_OVERRIDE_CACHE.get(pattern);
+    if (cached)
+        return cached;
+    // Fast pre-check: no `[Color` substring → no override possible.
+    // `indexOf` is far cheaper than a regex when the pattern is long
+    // and there's no match. (`[ColorN]` is case-sensitive — Excel
+    // accepts `[color10]` too but the standard form is title case.)
+    if (pattern.indexOf("[Color") === -1 && pattern.indexOf("[color") === -1) {
+        if (PATTERNS_WITHOUT_COLOR.size > COLOR_OVERRIDE_CACHE_LIMIT) {
+            PATTERNS_WITHOUT_COLOR.clear();
+        }
+        PATTERNS_WITHOUT_COLOR.add(pattern);
+        return null;
+    }
+    // Single pass: track current segment, current `[ColorN]` index, and
+    // whether we're inside a string literal. When we hit `;` outside a
+    // string, advance the segment. When we see `[Color\d+]`, record it
+    // for the current segment (only the first occurrence per segment —
+    // matches Excel's behaviour).
+    var segmentColors = [
+        undefined,
+        undefined,
+        undefined,
+        undefined,
+    ];
+    var seg = 0;
+    var inString = false;
+    var escape = false;
+    for (var i = 0; i < pattern.length; i++) {
+        if (seg > 3)
+            break;
+        var ch = pattern[i];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (ch === "\\") {
+            escape = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (ch === ";" && !inString) {
+            seg++;
+            continue;
+        }
+        if (ch === "[" && !inString && segmentColors[seg] === undefined) {
+            // Look ahead for `Color\d+]` — case-insensitive on the prefix.
+            var end = pattern.indexOf("]", i + 1);
+            if (end === -1)
+                continue;
+            var inside = pattern.slice(i + 1, end);
+            if (/^Color\d+$/i.test(inside)) {
+                var idx = Number(inside.slice(5));
+                var resolved = LEGACY_COLOR_PALETTE[idx];
+                if (resolved)
+                    segmentColors[seg] = resolved;
+            }
+            i = end;
+            continue;
+        }
+    }
+    var result = [
+        segmentColors[0],
+        segmentColors[1],
+        segmentColors[2],
+        segmentColors[3],
+        Math.min(seg, 3) + 1,
+    ];
+    // No `[ColorN]` in any segment after all — treat as "no override".
+    if (!result.slice(0, 4).some(function (x) { return x !== undefined; })) {
+        if (PATTERNS_WITHOUT_COLOR.size > COLOR_OVERRIDE_CACHE_LIMIT) {
+            PATTERNS_WITHOUT_COLOR.clear();
+        }
+        PATTERNS_WITHOUT_COLOR.add(pattern);
+        return null;
+    }
+    if (COLOR_OVERRIDE_CACHE.size > COLOR_OVERRIDE_CACHE_LIMIT) {
+        COLOR_OVERRIDE_CACHE.clear();
+    }
+    COLOR_OVERRIDE_CACHE.set(pattern, result);
+    return result;
+};
+/**
+ * Pick the `[ColorN]` override the value's matched segment carries, honoring
+ * Excel's section-selection rules for patterns with fewer than 4 sections:
+ * one section applies to every numeric value; with two, negatives take the
+ * second; zero takes the third only when present; text takes the fourth only
+ * when present (a number-only pattern leaves text unformatted — no color).
+ */
+var pickSegmentOverride = function (overrides, value) {
+    var sections = overrides[4];
+    if (typeof value === "string") {
+        return sections === 4 ? overrides[3] : undefined;
+    }
+    var n = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(n) || n > 0)
+        return overrides[0];
+    if (n < 0)
+        return sections >= 2 ? overrides[1] : overrides[0];
+    return sections >= 3 ? overrides[2] : overrides[0];
+};
+var ssfFormatColor = function (pattern, value) {
+    // numfmt resolves `[ColorN]` as its `indexColors[N - 1]`, but Excel's
+    // `[ColorN]` is legacy-indexed-palette entry `N + 7` — numfmt's answer
+    // is wrong for most N ≥ 9 (`[Color11]` navy renders pure red) and
+    // `#FFF` for some others. Whenever the matched segment carries a
+    // `[ColorN]` directive, prefer our palette resolution over numfmt's
+    // raw color. The `PATTERNS_WITHOUT_COLOR` set makes this check free
+    // for the common case of patterns with no `[ColorN]`.
+    var overrides = getPerSegmentColorOverrides(pattern);
+    if (overrides) {
+        var resolved = pickSegmentOverride(overrides, value);
+        if (resolved)
+            return resolved;
+    }
+    var raw;
+    try {
+        raw = (0, numfmt_1.formatColor)(pattern, value);
+    }
+    catch (err) {
+        raw = undefined;
+    }
+    return raw && raw.length > 0 ? raw : undefined;
+};
+exports.ssfFormatColor = ssfFormatColor;

package/dist/cjs/formula-refs.d.ts

@@ -0,0 +1,7 @@
+import type { CellInterface, GridRange } from "@rowsncolumns/common-types";
+export interface FormulaToRelativeReferenceOptions {
+    exclusionRange?: GridRange;
+    ignoreCircular?: boolean;
+}
+export declare const formulaToRelativeReference: (formula: string | undefined, sourceCell: CellInterface, destinationCell: CellInterface, options?: FormulaToRelativeReferenceOptions) => string | undefined;
+//# sourceMappingURL=formula-refs.d.ts.map

package/dist/cjs/formula-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula-refs.d.ts","sourceRoot":"","sources":["../../formula-refs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAsB3E,MAAM,WAAW,iCAAiC;IAChD,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,GAAG,SAAS,EAC3B,YAAY,aAAa,EACzB,iBAAiB,aAAa,EAC9B,UAAU,iCAAiC,KAC1C,MAAM,GAAG,SAgCX,CAAC"}

package/dist/cjs/formula-refs.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formulaToRelativeReference = void 0;
+var tslib_1 = require("tslib");
+var numbers_1 = require("./numbers");
+var CELL_ADDR_RE = /((?:'[^']+'|[^'!,]+)!)?(\$?[A-Z]+\$?\d+)(?::(\$?[A-Z]+\$?\d+))?/g;
+var parseAddr = function (addr) {
+    var m = /^(\$?)([A-Z]+)(\$?)(\d+)$/.exec(addr);
+    if (!m)
+        return null;
+    var _a = tslib_1.__read(m, 5), absCol = _a[1], colAlpha = _a[2], absRow = _a[3], rowStr = _a[4];
+    return {
+        col: (0, numbers_1.alpha2number)(colAlpha),
+        row: parseInt(rowStr, 10),
+        absCol: absCol === "$",
+        absRow: absRow === "$",
+    };
+};
+var formatAddr = function (row, col, absCol, absRow) {
+    var colAlpha = (0, numbers_1.number2Alpha)(Math.max(0, col - 1));
+    var rowNum = Math.max(1, row);
+    return "".concat(absCol ? "$" : "").concat(colAlpha).concat(absRow ? "$" : "").concat(rowNum);
+};
+var formulaToRelativeReference = function (formula, sourceCell, destinationCell, options) {
+    // Arguments exclusionRange and ignoreCircular were previously unused in this implementation
+    // We keep the options signature for compatibility but they remain unused in this regex-based impl?
+    // Actually, checking the previous code, they were underscored (_exclusionRange) so likely unused.
+    if (!formula)
+        return formula;
+    if (sourceCell.rowIndex === destinationCell.rowIndex &&
+        sourceCell.columnIndex === destinationCell.columnIndex) {
+        return formula;
+    }
+    var dRow = destinationCell.rowIndex - sourceCell.rowIndex;
+    var dCol = destinationCell.columnIndex - sourceCell.columnIndex;
+    return formula.replace(CELL_ADDR_RE, function (match, sheetPrefix, left, right) {
+        var adjustOne = function (addr) {
+            var p = parseAddr(addr);
+            if (!p)
+                return addr;
+            var newRow = p.absRow ? p.row : p.row + dRow;
+            var newCol = p.absCol ? p.col : p.col + dCol;
+            return formatAddr(newRow, newCol, p.absCol, p.absRow);
+        };
+        if (right) {
+            var leftAdjusted = adjustOne(left);
+            var rightAdjusted = adjustOne(right);
+            return "".concat(sheetPrefix !== null && sheetPrefix !== void 0 ? sheetPrefix : "").concat(leftAdjusted, ":").concat(rightAdjusted);
+        }
+        var singleAdjusted = adjustOne(left);
+        return "".concat(sheetPrefix !== null && sheetPrefix !== void 0 ? sheetPrefix : "").concat(singleAdjusted);
+    });
+};
+exports.formulaToRelativeReference = formulaToRelativeReference;

package/dist/cjs/formula.d.ts

@@ -0,0 +1,80 @@
+import type { AreaStyle, GridRange, SelectionArea } from "@rowsncolumns/common-types";
+/**
+ * Add/remove parenthesis in formulas
+ * @param str
+ * @returns
+ */
+export declare const balanceParentheses: (str: string) => string;
+/**
+ * Add closing quotes in formulas when a string is unterminated.
+ * Handles escaped quotes ("") inside strings.
+ */
+export declare const balanceQuotes: (str: string) => string;
+/**
+ * Add/remove parenthesis and add closing quotes in formulas.
+ */
+export declare const balanceFormula: (str: string) => string;
+/**
+ * Check if parenthesis is balanced
+ * @param str
+ * @returns
+ */
+export declare const isBalancedParenthesis: (str: string) => boolean;
+export declare const looksLikeMarkdown: (text: string) => boolean;
+export declare const setDefaultEnableAtFormula: (enable?: boolean) => void;
+/**
+ * Check if text is a formula
+ * @param text
+ * @returns
+ */
+export declare const isAFormula: (text: any) => boolean;
+/**
+ * Check if text is a formula-shaped expression stored WITHOUT the
+ * leading "=". OOXML defined names (`<definedName>` in workbook.xml)
+ * store their expressions bare — `OFFSET(Sheet1!$A$1,0,0,10)` rather
+ * than `=OFFSET(...)` — so `isAFormula` can't classify them.
+ *
+ * Returns false for anything that already resolves as a static value
+ * or plain reference today: quoted string / numeric / boolean
+ * literals, single-area range references (including external-workbook
+ * references like `'[1]Revenue'!$A$17`), and broken `#REF!`
+ * expressions. Returns true only for expressions that need the
+ * calculator: function calls and operator expressions.
+ * @param text
+ * @returns
+ */
+export declare const isBareFormulaExpression: (text: unknown) => boolean;
+export declare const isAlternateFormula: (text: string) => boolean;
+export declare const isValidFormula: (text: any) => boolean;
+/**
+ * Check if a key is an Arrow key
+ * @param code
+ * @returns
+ */
+export declare const isAnArrowKey: (code: string) => boolean;
+/**
+ * Iterate over all cells in a bound
+ * @param bounds
+ * @param callback
+ */
+export declare const iterateCells: (top: number, right: number | ((rowIndex: number) => number), bottom: number, left: number) => Generator<[number, number]>;
+export declare function combineIterators<T>(...generators: (Generator<T> | undefined)[]): Generator<T>;
+/**
+ * Iterate cells in range
+ * @param range
+ * @returns
+ */
+export type GridRangeIterator = GridRange | {
+    startRowIndex: number;
+    endColumnIndex: number | ((rowIndex: number) => number);
+    endRowIndex: number;
+    startColumnIndex: number;
+};
+export declare const iterateCellsInRange: (range: GridRangeIterator) => Generator<[number, number], any, any>;
+/**
+ * Iterate all cells in multiple selections
+ * @param selections
+ * @returns
+ */
+export declare const iterateSelections: <T extends AreaStyle>(selections: SelectionArea<T>[]) => Generator<Generator<[number, number], any, any>, void, unknown>;
+//# sourceMappingURL=formula.d.ts.map

package/dist/cjs/formula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula.d.ts","sourceRoot":"","sources":["../../formula.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACd,MAAM,4BAA4B,CAAC;AAgBpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,WAc7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,WAkDxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,WAEzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,MAAM,YAEhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,OAsChD,CAAC;AAIF,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,SAEzD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,GAAG,YAcnC,CAAC;AAYF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM,OAAO,KAAG,OAgCvD,CAAC;AAgBF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,YAwC9C,CAAC;AAGF,eAAO,MAAM,cAAc,GAAI,MAAM,GAAG,YAGvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,YAA6B,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,MAAM,EACX,OAAO,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,EAC9C,QAAQ,MAAM,EACd,MAAM,MAAM,KACX,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAO5B,CAAC;AAEF,wBAAiB,gBAAgB,CAAC,CAAC,EACjC,GAAG,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,GAC1C,SAAS,CAAC,CAAC,CAAC,CAId;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT;IACE,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AACN,eAAO,MAAM,mBAAmB,GAAI,OAAO,iBAAiB,0CAO3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAc,CAAC,SAAS,SAAS,EAC7D,YAAY,aAAa,CAAC,CAAC,CAAC,EAAE,oEAK/B,CAAC"}