@djangocfg/i18n 2.1.216 → 2.1.218

package/README.md

@@ -1,14 +1,13 @@
 # @djangocfg/i18n
 
-Lightweight, type-safe i18n library with LLM-powered translation CLI.
+Lightweight, type-safe i18n library for @djangocfg packages.
 
 ## Features
 
-- **17 languages** - en, ru, ko, ja, de, fr, zh, it, es, nl, ar, tr, pt-BR, pl, sv, no, da
-- **LLM Translation** - Translate with GPT-4o-mini via CLI
-- **Type-safe** - Full TypeScript support with autocomplete
-- **CLI included** - Manage and translate locales
-- **Works standalone** - Components work without provider
+- **17 languages** — en, ru, ko, ja, de, fr, zh, it, es, nl, ar, tr, pt-BR, pl, sv, no, da
+- **Type-safe** — Full TypeScript support with autocomplete
+- **CLI included** — Manage locales from the terminal
+- **Works standalone** — Components work without provider
 
 ## Installation
 
@@ -21,12 +20,10 @@ pnpm add @djangocfg/i18n
 ```tsx
 import { I18nProvider, useT, ru } from '@djangocfg/i18n'
 
-// Wrap your app
 <I18nProvider locale="ru" translations={ru}>
   <App />
 </I18nProvider>
 
-// Use in components
 function MyComponent() {
   const t = useT()
   return <span>{t('ui.form.save')}</span>
@@ -35,8 +32,6 @@ function MyComponent() {
 
 ## Subpath Imports (Server Components)
 
-For Next.js server components, use subpath imports to avoid React Context issues:
-
 ```tsx
 // ✅ Server-safe (no React Context)
 import { en, ru, ko } from '@djangocfg/i18n/locales'
@@ -54,85 +49,21 @@ import { I18nProvider, useT } from '@djangocfg/i18n'
 
 ## CLI
 
-Built-in CLI with LLM translation support.
-
-### Translate Text
-
 ```bash
-# Translate to multiple languages
-pnpm i18n translate "Hello World" --to ru,ko,ja
-# => ru: Привет, мир
-# => ko: 안녕하세요, 세계
-# => ja: こんにちは、世界
-
-# Output as JSON
-pnpm i18n translate "Save" --to ru,ko --json
-# => {"en":"Save","ru":"Сохранить","ko":"저장"}
-```
-
-### Translate Locale File
-
-```bash
-# Translate entire en.ts to Russian
-pnpm i18n translate ru
-
-# Or explicit
-pnpm i18n translate --file --to ru --from en
-```
-
-### Sync Missing Keys
-
-```bash
-# Show missing keys
-pnpm i18n sync --dry
-
-# Add with [TODO] placeholders
-pnpm i18n sync
-
-# Sync with LLM translation
-pnpm i18n sync --translate
-
-# Sync specific locales
-pnpm i18n sync --to ru,ko --translate
-```
-
-### Other Commands
-
-```bash
-# List/search keys
-pnpm i18n list              # All keys
-pnpm i18n list tour         # Search pattern
-pnpm i18n list -v           # With values
-
-# Check missing keys
+# Check missing keys across locales
 pnpm i18n check
 
-# Add key to all locales
-pnpm i18n add "tools.new" '{"en":"New","ru":"Новый"}'
-
-# Show translation cache stats
-pnpm i18n translate --stats
-```
-
-### Working with App Locales
-
-CLI supports any locales directory (.ts or .json files):
+# List / search keys
+pnpm i18n list
+pnpm i18n list tour        # filter by pattern
+pnpm i18n list -v          # with values
 
-```bash
-# Hub app
-pnpm i18n translate "Dashboard" --to ru,ko -d ../../apps/hub/i18n/locales
-
-# Sync with LLM translation
-pnpm i18n sync -d ../../apps/hub/i18n/locales --translate
-```
-
-### Environment Variables
+# Add key to all locales at once
+pnpm i18n add "tools.new" '{"en":"New","ru":"Новый"}'
 
-```bash
-# Optional - uses built-in test key by default
-SDKROUTER_API_KEY=your-key   # SDKRouter (recommended)
-OPENAI_API_KEY=your-key      # OpenAI
-ANTHROPIC_API_KEY=your-key   # Anthropic
+# Work with app locales in another directory
+pnpm i18n check -d ../../apps/hub/i18n/locales
+pnpm i18n list -d ../../apps/hub/i18n/locales
 ```
 
 ## Hooks
@@ -168,37 +99,10 @@ function LocaleSwitcher() {
 }
 ```
 
-### useTypedT<T>()
-
-```tsx
-import { useTypedT } from '@djangocfg/i18n'
-import type { I18nTranslations } from '@djangocfg/i18n'
-
-function MyComponent() {
-  const t = useTypedT<I18nTranslations>()
-  return <span>{t('ui.form.save')}</span>  // OK
-  // t('ui.form.typo')  // Compile error!
-}
-```
-
 ## Type-safe next-intl Integration
 
 Override `useTranslations` in your app's `global.d.ts` to get compile-time key validation.
 
-### 1. Merge translations (flat, no namespace)
-
-```ts
-// i18n/request.ts
-import { en as baseEn } from '@djangocfg/i18n/locales';
-import { en as appEn } from './locales';
-
-const locales = {
-  en: { ...baseEn, ...appEn },
-};
-```
-
-### 2. Add `global.d.ts` to your app root
-
 ```ts
 // global.d.ts
 type _Messages = import('@djangocfg/i18n').I18nTranslations &
@@ -216,68 +120,25 @@ declare module 'next-intl' {
 }
 ```
 
-### 3. Include in tsconfig.json
-
-```json
-{ "include": ["global.d.ts", "app/**/*.ts", ...] }
-```
-
-Now invalid keys and namespaces produce compile errors:
-
-```ts
-const t = useTranslations('machines');
-t('title');              // OK
-t('dialogs.delete.title'); // OK
-t('NONEXISTENT');        // Error!
-
-useTranslations('BOGUS'); // Error!
-```
-
-> **Why not `use-intl` AppConfig?** The standard `declare module 'use-intl' { interface AppConfig }` augmentation doesn't propagate through pnpm's nested `node_modules`. Overriding `useTranslations` in `next-intl` directly works reliably.
-
-### Exported utility types
-
-| Type | Description |
-|------|-------------|
-| `NestedKeyOf<T>` | All dot-separated paths (leaves + namespaces) |
-| `NestedValueOf<T, P>` | Resolve value type by dot path |
-| `NamespaceKeys<T, A>` | Paths resolving to objects (valid namespaces) |
-| `MessageKeys<T, A>` | Paths resolving to strings (valid keys) |
-| `IntlTranslator<M, NS>` | Type-safe translator with `t()`, `rich()`, `has()`, `raw()` |
-
 ## Extending Translations
 
-### Spread merge (recommended for next-intl apps)
-
 ```ts
-import { en as baseEn } from '@djangocfg/i18n/locales';
-const messages = { ...baseEn, ...appEn };
-```
+// Spread merge (recommended for next-intl)
+import { en as baseEn } from '@djangocfg/i18n/locales'
+const messages = { ...baseEn, ...appEn }
 
-### mergeTranslations() (deep merge with overrides)
-
-```tsx
+// Deep merge with overrides
 import { mergeTranslations, ru } from '@djangocfg/i18n'
-
 const customRu = mergeTranslations(ru, {
   ui: { select: { placeholder: 'Выберите...' } },
 })
 ```
 
-## Built-in Locales
-
-```tsx
-import { en, ru, ko, ja, de, fr, zh, it, es, nl, ar, tr, ptBR, pl, sv, no, da } from '@djangocfg/i18n'
-```
-
 ## Interpolation
 
 ```tsx
 t('ui.pagination.showing', { from: 1, to: 10, total: 100 })
 // => "1-10 of 100"
-
-t('ui.select.moreItems', { count: 5 })
-// => "+5 more"
 ```
 
 ## Translation Key Paths
@@ -292,7 +153,7 @@ tools.*      - Heavy tools (tour, upload, code, image)
 
 ## Works Without Provider
 
-Components using `useT()` work without provider - they fall back to English defaults.
+Components using `useT()` fall back to English defaults when used outside a provider.
 
 ## License
 

package/dist/cli/index.mjs

@@ -4,7 +4,6 @@ import { consola } from 'consola';
 import * as path from 'path';
 import * as fs from 'fs';
 import { createJiti } from 'jiti';
-import { createLLMClient, createTranslator } from '@djangocfg/llm';
 
 var jiti = createJiti(import.meta.url);
 function detectLocaleConfig(dir) {
@@ -53,7 +52,8 @@ async function loadLocale(config, locale) {
   try {
     const module = await jiti.import(filePath);
     const exportName = getExportName(locale);
-    return module[exportName] ?? module.default ?? {};
+    const m = module;
+    return m[exportName] ?? m["default"] ?? {};
   } catch (error) {
     consola.error(`Failed to load ${locale}:`, error);
     return {};
@@ -101,32 +101,6 @@ function getValueAtPath(obj, keyPath) {
   }
   return current;
 }
-var DEFAULT_API_KEY = "test-api-key";
-var translator = null;
-function getTranslator() {
-  if (!translator) {
-    const apiKey = process.env.SDKROUTER_API_KEY || process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY || DEFAULT_API_KEY;
-    const llm = createLLMClient({
-      provider: "sdkrouter",
-      apiKey
-    });
-    translator = createTranslator(llm);
-  }
-  return translator;
-}
-async function translateText(text, targetLocale, sourceLocale = "en") {
-  const t = getTranslator();
-  return t.translateText(text, targetLocale, { sourceLanguage: sourceLocale });
-}
-async function translateJson(data, targetLocale, sourceLocale = "en") {
-  const t = getTranslator();
-  const result = await t.translate(data, targetLocale, { sourceLanguage: sourceLocale });
-  return result.data;
-}
-function getTranslatorStats() {
-  if (!translator) return null;
-  return translator.getStats();
-}
 
 // src/cli/commands/list.ts
 var listCommand = defineCommand({
@@ -413,341 +387,6 @@ ${baseIndent}},`;
 function escapeQuotes(value) {
   return value.replace(/'/g, "\\'");
 }
-var translateCommand = defineCommand({
-  meta: {
-    name: "translate",
-    description: "Translate text or locale file using LLM"
-  },
-  args: {
-    text: {
-      type: "positional",
-      description: 'Text to translate or locale code (e.g., "Hello" or "ru")',
-      required: false
-    },
-    dir: {
-      type: "string",
-      alias: "d",
-      description: "Locales directory"
-    },
-    from: {
-      type: "string",
-      alias: "f",
-      description: "Source locale (default: en)",
-      default: "en"
-    },
-    to: {
-      type: "string",
-      alias: "t",
-      description: 'Target locales (comma-separated, e.g., "ru,ko,ja")'
-    },
-    json: {
-      type: "boolean",
-      alias: "j",
-      description: "Output as JSON",
-      default: false
-    },
-    file: {
-      type: "boolean",
-      description: "Translate entire locale file",
-      default: false
-    },
-    stats: {
-      type: "boolean",
-      alias: "s",
-      description: "Show translation cache stats",
-      default: false
-    }
-  },
-  async run({ args }) {
-    if (args.stats) {
-      const stats = getTranslatorStats();
-      if (stats) {
-        consola.info("Translation Cache Stats:");
-        consola.log(`  Memory size: ${stats.memorySize}`);
-        consola.log(`  Hits: ${stats.hits}`);
-        consola.log(`  Misses: ${stats.misses}`);
-        if (stats.languagePairs.length > 0) {
-          consola.log("  Language pairs:");
-          for (const { pair, translations } of stats.languagePairs) {
-            consola.log(`    ${pair}: ${translations} translations`);
-          }
-        }
-      } else {
-        consola.info("No translations performed yet.");
-      }
-      return;
-    }
-    const localesDir = args.dir ? path.resolve(process.cwd(), args.dir) : getDefaultLocalesDir();
-    try {
-      const config = detectLocaleConfig(localesDir);
-      const sourceLocale = args.from || "en";
-      let targetLocales;
-      if (args.to) {
-        targetLocales = args.to.split(",").map((l) => l.trim());
-      } else {
-        targetLocales = config.locales.filter((l) => l !== sourceLocale);
-      }
-      if (args.file || args.text && config.locales.includes(args.text)) {
-        const targetLocale = args.text || targetLocales[0];
-        if (!targetLocale) {
-          consola.error("Please specify target locale");
-          return;
-        }
-        consola.info(`Translating ${sourceLocale} -> ${targetLocale}`);
-        consola.info(`Directory: ${localesDir}`);
-        const sourceData = await loadLocale(config, sourceLocale);
-        const startTime = Date.now();
-        const topLevelKeys = Object.keys(sourceData);
-        const translated = {};
-        for (const section of topLevelKeys) {
-          const sectionData = sourceData[section];
-          consola.info(`  [${section}] translating...`);
-          const sectionTranslated = await translateJson(
-            sectionData,
-            targetLocale,
-            sourceLocale
-          );
-          translated[section] = sectionTranslated;
-          consola.success(`  [${section}] done`);
-        }
-        const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
-        consola.success(`Translated in ${elapsed}s`);
-        if (config.fileExtension === ".ts") {
-          const exportName = getExportName(targetLocale);
-          const { content } = readLocaleFile(config, targetLocale);
-          const jsonStr = JSON.stringify(translated, null, 2);
-          const newContent = content.replace(
-            /(export const \w+[^=]*=\s*)\{[\s\S]*$/,
-            `$1${jsonStr};
-`
-          );
-          const finalContent = newContent !== content ? newContent : `import type { DocsTranslations } from './en';
-
-export const ${exportName}: DocsTranslations = ${jsonStr};
-`;
-          writeLocaleFile(config, targetLocale, finalContent);
-          consola.success(`Written to ${targetLocale}.ts`);
-        } else {
-          writeLocaleFile(config, targetLocale, JSON.stringify(translated, null, 2));
-          consola.success(`Written to ${targetLocale}.json`);
-        }
-        if (args.json) {
-          console.log(JSON.stringify(translated, null, 2));
-        } else {
-          const sample = JSON.stringify(translated, null, 2).slice(0, 300);
-          consola.log(sample + (sample.length >= 300 ? "\n..." : ""));
-        }
-        return;
-      }
-      const text = args.text;
-      if (!text) {
-        consola.error("Please provide text to translate or use --file flag");
-        consola.log("");
-        consola.log("Examples:");
-        consola.log('  pnpm i18n translate "Hello World" --to ru,ko');
-        consola.log("  pnpm i18n translate --file --to ru");
-        consola.log("  pnpm i18n translate ru  # Translate en.ts to ru");
-        return;
-      }
-      consola.info(`Translating: "${text}"`);
-      consola.log("");
-      const translations = {
-        [sourceLocale]: text
-      };
-      for (const locale of targetLocales) {
-        try {
-          const translated = await translateText(text, locale, sourceLocale);
-          translations[locale] = translated;
-          consola.log(`  ${locale}: ${translated}`);
-        } catch (error) {
-          consola.warn(`  ${locale}: [FAILED] ${error instanceof Error ? error.message : error}`);
-        }
-      }
-      consola.log("");
-      if (args.json) {
-        console.log(JSON.stringify(translations, null, 2));
-      } else {
-        consola.log("Copy-paste JSON:");
-        console.log(JSON.stringify(translations));
-      }
-    } catch (error) {
-      consola.error(error);
-    }
-  }
-});
-var syncCommand = defineCommand({
-  meta: {
-    name: "sync",
-    description: "Sync missing keys from base locale to all others using LLM"
-  },
-  args: {
-    dir: {
-      type: "string",
-      alias: "d",
-      description: "Locales directory"
-    },
-    base: {
-      type: "string",
-      alias: "b",
-      description: "Base locale",
-      default: "en"
-    },
-    to: {
-      type: "string",
-      alias: "t",
-      description: "Target locales (comma-separated). Default: all except base"
-    },
-    dry: {
-      type: "boolean",
-      description: "Dry run - show what would be changed",
-      default: false
-    },
-    translate: {
-      type: "boolean",
-      alias: "T",
-      description: "Translate missing values using LLM (default: add [TODO] placeholders)",
-      default: false
-    },
-    stats: {
-      type: "boolean",
-      alias: "s",
-      description: "Show translation stats after sync",
-      default: false
-    }
-  },
-  async run({ args }) {
-    const localesDir = args.dir ? path.resolve(process.cwd(), args.dir) : getDefaultLocalesDir();
-    try {
-      const config = detectLocaleConfig(localesDir);
-      const baseLocale = args.base || "en";
-      if (!config.locales.includes(baseLocale)) {
-        consola.error(`Base locale "${baseLocale}" not found.`);
-        return;
-      }
-      let targetLocales;
-      if (args.to) {
-        targetLocales = args.to.split(",").map((l) => l.trim());
-      } else {
-        targetLocales = config.locales.filter((l) => l !== baseLocale);
-      }
-      consola.info(`Syncing locales from ${baseLocale}`);
-      consola.info(`Directory: ${localesDir}`);
-      consola.info(`Targets: ${targetLocales.join(", ")}`);
-      if (args.dry) consola.info("(Dry run - no changes will be made)");
-      if (args.translate) consola.info("(LLM batch translation enabled)");
-      consola.log("");
-      const baseTranslations = await loadLocale(config, baseLocale);
-      const baseKeys = getAllKeys(baseTranslations);
-      let totalAdded = 0;
-      let totalTranslated = 0;
-      for (const locale of targetLocales) {
-        if (!config.locales.includes(locale)) {
-          consola.warn(`Locale "${locale}" not found, skipping`);
-          continue;
-        }
-        const translations = await loadLocale(config, locale);
-        const missing = [];
-        for (const { path: keyPath, value } of baseKeys) {
-          const localeValue = getValueAtPath(translations, keyPath);
-          if (localeValue === void 0) {
-            missing.push({ path: keyPath, value });
-          }
-        }
-        if (missing.length === 0) {
-          consola.success(`${locale}: All keys present`);
-          continue;
-        }
-        consola.warn(`${locale}: ${missing.length} missing keys`);
-        if (args.dry) {
-          for (const { path: keyPath, value } of missing.slice(0, 5)) {
-            consola.log(`  + ${keyPath}: ${JSON.stringify(value)}`);
-          }
-          if (missing.length > 5) {
-            consola.log(`  ... and ${missing.length - 5} more`);
-          }
-          continue;
-        }
-        const { content } = readLocaleFile(config, locale);
-        if (config.fileExtension === ".json") {
-          const json = JSON.parse(content);
-          if (args.translate) {
-            const toTranslate = {};
-            for (const { path: keyPath, value } of missing) {
-              if (typeof value === "string") {
-                toTranslate[keyPath] = value;
-              }
-            }
-            if (Object.keys(toTranslate).length > 0) {
-              consola.info(`  Translating ${Object.keys(toTranslate).length} texts...`);
-              const startTime = Date.now();
-              try {
-                const translated = await translateJson(toTranslate, locale, baseLocale);
-                const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
-                consola.success(`  Translated in ${elapsed}s`);
-                for (const { path: keyPath, value } of missing) {
-                  if (typeof value === "string" && translated[keyPath]) {
-                    setNestedValue2(json, keyPath.split("."), translated[keyPath]);
-                    totalTranslated++;
-                  } else {
-                    const fallback = typeof value === "string" ? `[TODO] ${value}` : JSON.stringify(value);
-                    setNestedValue2(json, keyPath.split("."), fallback);
-                  }
-                }
-              } catch (error) {
-                consola.error(`  Translation failed: ${error instanceof Error ? error.message : error}`);
-                for (const { path: keyPath, value } of missing) {
-                  const fallback = typeof value === "string" ? `[TODO] ${value}` : JSON.stringify(value);
-                  setNestedValue2(json, keyPath.split("."), fallback);
-                }
-              }
-            }
-          } else {
-            for (const { path: keyPath, value } of missing) {
-              const newValue = typeof value === "string" ? `[TODO] ${value}` : JSON.stringify(value);
-              setNestedValue2(json, keyPath.split("."), newValue);
-            }
-          }
-          writeLocaleFile(config, locale, JSON.stringify(json, null, 2));
-          totalAdded += missing.length;
-          consola.success(`  Added ${missing.length} keys`);
-        } else {
-          consola.warn(`  TypeScript sync not fully implemented. Use JSON or 'add' command.`);
-          continue;
-        }
-      }
-      consola.log("");
-      if (args.dry) {
-        consola.info("Dry run complete. Use without --dry to apply changes.");
-      } else {
-        consola.success(`Sync complete. Added ${totalAdded} keys total.`);
-        if (args.translate && totalTranslated > 0) {
-          consola.info(`Translated ${totalTranslated} values using LLM (batch mode).`);
-        }
-      }
-      if (args.stats) {
-        const stats = getTranslatorStats();
-        if (stats && stats.memorySize > 0) {
-          consola.log("");
-          consola.info("Translation Cache:");
-          consola.log(`  Cached: ${stats.memorySize} | Hits: ${stats.hits} | Misses: ${stats.misses}`);
-        }
-      }
-    } catch (error) {
-      consola.error(error);
-    }
-  }
-});
-function setNestedValue2(obj, keys, value) {
-  let current = obj;
-  for (let i = 0; i < keys.length - 1; i++) {
-    const key = keys[i];
-    if (!(key in current) || typeof current[key] !== "object") {
-      current[key] = {};
-    }
-    current = current[key];
-  }
-  current[keys[keys.length - 1]] = value;
-}
 
 // src/cli/index.ts
 var main = defineCommand({
@@ -759,9 +398,7 @@ var main = defineCommand({
   subCommands: {
     list: listCommand,
     check: checkCommand,
-    add: addCommand,
-    translate: translateCommand,
-    sync: syncCommand
+    add: addCommand
   },
   setup() {
     consola.box("i18n CLI");