@rowsncolumns/utils 9.2.35

package/dist/cjs/formula.js

@@ -0,0 +1,401 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iterateSelections = exports.iterateCellsInRange = exports.iterateCells = exports.isAnArrowKey = exports.isValidFormula = exports.isAlternateFormula = exports.isBareFormulaExpression = exports.isAFormula = exports.setDefaultEnableAtFormula = exports.looksLikeMarkdown = exports.isBalancedParenthesis = exports.balanceFormula = exports.balanceQuotes = exports.balanceParentheses = void 0;
+exports.combineIterators = combineIterators;
+var tslib_1 = require("tslib");
+var selection_1 = require("./selection");
+/* Close parenthesis mapping */
+var inverseParenMap = {
+    "(": ")",
+    "[": "]",
+};
+/* Check if a str is function parenthesis */
+var isParen = function (char) { return "()[]".indexOf(char) !== -1; };
+/* Check if a str is open parenthesis */
+var isOpenParen = function (char) { return "(" === char || "[" === char; };
+/**
+ * Add/remove parenthesis in formulas
+ * @param str
+ * @returns
+ */
+var balanceParentheses = function (str) {
+    var chars = str.split("");
+    var stack = [];
+    for (var i = 0; i < chars.length; i++) {
+        var char = chars[i];
+        if (isParen(char)) {
+            if (isOpenParen(char)) {
+                stack.push(char);
+            }
+            else {
+                if (stack.length !== 0)
+                    stack.pop();
+            }
+        }
+    }
+    return str + stack.map(function (item) { return inverseParenMap[item]; }).join("");
+};
+exports.balanceParentheses = balanceParentheses;
+/**
+ * Add closing quotes in formulas when a string is unterminated.
+ * Handles escaped quotes ("") inside strings.
+ */
+var balanceQuotes = function (str) {
+    var inString = false;
+    var openScopeCount = 0;
+    var stringStartScopeCount = 0;
+    for (var i = 0; i < str.length; i++) {
+        var char = str[i];
+        if (char === '"') {
+            if (inString && str[i + 1] === '"') {
+                i += 1;
+                continue;
+            }
+            inString = !inString;
+            if (inString) {
+                stringStartScopeCount = openScopeCount;
+            }
+            continue;
+        }
+        if (!inString) {
+            if (isOpenParen(char)) {
+                openScopeCount++;
+            }
+            else if (char === ")" || char === "]") {
+                if (openScopeCount > 0)
+                    openScopeCount--;
+            }
+        }
+    }
+    if (!inString) {
+        return str;
+    }
+    var insertIndex = str.length;
+    while (insertIndex > 0 && /\s/.test(str[insertIndex - 1])) {
+        insertIndex -= 1;
+    }
+    var closeStart = insertIndex;
+    while (closeStart > 0) {
+        var char = str[closeStart - 1];
+        if (char !== ")" && char !== "]")
+            break;
+        closeStart -= 1;
+    }
+    var trailingParensCount = insertIndex - closeStart;
+    var parensToKeepOutside = Math.min(stringStartScopeCount, trailingParensCount);
+    var insertionPos = insertIndex - parensToKeepOutside;
+    return "".concat(str.slice(0, insertionPos), "\"").concat(str.slice(insertionPos));
+};
+exports.balanceQuotes = balanceQuotes;
+/**
+ * Add/remove parenthesis and add closing quotes in formulas.
+ */
+var balanceFormula = function (str) {
+    return (0, exports.balanceParentheses)(str);
+};
+exports.balanceFormula = balanceFormula;
+/**
+ * Check if parenthesis is balanced
+ * @param str
+ * @returns
+ */
+var isBalancedParenthesis = function (str) {
+    return (0, exports.balanceParentheses)(str).length === str.length;
+};
+exports.isBalancedParenthesis = isBalancedParenthesis;
+var looksLikeMarkdown = function (text) {
+    var normalizedText = text.replace(/\\n/g, "\n").replace(/\\r/g, "\r");
+    var trimmedStart = normalizedText.trimStart();
+    if (!trimmedStart) {
+        return false;
+    }
+    var firstLine = trimmedStart.split("\n", 1)[0];
+    // Text starting with `---` is considered markdown (horizontal rule or front matter)
+    if (firstLine.startsWith("--")) {
+        return true;
+    }
+    // Front matter: starts with --- and another --- appears within a few lines.
+    if (/^---\s*$/.test(firstLine)) {
+        var lines = trimmedStart.split("\n").slice(1, 20);
+        if (lines.some(function (line) { return /^---\s*$/.test(line); })) {
+            return true;
+        }
+        // Heuristic: if a front-matter-like start is followed by markdown markers,
+        // treat it as markdown even without a closing ---.
+        if (lines.some(function (line) {
+            return /^(#{1,6}\s|>\s|[-*]\s|\d+\.\s|\|)/.test(line.trimStart());
+        })) {
+            return true;
+        }
+    }
+    // Common markdown markers.
+    if (/^(#{1,6}\s|>\s|[-*]\s|\d+\.\s|\|)/.test(trimmedStart)) {
+        return true;
+    }
+    // Horizontal rule only (line with ---/***/___).
+    return /^(?:---|\*\*\*|___)\s*$/.test(firstLine);
+};
+exports.looksLikeMarkdown = looksLikeMarkdown;
+var defaultEnableAtFormula = false;
+var setDefaultEnableAtFormula = function (enable) {
+    defaultEnableAtFormula = enable !== null && enable !== void 0 ? enable : false;
+};
+exports.setDefaultEnableAtFormula = setDefaultEnableAtFormula;
+/**
+ * Check if text is a formula
+ * @param text
+ * @returns
+ */
+var isAFormula = function (text) {
+    var textStr = String(text);
+    if ((0, exports.looksLikeMarkdown)(textStr)) {
+        return false;
+    }
+    // A formula's expression can never legitimately begin with a second "="
+    // right after the leading one — neither Excel nor Google Sheets has a token
+    // that starts an expression with "=". So "==", "===", "=== heading ===" and
+    // similar are decorative/label text, not a (broken) formula. Treat them as
+    // plain text instead of routing them through the calculator.
+    if (textStr.startsWith("==")) {
+        return false;
+    }
+    return !!textStr.startsWith("=") || (0, exports.isAlternateFormula)(textStr);
+};
+exports.isAFormula = isAFormula;
+/* Quoted string literal, e.g. `"North Region"` (with `""` escapes). */
+var STRING_LITERAL_ONLY = /^"(?:[^"]|"")*"$/;
+/* Numeric literal, e.g. `42`, `-1.5`, `.5`, `1e3`, `12%`. */
+var NUMERIC_LITERAL_ONLY = /^[+-]?(?:\d+(?:\.\d+)?|\.\d+)(?:[eE][+-]?\d+)?%?$/;
+/* Boolean literal. */
+var BOOLEAN_LITERAL_ONLY = /^(?:TRUE|FALSE)$/i;
+/* Formula operators that can only appear in an expression that needs
+ * the calculator (scanned outside quoted segments). */
+var FORMULA_OPERATOR = /[+\-*/^&<>=]/;
+/**
+ * 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
+ */
+var isBareFormulaExpression = function (text) {
+    if (typeof text !== "string") {
+        return false;
+    }
+    var trimmed = text.trim();
+    if (!trimmed || trimmed.startsWith("=")) {
+        return false;
+    }
+    if (trimmed.includes("#REF!")) {
+        return false;
+    }
+    if (STRING_LITERAL_ONLY.test(trimmed) ||
+        NUMERIC_LITERAL_ONLY.test(trimmed) ||
+        BOOLEAN_LITERAL_ONLY.test(trimmed)) {
+        return false;
+    }
+    if ((0, selection_1.checkIfStringIsReference)(trimmed)) {
+        return false;
+    }
+    // Function call or parenthesized sub-expression.
+    if (trimmed.includes("(")) {
+        return true;
+    }
+    // Operator expression like `Sheet1!$A$1*2`. Strip string literals
+    // and quoted sheet names first so `'My-Sheet'!$A$1` isn't misread
+    // as subtraction.
+    var scannable = trimmed
+        .replace(/"(?:[^"]|"")*"/g, "")
+        .replace(/'[^']*'/g, "");
+    return FORMULA_OPERATOR.test(scannable);
+};
+exports.isBareFormulaExpression = isBareFormulaExpression;
+// Pre-compiled `\p{Sc}` (Unicode currency-symbol category) check. Used to
+// distinguish currency input like `-$100` / `+€50` from formula-prefixed
+// input like `-A1` / `+SUM(A1:B2)`. Wrapped in try/catch because some
+// older JS engines don't support Unicode property escapes.
+var CURRENCY_SYMBOL_START = (function () {
+    try {
+        return new RegExp("^\\p{Sc}", "u");
+    }
+    catch (_a) {
+        return /^[£$€¥₹₽₩₪₫₴₸₺₼₾₿]/;
+    }
+})();
+// Check if its alternate formula
+// ie the text starts with +
+var isAlternateFormula = function (text) {
+    // @ can be treated as formula in Excel (even if invalid), but is disabled by default here
+    if (text.startsWith("@"))
+        return defaultEnableAtFormula;
+    if (!text.startsWith("+") && !text.startsWith("-"))
+        return false;
+    // Remove the leading + and check if what remains is just a number
+    var afterSign = text.slice(1).trim();
+    // If it's empty or just a number literal, it's not a formula
+    // Also check with common thousands separators removed (comma and period)
+    // to handle locale-formatted numbers like "1,234" or "1.234"
+    if (!afterSign || !isNaN(Number(afterSign))) {
+        return false;
+    }
+    // Excel parity: a leading sign followed by a currency symbol is the start
+    // of a (possibly in-progress) currency negative / positive — `-$100`,
+    // `+€50`, `-£1,234.56`. Excel treats these as currency, not formulas,
+    // even mid-type (the bare `-$` shows as text until digits are added).
+    if (CURRENCY_SYMBOL_START.test(afterSign)) {
+        return false;
+    }
+    // Check for numbers with thousands separators (e.g., "1,234" or "1.234,56")
+    // Strip commas and periods that look like thousands separators
+    var withoutThousandsSeparators = afterSign.replace(/[,.]/g, "");
+    if (/^\d+$/.test(withoutThousandsSeparators)) {
+        return false;
+    }
+    // If there is whitespace with no letters, treat it as text unless it uses
+    // non-hyphen operators (phone numbers like "+1 224-535-1764").
+    var hasLetters = /[A-Za-z]/.test(afterSign);
+    if (/\s/.test(afterSign) && !hasLetters) {
+        return /[+*/^=<>]/.test(afterSign);
+    }
+    // Otherwise, it's a formula like +A1, +SUM(A1:B2), +1-2, etc.
+    return true;
+};
+exports.isAlternateFormula = isAlternateFormula;
+// Check if its a valid formula
+var isValidFormula = function (text) {
+    var str = String(text);
+    return str[0] === "=" && str.length > 1;
+};
+exports.isValidFormula = isValidFormula;
+/**
+ * Check if a key is an Arrow key
+ * @param code
+ * @returns
+ */
+var isAnArrowKey = function (code) { return code.startsWith("Arrow"); };
+exports.isAnArrowKey = isAnArrowKey;
+/**
+ * Iterate over all cells in a bound
+ * @param bounds
+ * @param callback
+ */
+var iterateCells = function (top, right, bottom, left) {
+    var rowIndex, rightBound, columnIndex;
+    return tslib_1.__generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                rowIndex = top;
+                _a.label = 1;
+            case 1:
+                if (!(rowIndex <= bottom)) return [3 /*break*/, 6];
+                rightBound = typeof right === "function" ? right(rowIndex) : right;
+                columnIndex = left;
+                _a.label = 2;
+            case 2:
+                if (!(columnIndex <= rightBound)) return [3 /*break*/, 5];
+                return [4 /*yield*/, [rowIndex, columnIndex]];
+            case 3:
+                _a.sent();
+                _a.label = 4;
+            case 4:
+                columnIndex++;
+                return [3 /*break*/, 2];
+            case 5:
+                rowIndex++;
+                return [3 /*break*/, 1];
+            case 6: return [2 /*return*/];
+        }
+    });
+};
+exports.iterateCells = iterateCells;
+function combineIterators() {
+    var _i, generators_1, generators_1_1, generator, e_1_1;
+    var e_1, _a;
+    var generators = [];
+    for (_i = 0; _i < arguments.length; _i++) {
+        generators[_i] = arguments[_i];
+    }
+    return tslib_1.__generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                _b.trys.push([0, 5, 6, 7]);
+                generators_1 = tslib_1.__values(generators), generators_1_1 = generators_1.next();
+                _b.label = 1;
+            case 1:
+                if (!!generators_1_1.done) return [3 /*break*/, 4];
+                generator = generators_1_1.value;
+                if (!generator) return [3 /*break*/, 3];
+                return [5 /*yield**/, tslib_1.__values(generator)];
+            case 2:
+                _b.sent();
+                _b.label = 3;
+            case 3:
+                generators_1_1 = generators_1.next();
+                return [3 /*break*/, 1];
+            case 4: return [3 /*break*/, 7];
+            case 5:
+                e_1_1 = _b.sent();
+                e_1 = { error: e_1_1 };
+                return [3 /*break*/, 7];
+            case 6:
+                try {
+                    if (generators_1_1 && !generators_1_1.done && (_a = generators_1.return)) _a.call(generators_1);
+                }
+                finally { if (e_1) throw e_1.error; }
+                return [7 /*endfinally*/];
+            case 7: return [2 /*return*/];
+        }
+    });
+}
+var iterateCellsInRange = function (range) {
+    return (0, exports.iterateCells)(range.startRowIndex, range.endColumnIndex, range.endRowIndex, range.startColumnIndex);
+};
+exports.iterateCellsInRange = iterateCellsInRange;
+/**
+ * Iterate all cells in multiple selections
+ * @param selections
+ * @returns
+ */
+var iterateSelections = function (selections) {
+    var selections_1, selections_1_1, selection, e_2_1;
+    var e_2, _a;
+    return tslib_1.__generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                _b.trys.push([0, 5, 6, 7]);
+                selections_1 = tslib_1.__values(selections), selections_1_1 = selections_1.next();
+                _b.label = 1;
+            case 1:
+                if (!!selections_1_1.done) return [3 /*break*/, 4];
+                selection = selections_1_1.value;
+                return [4 /*yield*/, (0, exports.iterateCellsInRange)(selection.range)];
+            case 2:
+                _b.sent();
+                _b.label = 3;
+            case 3:
+                selections_1_1 = selections_1.next();
+                return [3 /*break*/, 1];
+            case 4: return [3 /*break*/, 7];
+            case 5:
+                e_2_1 = _b.sent();
+                e_2 = { error: e_2_1 };
+                return [3 /*break*/, 7];
+            case 6:
+                try {
+                    if (selections_1_1 && !selections_1_1.done && (_a = selections_1.return)) _a.call(selections_1);
+                }
+                finally { if (e_2) throw e_2.error; }
+                return [7 /*endfinally*/];
+            case 7: return [2 /*return*/];
+        }
+    });
+};
+exports.iterateSelections = iterateSelections;

package/dist/cjs/index.d.ts

@@ -0,0 +1,24 @@
+export * from "./numbers";
+export * from "./uuid";
+export * from "./typeguards";
+export * from "./string";
+export * from "./formula";
+export * from "./color";
+export * from "./dom";
+export * from "./locale";
+export * from "./date";
+export * from "./log";
+export * from "./array";
+export * from "./formatter";
+export * from "./memoize";
+export * from "./cell-data-helpers";
+export * from "./selection";
+export * from "./colors";
+export * from "./formula-refs";
+export * from "./sort";
+export * from "./table-styles";
+export * from "./conditional-format";
+export * from "./data-validation";
+export * from "./content-hash";
+export * from "./shared-string-canonical";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./numbers"), exports);
+tslib_1.__exportStar(require("./uuid"), exports);
+tslib_1.__exportStar(require("./typeguards"), exports);
+tslib_1.__exportStar(require("./string"), exports);
+tslib_1.__exportStar(require("./formula"), exports);
+tslib_1.__exportStar(require("./color"), exports);
+tslib_1.__exportStar(require("./dom"), exports);
+tslib_1.__exportStar(require("./locale"), exports);
+tslib_1.__exportStar(require("./date"), exports);
+tslib_1.__exportStar(require("./log"), exports);
+tslib_1.__exportStar(require("./array"), exports);
+tslib_1.__exportStar(require("./formatter"), exports);
+tslib_1.__exportStar(require("./memoize"), exports);
+tslib_1.__exportStar(require("./cell-data-helpers"), exports);
+tslib_1.__exportStar(require("./selection"), exports);
+tslib_1.__exportStar(require("./colors"), exports);
+tslib_1.__exportStar(require("./formula-refs"), exports);
+tslib_1.__exportStar(require("./sort"), exports);
+tslib_1.__exportStar(require("./table-styles"), exports);
+tslib_1.__exportStar(require("./conditional-format"), exports);
+tslib_1.__exportStar(require("./data-validation"), exports);
+tslib_1.__exportStar(require("./content-hash"), exports);
+tslib_1.__exportStar(require("./shared-string-canonical"), exports);

package/dist/cjs/locale.d.ts

@@ -0,0 +1,34 @@
+export declare const getCurrentLocale: () => string;
+export type DatePartType = "month" | "day" | "year";
+/**
+ * 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.
+ */
+export declare const getLocaleDatePartsNotMemoized: (locale: string) => [DatePartType, string, string][];
+export declare const getLocaleDateParts: (locale: string) => [DatePartType, string, string][];
+/**
+ * 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`.
+ */
+export declare const getDefaultDateFormat: (locale?: string) => string;
+/**
+ * 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`.
+ */
+export declare const getDefaultTimeFormat: (locale?: string, precision?: "minute" | "second") => string;
+export declare const getDefaultDateTimeFormat: (locale?: string) => string;
+/**
+ * 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.
+ */
+export declare const getLongDateFormat: (locale?: string) => string;
+//# sourceMappingURL=locale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../locale.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,cAU5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,MAAM,qCAkC3D,CAAC;AAEF,eAAO,MAAM,kBAAkB,sDAAyC,CAAC;AAqFzE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAQ,MAA2B,WAClC,CAAC;AAuCvC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAQ,MAA2B,EACnC,YAAW,QAAQ,GAAG,QAAmB,WACS,CAAC;AAErD,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,WAEvD,CAAC;AA2CF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAQ,MAA2B,WAClC,CAAC"}