@adminiumjs/i18n 0.1.0-rc.1

package/dist/create-i18n.d.ts

@@ -0,0 +1,48 @@
+/**
+ * i18next factory (10-i18n-theming.md §2.3): i18next + IcuFormat (ICU
+ * MessageFormat for every message — i18next's own plural-suffix system is
+ * disabled by the ICU format plugin) + an inline lazy backend. The bundled
+ * en-US namespaces ship synchronously (they are the fallback text and must
+ * never be async); every other locale/namespace pair is fetched through
+ * `loadBundle` — the dashboard passes a Vite dynamic-import loader so each
+ * locale becomes its own chunk.
+ */
+import { type i18n } from 'i18next';
+import { type LocaleId } from './locales.js';
+import { type Namespace, type ResourceBundle } from './resources/index.js';
+/** The concrete i18next instance type consumers hold (re-exported so callers never import i18next directly). */
+export type I18nInstance = i18n;
+export type BundleLoader = (tag: string, ns: Namespace) => Promise<ResourceBundle | {
+    default: ResourceBundle;
+} | null>;
+export interface CreateI18nOptions {
+    /** Canonical locale id (`en_US` … `ar_EG`) the instance starts in. */
+    locale: LocaleId;
+    /**
+     * Extra/override resource bundles, keyed by BCP-47 tag then namespace.
+     * Merged over the bundled en-US resources (tests, Electron packaging).
+     */
+    resources?: Partial<Record<string, Partial<Record<Namespace, ResourceBundle>>>> | undefined;
+    /**
+     * Lazy loader for non-bundled locale/namespace pairs. Return `null` (or
+     * reject) for a missing bundle — the key then resolves through the en-US
+     * fallback chain instead of failing.
+     */
+    loadBundle?: BundleLoader | undefined;
+    /** Missing-key hook (dev overlay / CI missing-key guard, §8.2). */
+    onMissingKey?: ((lng: string, ns: string, key: string) => void) | undefined;
+}
+/**
+ * Builds a ready (initialized) i18next instance for `locale`. For `en_US`
+ * initialization is effectively synchronous (bundled resources); other
+ * locales resolve once their bundles load (or immediately, falling back to
+ * en-US, when no loader/bundle exists yet).
+ */
+export declare function createI18n(opts: CreateI18nOptions): Promise<I18nInstance>;
+/**
+ * Preloaded live locale switch (§7.4): the target locale's namespaces load
+ * BEFORE `changeLanguage` fires, so the UI never renders a half-translated
+ * frame while `dir`/`lang` flip.
+ */
+export declare function switchLocale(instance: I18nInstance, locale: LocaleId): Promise<void>;
+//# sourceMappingURL=create-i18n.d.ts.map

package/dist/create-i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-i18n.d.ts","sourceRoot":"","sources":["../src/create-i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAgB,EAAsB,KAAK,IAAI,EAAoC,MAAM,SAAS,CAAC;AAGnG,OAAO,EAA6B,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAA+B,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExG,gHAAgH;AAChH,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC;AAEhC,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,SAAS,KACV,OAAO,CAAC,cAAc,GAAG;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,MAAM,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC5F;;;;OAIG;IACH,UAAU,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC,mEAAmE;IACnE,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7E;AA8BD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyC/E;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1F"}

package/dist/create-i18n.js

@@ -0,0 +1,98 @@
+/**
+ * i18next factory (10-i18n-theming.md §2.3): i18next + IcuFormat (ICU
+ * MessageFormat for every message — i18next's own plural-suffix system is
+ * disabled by the ICU format plugin) + an inline lazy backend. The bundled
+ * en-US namespaces ship synchronously (they are the fallback text and must
+ * never be async); every other locale/namespace pair is fetched through
+ * `loadBundle` — the dashboard passes a Vite dynamic-import loader so each
+ * locale becomes its own chunk.
+ */
+import i18next, {} from 'i18next';
+import { IcuFormat } from './icu-format.js';
+import { localeEntry, tagForLocale } from './locales.js';
+import { EN_US_RESOURCES, NAMESPACES } from './resources/index.js';
+function lazyBackend(load) {
+    return {
+        type: 'backend',
+        init() {
+            // Options come through the closure — nothing to do.
+        },
+        read(language, namespace, callback) {
+            void Promise.resolve()
+                .then(async () => await load(language, namespace))
+                .then((bundle) => {
+                if (bundle === null) {
+                    callback(null, {});
+                    return;
+                }
+                const data = 'default' in bundle ? bundle.default : bundle;
+                callback(null, data);
+            }, () => {
+                // Missing/failed chunk: resolve empty so the fallback chain applies
+                // (degraded network beats a blank screen, §7.5).
+                callback(null, {});
+            });
+        },
+    };
+}
+/**
+ * Builds a ready (initialized) i18next instance for `locale`. For `en_US`
+ * initialization is effectively synchronous (bundled resources); other
+ * locales resolve once their bundles load (or immediately, falling back to
+ * en-US, when no loader/bundle exists yet).
+ */
+export async function createI18n(opts) {
+    const tag = tagForLocale(opts.locale);
+    const resources = {
+        'en-US': { ...EN_US_RESOURCES },
+    };
+    for (const [resourceTag, byNs] of Object.entries(opts.resources ?? {})) {
+        if (byNs === undefined)
+            continue;
+        const target = (resources[resourceTag] ??= {});
+        for (const [ns, bundle] of Object.entries(byNs)) {
+            if (bundle !== undefined)
+                target[ns] = bundle;
+        }
+    }
+    const instance = i18next.createInstance();
+    instance.use(new IcuFormat());
+    if (opts.loadBundle !== undefined)
+        instance.use(lazyBackend(opts.loadBundle));
+    await instance.init({
+        lng: tag,
+        fallbackLng: 'en-US',
+        ns: [...NAMESPACES],
+        defaultNS: 'common',
+        resources,
+        // Bundled en-US coexists with the lazy backend for other locales.
+        partialBundledLanguages: true,
+        // React escapes; ICU handles placeables (§2.3).
+        interpolation: { escapeValue: false },
+        returnNull: false,
+        returnEmptyString: false,
+        ...(opts.onMissingKey === undefined
+            ? {}
+            : {
+                saveMissing: true,
+                missingKeyHandler: (lngs, ns, key) => {
+                    for (const lng of lngs)
+                        opts.onMissingKey?.(lng, ns, key);
+                },
+            }),
+    });
+    return instance;
+}
+/**
+ * Preloaded live locale switch (§7.4): the target locale's namespaces load
+ * BEFORE `changeLanguage` fires, so the UI never renders a half-translated
+ * frame while `dir`/`lang` flip.
+ */
+export async function switchLocale(instance, locale) {
+    const { tag } = localeEntry(locale);
+    if (instance.language === tag)
+        return;
+    await instance.loadLanguages(tag);
+    await instance.changeLanguage(tag);
+}
+//# sourceMappingURL=create-i18n.js.map

package/dist/create-i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-i18n.js","sourceRoot":"","sources":["../src/create-i18n.ts"],"names":[],"mappings":"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"}

package/dist/format/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Intl formatting layer (10-i18n-theming.md §4). All numbers, dates,
+ * currencies, relative times, and lists render through here — never through
+ * hand-rolled helpers or `toLocaleString('en-US')`.
+ *
+ * Numeral policy (§4.2, normative): `ctx: "data"` (the default) forces Latin
+ * digits (`-u-nu-latn`) and the gregorian calendar (`-ca-gregory`) so mono
+ * data cells stay `tabular-nums`-aligned in every locale, including `ar_EG`;
+ * `ctx: "prose"` uses the locale's default numbering system, so Arabic prose
+ * renders Arabic-Indic digits. `Intl.*` instances are expensive — memoized
+ * per `(tag, options, context)`.
+ */
+export type FmtContext = 'data' | 'prose';
+export interface Formatters {
+    number(v: number, o?: Intl.NumberFormatOptions & {
+        ctx?: FmtContext;
+    }): string;
+    /** 24500 → "24.5K" / "24 500" per locale. */
+    compact(v: number, o?: {
+        ctx?: FmtContext;
+    }): string;
+    percent(v: number, o?: {
+        fractionDigits?: number;
+        ctx?: FmtContext;
+    }): string;
+    /** Currency code comes from column metadata, never from the viewer's locale (§4.4). */
+    currency(v: number, currency: string, o?: {
+        ctx?: FmtContext;
+    }): string;
+    /** Intl unit style, "1.2 MB". Data context (mono cells). */
+    bytes(v: number): string;
+    date(d: Date | string | number, style?: 'short' | 'medium' | 'long', o?: {
+        ctx?: FmtContext;
+        timeZone?: string;
+    }): string;
+    time(d: Date | string | number, o?: {
+        ctx?: FmtContext;
+        timeZone?: string;
+    }): string;
+    dateTime(d: Date | string | number, o?: {
+        ctx?: FmtContext;
+        timeZone?: string;
+    }): string;
+    /** `formatRange`, collapses shared parts. */
+    dateRange(a: Date | string | number, b: Date | string | number): string;
+    /** "3 hours ago" — auto unit, prose context; absolute date past ~26 days (§4.5). */
+    relative(d: Date | string | number, o?: {
+        now?: number;
+    }): string;
+    list(items: string[], type?: 'conjunction' | 'disjunction'): string;
+    /** Client-side sorts (in-memory widget sorts, ⌘K ordering) — `numeric: true`. */
+    collator(): Intl.Collator;
+}
+/** Static week-info fallback for the 8 locales (§4.5). ISO-8601 day numbers (1 = Monday … 7 = Sunday). */
+export interface WeekInfo {
+    firstDay: number;
+    weekend: readonly number[];
+}
+/** `Intl.Locale#getWeekInfo()` where available, else the static table. */
+export declare function weekInfo(tag: string): WeekInfo;
+/**
+ * The data-context BCP-47 tag (latn digits + gregorian calendar, §4.2) for
+ * callers that must build an `Intl.*` instance this layer does not expose —
+ * e.g. a narrow-style relative-time formatter for a mono grid cell. Keeps the
+ * numeral policy in one place instead of hand-rolling the `-u-nu-latn` suffix.
+ */
+export declare function latnDataTag(tag: string): string;
+/** Memoized per BCP-47 tag. Framework-free — the React binding is `useFmt()` (./react.js entry). */
+export declare function getFormatters(tag: string): Formatters;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/format/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG;QAAE,GAAG,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,MAAM,CAAC;IAC/E,6CAA6C;IAC7C,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,MAAM,CAAC;IACrD,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,MAAM,CAAC;IAC9E,uFAAuF;IACvF,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,MAAM,CAAC;IACxE,4DAA4D;IAC5D,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IAC1H,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IACrF,QAAQ,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IACzF,6CAA6C;IAC7C,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxE,oFAAoF;IACpF,QAAQ,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,aAAa,GAAG,MAAM,CAAC;IACpE,iFAAiF;IACjF,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;CAC3B;AAED,0GAA0G;AAC1G,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAaD,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAY9C;AAYD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AA2KD,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAQrD"}

package/dist/format/index.js

@@ -0,0 +1,217 @@
+/**
+ * Intl formatting layer (10-i18n-theming.md §4). All numbers, dates,
+ * currencies, relative times, and lists render through here — never through
+ * hand-rolled helpers or `toLocaleString('en-US')`.
+ *
+ * Numeral policy (§4.2, normative): `ctx: "data"` (the default) forces Latin
+ * digits (`-u-nu-latn`) and the gregorian calendar (`-ca-gregory`) so mono
+ * data cells stay `tabular-nums`-aligned in every locale, including `ar_EG`;
+ * `ctx: "prose"` uses the locale's default numbering system, so Arabic prose
+ * renders Arabic-Indic digits. `Intl.*` instances are expensive — memoized
+ * per `(tag, options, context)`.
+ */
+const WEEK_INFO_FALLBACK = {
+    'en-US': { firstDay: 7, weekend: [6, 7] },
+    'de-DE': { firstDay: 1, weekend: [6, 7] },
+    'fr-FR': { firstDay: 1, weekend: [6, 7] },
+    'cs-CZ': { firstDay: 1, weekend: [6, 7] },
+    'da-DK': { firstDay: 1, weekend: [6, 7] },
+    'zh-CN': { firstDay: 1, weekend: [6, 7] },
+    'zh-TW': { firstDay: 1, weekend: [6, 7] },
+    'ar-EG': { firstDay: 6, weekend: [5, 6] },
+};
+/** `Intl.Locale#getWeekInfo()` where available, else the static table. */
+export function weekInfo(tag) {
+    try {
+        const locale = new Intl.Locale(tag);
+        const info = locale.getWeekInfo?.() ?? locale.weekInfo;
+        if (info !== undefined)
+            return { firstDay: info.firstDay, weekend: info.weekend };
+    }
+    catch {
+        // Fall through to the static table.
+    }
+    return WEEK_INFO_FALLBACK[tag] ?? { firstDay: 1, weekend: [6, 7] };
+}
+/** §4.2/§4.3: latn digits + gregorian calendar pinned for data context. */
+function tagFor(tag, ctx) {
+    // Coalesce empty/invalid tags (see `normalizeTag`) before appending the
+    // `-u-...` extension, so `latnDataTag('')` and direct `Intl.*` builds off it
+    // don't produce an invalid `"-u-nu-latn-…"` tag that throws.
+    const base = normalizeTag(tag);
+    if (ctx === 'prose')
+        return base;
+    return base.includes('-u-') ? `${base}-nu-latn-ca-gregory` : `${base}-u-nu-latn-ca-gregory`;
+}
+/**
+ * The data-context BCP-47 tag (latn digits + gregorian calendar, §4.2) for
+ * callers that must build an `Intl.*` instance this layer does not expose —
+ * e.g. a narrow-style relative-time formatter for a mono grid cell. Keeps the
+ * numeral policy in one place instead of hand-rolling the `-u-nu-latn` suffix.
+ */
+export function latnDataTag(tag) {
+    return tagFor(tag, 'data');
+}
+const numberFormats = new Map();
+const dateFormats = new Map();
+const listFormats = new Map();
+const relativeFormats = new Map();
+const collators = new Map();
+function numberFormat(tag, ctx, options) {
+    const resolved = tagFor(tag, ctx);
+    const key = `${resolved}|${JSON.stringify(options)}`;
+    let fmt = numberFormats.get(key);
+    if (fmt === undefined) {
+        fmt = new Intl.NumberFormat(resolved, options);
+        numberFormats.set(key, fmt);
+    }
+    return fmt;
+}
+function dateFormat(tag, ctx, options) {
+    const resolved = tagFor(tag, ctx);
+    const key = `${resolved}|${JSON.stringify(options)}`;
+    let fmt = dateFormats.get(key);
+    if (fmt === undefined) {
+        fmt = new Intl.DateTimeFormat(resolved, options);
+        dateFormats.set(key, fmt);
+    }
+    return fmt;
+}
+function toDate(d) {
+    return d instanceof Date ? d : new Date(d);
+}
+const BYTE_UNITS = ['byte', 'kilobyte', 'megabyte', 'gigabyte', 'terabyte', 'petabyte'];
+const DATE_STYLES = {
+    short: { dateStyle: 'short' },
+    medium: { dateStyle: 'medium' },
+    long: { dateStyle: 'long' },
+};
+const MINUTE = 60_000;
+const HOUR = 3_600_000;
+const DAY = 86_400_000;
+const formattersByTag = new Map();
+function buildFormatters(tag) {
+    const relativeFor = (t) => {
+        let fmt = relativeFormats.get(t);
+        if (fmt === undefined) {
+            fmt = new Intl.RelativeTimeFormat(t, { numeric: 'auto' });
+            relativeFormats.set(t, fmt);
+        }
+        return fmt;
+    };
+    const fmt = {
+        number(v, o = {}) {
+            const { ctx = 'data', ...options } = o;
+            return numberFormat(tag, ctx, options).format(v);
+        },
+        compact(v, o = {}) {
+            return numberFormat(tag, o.ctx ?? 'data', { notation: 'compact', maximumFractionDigits: 1 }).format(v);
+        },
+        percent(v, o = {}) {
+            const digits = o.fractionDigits ?? 0;
+            return numberFormat(tag, o.ctx ?? 'data', {
+                style: 'percent',
+                minimumFractionDigits: digits,
+                maximumFractionDigits: digits,
+            }).format(v);
+        },
+        currency(v, currency, o = {}) {
+            return numberFormat(tag, o.ctx ?? 'data', { style: 'currency', currency }).format(v);
+        },
+        bytes(v) {
+            const magnitude = v === 0 ? 0 : Math.floor(Math.log10(Math.abs(v)) / 3);
+            const index = Math.min(Math.max(magnitude, 0), BYTE_UNITS.length - 1);
+            const unit = BYTE_UNITS[index] ?? 'byte';
+            return numberFormat(tag, 'data', {
+                style: 'unit',
+                unit,
+                unitDisplay: 'short',
+                maximumFractionDigits: 1,
+            }).format(v / 1000 ** index);
+        },
+        date(d, style = 'medium', o = {}) {
+            return dateFormat(tag, o.ctx ?? 'data', {
+                ...DATE_STYLES[style],
+                ...(o.timeZone === undefined ? {} : { timeZone: o.timeZone }),
+            }).format(toDate(d));
+        },
+        time(d, o = {}) {
+            return dateFormat(tag, o.ctx ?? 'data', {
+                timeStyle: 'short',
+                ...(o.timeZone === undefined ? {} : { timeZone: o.timeZone }),
+            }).format(toDate(d));
+        },
+        dateTime(d, o = {}) {
+            return dateFormat(tag, o.ctx ?? 'data', {
+                dateStyle: 'medium',
+                timeStyle: 'short',
+                ...(o.timeZone === undefined ? {} : { timeZone: o.timeZone }),
+            }).format(toDate(d));
+        },
+        dateRange(a, b) {
+            return dateFormat(tag, 'data', { dateStyle: 'medium' }).formatRange(toDate(a), toDate(b));
+        },
+        relative(d, o = {}) {
+            const now = o.now ?? Date.now();
+            const delta = toDate(d).getTime() - now;
+            const abs = Math.abs(delta);
+            const rtf = relativeFor(tag); // prose context: relative times live in sentences (§4.2)
+            if (abs < 45_000)
+                return rtf.format(0, 'second'); // "now" via numeric: 'auto'
+            if (abs < 90 * MINUTE)
+                return rtf.format(Math.round(delta / MINUTE), 'minute');
+            if (abs < 22 * HOUR)
+                return rtf.format(Math.round(delta / HOUR), 'hour');
+            if (abs < 26 * DAY)
+                return rtf.format(Math.round(delta / DAY), 'day');
+            return fmt.date(d);
+        },
+        list(items, type = 'conjunction') {
+            const key = `${tag}|${type}`;
+            let lf = listFormats.get(key);
+            if (lf === undefined) {
+                lf = new Intl.ListFormat(tag, { type });
+                listFormats.set(key, lf);
+            }
+            return lf.format(items);
+        },
+        collator() {
+            let c = collators.get(tag);
+            if (c === undefined) {
+                c = new Intl.Collator(tag, { numeric: true });
+                collators.set(tag, c);
+            }
+            return c;
+        },
+    };
+    return fmt;
+}
+/**
+ * Coalesce an empty/whitespace/structurally-invalid tag to `en-US`. Callers
+ * often pass `config.locale ?? 'en-US'`, which lets an empty string `''` slip
+ * through (`??` only catches null/undefined) — and `new Intl.NumberFormat('')`
+ * throws `RangeError`. Normalizing here makes every formatter safe against a
+ * schema-valid empty locale, so no widget crashes on it.
+ */
+function normalizeTag(tag) {
+    if (typeof tag !== 'string' || tag.trim() === '')
+        return 'en-US';
+    try {
+        Intl.getCanonicalLocales(tag); // throws RangeError on an invalid tag
+        return tag;
+    }
+    catch {
+        return 'en-US';
+    }
+}
+/** Memoized per BCP-47 tag. Framework-free — the React binding is `useFmt()` (./react.js entry). */
+export function getFormatters(tag) {
+    const normalized = normalizeTag(tag);
+    let fmt = formattersByTag.get(normalized);
+    if (fmt === undefined) {
+        fmt = buildFormatters(normalized);
+        formattersByTag.set(normalized, fmt);
+    }
+    return fmt;
+}
+//# sourceMappingURL=index.js.map

package/dist/format/index.js.map

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

package/dist/icu-format.d.ts

@@ -0,0 +1,17 @@
+type FormatValues = Record<string, unknown> | undefined;
+export declare class IcuFormat {
+    #private;
+    static readonly type = "i18nFormat";
+    readonly type: "i18nFormat";
+    constructor(opts?: {
+        onError?: (key: string, error: unknown) => void;
+    });
+    /** i18next module hook (called by i18next during init; extra args ignored). */
+    init(): void;
+    /** i18next i18nFormat contract: format the resolved resource string (trailing `info` arg unused). */
+    parse(res: string, options: FormatValues, lng: string, _ns: string, key: string): string;
+    /** i18next asks the format plugin whether to add ordinal/plural key suffixes — ICU handles plurals itself. */
+    getSuffixes(): string[];
+}
+export {};
+//# sourceMappingURL=icu-format.d.ts.map

package/dist/icu-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icu-format.d.ts","sourceRoot":"","sources":["../src/icu-format.ts"],"names":[],"mappings":"AAYA,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;AAExD,qBAAa,SAAS;;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB;IACpC,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;gBAK1B,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;KAAO;IAS1E,+EAA+E;IAC/E,IAAI,IAAI,IAAI;IAIZ,qGAAqG;IACrG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAgBxF,8GAA8G;IAC9G,WAAW,IAAI,MAAM,EAAE;CAGxB"}

package/dist/icu-format.js

@@ -0,0 +1,52 @@
+/**
+ * ICU i18nFormat module for i18next, built directly on intl-messageformat's
+ * NAMED export (10-i18n-theming.md §2.3).
+ *
+ * Replaces `i18next-icu`, whose ESM build does `import IntlMessageFormat from
+ * 'intl-messageformat'` — under Node ESM that default resolves to the CJS
+ * namespace object (not the class), the internal `new` throws, the error is
+ * swallowed, and every message silently renders raw. Owning these ~40 lines
+ * removes the interop landmine and gives us explicit error surfacing.
+ */
+import { IntlMessageFormat } from 'intl-messageformat';
+export class IcuFormat {
+    static type = 'i18nFormat';
+    type = 'i18nFormat';
+    #cache = new Map();
+    #onError;
+    constructor(opts = {}) {
+        this.#onError =
+            opts.onError ??
+                ((key, error) => {
+                    // One structured warning per failure — never throw at render time.
+                    console.warn(`[adminium/i18n] ICU parse failed for "${key}":`, error);
+                });
+    }
+    /** i18next module hook (called by i18next during init; extra args ignored). */
+    init() {
+        /* no service wiring needed */
+    }
+    /** i18next i18nFormat contract: format the resolved resource string (trailing `info` arg unused). */
+    parse(res, options, lng, _ns, key) {
+        if (typeof res !== 'string' || !res.includes('{'))
+            return res;
+        try {
+            const cacheKey = `${lng}\x00${key}\x00${res}`;
+            let message = this.#cache.get(cacheKey);
+            if (message === undefined) {
+                message = new IntlMessageFormat(res, lng, undefined, { ignoreTag: true });
+                this.#cache.set(cacheKey, message);
+            }
+            return String(message.format(options));
+        }
+        catch (error) {
+            this.#onError(key, error);
+            return res;
+        }
+    }
+    /** i18next asks the format plugin whether to add ordinal/plural key suffixes — ICU handles plurals itself. */
+    getSuffixes() {
+        return [];
+    }
+}
+//# sourceMappingURL=icu-format.js.map

package/dist/icu-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icu-format.js","sourceRoot":"","sources":["../src/icu-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,OAAO,SAAS;IACpB,MAAM,CAAU,IAAI,GAAG,YAAY,CAAC;IAC3B,IAAI,GAAG,YAAqB,CAAC;IAEtC,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC9C,QAAQ,CAAwC;IAEhD,YAAY,OAA4D,EAAE;QACxE,IAAI,CAAC,QAAQ;YACX,IAAI,CAAC,OAAO;gBACZ,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;oBACd,mEAAmE;oBACnE,OAAO,CAAC,IAAI,CAAC,yCAAyC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;gBACxE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,+EAA+E;IAC/E,IAAI;QACF,8BAA8B;IAChC,CAAC;IAED,qGAAqG;IACrG,KAAK,CAAC,GAAW,EAAE,OAAqB,EAAE,GAAW,EAAE,GAAW,EAAE,GAAW;QAC7E,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAC9D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,GAAG,GAAG,OAAO,GAAG,OAAO,GAAG,EAAE,CAAC;YAC9C,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,GAAG,IAAI,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAsD,CAAC,CAAC,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1B,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,8GAA8G;IAC9G,WAAW;QACT,OAAO,EAAE,CAAC;IACZ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @adminium/i18n — 8-locale registry, i18next+ICU runtime factory, Intl
+ * formatter layer, RTL utils (workplan/10-i18n-theming.md). Framework-free;
+ * React bindings live in the `@adminium/i18n/react` entry.
+ */
+export declare const PACKAGE_NAME = "@adminium/i18n";
+export { LOCALES, LOCALE_IDS, dirForLocale, isLocaleId, isRtlLocale, localeEntry, localeFromTag, tagForLocale, } from './locales.js';
+export type { LocaleEntry, LocaleId } from './locales.js';
+export { createI18n, switchLocale } from './create-i18n.js';
+export type { BundleLoader, CreateI18nOptions, I18nInstance } from './create-i18n.js';
+export { EN_US_RESOURCES, NAMESPACES } from './resources/index.js';
+export type { Namespace, ResourceBundle } from './resources/index.js';
+export { loadLocaleBundle } from './resources/lazy.js';
+export { getFormatters, latnDataTag, weekInfo } from './format/index.js';
+export type { FmtContext, Formatters, WeekInfo } from './format/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAE7C,OAAO,EACL,OAAO,EACP,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @adminium/i18n — 8-locale registry, i18next+ICU runtime factory, Intl
+ * formatter layer, RTL utils (workplan/10-i18n-theming.md). Framework-free;
+ * React bindings live in the `@adminium/i18n/react` entry.
+ */
+export const PACKAGE_NAME = '@adminium/i18n';
+export { LOCALES, LOCALE_IDS, dirForLocale, isLocaleId, isRtlLocale, localeEntry, localeFromTag, tagForLocale, } from './locales.js';
+export { createI18n, switchLocale } from './create-i18n.js';
+export { EN_US_RESOURCES, NAMESPACES } from './resources/index.js';
+export { loadLocaleBundle } from './resources/lazy.js';
+export { getFormatters, latnDataTag, weekInfo } from './format/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE7C,OAAO,EACL,OAAO,EACP,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}