@rowsncolumns/utils 9.5.7 → 9.6.1

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

@@ -0,0 +1,494 @@
+/**
+ * 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.
+ */
+import { analyzeFormatSection, pickNumberSection, splitFormatSections, } from "./excel-number-format";
+const 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. */
+const mightContainTokens = (code) => /[gG]|dbnum|aaa/i.test(code) || (/[eE]/.test(code) && code.includes("[$"));
+export const prepareCjkNumberFormat = (code, value, workbookLocale) => {
+    if (!mightContainTokens(code))
+        return undefined;
+    const tag = localeTag(code);
+    const tagLang = tag ? cjkLangOfTag(tag) : undefined;
+    const lang = tagLang ??
+        (workbookLocale ? cjkLangOfTag(workbookLocale) : undefined) ??
+        "ja";
+    const gannen = !!tag && tag.toLowerCase().includes("-x-gannen");
+    const date = serialToDate(value);
+    const sections = splitFormatSections(code);
+    const rewritten = [];
+    const levels = [];
+    const dated = [];
+    let changed = false;
+    for (const section of sections) {
+        const level = dbnumLevel(section);
+        const result = rewriteSection(section, {
+            dbnum: level === undefined ? undefined : { level, lang },
+            weekdayLang: lang,
+            eraYears: tagLang === "ja" || hasEraNameToken(section),
+            gannen,
+            date,
+        });
+        changed ||= result.changed || level !== undefined;
+        rewritten.push(result.text);
+        levels.push(level);
+        dated.push(result.dateToken);
+    }
+    if (!changed)
+        return undefined;
+    const anyCondition = sections.some((s) => analyzeFormatSection(s).hasCondition);
+    const index = anyCondition
+        ? 0
+        : Math.min(pickNumberSection(sections.length, value).index, sections.length - 1);
+    const level = levels[index];
+    const dbnum = level !== undefined && (level <= 3 || (level === 4 && lang === "ko"))
+        ? { level, lang }
+        : undefined;
+    let mode;
+    if (dated[index]) {
+        mode = "date";
+    }
+    else {
+        switch (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: (out) => dbnum && mode !== "unchanged" ? convertDigits(out, dbnum, mode) : out,
+    };
+};
+const runLength = (chars, from, letter) => {
+    let n = 0;
+    while (from + n < chars.length && chars[from + n].toLowerCase() === letter)
+        n += 1;
+    return n;
+};
+const startsWithCi = (chars, from, word) => chars
+    .slice(from, from + word.length)
+    .join("")
+    .toLowerCase() === word;
+const quote = (text) => `"${text}"`;
+const rewriteSection = (section, ctx) => {
+    const chars = Array.from(section);
+    let out = "";
+    let changed = false;
+    let dateToken = false;
+    let i = 0;
+    while (i < chars.length) {
+        const c = chars[i];
+        const lower = c.toLowerCase();
+        if (c === '"') {
+            const close = chars.indexOf('"', i + 1);
+            const end = close === -1 ? chars.length : close + 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 === "[") {
+            const close = chars.indexOf("]", i);
+            const end = close === -1 ? chars.length : close + 1;
+            const 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") {
+            const run = runLength(chars, i, "g");
+            if (ctx.date) {
+                const 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] !== "-") {
+            const run = runLength(chars, i, "e");
+            if (ctx.date && ctx.eraYears) {
+                const eraYear = ctx.date.year - eraOf(ctx.date).start[0] + 1;
+                const 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) {
+            const 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) {
+            const run = runLength(chars, i, "y");
+            const 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, dateToken };
+};
+/** `[...]` tokens outside quoted literals and escapes. */
+const bracketTokens = (section) => {
+    const tokens = [];
+    let inQuotes = false;
+    for (let i = 0; i < section.length; i += 1) {
+        const c = section[i];
+        if (c === '"')
+            inQuotes = !inQuotes;
+        else if (!inQuotes && (c === "\\" || c === "_" || c === "*"))
+            i += 1;
+        else if (!inQuotes && c === "[") {
+            const end = section.indexOf("]", i);
+            if (end !== -1) {
+                tokens.push(section.slice(i, end + 1));
+                i = end;
+            }
+        }
+    }
+    return tokens;
+};
+const dbnumLevel = (section) => {
+    for (const token of bracketTokens(section)) {
+        const m = DBNUM_TOKEN.exec(token);
+        if (m)
+            return Number(m[1]);
+    }
+    return undefined;
+};
+const stripDbNum = (section) => bracketTokens(section)
+    .filter((t) => DBNUM_TOKEN.test(t))
+    .reduce((s, t) => s.replace(t, ""), section);
+/** Whether a section names an era (`g`) outside quotes, brackets and `General`. */
+const hasEraNameToken = (section) => {
+    let inQuotes = false;
+    let inBrackets = false;
+    for (let i = 0; i < section.length; i += 1) {
+        const 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`). */
+const localeTag = (code) => {
+    const start = code.indexOf("[$");
+    if (start === -1)
+        return undefined;
+    const end = code.indexOf("]", start);
+    if (end === -1)
+        return undefined;
+    const inner = code.slice(start + 2, end);
+    const dash = inner.indexOf("-");
+    if (dash === -1)
+        return undefined;
+    const 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. */
+export const cjkLangOfTag = (input) => {
+    const 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;
+        }
+    }
+    const [primary, ...rest] = spec.toLowerCase().split(/[-_]/);
+    if (primary === "ja")
+        return "ja";
+    if (primary === "ko")
+        return "ko";
+    if (primary === "zh") {
+        return rest.some((p) => p === "hant" || p === "tw" || p === "hk" || p === "mo")
+            ? "zh-Hant"
+            : "zh-Hans";
+    }
+    return undefined;
+};
+// ---- 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.
+ */
+const serialToDate = (value) => {
+    if (!Number.isFinite(value) || value < 0 || value >= 2958466)
+        return undefined;
+    const days = Math.floor(Math.round(value * 86400) / 86400);
+    const weekday = (days + 6) % 7;
+    if (days === 60)
+        return { year: 1900, month: 2, day: 29, weekday };
+    const offset = days < 60 ? days : days - 1;
+    const d = new Date(Date.UTC(1899, 11, 31) + offset * 86400000);
+    return {
+        year: d.getUTCFullYear(),
+        month: d.getUTCMonth() + 1,
+        day: d.getUTCDate(),
+        weekday,
+    };
+};
+/** Japanese eras with the start dates Windows' Japanese calendar (and so Excel) uses. */
+const 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: "令和" },
+];
+const eraOf = (date) => {
+    const key = date.year * 10000 + date.month * 100 + date.day;
+    for (let i = ERAS.length - 1; i >= 0; i -= 1) {
+        const [y, m, d] = ERAS[i].start;
+        if (key >= y * 10000 + m * 100 + d)
+            return ERAS[i];
+    }
+    return ERAS[0];
+};
+const weekdayName = (lang, weekday, long) => {
+    const w = weekday % 7;
+    switch (lang) {
+        case "ja": {
+            const short = "日月火水木金土"[w];
+            return long ? `${short}曜日` : short;
+        }
+        case "ko": {
+            const short = "일월화수목금토"[w];
+            return long ? `${short}요일` : short;
+        }
+        default: {
+            const short = "日一二三四五六"[w];
+            return long ? `星期${short}` : short;
+        }
+    }
+};
+const KANJI = Array.from("〇一二三四五六七八九");
+const FULL_WIDTH = Array.from("０１２３４５６７８９");
+const BIG_HANS = ["万", "亿", "兆"];
+const BIG_TRAD = ["萬", "億", "兆"];
+const BIG_JA = ["万", "億", "兆"];
+const numerals = ({ level, lang }) => {
+    const zh = lang === "zh-Hans" || lang === "zh-Hant";
+    const 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,
+    };
+};
+const perDigit = (digits, dbnum) => {
+    const table = numerals(dbnum).digits;
+    return Array.from(digits)
+        .map((c) => (c >= "0" && c <= "9" ? table[Number(c)] : c))
+        .join("");
+};
+/** `digits` read as a number with units; past 兆 (≥ 10^16) digit by digit. */
+const withUnits = (digits, dbnum) => {
+    const n = numerals(dbnum);
+    const trimmed = digits.replace(/^0+/, "");
+    if (!trimmed)
+        return n.digits[0];
+    if (trimmed.length > 16)
+        return perDigit(digits, dbnum);
+    const values = Array.from(trimmed, Number);
+    const groups = Math.ceil(values.length / 4);
+    let out = "";
+    let pendingZero = false;
+    for (let g = 0; g < groups; g += 1) {
+        const groupIndex = groups - 1 - g;
+        const end = values.length - groupIndex * 4;
+        const group = values.slice(Math.max(0, end - 4), end);
+        let wrote = false;
+        group.forEach((d, k) => {
+            const pos = group.length - 1 - k;
+            if (d === 0) {
+                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];
+    }
+    return out;
+};
+const isAsciiDigit = (c) => !!c && c >= "0" && c <= "9";
+const convertDigits = (text, dbnum, mode) => {
+    const chars = Array.from(text);
+    let out = "";
+    let i = 0;
+    while (i < chars.length) {
+        if (!isAsciiDigit(chars[i])) {
+            out += chars[i];
+            i += 1;
+            continue;
+        }
+        let end = i;
+        while (end < chars.length && isAsciiDigit(chars[end]))
+            end += 1;
+        const run = chars.slice(i, end).join("");
+        const fraction = i >= 2 &&
+            (chars[i - 1] === "." || chars[i - 1] === ",") &&
+            isAsciiDigit(chars[i - 2]);
+        const units = mode === "date"
+            ? dbnum.level !== 3
+            : mode === "general"
+                ? !fraction
+                : false;
+        out += units ? withUnits(run, dbnum) : perDigit(run, dbnum);
+        i = end;
+    }
+    return out;
+};

package/dist/esm/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/esm/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"}

package/dist/esm/color.js

@@ -114,6 +114,59 @@ export const lightenColor = (unit = 0.2, color) => {
     const rgbColor = normalizeColor(color);
     return rgbColor ? shade(unit, rgbColor) : 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 const applyTint = (tint, color) => {
+    const rgba = normalizeColor(color);
+    if (!rgba || rgba.a === 0)
+        return undefined;
+    if (!Number.isFinite(tint) || tint === 0) {
+        return rgbToHex(Math.round(rgba.r), Math.round(rgba.g), Math.round(rgba.b));
+    }
+    const t = Math.max(-1, Math.min(1, tint));
+    const [h, l, s] = rgbToHls(rgba.r / 255, rgba.g / 255, rgba.b / 255);
+    const lum = Math.max(0, Math.min(1, t < 0 ? l * (1 + t) : l * (1 - t) + t));
+    const [r, g, b] = hlsToRgb(h, lum, s);
+    const byte = (c) => Math.max(0, Math.min(255, Math.round(c * 255)));
+    return rgbToHex(byte(r), byte(g), byte(b));
+};
+const rgbToHls = (r, g, b) => {
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    if (max === min)
+        return [0, l, 0];
+    const range = max - min;
+    const s = l <= 0.5 ? range / (max + min) : range / (2 - max - min);
+    const rc = (max - r) / range;
+    const gc = (max - g) / range;
+    const bc = (max - b) / range;
+    const h = r === max ? bc - gc : g === max ? 2 + rc - bc : 4 + gc - rc;
+    return [(((h / 6) % 1) + 1) % 1, l, s];
+};
+const hlsToRgb = (h, l, s) => {
+    if (s === 0)
+        return [l, l, l];
+    const m2 = l <= 0.5 ? l * (1 + s) : l + s - l * s;
+    const m1 = 2 * l - m2;
+    const v = (hue) => {
+        const x = ((hue % 1) + 1) % 1;
+        if (x < 1 / 6)
+            return m1 + (m2 - m1) * x * 6;
+        if (x < 0.5)
+            return m2;
+        if (x < 2 / 3)
+            return m1 + (m2 - m1) * (2 / 3 - x) * 6;
+        return m1;
+    };
+    return [v(h + 1 / 3), v(h), v(h - 1 / 3)];
+};
 export const hexToRgb = (hex) => {
     const bigint = parseInt(hex.slice(1), 16);
     const r = (bigint >> 16) & 255;

package/dist/esm/formatter.d.ts

@@ -44,5 +44,47 @@ export declare const withShortAmPmMarker: (pattern: string) => string | undefine
  */
 export declare const withWorkbookSeparators: (pattern: string, locale?: string) => string | undefined;
 export declare const ssfFormat: (pattern: string, value: any, locale?: string) => string;
+/**
+ * One piece of a number format's width-aware output (see
+ * {@link ssfFormatLayout}):
+ *  - `text` — literal characters, painted as they are;
+ *  - `fill` — Excel's `*x`: `x` repeated to fill the cell's free width;
+ *  - `skip` — Excel's `_x`: blank space as wide as the glyph `x`;
+ *  - `digit` — a `?` placeholder with no digit: blank space as wide as a
+ *    digit.
+ */
+export type NumberFormatLayoutPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "fill";
+    char: string;
+} | {
+    type: "skip";
+    char: string;
+} | {
+    type: "digit";
+};
+/**
+ * Excel's width-aware number-format output: `*x` repeats `x` to the cell's
+ * width, `_x` reserves the width of `x` and `?` reserves a digit's width
+ * ("Number format codes", support.microsoft.com). A plain formatted string
+ * cannot carry that — `ssfFormat` drops the fill and renders the reserves as
+ * single spaces — so the painter asks for the parts and expands them with
+ * measured glyph widths.
+ *
+ * Returns `undefined` when the pattern has none of those tokens (the plain
+ * string is already exact), and for East Asian numeral codes. The parts'
+ * plain text ({@link numberFormatLayoutText}) equals `ssfFormat`'s output;
+ * callers compare it against the string they paint and ignore the layout
+ * when the two disagree.
+ */
+export declare const ssfFormatLayout: (pattern: string, value: any, locale?: string) => NumberFormatLayoutPart[] | undefined;
+/**
+ * The plain string a layout stands for — what `ssfFormat` returns for the
+ * same pattern and value: fills drop out, skips and digit pads are one
+ * space each.
+ */
+export declare const numberFormatLayoutText: (parts: readonly NumberFormatLayoutPart[]) => string;
 export declare const ssfFormatColor: (pattern: string, value: any) => string | undefined;
 //# sourceMappingURL=formatter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../formatter.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OASlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KACjC,OAWF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAWlE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAOlE,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,KAAG,OA4B1D,CAAC;AA+LF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,MAAM,GAAG,SA4C9D,CAAC;AAiIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,MAAM,EACf,SAAS,MAAM,KACd,MAAM,GAAG,SAiBX,CAAC;AAiBF,eAAO,MAAM,SAAS,GACpB,SAAS,MAAM,EACf,OAAO,GAAG,EACV,SAAS,MAAM,KACd,MA0CF,CAAC;AAmLF,eAAO,MAAM,cAAc,GACzB,SAAS,MAAM,EACf,OAAO,GAAG,KACT,MAAM,GAAG,SAoBX,CAAC"}
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../formatter.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OASlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KACjC,OAWF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAWlE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAOlE,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,KAAG,OA4B1D,CAAC;AA+LF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,MAAM,GAAG,SA4C9D,CAAC;AAiIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,MAAM,EACf,SAAS,MAAM,KACd,MAAM,GAAG,SAiBX,CAAC;AAiBF,eAAO,MAAM,SAAS,GACpB,SAAS,MAAM,EACf,OAAO,GAAG,EACV,SAAS,MAAM,KACd,MASF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAoDtB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EACf,OAAO,GAAG,EACV,SAAS,MAAM,KACd,sBAAsB,EAAE,GAAG,SA8C7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,SAAS,sBAAsB,EAAE,KACvC,MAOF,CAAC;AAkQF,eAAO,MAAM,cAAc,GACzB,SAAS,MAAM,EACf,OAAO,GAAG,KACT,MAAM,GAAG,SAoBX,CAAC"}