@rowsncolumns/utils 9.2.35

package/dist/cjs/locale.js

@@ -0,0 +1,260 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLongDateFormat = exports.getDefaultDateTimeFormat = exports.getDefaultTimeFormat = exports.getDefaultDateFormat = exports.getLocaleDateParts = exports.getLocaleDatePartsNotMemoized = exports.getCurrentLocale = void 0;
+var tslib_1 = require("tslib");
+var memoize_1 = require("./memoize");
+var defaultLocale;
+var getCurrentLocale = function () {
+    if (defaultLocale) {
+        return defaultLocale;
+    }
+    try {
+        defaultLocale = Intl.DateTimeFormat().resolvedOptions().locale;
+    }
+    catch (err) {
+        defaultLocale = "en-US";
+    }
+    return defaultLocale;
+};
+exports.getCurrentLocale = getCurrentLocale;
+/**
+ * PARSER metadata only: relative day/month order for a locale, with the
+ * year deliberately moved last so the date-parser's regex can use fixed
+ * capture-group positions. This ordering is WRONG for display in
+ * year-first locales (ja-JP, hu-HU, sv-SE, …) — formatting helpers must
+ * use the `formatToParts`-driven builders below instead.
+ */
+var getLocaleDatePartsNotMemoized = function (locale) {
+    var e_1, _a;
+    var parts = [];
+    try {
+        var formatObj = new Intl.DateTimeFormat(locale).formatToParts(new Date());
+        try {
+            for (var formatObj_1 = tslib_1.__values(formatObj), formatObj_1_1 = formatObj_1.next(); !formatObj_1_1.done; formatObj_1_1 = formatObj_1.next()) {
+                var part = formatObj_1_1.value;
+                if (part.type === "day") {
+                    parts.push(["day", "d", "dd"]);
+                }
+                if (part.type === "month") {
+                    parts.push(["month", "m", "mm"]);
+                }
+                if (part.type === "year") {
+                    parts.push(["year", "yy", "yyyy"]);
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (formatObj_1_1 && !formatObj_1_1.done && (_a = formatObj_1.return)) _a.call(formatObj_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        // Always move year to last to prevent
+        // errors in Regex (duplicate capture group)
+        parts.sort(function (_, _a) {
+            var _b = tslib_1.__read(_a, 1), typeB = _b[0];
+            if (typeB === "year") {
+                return -1;
+            }
+            return 1;
+        });
+    }
+    catch (err) {
+        // en-US
+        parts = [
+            ["month", "m", "mm"],
+            ["day", "d", "dd"],
+            ["year", "yy", "yyyy"],
+        ];
+    }
+    return parts;
+};
+exports.getLocaleDatePartsNotMemoized = getLocaleDatePartsNotMemoized;
+exports.getLocaleDateParts = (0, memoize_1.memoize)(exports.getLocaleDatePartsNotMemoized);
+/**
+ * Fixed sample instant used to discover a locale's date/time pattern via
+ * `formatToParts`. Every numeric field is single-digit (5 April 2008,
+ * 05:09:07 UTC) so locale padding is observable: a locale that renders
+ * "05" for the day pads days, one that renders "5" does not.
+ */
+var FORMAT_SAMPLE_DATE = new Date(Date.UTC(2008, 3, 5, 5, 9, 7));
+/**
+ * Literal characters that spreadsheet number-format syntax accepts
+ * unquoted inside a date/time section. Anything else (words such as
+ * "г.", CJK markers such as 年/月/日, bidi controls, commas — which
+ * numfmt/Excel read as the thousands/scaling operator, e.g. hu-HU's
+ * `.,` literal — …) must be wrapped in double quotes.
+ */
+var SAFE_PATTERN_LITERAL = /^[\s./:-]*$/;
+var escapePatternLiteral = function (value) {
+    if (SAFE_PATTERN_LITERAL.test(value)) {
+        return value;
+    }
+    // Number-format strings cannot represent an embedded double quote —
+    // no locale literal contains one, so dropping it is safe.
+    return "\"".concat(value.replace(/"/g, ""), "\"");
+};
+var numericFieldToken = function (short, long, partValue) { return (partValue.length === 2 ? long : short); };
+var dateFieldToken = function (part) {
+    switch (part.type) {
+        case "day":
+            return numericFieldToken("d", "dd", part.value);
+        case "month":
+            return numericFieldToken("m", "mm", part.value);
+        case "year":
+            return part.value.length === 2 ? "yy" : "yyyy";
+        case "literal":
+            return escapePatternLiteral(part.value);
+        default:
+            // era and other exotic fields have no spreadsheet token — skip.
+            return undefined;
+    }
+};
+var buildPatternFromParts = function (parts, toToken) {
+    var e_2, _a;
+    var pattern = "";
+    try {
+        for (var parts_1 = tslib_1.__values(parts), parts_1_1 = parts_1.next(); !parts_1_1.done; parts_1_1 = parts_1.next()) {
+            var part = parts_1_1.value;
+            var token = toToken(part);
+            if (token !== undefined) {
+                pattern += token;
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (parts_1_1 && !parts_1_1.done && (_a = parts_1.return)) _a.call(parts_1);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    // A locale's pattern may end (or begin) with a literal that belongs to
+    // trailing fields we skipped (e.g. an era) — trim stray whitespace.
+    return pattern.trim();
+};
+var getDefaultDateFormatMemoized = (0, memoize_1.memoize)(function (locale) {
+    try {
+        var parts = new Intl.DateTimeFormat(locale, {
+            calendar: "gregory",
+            numberingSystem: "latn",
+            year: "numeric",
+            month: "numeric",
+            day: "numeric",
+            timeZone: "UTC",
+        }).formatToParts(FORMAT_SAMPLE_DATE);
+        var pattern = buildPatternFromParts(parts, dateFieldToken);
+        return pattern || "m/d/yyyy";
+    }
+    catch (err) {
+        return "m/d/yyyy";
+    }
+});
+/**
+ * Default numeric (short) date pattern for a locale, preserving the
+ * locale's field order, separators, literal text and zero-padding as
+ * reported by `Intl.DateTimeFormat(...).formatToParts()` — e.g.
+ * de-DE → `d.m.yyyy`, hu-HU → `yyyy. mm. dd.`, en-CA → `yyyy-mm-dd`.
+ */
+var getDefaultDateFormat = function (locale) {
+    if (locale === void 0) { locale = (0, exports.getCurrentLocale)(); }
+    return getDefaultDateFormatMemoized(locale);
+};
+exports.getDefaultDateFormat = getDefaultDateFormat;
+var getDefaultTimeFormatMemoized = (0, memoize_1.memoize)(function (locale, precision) {
+    try {
+        var parts = new Intl.DateTimeFormat(locale, tslib_1.__assign(tslib_1.__assign({ numberingSystem: "latn", hour: "numeric", minute: "numeric" }, (precision === "second" ? { second: "numeric" } : {})), { timeZone: "UTC" })).formatToParts(FORMAT_SAMPLE_DATE);
+        var pattern = buildPatternFromParts(parts, function (part) {
+            switch (part.type) {
+                case "hour":
+                    return numericFieldToken("h", "hh", part.value);
+                case "minute":
+                    return "mm";
+                case "second":
+                    return "ss";
+                case "dayPeriod":
+                    // Spreadsheet syntax only has the English AM/PM token; its
+                    // presence is what switches the hour field to 12-hour mode.
+                    return "AM/PM";
+                case "literal":
+                    return escapePatternLiteral(part.value);
+                default:
+                    return undefined;
+            }
+        });
+        var fallback = precision === "second" ? "h:mm:ss AM/PM" : "h:mm AM/PM";
+        return pattern || fallback;
+    }
+    catch (err) {
+        return precision === "second" ? "h:mm:ss AM/PM" : "h:mm AM/PM";
+    }
+});
+/**
+ * Default time pattern for a locale, honoring its 12/24-hour convention,
+ * separators and hour padding — e.g. en-US → `h:mm:ss AM/PM`,
+ * de-DE → `hh:mm:ss`, fi-FI → `h.mm.ss`.
+ */
+var getDefaultTimeFormat = function (locale, precision) {
+    if (locale === void 0) { locale = (0, exports.getCurrentLocale)(); }
+    if (precision === void 0) { precision = "second"; }
+    return getDefaultTimeFormatMemoized(locale, precision);
+};
+exports.getDefaultTimeFormat = getDefaultTimeFormat;
+var getDefaultDateTimeFormat = function (locale) {
+    return (0, exports.getDefaultDateFormat)(locale) + " " + (0, exports.getDefaultTimeFormat)(locale);
+};
+exports.getDefaultDateTimeFormat = getDefaultDateTimeFormat;
+var getLongDateFormatMemoized = (0, memoize_1.memoize)(function (locale) {
+    try {
+        var parts = new Intl.DateTimeFormat(locale, {
+            calendar: "gregory",
+            numberingSystem: "latn",
+            weekday: "long",
+            year: "numeric",
+            month: "long",
+            day: "numeric",
+            timeZone: "UTC",
+        }).formatToParts(FORMAT_SAMPLE_DATE);
+        var pattern = buildPatternFromParts(parts, function (part) {
+            switch (part.type) {
+                case "weekday":
+                    return "dddd";
+                case "month":
+                    // CJK locales keep the month numeric even in long dates
+                    // ("9月"): Intl reports the digit with 月/월 as a literal, and
+                    // the formatter's own `mmmm` would re-append the marker.
+                    return /^\d+$/.test(part.value)
+                        ? numericFieldToken("m", "mm", part.value)
+                        : "mmmm";
+                case "day":
+                    return numericFieldToken("d", "dd", part.value);
+                case "year":
+                    return part.value.length === 2 ? "yy" : "yyyy";
+                case "literal":
+                    return escapePatternLiteral(part.value);
+                default:
+                    return undefined;
+            }
+        });
+        if (!pattern) {
+            return "[$-".concat(locale, "]dddd, mmmm d, yyyy");
+        }
+        return "[$-".concat(locale, "]").concat(pattern);
+    }
+    catch (err) {
+        return "[$-".concat(locale, "]dddd, mmmm d, yyyy");
+    }
+});
+/**
+ * Long (full) date pattern for a locale, following the locale's own
+ * field placement and literal text — e.g. de-DE →
+ * `[$-de-DE]dddd, d. mmmm yyyy`, ja-JP → `[$-ja-JP]yyyy"年"m"月"d"日"dddd`.
+ * Localized weekday/month names are best-effort: they render through the
+ * spreadsheet formatter's own locale data via the `[$-locale]` tag.
+ */
+var getLongDateFormat = function (locale) {
+    if (locale === void 0) { locale = (0, exports.getCurrentLocale)(); }
+    return getLongDateFormatMemoized(locale);
+};
+exports.getLongDateFormat = getLongDateFormat;

package/dist/cjs/log.d.ts

@@ -0,0 +1,4 @@
+export declare const log: (...args: any[]) => false | void;
+export declare const debug: (...args: any[]) => false | void;
+export declare const error: (...args: any[]) => false | void;
+//# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../log.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,GAAG,EAAE,iBAC6B,CAAC;AAChE,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,GAAG,EAAE,iBAC6B,CAAC;AAClE,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,GAAG,EAAE,iBAC6B,CAAC"}

package/dist/cjs/log.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.error = exports.debug = exports.log = void 0;
+var tslib_1 = require("tslib");
+var log = function () {
+    var args = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        args[_i] = arguments[_i];
+    }
+    return process.env.NODE_ENV !== "production" && console.log.apply(console, tslib_1.__spreadArray([], tslib_1.__read(args), false));
+};
+exports.log = log;
+var debug = function () {
+    var args = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        args[_i] = arguments[_i];
+    }
+    return process.env.NODE_ENV !== "production" && console.debug.apply(console, tslib_1.__spreadArray([], tslib_1.__read(args), false));
+};
+exports.debug = debug;
+var error = function () {
+    var args = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        args[_i] = arguments[_i];
+    }
+    return process.env.NODE_ENV !== "production" && console.error.apply(console, tslib_1.__spreadArray([], tslib_1.__read(args), false));
+};
+exports.error = error;

package/dist/cjs/memoize.d.ts

@@ -0,0 +1,18 @@
+export declare const memoize: <T extends unknown[], K>(fn: (...args: T) => K) => (...args: T) => K;
+/**
+ * Mint a stable cellXfs key ("sid") for a CellFormat. The key is
+ * `contentHash` (FNV-1a-64 → 8-char base62) over a delimiter-separated
+ * canonical serialization of the format's defined properties — the
+ * previous 31-bit rolling int hash silently collided two different
+ * formats onto one registry key (first-writer wins, so e.g. a red
+ * format could hijack a blue one on import).
+ *
+ * Sids are minted at import/edit time and persisted in the doc's
+ * cellXfs map together with the cell references that carry them —
+ * readback resolves a stored sid against the stored map, never by
+ * re-hashing. Changing this algorithm therefore only affects newly
+ * minted keys; existing docs keep resolving their old sids.
+ */
+export declare const getCellXfsKey: (userObj: any | null | undefined) => string;
+export declare const definedProps: <T extends Record<string, any> | undefined | null>(obj: T) => Partial<NonNullable<T>> | T;
+//# sourceMappingURL=memoize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.d.ts","sourceRoot":"","sources":["../../memoize.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,MAE3D,GAAG,MAAM,CAAC,MASnB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,GAAG,GAAG,IAAI,GAAG,SAAS,KAAG,MA4D/D,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,EAC3E,KAAK,CAAC,KACL,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAU5B,CAAC"}

package/dist/cjs/memoize.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definedProps = exports.getCellXfsKey = exports.memoize = void 0;
+var tslib_1 = require("tslib");
+var content_hash_1 = require("./content-hash");
+var typeguards_1 = require("./typeguards");
+var memoize = function (fn) {
+    var cache = new Map();
+    return function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        var key = String(args);
+        if (cache.has(key)) {
+            return cache.get(key);
+        }
+        var value = fn.call.apply(fn, tslib_1.__spreadArray([undefined], tslib_1.__read(args), false));
+        cache.set(key, value);
+        return value;
+    };
+};
+exports.memoize = memoize;
+/**
+ * Mint a stable cellXfs key ("sid") for a CellFormat. The key is
+ * `contentHash` (FNV-1a-64 → 8-char base62) over a delimiter-separated
+ * canonical serialization of the format's defined properties — the
+ * previous 31-bit rolling int hash silently collided two different
+ * formats onto one registry key (first-writer wins, so e.g. a red
+ * format could hijack a blue one on import).
+ *
+ * Sids are minted at import/edit time and persisted in the doc's
+ * cellXfs map together with the cell references that carry them —
+ * readback resolves a stored sid against the stored map, never by
+ * re-hashing. Changing this algorithm therefore only affects newly
+ * minted keys; existing docs keep resolving their old sids.
+ */
+var getCellXfsKey = function (userObj) {
+    var e_1, _a;
+    if (userObj === null || userObj === undefined) {
+        return String(0);
+    }
+    var obj = (0, exports.definedProps)(userObj);
+    var serialized = "";
+    var hashString = function (str) {
+        // `\u0001` terminates every atom so adjacent strings can't merge
+        // into the same serialization (`{a:"bc"}` vs `{ab:"c"}`).
+        serialized += str + "\u0001";
+    };
+    var hashValue = function (value) {
+        var e_2, _a;
+        if (value === null || value === undefined)
+            return;
+        if (typeof value === "object") {
+            // Custom serialization for known object types
+            var sortedKeys = Object.keys(value).sort();
+            serialized += "\u0002";
+            try {
+                for (var sortedKeys_1 = tslib_1.__values(sortedKeys), sortedKeys_1_1 = sortedKeys_1.next(); !sortedKeys_1_1.done; sortedKeys_1_1 = sortedKeys_1.next()) {
+                    var key = sortedKeys_1_1.value;
+                    hashString(key);
+                    hashValue(value[key]);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (sortedKeys_1_1 && !sortedKeys_1_1.done && (_a = sortedKeys_1.return)) _a.call(sortedKeys_1);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+            serialized += "\u0003";
+        }
+        else {
+            hashString(String(value));
+        }
+    };
+    // Hash each property in a consistent order. The list MUST cover every
+    // field that distinguishes one CellFormat from another — when two
+    // different formats hash to the same key, the cellXfs registry
+    // dedupes them, so cells lose any field that wasn't in this list.
+    var props = [
+        "backgroundColor",
+        "borders",
+        "textFormat",
+        "numberFormat",
+        "horizontalAlignment",
+        "verticalAlignment",
+        "wrapStrategy",
+        "indent",
+        "textRotation",
+        "shrinkToFit",
+        "relativeIndent",
+        "fillPattern",
+        "foregroundColor",
+        "gradient",
+    ];
+    try {
+        for (var props_1 = tslib_1.__values(props), props_1_1 = props_1.next(); !props_1_1.done; props_1_1 = props_1.next()) {
+            var prop = props_1_1.value;
+            if (obj[prop] !== undefined) {
+                hashString(String(prop)); // Include property name in hash
+                hashValue(obj[prop]);
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (props_1_1 && !props_1_1.done && (_a = props_1.return)) _a.call(props_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return (0, content_hash_1.contentHash)(serialized);
+};
+exports.getCellXfsKey = getCellXfsKey;
+var definedProps = function (obj) {
+    if ((0, typeguards_1.isNil)(obj))
+        return obj;
+    var result = {};
+    for (var key in obj) {
+        if (!(0, typeguards_1.isNil)(obj[key])) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+};
+exports.definedProps = definedProps;

package/dist/cjs/numbers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Convert number to alphabet
+ * @param i
+ */
+export declare const number2Alpha: (i: number) => string;
+/**
+ * Converts a letter to number
+ * A = 1
+ * B => 2
+ * @param letters
+ */
+export declare const alpha2number: (letters: string) => number;
+/**
+ * Get min max of an array
+ * @param arr
+ */
+export declare const getMinMaxArray: (arr: number[]) => number[];
+export declare const isNumber: (value: any) => value is number;
+//# sourceMappingURL=numbers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../numbers.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,KAAG,MAIxC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAE9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,EAAE,aAa3C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,OAAO,GAAG,KAAG,KAAK,IAAI,MAAuB,CAAC"}

package/dist/cjs/numbers.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNumber = exports.getMinMaxArray = exports.alpha2number = exports.number2Alpha = void 0;
+// Pre-compute alphabet string to avoid repeated string access
+var ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+/**
+ * Convert number to alphabet
+ * @param i
+ */
+var number2Alpha = function (i) {
+    return ((i >= 26 ? (0, exports.number2Alpha)(((i / 26) >> 0) - 1) : "") + ALPHABET[i % 26 >> 0]);
+};
+exports.number2Alpha = number2Alpha;
+/**
+ * Converts a letter to number
+ * A = 1
+ * B => 2
+ * @param letters
+ */
+var alpha2number = function (letters) {
+    return letters.split("").reduce(function (r, a) { return r * 26 + parseInt(a, 36) - 9; }, 0);
+};
+exports.alpha2number = alpha2number;
+/**
+ * Get min max of an array
+ * @param arr
+ */
+var getMinMaxArray = function (arr) {
+    if (!arr.length)
+        return [0, 0];
+    // Loop, not spread — passing >~65k elements as call arguments throws
+    // `RangeError: Maximum call stack size exceeded` (selection-sized arrays
+    // reach millions).
+    var min = arr[0];
+    var max = arr[0];
+    for (var i = 1; i < arr.length; i++) {
+        var v = arr[i];
+        if (v < min)
+            min = v;
+        if (v > max)
+            max = v;
+    }
+    return [min, max];
+};
+exports.getMinMaxArray = getMinMaxArray;
+var isNumber = function (value) { return !isNaN(value); };
+exports.isNumber = isNumber;

package/dist/cjs/selection.d.ts

@@ -0,0 +1,88 @@
+import type { CellInterface, GridRange, SheetRange, SelectionArea } from "@rowsncolumns/common-types";
+import { type ParsedToken } from "@rowsncolumns/calculator";
+export type SelectionWithSheetName = SelectionArea & {
+    sheetName?: string;
+};
+export type SelectionFromTableResolver = (sheetId: number, activeCell?: CellInterface, tableName?: string, columnNames?: string[], thisRow?: boolean, specialItem?: ParsedToken["specialItem"]) => SelectionWithSheetName | undefined;
+export type SelectionFromNamedRangeResolver = (variableName: string) => SelectionWithSheetName | unknown;
+export declare const isSelection: (sel: unknown) => sel is SelectionWithSheetName;
+export declare const MAX_ROW_COUNT = 1048576;
+export declare const MAX_COLUMN_COUNT = 16384;
+export declare const DEFAULT_ROW_COUNT = 1000;
+export declare const DEFAULT_COLUMN_COUNT = 100;
+export declare const DEFAULT_ROW_HEIGHT = 21;
+export declare const DEFAULT_COLUMN_WIDTH = 100;
+export declare const DEFAULT_ACTIVE_CELL: CellInterface;
+export declare const addressToSelection: (address: string, rowCount?: number, columnCount?: number) => SelectionArea | undefined;
+export declare const addressToSheetRange: (address: string, sheetId: number, rowCount?: number, columnCount?: number) => SheetRange | undefined;
+/**
+ * Convert a selection object to A1 address form (optionally sheet-qualified).
+ */
+export declare const selectionToAddress: (selection: SelectionArea | undefined, sheetName?: string, merges?: GridRange[] | null, rowCount?: number, columnCount?: number) => string | undefined;
+export declare const checkIfStringIsReference: (value: string | undefined) => boolean;
+export declare const generateSelectionsFromFormula: (value: string, _sheetId?: number, currentSheetName?: string, activeCell?: CellInterface, rowCount?: number, columnCount?: number, tokenizer?: (value: string | undefined, sheetName?: string) => ParsedToken[], getSelectionFromTable?: SelectionFromTableResolver, getSelectionFromNamedRange?: SelectionFromNamedRangeResolver) => SelectionWithSheetName[];
+/**
+ * Check if two ranges are equal.
+ */
+export declare const isAreasEqual: (area1: GridRange | undefined, area2: GridRange | undefined) => boolean;
+/**
+ * Check if a cell is inside the provided range bounds.
+ */
+export declare const isCellWithinBounds: (cell: CellInterface, bounds?: GridRange) => boolean;
+/**
+ * Return a single-cell selection for the active cell.
+ */
+export declare const selectionFromActiveCell: (activeCell: CellInterface | null) => SelectionArea[];
+/**
+ * Check if two ranges overlap.
+ */
+export declare const areaIntersects: (area1: GridRange, area2: GridRange | undefined) => boolean;
+/**
+ * Check if `needle` range is fully inside `haystack`.
+ */
+export declare const areaInsideArea: (needle: GridRange, haystack: GridRange) => boolean;
+/**
+ * Intersection of two ranges, or `null` when they don't overlap.
+ */
+export declare const areaIntersection: (area1: GridRange, area2: GridRange) => GridRange | null;
+/**
+ * Re-scope a rule's ranges after a drag-move of `from` → `to` on `sheetId`, so
+ * range-scoped rules (conditional formats, data validations) travel with the
+ * moved cells the way Excel and Google Sheets carry them:
+ *
+ * - a range on another sheet, or untouched by the move, is kept as-is
+ * - a range that travelled entirely inside the moved area is shifted with it
+ * - a range that only partially overlaps the moved area keeps its original
+ *   scope (the source cells left behind keep the rule) and gains the shifted
+ *   overlap at the destination — unless one of the rule's ranges already
+ *   covers that destination
+ *
+ * Returns the new ranges, or `null` when the move leaves every range
+ * untouched, so callers can skip the rule update entirely (no history entry,
+ * no re-evaluation).
+ */
+export declare const rescopeSheetRangesOnMove: (ranges: readonly SheetRange[], sheetId: number, from: GridRange, to: GridRange) => SheetRange[] | null;
+/**
+ * Convert a cell coordinate into a single-cell range.
+ */
+export declare const cellToArea: ({ rowIndex, columnIndex, }: CellInterface) => GridRange;
+/**
+ * Convert font size from points to pixels.
+ */
+export declare const pointToPixel: (pt: number) => number;
+/**
+ * Convert font size from pixels to points.
+ */
+export declare const pixelToPoint: (px: number) => number;
+/**
+ * Resolve a table column name to absolute column index.
+ */
+export declare const getColumnIndexFromColumnName: (table: {
+    columns?: Array<{
+        name?: string | null;
+    }> | null;
+    range: {
+        startColumnIndex: number;
+    };
+}, columnName: string | undefined) => number | undefined;
+//# sourceMappingURL=selection.d.ts.map

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

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