@rowsncolumns/utils 9.5.7 → 9.6.1

package/dist/cjs/cell-data-helpers.d.ts

@@ -39,11 +39,17 @@ export declare const getExtendedValueError: (extValue?: Record<string, any> | nu
  * state hooks' row auto-height so both agree on which cells wrap.
  */
 export declare const alignmentImpliesWrap: (align: HorizontalAlign | string | null | undefined) => boolean;
+/**
+ * Excel's vertical `justify` and `distributed` wrap the text too: the lines
+ * are spread over the cell height, so there must be lines to spread.
+ */
+export declare const verticalAlignmentImpliesWrap: (align: string | null | undefined) => boolean;
 /**
  * Whether a cell format wraps its text — explicit `wrapStrategy: "wrap"` or
- * an alignment that wraps implicitly ({@link alignmentImpliesWrap}).
+ * an alignment that wraps implicitly ({@link alignmentImpliesWrap},
+ * {@link verticalAlignmentImpliesWrap}).
  */
-export declare const cellFormatWrapsText: (format: Pick<CellFormat, "wrapStrategy" | "horizontalAlignment"> | null | undefined) => boolean;
+export declare const cellFormatWrapsText: (format: Pick<CellFormat, "wrapStrategy" | "horizontalAlignment" | "verticalAlignment"> | null | undefined) => boolean;
 export declare const resolveDefaultHorizontalAlignment: ({ errorValue, userEnteredValue, effectiveValue, dataValidation, }: {
     errorValue: unknown;
     userEnteredValue: Record<string, any> | null | undefined;

package/dist/cjs/cell-data-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cell-data-helpers.d.ts","sourceRoot":"","sources":["../../cell-data-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,QAAQ,EACxD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EACtD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,QAAQ,EACzD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EACvD,OAAO,CAAC,GAAG,IAAI,KACd,UAAU,GAAG,cAAc,GAAG,IAAI,GAAG,SAEvC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EACtD,OAAO,CAAC,GAAG,IAAI,KACd,MAAM,GAAG,SAAS,GAAG,IAEvB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAE1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,OAAO,GAAG,SAEZ,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,GAAG,GAAG,SAER,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KACjD,OAAyD,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QACI,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,qBAAqB,CAAC,GACxD,IAAI,GACJ,SAAS,KACZ,OAEgD,CAAC;AAEpD,eAAO,MAAM,iCAAiC,GAAI,mEAK/C;IACD,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD,cAAc,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1E,KAAG,eAAe,GAAG,SASrB,CAAC"}
+{"version":3,"file":"cell-data-helpers.d.ts","sourceRoot":"","sources":["../../cell-data-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,QAAQ,EACxD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EACtD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,QAAQ,EACzD,OAAO,CAAC,GAAG,IAAI,KACd,CAAC,CAAC,IAAI,CAER,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,QAAQ,EACvD,OAAO,CAAC,GAAG,IAAI,KACd,UAAU,GAAG,cAAc,GAAG,IAAI,GAAG,SAEvC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EACtD,OAAO,CAAC,GAAG,IAAI,KACd,MAAM,GAAG,SAAS,GAAG,IAEvB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAE1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,OAAO,GAAG,SAEZ,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,MAAM,GAAG,SAEX,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,KACpC,GAAG,GAAG,SAER,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KACjD,OAAyD,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAC/B,OAAyD,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QACI,IAAI,CACF,UAAU,EACV,cAAc,GAAG,qBAAqB,GAAG,mBAAmB,CAC7D,GACD,IAAI,GACJ,SAAS,KACZ,OAGsD,CAAC;AAE1D,eAAO,MAAM,iCAAiC,GAAI,mEAK/C;IACD,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD,cAAc,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1E,KAAG,eAAe,GAAG,SASrB,CAAC"}

package/dist/cjs/cell-data-helpers.js

@@ -6,7 +6,7 @@
  * Note: These functions use generic types to avoid circular dependencies
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveDefaultHorizontalAlignment = exports.cellFormatWrapsText = exports.alignmentImpliesWrap = exports.getExtendedValueError = exports.getExtendedValueFormula = exports.getExtendedValueBool = exports.getExtendedValueString = exports.getExtendedValueNumber = exports.getStyleId = exports.getCellFormattedValue = exports.getCellEffectiveFormat = exports.getCellUserEnteredFormat = exports.getCellEffectiveValue = exports.getCellUserEnteredValue = void 0;
+exports.resolveDefaultHorizontalAlignment = exports.cellFormatWrapsText = exports.verticalAlignmentImpliesWrap = exports.alignmentImpliesWrap = exports.getExtendedValueError = exports.getExtendedValueFormula = exports.getExtendedValueBool = exports.getExtendedValueString = exports.getExtendedValueNumber = exports.getStyleId = exports.getCellFormattedValue = exports.getCellEffectiveFormat = exports.getCellUserEnteredFormat = exports.getCellEffectiveValue = exports.getCellUserEnteredValue = void 0;
 var getCellUserEnteredValue = function (cell) {
     var _a;
     return (_a = cell === null || cell === void 0 ? void 0 : cell.ue) !== null && _a !== void 0 ? _a : cell === null || cell === void 0 ? void 0 : cell.userEnteredValue;
@@ -86,13 +86,21 @@ exports.getExtendedValueError = getExtendedValueError;
  */
 var alignmentImpliesWrap = function (align) { return align === "justify" || align === "distributed"; };
 exports.alignmentImpliesWrap = alignmentImpliesWrap;
+/**
+ * Excel's vertical `justify` and `distributed` wrap the text too: the lines
+ * are spread over the cell height, so there must be lines to spread.
+ */
+var verticalAlignmentImpliesWrap = function (align) { return align === "justify" || align === "distributed"; };
+exports.verticalAlignmentImpliesWrap = verticalAlignmentImpliesWrap;
 /**
  * Whether a cell format wraps its text — explicit `wrapStrategy: "wrap"` or
- * an alignment that wraps implicitly ({@link alignmentImpliesWrap}).
+ * an alignment that wraps implicitly ({@link alignmentImpliesWrap},
+ * {@link verticalAlignmentImpliesWrap}).
  */
 var cellFormatWrapsText = function (format) {
     return (format === null || format === void 0 ? void 0 : format.wrapStrategy) === "wrap" ||
-        (0, exports.alignmentImpliesWrap)(format === null || format === void 0 ? void 0 : format.horizontalAlignment);
+        (0, exports.alignmentImpliesWrap)(format === null || format === void 0 ? void 0 : format.horizontalAlignment) ||
+        (0, exports.verticalAlignmentImpliesWrap)(format === null || format === void 0 ? void 0 : format.verticalAlignment);
 };
 exports.cellFormatWrapsText = cellFormatWrapsText;
 var resolveDefaultHorizontalAlignment = function (_a) {

package/dist/cjs/cjk-number-format.d.ts

@@ -0,0 +1,11 @@
+export type CjkLang = "ja" | "zh-Hans" | "zh-Hant" | "ko";
+export interface CjkPreparedFormat {
+    /** The rewritten code for the base formatter. */
+    code: string;
+    /** Converts the rendered text's digits into the `[DBNumN]` numeral system, if any. */
+    finish: (out: string) => string;
+}
+export declare const prepareCjkNumberFormat: (code: string, value: number, workbookLocale?: string) => CjkPreparedFormat | undefined;
+/** Language of an LCID (hex, low 16 bits) or a BCP-47 tag, for the CJK locales. */
+export declare const cjkLangOfTag: (input: string) => CjkLang | undefined;
+//# sourceMappingURL=cjk-number-format.d.ts.map

package/dist/cjs/cjk-number-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cjk-number-format.d.ts","sourceRoot":"","sources":["../../cjk-number-format.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;AAS1D,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAgBD,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,iBAAiB,MAAM,KACtB,iBAAiB,GAAG,SAsEtB,CAAC;AAqLF,mFAAmF;AACnF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAAO,GAAG,SA8BtD,CAAC"}

package/dist/cjs/cjk-number-format.js

@@ -0,0 +1,533 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cjkLangOfTag = exports.prepareCjkNumberFormat = void 0;
+var tslib_1 = require("tslib");
+/**
+ * East Asian number-format tokens `numfmt` does not render: the `[DBNum1]`–`[DBNum4]` numeral
+ * systems, the Japanese emperor-era tokens (`g`/`gg`/`ggg`, and `e`/`ee` under a Japanese locale)
+ * and the `aaa`/`aaaa` weekday tokens. TypeScript twin of the engine's Rust
+ * `rnc-cellmodel/src/cjk_format.rs` — keep the two in step.
+ *
+ * {@link prepareCjkNumberFormat} rewrites a format code so the base formatter can render it (era
+ * names, era years and weekday names become quoted literals computed from the date serial,
+ * `[DBNumN]` is removed, and under `[DBNumN]` a date's year becomes a quoted literal in that numeral
+ * system); `finish` then turns the remaining ASCII digits into the numeral system:
+ *
+ * - `General` and date fields read as a number with units (`123` → `百二十三`, `15日` → `十五日`);
+ * - digit placeholders (`0`, `#`) and years read digit by digit (`[DBNum1]0` → `一二三`).
+ *
+ * The language comes from the code's `[$-LCID]` / `[$-tag]` token, then the workbook locale, and
+ * defaults to Japanese.
+ */
+var excel_number_format_1 = require("./excel-number-format");
+var DBNUM_TOKEN = /^\[dbnum([1-4])\]$/i;
+/** Cheap pre-filter: a `DBNum` token, a `g` (era name or `General`), `aaa`, or an `e` beside a locale token. */
+var mightContainTokens = function (code) {
+    return /[gG]|dbnum|aaa/i.test(code) || (/[eE]/.test(code) && code.includes("[$"));
+};
+var prepareCjkNumberFormat = function (code, value, workbookLocale) {
+    var e_1, _a;
+    var _b;
+    if (!mightContainTokens(code))
+        return undefined;
+    var tag = localeTag(code);
+    var tagLang = tag ? (0, exports.cjkLangOfTag)(tag) : undefined;
+    var lang = (_b = tagLang !== null && tagLang !== void 0 ? tagLang : (workbookLocale ? (0, exports.cjkLangOfTag)(workbookLocale) : undefined)) !== null && _b !== void 0 ? _b : "ja";
+    var gannen = !!tag && tag.toLowerCase().includes("-x-gannen");
+    var date = serialToDate(value);
+    var sections = (0, excel_number_format_1.splitFormatSections)(code);
+    var rewritten = [];
+    var levels = [];
+    var dated = [];
+    var changed = false;
+    try {
+        for (var sections_1 = tslib_1.__values(sections), sections_1_1 = sections_1.next(); !sections_1_1.done; sections_1_1 = sections_1.next()) {
+            var section = sections_1_1.value;
+            var level_1 = dbnumLevel(section);
+            var result = rewriteSection(section, {
+                dbnum: level_1 === undefined ? undefined : { level: level_1, lang: lang },
+                weekdayLang: lang,
+                eraYears: tagLang === "ja" || hasEraNameToken(section),
+                gannen: gannen,
+                date: date,
+            });
+            changed || (changed = result.changed || level_1 !== undefined);
+            rewritten.push(result.text);
+            levels.push(level_1);
+            dated.push(result.dateToken);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (sections_1_1 && !sections_1_1.done && (_a = sections_1.return)) _a.call(sections_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    if (!changed)
+        return undefined;
+    var anyCondition = sections.some(function (s) { return (0, excel_number_format_1.analyzeFormatSection)(s).hasCondition; });
+    var index = anyCondition
+        ? 0
+        : Math.min((0, excel_number_format_1.pickNumberSection)(sections.length, value).index, sections.length - 1);
+    var level = levels[index];
+    var dbnum = level !== undefined && (level <= 3 || (level === 4 && lang === "ko"))
+        ? { level: level, lang: lang }
+        : undefined;
+    var mode;
+    if (dated[index]) {
+        mode = "date";
+    }
+    else {
+        switch ((0, excel_number_format_1.analyzeFormatSection)(stripDbNum(sections[index])).kind) {
+            case "general":
+                mode = "general";
+                break;
+            case "date":
+                mode = "date";
+                break;
+            case "number":
+            case "other":
+                mode = "digits";
+                break;
+            default:
+                mode = "unchanged";
+        }
+    }
+    return {
+        code: rewritten.join(";"),
+        finish: function (out) {
+            return dbnum && mode !== "unchanged" ? convertDigits(out, dbnum, mode) : out;
+        },
+    };
+};
+exports.prepareCjkNumberFormat = prepareCjkNumberFormat;
+var runLength = function (chars, from, letter) {
+    var n = 0;
+    while (from + n < chars.length && chars[from + n].toLowerCase() === letter)
+        n += 1;
+    return n;
+};
+var startsWithCi = function (chars, from, word) {
+    return chars
+        .slice(from, from + word.length)
+        .join("")
+        .toLowerCase() === word;
+};
+var quote = function (text) { return "\"".concat(text, "\""); };
+var rewriteSection = function (section, ctx) {
+    var chars = Array.from(section);
+    var out = "";
+    var changed = false;
+    var dateToken = false;
+    var i = 0;
+    while (i < chars.length) {
+        var c = chars[i];
+        var lower = c.toLowerCase();
+        if (c === '"') {
+            var close_1 = chars.indexOf('"', i + 1);
+            var end = close_1 === -1 ? chars.length : close_1 + 1;
+            out += chars.slice(i, end).join("");
+            i = end;
+        }
+        else if (c === "\\" || c === "_" || c === "*") {
+            out += chars.slice(i, i + 2).join("");
+            i += 2;
+        }
+        else if (c === "[") {
+            var close_2 = chars.indexOf("]", i);
+            var end = close_2 === -1 ? chars.length : close_2 + 1;
+            var token = chars.slice(i, end).join("");
+            if (DBNUM_TOKEN.test(token))
+                changed = true;
+            else
+                out += token;
+            i = end;
+        }
+        else if (lower === "g" && startsWithCi(chars, i, "general")) {
+            out += chars.slice(i, i + 7).join("");
+            i += 7;
+        }
+        else if (lower === "g") {
+            var run = runLength(chars, i, "g");
+            if (ctx.date) {
+                var era = eraOf(ctx.date);
+                out += quote(run === 1 ? era.letter : run === 2 ? era.short : era.name);
+            }
+            changed = true;
+            dateToken = true;
+            i += run;
+        }
+        else if (lower === "e" && chars[i + 1] !== "+" && chars[i + 1] !== "-") {
+            var run = runLength(chars, i, "e");
+            if (ctx.date && ctx.eraYears) {
+                var eraYear = ctx.date.year - eraOf(ctx.date).start[0] + 1;
+                var text = eraYear === 1 && ctx.gannen
+                    ? "元"
+                    : run >= 2
+                        ? String(eraYear).padStart(2, "0")
+                        : String(eraYear);
+                out += quote(text);
+                changed = true;
+                dateToken = true;
+            }
+            else if (ctx.date && ctx.dbnum) {
+                out += quote(perDigit(String(ctx.date.year), ctx.dbnum));
+                changed = true;
+                dateToken = true;
+            }
+            else {
+                out += chars.slice(i, i + run).join("");
+            }
+            i += run;
+        }
+        else if (lower === "a" && startsWithCi(chars, i, "am/pm")) {
+            out += chars.slice(i, i + 5).join("");
+            i += 5;
+        }
+        else if (lower === "a" && startsWithCi(chars, i, "a/p")) {
+            out += chars.slice(i, i + 3).join("");
+            i += 3;
+        }
+        else if (lower === "a" && runLength(chars, i, "a") >= 3) {
+            var run = runLength(chars, i, "a");
+            if (ctx.date)
+                out += quote(weekdayName(ctx.weekdayLang, ctx.date.weekday, run >= 4));
+            changed = true;
+            dateToken = true;
+            i += run;
+        }
+        else if (lower === "y" && ctx.dbnum && ctx.date) {
+            var run = runLength(chars, i, "y");
+            var digits = run <= 2
+                ? String(ctx.date.year % 100).padStart(2, "0")
+                : String(ctx.date.year);
+            out += quote(perDigit(digits, ctx.dbnum));
+            changed = true;
+            dateToken = true;
+            i += run;
+        }
+        else {
+            out += c;
+            i += 1;
+        }
+    }
+    return { text: out, changed: changed, dateToken: dateToken };
+};
+/** `[...]` tokens outside quoted literals and escapes. */
+var bracketTokens = function (section) {
+    var tokens = [];
+    var inQuotes = false;
+    for (var i = 0; i < section.length; i += 1) {
+        var c = section[i];
+        if (c === '"')
+            inQuotes = !inQuotes;
+        else if (!inQuotes && (c === "\\" || c === "_" || c === "*"))
+            i += 1;
+        else if (!inQuotes && c === "[") {
+            var end = section.indexOf("]", i);
+            if (end !== -1) {
+                tokens.push(section.slice(i, end + 1));
+                i = end;
+            }
+        }
+    }
+    return tokens;
+};
+var dbnumLevel = function (section) {
+    var e_2, _a;
+    try {
+        for (var _b = tslib_1.__values(bracketTokens(section)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var token = _c.value;
+            var m = DBNUM_TOKEN.exec(token);
+            if (m)
+                return Number(m[1]);
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return undefined;
+};
+var stripDbNum = function (section) {
+    return bracketTokens(section)
+        .filter(function (t) { return DBNUM_TOKEN.test(t); })
+        .reduce(function (s, t) { return s.replace(t, ""); }, section);
+};
+/** Whether a section names an era (`g`) outside quotes, brackets and `General`. */
+var hasEraNameToken = function (section) {
+    var inQuotes = false;
+    var inBrackets = false;
+    for (var i = 0; i < section.length; i += 1) {
+        var c = section[i];
+        if (inQuotes)
+            inQuotes = c !== '"';
+        else if (inBrackets)
+            inBrackets = c !== "]";
+        else if (c === '"')
+            inQuotes = true;
+        else if (c === "[")
+            inBrackets = true;
+        else if (c === "\\" || c === "_" || c === "*")
+            i += 1;
+        else if (c.toLowerCase() === "g") {
+            if (section.slice(i, i + 7).toLowerCase() === "general")
+                i += 6;
+            else
+                return true;
+        }
+    }
+    return false;
+};
+/** The locale spec of the code's first `[$…-spec]` token (`411`, `ja-JP`, `ja-JP-x-gannen`). */
+var localeTag = function (code) {
+    var start = code.indexOf("[$");
+    if (start === -1)
+        return undefined;
+    var end = code.indexOf("]", start);
+    if (end === -1)
+        return undefined;
+    var inner = code.slice(start + 2, end);
+    var dash = inner.indexOf("-");
+    if (dash === -1)
+        return undefined;
+    var spec = inner.slice(dash + 1);
+    return spec || undefined;
+};
+/** Language of an LCID (hex, low 16 bits) or a BCP-47 tag, for the CJK locales. */
+var cjkLangOfTag = function (input) {
+    var spec = input.split(",")[0].trim();
+    if (/^[0-9a-f]+$/i.test(spec)) {
+        switch (parseInt(spec, 16) & 0xffff) {
+            case 0x0411:
+                return "ja";
+            case 0x0804:
+            case 0x1004:
+                return "zh-Hans";
+            case 0x0404:
+            case 0x0c04:
+            case 0x1404:
+                return "zh-Hant";
+            case 0x0412:
+                return "ko";
+            default:
+                return undefined;
+        }
+    }
+    var _a = tslib_1.__read(spec.toLowerCase().split(/[-_]/)), primary = _a[0], rest = _a.slice(1);
+    if (primary === "ja")
+        return "ja";
+    if (primary === "ko")
+        return "ko";
+    if (primary === "zh") {
+        return rest.some(function (p) { return p === "hant" || p === "tw" || p === "hk" || p === "mo"; })
+            ? "zh-Hant"
+            : "zh-Hans";
+    }
+    return undefined;
+};
+exports.cjkLangOfTag = cjkLangOfTag;
+// ---- dates ------------------------------------------------------------------------------------
+/**
+ * Excel 1900-system serial → calendar date, keeping Excel's fictitious 1900-02-29 (serial 60)
+ * and its weekday numbering (serial 1 is a Sunday). The time of day rounds to the nearest second.
+ */
+var serialToDate = function (value) {
+    if (!Number.isFinite(value) || value < 0 || value >= 2958466)
+        return undefined;
+    var days = Math.floor(Math.round(value * 86400) / 86400);
+    var weekday = (days + 6) % 7;
+    if (days === 60)
+        return { year: 1900, month: 2, day: 29, weekday: weekday };
+    var offset = days < 60 ? days : days - 1;
+    var d = new Date(Date.UTC(1899, 11, 31) + offset * 86400000);
+    return {
+        year: d.getUTCFullYear(),
+        month: d.getUTCMonth() + 1,
+        day: d.getUTCDate(),
+        weekday: weekday,
+    };
+};
+/** Japanese eras with the start dates Windows' Japanese calendar (and so Excel) uses. */
+var ERAS = [
+    { start: [1868, 1, 1], letter: "M", short: "明", name: "明治" },
+    { start: [1912, 7, 30], letter: "T", short: "大", name: "大正" },
+    { start: [1926, 12, 25], letter: "S", short: "昭", name: "昭和" },
+    { start: [1989, 1, 8], letter: "H", short: "平", name: "平成" },
+    { start: [2019, 5, 1], letter: "R", short: "令", name: "令和" },
+];
+var eraOf = function (date) {
+    var key = date.year * 10000 + date.month * 100 + date.day;
+    for (var i = ERAS.length - 1; i >= 0; i -= 1) {
+        var _a = tslib_1.__read(ERAS[i].start, 3), y = _a[0], m = _a[1], d = _a[2];
+        if (key >= y * 10000 + m * 100 + d)
+            return ERAS[i];
+    }
+    return ERAS[0];
+};
+var weekdayName = function (lang, weekday, long) {
+    var w = weekday % 7;
+    switch (lang) {
+        case "ja": {
+            var short = "日月火水木金土"[w];
+            return long ? "".concat(short, "\u66DC\u65E5") : short;
+        }
+        case "ko": {
+            var short = "일월화수목금토"[w];
+            return long ? "".concat(short, "\uC694\uC77C") : short;
+        }
+        default: {
+            var short = "日一二三四五六"[w];
+            return long ? "\u661F\u671F".concat(short) : short;
+        }
+    }
+};
+var KANJI = Array.from("〇一二三四五六七八九");
+var FULL_WIDTH = Array.from("０１２３４５６７８９");
+var BIG_HANS = ["万", "亿", "兆"];
+var BIG_TRAD = ["萬", "億", "兆"];
+var BIG_JA = ["万", "億", "兆"];
+var numerals = function (_a) {
+    var level = _a.level, lang = _a.lang;
+    var zh = lang === "zh-Hans" || lang === "zh-Hant";
+    var level1Big = lang === "ja" ? BIG_JA : lang === "zh-Hans" ? BIG_HANS : BIG_TRAD;
+    if (level === 2) {
+        switch (lang) {
+            case "ja":
+                return {
+                    digits: Array.from("〇壱弐参四伍六七八九"),
+                    small: ["拾", "百", "阡"],
+                    big: BIG_TRAD,
+                    omitOne: false,
+                    fillZero: false,
+                };
+            case "zh-Hans":
+                return {
+                    digits: Array.from("零壹贰叁肆伍陆柒捌玖"),
+                    small: ["拾", "佰", "仟"],
+                    big: BIG_HANS,
+                    omitOne: false,
+                    fillZero: true,
+                };
+            case "zh-Hant":
+                return {
+                    digits: Array.from("零壹貳參肆伍陸柒捌玖"),
+                    small: ["拾", "佰", "仟"],
+                    big: BIG_TRAD,
+                    omitOne: false,
+                    fillZero: true,
+                };
+            case "ko":
+                return {
+                    digits: Array.from("零壹貳參四伍六七八九"),
+                    small: ["拾", "百", "阡"],
+                    big: BIG_TRAD,
+                    omitOne: false,
+                    fillZero: false,
+                };
+        }
+    }
+    if (level === 3) {
+        return {
+            digits: FULL_WIDTH,
+            small: ["十", "百", "千"],
+            big: level1Big,
+            omitOne: false,
+            fillZero: zh,
+        };
+    }
+    if (level === 4 && lang === "ko") {
+        return {
+            digits: Array.from("영일이삼사오육칠팔구"),
+            small: ["십", "백", "천"],
+            big: ["만", "억", "조"],
+            omitOne: true,
+            fillZero: false,
+        };
+    }
+    return {
+        digits: KANJI,
+        small: ["十", "百", "千"],
+        big: level1Big,
+        omitOne: !zh,
+        fillZero: zh,
+    };
+};
+var perDigit = function (digits, dbnum) {
+    var table = numerals(dbnum).digits;
+    return Array.from(digits)
+        .map(function (c) { return (c >= "0" && c <= "9" ? table[Number(c)] : c); })
+        .join("");
+};
+/** `digits` read as a number with units; past 兆 (≥ 10^16) digit by digit. */
+var withUnits = function (digits, dbnum) {
+    var n = numerals(dbnum);
+    var trimmed = digits.replace(/^0+/, "");
+    if (!trimmed)
+        return n.digits[0];
+    if (trimmed.length > 16)
+        return perDigit(digits, dbnum);
+    var values = Array.from(trimmed, Number);
+    var groups = Math.ceil(values.length / 4);
+    var out = "";
+    var pendingZero = false;
+    var _loop_1 = function (g) {
+        var groupIndex = groups - 1 - g;
+        var end = values.length - groupIndex * 4;
+        var group = values.slice(Math.max(0, end - 4), end);
+        var wrote = false;
+        group.forEach(function (d, k) {
+            var pos = group.length - 1 - k;
+            if (d === 0) {
+                pendingZero || (pendingZero = out.length > 0 || wrote);
+                return;
+            }
+            if (pendingZero && n.fillZero)
+                out += "零";
+            pendingZero = false;
+            if (!(d === 1 && pos > 0 && n.omitOne))
+                out += n.digits[d];
+            if (pos > 0)
+                out += n.small[pos - 1];
+            wrote = true;
+        });
+        if (wrote && groupIndex > 0)
+            out += n.big[groupIndex - 1];
+    };
+    for (var g = 0; g < groups; g += 1) {
+        _loop_1(g);
+    }
+    return out;
+};
+var isAsciiDigit = function (c) { return !!c && c >= "0" && c <= "9"; };
+var convertDigits = function (text, dbnum, mode) {
+    var chars = Array.from(text);
+    var out = "";
+    var i = 0;
+    while (i < chars.length) {
+        if (!isAsciiDigit(chars[i])) {
+            out += chars[i];
+            i += 1;
+            continue;
+        }
+        var end = i;
+        while (end < chars.length && isAsciiDigit(chars[end]))
+            end += 1;
+        var run = chars.slice(i, end).join("");
+        var fraction = i >= 2 &&
+            (chars[i - 1] === "." || chars[i - 1] === ",") &&
+            isAsciiDigit(chars[i - 2]);
+        var units = mode === "date"
+            ? dbnum.level !== 3
+            : mode === "general"
+                ? !fraction
+                : false;
+        out += units ? withUnits(run, dbnum) : perDigit(run, dbnum);
+        i = end;
+    }
+    return out;
+};

package/dist/cjs/color.d.ts

@@ -10,6 +10,15 @@ export declare const rgbaToArgbHex: ({ r, g, b, a }: RGBA) => string;
 export declare const isSameColor: (colorA: string | undefined, colorB: string | undefined) => boolean | undefined;
 export declare const colorStringToHex: (color: string | undefined) => string | undefined;
 export declare const lightenColor: (unit: number | undefined, color: string) => string | undefined;
+/**
+ * Excel's tint (ECMA-376 Part 1, §18.8.19 `CT_Color@tint`) — what a `{ theme, tint }` colour paints
+ * as. Unlike `lightenColor`, which blends each channel toward black or white, the colour moves to
+ * HLS and only its luminance changes: `L·(1+tint)` for a negative tint, `L·(1−tint) + tint` for a
+ * positive one. Hue and saturation stay, so accent1 `#4472C4` at −25 % is Excel's `#2F5597` (not
+ * `#335693`) and accent2 `#ED7D31` at −25 % is `#C55A11`. The engine's `rnc_model::apply_tint`
+ * is the same rule. Returns `#rrggbb` (as `rgbToHex`); `undefined` for a colour it cannot read.
+ */
+export declare const applyTint: (tint: number, color: string) => string | undefined;
 export declare const hexToRgb: (hex: string) => {
     r: number;
     g: number;

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

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../color.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,WAoCnD,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAYnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkBzD;AAED,eAAO,MAAM,aAAa,GAAI,gBAAoB,IAAI,WAUrD,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,MAAM,GAAG,SAAS,wBAiB3B,CAAC;AAQF,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,uBAczD,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,wBAAU,EAAE,OAAO,MAAM,uBAGrD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM;;;;CAOnC,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,WAGvD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAUA,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,MAUF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,SAAS,MAAM,EAAE,EAC1B,OAAO,MAAM,KACZ,MAMF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAAM,EAInE,CAAC;AAEJ,eAAO,MAAM,gBAAgB,GAC3B,iBAAiB,MAAM,EACvB,YAAY,MAAM,EAClB,WAAW,MAAM,uBAUlB,CAAC"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../color.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,WAoCnD,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAYnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkBzD;AAED,eAAO,MAAM,aAAa,GAAI,gBAAoB,IAAI,WAUrD,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,MAAM,GAAG,SAAS,wBAiB3B,CAAC;AAQF,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,uBAczD,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,wBAAU,EAAE,OAAO,MAAM,uBAGrD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,MAAM,GAAG,SAYhE,CAAC;AA8BF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM;;;;CAOnC,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,WAGvD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAUA,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,MAUF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,SAAS,MAAM,EAAE,EAC1B,OAAO,MAAM,KACZ,MAMF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAAM,EAInE,CAAC;AAEJ,eAAO,MAAM,gBAAgB,GAC3B,iBAAiB,MAAM,EACvB,YAAY,MAAM,EAClB,WAAW,MAAM,uBAUlB,CAAC"}