@vielzeug/i18nit 1.1.1

package/README.md

@@ -0,0 +1,783 @@
+# @vielzeug/i18nit
+
+Type-safe, lightweight internationalization (i18n) library for TypeScript applications. Simple, powerful translation management with zero dependencies.
+
+## Features
+
+- ✅ **Type-Safe** - Full TypeScript support with generic types
+- ✅ **Lightweight** - ~3KB gzipped with zero dependencies
+- ✅ **Universal Pluralization** - 100+ languages via Intl.PluralRules API
+- ✅ **Path Interpolation** - Support for nested objects and array indices
+- ✅ **Lazy Loading** - Async locale loading with automatic caching
+- ✅ **Namespaces** - Organize translations by feature or module
+- ✅ **Fallback Chain** - Multiple fallback locales with automatic language variants
+- ✅ **HTML Escaping** - Built-in XSS protection
+- ✅ **Number & Date Formatting** - Locale-aware formatting with Intl API
+- ✅ **Structured Errors** - Detailed error information with MissingVariableError
+- ✅ **Framework Agnostic** - Works with React, Vue, Svelte, or vanilla JS
+
+## Installation
+
+```bash
+# pnpm
+pnpm add @vielzeug/i18nit
+
+# npm
+npm install @vielzeug/i18nit
+
+# yarn
+yarn add @vielzeug/i18nit
+```
+
+## Quick Start
+
+```typescript
+import { createI18n } from '@vielzeug/i18nit';
+
+// Create instance with messages
+const i18n = createI18n({
+  locale: 'en',
+  messages: {
+    en: {
+      greeting: 'Hello, {name}!',
+      items: {
+        zero: 'No items',
+        one: 'One item',
+        other: '{count} items',
+      },
+    },
+    es: {
+      greeting: '¡Hola, {name}!',
+      items: {
+        zero: 'Sin artículos',
+        one: 'Un artículo',
+        other: '{count} artículos',
+      },
+    },
+  },
+});
+
+// Simple translation
+i18n.t('greeting', { name: 'World' }); // "Hello, World!"
+
+// Pluralization
+i18n.t('items', { count: 0 }); // "No items"
+i18n.t('items', { count: 1 }); // "One item"
+i18n.t('items', { count: 5 }); // "5 items"
+
+// Change locale
+i18n.setLocale('es');
+i18n.t('greeting', { name: 'Mundo' }); // "¡Hola, Mundo!"
+```
+
+## Core Concepts
+
+### Translation Keys
+
+Translation keys support dot notation for nested organization:
+
+```typescript
+const i18n = createI18n({
+  messages: {
+    en: {
+      'user.profile.title': 'Profile',
+      'user.settings.title': 'Settings',
+      'admin.dashboard': 'Dashboard',
+    },
+  },
+});
+
+i18n.t('user.profile.title'); // "Profile"
+```
+
+### Variable Interpolation
+
+#### Basic Interpolation
+
+```typescript
+i18n.t('greeting', { name: 'Alice' });
+// Template: "Hello, {name}!"
+// Result: "Hello, Alice!"
+```
+
+#### Nested Object Access
+
+```typescript
+i18n.t('message', { user: { name: 'Bob', role: 'Admin' } });
+// Template: "User {user.name} is {user.role}"
+// Result: "User Bob is Admin"
+```
+
+#### Array Index Access
+
+```typescript
+i18n.t('friends', { friends: [{ name: 'Charlie' }, { name: 'Dave' }] });
+// Template: "First friend: {friends[0].name}"
+// Result: "First friend: Charlie"
+```
+
+#### Supported Path Formats
+
+- `{name}` - Simple variable
+- `{user.name}` - Nested object property
+- `{items[0]}` - Array index
+- `{data.items[0].value}` - Mixed notation
+
+**Limitations:**
+- Only numeric bracket notation `[0]`, `[123]`
+- Quoted keys not supported `["key"]`
+- Non-numeric brackets not supported `[key]`
+
+### Missing Variable Handling
+
+Control how missing variables are handled:
+
+```typescript
+// Empty string (default)
+const i18n1 = createI18n({
+  messages: { en: { msg: 'Hello, {name}!' } },
+  missingVar: 'empty',
+});
+i18n1.t('msg'); // "Hello, !"
+
+// Preserve placeholder
+const i18n2 = createI18n({
+  messages: { en: { msg: 'Hello, {name}!' } },
+  missingVar: 'preserve',
+});
+i18n2.t('msg'); // "Hello, {name}!"
+
+// Throw error
+import { MissingVariableError } from '@vielzeug/i18nit';
+
+const i18n3 = createI18n({
+  messages: { en: { msg: 'Hello, {name}!' } },
+  missingVar: 'error',
+});
+
+try {
+  i18n3.t('msg');
+} catch (error) {
+  if (error instanceof MissingVariableError) {
+    console.log(error.key);      // 'msg'
+    console.log(error.variable); // 'name'
+    console.log(error.locale);   // 'en'
+  }
+}
+```
+
+### Pluralization
+
+Support for multiple plural forms based on locale-specific rules:
+
+```typescript
+const i18n = createI18n({
+  locale: 'en',
+  messages: {
+    en: {
+      notifications: {
+        zero: 'No notifications',
+        one: 'One notification',
+        other: '{count} notifications',
+      },
+    },
+  },
+});
+
+i18n.t('notifications', { count: 0 }); // "No notifications"
+i18n.t('notifications', { count: 1 }); // "One notification"
+i18n.t('notifications', { count: 5 }); // "5 notifications"
+```
+
+#### Supported Plural Rules
+
+i18nit uses the browser's built-in `Intl.PluralRules` API to automatically support pluralization for **100+ languages**, including:
+
+- **English (en)**: one, other
+- **French (fr)**: one (0-1), other
+- **Arabic (ar)**: zero, one, two, few, many, other
+- **Polish (pl)**: one, few, many
+- **Russian (ru)**: one, few, many, other
+- **German (de)**: one, other
+- **Chinese (zh)**: other
+- **Japanese (ja)**: other
+- And 90+ more languages...
+
+### Message Functions
+
+For complex dynamic content, use function-based messages:
+
+```typescript
+const i18n = createI18n({
+  locale: 'en',
+  messages: {
+    en: {
+      // Simple function
+      dynamic: (vars) => `Hello, ${vars.name}!`,
+
+      // With number formatting
+      price: (vars, helpers) => 
+        `Price: ${helpers.number(vars.amount as number, { 
+          style: 'currency', 
+          currency: 'USD' 
+        })}`,
+
+      // With date formatting
+      event: (vars, helpers) => 
+        `Event on ${helpers.date(vars.date as Date, { 
+          dateStyle: 'long' 
+        })}`,
+    },
+  },
+});
+
+i18n.t('dynamic', { name: 'Eve' }); // "Hello, Eve!"
+i18n.t('price', { amount: 99.99 }); // "Price: $99.99"
+i18n.t('event', { date: new Date('2024-01-15') }); // "Event on January 15, 2024"
+```
+
+## Advanced Features
+
+### Fallback Locales
+
+Define fallback locales for missing translations:
+
+```typescript
+const i18n = createI18n({
+  locale: 'de-CH',
+  fallback: ['de', 'en'],
+  messages: {
+    'de-CH': { greeting: 'Grüezi!' },
+    de: { greeting: 'Hallo!', goodbye: 'Auf Wiedersehen!' },
+    en: { greeting: 'Hello!', goodbye: 'Goodbye!', welcome: 'Welcome!' },
+  },
+});
+
+i18n.t('greeting'); // "Grüezi!" (de-CH)
+i18n.t('goodbye'); // "Auf Wiedersehen!" (de fallback)
+i18n.t('welcome'); // "Welcome!" (en fallback)
+```
+
+**Fallback Chain:**
+1. Primary locale (e.g., `de-CH`)
+2. Base language (e.g., `de` from `de-CH`)
+3. First fallback locale
+4. Base of first fallback
+5. Continue through all fallbacks
+
+### Async Locale Loading
+
+Load translations on-demand for better performance:
+
+```typescript
+const i18n = createI18n({
+  locale: 'en',
+  loaders: {
+    fr: async () => {
+      const response = await fetch('/locales/fr.json');
+      return response.json();
+    },
+    de: async () => import('./locales/de.json'),
+  },
+});
+
+// Lazy translation - loads locale first
+const text = await i18n.tl('greeting', { name: 'World' }, { locale: 'fr' });
+
+// Or load explicitly
+await i18n.load('de');
+i18n.t('greeting', undefined, { locale: 'de' });
+
+// Register loader dynamically
+i18n.register('es', async () => {
+  const module = await import('./locales/es.json');
+  return module.default;
+});
+```
+
+**Features:**
+- Concurrent requests are deduplicated
+- Failed loads can be retried
+- Errors are logged but don't break fallback
+- Locale is cached after loading
+
+### Namespaces
+
+Organize translations by feature or module:
+
+```typescript
+const i18n = createI18n({
+  messages: {
+    en: {
+      'auth.login.title': 'Login',
+      'auth.login.button': 'Sign In',
+      'auth.register.title': 'Register',
+      'dashboard.welcome': 'Welcome back!',
+    },
+  },
+});
+
+// Create namespaced translator
+const auth = i18n.namespace('auth.login');
+auth.t('title'); // "Login"
+auth.t('button'); // "Sign In"
+
+const dashboard = i18n.namespace('dashboard');
+dashboard.t('welcome'); // "Welcome back!"
+```
+
+### HTML Escaping
+
+Protect against XSS attacks with automatic HTML escaping:
+
+```typescript
+const i18n = createI18n({
+  messages: {
+    en: { 
+      userContent: 'Comment: {content}',
+    },
+  },
+});
+
+// Enable escaping globally
+const safeI18n = createI18n({
+  escape: true,
+  messages: { en: { html: '<script>alert("xss")</script>' } },
+});
+
+safeI18n.t('html'); 
+// "&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;"
+
+// Or per translation
+i18n.t('userContent', 
+  { content: '<b>Bold</b>' }, 
+  { escape: true }
+);
+// "Comment: &lt;b&gt;Bold&lt;/b&gt;"
+```
+
+### Number & Date Formatting
+
+Locale-aware formatting using the Intl API:
+
+```typescript
+const i18n = createI18n({ locale: 'en-US' });
+
+// Number formatting
+i18n.number(1234.56); // "1,234.56"
+i18n.number(99.99, { style: 'currency', currency: 'USD' }); // "$99.99"
+i18n.number(0.15, { style: 'percent' }); // "15%"
+
+// Date formatting
+const date = new Date('2024-01-15');
+i18n.date(date); // "1/15/2024"
+i18n.date(date, { dateStyle: 'long' }); // "January 15, 2024"
+i18n.date(date, { timeStyle: 'short' }); // "12:00 AM"
+
+// Timestamps
+i18n.date(Date.now(), { dateStyle: 'medium' }); // "Jan 15, 2024"
+
+// Custom locale
+i18n.number(1234.56, undefined, 'de-DE'); // "1.234,56"
+i18n.date(date, { dateStyle: 'short' }, 'fr'); // "15/01/2024"
+```
+
+### Subscriptions
+
+React to locale changes:
+
+```typescript
+const i18n = createI18n({ locale: 'en' });
+
+// Subscribe to locale changes
+const unsubscribe = i18n.subscribe((locale) => {
+  console.log('Locale changed to:', locale);
+  // Update UI, reload data, etc.
+});
+
+i18n.setLocale('fr'); // Logs: "Locale changed to: fr"
+
+// Unsubscribe when done
+unsubscribe();
+```
+
+**Use Cases:**
+- Update UI when locale changes
+- Reload locale-specific data
+- Analytics/tracking
+- State management integration
+
+### Custom Missing Key Handler
+
+Customize behavior for missing translations:
+
+```typescript
+const i18n = createI18n({
+  missingKey: (key, locale) => {
+    console.warn(`Missing translation: ${key} in ${locale}`);
+    return `[${locale}:${key}]`;
+  },
+});
+
+i18n.t('nonexistent.key'); // "[en:nonexistent.key]"
+```
+
+## API Reference
+
+### createI18n(config?)
+
+Creates a new i18n instance.
+
+```typescript
+type I18nConfig = {
+  locale?: string;                    // Default: 'en'
+  fallback?: string | string[];       // Fallback locale(s)
+  messages?: Record<string, Messages>; // Initial translations
+  loaders?: Record<string, () => Promise<Messages>>; // Async loaders
+  escape?: boolean;                   // Global HTML escaping (default: false)
+  missingKey?: (key: string, locale: string) => string; // Missing key handler
+  missingVar?: 'preserve' | 'empty' | 'error'; // Missing variable strategy
+};
+```
+
+### Translation Methods
+
+#### `t(key, vars?, options?)`
+
+Translate a key synchronously.
+
+```typescript
+i18n.t('greeting'); // Simple
+i18n.t('greeting', { name: 'Alice' }); // With variables
+i18n.t('greeting', { name: 'Bob' }, { locale: 'fr', escape: true }); // With options
+```
+
+**Options:**
+- `locale?: string` - Override locale for this translation
+- `fallback?: string` - Custom fallback text
+- `escape?: boolean` - Override HTML escaping
+
+#### `tl(key, vars?, options?)`
+
+Translate a key asynchronously (loads locale if needed).
+
+```typescript
+await i18n.tl('greeting', { name: 'Alice' }, { locale: 'fr' });
+```
+
+### Locale Management
+
+```typescript
+i18n.setLocale('fr');           // Change locale
+i18n.getLocale();               // Get current locale
+i18n.hasLocale('es');           // Check if locale exists
+i18n.has('key');                // Check if key exists
+i18n.has('key', 'fr');          // Check if key exists in locale
+await i18n.hasAsync('key', 'es'); // Check with async loading
+```
+
+### Message Management
+
+```typescript
+// Add messages (merge)
+i18n.add('en', { newKey: 'New value' });
+
+// Set messages (replace)
+i18n.set('en', { key: 'Value' });
+
+// Get messages for locale
+const messages = i18n.getMessages('en');
+```
+
+### Async Loading
+
+```typescript
+// Register loader
+i18n.register('de', async () => import('./locales/de.json'));
+
+// Load locale
+await i18n.load('de');
+```
+
+### Formatting
+
+```typescript
+i18n.number(value, options?, locale?);
+i18n.date(value, options?, locale?);
+```
+
+### Namespace
+
+```typescript
+const ns = i18n.namespace('auth');
+ns.t('login.title');
+await ns.tl('register.title', undefined, { locale: 'fr' });
+```
+
+### Subscriptions
+
+```typescript
+const unsubscribe = i18n.subscribe((locale) => {
+  console.log('Locale changed:', locale);
+});
+```
+
+## Framework Integration
+
+### React
+
+```tsx
+import { createI18n } from '@vielzeug/i18nit';
+import { createContext, useContext, useState, useEffect } from 'react';
+
+const I18nContext = createContext(null);
+
+export function I18nProvider({ children, config }) {
+  const [i18n] = useState(() => createI18n(config));
+  const [locale, setLocale] = useState(i18n.getLocale());
+
+  useEffect(() => {
+    return i18n.subscribe(setLocale);
+  }, [i18n]);
+
+  return (
+    <I18nContext.Provider value={{ i18n, locale }}>
+      {children}
+    </I18nContext.Provider>
+  );
+}
+
+export function useI18n() {
+  const context = useContext(I18nContext);
+  if (!context) throw new Error('useI18n must be used within I18nProvider');
+  return context;
+}
+
+export function useTranslation(namespace?: string) {
+  const { i18n } = useI18n();
+  const ns = namespace ? i18n.namespace(namespace) : i18n;
+  
+  return {
+    t: ns.t.bind(ns),
+    tl: ns.tl.bind(ns),
+    locale: i18n.getLocale(),
+    setLocale: i18n.setLocale.bind(i18n),
+  };
+}
+
+// Usage
+function MyComponent() {
+  const { t, locale, setLocale } = useTranslation('dashboard');
+  
+  return (
+    <div>
+      <h1>{t('welcome')}</h1>
+      <button onClick={() => setLocale('fr')}>Français</button>
+    </div>
+  );
+}
+```
+
+### Vue 3
+
+```typescript
+import { createI18n } from '@vielzeug/i18nit';
+import { ref, onUnmounted, Plugin } from 'vue';
+
+const i18n = createI18n({ locale: 'en' });
+const locale = ref(i18n.getLocale());
+
+const unsubscribe = i18n.subscribe((newLocale) => {
+  locale.value = newLocale;
+});
+
+export const i18nPlugin: Plugin = {
+  install(app) {
+    app.config.globalProperties.$t = i18n.t.bind(i18n);
+    app.config.globalProperties.$i18n = i18n;
+    
+    app.provide('i18n', i18n);
+    app.provide('locale', locale);
+  },
+};
+
+// Composable
+export function useI18n() {
+  return {
+    t: i18n.t.bind(i18n),
+    tl: i18n.tl.bind(i18n),
+    locale,
+    setLocale: (newLocale: string) => i18n.setLocale(newLocale),
+  };
+}
+
+// Usage in component
+<script setup>
+import { useI18n } from './i18n';
+
+const { t, locale, setLocale } = useI18n();
+</script>
+
+<template>
+  <div>
+    <h1>{{ t('welcome') }}</h1>
+    <button @click="setLocale('fr')">Français</button>
+  </div>
+</template>
+```
+
+### Svelte
+
+```typescript
+import { createI18n } from '@vielzeug/i18nit';
+import { writable } from 'svelte/store';
+
+const i18n = createI18n({ locale: 'en' });
+export const locale = writable(i18n.getLocale());
+
+i18n.subscribe((newLocale) => {
+  locale.set(newLocale);
+});
+
+export const t = i18n.t.bind(i18n);
+export const setLocale = i18n.setLocale.bind(i18n);
+
+// Usage
+<script>
+  import { t, setLocale } from './i18n';
+</script>
+
+<h1>{$t('welcome')}</h1>
+<button on:click={() => setLocale('fr')}>Français</button>
+```
+
+## Best Practices
+
+### 1. Organize Translations by Feature
+
+```typescript
+const messages = {
+  en: {
+    'auth.login.title': 'Login',
+    'auth.register.title': 'Register',
+    'dashboard.stats.users': 'Users',
+    'dashboard.stats.revenue': 'Revenue',
+  },
+};
+```
+
+### 2. Use Namespaces for Large Apps
+
+```typescript
+const authTranslations = i18n.namespace('auth');
+const dashboardTranslations = i18n.namespace('dashboard');
+```
+
+### 3. Lazy Load Translations
+
+```typescript
+const i18n = createI18n({
+  loaders: {
+    'en-US': () => import('./locales/en-US.json'),
+    'es-ES': () => import('./locales/es-ES.json'),
+  },
+});
+```
+
+### 4. Type-Safe Translation Keys
+
+```typescript
+type TranslationKeys = 
+  | 'auth.login.title'
+  | 'auth.register.title'
+  | 'dashboard.welcome';
+
+function t(key: TranslationKeys, vars?: Record<string, unknown>) {
+  return i18n.t(key, vars);
+}
+```
+
+### 5. Use Structured Error Handling
+
+```typescript
+import { MissingVariableError } from '@vielzeug/i18nit';
+
+const i18n = createI18n({
+  missingVar: 'error',
+  messages: { en: { greeting: 'Hello, {name}!' } },
+});
+
+try {
+  i18n.t('greeting');
+} catch (error) {
+  if (error instanceof MissingVariableError) {
+    // Log to error tracking service
+    console.error('Missing variable:', {
+      key: error.key,
+      variable: error.variable,
+      locale: error.locale,
+    });
+  }
+}
+```
+
+## TypeScript Support
+
+Full TypeScript support with type inference:
+
+```typescript
+import { createI18n, type Messages, type I18nConfig } from '@vielzeug/i18nit';
+
+// Define your messages type
+interface MyMessages extends Messages {
+  greeting: string;
+  items: {
+    zero: string;
+    one: string;
+    other: string;
+  };
+}
+
+const config: I18nConfig = {
+  locale: 'en',
+  messages: {
+    en: {
+      greeting: 'Hello!',
+      items: { zero: 'No items', one: 'One item', other: '{count} items' },
+    } satisfies MyMessages,
+  },
+};
+
+const i18n = createI18n(config);
+```
+
+## Comparison
+
+| Feature | i18nit | i18next | react-intl |
+|---------|--------|---------|------------|
+| Bundle Size | **~3KB** | ~12KB | ~15KB |
+| Dependencies | **0** | 2+ | 10+ |
+| TypeScript | ✅ First-class | ✅ Good | ✅ Good |
+| Pluralization | ✅ Built-in | ✅ Plugin | ✅ Built-in |
+| Async Loading | ✅ Built-in | ✅ Built-in | ⚠️ Manual |
+| Path Interpolation | ✅ `{user.name}` | ❌ | ❌ |
+| Message Functions | ✅ Built-in | ⚠️ Limited | ✅ Components |
+| HTML Escaping | ✅ Built-in | ⚠️ Manual | ✅ Built-in |
+| Structured Errors | ✅ MissingVariableError | ❌ | ❌ |
+| Framework Agnostic | ✅ | ✅ | ❌ React only |
+
+## License
+
+MIT © [Helmuth Duarte](https://github.com/helmuthdu)
+
+## Links
+
+- [GitHub Repository](https://github.com/helmuthdu/vielzeug)
+- [Documentation](https://vielzeug.dev)
+- [NPM Package](https://www.npmjs.com/package/@vielzeug/i18nit)
+- [Issue Tracker](https://github.com/helmuthdu/vielzeug/issues)
+
+---
+
+Part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) ecosystem - A collection of type-safe utilities for modern web development.
+

package/dist/i18nit.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class f extends Error{key;variable;locale;constructor(t,s,e){super(`Missing variable '${s}' for key '${t}' in locale '${e}'`),this.name="MissingVariableError",this.key=t,this.variable=s,this.locale=e}}const d={"'":"&#39;",'"':"&quot;","&":"&amp;","<":"&lt;",">":"&gt;"},c=n=>n.replace(/[&<>"']/g,t=>d[t]),g=(n,t)=>{if(t in n)return n[t];const s=t.match(/[^.[\]]+/g)||[];let e=n;for(const r of s){if(e==null||typeof e!="object")return;e=e[r]}return e},u=(n,t,s={})=>{const e=s.missingVar??"empty";return n.replace(/\{([\w.[\]]+)}/g,(r,i)=>{const a=g(t,i);if(a==null){if(e==="preserve")return r;if(e==="error")throw new f(s.key??"unknown",i,s.locale??"unknown");return""}if(typeof a=="number"&&s.locale)try{return new Intl.NumberFormat(s.locale).format(a)}catch{}return String(a)})},m=(n,t)=>{const s=Math.abs(Math.floor(t));try{return new Intl.PluralRules(n).select(s)}catch{return s===1?"one":"other"}};class y{locale;fallbacks;catalogs=new Map;loaders=new Map;loading=new Map;subscribers=new Set;escape;missingKey;missingVar;constructor(t={}){if(this.locale=t.locale??"en",this.fallbacks=Array.isArray(t.fallback)?t.fallback:t.fallback?[t.fallback]:[],this.escape=t.escape??!1,this.missingKey=t.missingKey??(s=>s),this.missingVar=t.missingVar??"empty",t.messages)for(const[s,e]of Object.entries(t.messages))this.catalogs.set(s,e);if(t.loaders)for(const[s,e]of Object.entries(t.loaders))this.loaders.set(s,e)}setLocale(t){this.locale!==t&&(this.locale=t,this.notifySubscribers())}getLocale(){return this.locale}add(t,s){const e=this.catalogs.get(t)??{};this.catalogs.set(t,{...e,...s}),this.notifySubscribers()}set(t,s){this.catalogs.set(t,s),this.notifySubscribers()}getMessages(t){return this.catalogs.get(t)}hasLocale(t){return this.catalogs.has(t)}has(t,s){return this.findMessage(t,s)!==void 0}async load(t){if(this.loading.has(t))return this.loading.get(t);if(this.catalogs.has(t))return;const s=this.loaders.get(t);if(!s)return;const e=(async()=>{try{const r=await s();this.add(t,r)}catch(r){throw console.warn(`[I18n] Failed to load locale '${t}':`,r),r}finally{this.loading.delete(t)}})();return this.loading.set(t,e),e}register(t,s){this.loaders.set(t,s)}async hasAsync(t,s){const e=s??this.locale;return!this.catalogs.has(e)&&this.loaders.has(e)&&await this.load(e),this.has(t,e)}t(t,s,e){const r=e??{},i=r.locale??this.locale,a=r.escape??this.escape,o=this.findMessage(t,i);return o===void 0?r.fallback??this.missingKey(t,i):this.formatMessage(o,s??{},i,a,t)}async tl(t,s,e){const r=e?.locale??this.locale;if(!this.catalogs.has(r)&&this.loaders.has(r))try{await this.load(r)}catch{}return this.t(t,s,e)}number(t,s,e){try{return new Intl.NumberFormat(e??this.locale,s).format(t)}catch{return String(t)}}date(t,s,e){const r=typeof t=="number"?new Date(t):t;try{return new Intl.DateTimeFormat(e??this.locale,s).format(r)}catch{return r.toString()}}namespace(t){return{t:(s,e,r)=>this.t(`${t}.${s}`,e,r),tl:(s,e,r)=>this.tl(`${t}.${s}`,e,r)}}subscribe(t){this.subscribers.add(t);try{t(this.locale)}catch{}return()=>this.subscribers.delete(t)}notifySubscribers(){for(const t of this.subscribers)try{t(this.locale)}catch{}}findMessage(t,s){const e=this.getLocaleChain(s??this.locale);for(const r of e){const i=this.catalogs.get(r);if(!i)continue;const a=g(i,t);if(a!==void 0)return a}}getLocaleChain(t){const s=[t],e=t.split("-")[0];e!==t&&s.push(e);for(const r of this.fallbacks){s.push(r);const i=r.split("-")[0];i!==r&&s.push(i)}return s}formatMessage(t,s,e,r,i){if(typeof t=="function")try{const a=t(s,{date:(o,l)=>this.date(o,l,e),number:(o,l)=>this.number(o,l,e)});return r?c(a):a}catch{return""}if(typeof t=="object"&&"other"in t){const a=Number(s.count??0),o=t;let l;a===0&&o.zero!==void 0?l="zero":l=m(e,a);const b=o[l]??o.other,h=u(b,s,{key:i,locale:e,missingVar:this.missingVar});return r?c(h):h}if(typeof t=="string"){const a=u(t,s,{key:i,locale:e,missingVar:this.missingVar});return r?c(a):a}return""}}function p(n){return new y(n)}exports.MissingVariableError=f;exports.createI18n=p;
+//# sourceMappingURL=i18nit.cjs.map

package/dist/i18nit.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18nit.cjs","sources":["../src/i18nit.ts"],"sourcesContent":["export type Locale = string;\n\nexport type PluralForm = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';\n\nexport type PluralMessages = Partial<Record<PluralForm, string>> & { other: string };\n\nexport type MessageFunction = (\n  vars: Record<string, unknown>,\n  helpers: {\n    number: (value: number, options?: Intl.NumberFormatOptions) => string;\n    date: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;\n  },\n) => string;\n\nexport type MessageValue = string | PluralMessages | MessageFunction;\n\nexport type Messages = Record<string, MessageValue>;\n\nexport type TranslateParams = {\n  locale?: Locale;\n  fallback?: string;\n  escape?: boolean;\n};\n\nexport type I18nConfig = {\n  locale?: Locale;\n  fallback?: Locale | Locale[];\n  messages?: Record<Locale, Messages>;\n  loaders?: Record<Locale, () => Promise<Messages>>;\n  escape?: boolean;\n  missingKey?: (key: string, locale: Locale) => string;\n  missingVar?: 'preserve' | 'empty' | 'error';\n};\n\n/**\n * Error thrown when a required variable is missing during interpolation.\n */\nexport class MissingVariableError extends Error {\n  readonly key: string;\n  readonly variable: string;\n  readonly locale: Locale;\n\n  constructor(key: string, variable: string, locale: Locale) {\n    super(`Missing variable '${variable}' for key '${key}' in locale '${locale}'`);\n    this.name = 'MissingVariableError';\n    this.key = key;\n    this.variable = variable;\n    this.locale = locale;\n  }\n}\n\n/* Helpers */\n\nconst HTML_ENTITIES: Record<string, string> = {\n  \"'\": '&#39;',\n  '\"': '&quot;',\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n};\n\nconst escapeHtml = (str: string): string => str.replace(/[&<>\"']/g, (char) => HTML_ENTITIES[char]);\n\n/**\n * Resolve nested properties using dot notation and numeric bracket notation.\n *\n * @param obj - Object to traverse\n * @param path - Path string to resolve\n * @returns Value at a path or undefined if not found\n */\nconst resolvePath = (obj: Record<string, unknown>, path: string): unknown => {\n  // Try direct access first (supports literal keys with dots)\n  if (path in obj) return obj[path];\n\n  // Parse and traverse path - matches: word characters, numbers\n  // Regex: /[^.[\\]]+/g matches segments between dots and brackets\n  const parts = path.match(/[^.[\\]]+/g) || [];\n  let value: unknown = obj;\n\n  for (const part of parts) {\n    if (value == null || typeof value !== 'object') return undefined;\n    value = (value as Record<string, unknown>)[part];\n  }\n\n  return value;\n};\n\n/**\n * Interpolate variables into a template string.\n *\n * Template format: {variableName} or {nested.path} or {array[0]}\n *\n * @param template - Template string with {variable} placeholders\n * @param vars - Variables object\n * @param options - Interpolation options\n * @returns Interpolated string\n * @throws {MissingVariableError} When missingVar is 'error' and a variable is not found\n */\nconst interpolate = (\n  template: string,\n  vars: Record<string, unknown>,\n  options: {\n    locale?: Locale;\n    missingVar?: 'preserve' | 'empty' | 'error';\n    key?: string; // For better error messages\n  } = {},\n): string => {\n  const missingVar = options.missingVar ?? 'empty';\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Variable interpolation requires conditional logic\n  return template.replace(/\\{([\\w.[\\]]+)}/g, (match, key) => {\n    const value = resolvePath(vars, key);\n\n    if (value == null) {\n      if (missingVar === 'preserve') return match;\n      if (missingVar === 'error') {\n        throw new MissingVariableError(options.key ?? 'unknown', key, options.locale ?? 'unknown');\n      }\n      return '';\n    }\n\n    // Format numbers with locale\n    if (typeof value === 'number' && options.locale) {\n      try {\n        return new Intl.NumberFormat(options.locale).format(value);\n      } catch {\n        // Fall through to string conversion\n      }\n    }\n\n    return String(value);\n  });\n};\n\n/* Pluralization */\n\ntype PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';\n\n/**\n * Get the plural form for a number in a given locale using Intl.PluralRules API.\n *\n * Automatically handles all locale-specific plural rules including:\n * - English: one/other\n * - Arabic: zero/one/two/few/many/other\n * - Russian/Polish: one/few/many/other\n * - And 100+ other languages\n *\n * @param locale - Locale string (e.g., 'en-US', 'fr')\n * @param count - Number to pluralize\n * @returns Plural category\n */\nconst getPluralForm = (locale: Locale, count: number): PluralCategory => {\n  const n = Math.abs(Math.floor(count));\n\n  try {\n    const pluralRules = new Intl.PluralRules(locale);\n    return pluralRules.select(n) as PluralCategory;\n  } catch {\n    // Fallback to English-like behavior if locale is invalid\n    return n === 1 ? 'one' : 'other';\n  }\n};\n\ntype LocaleChangeHandler = (locale: Locale) => void;\n\nclass I18n {\n  private locale: Locale;\n  private fallbacks: Locale[];\n  private catalogs = new Map<Locale, Messages>();\n  private loaders = new Map<Locale, () => Promise<Messages>>();\n  private loading = new Map<Locale, Promise<void>>();\n  private subscribers = new Set<LocaleChangeHandler>();\n\n  private escape: boolean;\n  private missingKey: (key: string, locale: Locale) => string;\n  private missingVar: 'preserve' | 'empty' | 'error';\n\n  constructor(config: I18nConfig = {}) {\n    this.locale = config.locale ?? 'en';\n    this.fallbacks = Array.isArray(config.fallback) ? config.fallback : config.fallback ? [config.fallback] : [];\n\n    this.escape = config.escape ?? false;\n    this.missingKey = config.missingKey ?? ((key) => key);\n    this.missingVar = config.missingVar ?? 'empty';\n\n    if (config.messages) {\n      for (const [locale, messages] of Object.entries(config.messages)) {\n        this.catalogs.set(locale, messages);\n      }\n    }\n\n    if (config.loaders) {\n      for (const [locale, loader] of Object.entries(config.loaders)) {\n        this.loaders.set(locale, loader);\n      }\n    }\n  }\n\n  // Locale Management\n\n  setLocale(locale: Locale): void {\n    if (this.locale === locale) return;\n    this.locale = locale;\n    this.notifySubscribers();\n  }\n\n  getLocale(): Locale {\n    return this.locale;\n  }\n\n  // Message Management\n\n  add(locale: Locale, messages: Messages): void {\n    const existing = this.catalogs.get(locale) ?? {};\n    this.catalogs.set(locale, { ...existing, ...messages });\n    this.notifySubscribers();\n  }\n\n  set(locale: Locale, messages: Messages): void {\n    this.catalogs.set(locale, messages);\n    this.notifySubscribers();\n  }\n\n  getMessages(locale: Locale): Messages | undefined {\n    return this.catalogs.get(locale);\n  }\n\n  hasLocale(locale: Locale): boolean {\n    return this.catalogs.has(locale);\n  }\n\n  has(key: string, locale?: Locale): boolean {\n    return this.findMessage(key, locale) !== undefined;\n  }\n\n  // Async Loaders\n\n  async load(locale: Locale): Promise<void> {\n    if (this.loading.has(locale)) return this.loading.get(locale);\n    if (this.catalogs.has(locale)) return;\n\n    const loader = this.loaders.get(locale);\n    if (!loader) return;\n\n    const promise = (async () => {\n      try {\n        const messages = await loader();\n        this.add(locale, messages);\n      } catch (error) {\n        // Log loader failures for visibility\n        console.warn(`[I18n] Failed to load locale '${locale}':`, error);\n        // Re-throw so callers can handle errors\n        throw error;\n      } finally {\n        this.loading.delete(locale);\n      }\n    })();\n\n    this.loading.set(locale, promise);\n    return promise;\n  }\n\n  register(locale: Locale, loader: () => Promise<Messages>): void {\n    this.loaders.set(locale, loader);\n  }\n\n  async hasAsync(key: string, locale?: Locale): Promise<boolean> {\n    const targetLocale = locale ?? this.locale;\n    if (!this.catalogs.has(targetLocale) && this.loaders.has(targetLocale)) {\n      await this.load(targetLocale);\n    }\n    return this.has(key, targetLocale);\n  }\n\n  // Translation\n\n  t(key: string, vars?: Record<string, unknown>, options?: TranslateParams): string {\n    const opts = options ?? {};\n    const targetLocale = opts.locale ?? this.locale;\n    const shouldEscape = opts.escape ?? this.escape;\n\n    const message = this.findMessage(key, targetLocale);\n    if (message === undefined) {\n      return opts.fallback ?? this.missingKey(key, targetLocale);\n    }\n\n    return this.formatMessage(message, vars ?? {}, targetLocale, shouldEscape, key);\n  }\n\n  async tl(key: string, vars?: Record<string, unknown>, options?: TranslateParams): Promise<string> {\n    const targetLocale = options?.locale ?? this.locale;\n\n    if (!this.catalogs.has(targetLocale) && this.loaders.has(targetLocale)) {\n      try {\n        await this.load(targetLocale);\n      } catch {\n        // Loader errors are already logged in load(), continue with fallback\n        // This catch prevents the error from propagating to the caller\n      }\n    }\n\n    return this.t(key, vars, options);\n  }\n\n  // Formatting Helpers\n\n  number(value: number, options?: Intl.NumberFormatOptions, locale?: Locale): string {\n    try {\n      return new Intl.NumberFormat(locale ?? this.locale, options).format(value);\n    } catch {\n      return String(value);\n    }\n  }\n\n  date(value: Date | number, options?: Intl.DateTimeFormatOptions, locale?: Locale): string {\n    const date = typeof value === 'number' ? new Date(value) : value;\n    try {\n      return new Intl.DateTimeFormat(locale ?? this.locale, options).format(date);\n    } catch {\n      return date.toString();\n    }\n  }\n\n  // Namespaced Translator\n\n  namespace(ns: string) {\n    return {\n      t: (key: string, vars?: Record<string, unknown>, options?: TranslateParams) =>\n        this.t(`${ns}.${key}`, vars, options),\n      tl: (key: string, vars?: Record<string, unknown>, options?: TranslateParams) =>\n        this.tl(`${ns}.${key}`, vars, options),\n    };\n  }\n\n  // Subscriptions\n\n  subscribe(handler: LocaleChangeHandler): () => void {\n    this.subscribers.add(handler);\n    try {\n      handler(this.locale);\n    } catch {\n      // Ignore handler errors\n    }\n    return () => this.subscribers.delete(handler);\n  }\n\n  private notifySubscribers(): void {\n    for (const handler of this.subscribers) {\n      try {\n        handler(this.locale);\n      } catch {\n        // Ignore handler errors\n      }\n    }\n  }\n\n  // Internal Helpers\n\n  private findMessage(key: string, locale?: Locale): MessageValue | undefined {\n    const locales = this.getLocaleChain(locale ?? this.locale);\n\n    for (const loc of locales) {\n      const messages = this.catalogs.get(loc);\n      if (!messages) continue;\n\n      const value = resolvePath(messages, key);\n      if (value !== undefined) return value as MessageValue;\n    }\n\n    return undefined;\n  }\n\n  private getLocaleChain(locale: Locale): Locale[] {\n    const chain: Locale[] = [locale];\n\n    // Add base language (e.g., 'en' from 'en-US')\n    const lang = locale.split('-')[0];\n    if (lang !== locale) chain.push(lang);\n\n    // Add fallback locales\n    for (const fallback of this.fallbacks) {\n      chain.push(fallback);\n      const fallbackLang = fallback.split('-')[0];\n      if (fallbackLang !== fallback) chain.push(fallbackLang);\n    }\n\n    return chain;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: -\n  private formatMessage(\n    message: MessageValue,\n    vars: Record<string, unknown>,\n    locale: Locale,\n    shouldEscape: boolean,\n    key?: string,\n  ): string {\n    // Handle function messages\n    if (typeof message === 'function') {\n      try {\n        const result = message(vars, {\n          date: (d, opts) => this.date(d, opts, locale),\n          number: (v, opts) => this.number(v, opts, locale),\n        });\n        return shouldEscape ? escapeHtml(result) : result;\n      } catch {\n        return '';\n      }\n    }\n\n    // Handle plural messages\n    if (typeof message === 'object' && 'other' in message) {\n      const count = Number(vars.count ?? 0);\n      const pluralMsg = message as PluralMessages;\n\n      // Prefer an explicit 'zero' form when the count is 0\n      let form: PluralForm;\n      if (count === 0 && pluralMsg.zero !== undefined) {\n        form = 'zero';\n      } else {\n        form = getPluralForm(locale, count);\n      }\n\n      const template = pluralMsg[form] ?? pluralMsg.other;\n      const result = interpolate(template, vars, { key, locale, missingVar: this.missingVar });\n      return shouldEscape ? escapeHtml(result) : result;\n    }\n\n    // Handle string messages\n    if (typeof message === 'string') {\n      const result = interpolate(message, vars, { key, locale, missingVar: this.missingVar });\n      return shouldEscape ? escapeHtml(result) : result;\n    }\n\n    return '';\n  }\n}\n\nexport function createI18n(config?: I18nConfig): I18n {\n  return new I18n(config);\n}\n"],"names":["MissingVariableError","key","variable","locale","HTML_ENTITIES","escapeHtml","str","char","resolvePath","obj","path","parts","value","part","interpolate","template","vars","options","missingVar","match","getPluralForm","count","n","I18n","config","messages","loader","existing","promise","error","targetLocale","opts","shouldEscape","message","date","ns","handler","locales","loc","chain","lang","fallback","fallbackLang","result","d","v","pluralMsg","form","createI18n"],"mappings":"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"}

package/dist/i18nit.js

@@ -0,0 +1,222 @@
+class b extends Error {
+  key;
+  variable;
+  locale;
+  constructor(t, s, e) {
+    super(`Missing variable '${s}' for key '${t}' in locale '${e}'`), this.name = "MissingVariableError", this.key = t, this.variable = s, this.locale = e;
+  }
+}
+const m = {
+  "'": "'",
+  '"': """,
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;"
+}, c = (n) => n.replace(/[&<>"']/g, (t) => m[t]), f = (n, t) => {
+  if (t in n) return n[t];
+  const s = t.match(/[^.[\]]+/g) || [];
+  let e = n;
+  for (const r of s) {
+    if (e == null || typeof e != "object") return;
+    e = e[r];
+  }
+  return e;
+}, u = (n, t, s = {}) => {
+  const e = s.missingVar ?? "empty";
+  return n.replace(/\{([\w.[\]]+)}/g, (r, i) => {
+    const a = f(t, i);
+    if (a == null) {
+      if (e === "preserve") return r;
+      if (e === "error")
+        throw new b(s.key ?? "unknown", i, s.locale ?? "unknown");
+      return "";
+    }
+    if (typeof a == "number" && s.locale)
+      try {
+        return new Intl.NumberFormat(s.locale).format(a);
+      } catch {
+      }
+    return String(a);
+  });
+}, d = (n, t) => {
+  const s = Math.abs(Math.floor(t));
+  try {
+    return new Intl.PluralRules(n).select(s);
+  } catch {
+    return s === 1 ? "one" : "other";
+  }
+};
+class y {
+  locale;
+  fallbacks;
+  catalogs = /* @__PURE__ */ new Map();
+  loaders = /* @__PURE__ */ new Map();
+  loading = /* @__PURE__ */ new Map();
+  subscribers = /* @__PURE__ */ new Set();
+  escape;
+  missingKey;
+  missingVar;
+  constructor(t = {}) {
+    if (this.locale = t.locale ?? "en", this.fallbacks = Array.isArray(t.fallback) ? t.fallback : t.fallback ? [t.fallback] : [], this.escape = t.escape ?? !1, this.missingKey = t.missingKey ?? ((s) => s), this.missingVar = t.missingVar ?? "empty", t.messages)
+      for (const [s, e] of Object.entries(t.messages))
+        this.catalogs.set(s, e);
+    if (t.loaders)
+      for (const [s, e] of Object.entries(t.loaders))
+        this.loaders.set(s, e);
+  }
+  // Locale Management
+  setLocale(t) {
+    this.locale !== t && (this.locale = t, this.notifySubscribers());
+  }
+  getLocale() {
+    return this.locale;
+  }
+  // Message Management
+  add(t, s) {
+    const e = this.catalogs.get(t) ?? {};
+    this.catalogs.set(t, { ...e, ...s }), this.notifySubscribers();
+  }
+  set(t, s) {
+    this.catalogs.set(t, s), this.notifySubscribers();
+  }
+  getMessages(t) {
+    return this.catalogs.get(t);
+  }
+  hasLocale(t) {
+    return this.catalogs.has(t);
+  }
+  has(t, s) {
+    return this.findMessage(t, s) !== void 0;
+  }
+  // Async Loaders
+  async load(t) {
+    if (this.loading.has(t)) return this.loading.get(t);
+    if (this.catalogs.has(t)) return;
+    const s = this.loaders.get(t);
+    if (!s) return;
+    const e = (async () => {
+      try {
+        const r = await s();
+        this.add(t, r);
+      } catch (r) {
+        throw console.warn(`[I18n] Failed to load locale '${t}':`, r), r;
+      } finally {
+        this.loading.delete(t);
+      }
+    })();
+    return this.loading.set(t, e), e;
+  }
+  register(t, s) {
+    this.loaders.set(t, s);
+  }
+  async hasAsync(t, s) {
+    const e = s ?? this.locale;
+    return !this.catalogs.has(e) && this.loaders.has(e) && await this.load(e), this.has(t, e);
+  }
+  // Translation
+  t(t, s, e) {
+    const r = e ?? {}, i = r.locale ?? this.locale, a = r.escape ?? this.escape, o = this.findMessage(t, i);
+    return o === void 0 ? r.fallback ?? this.missingKey(t, i) : this.formatMessage(o, s ?? {}, i, a, t);
+  }
+  async tl(t, s, e) {
+    const r = e?.locale ?? this.locale;
+    if (!this.catalogs.has(r) && this.loaders.has(r))
+      try {
+        await this.load(r);
+      } catch {
+      }
+    return this.t(t, s, e);
+  }
+  // Formatting Helpers
+  number(t, s, e) {
+    try {
+      return new Intl.NumberFormat(e ?? this.locale, s).format(t);
+    } catch {
+      return String(t);
+    }
+  }
+  date(t, s, e) {
+    const r = typeof t == "number" ? new Date(t) : t;
+    try {
+      return new Intl.DateTimeFormat(e ?? this.locale, s).format(r);
+    } catch {
+      return r.toString();
+    }
+  }
+  // Namespaced Translator
+  namespace(t) {
+    return {
+      t: (s, e, r) => this.t(`${t}.${s}`, e, r),
+      tl: (s, e, r) => this.tl(`${t}.${s}`, e, r)
+    };
+  }
+  // Subscriptions
+  subscribe(t) {
+    this.subscribers.add(t);
+    try {
+      t(this.locale);
+    } catch {
+    }
+    return () => this.subscribers.delete(t);
+  }
+  notifySubscribers() {
+    for (const t of this.subscribers)
+      try {
+        t(this.locale);
+      } catch {
+      }
+  }
+  // Internal Helpers
+  findMessage(t, s) {
+    const e = this.getLocaleChain(s ?? this.locale);
+    for (const r of e) {
+      const i = this.catalogs.get(r);
+      if (!i) continue;
+      const a = f(i, t);
+      if (a !== void 0) return a;
+    }
+  }
+  getLocaleChain(t) {
+    const s = [t], e = t.split("-")[0];
+    e !== t && s.push(e);
+    for (const r of this.fallbacks) {
+      s.push(r);
+      const i = r.split("-")[0];
+      i !== r && s.push(i);
+    }
+    return s;
+  }
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: -
+  formatMessage(t, s, e, r, i) {
+    if (typeof t == "function")
+      try {
+        const a = t(s, {
+          date: (o, l) => this.date(o, l, e),
+          number: (o, l) => this.number(o, l, e)
+        });
+        return r ? c(a) : a;
+      } catch {
+        return "";
+      }
+    if (typeof t == "object" && "other" in t) {
+      const a = Number(s.count ?? 0), o = t;
+      let l;
+      a === 0 && o.zero !== void 0 ? l = "zero" : l = d(e, a);
+      const g = o[l] ?? o.other, h = u(g, s, { key: i, locale: e, missingVar: this.missingVar });
+      return r ? c(h) : h;
+    }
+    if (typeof t == "string") {
+      const a = u(t, s, { key: i, locale: e, missingVar: this.missingVar });
+      return r ? c(a) : a;
+    }
+    return "";
+  }
+}
+function p(n) {
+  return new y(n);
+}
+export {
+  b as MissingVariableError,
+  p as createI18n
+};
+//# sourceMappingURL=i18nit.js.map

package/dist/i18nit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18nit.js","sources":["../src/i18nit.ts"],"sourcesContent":["export type Locale = string;\n\nexport type PluralForm = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';\n\nexport type PluralMessages = Partial<Record<PluralForm, string>> & { other: string };\n\nexport type MessageFunction = (\n  vars: Record<string, unknown>,\n  helpers: {\n    number: (value: number, options?: Intl.NumberFormatOptions) => string;\n    date: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;\n  },\n) => string;\n\nexport type MessageValue = string | PluralMessages | MessageFunction;\n\nexport type Messages = Record<string, MessageValue>;\n\nexport type TranslateParams = {\n  locale?: Locale;\n  fallback?: string;\n  escape?: boolean;\n};\n\nexport type I18nConfig = {\n  locale?: Locale;\n  fallback?: Locale | Locale[];\n  messages?: Record<Locale, Messages>;\n  loaders?: Record<Locale, () => Promise<Messages>>;\n  escape?: boolean;\n  missingKey?: (key: string, locale: Locale) => string;\n  missingVar?: 'preserve' | 'empty' | 'error';\n};\n\n/**\n * Error thrown when a required variable is missing during interpolation.\n */\nexport class MissingVariableError extends Error {\n  readonly key: string;\n  readonly variable: string;\n  readonly locale: Locale;\n\n  constructor(key: string, variable: string, locale: Locale) {\n    super(`Missing variable '${variable}' for key '${key}' in locale '${locale}'`);\n    this.name = 'MissingVariableError';\n    this.key = key;\n    this.variable = variable;\n    this.locale = locale;\n  }\n}\n\n/* Helpers */\n\nconst HTML_ENTITIES: Record<string, string> = {\n  \"'\": '&#39;',\n  '\"': '&quot;',\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n};\n\nconst escapeHtml = (str: string): string => str.replace(/[&<>\"']/g, (char) => HTML_ENTITIES[char]);\n\n/**\n * Resolve nested properties using dot notation and numeric bracket notation.\n *\n * @param obj - Object to traverse\n * @param path - Path string to resolve\n * @returns Value at a path or undefined if not found\n */\nconst resolvePath = (obj: Record<string, unknown>, path: string): unknown => {\n  // Try direct access first (supports literal keys with dots)\n  if (path in obj) return obj[path];\n\n  // Parse and traverse path - matches: word characters, numbers\n  // Regex: /[^.[\\]]+/g matches segments between dots and brackets\n  const parts = path.match(/[^.[\\]]+/g) || [];\n  let value: unknown = obj;\n\n  for (const part of parts) {\n    if (value == null || typeof value !== 'object') return undefined;\n    value = (value as Record<string, unknown>)[part];\n  }\n\n  return value;\n};\n\n/**\n * Interpolate variables into a template string.\n *\n * Template format: {variableName} or {nested.path} or {array[0]}\n *\n * @param template - Template string with {variable} placeholders\n * @param vars - Variables object\n * @param options - Interpolation options\n * @returns Interpolated string\n * @throws {MissingVariableError} When missingVar is 'error' and a variable is not found\n */\nconst interpolate = (\n  template: string,\n  vars: Record<string, unknown>,\n  options: {\n    locale?: Locale;\n    missingVar?: 'preserve' | 'empty' | 'error';\n    key?: string; // For better error messages\n  } = {},\n): string => {\n  const missingVar = options.missingVar ?? 'empty';\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Variable interpolation requires conditional logic\n  return template.replace(/\\{([\\w.[\\]]+)}/g, (match, key) => {\n    const value = resolvePath(vars, key);\n\n    if (value == null) {\n      if (missingVar === 'preserve') return match;\n      if (missingVar === 'error') {\n        throw new MissingVariableError(options.key ?? 'unknown', key, options.locale ?? 'unknown');\n      }\n      return '';\n    }\n\n    // Format numbers with locale\n    if (typeof value === 'number' && options.locale) {\n      try {\n        return new Intl.NumberFormat(options.locale).format(value);\n      } catch {\n        // Fall through to string conversion\n      }\n    }\n\n    return String(value);\n  });\n};\n\n/* Pluralization */\n\ntype PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';\n\n/**\n * Get the plural form for a number in a given locale using Intl.PluralRules API.\n *\n * Automatically handles all locale-specific plural rules including:\n * - English: one/other\n * - Arabic: zero/one/two/few/many/other\n * - Russian/Polish: one/few/many/other\n * - And 100+ other languages\n *\n * @param locale - Locale string (e.g., 'en-US', 'fr')\n * @param count - Number to pluralize\n * @returns Plural category\n */\nconst getPluralForm = (locale: Locale, count: number): PluralCategory => {\n  const n = Math.abs(Math.floor(count));\n\n  try {\n    const pluralRules = new Intl.PluralRules(locale);\n    return pluralRules.select(n) as PluralCategory;\n  } catch {\n    // Fallback to English-like behavior if locale is invalid\n    return n === 1 ? 'one' : 'other';\n  }\n};\n\ntype LocaleChangeHandler = (locale: Locale) => void;\n\nclass I18n {\n  private locale: Locale;\n  private fallbacks: Locale[];\n  private catalogs = new Map<Locale, Messages>();\n  private loaders = new Map<Locale, () => Promise<Messages>>();\n  private loading = new Map<Locale, Promise<void>>();\n  private subscribers = new Set<LocaleChangeHandler>();\n\n  private escape: boolean;\n  private missingKey: (key: string, locale: Locale) => string;\n  private missingVar: 'preserve' | 'empty' | 'error';\n\n  constructor(config: I18nConfig = {}) {\n    this.locale = config.locale ?? 'en';\n    this.fallbacks = Array.isArray(config.fallback) ? config.fallback : config.fallback ? [config.fallback] : [];\n\n    this.escape = config.escape ?? false;\n    this.missingKey = config.missingKey ?? ((key) => key);\n    this.missingVar = config.missingVar ?? 'empty';\n\n    if (config.messages) {\n      for (const [locale, messages] of Object.entries(config.messages)) {\n        this.catalogs.set(locale, messages);\n      }\n    }\n\n    if (config.loaders) {\n      for (const [locale, loader] of Object.entries(config.loaders)) {\n        this.loaders.set(locale, loader);\n      }\n    }\n  }\n\n  // Locale Management\n\n  setLocale(locale: Locale): void {\n    if (this.locale === locale) return;\n    this.locale = locale;\n    this.notifySubscribers();\n  }\n\n  getLocale(): Locale {\n    return this.locale;\n  }\n\n  // Message Management\n\n  add(locale: Locale, messages: Messages): void {\n    const existing = this.catalogs.get(locale) ?? {};\n    this.catalogs.set(locale, { ...existing, ...messages });\n    this.notifySubscribers();\n  }\n\n  set(locale: Locale, messages: Messages): void {\n    this.catalogs.set(locale, messages);\n    this.notifySubscribers();\n  }\n\n  getMessages(locale: Locale): Messages | undefined {\n    return this.catalogs.get(locale);\n  }\n\n  hasLocale(locale: Locale): boolean {\n    return this.catalogs.has(locale);\n  }\n\n  has(key: string, locale?: Locale): boolean {\n    return this.findMessage(key, locale) !== undefined;\n  }\n\n  // Async Loaders\n\n  async load(locale: Locale): Promise<void> {\n    if (this.loading.has(locale)) return this.loading.get(locale);\n    if (this.catalogs.has(locale)) return;\n\n    const loader = this.loaders.get(locale);\n    if (!loader) return;\n\n    const promise = (async () => {\n      try {\n        const messages = await loader();\n        this.add(locale, messages);\n      } catch (error) {\n        // Log loader failures for visibility\n        console.warn(`[I18n] Failed to load locale '${locale}':`, error);\n        // Re-throw so callers can handle errors\n        throw error;\n      } finally {\n        this.loading.delete(locale);\n      }\n    })();\n\n    this.loading.set(locale, promise);\n    return promise;\n  }\n\n  register(locale: Locale, loader: () => Promise<Messages>): void {\n    this.loaders.set(locale, loader);\n  }\n\n  async hasAsync(key: string, locale?: Locale): Promise<boolean> {\n    const targetLocale = locale ?? this.locale;\n    if (!this.catalogs.has(targetLocale) && this.loaders.has(targetLocale)) {\n      await this.load(targetLocale);\n    }\n    return this.has(key, targetLocale);\n  }\n\n  // Translation\n\n  t(key: string, vars?: Record<string, unknown>, options?: TranslateParams): string {\n    const opts = options ?? {};\n    const targetLocale = opts.locale ?? this.locale;\n    const shouldEscape = opts.escape ?? this.escape;\n\n    const message = this.findMessage(key, targetLocale);\n    if (message === undefined) {\n      return opts.fallback ?? this.missingKey(key, targetLocale);\n    }\n\n    return this.formatMessage(message, vars ?? {}, targetLocale, shouldEscape, key);\n  }\n\n  async tl(key: string, vars?: Record<string, unknown>, options?: TranslateParams): Promise<string> {\n    const targetLocale = options?.locale ?? this.locale;\n\n    if (!this.catalogs.has(targetLocale) && this.loaders.has(targetLocale)) {\n      try {\n        await this.load(targetLocale);\n      } catch {\n        // Loader errors are already logged in load(), continue with fallback\n        // This catch prevents the error from propagating to the caller\n      }\n    }\n\n    return this.t(key, vars, options);\n  }\n\n  // Formatting Helpers\n\n  number(value: number, options?: Intl.NumberFormatOptions, locale?: Locale): string {\n    try {\n      return new Intl.NumberFormat(locale ?? this.locale, options).format(value);\n    } catch {\n      return String(value);\n    }\n  }\n\n  date(value: Date | number, options?: Intl.DateTimeFormatOptions, locale?: Locale): string {\n    const date = typeof value === 'number' ? new Date(value) : value;\n    try {\n      return new Intl.DateTimeFormat(locale ?? this.locale, options).format(date);\n    } catch {\n      return date.toString();\n    }\n  }\n\n  // Namespaced Translator\n\n  namespace(ns: string) {\n    return {\n      t: (key: string, vars?: Record<string, unknown>, options?: TranslateParams) =>\n        this.t(`${ns}.${key}`, vars, options),\n      tl: (key: string, vars?: Record<string, unknown>, options?: TranslateParams) =>\n        this.tl(`${ns}.${key}`, vars, options),\n    };\n  }\n\n  // Subscriptions\n\n  subscribe(handler: LocaleChangeHandler): () => void {\n    this.subscribers.add(handler);\n    try {\n      handler(this.locale);\n    } catch {\n      // Ignore handler errors\n    }\n    return () => this.subscribers.delete(handler);\n  }\n\n  private notifySubscribers(): void {\n    for (const handler of this.subscribers) {\n      try {\n        handler(this.locale);\n      } catch {\n        // Ignore handler errors\n      }\n    }\n  }\n\n  // Internal Helpers\n\n  private findMessage(key: string, locale?: Locale): MessageValue | undefined {\n    const locales = this.getLocaleChain(locale ?? this.locale);\n\n    for (const loc of locales) {\n      const messages = this.catalogs.get(loc);\n      if (!messages) continue;\n\n      const value = resolvePath(messages, key);\n      if (value !== undefined) return value as MessageValue;\n    }\n\n    return undefined;\n  }\n\n  private getLocaleChain(locale: Locale): Locale[] {\n    const chain: Locale[] = [locale];\n\n    // Add base language (e.g., 'en' from 'en-US')\n    const lang = locale.split('-')[0];\n    if (lang !== locale) chain.push(lang);\n\n    // Add fallback locales\n    for (const fallback of this.fallbacks) {\n      chain.push(fallback);\n      const fallbackLang = fallback.split('-')[0];\n      if (fallbackLang !== fallback) chain.push(fallbackLang);\n    }\n\n    return chain;\n  }\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: -\n  private formatMessage(\n    message: MessageValue,\n    vars: Record<string, unknown>,\n    locale: Locale,\n    shouldEscape: boolean,\n    key?: string,\n  ): string {\n    // Handle function messages\n    if (typeof message === 'function') {\n      try {\n        const result = message(vars, {\n          date: (d, opts) => this.date(d, opts, locale),\n          number: (v, opts) => this.number(v, opts, locale),\n        });\n        return shouldEscape ? escapeHtml(result) : result;\n      } catch {\n        return '';\n      }\n    }\n\n    // Handle plural messages\n    if (typeof message === 'object' && 'other' in message) {\n      const count = Number(vars.count ?? 0);\n      const pluralMsg = message as PluralMessages;\n\n      // Prefer an explicit 'zero' form when the count is 0\n      let form: PluralForm;\n      if (count === 0 && pluralMsg.zero !== undefined) {\n        form = 'zero';\n      } else {\n        form = getPluralForm(locale, count);\n      }\n\n      const template = pluralMsg[form] ?? pluralMsg.other;\n      const result = interpolate(template, vars, { key, locale, missingVar: this.missingVar });\n      return shouldEscape ? escapeHtml(result) : result;\n    }\n\n    // Handle string messages\n    if (typeof message === 'string') {\n      const result = interpolate(message, vars, { key, locale, missingVar: this.missingVar });\n      return shouldEscape ? escapeHtml(result) : result;\n    }\n\n    return '';\n  }\n}\n\nexport function createI18n(config?: I18nConfig): I18n {\n  return new I18n(config);\n}\n"],"names":["MissingVariableError","key","variable","locale","HTML_ENTITIES","escapeHtml","str","char","resolvePath","obj","path","parts","value","part","interpolate","template","vars","options","missingVar","match","getPluralForm","count","n","I18n","config","messages","loader","existing","promise","error","targetLocale","opts","shouldEscape","message","date","ns","handler","locales","loc","chain","lang","fallback","fallbackLang","result","d","v","pluralMsg","form","createI18n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./i18nit.cjs");exports.MissingVariableError=r.MissingVariableError;exports.createI18n=r.createI18n;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+export declare function createI18n(config?: I18nConfig): I18n;
+
+declare class I18n {
+    private locale;
+    private fallbacks;
+    private catalogs;
+    private loaders;
+    private loading;
+    private subscribers;
+    private escape;
+    private missingKey;
+    private missingVar;
+    constructor(config?: I18nConfig);
+    setLocale(locale: Locale): void;
+    getLocale(): Locale;
+    add(locale: Locale, messages: Messages): void;
+    set(locale: Locale, messages: Messages): void;
+    getMessages(locale: Locale): Messages | undefined;
+    hasLocale(locale: Locale): boolean;
+    has(key: string, locale?: Locale): boolean;
+    load(locale: Locale): Promise<void>;
+    register(locale: Locale, loader: () => Promise<Messages>): void;
+    hasAsync(key: string, locale?: Locale): Promise<boolean>;
+    t(key: string, vars?: Record<string, unknown>, options?: TranslateParams): string;
+    tl(key: string, vars?: Record<string, unknown>, options?: TranslateParams): Promise<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?: TranslateParams) => string;
+        tl: (key: string, vars?: Record<string, unknown>, options?: TranslateParams) => Promise<string>;
+    };
+    subscribe(handler: LocaleChangeHandler): () => void;
+    private notifySubscribers;
+    private findMessage;
+    private getLocaleChain;
+    private formatMessage;
+}
+
+export declare type I18nConfig = {
+    locale?: Locale;
+    fallback?: Locale | Locale[];
+    messages?: Record<Locale, Messages>;
+    loaders?: Record<Locale, () => Promise<Messages>>;
+    escape?: boolean;
+    missingKey?: (key: string, locale: Locale) => string;
+    missingVar?: 'preserve' | 'empty' | 'error';
+};
+
+export declare type Locale = string;
+
+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;
+
+/**
+ * Error thrown when a required variable is missing during interpolation.
+ */
+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 PluralForm = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
+
+export declare type PluralMessages = Partial<Record<PluralForm, string>> & {
+    other: string;
+};
+
+export declare type TranslateParams = {
+    locale?: Locale;
+    fallback?: string;
+    escape?: boolean;
+};
+
+export { }

package/dist/index.js

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

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@vielzeug/i18nit",
+  "version": "1.1.1",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsc && vite build",
+    "fix": "biome check --write --unsafe src",
+    "lint": "biome check src",
+    "prepublishOnly": "npm run build",
+    "preview": "vite preview",
+    "test": "vitest"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.18"
+  }
+}