@rowsncolumns/utils 9.2.38 → 9.2.40

package/dist/cjs/formatter.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ssfFormatColor = exports.ssfFormat = exports.isStandaloneMonthPattern = exports.isTextPattern = exports.isTimePattern = exports.isDateTimePattern = exports.isDatePattern = void 0;
+exports.ssfFormatColor = exports.ssfFormat = exports.withShortAmPmMarker = exports.isStandaloneMonthPattern = exports.isTextPattern = exports.isTimePattern = exports.isDateTimePattern = exports.isDatePattern = void 0;
 var tslib_1 = require("tslib");
 var numfmt_1 = require("numfmt");
 var colors_1 = require("./colors");
+var excel_number_format_1 = require("./excel-number-format");
 /**
  * Pattern-based type inference (Excel parity). xlsx files routinely carry
  * a `numberFormat.pattern` without an accompanying `type` field — these
@@ -188,12 +189,160 @@ var localeForPattern = function (pattern, locale) {
     }
     return standalone ? ((_a = getStandaloneMonthLocale(locale)) !== null && _a !== void 0 ? _a : locale) : locale;
 };
+var shortAmPmLocales = new Map();
+/**
+ * Excel's `A/P` renders one letter (`6:00 P`) in every locale, but numfmt
+ * honours the short form only when no locale is passed — under a locale it
+ * emits that locale's full designator (`6:00 PM`). Patterns with `A/P` render
+ * under a companion locale whose AM/PM designators are `A`/`P`. `locale` is a
+ * BCP 47 tag or an Excel LCID (`409`), as numfmt accepts both.
+ */
+var getShortAmPmLocale = function (locale) {
+    var _a;
+    var cached = shortAmPmLocales.get(locale);
+    if (cached !== undefined)
+        return cached;
+    var overlay = locale;
+    try {
+        overlay = "ampm_".concat(locale.replace(/[^a-z\d]/gi, ""));
+        (0, numfmt_1.addLocale)(tslib_1.__assign(tslib_1.__assign({}, ((_a = (0, numfmt_1.getLocale)(locale)) !== null && _a !== void 0 ? _a : {})), { ampm: ["A", "P"] }), overlay);
+    }
+    catch (_b) {
+        overlay = locale;
+    }
+    shortAmPmLocales.set(locale, overlay);
+    return overlay;
+};
+/**
+ * An Excel `[$-LCID]` / `[$symbol-LCID]` token pins the section's locale, and
+ * numfmt resolves it to that LCID's own table — ahead of the companion locale
+ * `ssfFormat` passes, so `[$-409]h:mm A/P` would still render `6:00 PM`.
+ * Re-point a known LCID or tag at its companion (`$-409` → `$-ampm_409`); an
+ * LCID numfmt does not know (`F400`) or one carrying calendar bits stays as
+ * written.
+ */
+var shortAmPmLocaleToken = function (token) {
+    var dash = token.indexOf("-");
+    if (dash < 0)
+        return token;
+    var code = token.slice(dash + 1);
+    var wincode = Number.parseInt(code, 16);
+    if (Number.isFinite(wincode) && wincode & 0xff0000)
+        return token;
+    if (!(0, numfmt_1.getLocale)(code))
+        return token;
+    return "".concat(token.slice(0, dash + 1)).concat(getShortAmPmLocale(code));
+};
+/**
+ * Does the pattern carry Excel's short `A/P` marker outside quoted literals,
+ * bracket directives and escapes? Returns the pattern with the marker
+ * upper-cased (Excel accepts `a/p` and renders it `A`/`P`; numfmt only
+ * tokenizes `A/P`) and its `[$-LCID]` tokens re-pointed at the companion
+ * `A`/`P` locale, or `undefined` when there is none.
+ */
+var withShortAmPmMarker = function (pattern) {
+    var e_1, _a;
+    var _b;
+    var chunks = [];
+    var localeChunks = [];
+    var found = false;
+    var inQuotes = false;
+    var inBrackets = false;
+    for (var i = 0; i < pattern.length; i++) {
+        var char = pattern[i];
+        if (inQuotes) {
+            inQuotes = char !== '"';
+        }
+        else if (inBrackets) {
+            inBrackets = char !== "]";
+        }
+        else if (char === '"') {
+            inQuotes = true;
+        }
+        else if (char === "[") {
+            var end = pattern[i + 1] === "$" ? pattern.indexOf("]", i) : -1;
+            if (end > 0) {
+                localeChunks.push(chunks.length);
+                chunks.push(pattern.slice(i + 1, end));
+                i = end;
+                continue;
+            }
+            inBrackets = true;
+        }
+        else if (char === "\\" || char === "_" || char === "*") {
+            chunks.push(char + ((_b = pattern[i + 1]) !== null && _b !== void 0 ? _b : ""));
+            i++;
+            continue;
+        }
+        else if ((char === "A" || char === "a") &&
+            pattern[i + 1] === "/" &&
+            (pattern[i + 2] === "P" || pattern[i + 2] === "p")) {
+            chunks.push("A/P");
+            found = true;
+            i += 2;
+            continue;
+        }
+        chunks.push(char);
+    }
+    if (!found)
+        return undefined;
+    try {
+        for (var localeChunks_1 = tslib_1.__values(localeChunks), localeChunks_1_1 = localeChunks_1.next(); !localeChunks_1_1.done; localeChunks_1_1 = localeChunks_1.next()) {
+            var index = localeChunks_1_1.value;
+            chunks[index] = "[".concat(shortAmPmLocaleToken(chunks[index]), "]");
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (localeChunks_1_1 && !localeChunks_1_1.done && (_a = localeChunks_1.return)) _a.call(localeChunks_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return chunks.join("");
+};
+exports.withShortAmPmMarker = withShortAmPmMarker;
+var shortAmPmPatternCache = new Map();
+var DEFAULT_SEPARATORS = { decimal: ".", group: "," };
+var separatorsFor = function (locale) {
+    var _a, _b;
+    if (!locale)
+        return DEFAULT_SEPARATORS;
+    var l10n = (0, numfmt_1.getLocale)(locale);
+    if (!l10n)
+        return DEFAULT_SEPARATORS;
+    return {
+        decimal: (_a = l10n.decimal) !== null && _a !== void 0 ? _a : ".",
+        group: (_b = l10n.group) !== null && _b !== void 0 ? _b : ",",
+    };
+};
 var ssfFormat = function (pattern, value, locale) {
     try {
+        var shortAmPm = shortAmPmPatternCache.get(pattern);
+        if (shortAmPm === undefined && !shortAmPmPatternCache.has(pattern)) {
+            shortAmPm = (0, exports.withShortAmPmMarker)(pattern);
+            shortAmPmPatternCache.set(pattern, shortAmPm);
+        }
+        var code = shortAmPm !== null && shortAmPm !== void 0 ? shortAmPm : pattern;
+        var patternLocale = localeForPattern(pattern, locale);
+        if (shortAmPm !== undefined && patternLocale) {
+            patternLocale = getShortAmPmLocale(patternLocale);
+        }
+        var options_1 = { locale: patternLocale };
+        if (typeof value === "number") {
+            // Excel decides rounding, `General`, huge magnitudes and conditional
+            // sections from the 15-significant-digit decimal, not the binary
+            // double (#546 U8 / U21).
+            var pre = (0, excel_number_format_1.excelNumberPrePass)(code, value, separatorsFor(locale), function (section, sectionValue) { return (0, numfmt_1.format)(section, sectionValue, options_1); });
+            if (pre.text !== undefined) {
+                return pre.text;
+            }
+            value = pre.value;
+        }
         var isNegativeElapsedTime = typeof value === "number" &&
             value < 0 &&
             isSingleSectionElapsedTimePattern(pattern);
-        var formatted = (0, numfmt_1.format)(pattern, isNegativeElapsedTime ? Math.abs(value) : value, { locale: localeForPattern(pattern, locale) });
+        var formatted = (0, numfmt_1.format)(code, isNegativeElapsedTime ? Math.abs(value) : value, options_1);
         return isNegativeElapsedTime ? "-".concat(formatted) : formatted;
     }
     catch (err) {

package/dist/cjs/index.d.ts

@@ -9,6 +9,7 @@ export * from "./locale";
 export * from "./date";
 export * from "./log";
 export * from "./array";
+export * from "./excel-number-format";
 export * from "./formatter";
 export * from "./memoize";
 export * from "./cell-data-helpers";
@@ -21,4 +22,6 @@ export * from "./conditional-format";
 export * from "./data-validation";
 export * from "./content-hash";
 export * from "./shared-string-canonical";
+export * from "./keyboard";
+export * from "./sheet-span";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,uBAAuB,CAAC;AACtC,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;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/cjs/index.js

@@ -12,6 +12,7 @@ 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("./excel-number-format"), exports);
 tslib_1.__exportStar(require("./formatter"), exports);
 tslib_1.__exportStar(require("./memoize"), exports);
 tslib_1.__exportStar(require("./cell-data-helpers"), exports);
@@ -24,3 +25,5 @@ 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);
+tslib_1.__exportStar(require("./keyboard"), exports);
+tslib_1.__exportStar(require("./sheet-span"), exports);

package/dist/cjs/keyboard.d.ts

@@ -0,0 +1,28 @@
+type HotkeyEventLike = {
+    key: string;
+    code?: string;
+};
+/**
+ * Map a physical key code (`KeyboardEvent.code`) to the character that key
+ * produces on a US layout: `KeyB` → `b`, `Digit1` → `1`, `Semicolon` → `;`.
+ * Returns undefined for codes that are not a letter, digit or punctuation key.
+ * @param code
+ * @returns
+ */
+export declare const hotkeyKeyFromCode: (code: string | undefined) => string | undefined;
+/**
+ * Layout-independent key to match keyboard shortcuts against.
+ *
+ * - A printable ASCII `event.key` wins, lowercased, so Dvorak/AZERTY users
+ *   keep the shortcut printed on their keys (Excel / Google Sheets parity)
+ *   and Shift no longer changes the letter (`Ctrl+Shift+X` → `x`).
+ * - When the layout produces a non-ASCII character (Cyrillic `и`, Greek `β`,
+ *   Hebrew, or a macOS Option dead character such as `†`), the character is
+ *   derived from the physical key instead: `event.code` `KeyB` → `b`.
+ * - Named keys (`Enter`, `Escape`, `F4`, `ArrowUp`, …) are returned as-is.
+ * @param event
+ * @returns
+ */
+export declare const getHotkeyKey: (event: HotkeyEventLike) => string;
+export {};
+//# sourceMappingURL=keyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../keyboard.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAqBF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,GAAG,SAAS,uBAWzD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,eAAe,WAYlD,CAAC"}

package/dist/cjs/keyboard.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHotkeyKey = exports.hotkeyKeyFromCode = void 0;
+var PUNCTUATION_BY_CODE = {
+    Backquote: "`",
+    Backslash: "\\",
+    BracketLeft: "[",
+    BracketRight: "]",
+    Comma: ",",
+    Equal: "=",
+    Minus: "-",
+    Period: ".",
+    Quote: "'",
+    Semicolon: ";",
+    Slash: "/",
+};
+var isPrintableAscii = function (key) {
+    var charCode = key.charCodeAt(0);
+    return charCode >= 0x20 && charCode <= 0x7e;
+};
+/**
+ * Map a physical key code (`KeyboardEvent.code`) to the character that key
+ * produces on a US layout: `KeyB` → `b`, `Digit1` → `1`, `Semicolon` → `;`.
+ * Returns undefined for codes that are not a letter, digit or punctuation key.
+ * @param code
+ * @returns
+ */
+var hotkeyKeyFromCode = function (code) {
+    if (!code) {
+        return undefined;
+    }
+    if (/^Key[A-Z]$/.test(code)) {
+        return code.charAt(3).toLowerCase();
+    }
+    if (/^Digit[0-9]$/.test(code)) {
+        return code.charAt(5);
+    }
+    return PUNCTUATION_BY_CODE[code];
+};
+exports.hotkeyKeyFromCode = hotkeyKeyFromCode;
+/**
+ * Layout-independent key to match keyboard shortcuts against.
+ *
+ * - A printable ASCII `event.key` wins, lowercased, so Dvorak/AZERTY users
+ *   keep the shortcut printed on their keys (Excel / Google Sheets parity)
+ *   and Shift no longer changes the letter (`Ctrl+Shift+X` → `x`).
+ * - When the layout produces a non-ASCII character (Cyrillic `и`, Greek `β`,
+ *   Hebrew, or a macOS Option dead character such as `†`), the character is
+ *   derived from the physical key instead: `event.code` `KeyB` → `b`.
+ * - Named keys (`Enter`, `Escape`, `F4`, `ArrowUp`, …) are returned as-is.
+ * @param event
+ * @returns
+ */
+var getHotkeyKey = function (event) {
+    var key = event.key, code = event.code;
+    if (key.length === 1) {
+        if (isPrintableAscii(key)) {
+            return key.toLowerCase();
+        }
+        var keyFromCode = (0, exports.hotkeyKeyFromCode)(code);
+        if (keyFromCode !== undefined) {
+            return keyFromCode;
+        }
+    }
+    return key;
+};
+exports.getHotkeyKey = getHotkeyKey;

package/dist/cjs/sheet-span.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Sheets covered by a 3-D reference span `first:last` (`Sheet1:Sheet3!A1`):
+ * every name between the two endpoints in tab order, inclusive. Excel spans
+ * the tabs between the endpoints whichever one is written first and matches
+ * sheet names case-insensitively. Returns undefined when an endpoint is not a
+ * sheet (the caller reports #REF!).
+ * @param sheetNames sheet names in tab order
+ * @param first
+ * @param last
+ * @returns
+ */
+export declare const resolveSheetSpan: (sheetNames: readonly string[], first: string, last: string) => string[] | undefined;
+//# sourceMappingURL=sheet-span.d.ts.map

package/dist/cjs/sheet-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-span.d.ts","sourceRoot":"","sources":["../../sheet-span.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAC3B,YAAY,SAAS,MAAM,EAAE,EAC7B,OAAO,MAAM,EACb,MAAM,MAAM,KACX,MAAM,EAAE,GAAG,SAQb,CAAC"}

package/dist/cjs/sheet-span.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSheetSpan = void 0;
+/**
+ * Sheets covered by a 3-D reference span `first:last` (`Sheet1:Sheet3!A1`):
+ * every name between the two endpoints in tab order, inclusive. Excel spans
+ * the tabs between the endpoints whichever one is written first and matches
+ * sheet names case-insensitively. Returns undefined when an endpoint is not a
+ * sheet (the caller reports #REF!).
+ * @param sheetNames sheet names in tab order
+ * @param first
+ * @param last
+ * @returns
+ */
+var resolveSheetSpan = function (sheetNames, first, last) {
+    var lower = sheetNames.map(function (name) { return name.toLowerCase(); });
+    var start = lower.indexOf(first.toLowerCase());
+    var end = lower.indexOf(last.toLowerCase());
+    if (start === -1 || end === -1) {
+        return undefined;
+    }
+    return sheetNames.slice(Math.min(start, end), Math.max(start, end) + 1);
+};
+exports.resolveSheetSpan = resolveSheetSpan;

package/dist/cjs/tsconfig.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../array.ts","../../cell-data-helpers.ts","../../color.ts","../../colors.ts","../../conditional-format.ts","../../content-hash.ts","../../data-validation.ts","../../date.ts","../../dom.ts","../../formatter.ts","../../formula-refs.ts","../../formula.ts","../../index.ts","../../locale.ts","../../log.ts","../../memoize.ts","../../numbers.ts","../../selection.ts","../../shared-string-canonical.ts","../../sort.ts","../../string.ts","../../table-styles.ts","../../typeguards.ts","../../uuid.ts","../../vitest.config.ts"],"version":"5.8.3"}
+{"root":["../../array.ts","../../cell-data-helpers.ts","../../color.ts","../../colors.ts","../../conditional-format.ts","../../content-hash.ts","../../data-validation.ts","../../date.ts","../../dom.ts","../../excel-number-format.ts","../../formatter.ts","../../formula-refs.ts","../../formula.ts","../../index.ts","../../keyboard.ts","../../locale.ts","../../log.ts","../../memoize.ts","../../numbers.ts","../../selection.ts","../../shared-string-canonical.ts","../../sheet-span.ts","../../sort.ts","../../string.ts","../../table-styles.ts","../../typeguards.ts","../../uuid.ts","../../vitest.config.ts"],"version":"5.8.3"}

package/dist/esm/excel-number-format.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Excel-parity pre-pass for number formatting.
+ *
+ * `numfmt` renders the bulk of Excel's format language, but it decides three
+ * things from the binary double where Excel decides them from the number's
+ * 15-significant-digit decimal representation:
+ *
+ *  - rounding to a fixed number of decimals (`0.00` of `1.005` is `1.01`, not
+ *    the `1.00` the double `1.00499999999999989…` rounds to);
+ *  - `General`, which switches to scientific notation below 1E-4 and above
+ *    11 digits and rounds (never truncates) the 11th digit;
+ *  - magnitudes ≥ 1E15, where Excel pads the 15 significant digits with
+ *    zeros (`0.00` of `1E21` is `1000000000000000000000.00`).
+ *
+ * It also renders a date/time format for a serial outside Excel's calendar
+ * (negative, or ≥ 10000-01-01) as `#######`, as Excel does in the cell.
+ *
+ * Everything here works on the pattern's SECTION the value selects, so
+ * multi-section formats (`0.00;(0.00);"-"`) keep their Excel section rules.
+ * A format with `[>100]`-style conditions is resolved here too — which
+ * section matches, and whether the value's sign is shown — so the matched
+ * section gets the same decimal rules; the library then renders that one
+ * section on its own.
+ */
+/**
+ * What Excel shows when a value cannot be rendered by its format: a
+ * date/time outside the calendar, or a number no conditional section takes.
+ */
+export declare const DATE_OVERFLOW_DISPLAY = "#######";
+export type FormatSectionKind = "general" | "empty" | "number" | "date" | "text" | "other";
+export type FormatConditionOperator = "<" | "<=" | ">" | ">=" | "=" | "<>";
+/** A `[>100]`-style section condition. */
+export interface FormatCondition {
+    op: FormatConditionOperator;
+    operand: number;
+}
+export interface FormatSectionInfo {
+    kind: FormatSectionKind;
+    /** The section body with color / locale / condition tokens removed. */
+    body: string;
+    /** `[>100]`-style condition on this section. */
+    hasCondition: boolean;
+    condition?: FormatCondition;
+    /** Elapsed-time token (`[h]`, `[mm]`, `[s]`) — negative values are legal. */
+    isElapsed: boolean;
+    /** Literal text before a `General` token (`-General` → `"-"`). */
+    generalPrefix: string;
+    /** Digit placeholders after the decimal point. */
+    decimals: number;
+    /** Number of `%` signs (each scales by 100). */
+    percent: number;
+    /** Trailing scaling commas (each divides by 1000). */
+    commaScale: number;
+    /** A grouping comma between digit placeholders. */
+    grouping: boolean;
+    /** Only placeholders / separators — safe to render without the library. */
+    isPlainNumber: boolean;
+    /**
+     * Digit placeholders outside a fraction: a `-` prefixed to this section is
+     * dropped when every digit it renders is zero (`0.00` of -0.001 → `0.00`).
+     */
+    volatileSign: boolean;
+}
+/**
+ * Split a format code into its `;` sections, honouring quotes, bracket
+ * tokens and backslash escapes.
+ */
+export declare const splitFormatSections: (code: string) => string[];
+/** Classify one section of a format code. */
+export declare const analyzeFormatSection: (section: string) => FormatSectionInfo;
+/**
+ * Which section Excel applies to a numeric value: one section covers every
+ * number; two sections split positive-or-zero / negative; three add a zero
+ * section. Returns the index and whether the section's sign is implicit.
+ */
+export declare const pickNumberSection: (sectionCount: number, value: number) => {
+    index: number;
+    implicitSign: boolean;
+};
+export interface ResolvedConditionalSection {
+    index: number;
+    /** The implicit `General` fallback Excel adds to a one-section conditional format. */
+    generated: boolean;
+    /** A negative value's rendering is prefixed with `-`. */
+    minus: boolean;
+}
+/**
+ * Excel's section selection for a format with `[>100]`-style conditions:
+ * the first of the (up to three) numeric sections whose condition holds —
+ * an unconditional section always holds — or `undefined` when none does.
+ * `conditions[i]` is section i's condition (or `undefined`).
+ */
+export declare const resolveConditionalSection: (conditions: readonly (FormatCondition | undefined)[], value: number) => ResolvedConditionalSection | undefined;
+/** Remove the `[>100]`-style condition tokens from one section. */
+export declare const stripConditionTokens: (section: string) => string;
+/**
+ * Round |x|·10^shift half away from zero to `decimals` places using its
+ * 15-significant-digit decimal representation, and return the rounded value
+ * scaled back (÷10^shift). Returns `x` unchanged when no digit is dropped.
+ */
+export declare const roundDecimal15: (x: number, decimals: number, shift?: number) => number;
+/** Excel `General` for a finite number, using `.`/`E` (caller localizes). */
+export declare const excelGeneral: (value: number) => string;
+/**
+ * Digits of |x| for |x| ≥ 1E15 as Excel shows them: the 15 significant
+ * digits followed by zeros (Excel stores nothing beyond 15 digits).
+ */
+export declare const hugeIntegerDigits: (x: number) => string;
+export declare const groupDigits: (digits: string, separator: string) => string;
+export interface ExcelPrePassResult {
+    /** A final rendering; the library is not consulted. */
+    text?: string;
+    /** The (possibly pre-rounded) value to hand to the library. */
+    value: number;
+}
+export interface ExcelPrePassLocale {
+    decimal: string;
+    group: string;
+}
+/** Renders one section of a format code with the formatting library. */
+export type RenderFormatSection = (code: string, value: number) => string;
+/**
+ * Apply Excel's decimal rules before handing a numeric value to `numfmt`.
+ * `render` formats one section of the pattern with the library; it is used
+ * when the pre-pass has to resolve a conditional format itself.
+ */
+export declare const excelNumberPrePass: (pattern: string, value: number, l10n: ExcelPrePassLocale, render: RenderFormatSection) => ExcelPrePassResult;
+//# sourceMappingURL=excel-number-format.d.ts.map

package/dist/esm/excel-number-format.d.ts.map

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