@gears-frontx/i18n 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,305 @@
+/**
+ * @gears-frontx/i18n - Type Definitions
+ *
+ * Core types for HAI3 internationalization.
+ * Supports 36 languages with RTL support.
+ */
+/**
+ * Text Direction Enum
+ * Defines text direction for RTL language support.
+ */
+declare enum TextDirection {
+    LeftToRight = "ltr",
+    RightToLeft = "rtl"
+}
+/**
+ * Language Enum
+ * All 36 supported languages based on major platforms (Google, Facebook, Microsoft, Apple).
+ */
+declare enum Language {
+    English = "en",
+    Spanish = "es",
+    French = "fr",
+    German = "de",
+    Italian = "it",
+    Portuguese = "pt",
+    Dutch = "nl",
+    Russian = "ru",
+    Polish = "pl",
+    Ukrainian = "uk",
+    Czech = "cs",
+    Arabic = "ar",
+    Hebrew = "he",
+    Persian = "fa",
+    Urdu = "ur",
+    Turkish = "tr",
+    ChineseSimplified = "zh",
+    ChineseTraditional = "zh-TW",
+    Japanese = "ja",
+    Korean = "ko",
+    Vietnamese = "vi",
+    Thai = "th",
+    Indonesian = "id",
+    Hindi = "hi",
+    Bengali = "bn",
+    Swedish = "sv",
+    Danish = "da",
+    Norwegian = "no",
+    Finnish = "fi",
+    Greek = "el",
+    Romanian = "ro",
+    Hungarian = "hu",
+    Malay = "ms",
+    Tagalog = "tl",
+    Tamil = "ta",
+    Swahili = "sw"
+}
+/**
+ * Language Metadata
+ * Complete information about a supported language.
+ */
+interface LanguageMetadata {
+    /** Language code (from Language enum) */
+    code: Language;
+    /** Native name (e.g., 'English', 'العربية') */
+    name: string;
+    /** English name for settings UI */
+    englishName: string;
+    /** Text direction */
+    direction: TextDirection;
+    /** Optional region (e.g., 'US', 'GB', 'TW') */
+    region?: string;
+}
+/**
+ * Language Code Type
+ * Type alias for language codes.
+ */
+type LanguageCode = Language;
+/**
+ * Translation Dictionary
+ * Nested key-value structure for translations.
+ *
+ * @example
+ * ```typescript
+ * const translations: TranslationDictionary = {
+ *   button: {
+ *     submit: 'Submit',
+ *     cancel: 'Cancel',
+ *   },
+ *   messages: {
+ *     success: 'Operation completed successfully',
+ *   },
+ * };
+ * ```
+ */
+interface TranslationDictionary {
+    [key: string]: string | TranslationDictionary;
+}
+/**
+ * Translation Loader Function
+ * Returns translations for a given language using dynamic import.
+ * Accepts both Language enum and string for compatibility with @gears-frontx/layout.
+ *
+ * @example
+ * ```typescript
+ * const loader: TranslationLoader = async (language) => {
+ *   const module = await import(`./i18n/${language}.json`);
+ *   return module.default;
+ * };
+ * ```
+ */
+type TranslationLoader = (language: Language | string) => Promise<TranslationDictionary>;
+/**
+ * Translation Map
+ * Maps languages to their dynamic import functions.
+ * Used by I18nRegistry.createLoader().
+ *
+ * @example
+ * ```typescript
+ * const translationMap: TranslationMap = {
+ *   [Language.English]: () => import('./i18n/en.json'),
+ *   [Language.Spanish]: () => import('./i18n/es.json'),
+ *   // ... all 36 languages
+ * };
+ * ```
+ */
+type TranslationMap = Record<Language, () => Promise<{
+    default: TranslationDictionary;
+}>>;
+/**
+ * I18n Configuration
+ * Configuration options for the i18n system.
+ */
+interface I18nConfig {
+    /** Default language to use */
+    defaultLanguage: LanguageCode;
+    /** Fallback language when translation is missing */
+    fallbackLanguage: LanguageCode;
+}
+/**
+ * Translation Parameters
+ * Parameters for string interpolation.
+ *
+ * @example
+ * ```typescript
+ * // Translation: "Hello, {name}!"
+ * t('greeting', { name: 'John' });  // "Hello, John!"
+ * ```
+ */
+type TranslationParams = Record<string, string | number | boolean>;
+/**
+ * I18n Registry Interface
+ * Central registry for translation management.
+ *
+ * @example
+ * ```typescript
+ * // Register translations
+ * i18nRegistry.registerLoader('screenset.demo', demoLoader);
+ *
+ * // Set language
+ * await i18nRegistry.setLanguage(Language.Spanish);
+ *
+ * // Translate
+ * const text = i18nRegistry.t('screenset.demo:welcome.title');
+ * ```
+ */
+interface I18nRegistry {
+    /**
+     * Register translations for a namespace.
+     *
+     * @param namespace - Translation namespace (e.g., 'screenset.demo')
+     * @param language - Language enum value
+     * @param translations - Translation dictionary
+     */
+    register(namespace: string, language: Language, translations: TranslationDictionary): void;
+    /**
+     * Register a translation loader for a namespace.
+     * Loader is called on-demand when language changes.
+     *
+     * @param namespace - Namespace identifier
+     * @param loader - Function that loads translations
+     */
+    registerLoader(namespace: string, loader: TranslationLoader): void;
+    /**
+     * Translate a key.
+     *
+     * @param key - Format: 'namespace:key.subkey' or just 'key' for default namespace
+     * @param params - Interpolation parameters
+     * @returns Translated string
+     */
+    t(key: string, params?: TranslationParams): string;
+    /**
+     * Set current language and load translations.
+     * Updates HTML lang and dir attributes.
+     *
+     * @param language - Language to set
+     */
+    setLanguage(language: Language): Promise<void>;
+    /**
+     * Get current language.
+     *
+     * @returns Current language or null if not set
+     */
+    getLanguage(): Language | null;
+    /**
+     * Get language metadata.
+     *
+     * @param code - Optional language code (defaults to current)
+     * @returns Language metadata
+     */
+    getLanguageMetadata(code?: Language): LanguageMetadata | undefined;
+    /**
+     * Get all supported languages.
+     *
+     * @returns Array of language metadata
+     */
+    getSupportedLanguages(): LanguageMetadata[];
+    /**
+     * Check if current language is RTL.
+     *
+     * @param code - Optional language code (defaults to current)
+     * @returns True if RTL
+     */
+    isRTL(code?: Language): boolean;
+    /**
+     * Check if namespace is registered.
+     *
+     * @param namespace - Namespace to check
+     * @returns True if registered
+     */
+    hasNamespace(namespace: string): boolean;
+    /**
+     * Get all registered namespaces.
+     *
+     * @returns Array of namespace identifiers
+     */
+    getNamespaces(): string[];
+    /**
+     * Load translations for a specific language.
+     *
+     * @param language - Language to load
+     */
+    loadLanguage(language: Language): Promise<void>;
+    /**
+     * Load translations for a specific screenset.
+     *
+     * @param screensetId - Screenset ID
+     * @param language - Optional language (defaults to current)
+     */
+    loadScreensetTranslations(screensetId: string, language?: Language): Promise<void>;
+    /**
+     * Preload translations for multiple languages.
+     *
+     * @param languages - Languages to preload
+     */
+    preloadLanguages(languages: Language[]): Promise<void>;
+    /**
+     * Subscribe to translation changes.
+     * Called when new translations are registered.
+     *
+     * @param callback - Function to call on changes
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: () => void): () => void;
+    /**
+     * Get the current version number.
+     * Increments when translations change. Used by React for re-rendering.
+     *
+     * @returns Current version number
+     */
+    getVersion(): number;
+}
+/**
+ * Language Display Mode
+ * How to display language names in the UI.
+ */
+declare enum LanguageDisplayMode {
+    /** Show native name (e.g., 'Español') */
+    Native = "native",
+    /** Show English name (e.g., 'Spanish') */
+    English = "english"
+}
+/**
+ * I18n namespace separator constant.
+ * Used to separate namespace from key: 'namespace:key'
+ */
+declare const I18N_NAMESPACE_SEPARATOR = ":";
+/**
+ * I18n path separator constant.
+ * Used to separate nested keys: 'key.subkey'
+ */
+declare const I18N_PATH_SEPARATOR = ".";
+/**
+ * Default namespace for translations without explicit namespace.
+ */
+declare const I18N_DEFAULT_NAMESPACE = "app";
+/**
+ * HTML lang attribute name.
+ */
+declare const HTML_LANG_ATTRIBUTE = "lang";
+/**
+ * HTML dir attribute name.
+ */
+declare const HTML_DIR_ATTRIBUTE = "dir";
+
+export { HTML_DIR_ATTRIBUTE, HTML_LANG_ATTRIBUTE, I18N_DEFAULT_NAMESPACE, I18N_NAMESPACE_SEPARATOR, I18N_PATH_SEPARATOR, type I18nConfig, type I18nRegistry, Language, type LanguageCode, LanguageDisplayMode, type LanguageMetadata, TextDirection, type TranslationDictionary, type TranslationLoader, type TranslationMap, type TranslationParams };

package/dist/types.js

@@ -0,0 +1,66 @@
+// src/types.ts
+var TextDirection = /* @__PURE__ */ ((TextDirection2) => {
+  TextDirection2["LeftToRight"] = "ltr";
+  TextDirection2["RightToLeft"] = "rtl";
+  return TextDirection2;
+})(TextDirection || {});
+var Language = /* @__PURE__ */ ((Language2) => {
+  Language2["English"] = "en";
+  Language2["Spanish"] = "es";
+  Language2["French"] = "fr";
+  Language2["German"] = "de";
+  Language2["Italian"] = "it";
+  Language2["Portuguese"] = "pt";
+  Language2["Dutch"] = "nl";
+  Language2["Russian"] = "ru";
+  Language2["Polish"] = "pl";
+  Language2["Ukrainian"] = "uk";
+  Language2["Czech"] = "cs";
+  Language2["Arabic"] = "ar";
+  Language2["Hebrew"] = "he";
+  Language2["Persian"] = "fa";
+  Language2["Urdu"] = "ur";
+  Language2["Turkish"] = "tr";
+  Language2["ChineseSimplified"] = "zh";
+  Language2["ChineseTraditional"] = "zh-TW";
+  Language2["Japanese"] = "ja";
+  Language2["Korean"] = "ko";
+  Language2["Vietnamese"] = "vi";
+  Language2["Thai"] = "th";
+  Language2["Indonesian"] = "id";
+  Language2["Hindi"] = "hi";
+  Language2["Bengali"] = "bn";
+  Language2["Swedish"] = "sv";
+  Language2["Danish"] = "da";
+  Language2["Norwegian"] = "no";
+  Language2["Finnish"] = "fi";
+  Language2["Greek"] = "el";
+  Language2["Romanian"] = "ro";
+  Language2["Hungarian"] = "hu";
+  Language2["Malay"] = "ms";
+  Language2["Tagalog"] = "tl";
+  Language2["Tamil"] = "ta";
+  Language2["Swahili"] = "sw";
+  return Language2;
+})(Language || {});
+var LanguageDisplayMode = /* @__PURE__ */ ((LanguageDisplayMode2) => {
+  LanguageDisplayMode2["Native"] = "native";
+  LanguageDisplayMode2["English"] = "english";
+  return LanguageDisplayMode2;
+})(LanguageDisplayMode || {});
+var I18N_NAMESPACE_SEPARATOR = ":";
+var I18N_PATH_SEPARATOR = ".";
+var I18N_DEFAULT_NAMESPACE = "app";
+var HTML_LANG_ATTRIBUTE = "lang";
+var HTML_DIR_ATTRIBUTE = "dir";
+export {
+  HTML_DIR_ATTRIBUTE,
+  HTML_LANG_ATTRIBUTE,
+  I18N_DEFAULT_NAMESPACE,
+  I18N_NAMESPACE_SEPARATOR,
+  I18N_PATH_SEPARATOR,
+  Language,
+  LanguageDisplayMode,
+  TextDirection
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * @gears-frontx/i18n - Type Definitions\n *\n * Core types for HAI3 internationalization.\n * Supports 36 languages with RTL support.\n */\n\n// ============================================================================\n// Text Direction\n// ============================================================================\n\n/**\n * Text Direction Enum\n * Defines text direction for RTL language support.\n */\nexport enum TextDirection {\n  LeftToRight = 'ltr',\n  RightToLeft = 'rtl',\n}\n\n// ============================================================================\n// Language Enum\n// ============================================================================\n\n/**\n * Language Enum\n * All 36 supported languages based on major platforms (Google, Facebook, Microsoft, Apple).\n */\nexport enum Language {\n  // Western European\n  English = 'en',\n  Spanish = 'es',\n  French = 'fr',\n  German = 'de',\n  Italian = 'it',\n  Portuguese = 'pt',\n  Dutch = 'nl',\n\n  // Eastern European\n  Russian = 'ru',\n  Polish = 'pl',\n  Ukrainian = 'uk',\n  Czech = 'cs',\n\n  // Middle East & North Africa (RTL)\n  Arabic = 'ar',\n  Hebrew = 'he',\n  Persian = 'fa',\n  Urdu = 'ur',\n  Turkish = 'tr',\n\n  // Asian\n  ChineseSimplified = 'zh',\n  ChineseTraditional = 'zh-TW',\n  Japanese = 'ja',\n  Korean = 'ko',\n  Vietnamese = 'vi',\n  Thai = 'th',\n  Indonesian = 'id',\n  Hindi = 'hi',\n  Bengali = 'bn',\n\n  // Nordic\n  Swedish = 'sv',\n  Danish = 'da',\n  Norwegian = 'no',\n  Finnish = 'fi',\n\n  // Other\n  Greek = 'el',\n  Romanian = 'ro',\n  Hungarian = 'hu',\n\n  // Additional major languages\n  Malay = 'ms',\n  Tagalog = 'tl',\n  Tamil = 'ta',\n  Swahili = 'sw',\n}\n\n// ============================================================================\n// Language Metadata\n// ============================================================================\n\n/**\n * Language Metadata\n * Complete information about a supported language.\n */\nexport interface LanguageMetadata {\n  /** Language code (from Language enum) */\n  code: Language;\n  /** Native name (e.g., 'English', 'العربية') */\n  name: string;\n  /** English name for settings UI */\n  englishName: string;\n  /** Text direction */\n  direction: TextDirection;\n  /** Optional region (e.g., 'US', 'GB', 'TW') */\n  region?: string;\n}\n\n/**\n * Language Code Type\n * Type alias for language codes.\n */\nexport type LanguageCode = Language;\n\n// ============================================================================\n// Translation Types\n// ============================================================================\n\n/**\n * Translation Dictionary\n * Nested key-value structure for translations.\n *\n * @example\n * ```typescript\n * const translations: TranslationDictionary = {\n *   button: {\n *     submit: 'Submit',\n *     cancel: 'Cancel',\n *   },\n *   messages: {\n *     success: 'Operation completed successfully',\n *   },\n * };\n * ```\n */\nexport interface TranslationDictionary {\n  [key: string]: string | TranslationDictionary;\n}\n\n/**\n * Translation Loader Function\n * Returns translations for a given language using dynamic import.\n * Accepts both Language enum and string for compatibility with @gears-frontx/layout.\n *\n * @example\n * ```typescript\n * const loader: TranslationLoader = async (language) => {\n *   const module = await import(`./i18n/${language}.json`);\n *   return module.default;\n * };\n * ```\n */\nexport type TranslationLoader = (language: Language | string) => Promise<TranslationDictionary>;\n\n/**\n * Translation Map\n * Maps languages to their dynamic import functions.\n * Used by I18nRegistry.createLoader().\n *\n * @example\n * ```typescript\n * const translationMap: TranslationMap = {\n *   [Language.English]: () => import('./i18n/en.json'),\n *   [Language.Spanish]: () => import('./i18n/es.json'),\n *   // ... all 36 languages\n * };\n * ```\n */\nexport type TranslationMap = Record<Language, () => Promise<{ default: TranslationDictionary }>>;\n\n// ============================================================================\n// I18n Configuration\n// ============================================================================\n\n/**\n * I18n Configuration\n * Configuration options for the i18n system.\n */\nexport interface I18nConfig {\n  /** Default language to use */\n  defaultLanguage: LanguageCode;\n  /** Fallback language when translation is missing */\n  fallbackLanguage: LanguageCode;\n}\n\n/**\n * Translation Parameters\n * Parameters for string interpolation.\n *\n * @example\n * ```typescript\n * // Translation: \"Hello, {name}!\"\n * t('greeting', { name: 'John' });  // \"Hello, John!\"\n * ```\n */\nexport type TranslationParams = Record<string, string | number | boolean>;\n\n// ============================================================================\n// I18n Registry Interface\n// ============================================================================\n\n/**\n * I18n Registry Interface\n * Central registry for translation management.\n *\n * @example\n * ```typescript\n * // Register translations\n * i18nRegistry.registerLoader('screenset.demo', demoLoader);\n *\n * // Set language\n * await i18nRegistry.setLanguage(Language.Spanish);\n *\n * // Translate\n * const text = i18nRegistry.t('screenset.demo:welcome.title');\n * ```\n */\nexport interface I18nRegistry {\n  /**\n   * Register translations for a namespace.\n   *\n   * @param namespace - Translation namespace (e.g., 'screenset.demo')\n   * @param language - Language enum value\n   * @param translations - Translation dictionary\n   */\n  register(namespace: string, language: Language, translations: TranslationDictionary): void;\n\n  /**\n   * Register a translation loader for a namespace.\n   * Loader is called on-demand when language changes.\n   *\n   * @param namespace - Namespace identifier\n   * @param loader - Function that loads translations\n   */\n  registerLoader(namespace: string, loader: TranslationLoader): void;\n\n  /**\n   * Translate a key.\n   *\n   * @param key - Format: 'namespace:key.subkey' or just 'key' for default namespace\n   * @param params - Interpolation parameters\n   * @returns Translated string\n   */\n  t(key: string, params?: TranslationParams): string;\n\n  /**\n   * Set current language and load translations.\n   * Updates HTML lang and dir attributes.\n   *\n   * @param language - Language to set\n   */\n  setLanguage(language: Language): Promise<void>;\n\n  /**\n   * Get current language.\n   *\n   * @returns Current language or null if not set\n   */\n  getLanguage(): Language | null;\n\n  /**\n   * Get language metadata.\n   *\n   * @param code - Optional language code (defaults to current)\n   * @returns Language metadata\n   */\n  getLanguageMetadata(code?: Language): LanguageMetadata | undefined;\n\n  /**\n   * Get all supported languages.\n   *\n   * @returns Array of language metadata\n   */\n  getSupportedLanguages(): LanguageMetadata[];\n\n  /**\n   * Check if current language is RTL.\n   *\n   * @param code - Optional language code (defaults to current)\n   * @returns True if RTL\n   */\n  isRTL(code?: Language): boolean;\n\n  /**\n   * Check if namespace is registered.\n   *\n   * @param namespace - Namespace to check\n   * @returns True if registered\n   */\n  hasNamespace(namespace: string): boolean;\n\n  /**\n   * Get all registered namespaces.\n   *\n   * @returns Array of namespace identifiers\n   */\n  getNamespaces(): string[];\n\n  /**\n   * Load translations for a specific language.\n   *\n   * @param language - Language to load\n   */\n  loadLanguage(language: Language): Promise<void>;\n\n  /**\n   * Load translations for a specific screenset.\n   *\n   * @param screensetId - Screenset ID\n   * @param language - Optional language (defaults to current)\n   */\n  loadScreensetTranslations(screensetId: string, language?: Language): Promise<void>;\n\n  /**\n   * Preload translations for multiple languages.\n   *\n   * @param languages - Languages to preload\n   */\n  preloadLanguages(languages: Language[]): Promise<void>;\n\n  /**\n   * Subscribe to translation changes.\n   * Called when new translations are registered.\n   *\n   * @param callback - Function to call on changes\n   * @returns Unsubscribe function\n   */\n  subscribe(callback: () => void): () => void;\n\n  /**\n   * Get the current version number.\n   * Increments when translations change. Used by React for re-rendering.\n   *\n   * @returns Current version number\n   */\n  getVersion(): number;\n}\n\n// ============================================================================\n// Display Mode\n// ============================================================================\n\n/**\n * Language Display Mode\n * How to display language names in the UI.\n */\nexport enum LanguageDisplayMode {\n  /** Show native name (e.g., 'Español') */\n  Native = 'native',\n  /** Show English name (e.g., 'Spanish') */\n  English = 'english',\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/**\n * I18n namespace separator constant.\n * Used to separate namespace from key: 'namespace:key'\n */\nexport const I18N_NAMESPACE_SEPARATOR = ':';\n\n/**\n * I18n path separator constant.\n * Used to separate nested keys: 'key.subkey'\n */\nexport const I18N_PATH_SEPARATOR = '.';\n\n/**\n * Default namespace for translations without explicit namespace.\n */\nexport const I18N_DEFAULT_NAMESPACE = 'app';\n\n/**\n * HTML lang attribute name.\n */\nexport const HTML_LANG_ATTRIBUTE = 'lang';\n\n/**\n * HTML dir attribute name.\n */\nexport const HTML_DIR_ATTRIBUTE = 'dir';\n"],"mappings":";AAeO,IAAK,gBAAL,kBAAKA,mBAAL;AACL,EAAAA,eAAA,iBAAc;AACd,EAAAA,eAAA,iBAAc;AAFJ,SAAAA;AAAA,GAAA;AAaL,IAAK,WAAL,kBAAKC,cAAL;AAEL,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,WAAQ;AAGR,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,WAAQ;AAGR,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,UAAO;AACP,EAAAA,UAAA,aAAU;AAGV,EAAAA,UAAA,uBAAoB;AACpB,EAAAA,UAAA,wBAAqB;AACrB,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,UAAO;AACP,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,aAAU;AAGV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,aAAU;AAGV,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,eAAY;AAGZ,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,aAAU;AAjDA,SAAAA;AAAA,GAAA;AAuTL,IAAK,sBAAL,kBAAKC,yBAAL;AAEL,EAAAA,qBAAA,YAAS;AAET,EAAAA,qBAAA,aAAU;AAJA,SAAAA;AAAA,GAAA;AAeL,IAAM,2BAA2B;AAMjC,IAAM,sBAAsB;AAK5B,IAAM,yBAAyB;AAK/B,IAAM,sBAAsB;AAK5B,IAAM,qBAAqB;","names":["TextDirection","Language","LanguageDisplayMode"]}

package/llms.txt

@@ -0,0 +1,49 @@
+# @gears-frontx/i18n
+
+> Internationalization with 36 languages, namespace support, lazy loading, and RTL detection for HAI3 SDK.
+
+Part of the HAI3 SDK Layer (L1) - can be used independently without other @gears-frontx packages. Zero dependencies.
+
+## Core API
+
+- [i18nRegistry](https://hai3.dev/docs/i18n/registry): Singleton for translations
+- [Language](https://hai3.dev/docs/i18n/languages): Enum of 36 language codes
+- [createI18nRegistry](https://hai3.dev/docs/i18n/create): Factory for isolated testing
+
+## Key Patterns
+
+- Namespace keys: `namespace:key.subkey` (e.g., `screen.demo.home:title`)
+- Lazy loading via `registerLoader()` with dynamic imports
+- RTL detection for Arabic, Hebrew, Persian, Urdu
+- Parameter interpolation: `{param}` syntax
+
+## Quick Start
+
+```typescript
+import { i18nRegistry, Language, I18nRegistryImpl } from '@gears-frontx/i18n';
+
+// Register translations directly
+i18nRegistry.register('common', Language.English, {
+  'app.title': 'My App',
+  'app.welcome': 'Welcome, {name}!'
+});
+
+// Or lazy load per screen
+const screenTranslations = I18nRegistryImpl.createLoader({
+  [Language.English]: () => import('./i18n/en.json'),
+  [Language.Spanish]: () => import('./i18n/es.json'),
+});
+
+// Use translations
+const title = i18nRegistry.t('common:app.title');
+const welcome = i18nRegistry.t('common:app.welcome', { name: 'John' });
+
+// Language management
+await i18nRegistry.setLanguage(Language.Spanish);
+const isRTL = i18nRegistry.isRTL();
+```
+
+## Optional
+
+- [Migration Guide](https://hai3.dev/docs/i18n/migration): Migrating from @gears-frontx/uicore
+- [RTL Support](https://hai3.dev/docs/i18n/rtl): Right-to-left language handling

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@gears-frontx/i18n",
+  "version": "0.1.0",
+  "description": "Internationalization and translation management for HAI3 SDK",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "llms.txt"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.2"
+  },
+  "peerDependencies": {},
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "hai3",
+    "i18n",
+    "internationalization",
+    "localization",
+    "typescript"
+  ],
+  "author": "HAI3",
+  "license": "Apache-2.0"
+}