@vielzeug/i18nit 1.1.3 → 1.2.0

package/dist/index.d.ts

@@ -1,15 +1,13 @@
 export declare function createI18n(config?: I18nConfig): I18n;
 
-declare class I18n {
+export declare class I18n {
     private locale;
     private fallbacks;
+    private escape;
     private catalogs;
     private loaders;
     private loading;
     private subscribers;
-    private escape;
-    private missingKey;
-    private missingVar;
     constructor(config?: I18nConfig);
     setLocale(locale: Locale): void;
     getLocale(): Locale;
@@ -25,25 +23,30 @@ declare class I18n {
     hasLocale(locale: Locale): boolean;
     has(key: string, locale?: Locale): boolean;
     load(locale: Locale): Promise<void>;
-    register(locale: Locale, loader: () => Promise<Messages>): void;
+    register(locale: Locale, loader: (locale: Locale) => Promise<Messages>): void;
     hasAsync(key: string, locale?: Locale): Promise<boolean>;
     /**
-     * Translates a key with optional variables.
+     * Load multiple locales in parallel.
+     * Useful for preloading all needed locales at app startup.
      */
-    t(key: string, vars?: Record<string, unknown>, options?: TranslateOptions): string;
+    loadAll(locales: Locale[]): Promise<void>;
     /**
-     * Translates a key with automatic async loading.
+     * Translates a key with optional variables and options.
+     * Synchronous - locale must be loaded first via load() or provided in config.
      */
-    tl(key: string, vars?: Record<string, unknown>, options?: TranslateOptions): Promise<string>;
+    t(key: string, vars?: Record<string, unknown>, options?: TranslateOptions): string;
     number(value: number, options?: Intl.NumberFormatOptions, locale?: Locale): string;
     date(value: Date | number, options?: Intl.DateTimeFormatOptions, locale?: Locale): string;
     namespace(ns: string): {
         t: (key: string, vars?: Record<string, unknown>, options?: TranslateOptions) => string;
-        tl: (key: string, vars?: Record<string, unknown>, options?: TranslateOptions) => Promise<string>;
     };
-    subscribe(handler: LocaleChangeHandler): () => void;
+    subscribe(handler: (locale: Locale) => void): () => void;
     private notifySubscribers;
     private findMessage;
+    /**
+     * Check if a value is a MessageValue (string or PluralMessages) rather than a nested Messages object
+     */
+    private isMessageValue;
     private getLocaleChain;
     private formatMessage;
 }
@@ -52,31 +55,17 @@ export declare type I18nConfig = {
     locale?: Locale;
     fallback?: Locale | Locale[];
     messages?: Record<Locale, Messages>;
-    loaders?: Record<Locale, () => Promise<Messages>>;
+    loaders?: Record<Locale, (locale: Locale) => Promise<Messages>>;
     escape?: boolean;
-    missingKey?: (key: string, locale: Locale) => string;
-    missingVar?: 'preserve' | 'empty' | 'error';
 };
 
 export declare type Locale = string;
 
-export declare type LocaleChangeHandler = (locale: Locale) => void;
-
-export declare type MessageFunction = (vars: Record<string, unknown>, helpers: {
-    number: (value: number, options?: Intl.NumberFormatOptions) => string;
-    date: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
-}) => string;
-
-export declare type Messages = Record<string, MessageValue>;
-
-export declare type MessageValue = string | PluralMessages | MessageFunction;
+export declare type Messages = {
+    [key: string]: MessageValue | Messages;
+};
 
-export declare class MissingVariableError extends Error {
-    readonly key: string;
-    readonly variable: string;
-    readonly locale: Locale;
-    constructor(key: string, variable: string, locale: Locale);
-}
+export declare type MessageValue = string | PluralMessages;
 
 export declare type PluralForm = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
 
@@ -86,7 +75,6 @@ export declare type PluralMessages = Partial<Record<PluralForm, string>> & {
 
 export declare type TranslateOptions = {
     locale?: Locale;
-    fallback?: string;
     escape?: boolean;
 };
 

package/dist/index.js

@@ -1,6 +1,6 @@
-import { MissingVariableError as a, createI18n as i } from "./i18nit.js";
+import { I18n as n, createI18n as o } from "./i18nit.js";
 export {
-  a as MissingVariableError,
-  i as createI18n
+  n as I18n,
+  o as createI18n
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vielzeug/i18nit",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "type": "module",
   "files": [
     "dist"