i18nsmith 0.1.0

package/dist/utils/provider-injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-injector.js","sourceRoot":"","sources":["../../src/utils/provider-injector.ts"],"names":[],"mappings":"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"}

package/dist/utils/provider-injector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-injector.test.d.ts.map

package/dist/utils/provider-injector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-injector.test.d.ts","sourceRoot":"","sources":["../../src/utils/provider-injector.test.ts"],"names":[],"mappings":""}

package/dist/utils/provider-injector.test.js

@@ -0,0 +1,67 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { promises as fs } from 'fs';
+import os from 'os';
+import path from 'path';
+import { maybeInjectProvider } from './provider-injector.js';
+const providerComponentPath = 'src/components/i18n-provider.tsx';
+const providerTemplate = `'use client';
+
+export default function Providers({ children }: { children: React.ReactNode }) {
+  return <ThemeProvider>{children}</ThemeProvider>;
+}
+`;
+describe('provider injector', () => {
+    let workspaceRoot;
+    let cwdSpy;
+    beforeEach(async () => {
+        workspaceRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'i18nsmith-inject-'));
+        cwdSpy = vi.spyOn(process, 'cwd').mockReturnValue(workspaceRoot);
+        await fs.mkdir(path.join(workspaceRoot, 'app'), { recursive: true });
+    });
+    afterEach(async () => {
+        cwdSpy.mockRestore();
+        await fs.rm(workspaceRoot, { recursive: true, force: true });
+    });
+    it('injects the provider when children expression exists', async () => {
+        const providerFile = path.join(workspaceRoot, 'app/providers.tsx');
+        await fs.writeFile(providerFile, providerTemplate, 'utf8');
+        const result = await maybeInjectProvider({ providerComponentPath });
+        expect(result.status).toBe('injected');
+        if (result.status !== 'injected')
+            return;
+        const contents = await fs.readFile(providerFile, 'utf8');
+        expect(contents).toMatch(/import \{ I18nProvider \} from ['"].+i18n-provider['"];?/);
+        expect(contents).toContain('<I18nProvider>{children}</I18nProvider>');
+    });
+    it('previews changes without touching files when dryRun is true', async () => {
+        const providerFile = path.join(workspaceRoot, 'app/providers.tsx');
+        await fs.writeFile(providerFile, providerTemplate, 'utf8');
+        const result = await maybeInjectProvider({ providerComponentPath, dryRun: true });
+        expect(result.status).toBe('preview');
+        if (result.status !== 'preview')
+            return;
+        expect(result.diff).toContain('I18nProvider');
+        const contents = await fs.readFile(providerFile, 'utf8');
+        expect(contents).toBe(providerTemplate);
+    });
+    it('fails gracefully when multiple children expressions exist', async () => {
+        const providerFile = path.join(workspaceRoot, 'app/providers.tsx');
+        await fs.writeFile(providerFile, `'use client';
+
+export default function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <ThemeProvider>
+      {children}
+      <div>{children}</div>
+    </ThemeProvider>
+  );
+}
+`, 'utf8');
+        const result = await maybeInjectProvider({ providerComponentPath });
+        expect(result.status).toBe('failed');
+        if (result.status !== 'failed')
+            return;
+        expect(result.reason).toMatch(/Multiple/);
+    });
+});
+//# sourceMappingURL=provider-injector.test.js.map

package/dist/utils/provider-injector.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-injector.test.js","sourceRoot":"","sources":["../../src/utils/provider-injector.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/scaffold.d.ts

@@ -0,0 +1,20 @@
+interface ScaffoldOptions {
+    localesDir?: string;
+    workspaceRoot?: string;
+    force?: boolean;
+    dryRun?: boolean;
+}
+export interface ScaffoldResult {
+    path: string;
+    content: string;
+    written: boolean;
+}
+export declare function scaffoldTranslationContext(filePath: string, sourceLanguage: string, options?: ScaffoldOptions): Promise<ScaffoldResult>;
+export declare function scaffoldI18next(i18nPath: string, providerPath: string, sourceLanguage: string, localesDir?: string, options?: ScaffoldOptions): Promise<{
+    i18nPath: string;
+    providerPath: string;
+    i18nResult: ScaffoldResult;
+    providerResult: ScaffoldResult;
+}>;
+export {};
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/utils/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/utils/scaffold.ts"],"names":[],"mappings":"AAGA,UAAU,eAAe;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AA2CD,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA0DzB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,UAAU,SAAY,EACtB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,cAAc,CAAA;CAAE,CAAC,CAgHjH"}

package/dist/utils/scaffold.js

@@ -0,0 +1,197 @@
+import fs from 'fs/promises';
+import path from 'path';
+function resolvePath(targetPath, workspaceRoot) {
+    return path.isAbsolute(targetPath) ? targetPath : path.join(workspaceRoot, targetPath);
+}
+async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+async function writeFileSafely(filePath, content, force, dryRun) {
+    try {
+        await fs.stat(filePath);
+        if (!force) {
+            throw new Error(`File already exists at ${filePath}. Re-run with --force to overwrite.`);
+        }
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'code' in error && error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    if (dryRun) {
+        return false;
+    }
+    await fs.writeFile(filePath, content, 'utf8');
+    return true;
+}
+function relativeImportPath(fromDir, targetPath, dropExtension = true) {
+    let relative = path.relative(fromDir, targetPath).replace(/\\/g, '/');
+    if (!relative.startsWith('.')) {
+        relative = `./${relative}`;
+    }
+    if (dropExtension) {
+        relative = relative.replace(/\.(ts|tsx|js|jsx|mjs|cjs)$/i, '');
+    }
+    return relative;
+}
+export async function scaffoldTranslationContext(filePath, sourceLanguage, options = {}) {
+    const workspaceRoot = options.workspaceRoot ?? process.cwd();
+    const localesDir = options.localesDir ?? 'locales';
+    const absolutePath = resolvePath(filePath, workspaceRoot);
+    const dir = path.dirname(absolutePath);
+    if (!options.dryRun) {
+        await ensureDir(dir);
+    }
+    const localeFile = path.join(workspaceRoot, localesDir, `${sourceLanguage}.json`);
+    let localeImportPath = path.relative(dir, localeFile).replace(/\\/g, '/');
+    if (!localeImportPath.startsWith('.')) {
+        localeImportPath = `./${localeImportPath}`;
+    }
+    const content = `'use client';
+
+import { createContext, useContext, useState } from 'react';
+import ${sourceLanguage}Messages from '${localeImportPath}';
+
+type Language = '${sourceLanguage}';
+
+const messages = {
+  ${sourceLanguage}: ${sourceLanguage}Messages,
+};
+
+interface TranslationContextType {
+  language: Language;
+  setLanguage: (lang: Language) => void;
+  t: (key: string) => string;
+}
+
+const TranslationContext = createContext<TranslationContextType>({
+  language: '${sourceLanguage}',
+  setLanguage: () => {},
+  t: (key) => key,
+});
+
+export function TranslationProvider({ children }: { children: React.ReactNode }) {
+  const [language, setLanguage] = useState<Language>('${sourceLanguage}');
+
+  const t = (key: string) => messages[language]?.[key] ?? key;
+
+  return (
+    <TranslationContext.Provider value={{ language, setLanguage, t }}>
+      {children}
+    </TranslationContext.Provider>
+  );
+}
+
+export function useTranslation() {
+  return useContext(TranslationContext);
+}
+`;
+    const written = await writeFileSafely(absolutePath, content, options.force, options.dryRun);
+    return { path: absolutePath, content, written };
+}
+export async function scaffoldI18next(i18nPath, providerPath, sourceLanguage, localesDir = 'locales', options = {}) {
+    const workspaceRoot = options.workspaceRoot ?? process.cwd();
+    const absoluteI18nPath = resolvePath(i18nPath, workspaceRoot);
+    const absoluteProviderPath = resolvePath(providerPath, workspaceRoot);
+    if (!options.dryRun) {
+        await ensureDir(path.dirname(absoluteI18nPath));
+        await ensureDir(path.dirname(absoluteProviderPath));
+    }
+    const localeFile = path.join(workspaceRoot, localesDir, `${sourceLanguage}.json`);
+    let localeImportPath = path.relative(path.dirname(absoluteI18nPath), localeFile).replace(/\\/g, '/');
+    if (!localeImportPath.startsWith('.')) {
+        localeImportPath = `./${localeImportPath}`;
+    }
+    const i18nContent = `import i18next from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import ${sourceLanguage}Messages from '${localeImportPath}';
+
+const resources = {
+  ${sourceLanguage}: {
+    translation: ${sourceLanguage}Messages,
+  },
+};
+
+function doInit() {
+  const initialized = (i18next as unknown as { isInitialized?: boolean }).isInitialized;
+  if (initialized) {
+    return Promise.resolve();
+  }
+
+  return i18next
+    .use(initReactI18next)
+    .init({
+      lng: '${sourceLanguage}',
+      fallbackLng: '${sourceLanguage}',
+      resources,
+      interpolation: {
+        escapeValue: false,
+      },
+      react: {
+        useSuspense: false,
+      },
+    })
+    .catch((error) => {
+      console.error('i18next init failed', error);
+      throw error;
+    });
+}
+
+if (typeof window !== 'undefined') {
+  void doInit();
+}
+
+export function initI18next() {
+  return doInit();
+}
+
+export default i18next;
+`;
+    const i18nWritten = await writeFileSafely(absoluteI18nPath, i18nContent, options.force, options.dryRun);
+    const providerImport = relativeImportPath(path.dirname(absoluteProviderPath), absoluteI18nPath, true);
+    const providerContent = `'use client';
+
+import { ReactNode, useEffect, useState } from 'react';
+import { initI18next } from '${providerImport}';
+
+interface I18nProviderProps {
+  children: ReactNode;
+}
+
+export function I18nProvider({ children }: I18nProviderProps) {
+  const [ready, setReady] = useState(false);
+
+  useEffect(() => {
+    let mounted = true;
+
+    Promise.resolve(initI18next())
+      .catch((error) => {
+        console.error('i18next initialization failed', error);
+      })
+      .finally(() => {
+        if (mounted) {
+          setReady(true);
+        }
+      });
+
+    return () => {
+      mounted = false;
+    };
+  }, []);
+
+  if (!ready) {
+    return null;
+  }
+
+  return <>{children}</>;
+}
+`;
+    const providerWritten = await writeFileSafely(absoluteProviderPath, providerContent, options.force, options.dryRun);
+    return {
+        i18nPath: absoluteI18nPath,
+        providerPath: absoluteProviderPath,
+        i18nResult: { path: absoluteI18nPath, content: i18nContent, written: i18nWritten },
+        providerResult: { path: absoluteProviderPath, content: providerContent, written: providerWritten },
+    };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/utils/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/utils/scaffold.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "i18nsmith",
+  "version": "0.1.0",
+  "description": "CLI for i18nsmith",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "i18nsmith": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@i18nsmith/core": "workspace:*",
+    "@i18nsmith/transformer": "workspace:*",
+    "@i18nsmith/translation": "workspace:*",
+    "@i18nsmith/translator-mock": "workspace:*",
+    "chalk": "^5.0.0",
+    "commander": "^11.0.0",
+    "diff": "^8.0.2",
+    "fast-glob": "^3.3.3",
+    "inquirer": "^9.0.0",
+    "p-limit": "^7.2.0",
+    "p-retry": "^7.1.0",
+    "ts-morph": "^21.0.0"
+  }
+}

package/src/commands/audit.ts

@@ -0,0 +1,234 @@
+import fs from 'fs/promises';
+import path from 'path';
+import chalk from 'chalk';
+import type { Command } from 'commander';
+import {
+  loadConfig,
+  LocaleStore,
+  KeyValidator,
+  LocaleValidator,
+  SUSPICIOUS_KEY_REASON_DESCRIPTIONS,
+} from '@i18nsmith/core';
+
+interface AuditCommandOptions {
+  config?: string;
+  locale?: string[];
+  json?: boolean;
+  report?: string;
+  strict?: boolean;
+  duplicates?: boolean;
+  inconsistent?: boolean;
+  orphaned?: boolean;
+}
+
+interface AuditIssue {
+  key: string;
+  value: string;
+  reason: string;
+  description: string;
+  suggestion?: string;
+}
+
+interface QualityIssue {
+  type: 'duplicate-value' | 'inconsistent-key' | 'orphaned-namespace';
+  description: string;
+  keys?: string[];
+  suggestion?: string;
+}
+
+interface LocaleAuditResult {
+  locale: string;
+  totalKeys: number;
+  issues: AuditIssue[];
+  qualityIssues: QualityIssue[];
+}
+
+export function registerAudit(program: Command) {
+  program
+    .command('audit')
+    .description('Audit locale files for suspicious keys, key=value patterns, and quality issues')
+    .option('-c, --config <path>', 'Path to i18nsmith config file', 'i18n.config.json')
+    .option('-l, --locale <locales...>', 'Specific locale(s) to audit (defaults to all)')
+    .option('--json', 'Print raw JSON results', false)
+    .option('--report <path>', 'Write JSON report to a file')
+    .option('--strict', 'Exit with error code if any issues found', false)
+    .option('--duplicates', 'Check for duplicate values (consolidation opportunities)', false)
+    .option('--inconsistent', 'Check for inconsistent key naming patterns', false)
+    .option('--orphaned', 'Check for orphaned namespaces with few keys', false)
+    .action(async (options: AuditCommandOptions) => {
+      console.log(chalk.blue('Auditing locale files...'));
+      try {
+        const config = await loadConfig(options.config);
+        const localesDir = path.resolve(process.cwd(), config.localesDir ?? 'locales');
+        const localeStore = new LocaleStore(localesDir, {
+          sortKeys: config.locales?.sortKeys ?? 'alphabetical',
+        });
+        const keyValidator = new KeyValidator(config.sync?.suspiciousKeyPolicy ?? 'skip');
+        const localeValidator = new LocaleValidator({
+          delimiter: config.locales?.delimiter ?? '.',
+        });
+
+        // Determine which locales to audit
+        let localesToAudit = options.locale ?? [];
+        if (localesToAudit.length === 0) {
+          localesToAudit = [config.sourceLanguage ?? 'en', ...(config.targetLanguages ?? [])];
+        }
+
+        // Enable all quality checks if none specified
+        const runQualityChecks = options.duplicates || options.inconsistent || options.orphaned;
+        const checkDuplicates = options.duplicates || !runQualityChecks;
+        const checkInconsistent = options.inconsistent;
+        const checkOrphaned = options.orphaned;
+
+        const results: LocaleAuditResult[] = [];
+        const allKeys = new Set<string>();
+
+        // First pass: collect all keys
+        for (const locale of localesToAudit) {
+          const data = await localeStore.get(locale);
+          for (const key of Object.keys(data)) {
+            allKeys.add(key);
+          }
+        }
+
+        // Second pass: run audits
+        for (const locale of localesToAudit) {
+          const data = await localeStore.get(locale);
+          const keys = Object.keys(data);
+          const issues: AuditIssue[] = [];
+          const qualityIssues: QualityIssue[] = [];
+
+          // Suspicious key detection
+          for (const key of keys) {
+            const value = data[key];
+            const analysis = keyValidator.analyzeWithValue(key, value);
+
+            if (analysis.suspicious && analysis.reason) {
+              issues.push({
+                key,
+                value: value.length > 50 ? `${value.slice(0, 47)}...` : value,
+                reason: analysis.reason,
+                description: SUSPICIOUS_KEY_REASON_DESCRIPTIONS[analysis.reason] ?? 'Unknown issue',
+                suggestion: keyValidator.suggestFix(key, analysis.reason),
+              });
+            }
+          }
+
+          // Quality checks
+          if (checkDuplicates) {
+            const duplicates = localeValidator.detectDuplicateValues(locale, data);
+            for (const dup of duplicates) {
+              qualityIssues.push({
+                type: 'duplicate-value',
+                description: `Value "${dup.value.slice(0, 40)}${dup.value.length > 40 ? '...' : ''}" used by ${dup.keys.length} keys`,
+                keys: dup.keys,
+                suggestion: 'Consider consolidating to a single key',
+              });
+            }
+          }
+
+          if (checkInconsistent && locale === localesToAudit[0]) {
+            // Only check inconsistent keys once (using all keys)
+            const inconsistent = localeValidator.detectInconsistentKeys(Array.from(allKeys));
+            for (const inc of inconsistent) {
+              qualityIssues.push({
+                type: 'inconsistent-key',
+                description: inc.pattern,
+                keys: inc.variants,
+                suggestion: inc.suggestion,
+              });
+            }
+          }
+
+          if (checkOrphaned && locale === localesToAudit[0]) {
+            // Only check orphaned namespaces once (using all keys)
+            const orphaned = localeValidator.detectOrphanedNamespaces(Array.from(allKeys));
+            for (const orph of orphaned) {
+              qualityIssues.push({
+                type: 'orphaned-namespace',
+                description: `Namespace "${orph.namespace}" has only ${orph.keyCount} key(s)`,
+                keys: orph.keys,
+                suggestion: 'Consider merging into a related namespace',
+              });
+            }
+          }
+
+          results.push({
+            locale,
+            totalKeys: keys.length,
+            issues,
+            qualityIssues,
+          });
+        }
+
+        const totalIssues = results.reduce((sum, r) => sum + r.issues.length, 0);
+        const totalQualityIssues = results.reduce((sum, r) => sum + r.qualityIssues.length, 0);
+
+        if (options.report) {
+          const outputPath = path.resolve(process.cwd(), options.report);
+          await fs.mkdir(path.dirname(outputPath), { recursive: true });
+          await fs.writeFile(outputPath, JSON.stringify({ results, totalIssues, totalQualityIssues }, null, 2));
+          console.log(chalk.green(`Audit report written to ${outputPath}`));
+        }
+
+        if (options.json) {
+          console.log(JSON.stringify({ results, totalIssues, totalQualityIssues }, null, 2));
+        } else {
+          // Pretty print results
+          for (const result of results) {
+            const hasIssues = result.issues.length > 0 || result.qualityIssues.length > 0;
+            if (!hasIssues) {
+              console.log(chalk.green(`✓ ${result.locale}.json: ${result.totalKeys} keys, no issues`));
+            } else {
+              console.log(chalk.yellow(`⚠ ${result.locale}.json: ${result.totalKeys} keys`));
+
+              // Suspicious keys
+              if (result.issues.length > 0) {
+                console.log(chalk.yellow(`  Suspicious keys: ${result.issues.length}`));
+                for (const issue of result.issues) {
+                  console.log(chalk.dim(`    - "${issue.key}"`));
+                  console.log(chalk.dim(`      ${issue.description}`));
+                  if (issue.suggestion) {
+                    console.log(chalk.dim(`      Suggestion: ${issue.suggestion}`));
+                  }
+                }
+              }
+
+              // Quality issues
+              if (result.qualityIssues.length > 0) {
+                console.log(chalk.cyan(`  Quality checks: ${result.qualityIssues.length}`));
+                for (const issue of result.qualityIssues) {
+                  const typeLabel = issue.type === 'duplicate-value' ? '📋' :
+                                    issue.type === 'inconsistent-key' ? '🔀' : '📦';
+                  console.log(chalk.dim(`    ${typeLabel} ${issue.description}`));
+                  if (issue.suggestion) {
+                    console.log(chalk.dim(`       ${issue.suggestion}`));
+                  }
+                }
+              }
+            }
+          }
+
+          console.log();
+          if (totalIssues === 0 && totalQualityIssues === 0) {
+            console.log(chalk.green('✓ No issues found in locale files'));
+          } else {
+            if (totalIssues > 0) {
+              console.log(chalk.yellow(`Found ${totalIssues} suspicious key(s)`));
+            }
+            if (totalQualityIssues > 0) {
+              console.log(chalk.cyan(`Found ${totalQualityIssues} quality issue(s)`));
+            }
+          }
+        }
+
+        if (options.strict && totalIssues > 0) {
+          console.error(chalk.red(`\nAudit failed with ${totalIssues} issue(s). Use --strict=false to allow.`));
+          process.exitCode = 1;
+        }
+      } catch (error) {
+        console.error(chalk.red('Audit failed:'), (error as Error).message);
+        process.exitCode = 1;
+      }
+    });
+}