@ooneex/translation 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ooneex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,657 @@
+# @ooneex/translation
+
+A comprehensive TypeScript/JavaScript library for internationalization (i18n) and localization (l10n). This package provides powerful translation utilities with support for multiple languages, parameter interpolation, pluralization, and nested key structures.
+
+![Browser](https://img.shields.io/badge/Browser-Compatible-green?style=flat-square&logo=googlechrome)
+![Bun](https://img.shields.io/badge/Bun-Compatible-orange?style=flat-square&logo=bun)
+![Deno](https://img.shields.io/badge/Deno-Compatible-blue?style=flat-square&logo=deno)
+![Node.js](https://img.shields.io/badge/Node.js-Compatible-green?style=flat-square&logo=node.js)
+![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)
+![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)
+
+## Features
+
+✅ **Multi-Language Support** - 31 supported locales including Arabic, Chinese, French, Spanish, and more
+
+✅ **Type-Safe** - Full TypeScript support with proper type definitions
+
+✅ **Parameter Interpolation** - Replace placeholders with dynamic values
+
+✅ **Pluralization Support** - Handle singular, plural, and zero forms automatically
+
+✅ **Nested Keys** - Support for dot notation in translation keys
+
+✅ **Flexible Input** - Accept both dictionary keys and direct translation objects
+
+✅ **Fallback System** - Graceful fallbacks to English or base keys
+
+✅ **Error Handling** - Custom exceptions for missing translations
+
+✅ **Lightweight** - Minimal dependencies and optimized bundle size
+
+✅ **Cross-Platform** - Works in Browser, Node.js, Bun, and Deno
+
+## Installation
+
+### Bun
+```bash
+bun add @ooneex/translation
+```
+
+### pnpm
+```bash
+pnpm add @ooneex/translation
+```
+
+### Yarn
+```bash
+yarn add @ooneex/translation
+```
+
+### npm
+```bash
+npm install @ooneex/translation
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { trans } from '@ooneex/translation';
+
+// Using dictionary with string keys
+const dictionary = {
+  greeting: {
+    en: 'Hello, World!',
+    fr: 'Bonjour, le monde!',
+    es: 'Hola, mundo!'
+  }
+};
+
+// Get English translation (default)
+const english = trans('greeting', { dict: dictionary });
+console.log(english); // "Hello, World!"
+
+// Get French translation
+const french = trans('greeting', {
+  lang: 'fr',
+  dict: dictionary
+});
+console.log(french); // "Bonjour, le monde!"
+
+// Using direct translation objects
+const directTranslation = {
+  en: 'Welcome',
+  fr: 'Bienvenue',
+  es: 'Bienvenido'
+};
+
+const welcome = trans(directTranslation, { lang: 'fr' });
+console.log(welcome); // "Bienvenue"
+```
+
+### Parameter Interpolation
+
+```typescript
+import { trans } from '@ooneex/translation';
+
+const dictionary = {
+  welcome: {
+    en: 'Welcome, {{ name }}!',
+    fr: 'Bienvenue, {{ name }}!',
+    es: '¡Bienvenido, {{ name }}!'
+  },
+  userInfo: {
+    en: 'User {{ name }} has {{ count }} points',
+    fr: 'L\'utilisateur {{ name }} a {{ count }} points'
+  }
+};
+
+// Single parameter
+const greeting = trans('welcome', {
+  lang: 'en',
+  dict: dictionary,
+  params: { name: 'John' }
+});
+console.log(greeting); // "Welcome, John!"
+
+// Multiple parameters
+const info = trans('userInfo', {
+  lang: 'en',
+  dict: dictionary,
+  params: { name: 'Alice', count: 150 }
+});
+console.log(info); // "User Alice has 150 points"
+
+// Different parameter types
+const stats = trans('stats', {
+  dict: {
+    stats: {
+      en: 'Active: {{ active }}, Score: {{ score }}, ID: {{ id }}'
+    }
+  },
+  params: {
+    active: true,
+    score: 95.5,
+    id: 12345
+  }
+});
+console.log(stats); // "Active: true, Score: 95.5, ID: 12345"
+```
+
+### Pluralization
+
+```typescript
+import { trans } from '@ooneex/translation';
+
+const dictionary = {
+  item: {
+    en: '{{ count }} item',
+    fr: '{{ count }} élément'
+  },
+  item_plural: {
+    en: '{{ count }} items',
+    fr: '{{ count }} éléments'
+  },
+  message: {
+    en: '{{ count }} message',
+    fr: '{{ count }} message'
+  },
+  message_plural: {
+    en: '{{ count }} messages',
+    fr: '{{ count }} messages'
+  },
+  message_zero: {
+    en: 'No messages',
+    fr: 'Aucun message'
+  }
+};
+
+// Singular form (count = 1)
+const singular = trans('item', {
+  lang: 'en',
+  dict: dictionary,
+  count: 1
+});
+console.log(singular); // "1 item"
+
+// Plural form (count > 1)
+const plural = trans('item', {
+  lang: 'en',
+  dict: dictionary,
+  count: 5
+});
+console.log(plural); // "5 items"
+
+// Zero form (count = 0, when available)
+const zero = trans('message', {
+  lang: 'en',
+  dict: dictionary,
+  count: 0
+});
+console.log(zero); // "No messages"
+
+// Zero form fallback to plural (when zero form not available)
+const zeroFallback = trans('item', {
+  lang: 'en',
+  dict: dictionary,
+  count: 0
+});
+console.log(zeroFallback); // "0 items"
+```
+
+### Nested Keys
+
+```typescript
+import { trans } from '@ooneex/translation';
+
+const dictionary = {
+  user: {
+    profile: {
+      name: {
+        en: 'Full Name',
+        fr: 'Nom complet',
+        es: 'Nombre completo'
+      },
+      email: {
+        en: 'Email Address',
+        fr: 'Adresse e-mail'
+      }
+    }
+  },
+  app: {
+    navigation: {
+      home: {
+        en: 'Home',
+        fr: 'Accueil'
+      },
+      about: {
+        en: 'About',
+        fr: 'À propos'
+      }
+    }
+  }
+};
+
+// Access nested keys with dot notation
+const profileName = trans('user.profile.name', {
+  lang: 'fr',
+  dict: dictionary
+});
+console.log(profileName); // "Nom complet"
+
+const homeNav = trans('app.navigation.home', {
+  lang: 'en',
+  dict: dictionary
+});
+console.log(homeNav); // "Home"
+```
+
+### Advanced Usage
+
+```typescript
+import { trans, locales, TranslationException } from '@ooneex/translation';
+
+// Check supported locales
+console.log(locales); // ['ar', 'bg', 'cs', 'da', 'de', 'el', 'en', ...]
+
+// Error handling
+try {
+  const result = trans('nonexistent.key', {
+    dict: {},
+    lang: 'en'
+  });
+} catch (error) {
+  if (error instanceof TranslationException) {
+    console.log('Translation not found:', error.message);
+  }
+}
+
+// Complex real-world example
+const appDictionary = {
+  notifications: {
+    unread: {
+      en: 'You have {{ count }} unread notification',
+      fr: 'Vous avez {{ count }} notification non lue'
+    },
+    unread_plural: {
+      en: 'You have {{ count }} unread notifications',
+      fr: 'Vous avez {{ count }} notifications non lues'
+    },
+    unread_zero: {
+      en: 'No unread notifications',
+      fr: 'Aucune notification non lue'
+    }
+  },
+  validation: {
+    required: {
+      en: 'The {{ field }} field is required',
+      fr: 'Le champ {{ field }} est requis'
+    },
+    minLength: {
+      en: 'The {{ field }} must be at least {{ min }} characters',
+      fr: 'Le {{ field }} doit contenir au moins {{ min }} caractères'
+    }
+  }
+};
+
+// Notification with pluralization
+const notification = trans('notifications.unread', {
+  lang: 'en',
+  dict: appDictionary,
+  count: 3
+});
+console.log(notification); // "You have 3 unread notifications"
+
+// Form validation with parameters
+const validation = trans('validation.minLength', {
+  lang: 'fr',
+  dict: appDictionary,
+  params: { field: 'mot de passe', min: 8 }
+});
+console.log(validation); // "Le mot de passe doit contenir au moins 8 caractères"
+```
+
+## API Reference
+
+### `trans<T extends string>(key, options?): T`
+
+The main translation function that handles all translation scenarios.
+
+**Parameters:**
+- `key`: `string | Record<LocaleType, string>` - Translation key (dot notation supported) or direct translation object
+- `options?`: `Object` - Translation options
+  - `lang?`: `LocaleType` - Target language (defaults to 'en')
+  - `params?`: `Record<string, boolean | number | bigint | string>` - Parameters for interpolation
+  - `dict?`: `Record<string, unknown>` - Translation dictionary (required when using string keys)
+  - `count?`: `number` - Count for pluralization
+
+**Returns:** Translated string
+
+**Example:**
+```typescript
+// String key with dictionary
+trans('greeting', { lang: 'fr', dict: dictionary });
+
+// Direct translation object
+trans({ en: 'Hello', fr: 'Bonjour' }, { lang: 'fr' });
+
+// With parameters
+trans('welcome', {
+  dict: dictionary,
+  params: { name: 'John' }
+});
+
+// With pluralization
+trans('item', {
+  dict: dictionary,
+  count: 5
+});
+```
+
+### Types
+
+#### `LocaleType`
+TypeScript type representing all supported locale codes.
+
+**Supported locales:**
+```typescript
+type LocaleType = 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'eo' | 'es' | 'et' | 'eu' | 'fi' | 'fr' | 'hu' | 'hy' | 'it' | 'ja' | 'ko' | 'lt' | 'nl' | 'no' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sv' | 'th' | 'uk' | 'zh' | 'zh-tw';
+```
+
+#### `LocaleInfoType`
+Type for locale information including region data.
+
+```typescript
+type LocaleInfoType = {
+  code: LocaleType;
+  region: string | null;
+};
+```
+
+### Constants
+
+#### `locales`
+Array of all supported locale codes.
+
+```typescript
+const locales: readonly LocaleType[];
+```
+
+### Exceptions
+
+#### `TranslationException`
+Custom exception thrown when translations are not found or invalid.
+
+**Properties:**
+- Extends base `Exception` class
+- HTTP status: 404 (Not Found)
+- Includes translation key and context information
+
+**Example:**
+```typescript
+try {
+  trans('missing.key', { dict: {} });
+} catch (error) {
+  if (error instanceof TranslationException) {
+    console.log(error.message); // "Translation key 'missing.key' not found"
+  }
+}
+```
+
+## Translation Dictionary Structure
+
+### Basic Structure
+```typescript
+const dictionary = {
+  keyName: {
+    en: 'English translation',
+    fr: 'French translation',
+    es: 'Spanish translation'
+    // ... other locales
+  }
+};
+```
+
+### Nested Structure
+```typescript
+const dictionary = {
+  section: {
+    subsection: {
+      keyName: {
+        en: 'English translation',
+        fr: 'French translation'
+      }
+    }
+  }
+};
+```
+
+### Pluralization Structure
+```typescript
+const dictionary = {
+  // Singular form (count = 1)
+  item: {
+    en: '{{ count }} item',
+    fr: '{{ count }} élément'
+  },
+  // Plural form (count != 1, except 0 if zero form exists)
+  item_plural: {
+    en: '{{ count }} items',
+    fr: '{{ count }} éléments'
+  },
+  // Zero form (count = 0, optional)
+  item_zero: {
+    en: 'No items',
+    fr: 'Aucun élément'
+  }
+};
+```
+
+## Pluralization Rules
+
+1. **count = 1**: Uses the base key (singular form)
+2. **count = 0**: Uses `key_zero` if available, otherwise falls back to `key_plural`
+3. **count > 1 or count < 0**: Uses `key_plural`
+4. **Fallback**: If plural forms don't exist, falls back to singular form
+
+## Fallback Strategy
+
+1. **Language fallback**: If requested language not available, falls back to English ('en')
+2. **Key fallback**: If translation key not found, returns the key itself
+3. **Pluralization fallback**: If plural forms don't exist, uses singular form
+4. **Empty translation**: Throws `TranslationException` for empty translations
+
+## Best Practices
+
+### 1. Organize Dictionary Structure
+```typescript
+// Good: Organized by feature/section
+const dictionary = {
+  auth: {
+    login: { en: 'Log In', fr: 'Se connecter' },
+    logout: { en: 'Log Out', fr: 'Se déconnecter' }
+  },
+  navigation: {
+    home: { en: 'Home', fr: 'Accueil' },
+    about: { en: 'About', fr: 'À propos' }
+  }
+};
+```
+
+### 2. Use Consistent Parameter Names
+```typescript
+// Good: Consistent naming
+const dictionary = {
+  welcome: { en: 'Welcome, {{ username }}!' },
+  goodbye: { en: 'Goodbye, {{ username }}!' }
+};
+```
+
+### 3. Handle Pluralization Properly
+```typescript
+// Good: Complete pluralization support
+const dictionary = {
+  notification: { en: '{{ count }} notification' },
+  notification_plural: { en: '{{ count }} notifications' },
+  notification_zero: { en: 'No notifications' }
+};
+```
+
+### 4. Provide Fallbacks
+```typescript
+// Good: Always include English translations
+const dictionary = {
+  greeting: {
+    en: 'Hello',
+    fr: 'Bonjour',
+    es: 'Hola'
+    // en is always available as fallback
+  }
+};
+```
+
+## Error Handling
+
+The package throws `TranslationException` in the following cases:
+
+- Translation key not found in dictionary
+- Nested key path doesn't exist
+- Translation value is empty
+- String key used without dictionary
+
+```typescript
+try {
+  const result = trans('missing.key', { dict: dictionary });
+} catch (error) {
+  if (error instanceof TranslationException) {
+    // Handle translation error
+    console.warn('Translation missing:', error.message);
+    // Provide fallback or default value
+    return 'Fallback text';
+  }
+}
+```
+
+## Performance Considerations
+
+- **Dictionary Caching**: Cache translation dictionaries to avoid repeated parsing
+- **Lazy Loading**: Load only required translations for better performance
+- **Nested Key Optimization**: Avoid deeply nested structures when possible
+- **Parameter Validation**: Validate parameters before passing to avoid runtime errors
+
+## Real-world Examples
+
+### E-commerce Application
+```typescript
+const ecommerceDict = {
+  product: {
+    price: {
+      en: 'Price: ${{ amount }}',
+      fr: 'Prix : {{ amount }} $'
+    },
+    availability: {
+      en: '{{ count }} in stock',
+      fr: '{{ count }} en stock'
+    },
+    availability_zero: {
+      en: 'Out of stock',
+      fr: 'Rupture de stock'
+    }
+  },
+  cart: {
+    item: {
+      en: '{{ count }} item',
+      fr: '{{ count }} article'
+    },
+    item_plural: {
+      en: '{{ count }} items',
+      fr: '{{ count }} articles'
+    },
+    total: {
+      en: 'Total: ${{ amount }}',
+      fr: 'Total : {{ amount }} $'
+    }
+  }
+};
+
+// Usage
+const price = trans('product.price', {
+  dict: ecommerceDict,
+  lang: 'en',
+  params: { amount: '29.99' }
+});
+
+const cartItems = trans('cart.item', {
+  dict: ecommerceDict,
+  lang: 'fr',
+  count: 3
+});
+```
+
+### User Dashboard
+```typescript
+const dashboardDict = {
+  dashboard: {
+    welcome: {
+      en: 'Welcome back, {{ username }}!',
+      fr: 'Bon retour, {{ username }} !'
+    },
+    stats: {
+      unread: {
+        en: 'You have {{ count }} unread message',
+        fr: 'Vous avez {{ count }} message non lu'
+      },
+      unread_plural: {
+        en: 'You have {{ count }} unread messages',
+        fr: 'Vous avez {{ count }} messages non lus'
+      },
+      unread_zero: {
+        en: 'No unread messages',
+        fr: 'Aucun message non lu'
+      }
+    }
+  }
+};
+
+// Usage
+const welcome = trans('dashboard.welcome', {
+  dict: dashboardDict,
+  lang: 'fr',
+  params: { username: 'Marie' }
+});
+
+const messages = trans('dashboard.stats.unread', {
+  dict: dashboardDict,
+  lang: 'en',
+  count: 0
+});
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+### Development Setup
+
+1. Clone the repository
+2. Install dependencies: `bun install`
+3. Run tests: `bun run test`
+4. Build the project: `bun run build`
+
+### Guidelines
+
+- Write tests for new features
+- Follow the existing code style
+- Update documentation for API changes
+- Ensure all tests pass before submitting PR
+- Add new locales to the supported list when needed
+
+---
+
+Made with ❤️ by the Ooneex team

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+declare const locales: readonly ["ar", "bg", "cs", "da", "de", "el", "en", "eo", "es", "et", "eu", "fi", "fr", "hu", "hy", "it", "ja", "ko", "lt", "nl", "no", "pl", "pt", "ro", "ru", "sk", "sv", "th", "uk", "zh", "zh-tw"];
+import { Exception } from "@ooneex/exception";
+declare class TranslationException extends Exception {
+	constructor(message: string, data?: Record<string, unknown>);
+}
+type LocaleType = (typeof locales)[number];
+type LocaleInfoType = {
+	code: LocaleType;
+	region: string | null;
+};
+declare const trans: <T extends string>(key: string | Record<LocaleType, string>, options?: {
+	lang?: LocaleType;
+	params?: Record<string, boolean | number | bigint | string>;
+	dict?: Record<string, unknown>;
+	count?: number;
+}) => T;
+export { trans, locales, TranslationException, LocaleType, LocaleInfoType };

package/dist/index.js

@@ -0,0 +1,3 @@
+var q=["ar","bg","cs","da","de","el","en","eo","es","et","eu","fi","fr","hu","hy","it","ja","ko","lt","nl","no","pl","pt","ro","ru","sk","sv","th","uk","zh","zh-tw"];import{Exception as I}from"@ooneex/exception";import{HttpStatus as S}from"@ooneex/http-status";class C extends I{constructor(o,h={}){super(o,{status:S.Code.NotFound,data:h});this.name="TranslationException"}}var H=(o,h)=>h.split(".").reduce((p,L)=>p&&typeof p==="object"&&p!==null&&(L in p)?p[L]:void 0,o),J=(o,h)=>{let{lang:p="en",params:L,dict:F,count:w}=h||{},m="";if(typeof o==="string"&&F){let f=o;if(w!==void 0)if(w===0){let s=`${o}_zero`;if(H(F,s))f=s;else f=`${o}_plural`}else if(w===1)f=o;else f=`${o}_plural`;let j=H(F,f);if(j)m=j[p]||j.en||o;else if(f!==o){let s=H(F,o);if(s)m=s[p]||s.en||o;else throw new C(`Translation key "${o}" not found`)}else throw new C(`Translation key "${o}" not found`)}else if(typeof o==="object")m=o[p]||o.en;if(!m)throw new C("Translation value is empty");if(L)for(let[f,j]of Object.entries(L))m=m.replace(`{{ ${f} }}`,j.toString());if(w!==void 0)m=m.replace(/\{\{ count \}\}/g,w.toString());return m};export{J as trans,q as locales,C as TranslationException};
+
+//# debugId=9CE459E1BD46321164756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["src/locales.ts", "src/TranslationException.ts", "src/trans.ts"],
+  "sourcesContent": [
+    "export const locales = [\n  \"ar\",\n  \"bg\",\n  \"cs\",\n  \"da\",\n  \"de\",\n  \"el\",\n  \"en\",\n  \"eo\",\n  \"es\",\n  \"et\",\n  \"eu\",\n  \"fi\",\n  \"fr\",\n  \"hu\",\n  \"hy\",\n  \"it\",\n  \"ja\",\n  \"ko\",\n  \"lt\",\n  \"nl\",\n  \"no\",\n  \"pl\",\n  \"pt\",\n  \"ro\",\n  \"ru\",\n  \"sk\",\n  \"sv\",\n  \"th\",\n  \"uk\",\n  \"zh\",\n  \"zh-tw\",\n] as const;\n",
+    "import { Exception } from \"@ooneex/exception\";\nimport { HttpStatus } from \"@ooneex/http-status\";\n\nexport class TranslationException extends Exception {\n  constructor(message: string, data: Record<string, unknown> = {}) {\n    super(message, {\n      status: HttpStatus.Code.NotFound,\n      data,\n    });\n    this.name = \"TranslationException\";\n  }\n}\n",
+    "import { TranslationException } from \"./TranslationException\";\nimport type { LocaleType } from \"./types\";\n\nconst getNestedValue = (dict: unknown, path: string): unknown =>\n  path\n    .split(\".\")\n    .reduce(\n      (current, key) =>\n        current && typeof current === \"object\" && current !== null && key in current\n          ? (current as Record<string, unknown>)[key]\n          : undefined,\n      dict,\n    );\n\nexport const trans = <T extends string>(\n  key: string | Record<LocaleType, string>,\n  options?: {\n    lang?: LocaleType;\n    params?: Record<string, boolean | number | bigint | string>;\n    dict?: Record<string, unknown>;\n    count?: number;\n  },\n): T => {\n  const { lang = \"en\", params, dict, count } = options || {};\n  let text = \"\";\n\n  if (typeof key === \"string\" && dict) {\n    let translationKey = key;\n\n    // Handle pluralization\n    if (count !== undefined) {\n      if (count === 0) {\n        // Try zero form first, fallback to plural\n        const zeroKey = `${key}_zero`;\n        const zeroEntry = getNestedValue(dict, zeroKey) as Record<LocaleType, string>;\n        if (zeroEntry) {\n          translationKey = zeroKey;\n        } else {\n          translationKey = `${key}_plural`;\n        }\n      } else if (count === 1) {\n        // Use singular form (original key)\n        translationKey = key;\n      } else {\n        // Use plural form\n        translationKey = `${key}_plural`;\n      }\n    }\n\n    const translationEntry = getNestedValue(dict, translationKey) as Record<LocaleType, string>;\n\n    if (translationEntry) {\n      text = translationEntry[lang as keyof typeof translationEntry] || translationEntry.en || key;\n    } else {\n      // Fallback to original key if plural form not found\n      if (translationKey !== key) {\n        const fallbackEntry = getNestedValue(dict, key) as Record<LocaleType, string>;\n        if (fallbackEntry) {\n          text = fallbackEntry[lang as keyof typeof fallbackEntry] || fallbackEntry.en || key;\n        } else {\n          throw new TranslationException(`Translation key \"${key}\" not found`);\n        }\n      } else {\n        throw new TranslationException(`Translation key \"${key}\" not found`);\n      }\n    }\n  } else if (typeof key === \"object\") {\n    text = key[lang as keyof typeof key] || key.en;\n  }\n\n  if (!text) {\n    throw new TranslationException(\"Translation value is empty\");\n  }\n\n  // Replace parameters\n  if (params) {\n    for (const [paramKey, value] of Object.entries(params)) {\n      text = (text as string).replace(`{{ ${paramKey} }}`, value.toString());\n    }\n  }\n\n  // Replace count parameter if provided\n  if (count !== undefined) {\n    text = (text as string).replace(/\\{\\{ count \\}\\}/g, count.toString());\n  }\n\n  return text as T;\n};\n"
+  ],
+  "mappings": "AAAO,IAAM,EAAU,CACrB,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,KACA,OACF,EChCA,oBAAS,0BACT,qBAAS,4BAEF,MAAM,UAA6B,CAAU,CAClD,WAAW,CAAC,EAAiB,EAAgC,CAAC,EAAG,CAC/D,MAAM,EAAS,CACb,OAAQ,EAAW,KAAK,SACxB,MACF,CAAC,EACD,KAAK,KAAO,uBAEhB,CCRA,IAAM,EAAiB,CAAC,EAAe,IACrC,EACG,MAAM,GAAG,EACT,OACC,CAAC,EAAS,IACR,GAAW,OAAO,IAAY,UAAY,IAAY,OAAQ,KAAO,GAChE,EAAoC,GACrC,OACN,CACF,EAES,EAAQ,CACnB,EACA,IAMM,CACN,IAAQ,OAAO,KAAM,SAAQ,OAAM,SAAU,GAAW,CAAC,EACrD,EAAO,GAEX,GAAI,OAAO,IAAQ,UAAY,EAAM,CACnC,IAAI,EAAiB,EAGrB,GAAI,IAAU,OACZ,GAAI,IAAU,EAAG,CAEf,IAAM,EAAU,GAAG,SAEnB,GADkB,EAAe,EAAM,CAAO,EAE5C,EAAiB,EAEjB,OAAiB,GAAG,WAEjB,QAAI,IAAU,EAEnB,EAAiB,EAGjB,OAAiB,GAAG,WAIxB,IAAM,EAAmB,EAAe,EAAM,CAAc,EAE5D,GAAI,EACF,EAAO,EAAiB,IAA0C,EAAiB,IAAM,EAGzF,QAAI,IAAmB,EAAK,CAC1B,IAAM,EAAgB,EAAe,EAAM,CAAG,EAC9C,GAAI,EACF,EAAO,EAAc,IAAuC,EAAc,IAAM,EAEhF,WAAM,IAAI,EAAqB,oBAAoB,cAAgB,EAGrE,WAAM,IAAI,EAAqB,oBAAoB,cAAgB,EAGlE,QAAI,OAAO,IAAQ,SACxB,EAAO,EAAI,IAA6B,EAAI,GAG9C,GAAI,CAAC,EACH,MAAM,IAAI,EAAqB,4BAA4B,EAI7D,GAAI,EACF,QAAY,EAAU,KAAU,OAAO,QAAQ,CAAM,EACnD,EAAQ,EAAgB,QAAQ,MAAM,OAAe,EAAM,SAAS,CAAC,EAKzE,GAAI,IAAU,OACZ,EAAQ,EAAgB,QAAQ,mBAAoB,EAAM,SAAS,CAAC,EAGtE,OAAO",
+  "debugId": "9CE459E1BD46321164756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@ooneex/translation",
+  "description": "",
+  "version": "0.0.1",
+  "type": "module",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "MIT",
+  "scripts": {
+    "test": "bun test tests",
+    "build": "bunup",
+    "lint": "tsgo --noEmit && bunx biome lint",
+    "publish:prod": "bun publish --tolerate-republish --access public",
+    "publish:pack": "bun pm pack --destination ./dist",
+    "publish:dry": "bun publish --dry-run"
+  },
+  "dependencies": {
+    "@ooneex/exception": "0.0.1",
+    "@ooneex/http-status": "0.0.1"
+  },
+  "devDependencies": {}
+}