@c9up/rosetta 0.1.3 → 0.1.5

package/dist/Rosetta.d.ts

@@ -0,0 +1,100 @@
+export type TranslationParams = Record<string, string | number | boolean | Date | null | undefined>;
+export type MessageValue = string | number | boolean | null;
+export type MessageTree = {
+    [key: string]: MessageValue | MessageTree;
+};
+export type MessageCatalog = Record<string, string>;
+export interface TranslateOptions {
+    locale?: string;
+    defaultValue?: string;
+}
+export interface LocaleResolverInput {
+    header?: string | null;
+    accepted?: string[];
+}
+export interface RosettaLoader {
+    load(locale: string): Promise<MessageTree | MessageCatalog | null | undefined>;
+}
+export interface RosettaOptions {
+    defaultLocale?: string;
+    supportedLocales?: string[];
+    fallbackLocale?: string;
+    fallbackLocales?: Record<string, string>;
+    messages?: Record<string, MessageTree | MessageCatalog>;
+    loaders?: RosettaLoader[];
+}
+/**
+ * Numeric separators for a resolved locale. Returned by
+ * `Rosetta.getNumberFormatData()` so consumers (e.g. `@c9up/atom`'s
+ * `Decimal.parseLocale`) can honor Rosetta's `fallbackLocales`
+ * chain when extracting group / decimal separators — without
+ * importing `@c9up/rosetta` directly (structural typing).
+ */
+export interface NumberFormatData {
+    decimal: string;
+    group: string;
+    minus: string;
+    plusSign: string;
+}
+export declare class RosettaLocale {
+    #private;
+    constructor(manager: Rosetta, locale: string);
+    getLocale(): string;
+    has(key: string): boolean;
+    t(key: string, params?: TranslationParams, options?: Omit<TranslateOptions, "locale">): string;
+    formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
+    formatCurrency(value: number, currency: string, options?: Intl.NumberFormatOptions): string;
+    formatDate(value: Date | number | string, options?: Intl.DateTimeFormatOptions): string;
+    formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;
+    getNumberFormatData(): NumberFormatData;
+    formatNumberString(value: string, options?: Intl.NumberFormatOptions): string;
+}
+/**
+ * Rosetta i18n manager.
+ *
+ * Framework-agnostic with request-scoped locale instances.
+ */
+export declare class Rosetta {
+    #private;
+    constructor(options?: RosettaOptions);
+    boot(): Promise<void>;
+    locale(locale: string): RosettaLocale;
+    loadMessages(locale: string, messages: MessageTree | MessageCatalog): this;
+    loadLocale(locale: string): Promise<this>;
+    setLocale(locale: string): this;
+    getLocale(): string;
+    setDefaultLocale(locale: string): this;
+    getDefaultLocale(): string;
+    setSupportedLocales(locales: string[]): this;
+    getSupportedLocales(): string[] | undefined;
+    setFallbackLocale(locale: string): this;
+    getFallbackLocale(): string;
+    setFallbackLocales(locales: Record<string, string>): this;
+    getFallbackLocales(): Record<string, string>;
+    resolveLocale(input: string | LocaleResolverInput): string;
+    has(key: string, locale?: string): boolean;
+    t(key: string, params?: TranslationParams, options?: TranslateOptions): string;
+    formatNumber(value: number, options?: Intl.NumberFormatOptions, locale?: string): string;
+    formatCurrency(value: number, currency: string, options?: Intl.NumberFormatOptions, locale?: string): string;
+    formatDate(value: Date | number | string, options?: Intl.DateTimeFormatOptions, locale?: string): string;
+    formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions, locale?: string): string;
+    /**
+     * Resolve the numeric separators for `locale`, honoring the
+     * configured `fallbackLocales` chain. Returns the first locale
+     * in the chain that `Intl.NumberFormat` actually supports.
+     *
+     * Cached per resolved locale so the `formatToParts` work runs
+     * once per chain destination.
+     */
+    getNumberFormatData(locale?: string): NumberFormatData;
+    /**
+     * Format a string-valued number through `Intl.NumberFormat`'s
+     * string-accepting overload — preserves precision on 18+-digit
+     * values that would otherwise truncate via `Number()`.
+     *
+     * Locale resolution uses the same fallback chain as
+     * `getNumberFormatData`.
+     */
+    formatNumberString(value: string, options?: Intl.NumberFormatOptions, locale?: string): string;
+}
+//# sourceMappingURL=Rosetta.d.ts.map

package/dist/Rosetta.d.ts.map

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

package/dist/Rosetta.js

@@ -0,0 +1,381 @@
+import { createNativeEngine } from "./native.js";
+const DEFAULT_LOCALE = "en";
+export class RosettaLocale {
+    #manager;
+    #locale;
+    constructor(manager, locale) {
+        this.#manager = manager;
+        this.#locale = locale;
+    }
+    getLocale() {
+        return this.#locale;
+    }
+    has(key) {
+        return this.#manager.has(key, this.#locale);
+    }
+    t(key, params, options) {
+        return this.#manager.t(key, params, { ...options, locale: this.#locale });
+    }
+    formatNumber(value, options) {
+        return this.#manager.formatNumber(value, options, this.#locale);
+    }
+    formatCurrency(value, currency, options) {
+        return this.#manager.formatCurrency(value, currency, options, this.#locale);
+    }
+    formatDate(value, options) {
+        return this.#manager.formatDate(value, options, this.#locale);
+    }
+    formatRelativeTime(value, unit, options) {
+        return this.#manager.formatRelativeTime(value, unit, options, this.#locale);
+    }
+    getNumberFormatData() {
+        return this.#manager.getNumberFormatData(this.#locale);
+    }
+    formatNumberString(value, options) {
+        return this.#manager.formatNumberString(value, options, this.#locale);
+    }
+}
+/**
+ * Rosetta i18n manager.
+ *
+ * Framework-agnostic with request-scoped locale instances.
+ */
+export class Rosetta {
+    #messages = new Map();
+    #catalogsCache;
+    #catalogsCacheDirty = true;
+    /** Stateful Rust engine (Story 37.9) — holds parsed catalogs in Rust memory. */
+    #nativeEngine = createNativeEngine();
+    #locale;
+    #defaultLocale;
+    #fallbackLocale;
+    #fallbackLocales;
+    #supportedLocales;
+    #loaders;
+    #numberFormatDataCache = new Map();
+    constructor(options = {}) {
+        this.#defaultLocale = normalizeLocale(options.defaultLocale ?? DEFAULT_LOCALE);
+        this.#locale = this.#defaultLocale;
+        this.#fallbackLocale = normalizeLocale(options.fallbackLocale ?? this.#defaultLocale);
+        this.#fallbackLocales = normalizeFallbackMap(options.fallbackLocales ?? {});
+        this.#supportedLocales = options.supportedLocales
+            ? new Set(options.supportedLocales.map(normalizeLocale))
+            : undefined;
+        this.#loaders = options.loaders ?? [];
+        if (options.messages) {
+            for (const [locale, catalog] of Object.entries(options.messages)) {
+                this.loadMessages(locale, catalog);
+            }
+        }
+    }
+    async boot() {
+        if (!this.#supportedLocales || this.#loaders.length === 0) {
+            return;
+        }
+        for (const locale of this.#supportedLocales) {
+            await this.#loadFromLoaders(locale);
+        }
+    }
+    locale(locale) {
+        return new RosettaLocale(this, normalizeLocale(locale));
+    }
+    loadMessages(locale, messages) {
+        const normalizedLocale = normalizeLocale(locale);
+        const existing = this.#messages.get(normalizedLocale) ?? {};
+        const flattened = flattenMessages(messages);
+        this.#messages.set(normalizedLocale, { ...existing, ...flattened });
+        this.#catalogsCacheDirty = true;
+        return this;
+    }
+    async loadLocale(locale) {
+        await this.#loadFromLoaders(normalizeLocale(locale));
+        return this;
+    }
+    setLocale(locale) {
+        this.#locale = normalizeLocale(locale);
+        return this;
+    }
+    getLocale() {
+        return this.#locale;
+    }
+    setDefaultLocale(locale) {
+        this.#defaultLocale = normalizeLocale(locale);
+        // Invalidate the number-format-data cache: even though the
+        // cache is keyed by the *resolved* locale (so most entries
+        // stay correct across config changes), an entry produced by
+        // the previous "ultimate fallback" path may now mismatch.
+        this.#numberFormatDataCache.clear();
+        return this;
+    }
+    getDefaultLocale() {
+        return this.#defaultLocale;
+    }
+    setSupportedLocales(locales) {
+        this.#supportedLocales = new Set(locales.map(normalizeLocale));
+        return this;
+    }
+    getSupportedLocales() {
+        return this.#supportedLocales
+            ? Array.from(this.#supportedLocales)
+            : undefined;
+    }
+    setFallbackLocale(locale) {
+        this.#fallbackLocale = normalizeLocale(locale);
+        this.#numberFormatDataCache.clear();
+        return this;
+    }
+    getFallbackLocale() {
+        return this.#fallbackLocale;
+    }
+    setFallbackLocales(locales) {
+        this.#fallbackLocales = normalizeFallbackMap(locales);
+        this.#numberFormatDataCache.clear();
+        return this;
+    }
+    getFallbackLocales() {
+        return { ...this.#fallbackLocales };
+    }
+    resolveLocale(input) {
+        const requested = typeof input === "string"
+            ? parseAcceptLanguage(input)
+            : (input.accepted ?? parseAcceptLanguage(input.header ?? ""));
+        for (const candidate of requested) {
+            const normalized = normalizeLocale(candidate);
+            const supported = this.#pickFirstSupported(this.#localeChainFor(normalized));
+            if (supported) {
+                return supported;
+            }
+        }
+        const fallback = this.#pickFirstSupported(this.#localeChainFor(this.#defaultLocale));
+        return fallback ?? this.#defaultLocale;
+    }
+    has(key, locale = this.#locale) {
+        const normalizedLocale = normalizeLocale(locale);
+        const chain = this.#localeChainFor(normalizedLocale);
+        if (!this.#nativeEngine) {
+            throw new Error("[ROSETTA_NAPI_REQUIRED] The Rust ICU engine is required. Build it with `cd packages/rosetta && pnpm build:napi`.");
+        }
+        this.#syncNativeEngine();
+        return this.#nativeEngine.has(key, JSON.stringify(chain));
+    }
+    t(key, params, options) {
+        const requestedLocale = normalizeLocale(options?.locale ?? this.#locale);
+        const chain = this.#localeChainFor(requestedLocale);
+        if (!this.#nativeEngine) {
+            throw new Error("[ROSETTA_NAPI_REQUIRED] The Rust ICU engine is required. Build it with `cd packages/rosetta && pnpm build:napi`.");
+        }
+        this.#syncNativeEngine();
+        // `bigint` makes a plain `JSON.stringify` THROW, crashing `t()` — serialise
+        // it as its decimal string so it survives the boundary and renders/pluralises
+        // correctly (RO7). `Date` already serialises to an ISO string via `toJSON`,
+        // which the engine's date/time formatter now slices.
+        const paramsJson = params
+            ? JSON.stringify(params, (_k, v) => typeof v === "bigint" ? v.toString() : v)
+            : undefined;
+        return this.#nativeEngine.translate(key, paramsJson, JSON.stringify(chain), options?.defaultValue);
+    }
+    formatNumber(value, options, locale = this.#locale) {
+        return new Intl.NumberFormat(normalizeLocale(locale), options).format(value);
+    }
+    formatCurrency(value, currency, options, locale = this.#locale) {
+        // Spread `options` FIRST so explicit `style: "currency"` and
+        // `currency` always win — a caller's stray `{ style: "decimal" }`
+        // must not silently disable currency formatting.
+        return this.formatNumber(value, { ...options, style: "currency", currency }, locale);
+    }
+    formatDate(value, options, locale = this.#locale) {
+        const date = value instanceof Date ? value : new Date(value);
+        return new Intl.DateTimeFormat(normalizeLocale(locale), options).format(date);
+    }
+    formatRelativeTime(value, unit, options, locale = this.#locale) {
+        return new Intl.RelativeTimeFormat(normalizeLocale(locale), options).format(value, unit);
+    }
+    /**
+     * Resolve the numeric separators for `locale`, honoring the
+     * configured `fallbackLocales` chain. Returns the first locale
+     * in the chain that `Intl.NumberFormat` actually supports.
+     *
+     * Cached per resolved locale so the `formatToParts` work runs
+     * once per chain destination.
+     */
+    getNumberFormatData(locale = this.#locale) {
+        const resolved = this.#resolveNumberLocale(locale);
+        const cached = this.#numberFormatDataCache.get(resolved);
+        if (cached)
+            return cached;
+        const formatter = new Intl.NumberFormat(resolved);
+        const negativeParts = formatter.formatToParts(-12345.6);
+        const positiveParts = new Intl.NumberFormat(resolved, {
+            signDisplay: "always",
+        }).formatToParts(1);
+        const data = {
+            decimal: negativeParts.find((p) => p.type === "decimal")?.value ?? ".",
+            group: negativeParts.find((p) => p.type === "group")?.value ?? ",",
+            minus: negativeParts.find((p) => p.type === "minusSign")?.value ?? "-",
+            plusSign: positiveParts.find((p) => p.type === "plusSign")?.value ?? "+",
+        };
+        this.#numberFormatDataCache.set(resolved, data);
+        return data;
+    }
+    /**
+     * Format a string-valued number through `Intl.NumberFormat`'s
+     * string-accepting overload — preserves precision on 18+-digit
+     * values that would otherwise truncate via `Number()`.
+     *
+     * Locale resolution uses the same fallback chain as
+     * `getNumberFormatData`.
+     */
+    formatNumberString(value, options, locale = this.#locale) {
+        const resolved = this.#resolveNumberLocale(locale);
+        const formatter = new Intl.NumberFormat(resolved, options);
+        return formatter.format(value);
+    }
+    #resolveNumberLocale(locale) {
+        const chain = this.#localeChainFor(normalizeLocale(locale));
+        for (const candidate of chain) {
+            const supported = Intl.NumberFormat.supportedLocalesOf([candidate], {
+                localeMatcher: "lookup",
+            });
+            if (supported.length > 0)
+                return supported[0];
+        }
+        // Last-resort: the configured #defaultLocale itself may not be
+        // Intl-supported (e.g. an invented private-use tag). Validate
+        // it once so the cache key is always a real Intl locale.
+        const defaultSupported = Intl.NumberFormat.supportedLocalesOf([this.#defaultLocale], { localeMatcher: "lookup" });
+        if (defaultSupported.length > 0)
+            return defaultSupported[0];
+        // Truly unresolvable — fall back to "en", which every Intl
+        // implementation must support per ECMA-402.
+        return "en";
+    }
+    async #loadFromLoaders(locale) {
+        for (const loader of this.#loaders) {
+            const messages = await loader.load(locale);
+            if (messages) {
+                this.loadMessages(locale, messages);
+            }
+        }
+    }
+    #pickFirstSupported(candidates) {
+        if (!this.#supportedLocales) {
+            return candidates[0];
+        }
+        return candidates.find((candidate) => this.#supportedLocales?.has(candidate));
+    }
+    #localeChainFor(locale) {
+        const chain = [];
+        const visited = new Set();
+        const push = (value) => {
+            const normalized = normalizeLocale(value);
+            if (!normalized || visited.has(normalized))
+                return;
+            visited.add(normalized);
+            chain.push(normalized);
+        };
+        push(locale);
+        const localeParts = locale.split("-");
+        if (localeParts.length > 1) {
+            push(localeParts[0]);
+        }
+        const explicitFallback = this.#fallbackLocales[locale];
+        if (explicitFallback) {
+            push(explicitFallback);
+            const explicitParts = explicitFallback.split("-");
+            if (explicitParts.length > 1) {
+                push(explicitParts[0]);
+            }
+        }
+        push(this.#fallbackLocale);
+        const fallbackParts = this.#fallbackLocale.split("-");
+        if (fallbackParts.length > 1) {
+            push(fallbackParts[0]);
+        }
+        push(this.#defaultLocale);
+        const defaultParts = this.#defaultLocale.split("-");
+        if (defaultParts.length > 1) {
+            push(defaultParts[0]);
+        }
+        return chain;
+    }
+    /**
+     * Sync the Rust-resident catalog with the TS-side `#messages` map. Only
+     * performs JSON.stringify when the dirty flag is set (a locale was loaded or
+     * edited). On subsequent `t()` / `has()` calls with no changes, this is a
+     * no-op — the Rust engine already holds the parsed catalog in memory.
+     *
+     * Story 37.9: this replaces the old `#catalogsJson()` which serialized the
+     * entire catalog on EVERY `t()` call.
+     */
+    #syncNativeEngine() {
+        if (!this.#nativeEngine)
+            return;
+        if (!this.#catalogsCacheDirty && this.#catalogsCache)
+            return;
+        const cache = {};
+        for (const [locale, catalog] of this.#messages.entries()) {
+            cache[locale] = catalog;
+        }
+        // loadCatalogs may throw (malformed JSON, lock poisoned). The dirty flag
+        // is only cleared AFTER a successful load so a retry on the next t()
+        // call re-attempts instead of silently using a stale/empty catalog.
+        this.#nativeEngine.loadCatalogs(JSON.stringify(cache));
+        this.#catalogsCache = cache;
+        this.#catalogsCacheDirty = false;
+    }
+}
+function normalizeLocale(locale) {
+    return locale.trim().replace(/_/g, "-").toLowerCase();
+}
+function normalizeFallbackMap(map) {
+    const normalized = {};
+    for (const [from, to] of Object.entries(map)) {
+        normalized[normalizeLocale(from)] = normalizeLocale(to);
+    }
+    return normalized;
+}
+function parseAcceptLanguage(header) {
+    return header
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean)
+        .map((item) => {
+        const [localePart, ...rest] = item.split(";");
+        let quality = 1;
+        for (const part of rest) {
+            const trimmed = part.trim();
+            if (trimmed.startsWith("q=")) {
+                const n = Number(trimmed.slice(2));
+                if (Number.isFinite(n))
+                    quality = n;
+            }
+        }
+        return { locale: normalizeLocale(localePart), quality };
+    })
+        .filter((entry) => entry.locale.length > 0)
+        .sort((a, b) => b.quality - a.quality)
+        .map((entry) => entry.locale);
+}
+function flattenMessages(messages) {
+    const out = {};
+    walkFlatten("", messages, out);
+    return out;
+}
+function walkFlatten(prefix, value, out) {
+    if (typeof value === "string") {
+        out[prefix] = value;
+        return;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        out[prefix] = String(value);
+        return;
+    }
+    if (value === null || value === undefined) {
+        return;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        const next = prefix ? `${prefix}.${key}` : key;
+        walkFlatten(next, child, out);
+    }
+}
+//# sourceMappingURL=Rosetta.js.map

package/dist/Rosetta.js.map

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

package/dist/RosettaProvider.d.ts

@@ -0,0 +1,55 @@
+import { type RosettaOptions } from "./Rosetta.js";
+/**
+ * Duck-typed host context — rosetta stays publishable without
+ * importing `@c9up/ream`. Any framework that exposes a Container + a
+ * config store satisfies the contract.
+ */
+interface RosettaContainer {
+    singleton(token: unknown, factory: () => unknown): void;
+    resolve<T = unknown>(token: unknown): T;
+}
+interface RosettaConfigStore {
+    get<T = unknown>(key: string): T | undefined;
+}
+export interface RosettaAppContext {
+    container: RosettaContainer;
+    config: RosettaConfigStore;
+}
+export interface RosettaProviderConfig extends RosettaOptions {
+    /**
+     * If set, a `FileSystemLoader` reading from this directory is
+     * appended to `options.loaders`. Most apps only need this and the
+     * `supportedLocales` list — the provider's `boot()` calls
+     * `rosetta.boot()` so catalogs are warm before the first request.
+     */
+    rootDir?: string;
+}
+/**
+ * RosettaProvider — registers a shared `Rosetta` instance under
+ * `Rosetta` + `"i18n"` tokens, then awaits its boot so the configured
+ * locale catalogs are loaded by the time the first request lands.
+ *
+ *   // reamrc.ts
+ *   providers: [() => import('@c9up/rosetta/provider')]
+ *
+ *   // config/i18n.ts
+ *   import { resolve } from 'node:path'
+ *   export default {
+ *     defaultLocale: 'en',
+ *     supportedLocales: ['en', 'fr'],
+ *     rootDir: resolve('./resources/lang'),
+ *   }
+ *
+ *   // anywhere
+ *   import i18n from '@c9up/rosetta/services/main'
+ *   const t = i18n.locale('fr').t('greeting', { name: 'Alice' })
+ */
+export default class RosettaProvider {
+    protected app: RosettaAppContext;
+    constructor(app: RosettaAppContext);
+    register(): void;
+    boot(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=RosettaProvider.d.ts.map

package/dist/RosettaProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RosettaProvider.d.ts","sourceRoot":"","sources":["../src/RosettaProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAG5D;;;;GAIG;AACH,UAAU,gBAAgB;IACzB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CACxC;AACD,UAAU,kBAAkB;IAC3B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AACD,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC5D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IACvB,SAAS,CAAC,GAAG,EAAE,iBAAiB;gBAAtB,GAAG,EAAE,iBAAiB;IAE5C,QAAQ,IAAI,IAAI;IAeV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAC/B"}

package/dist/RosettaProvider.js

@@ -0,0 +1,48 @@
+import { FileSystemLoader } from "./loaders/FileSystemLoader.js";
+import { Rosetta } from "./Rosetta.js";
+import { setI18n } from "./services/main.js";
+/**
+ * RosettaProvider — registers a shared `Rosetta` instance under
+ * `Rosetta` + `"i18n"` tokens, then awaits its boot so the configured
+ * locale catalogs are loaded by the time the first request lands.
+ *
+ *   // reamrc.ts
+ *   providers: [() => import('@c9up/rosetta/provider')]
+ *
+ *   // config/i18n.ts
+ *   import { resolve } from 'node:path'
+ *   export default {
+ *     defaultLocale: 'en',
+ *     supportedLocales: ['en', 'fr'],
+ *     rootDir: resolve('./resources/lang'),
+ *   }
+ *
+ *   // anywhere
+ *   import i18n from '@c9up/rosetta/services/main'
+ *   const t = i18n.locale('fr').t('greeting', { name: 'Alice' })
+ */
+export default class RosettaProvider {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    register() {
+        this.app.container.singleton(Rosetta, () => {
+            const config = this.app.config.get("i18n");
+            const options = { ...(config ?? {}) };
+            if (config?.rootDir) {
+                const fsLoader = new FileSystemLoader({ rootDir: config.rootDir });
+                options.loaders = [...(options.loaders ?? []), fsLoader];
+            }
+            return new Rosetta(options);
+        });
+        this.app.container.singleton("i18n", () => this.app.container.resolve(Rosetta));
+    }
+    async boot() {
+        const rosetta = this.app.container.resolve(Rosetta);
+        await rosetta.boot();
+        setI18n(rosetta);
+    }
+    async shutdown() { }
+}
+//# sourceMappingURL=RosettaProvider.js.map

package/dist/RosettaProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RosettaProvider.js","sourceRoot":"","sources":["../src/RosettaProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAuB,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA6B7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IACb;IAAtB,YAAsB,GAAsB;QAAtB,QAAG,GAAH,GAAG,CAAmB;IAAG,CAAC;IAEhD,QAAQ;QACP,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAwB,MAAM,CAAC,CAAC;YAClE,MAAM,OAAO,GAAmB,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;YACtD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACrB,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;gBACnE,OAAO,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CACzC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAU,OAAO,CAAC,CAC5C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAU,OAAO,CAAC,CAAC;QAC7D,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,QAAQ,KAAmB,CAAC;CAClC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @c9up/rosetta — framework-agnostic internationalization module.
+ */
+export type { FileSystemLoaderOptions } from "./loaders/FileSystemLoader.js";
+export { FileSystemLoader } from "./loaders/FileSystemLoader.js";
+export { isNativeAvailable } from "./native.js";
+export type { LocaleResolverInput, MessageCatalog, MessageTree, NumberFormatData, RosettaLoader, RosettaLocale, RosettaOptions, TranslateOptions, TranslationParams, } from "./Rosetta.js";
+export { Rosetta } from "./Rosetta.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;;GAEG;AAEH,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EACX,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * @c9up/rosetta — framework-agnostic internationalization module.
+ */
+export { FileSystemLoader } from "./loaders/FileSystemLoader.js";
+export { isNativeAvailable } from "./native.js";
+export { Rosetta } from "./Rosetta.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;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAYhD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/loaders/FileSystemLoader.d.ts

@@ -0,0 +1,10 @@
+import type { MessageCatalog, MessageTree, RosettaLoader } from "../Rosetta.js";
+export interface FileSystemLoaderOptions {
+    rootDir: string;
+}
+export declare class FileSystemLoader implements RosettaLoader {
+    #private;
+    constructor(options: FileSystemLoaderOptions);
+    load(locale: string): Promise<MessageTree | MessageCatalog | null>;
+}
+//# sourceMappingURL=FileSystemLoader.d.ts.map

package/dist/loaders/FileSystemLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemLoader.d.ts","sourceRoot":"","sources":["../../src/loaders/FileSystemLoader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKhF,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAiB,YAAW,aAAa;;gBAGzC,OAAO,EAAE,uBAAuB;IAItC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,cAAc,GAAG,IAAI,CAAC;CA6BxE"}

package/dist/loaders/FileSystemLoader.js

@@ -0,0 +1,175 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+/** IANA BCP 47 locale ID pattern — allows `en`, `en-US`, `zh-Hant-TW`, etc. */
+const SAFE_LOCALE_PATTERN = /^[a-zA-Z]{2,8}(-[a-zA-Z0-9]{2,8})*$/;
+export class FileSystemLoader {
+    #rootDir;
+    constructor(options) {
+        this.#rootDir = options.rootDir;
+    }
+    async load(locale) {
+        // Validate locale to prevent path traversal. A locale like
+        // `../../etc/passwd` would escape the rootDir without this check.
+        if (!SAFE_LOCALE_PATTERN.test(locale))
+            return null;
+        for (const ext of ["json", "yaml", "yml"]) {
+            const fullPath = path.join(this.#rootDir, `${locale}.${ext}`);
+            // Defense-in-depth: verify the resolved path is still inside rootDir
+            // even after the regex check (belt + suspenders).
+            if (!path.resolve(fullPath).startsWith(path.resolve(this.#rootDir)))
+                return null;
+            try {
+                const raw = await fsp.readFile(fullPath, "utf8");
+                return ext === "json"
+                    ? JSON.parse(raw)
+                    : parseYaml(raw);
+            }
+            catch (err) {
+                // ENOENT = file doesn't exist → try next extension. Any other error
+                // (permission denied, invalid JSON, disk failure) is a real problem
+                // that must surface — silently swallowing it would turn a config bug
+                // into a "missing translation" ghost that's impossible to debug in prod.
+                const code = err?.code;
+                if (code === "ENOENT")
+                    continue;
+                throw err;
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Minimal YAML parser for locale files. Supports:
+ * - Nested keys via indentation
+ * - Quoted and unquoted scalar values
+ * - Colons in values (URLs like `https://example.com`)
+ * - Multiline block scalars: `|` (literal) and `>` (folded)
+ * - Comments (`#`)
+ *
+ * Does NOT support: anchors/aliases (`&`/`*`), flow sequences (`[a, b]`),
+ * flow mappings (`{a: 1}`), complex keys, merge keys (`<<`), or tags (`!!`).
+ * For production apps with complex locale files, replace with `js-yaml`.
+ */
+function parseYaml(input) {
+    const root = {};
+    const stack = [
+        { indent: -1, node: root },
+    ];
+    const lines = input.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length) {
+        const rawLine = lines[i];
+        i++;
+        if (!rawLine.trim() || rawLine.trim().startsWith("#"))
+            continue;
+        // Match `key:` with an optional value. The key stops at the first unquoted
+        // colon that is NOT inside a URL scheme (`://`). We use a simpler heuristic:
+        // split on the first `:` followed by a space or end-of-line. This correctly
+        // handles `url: https://example.com` because the `: ` after `url` is the
+        // first split point, and `://` inside the value has no preceding space.
+        const match = rawLine.match(/^(\s*)([^:#\s][^:]*?)\s*:\s*(.*)$/);
+        if (!match)
+            continue;
+        const indent = match[1].length;
+        const key = match[2].trim();
+        let valueRaw = match[3].trim();
+        while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+            stack.pop();
+        }
+        const parent = stack[stack.length - 1].node;
+        // Block scalar: `|` (literal) or `>` (folded).
+        if (valueRaw === "|" || valueRaw === ">") {
+            const block = parseBlockScalar(lines, i, indent, valueRaw === ">");
+            parent[key] = block.value;
+            i = block.nextIndex;
+            continue;
+        }
+        if (!valueRaw) {
+            const child = {};
+            parent[key] = child;
+            stack.push({ indent, node: child });
+            continue;
+        }
+        // Strip inline comments: `value # comment` → `value`. But only if the `#`
+        // is preceded by whitespace (to avoid stripping inside URLs like `#fragment`).
+        const commentIdx = valueRaw.search(/\s+#/);
+        if (commentIdx > 0)
+            valueRaw = valueRaw.slice(0, commentIdx).trim();
+        parent[key] = parseScalar(valueRaw);
+    }
+    return root;
+}
+/**
+ * Consume a `|` (literal) or `>` (folded) block scalar starting at `startIndex`.
+ * Returns the joined value and the index of the first line past the block.
+ */
+function parseBlockScalar(lines, startIndex, indent, fold) {
+    const blockLines = [];
+    const blockIndent = indent + 2;
+    let i = startIndex;
+    while (i < lines.length) {
+        const bl = lines[i];
+        // A line with less indent (or empty after content) ends the block.
+        if (bl.trim() && bl.search(/\S/) < blockIndent)
+            break;
+        blockLines.push(bl.slice(blockIndent) || "");
+        i++;
+    }
+    // Trim trailing empty lines.
+    while (blockLines.length > 0 && blockLines[blockLines.length - 1] === "") {
+        blockLines.pop();
+    }
+    return {
+        value: fold ? foldParagraphs(blockLines) : blockLines.join("\n"),
+        nextIndex: i,
+    };
+}
+/**
+ * Fold a `>` block scalar: consecutive non-blank lines join with a space, blank
+ * lines become hard newlines (paragraph breaks per the YAML spec).
+ */
+function foldParagraphs(blockLines) {
+    const paragraphs = [];
+    let current = [];
+    for (const bl of blockLines) {
+        if (bl === "") {
+            if (current.length > 0)
+                paragraphs.push(current.join(" "));
+            current = [];
+            paragraphs.push("");
+        }
+        else {
+            current.push(bl);
+        }
+    }
+    if (current.length > 0)
+        paragraphs.push(current.join(" "));
+    return paragraphs.join("\n");
+}
+function parseScalar(value) {
+    if (value.startsWith('"') && value.endsWith('"')) {
+        // Double-quoted: process YAML escape sequences (\n, \t, \\, \', \")
+        return value
+            .slice(1, -1)
+            .replace(/\\n/g, "\n")
+            .replace(/\\t/g, "\t")
+            .replace(/\\\\/g, "\\")
+            .replace(/\\'/g, "'")
+            .replace(/\\"/g, '"');
+    }
+    if (value.startsWith("'") && value.endsWith("'")) {
+        // Single-quoted: only '' escape (doubled apostrophe → single)
+        return value.slice(1, -1).replace(/''/g, "'");
+    }
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    if (value === "null")
+        return null;
+    const n = Number(value);
+    if (Number.isFinite(n) && value !== "")
+        return n;
+    return value;
+}
+//# sourceMappingURL=FileSystemLoader.js.map

package/dist/loaders/FileSystemLoader.js.map

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

package/dist/native.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Universal engine loader — auto-detects Node (NAPI) vs Browser (WASM).
+ *
+ * Node gets the stateful `RosettaEngine` class (resident catalog in Rust memory).
+ * Browser gets the stateless WASM functions (re-parse catalog per call — acceptable
+ * because browser apps typically have smaller catalogs than server-rendered i18n).
+ */
+export interface NativeRosettaEngine {
+    loadCatalogs(catalogsJson: string): void;
+    translate(key: string, paramsJson: string | undefined, chainJson: string, defaultValue: string | undefined): string;
+    has(key: string, chainJson: string): boolean;
+}
+export declare function isNativeAvailable(): boolean;
+/** Create a stateful engine (Node NAPI only). Returns null in browser (WASM is stateless). */
+export declare function createNativeEngine(): NativeRosettaEngine | null;
+export declare function nativeTranslate(catalogsJson: string, key: string, paramsJson: string | undefined, chainJson: string, defaultValue: string | undefined): string;
+export declare function nativeHas(catalogsJson: string, key: string, chainJson: string): boolean;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,mBAAmB;IACnC,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,SAAS,CACR,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,CAAC;IACV,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C;AAuED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,IAAI,mBAAmB,GAAG,IAAI,CAwB/D;AAGD,wBAAgB,eAAe,CAC9B,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,CAqBR;AAED,wBAAgB,SAAS,CACxB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GACf,OAAO,CAQT"}

package/dist/native.js

@@ -0,0 +1,89 @@
+/**
+ * Universal engine loader — auto-detects Node (NAPI) vs Browser (WASM).
+ *
+ * Node gets the stateful `RosettaEngine` class (resident catalog in Rust memory).
+ * Browser gets the stateless WASM functions (re-parse catalog per call — acceptable
+ * because browser apps typically have smaller catalogs than server-rendered i18n).
+ */
+let native;
+let wasmModule;
+let loadError;
+const isNode = typeof globalThis.process !== "undefined" &&
+    typeof globalThis.process.versions?.node === "string";
+if (isNode) {
+    try {
+        const { createRequire } = await import("node:module");
+        const { dirname, join } = await import("node:path");
+        const { fileURLToPath } = await import("node:url");
+        const { arch, platform } = await import("node:process");
+        const nodeRequire = createRequire(import.meta.url);
+        const currentDir = dirname(fileURLToPath(import.meta.url));
+        const platformMap = {
+            "linux-x64": "linux-x64-gnu",
+            "linux-arm64": "linux-arm64-gnu",
+            "darwin-x64": "darwin-x64",
+            "darwin-arm64": "darwin-arm64",
+            "win32-x64": "win32-x64-msvc",
+        };
+        const suffix = platformMap[`${platform}-${arch}`];
+        if (suffix) {
+            native = nodeRequire(join(currentDir, `../index.${suffix}.node`));
+        }
+    }
+    catch (e) {
+        loadError = e;
+    }
+}
+else {
+    try {
+        // The WASM glue generated by wasm-pack exports `translate` and `has` as
+        // top-level functions with the exact same signatures as `WasmStatelessApi`.
+        // We declare the import shape explicitly so no cast is needed.
+        const wasm = await import("../wasm/rosetta_engine_wasm.js");
+        await wasm.default();
+        wasmModule = wasm;
+    }
+    catch (e) {
+        loadError = e;
+    }
+}
+export function isNativeAvailable() {
+    return native !== undefined || wasmModule !== undefined;
+}
+/** Create a stateful engine (Node NAPI only). Returns null in browser (WASM is stateless). */
+export function createNativeEngine() {
+    if (!native) {
+        if (!wasmModule)
+            return null;
+        const wasm = wasmModule;
+        let catalogsJson = "{}";
+        return {
+            loadCatalogs(json) {
+                catalogsJson = json;
+            },
+            translate(key, paramsJson, chainJson, defaultValue) {
+                return wasm.translate(catalogsJson, key, paramsJson ?? undefined, chainJson, defaultValue ?? undefined);
+            },
+            has(key, chainJson) {
+                return wasm.has(catalogsJson, key, chainJson);
+            },
+        };
+    }
+    return new native.RosettaEngine();
+}
+// Legacy stateless exports (used by tests)
+export function nativeTranslate(catalogsJson, key, paramsJson, chainJson, defaultValue) {
+    if (native)
+        return native.translate(catalogsJson, key, paramsJson, chainJson, defaultValue);
+    if (wasmModule)
+        return wasmModule.translate(catalogsJson, key, paramsJson, chainJson, defaultValue);
+    throw new Error(`[ROSETTA_ENGINE_NOT_FOUND] ${loadError ?? "binary not found"}`, { cause: loadError });
+}
+export function nativeHas(catalogsJson, key, chainJson) {
+    if (native)
+        return native.has(catalogsJson, key, chainJson);
+    if (wasmModule)
+        return wasmModule.has(catalogsJson, key, chainJson);
+    throw new Error(`[ROSETTA_ENGINE_NOT_FOUND] ${loadError ?? "binary not found"}`, { cause: loadError });
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

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

package/dist/services/main.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Default `Rosetta` singleton — mirror of Adonis's
+ * `import i18n from '@adonisjs/i18n/services/main'` shape.
+ *
+ *   import i18n from '@c9up/rosetta/services/main'
+ *
+ *   const locale = i18n.locale(i18n.resolveLocale({ header: req.headers['accept-language'] }))
+ *   locale.t('greeting', { name: user.name })
+ *
+ * Populated by `RosettaProvider.boot()` or by the app directly through
+ * `setI18n(myRosetta)` when the i18n config has to be built outside
+ * the provider flow.
+ */
+import type { Rosetta } from "../Rosetta.js";
+/** @internal Bind the singleton (called by RosettaProvider or the app). */
+export declare function setI18n(value: Rosetta): void;
+/** @internal Read the singleton (or `undefined` pre-boot). */
+export declare function getI18n(): Rosetta | undefined;
+declare const i18n: Rosetta;
+export default i18n;
+//# sourceMappingURL=main.d.ts.map

package/dist/services/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE5C;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,IAAI,OAAO,GAAG,SAAS,CAE7C;AAED,QAAA,MAAM,IAAI,EAAE,OAWV,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/services/main.js

@@ -0,0 +1,34 @@
+/**
+ * Default `Rosetta` singleton — mirror of Adonis's
+ * `import i18n from '@adonisjs/i18n/services/main'` shape.
+ *
+ *   import i18n from '@c9up/rosetta/services/main'
+ *
+ *   const locale = i18n.locale(i18n.resolveLocale({ header: req.headers['accept-language'] }))
+ *   locale.t('greeting', { name: user.name })
+ *
+ * Populated by `RosettaProvider.boot()` or by the app directly through
+ * `setI18n(myRosetta)` when the i18n config has to be built outside
+ * the provider flow.
+ */
+let instance;
+/** @internal Bind the singleton (called by RosettaProvider or the app). */
+export function setI18n(value) {
+    instance = value;
+}
+/** @internal Read the singleton (or `undefined` pre-boot). */
+export function getI18n() {
+    return instance;
+}
+const i18n = new Proxy({}, {
+    get(_target, prop) {
+        if (!instance) {
+            throw new Error("[rosetta] Rosetta singleton accessed before RosettaProvider.boot() ran " +
+                "or `setI18n(myRosetta)` was called. Wire one of them first.");
+        }
+        const value = Reflect.get(instance, prop, instance);
+        return typeof value === "function" ? value.bind(instance) : value;
+    },
+});
+export default i18n;
+//# sourceMappingURL=main.js.map

package/dist/services/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,IAAI,QAA6B,CAAC;AAElC,2EAA2E;AAC3E,MAAM,UAAU,OAAO,CAAC,KAAc;IACrC,QAAQ,GAAG,KAAK,CAAC;AAClB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,OAAO;IACtB,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,IAAI,GAAY,IAAI,KAAK,CAAC,EAAa,EAAE;IAC9C,GAAG,CAAC,OAAO,EAAE,IAAI;QAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,yEAAyE;gBACxE,6DAA6D,CAC9D,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/rosetta",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Rosetta — dedicated i18n module for the Ream ecosystem",
   "license": "MIT",
   "type": "module",

package/src/Rosetta.ts

@@ -287,7 +287,15 @@ export class Rosetta {
 			);
 		}
 		this.#syncNativeEngine();
-		const paramsJson = params ? JSON.stringify(params) : undefined;
+		// `bigint` makes a plain `JSON.stringify` THROW, crashing `t()` — serialise
+		// it as its decimal string so it survives the boundary and renders/pluralises
+		// correctly (RO7). `Date` already serialises to an ISO string via `toJSON`,
+		// which the engine's date/time formatter now slices.
+		const paramsJson = params
+			? JSON.stringify(params, (_k, v) =>
+					typeof v === "bigint" ? v.toString() : v,
+				)
+			: undefined;
 		return this.#nativeEngine.translate(
 			key,
 			paramsJson,