@rowsncolumns/utils 9.5.7 → 9.6.1

package/dist/cjs/color.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getContrastColor = exports.expandChartPalette = exports.chartPaletteColorAt = exports.applyLumModOff = exports.CHART_PALETTE_VARIATIONS = exports.rgbToHex = exports.hexToRgb = exports.lightenColor = exports.colorStringToHex = exports.isSameColor = exports.rgbaToArgbHex = exports.getSelectionColorAtIndex = void 0;
+exports.getContrastColor = exports.expandChartPalette = exports.chartPaletteColorAt = exports.applyLumModOff = exports.CHART_PALETTE_VARIATIONS = exports.rgbToHex = exports.hexToRgb = exports.applyTint = exports.lightenColor = exports.colorStringToHex = exports.isSameColor = exports.rgbaToArgbHex = exports.getSelectionColorAtIndex = void 0;
 exports.normalizeColor = normalizeColor;
 var tslib_1 = require("tslib");
 var typeguards_1 = require("./typeguards");
@@ -126,6 +126,60 @@ var lightenColor = function (unit, color) {
     return rgbColor ? shade(unit, rgbColor) : undefined;
 };
 exports.lightenColor = lightenColor;
+/**
+ * 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.
+ */
+var applyTint = function (tint, color) {
+    var rgba = normalizeColor(color);
+    if (!rgba || rgba.a === 0)
+        return undefined;
+    if (!Number.isFinite(tint) || tint === 0) {
+        return (0, exports.rgbToHex)(Math.round(rgba.r), Math.round(rgba.g), Math.round(rgba.b));
+    }
+    var t = Math.max(-1, Math.min(1, tint));
+    var _a = tslib_1.__read(rgbToHls(rgba.r / 255, rgba.g / 255, rgba.b / 255), 3), h = _a[0], l = _a[1], s = _a[2];
+    var lum = Math.max(0, Math.min(1, t < 0 ? l * (1 + t) : l * (1 - t) + t));
+    var _b = tslib_1.__read(hlsToRgb(h, lum, s), 3), r = _b[0], g = _b[1], b = _b[2];
+    var byte = function (c) { return Math.max(0, Math.min(255, Math.round(c * 255))); };
+    return (0, exports.rgbToHex)(byte(r), byte(g), byte(b));
+};
+exports.applyTint = applyTint;
+var rgbToHls = function (r, g, b) {
+    var max = Math.max(r, g, b);
+    var min = Math.min(r, g, b);
+    var l = (max + min) / 2;
+    if (max === min)
+        return [0, l, 0];
+    var range = max - min;
+    var s = l <= 0.5 ? range / (max + min) : range / (2 - max - min);
+    var rc = (max - r) / range;
+    var gc = (max - g) / range;
+    var bc = (max - b) / range;
+    var h = r === max ? bc - gc : g === max ? 2 + rc - bc : 4 + gc - rc;
+    return [(((h / 6) % 1) + 1) % 1, l, s];
+};
+var hlsToRgb = function (h, l, s) {
+    if (s === 0)
+        return [l, l, l];
+    var m2 = l <= 0.5 ? l * (1 + s) : l + s - l * s;
+    var m1 = 2 * l - m2;
+    var v = function (hue) {
+        var 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)];
+};
 var hexToRgb = function (hex) {
     var bigint = parseInt(hex.slice(1), 16);
     var r = (bigint >> 16) & 255;

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

package/dist/cjs/formatter.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ssfFormatColor = exports.ssfFormat = exports.withWorkbookSeparators = exports.withShortAmPmMarker = exports.isStandaloneMonthPattern = exports.isTextPattern = exports.isTimePattern = exports.isDateTimePattern = exports.isDatePattern = void 0;
+exports.ssfFormatColor = exports.numberFormatLayoutText = exports.ssfFormatLayout = exports.ssfFormat = exports.withWorkbookSeparators = 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 cjk_number_format_1 = require("./cjk-number-format");
 var colors_1 = require("./colors");
 var excel_number_format_1 = require("./excel-number-format");
 /**
@@ -529,6 +530,169 @@ var withWorkbookSeparatorsCached = function (code, locale) {
     return rewritten;
 };
 var ssfFormat = function (pattern, value, locale) {
+    // East Asian tokens numfmt does not render (`[DBNumN]`, Japanese era `g`/`e`,
+    // `aaa` weekdays): rewrite the code to plain literals, then convert the
+    // rendered digits to the `[DBNumN]` numeral system (see cjk-number-format).
+    if (typeof value === "number") {
+        var cjk = (0, cjk_number_format_1.prepareCjkNumberFormat)(pattern, value, locale);
+        if (cjk)
+            return cjk.finish(ssfFormatBase(cjk.code, value, locale));
+    }
+    return ssfFormatBase(pattern, value, locale);
+};
+exports.ssfFormat = ssfFormat;
+var LAYOUT_FILL_MARK = "\uE000";
+var LAYOUT_SKIP_MARK = "\uE001";
+var LAYOUT_LITERAL_SPACE = "\uE002";
+var LAYOUT_DIGIT_PAD = "\u00a0";
+/**
+ * Quote every literal space of `code` as a private-use sentinel so that,
+ * rendered with numfmt's `nbsp` option, the only non-breaking spaces left
+ * in the output are the `?` digit pads.
+ */
+var markLiteralSpaces = function (code) {
+    var _a;
+    var out = "";
+    var inQuotes = false;
+    var inBrackets = false;
+    for (var i = 0; i < code.length; i++) {
+        var char = code[i];
+        if (inQuotes) {
+            if (char === '"')
+                inQuotes = false;
+            out += char === " " ? LAYOUT_LITERAL_SPACE : char;
+            continue;
+        }
+        if (inBrackets) {
+            if (char === "]")
+                inBrackets = false;
+            out += char;
+            continue;
+        }
+        if (char === '"') {
+            inQuotes = true;
+        }
+        else if (char === "[") {
+            inBrackets = true;
+        }
+        else if (char === "\\" && code[i + 1] === " ") {
+            out += "\"".concat(LAYOUT_LITERAL_SPACE, "\"");
+            i++;
+            continue;
+        }
+        else if (char === "\\" || char === "_" || char === "*") {
+            out += char + ((_a = code[i + 1]) !== null && _a !== void 0 ? _a : "");
+            i++;
+            continue;
+        }
+        else if (char === " ") {
+            out += "\"".concat(LAYOUT_LITERAL_SPACE, "\"");
+            continue;
+        }
+        out += char;
+    }
+    return out;
+};
+/** Does the pattern carry a `*` fill, `_` skip or `?` placeholder at all? */
+var LAYOUT_TOKEN_REGEX = /[*_?]/;
+/**
+ * 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.
+ */
+var ssfFormatLayout = function (pattern, value, locale) {
+    var _a;
+    if (!pattern || !LAYOUT_TOKEN_REGEX.test(pattern))
+        return undefined;
+    if (typeof value === "number" && (0, cjk_number_format_1.prepareCjkNumberFormat)(pattern, value, locale)) {
+        return undefined;
+    }
+    var raw = ssfFormatBase(pattern, value, locale, {
+        nbsp: true,
+        fillChar: LAYOUT_FILL_MARK,
+        skipChar: LAYOUT_SKIP_MARK,
+        transform: markLiteralSpaces,
+    });
+    if (raw === undefined)
+        return undefined;
+    // A locale whose group separator is itself a non-breaking space makes the
+    // digit pads ambiguous: keep those as plain spaces.
+    var digitPads = separatorsFor(locale).group !== LAYOUT_DIGIT_PAD;
+    var parts = [];
+    var text = "";
+    var flush = function () {
+        if (text)
+            parts.push({ type: "text", text: text });
+        text = "";
+    };
+    for (var i = 0; i < raw.length; i++) {
+        var char = raw[i];
+        if (char === LAYOUT_FILL_MARK || char === LAYOUT_SKIP_MARK) {
+            var next = (_a = raw[i + 1]) !== null && _a !== void 0 ? _a : " ";
+            flush();
+            parts.push({
+                type: char === LAYOUT_FILL_MARK ? "fill" : "skip",
+                char: next,
+            });
+            i++;
+        }
+        else if (char === LAYOUT_DIGIT_PAD) {
+            if (digitPads) {
+                flush();
+                parts.push({ type: "digit" });
+            }
+            else {
+                text += char;
+            }
+        }
+        else if (char === LAYOUT_LITERAL_SPACE) {
+            text += " ";
+        }
+        else {
+            text += char;
+        }
+    }
+    flush();
+    return parts.some(function (part) { return part.type !== "text"; }) ? parts : undefined;
+};
+exports.ssfFormatLayout = ssfFormatLayout;
+/**
+ * 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.
+ */
+var numberFormatLayoutText = function (parts) {
+    var e_2, _a;
+    var out = "";
+    try {
+        for (var parts_1 = tslib_1.__values(parts), parts_1_1 = parts_1.next(); !parts_1_1.done; parts_1_1 = parts_1.next()) {
+            var part = parts_1_1.value;
+            if (part.type === "text")
+                out += part.text;
+            else if (part.type !== "fill")
+                out += " ";
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (parts_1_1 && !parts_1_1.done && (_a = parts_1.return)) _a.call(parts_1);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return out;
+};
+exports.numberFormatLayoutText = numberFormatLayoutText;
+function ssfFormatBase(pattern, value, locale, layout) {
     try {
         if (locale)
             ensureNumfmtLocale(locale);
@@ -537,12 +701,22 @@ var ssfFormat = function (pattern, value, locale) {
             shortAmPm = (0, exports.withShortAmPmMarker)(pattern);
             shortAmPmPatternCache.set(pattern, shortAmPm);
         }
-        var code = withWorkbookSeparatorsCached(shortAmPm !== null && shortAmPm !== void 0 ? shortAmPm : pattern, locale);
+        var baseCode = withWorkbookSeparatorsCached(shortAmPm !== null && shortAmPm !== void 0 ? shortAmPm : pattern, locale);
+        var code = layout ? layout.transform(baseCode) : baseCode;
         var patternLocale = localeForPattern(pattern, locale);
         if (shortAmPm !== undefined && patternLocale) {
             patternLocale = getShortAmPmLocale(patternLocale);
         }
-        var options_1 = { locale: patternLocale };
+        // numfmt types `fillChar` / `skipChar` as booleans; at runtime they are
+        // the marker strings it emits ahead of the fill / skip character.
+        var options_1 = layout
+            ? {
+                locale: patternLocale,
+                nbsp: layout.nbsp,
+                fillChar: layout.fillChar,
+                skipChar: layout.skipChar,
+            }
+            : { locale: patternLocale };
         if (typeof value === "number") {
             // Excel decides rounding, `General`, huge magnitudes and conditional
             // sections from the 15-significant-digit decimal, not the binary
@@ -560,10 +734,9 @@ var ssfFormat = function (pattern, value, locale) {
         return isNegativeElapsedTime ? "-".concat(formatted) : formatted;
     }
     catch (err) {
-        return String(value);
+        return layout ? undefined : String(value);
     }
-};
-exports.ssfFormat = ssfFormat;
+}
 /**
  * Excel's legacy fixed 56-color palette used by `[ColorN]` directives
  * inside number format patterns (1-indexed). This palette is INDEPENDENT

package/dist/cjs/tsconfig.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../array.ts","../../cell-data-helpers.ts","../../clipboard-html-sanitize.ts","../../color.ts","../../colors.ts","../../condition-operand.ts","../../conditional-format.ts","../../content-hash.ts","../../data-validation.ts","../../date.ts","../../dom.ts","../../excel-number-format.ts","../../formatter.ts","../../formula-locale.ts","../../formula-refs.ts","../../formula.ts","../../index.ts","../../keyboard.ts","../../locale.ts","../../log.ts","../../memoize.ts","../../numbers.ts","../../rich-text-html.ts","../../rich-text-links.ts","../../selection.ts","../../shared-string-canonical.ts","../../sheet-names.ts","../../sheet-protection.ts","../../sheet-span.ts","../../sort.ts","../../sparkline-groups.ts","../../string.ts","../../table-names.ts","../../table-styles.ts","../../table-totals.ts","../../typeguards.ts","../../uuid.ts","../../vitest.config.ts","../../formula-locale/formula-locale-data.generated.ts"],"version":"5.8.3"}
+{"root":["../../array.ts","../../cell-data-helpers.ts","../../cjk-number-format.ts","../../clipboard-html-sanitize.ts","../../color.ts","../../colors.ts","../../condition-operand.ts","../../conditional-format.ts","../../content-hash.ts","../../data-validation.ts","../../date.ts","../../dom.ts","../../excel-number-format.ts","../../formatter.ts","../../formula-locale.ts","../../formula-refs.ts","../../formula.ts","../../index.ts","../../keyboard.ts","../../locale.ts","../../log.ts","../../memoize.ts","../../numbers.ts","../../rich-text-html.ts","../../rich-text-links.ts","../../selection.ts","../../shared-string-canonical.ts","../../sheet-names.ts","../../sheet-protection.ts","../../sheet-span.ts","../../sort.ts","../../sparkline-groups.ts","../../string.ts","../../table-names.ts","../../table-styles.ts","../../table-totals.ts","../../typeguards.ts","../../uuid.ts","../../vitest.config.ts","../../formula-locale/formula-locale-data.generated.ts"],"version":"5.8.3"}

package/dist/esm/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/esm/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/esm/cell-data-helpers.js

@@ -60,12 +60,19 @@ export const getExtendedValueError = (extValue) => {
  * state hooks' row auto-height so both agree on which cells wrap.
  */
 export const alignmentImpliesWrap = (align) => align === "justify" || align === "distributed";
+/**
+ * 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 const verticalAlignmentImpliesWrap = (align) => align === "justify" || align === "distributed";
 /**
  * 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 const cellFormatWrapsText = (format) => format?.wrapStrategy === "wrap" ||
-    alignmentImpliesWrap(format?.horizontalAlignment);
+    alignmentImpliesWrap(format?.horizontalAlignment) ||
+    verticalAlignmentImpliesWrap(format?.verticalAlignment);
 export const resolveDefaultHorizontalAlignment = ({ errorValue, userEnteredValue, effectiveValue, dataValidation, }) => {
     const isBoolean = getExtendedValueBool(userEnteredValue) !== undefined;
     const isCheckbox = dataValidation?.condition?.type === "BOOLEAN";

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