@coherent.js/i18n 1.0.0-rc.2 → 1.0.0-rc.3

package/README.md

@@ -30,7 +30,7 @@ Internationalization utilities
 ### Example Usage
 
 ```javascript
-import { createI18n } from '@coherent.js/i18n';
+import { createTranslator, createFormatters, createLocaleManager } from '@coherent.js/i18n';
 ```
 
 > **Note**: All exports are tree-shakable. Import only what you need for optimal bundle size.
@@ -38,44 +38,38 @@ import { createI18n } from '@coherent.js/i18n';
 
 JavaScript (ESM):
 ```js
-import { createTranslator } from '@coherent.js/i18n/translator';
+import { createTranslator } from '@coherent.js/i18n';
 
-const t = createTranslator({
-  en: { hello: 'Hello, {name}!' },
-  fr: { hello: 'Bonjour, {name} !' }
-}, { locale: 'en' });
+const translator = createTranslator({ defaultLocale: 'en' });
+translator.addTranslations('en', { hello: 'Hello, {{name}}!' });
+translator.addTranslations('fr', { hello: 'Bonjour, {{name}} !' });
 
-console.log(t('hello', { name: 'Coherent' }));
+console.log(translator.t('hello', { name: 'Coherent' })); // Hello, Coherent!
+translator.setLocale('fr');
+console.log(translator.t('hello', { name: 'Coherent' })); // Bonjour, Coherent !
 ```
 
 TypeScript:
 ```ts
-import { createTranslator } from '@coherent.js/i18n/translator';
+import { createTranslator } from '@coherent.js/i18n';
 
-type Messages = {
-  hello: string;
-};
+const translator = createTranslator({ defaultLocale: 'en' });
+translator.addTranslations('en', { hello: 'Hello, {{name}}!' });
 
-const t = createTranslator<{ en: Messages; fr: Messages }>({
-  en: { hello: 'Hello, {name}!' },
-  fr: { hello: 'Bonjour, {name} !' }
-}, { locale: 'en' });
-
-console.log(t('hello', { name: 'TS' }));
+console.log(translator.t('hello', { name: 'TS' }));
 ```
 
 ### Formatters and locale
 
 ```js
-import { createFormatters } from '@coherent.js/i18n/formatters';
-import { createLocaleManager } from '@coherent.js/i18n/locale';
+import { createFormatters, createLocaleManager } from '@coherent.js/i18n';
 
-const locale = createLocaleManager('en-US');
-const fmt = createFormatters(locale.current());
+const locales = createLocaleManager({ defaultLocale: 'en-US' });
+const fmt = createFormatters(locales.getLocale());
 
-fmt.date(new Date());
-fmt.number(12345.678);
-fmt.currency(1999.99, 'USD');
+fmt.date.format(new Date());        // 1/15/2026
+fmt.number.format(12345.678);       // 12,345.678
+fmt.currency.format(1999.99);       // $1,999.99
 ```
 
 ## Exports

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@coherent.js/i18n",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.3",
   "description": "Internationalization support for Coherent.js applications",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
-    ".": "./dist/index.js",
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./dist/index.js"
+    },
     "./translator": "./dist/translator.js",
     "./formatters": "./dist/formatters.js",
     "./locale": "./dist/locale.js"
@@ -20,7 +23,7 @@
   "author": "Coherent.js Team",
   "license": "MIT",
   "peerDependencies": {
-    "@coherent.js/core": "1.0.0-rc.2"
+    "@coherent.js/core": "1.0.0-rc.3"
   },
   "repository": {
     "type": "git",

package/types/index.d.ts

@@ -58,14 +58,6 @@ export interface TranslationFunction {
   (key: TranslationKey, params: Record<string, string | number>, count: number): string;
 }
 
-/**
- * Create a typed translator for a specific message shape
- * @template T - The translation messages type
- */
-export function createTypedTranslator<T extends TranslationMessages>(
-  messages: T
-): (key: FlattenKeys<T>, params?: Record<string, string | number>) => string;
-
 // ============================================================================
 // I18n Configuration
 // ============================================================================
@@ -179,20 +171,6 @@ export interface I18nInstance {
   getMessages(): TranslationMessages;
 }
 
-/**
- * Create an i18n instance
- */
-export function createI18n(config: I18nConfig): I18nInstance;
-
-/**
- * Hook to get the translation function (for component usage)
- */
-export function useTranslation(): TranslationFunction;
-
-/**
- * Hook to get and set the current locale
- */
-export function useLocale(): [string, (locale: string) => Promise<void>];
 
 // ============================================================================
 // Translator Class
@@ -447,6 +425,16 @@ export function detectLocale(): string;
 /**
  * Normalize a locale code (e.g., 'en_US' -> 'en-US')
  */
+export function getLocaleDirection(locale: string): 'ltr' | 'rtl';
+
+export function getLocaleDisplayName(locale: string, displayLocale?: string): string;
+
+export function getSupportedLocales(): string[];
+
+export function matchLocale(requestedLocale: string, availableLocales: string[], defaultLocale?: string): string;
+
+export function parseLocale(locale: string): { language: string; region: string | null; script: string | null; full: string };
+
 export function normalizeLocale(locale: string): string;
 
 /**
@@ -458,19 +446,3 @@ export function isRTL(locale: string): boolean;
 // Component Helpers
 // ============================================================================
 
-/**
- * Create a translated component node
- */
-export function translatedNode(
-  key: TranslationKey,
-  tagName?: string,
-  params?: Record<string, string | number>
-): CoherentNode;
-
-/**
- * Create an i18n context provider component
- */
-export function createI18nProvider(
-  i18n: I18nInstance,
-  children: CoherentNode
-): CoherentNode;