@rowsncolumns/utils 9.2.40 → 9.2.42

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

@@ -31,6 +31,19 @@ export declare const getExtendedValueError: (extValue?: Record<string, any> | nu
  * `getDefaultHorizontalAlignment(sheetId, rowIndex, columnIndex)` so a toolbar
  * alignment selector reports the alignment the grid actually draws.
  */
+/**
+ * Excel's `justify` and `distributed` alignments imply word wrap: the cell
+ * wraps inside its own width even without `wrapStrategy: "wrap"` (there is
+ * nothing to spread across otherwise) and the row auto-fits the wrapped
+ * lines. Shared by the canvas renderer (wrap + overflow decision) and the
+ * state hooks' row auto-height so both agree on which cells wrap.
+ */
+export declare const alignmentImpliesWrap: (align: HorizontalAlign | string | null | undefined) => boolean;
+/**
+ * Whether a cell format wraps its text — explicit `wrapStrategy: "wrap"` or
+ * an alignment that wraps implicitly ({@link alignmentImpliesWrap}).
+ */
+export declare const cellFormatWrapsText: (format: Pick<CellFormat, "wrapStrategy" | "horizontalAlignment"> | 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,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,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"}

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.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.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;
@@ -77,6 +77,24 @@ exports.getExtendedValueError = getExtendedValueError;
  * `getDefaultHorizontalAlignment(sheetId, rowIndex, columnIndex)` so a toolbar
  * alignment selector reports the alignment the grid actually draws.
  */
+/**
+ * Excel's `justify` and `distributed` alignments imply word wrap: the cell
+ * wraps inside its own width even without `wrapStrategy: "wrap"` (there is
+ * nothing to spread across otherwise) and the row auto-fits the wrapped
+ * lines. Shared by the canvas renderer (wrap + overflow decision) and the
+ * state hooks' row auto-height so both agree on which cells wrap.
+ */
+var alignmentImpliesWrap = function (align) { return align === "justify" || align === "distributed"; };
+exports.alignmentImpliesWrap = alignmentImpliesWrap;
+/**
+ * Whether a cell format wraps its text — explicit `wrapStrategy: "wrap"` or
+ * an alignment that wraps implicitly ({@link alignmentImpliesWrap}).
+ */
+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);
+};
+exports.cellFormatWrapsText = cellFormatWrapsText;
 var resolveDefaultHorizontalAlignment = function (_a) {
     var _b;
     var errorValue = _a.errorValue, userEnteredValue = _a.userEnteredValue, effectiveValue = _a.effectiveValue, dataValidation = _a.dataValidation;

package/dist/cjs/formatter.d.ts

@@ -31,6 +31,18 @@ export declare const isStandaloneMonthPattern: (pattern: string) => boolean;
  * `A`/`P` locale, or `undefined` when there is none.
  */
 export declare const withShortAmPmMarker: (pattern: string) => string | undefined;
+/**
+ * Excel's `[$symbol-LCID]` token selects the currency symbol and the
+ * language of day/month names and AM/PM; digit grouping and the decimal
+ * separator follow the workbook locale (`[$€-407] #,##0.00` is
+ * `€ 1,234.50` on a US host). numfmt applies the token's locale to the whole
+ * section, separators included, so the locale part is dropped from every
+ * section that is not a date (number, scientific, fraction, text, …); a
+ * date section keeps the token for its names, re-pointed at a companion
+ * locale that carries the workbook's separators for fractional seconds.
+ * Returns `undefined` when nothing had to change.
+ */
+export declare const withWorkbookSeparators: (pattern: string, locale?: string) => string | undefined;
 export declare const ssfFormat: (pattern: string, value: any, locale?: string) => 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":"AAaA;;;;;;;;;;;;;;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;AAuHF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,MAAM,GAAG,SA4C9D,CAAC;AAgBF,eAAO,MAAM,SAAS,GACpB,SAAS,MAAM,EACf,OAAO,GAAG,EACV,SAAS,MAAM,KACd,MAyCF,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":"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"}

package/dist/cjs/formatter.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ssfFormatColor = exports.ssfFormat = exports.withShortAmPmMarker = exports.isStandaloneMonthPattern = exports.isTextPattern = exports.isTimePattern = exports.isDateTimePattern = exports.isDatePattern = void 0;
+exports.ssfFormatColor = 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 colors_1 = require("./colors");
@@ -144,6 +144,69 @@ var intlMonthNames = function (locale, options) {
             .find(function (part) { return part.type === "month"; })) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : "";
     });
 };
+var intlRegisteredLocales = new Set();
+/**
+ * numfmt ships name tables for a fixed set of languages; a tag it does not know
+ * (et, ms, nn, …) silently renders English month/weekday names and en-US
+ * separators. Excel and `Intl.DateTimeFormat` localize every locale, so an
+ * unknown tag gets a numfmt locale built from Intl on first use: separators
+ * from `Intl.NumberFormat`, the in-date month names (numfmt's single table is
+ * the form used beside a day number — see `getStandaloneMonthLocale`), the
+ * in-date weekday names (the form `dateStyle: "full"` shows) and the AM/PM
+ * designators. Tags Intl itself does not know keep numfmt's fallback.
+ */
+var ensureNumfmtLocale = function (locale) {
+    var _a, _b;
+    if (intlRegisteredLocales.has(locale))
+        return;
+    intlRegisteredLocales.add(locale);
+    try {
+        if ((0, numfmt_1.getLocale)(locale))
+            return;
+        var canonical = Intl.DateTimeFormat.supportedLocalesOf([locale])[0];
+        if (!canonical)
+            return;
+        var numberParts_1 = new Intl.NumberFormat(locale).formatToParts(1234567.5);
+        var part = function (type) { var _a; return (_a = numberParts_1.find(function (p) { return p.type === type; })) === null || _a === void 0 ? void 0 : _a.value; };
+        var weekdayNames = function (weekday) {
+            // 2024-01-07 was a Sunday; numfmt indexes `dddd[0]` as Sunday.
+            var fmt = new Intl.DateTimeFormat(locale, {
+                weekday: weekday,
+                day: "numeric",
+                month: "long",
+                year: "numeric",
+                timeZone: "UTC",
+            });
+            return Array.from({ length: 7 }, function (_, i) {
+                var _a, _b;
+                return (_b = (_a = fmt
+                    .formatToParts(new Date(Date.UTC(2024, 0, 7 + i)))
+                    .find(function (p) { return p.type === "weekday"; })) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : "";
+            });
+        };
+        var dayPeriod = function (hour) {
+            var _a;
+            return (_a = new Intl.DateTimeFormat(locale, {
+                hour: "numeric",
+                hour12: true,
+                timeZone: "UTC",
+            })
+                .formatToParts(new Date(Date.UTC(2024, 0, 7, hour)))
+                .find(function (p) { return p.type === "dayPeriod"; })) === null || _a === void 0 ? void 0 : _a.value;
+        };
+        var dateParts = new Intl.DateTimeFormat(locale, {
+            timeZone: "UTC",
+        }).formatToParts(new Date(Date.UTC(2024, 0, 7)));
+        var monthIndex = dateParts.findIndex(function (p) { return p.type === "month"; });
+        var dayIndex = dateParts.findIndex(function (p) { return p.type === "day"; });
+        var am = dayPeriod(9);
+        var pm = dayPeriod(21);
+        (0, numfmt_1.addLocale)(tslib_1.__assign(tslib_1.__assign({ group: (_a = part("group")) !== null && _a !== void 0 ? _a : "\u00a0", decimal: (_b = part("decimal")) !== null && _b !== void 0 ? _b : ".", mmmm: intlMonthNames(locale, { day: "numeric", month: "long" }), mmm: intlMonthNames(locale, { day: "numeric", month: "short" }), dddd: weekdayNames("long"), ddd: weekdayNames("short") }, (am && pm && am !== pm ? { ampm: [am, pm] } : {})), { preferMDY: monthIndex >= 0 && dayIndex >= 0 && monthIndex < dayIndex }), locale);
+    }
+    catch (_c) {
+        // Malformed tag: numfmt keeps its own fallback.
+    }
+};
 var standaloneMonthLocales = new Map();
 /**
  * numfmt ships one month-name table per locale: the form used beside a day
@@ -316,14 +379,165 @@ var separatorsFor = function (locale) {
         group: (_b = l10n.group) !== null && _b !== void 0 ? _b : ",",
     };
 };
+/**
+ * Rewrite the `[$symbol-LCID]` tokens of one section through `rewrite`,
+ * which receives the bracket content (`€-407`) and returns the new content,
+ * or an empty string to drop the token. Quoted literals, escapes and other
+ * bracket directives are left as written.
+ */
+var rewriteSectionLocaleTokens = function (section, rewrite) {
+    var _a;
+    var out = "";
+    var inQuotes = false;
+    var inBrackets = false;
+    for (var i = 0; i < section.length; i++) {
+        var char = section[i];
+        if (inQuotes) {
+            inQuotes = char !== '"';
+        }
+        else if (inBrackets) {
+            inBrackets = char !== "]";
+        }
+        else if (char === '"') {
+            inQuotes = true;
+        }
+        else if (char === "[") {
+            var end = section[i + 1] === "$" ? section.indexOf("]", i) : -1;
+            if (end > 0) {
+                var token = rewrite(section.slice(i + 1, end));
+                if (token)
+                    out += "[".concat(token, "]");
+                i = end;
+                continue;
+            }
+            inBrackets = true;
+        }
+        else if (char === "\\" || char === "_" || char === "*") {
+            out += char + ((_a = section[i + 1]) !== null && _a !== void 0 ? _a : "");
+            i++;
+            continue;
+        }
+        out += char;
+    }
+    return out;
+};
+/** `[$€-407]` → `[$€]`; a bare `[$-407]` goes away. */
+var currencySymbolOnly = function (token) {
+    var dash = token.indexOf("-");
+    var symbol = dash < 0 ? token : token.slice(0, dash);
+    return symbol.length > 1 ? symbol : "";
+};
+var separatorLocales = new Map();
+/**
+ * Companion numfmt locale carrying `locale`'s calendar names and AM/PM with
+ * the workbook's decimal / group separators, so a date section pinned to
+ * `[$-407]` renders German names but a workbook decimal mark in `ss.00`.
+ * Returns `locale` itself when its separators already match.
+ */
+var getWorkbookSeparatorLocale = function (locale, separators) {
+    var key = "".concat(locale, "\0").concat(separators.decimal, "\0").concat(separators.group);
+    var cached = separatorLocales.get(key);
+    if (cached !== undefined)
+        return cached;
+    var overlay = locale;
+    try {
+        var base = (0, numfmt_1.getLocale)(locale);
+        if (base &&
+            (base.decimal !== separators.decimal || base.group !== separators.group)) {
+            // numfmt locale ids are `[a-z\d]+` with one optional `_` part.
+            var hex = function (text) {
+                return tslib_1.__spreadArray([], tslib_1.__read(text), false).map(function (c) { return c.codePointAt(0).toString(16); }).join("x");
+            };
+            overlay = "sep".concat(hex(separators.decimal), "x").concat(hex(separators.group), "_").concat(locale.replace(/[^a-z\d]/gi, ""));
+            (0, numfmt_1.addLocale)(tslib_1.__assign(tslib_1.__assign({}, base), { decimal: separators.decimal, group: separators.group }), overlay);
+        }
+    }
+    catch (_a) {
+        overlay = locale;
+    }
+    separatorLocales.set(key, overlay);
+    return overlay;
+};
+/**
+ * Re-point a date section's `[$symbol-LCID]` token at the companion locale
+ * with the workbook's separators (`$-407` → `$-sep2ex2c_407`). An LCID numfmt
+ * does not know or one carrying calendar bits stays as written.
+ */
+var workbookSeparatorLocaleToken = function (separators) {
+    return 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(getWorkbookSeparatorLocale(code, separators));
+    };
+};
+var isDateSection = function (section) {
+    try {
+        return (0, numfmt_1.isDateFormat)(section);
+    }
+    catch (_a) {
+        return false;
+    }
+};
+/**
+ * Excel's `[$symbol-LCID]` token selects the currency symbol and the
+ * language of day/month names and AM/PM; digit grouping and the decimal
+ * separator follow the workbook locale (`[$€-407] #,##0.00` is
+ * `€ 1,234.50` on a US host). numfmt applies the token's locale to the whole
+ * section, separators included, so the locale part is dropped from every
+ * section that is not a date (number, scientific, fraction, text, …); a
+ * date section keeps the token for its names, re-pointed at a companion
+ * locale that carries the workbook's separators for fractional seconds.
+ * Returns `undefined` when nothing had to change.
+ */
+var withWorkbookSeparators = function (pattern, locale) {
+    if (!pattern.includes("[$"))
+        return undefined;
+    var sections = (0, excel_number_format_1.splitFormatSections)(pattern);
+    var changed = false;
+    var dateTokens;
+    var rewritten = sections.map(function (section) {
+        if (!section.includes("[$"))
+            return section;
+        var rewrite = currencySymbolOnly;
+        if (isDateSection(section)) {
+            dateTokens !== null && dateTokens !== void 0 ? dateTokens : (dateTokens = workbookSeparatorLocaleToken(separatorsFor(locale)));
+            rewrite = dateTokens;
+        }
+        var stripped = rewriteSectionLocaleTokens(section, rewrite);
+        changed || (changed = stripped !== section);
+        return stripped;
+    });
+    return changed ? rewritten.join(";") : undefined;
+};
+exports.withWorkbookSeparators = withWorkbookSeparators;
+var workbookSeparatorPatternCache = new Map();
+var withWorkbookSeparatorsCached = function (code, locale) {
+    var _a;
+    var key = "".concat(locale !== null && locale !== void 0 ? locale : "", "\0").concat(code);
+    var rewritten = workbookSeparatorPatternCache.get(key);
+    if (rewritten === undefined) {
+        rewritten = (_a = (0, exports.withWorkbookSeparators)(code, locale)) !== null && _a !== void 0 ? _a : code;
+        workbookSeparatorPatternCache.set(key, rewritten);
+    }
+    return rewritten;
+};
 var ssfFormat = function (pattern, value, locale) {
     try {
+        if (locale)
+            ensureNumfmtLocale(locale);
         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 code = withWorkbookSeparatorsCached(shortAmPm !== null && shortAmPm !== void 0 ? shortAmPm : pattern, locale);
         var patternLocale = localeForPattern(pattern, locale);
         if (shortAmPm !== undefined && patternLocale) {
             patternLocale = getShortAmPmLocale(patternLocale);

package/dist/cjs/locale.d.ts

@@ -16,6 +16,21 @@ export declare const getLocaleDateParts: (locale: string) => [DatePartType, stri
  * de-DE → `d.m.yyyy`, hu-HU → `yyyy. mm. dd.`, en-CA → `yyyy-mm-dd`.
  */
 export declare const getDefaultDateFormat: (locale?: string) => string;
+export interface DateFieldTokens {
+    day: "d" | "dd";
+    month: "m" | "mm";
+    year: "yy" | "yyyy";
+}
+/**
+ * The day / month / year tokens of {@link getDefaultDateFormat} for a
+ * locale, i.e. whether the locale zero-pads each numeric field — ru-RU
+ * (`dd.mm.yyyy`) → `{ day: "dd", month: "mm", year: "yyyy" }`, en-US
+ * (`m/d/yyyy`) → `{ day: "d", month: "m", year: "yyyy" }`. A date typed
+ * as digits is displayed with the locale's own padding (Excel re-renders
+ * `30.9.2025` as `30.09.2025` under ru-RU), so the date parser assigns
+ * these tokens rather than echoing the padding the user happened to type.
+ */
+export declare const getDefaultDateFieldTokens: (locale?: string) => DateFieldTokens;
 /**
  * Default time pattern for a locale, honoring its 12/24-hour convention,
  * separators and hour padding — e.g. en-US → `h:mm:ss AM/PM`,

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

@@ -1 +1 @@
-{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../locale.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,cAU5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,MAAM,qCAkC3D,CAAC;AAEF,eAAO,MAAM,kBAAkB,sDAAyC,CAAC;AAqFzE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAQ,MAA2B,WAClC,CAAC;AAuCvC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAQ,MAA2B,EACnC,YAAW,QAAQ,GAAG,QAAmB,WACS,CAAC;AAErD,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,WAEvD,CAAC;AA2CF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAQ,MAA2B,WAClC,CAAC"}
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../locale.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,cAU5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,MAAM,qCAkC3D,CAAC;AAEF,eAAO,MAAM,kBAAkB,sDAAyC,CAAC;AAiGzE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAQ,MAA2B,WAClC,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IAChB,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;CACrB;AAwBD;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAQ,MAA2B,KAClC,eAA4D,CAAC;AAuChE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAQ,MAA2B,EACnC,YAAW,QAAQ,GAAG,QAAmB,WACS,CAAC;AAErD,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,WAEvD,CAAC;AA2CF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAQ,MAA2B,WAClC,CAAC"}

package/dist/cjs/locale.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLongDateFormat = exports.getDefaultDateTimeFormat = exports.getDefaultTimeFormat = exports.getDefaultDateFormat = exports.getLocaleDateParts = exports.getLocaleDatePartsNotMemoized = exports.getCurrentLocale = void 0;
+exports.getLongDateFormat = exports.getDefaultDateTimeFormat = exports.getDefaultTimeFormat = exports.getDefaultDateFieldTokens = exports.getDefaultDateFormat = exports.getLocaleDateParts = exports.getLocaleDatePartsNotMemoized = exports.getCurrentLocale = void 0;
 var tslib_1 = require("tslib");
 var memoize_1 = require("./memoize");
 var defaultLocale;
@@ -134,9 +134,15 @@ var buildPatternFromParts = function (parts, toToken) {
     // trailing fields we skipped (e.g. an era) — trim stray whitespace.
     return pattern.trim();
 };
-var getDefaultDateFormatMemoized = (0, memoize_1.memoize)(function (locale) {
+/**
+ * `formatToParts` of the locale's numeric short date for the sample
+ * instant — the single source both the default pattern and its per-field
+ * tokens are read from, so they can never disagree. Empty when Intl has
+ * no data for the locale.
+ */
+var getDefaultDateParts = (0, memoize_1.memoize)(function (locale) {
     try {
-        var parts = new Intl.DateTimeFormat(locale, {
+        return new Intl.DateTimeFormat(locale, {
             calendar: "gregory",
             numberingSystem: "latn",
             year: "numeric",
@@ -144,13 +150,15 @@ var getDefaultDateFormatMemoized = (0, memoize_1.memoize)(function (locale) {
             day: "numeric",
             timeZone: "UTC",
         }).formatToParts(FORMAT_SAMPLE_DATE);
-        var pattern = buildPatternFromParts(parts, dateFieldToken);
-        return pattern || "m/d/yyyy";
     }
     catch (err) {
-        return "m/d/yyyy";
+        return [];
     }
 });
+var getDefaultDateFormatMemoized = (0, memoize_1.memoize)(function (locale) {
+    var pattern = buildPatternFromParts(getDefaultDateParts(locale), dateFieldToken);
+    return pattern || "m/d/yyyy";
+});
 /**
  * Default numeric (short) date pattern for a locale, preserving the
  * locale's field order, separators, literal text and zero-padding as
@@ -162,6 +170,50 @@ var getDefaultDateFormat = function (locale) {
     return getDefaultDateFormatMemoized(locale);
 };
 exports.getDefaultDateFormat = getDefaultDateFormat;
+var getDefaultDateFieldTokensMemoized = (0, memoize_1.memoize)(function (locale) {
+    var e_3, _a;
+    var tokens = { day: "d", month: "m", year: "yyyy" };
+    try {
+        for (var _b = tslib_1.__values(getDefaultDateParts(locale)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var part = _c.value;
+            switch (part.type) {
+                case "day":
+                    tokens.day = part.value.length === 2 ? "dd" : "d";
+                    break;
+                case "month":
+                    tokens.month = part.value.length === 2 ? "mm" : "m";
+                    break;
+                case "year":
+                    tokens.year = part.value.length === 2 ? "yy" : "yyyy";
+                    break;
+                default:
+                    break;
+            }
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+    return tokens;
+});
+/**
+ * The day / month / year tokens of {@link getDefaultDateFormat} for a
+ * locale, i.e. whether the locale zero-pads each numeric field — ru-RU
+ * (`dd.mm.yyyy`) → `{ day: "dd", month: "mm", year: "yyyy" }`, en-US
+ * (`m/d/yyyy`) → `{ day: "d", month: "m", year: "yyyy" }`. A date typed
+ * as digits is displayed with the locale's own padding (Excel re-renders
+ * `30.9.2025` as `30.09.2025` under ru-RU), so the date parser assigns
+ * these tokens rather than echoing the padding the user happened to type.
+ */
+var getDefaultDateFieldTokens = function (locale) {
+    if (locale === void 0) { locale = (0, exports.getCurrentLocale)(); }
+    return getDefaultDateFieldTokensMemoized(locale);
+};
+exports.getDefaultDateFieldTokens = getDefaultDateFieldTokens;
 var getDefaultTimeFormatMemoized = (0, memoize_1.memoize)(function (locale, precision) {
     try {
         var parts = new Intl.DateTimeFormat(locale, tslib_1.__assign(tslib_1.__assign({ numberingSystem: "latn", hour: "numeric", minute: "numeric" }, (precision === "second" ? { second: "numeric" } : {})), { timeZone: "UTC" })).formatToParts(FORMAT_SAMPLE_DATE);

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

@@ -31,6 +31,19 @@ export declare const getExtendedValueError: (extValue?: Record<string, any> | nu
  * `getDefaultHorizontalAlignment(sheetId, rowIndex, columnIndex)` so a toolbar
  * alignment selector reports the alignment the grid actually draws.
  */
+/**
+ * Excel's `justify` and `distributed` alignments imply word wrap: the cell
+ * wraps inside its own width even without `wrapStrategy: "wrap"` (there is
+ * nothing to spread across otherwise) and the row auto-fits the wrapped
+ * lines. Shared by the canvas renderer (wrap + overflow decision) and the
+ * state hooks' row auto-height so both agree on which cells wrap.
+ */
+export declare const alignmentImpliesWrap: (align: HorizontalAlign | string | null | undefined) => boolean;
+/**
+ * Whether a cell format wraps its text — explicit `wrapStrategy: "wrap"` or
+ * an alignment that wraps implicitly ({@link alignmentImpliesWrap}).
+ */
+export declare const cellFormatWrapsText: (format: Pick<CellFormat, "wrapStrategy" | "horizontalAlignment"> | 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,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,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"}

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

@@ -52,6 +52,20 @@ export const getExtendedValueError = (extValue) => {
  * `getDefaultHorizontalAlignment(sheetId, rowIndex, columnIndex)` so a toolbar
  * alignment selector reports the alignment the grid actually draws.
  */
+/**
+ * Excel's `justify` and `distributed` alignments imply word wrap: the cell
+ * wraps inside its own width even without `wrapStrategy: "wrap"` (there is
+ * nothing to spread across otherwise) and the row auto-fits the wrapped
+ * lines. Shared by the canvas renderer (wrap + overflow decision) and the
+ * state hooks' row auto-height so both agree on which cells wrap.
+ */
+export const alignmentImpliesWrap = (align) => align === "justify" || align === "distributed";
+/**
+ * Whether a cell format wraps its text — explicit `wrapStrategy: "wrap"` or
+ * an alignment that wraps implicitly ({@link alignmentImpliesWrap}).
+ */
+export const cellFormatWrapsText = (format) => format?.wrapStrategy === "wrap" ||
+    alignmentImpliesWrap(format?.horizontalAlignment);
 export const resolveDefaultHorizontalAlignment = ({ errorValue, userEnteredValue, effectiveValue, dataValidation, }) => {
     const isBoolean = getExtendedValueBool(userEnteredValue) !== undefined;
     const isCheckbox = dataValidation?.condition?.type === "BOOLEAN";

package/dist/esm/formatter.d.ts

@@ -31,6 +31,18 @@ export declare const isStandaloneMonthPattern: (pattern: string) => boolean;
  * `A`/`P` locale, or `undefined` when there is none.
  */
 export declare const withShortAmPmMarker: (pattern: string) => string | undefined;
+/**
+ * Excel's `[$symbol-LCID]` token selects the currency symbol and the
+ * language of day/month names and AM/PM; digit grouping and the decimal
+ * separator follow the workbook locale (`[$€-407] #,##0.00` is
+ * `€ 1,234.50` on a US host). numfmt applies the token's locale to the whole
+ * section, separators included, so the locale part is dropped from every
+ * section that is not a date (number, scientific, fraction, text, …); a
+ * date section keeps the token for its names, re-pointed at a companion
+ * locale that carries the workbook's separators for fractional seconds.
+ * Returns `undefined` when nothing had to change.
+ */
+export declare const withWorkbookSeparators: (pattern: string, locale?: string) => string | undefined;
 export declare const ssfFormat: (pattern: string, value: any, locale?: string) => 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":"AAaA;;;;;;;;;;;;;;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;AAuHF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,MAAM,GAAG,SA4C9D,CAAC;AAgBF,eAAO,MAAM,SAAS,GACpB,SAAS,MAAM,EACf,OAAO,GAAG,EACV,SAAS,MAAM,KACd,MAyCF,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":"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"}

package/dist/esm/formatter.js

@@ -1,6 +1,6 @@
 import { addLocale, format, formatColor, getFormatDateInfo, getLocale, isDateFormat, isTextFormat, } from "numfmt";
 import { IndexedColors } from "./colors";
-import { excelNumberPrePass } from "./excel-number-format";
+import { excelNumberPrePass, splitFormatSections, } from "./excel-number-format";
 /**
  * Pattern-based type inference (Excel parity). xlsx files routinely carry
  * a `numberFormat.pattern` without an accompanying `type` field — these
@@ -132,6 +132,71 @@ const intlMonthNames = (locale, options) => {
         .formatToParts(new Date(Date.UTC(2020, month, 1)))
         .find((part) => part.type === "month")?.value ?? "");
 };
+const intlRegisteredLocales = new Set();
+/**
+ * numfmt ships name tables for a fixed set of languages; a tag it does not know
+ * (et, ms, nn, …) silently renders English month/weekday names and en-US
+ * separators. Excel and `Intl.DateTimeFormat` localize every locale, so an
+ * unknown tag gets a numfmt locale built from Intl on first use: separators
+ * from `Intl.NumberFormat`, the in-date month names (numfmt's single table is
+ * the form used beside a day number — see `getStandaloneMonthLocale`), the
+ * in-date weekday names (the form `dateStyle: "full"` shows) and the AM/PM
+ * designators. Tags Intl itself does not know keep numfmt's fallback.
+ */
+const ensureNumfmtLocale = (locale) => {
+    if (intlRegisteredLocales.has(locale))
+        return;
+    intlRegisteredLocales.add(locale);
+    try {
+        if (getLocale(locale))
+            return;
+        const canonical = Intl.DateTimeFormat.supportedLocalesOf([locale])[0];
+        if (!canonical)
+            return;
+        const numberParts = new Intl.NumberFormat(locale).formatToParts(1234567.5);
+        const part = (type) => numberParts.find((p) => p.type === type)?.value;
+        const weekdayNames = (weekday) => {
+            // 2024-01-07 was a Sunday; numfmt indexes `dddd[0]` as Sunday.
+            const fmt = new Intl.DateTimeFormat(locale, {
+                weekday,
+                day: "numeric",
+                month: "long",
+                year: "numeric",
+                timeZone: "UTC",
+            });
+            return Array.from({ length: 7 }, (_, i) => fmt
+                .formatToParts(new Date(Date.UTC(2024, 0, 7 + i)))
+                .find((p) => p.type === "weekday")?.value ?? "");
+        };
+        const dayPeriod = (hour) => new Intl.DateTimeFormat(locale, {
+            hour: "numeric",
+            hour12: true,
+            timeZone: "UTC",
+        })
+            .formatToParts(new Date(Date.UTC(2024, 0, 7, hour)))
+            .find((p) => p.type === "dayPeriod")?.value;
+        const dateParts = new Intl.DateTimeFormat(locale, {
+            timeZone: "UTC",
+        }).formatToParts(new Date(Date.UTC(2024, 0, 7)));
+        const monthIndex = dateParts.findIndex((p) => p.type === "month");
+        const dayIndex = dateParts.findIndex((p) => p.type === "day");
+        const am = dayPeriod(9);
+        const pm = dayPeriod(21);
+        addLocale({
+            group: part("group") ?? "\u00a0",
+            decimal: part("decimal") ?? ".",
+            mmmm: intlMonthNames(locale, { day: "numeric", month: "long" }),
+            mmm: intlMonthNames(locale, { day: "numeric", month: "short" }),
+            dddd: weekdayNames("long"),
+            ddd: weekdayNames("short"),
+            ...(am && pm && am !== pm ? { ampm: [am, pm] } : {}),
+            preferMDY: monthIndex >= 0 && dayIndex >= 0 && monthIndex < dayIndex,
+        }, locale);
+    }
+    catch {
+        // Malformed tag: numfmt keeps its own fallback.
+    }
+};
 const standaloneMonthLocales = new Map();
 /**
  * numfmt ships one month-name table per locale: the form used beside a day
@@ -290,14 +355,158 @@ const separatorsFor = (locale) => {
         group: l10n.group ?? ",",
     };
 };
+/**
+ * Rewrite the `[$symbol-LCID]` tokens of one section through `rewrite`,
+ * which receives the bracket content (`€-407`) and returns the new content,
+ * or an empty string to drop the token. Quoted literals, escapes and other
+ * bracket directives are left as written.
+ */
+const rewriteSectionLocaleTokens = (section, rewrite) => {
+    let out = "";
+    let inQuotes = false;
+    let inBrackets = false;
+    for (let i = 0; i < section.length; i++) {
+        const char = section[i];
+        if (inQuotes) {
+            inQuotes = char !== '"';
+        }
+        else if (inBrackets) {
+            inBrackets = char !== "]";
+        }
+        else if (char === '"') {
+            inQuotes = true;
+        }
+        else if (char === "[") {
+            const end = section[i + 1] === "$" ? section.indexOf("]", i) : -1;
+            if (end > 0) {
+                const token = rewrite(section.slice(i + 1, end));
+                if (token)
+                    out += `[${token}]`;
+                i = end;
+                continue;
+            }
+            inBrackets = true;
+        }
+        else if (char === "\\" || char === "_" || char === "*") {
+            out += char + (section[i + 1] ?? "");
+            i++;
+            continue;
+        }
+        out += char;
+    }
+    return out;
+};
+/** `[$€-407]` → `[$€]`; a bare `[$-407]` goes away. */
+const currencySymbolOnly = (token) => {
+    const dash = token.indexOf("-");
+    const symbol = dash < 0 ? token : token.slice(0, dash);
+    return symbol.length > 1 ? symbol : "";
+};
+const separatorLocales = new Map();
+/**
+ * Companion numfmt locale carrying `locale`'s calendar names and AM/PM with
+ * the workbook's decimal / group separators, so a date section pinned to
+ * `[$-407]` renders German names but a workbook decimal mark in `ss.00`.
+ * Returns `locale` itself when its separators already match.
+ */
+const getWorkbookSeparatorLocale = (locale, separators) => {
+    const key = `${locale}\u0000${separators.decimal}\u0000${separators.group}`;
+    const cached = separatorLocales.get(key);
+    if (cached !== undefined)
+        return cached;
+    let overlay = locale;
+    try {
+        const base = getLocale(locale);
+        if (base &&
+            (base.decimal !== separators.decimal || base.group !== separators.group)) {
+            // numfmt locale ids are `[a-z\d]+` with one optional `_` part.
+            const hex = (text) => [...text].map((c) => c.codePointAt(0).toString(16)).join("x");
+            overlay = `sep${hex(separators.decimal)}x${hex(separators.group)}_${locale.replace(/[^a-z\d]/gi, "")}`;
+            addLocale({ ...base, decimal: separators.decimal, group: separators.group }, overlay);
+        }
+    }
+    catch {
+        overlay = locale;
+    }
+    separatorLocales.set(key, overlay);
+    return overlay;
+};
+/**
+ * Re-point a date section's `[$symbol-LCID]` token at the companion locale
+ * with the workbook's separators (`$-407` → `$-sep2ex2c_407`). An LCID numfmt
+ * does not know or one carrying calendar bits stays as written.
+ */
+const workbookSeparatorLocaleToken = (separators) => (token) => {
+    const dash = token.indexOf("-");
+    if (dash < 0)
+        return token;
+    const code = token.slice(dash + 1);
+    const wincode = Number.parseInt(code, 16);
+    if (Number.isFinite(wincode) && wincode & 0xff0000)
+        return token;
+    if (!getLocale(code))
+        return token;
+    return `${token.slice(0, dash + 1)}${getWorkbookSeparatorLocale(code, separators)}`;
+};
+const isDateSection = (section) => {
+    try {
+        return isDateFormat(section);
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Excel's `[$symbol-LCID]` token selects the currency symbol and the
+ * language of day/month names and AM/PM; digit grouping and the decimal
+ * separator follow the workbook locale (`[$€-407] #,##0.00` is
+ * `€ 1,234.50` on a US host). numfmt applies the token's locale to the whole
+ * section, separators included, so the locale part is dropped from every
+ * section that is not a date (number, scientific, fraction, text, …); a
+ * date section keeps the token for its names, re-pointed at a companion
+ * locale that carries the workbook's separators for fractional seconds.
+ * Returns `undefined` when nothing had to change.
+ */
+export const withWorkbookSeparators = (pattern, locale) => {
+    if (!pattern.includes("[$"))
+        return undefined;
+    const sections = splitFormatSections(pattern);
+    let changed = false;
+    let dateTokens;
+    const rewritten = sections.map((section) => {
+        if (!section.includes("[$"))
+            return section;
+        let rewrite = currencySymbolOnly;
+        if (isDateSection(section)) {
+            dateTokens ??= workbookSeparatorLocaleToken(separatorsFor(locale));
+            rewrite = dateTokens;
+        }
+        const stripped = rewriteSectionLocaleTokens(section, rewrite);
+        changed ||= stripped !== section;
+        return stripped;
+    });
+    return changed ? rewritten.join(";") : undefined;
+};
+const workbookSeparatorPatternCache = new Map();
+const withWorkbookSeparatorsCached = (code, locale) => {
+    const key = `${locale ?? ""}\u0000${code}`;
+    let rewritten = workbookSeparatorPatternCache.get(key);
+    if (rewritten === undefined) {
+        rewritten = withWorkbookSeparators(code, locale) ?? code;
+        workbookSeparatorPatternCache.set(key, rewritten);
+    }
+    return rewritten;
+};
 export const ssfFormat = (pattern, value, locale) => {
     try {
+        if (locale)
+            ensureNumfmtLocale(locale);
         let shortAmPm = shortAmPmPatternCache.get(pattern);
         if (shortAmPm === undefined && !shortAmPmPatternCache.has(pattern)) {
             shortAmPm = withShortAmPmMarker(pattern);
             shortAmPmPatternCache.set(pattern, shortAmPm);
         }
-        const code = shortAmPm ?? pattern;
+        const code = withWorkbookSeparatorsCached(shortAmPm ?? pattern, locale);
         let patternLocale = localeForPattern(pattern, locale);
         if (shortAmPm !== undefined && patternLocale) {
             patternLocale = getShortAmPmLocale(patternLocale);

package/dist/esm/locale.d.ts

@@ -16,6 +16,21 @@ export declare const getLocaleDateParts: (locale: string) => [DatePartType, stri
  * de-DE → `d.m.yyyy`, hu-HU → `yyyy. mm. dd.`, en-CA → `yyyy-mm-dd`.
  */
 export declare const getDefaultDateFormat: (locale?: string) => string;
+export interface DateFieldTokens {
+    day: "d" | "dd";
+    month: "m" | "mm";
+    year: "yy" | "yyyy";
+}
+/**
+ * The day / month / year tokens of {@link getDefaultDateFormat} for a
+ * locale, i.e. whether the locale zero-pads each numeric field — ru-RU
+ * (`dd.mm.yyyy`) → `{ day: "dd", month: "mm", year: "yyyy" }`, en-US
+ * (`m/d/yyyy`) → `{ day: "d", month: "m", year: "yyyy" }`. A date typed
+ * as digits is displayed with the locale's own padding (Excel re-renders
+ * `30.9.2025` as `30.09.2025` under ru-RU), so the date parser assigns
+ * these tokens rather than echoing the padding the user happened to type.
+ */
+export declare const getDefaultDateFieldTokens: (locale?: string) => DateFieldTokens;
 /**
  * Default time pattern for a locale, honoring its 12/24-hour convention,
  * separators and hour padding — e.g. en-US → `h:mm:ss AM/PM`,

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

@@ -1 +1 @@
-{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../locale.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,cAU5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,MAAM,qCAkC3D,CAAC;AAEF,eAAO,MAAM,kBAAkB,sDAAyC,CAAC;AAqFzE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAQ,MAA2B,WAClC,CAAC;AAuCvC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAQ,MAA2B,EACnC,YAAW,QAAQ,GAAG,QAAmB,WACS,CAAC;AAErD,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,WAEvD,CAAC;AA2CF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAQ,MAA2B,WAClC,CAAC"}
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../locale.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,cAU5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,MAAM,qCAkC3D,CAAC;AAEF,eAAO,MAAM,kBAAkB,sDAAyC,CAAC;AAiGzE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAQ,MAA2B,WAClC,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IAChB,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;CACrB;AAwBD;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAQ,MAA2B,KAClC,eAA4D,CAAC;AAuChE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAQ,MAA2B,EACnC,YAAW,QAAQ,GAAG,QAAmB,WACS,CAAC;AAErD,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,WAEvD,CAAC;AA2CF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAQ,MAA2B,WAClC,CAAC"}

package/dist/esm/locale.js

@@ -105,9 +105,15 @@ const buildPatternFromParts = (parts, toToken) => {
     // trailing fields we skipped (e.g. an era) — trim stray whitespace.
     return pattern.trim();
 };
-const getDefaultDateFormatMemoized = memoize((locale) => {
+/**
+ * `formatToParts` of the locale's numeric short date for the sample
+ * instant — the single source both the default pattern and its per-field
+ * tokens are read from, so they can never disagree. Empty when Intl has
+ * no data for the locale.
+ */
+const getDefaultDateParts = memoize((locale) => {
     try {
-        const parts = new Intl.DateTimeFormat(locale, {
+        return new Intl.DateTimeFormat(locale, {
             calendar: "gregory",
             numberingSystem: "latn",
             year: "numeric",
@@ -115,13 +121,15 @@ const getDefaultDateFormatMemoized = memoize((locale) => {
             day: "numeric",
             timeZone: "UTC",
         }).formatToParts(FORMAT_SAMPLE_DATE);
-        const pattern = buildPatternFromParts(parts, dateFieldToken);
-        return pattern || "m/d/yyyy";
     }
     catch (err) {
-        return "m/d/yyyy";
+        return [];
     }
 });
+const getDefaultDateFormatMemoized = memoize((locale) => {
+    const pattern = buildPatternFromParts(getDefaultDateParts(locale), dateFieldToken);
+    return pattern || "m/d/yyyy";
+});
 /**
  * Default numeric (short) date pattern for a locale, preserving the
  * locale's field order, separators, literal text and zero-padding as
@@ -129,6 +137,35 @@ const getDefaultDateFormatMemoized = memoize((locale) => {
  * de-DE → `d.m.yyyy`, hu-HU → `yyyy. mm. dd.`, en-CA → `yyyy-mm-dd`.
  */
 export const getDefaultDateFormat = (locale = getCurrentLocale()) => getDefaultDateFormatMemoized(locale);
+const getDefaultDateFieldTokensMemoized = memoize((locale) => {
+    const tokens = { day: "d", month: "m", year: "yyyy" };
+    for (const part of getDefaultDateParts(locale)) {
+        switch (part.type) {
+            case "day":
+                tokens.day = part.value.length === 2 ? "dd" : "d";
+                break;
+            case "month":
+                tokens.month = part.value.length === 2 ? "mm" : "m";
+                break;
+            case "year":
+                tokens.year = part.value.length === 2 ? "yy" : "yyyy";
+                break;
+            default:
+                break;
+        }
+    }
+    return tokens;
+});
+/**
+ * The day / month / year tokens of {@link getDefaultDateFormat} for a
+ * locale, i.e. whether the locale zero-pads each numeric field — ru-RU
+ * (`dd.mm.yyyy`) → `{ day: "dd", month: "mm", year: "yyyy" }`, en-US
+ * (`m/d/yyyy`) → `{ day: "d", month: "m", year: "yyyy" }`. A date typed
+ * as digits is displayed with the locale's own padding (Excel re-renders
+ * `30.9.2025` as `30.09.2025` under ru-RU), so the date parser assigns
+ * these tokens rather than echoing the padding the user happened to type.
+ */
+export const getDefaultDateFieldTokens = (locale = getCurrentLocale()) => getDefaultDateFieldTokensMemoized(locale);
 const getDefaultTimeFormatMemoized = memoize((locale, precision) => {
     try {
         const parts = new Intl.DateTimeFormat(locale, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/utils",
-  "version": "9.2.40",
+  "version": "9.2.42",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "./dist/cjs/index.js",
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "numfmt": "^3.2.2",
-    "@rowsncolumns/common-types": ">=5.2.31"
+    "@rowsncolumns/common-types": ">=5.2.32"
   },
   "devDependencies": {},
   "peerDependencies": {}