@umituz/react-native-localization 2.0.1 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-localization",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "English-only localization system for React Native apps with i18n support",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/scripts/prepublish.js

@@ -2,79 +2,34 @@
 /* eslint-disable no-console */
 
 /**
- * Pre-Publish Script
- * 
- * This script runs automatically before npm publish to ensure:
- * 1. en-US translation files are ready
- * 2. en-US index.ts loader is generated
- * 3. All required files are in place
- * 
- * Runs automatically via "prepublishOnly" npm script
+ * Pre-Publish Script - Minimal Version
+ *
+ * Basic checks before publishing
  */
 
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
 
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
 const EN_US_DIR = path.join(PACKAGE_ROOT, 'src/infrastructure/locales/en-US');
-const EN_US_INDEX = path.join(EN_US_DIR, 'index.ts');
 
 console.log('🔍 Pre-publish checks...\n');
 
 // Check if en-US directory exists
 if (!fs.existsSync(EN_US_DIR)) {
   console.error('❌ en-US directory not found!');
-  console.error(`   Expected: ${EN_US_DIR}`);
   process.exit(1);
 }
 
 // Check if en-US has JSON files
 const jsonFiles = fs.readdirSync(EN_US_DIR)
-  .filter(file => file.endsWith('.json'))
-  .sort();
+  .filter(file => file.endsWith('.json'));
 
 if (jsonFiles.length === 0) {
-  console.error('❌ No JSON translation files found in en-US directory!');
+  console.error('❌ No JSON translation files found!');
   process.exit(1);
 }
 
-console.log(`✅ Found ${jsonFiles.length} translation files in en-US:`);
-jsonFiles.forEach(file => console.log(`   - ${file}`));
-
-// Generate index.ts if it doesn't exist or is outdated
-const needsIndexUpdate = !fs.existsSync(EN_US_INDEX) || 
-  jsonFiles.some(file => {
-    const filePath = path.join(EN_US_DIR, file);
-    const indexStat = fs.statSync(EN_US_INDEX);
-    const fileStat = fs.statSync(filePath);
-    return fileStat.mtime > indexStat.mtime;
-  });
-
-if (needsIndexUpdate) {
-  console.log('\n📝 Generating en-US index.ts loader...');
-  try {
-    // Run createLocaleLoaders script for en-US
-    const createLoaderScript = path.join(PACKAGE_ROOT, 'scripts/createLocaleLoaders.js');
-    execSync(`node "${createLoaderScript}" en-US`, {
-      stdio: 'inherit',
-      cwd: PACKAGE_ROOT,
-    });
-    console.log('✅ en-US index.ts generated successfully');
-  } catch (error) {
-    console.error('❌ Failed to generate en-US index.ts:', error.message);
-    process.exit(1);
-  }
-} else {
-  console.log('\n✅ en-US index.ts is up to date');
-}
-
-// Verify index.ts exists
-if (!fs.existsSync(EN_US_INDEX)) {
-  console.error('❌ en-US/index.ts not found after generation!');
-  process.exit(1);
-}
-
-console.log('\n✅ Pre-publish checks passed!');
-console.log('   Package is ready to publish.\n');
+console.log(`✅ Found ${jsonFiles.length} translation files`);
+console.log('✅ Pre-publish checks passed!\n');
 

package/src/infrastructure/config/I18nInitializer.ts

@@ -2,7 +2,7 @@
  * i18n Initializer
  *
  * Handles i18n configuration and initialization
- * - Resource building
+ * - Auto-discovers project translations
  * - i18n setup
  * - React i18next integration
  */
@@ -15,39 +15,44 @@ import { TranslationLoader } from './TranslationLoader';
 export class I18nInitializer {
   private static reactI18nextInitialized = false;
 
+  /**
+   * Auto-discover project translations from common paths
+   */
+  private static loadProjectTranslations(): Record<string, any> {
+    const possiblePaths = [
+      './src/locales/en-US',           // App structure
+      './locales/en-US',               // Alternative app structure
+      '../src/locales/en-US',          // Relative from package
+    ];
+
+    for (const path of possiblePaths) {
+      try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const translations = require(path);
+        return translations.default || translations;
+      } catch {
+        // Try next path
+      }
+    }
+
+    return {};
+  }
+
   /**
    * Build resources object for all supported languages
    */
   private static buildResources(): Record<string, { translation: any }> {
     const resources: Record<string, { translation: any }> = {};
     const packageTranslations = TranslationLoader.loadPackageTranslations();
-    const projectTranslations = TranslationLoader.loadProjectTranslations();
-
-    // Build resources for each supported language
-    for (const lang of SUPPORTED_LANGUAGES) {
-      const langCode = lang.code;
-      const packageTranslation = langCode === 'en-US' ? (packageTranslations['en-US'] || {}) : {};
-      const projectTranslation = projectTranslations[langCode] || {};
-
-      // For en-US, merge package and project translations
-      // For other languages, use project translations only (fallback to en-US handled by i18n)
-      if (langCode === 'en-US') {
-        resources[langCode] = {
-          translation: TranslationLoader.mergeTranslations(packageTranslation, projectTranslation),
-        };
-      } else if (projectTranslation && Object.keys(projectTranslation).length > 0) {
-        resources[langCode] = {
-          translation: projectTranslation,
-        };
-      }
-    }
-
-    // Ensure en-US is always present
-    if (!resources['en-US']) {
-      resources['en-US'] = {
-        translation: packageTranslations['en-US'] || {},
-      };
-    }
+    const projectTranslations = this.loadProjectTranslations();
+
+    // For en-US, merge package and project translations
+    resources['en-US'] = {
+      translation: TranslationLoader.mergeTranslations(
+        packageTranslations['en-US'] || {},
+        projectTranslations
+      ),
+    };
 
     return resources;
   }

package/src/infrastructure/config/TranslationLoader.ts

@@ -1,10 +1,7 @@
 /**
  * Translation Loader
  *
- * Handles loading of translations from different sources
- * - Package translations
- * - Project translations
- * - Resource merging
+ * Handles loading of translations from package only
  */
 
 export class TranslationLoader {
@@ -21,14 +18,6 @@ export class TranslationLoader {
     }
   }
 
-  /**
-   * Load project translations for all supported languages
-   * Currently returns empty as projects manage their own translations
-   */
-  static loadProjectTranslations(): Record<string, any> {
-    return {};
-  }
-
   /**
    * Merge package defaults with project-specific translations
    */

package/src/infrastructure/config/i18n.ts

@@ -1,17 +1,15 @@
 /**
- * i18n Configuration Entry Point
+ * i18n Configuration
  *
- * Delegates to I18nInitializer for setup
- * Exports i18n instance and utility functions
+ * Auto-initializes i18n with project translations
  */
 
-import i18n from 'i18next';
 import { I18nInitializer } from './I18nInitializer';
+import i18n from 'i18next';
 
-// Initialize i18n immediately
+// Initialize i18n automatically
 I18nInitializer.initialize();
 
-// Export utility functions
+// Export for advanced usage
 export const addTranslationResources = I18nInitializer.addTranslationResources;
-
 export default i18n;

package/scripts/analyze-keys.js

@@ -1,230 +0,0 @@
-#!/usr/bin/env node
-/* eslint-disable no-console */
-
-/**
- * Translation Key Analyzer
- *
- * Analyzes React Native apps to find all translation keys used
- * in screens and compares them against available translations.
- *
- * Usage:
- *   npm run i18n:analyze
- *   node node_modules/@umituz/react-native-localization/scripts/analyze-keys.js
- *
- * Features:
- * - Extracts all t('...') calls from .tsx/.ts files
- * - Validates against en-US translation files
- * - Reports missing keys
- * - Reports unused keys (in JSON but not in code)
- * - Generates comprehensive report
- */
-
-const fs = require('fs');
-const path = require('path');
-const { getLocalesDir } = require('./utils/findLocalesDir');
-
-/**
- * Extract translation keys from a TypeScript/TSX file
- * Looks for patterns: t('key'), t("key"), t(`key`)
- */
-function extractKeysFromFile(filePath) {
-  const content = fs.readFileSync(filePath, 'utf8');
-  const keys = new Set();
-
-  // Regex patterns for t('key'), t("key"), t(`key`)
-  const patterns = [
-    /t\(['"]([^'"]+)['"]\)/g,  // t('key') or t("key")
-    /t\(`([^`]+)`\)/g,          // t(`key`)
-  ];
-
-  for (const pattern of patterns) {
-    let match;
-    while ((match = pattern.exec(content)) !== null) {
-      const key = match[1].trim();
-
-      // Skip invalid keys
-      if (
-        !key ||                           // Empty
-        key.length < 3 ||                 // Too short (single chars like '/', '-')
-        key.includes('${') ||             // Variables ${var}
-        key.includes('{{') ||             // Handlebars {{var}}
-        /^[A-Z][a-z]+$/.test(key) ||      // Single words like "Main", "Settings" (likely screen names)
-        /^[a-z]+$/.test(key) ||           // Single words like "button", "icon" (likely prop values)
-        /^[a-z]+-[a-z]+$/.test(key)       // Kebab-case like "onboarding-complete" (likely testIDs)
-      ) {
-        continue;
-      }
-
-      keys.add(key);
-    }
-  }
-
-  return keys;
-}
-
-/**
- * Recursively find all TypeScript/TSX files in a directory
- */
-function findSourceFiles(dir, files = []) {
-  if (!fs.existsSync(dir)) {
-    return files;
-  }
-
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-
-    // Skip node_modules, .git, build directories
-    if (entry.name === 'node_modules' || entry.name === '.git' || entry.name === 'build' || entry.name === 'lib') {
-      continue;
-    }
-
-    if (entry.isDirectory()) {
-      findSourceFiles(fullPath, files);
-    } else if (entry.name.endsWith('.tsx') || entry.name.endsWith('.ts')) {
-      files.push(fullPath);
-    }
-  }
-
-  return files;
-}
-
-/**
- * Load all translation keys from JSON files
- */
-function loadTranslationKeys(localesDir, locale = 'en-US') {
-  const localeDir = path.join(localesDir, locale);
-  const keys = new Set();
-
-  if (!fs.existsSync(localeDir)) {
-    return keys;
-  }
-
-  const files = fs.readdirSync(localeDir).filter(f => f.endsWith('.json'));
-
-  for (const file of files) {
-    const filePath = path.join(localeDir, file);
-    const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
-    const namespace = file.replace('.json', '');
-
-    extractKeysFromObject(content, namespace, keys);
-  }
-
-  return keys;
-}
-
-/**
- * Recursively extract keys from translation object
- */
-function extractKeysFromObject(obj, prefix, keys) {
-  for (const key in obj) {
-    const fullKey = prefix ? `${prefix}.${key}` : key;
-
-    if (typeof obj[key] === 'object' && obj[key] !== null) {
-      extractKeysFromObject(obj[key], fullKey, keys);
-    } else if (typeof obj[key] === 'string') {
-      keys.add(fullKey);
-    }
-  }
-}
-
-/**
- * Analyze translation keys for current project
- */
-function analyzeProject() {
-  console.log(`\n🔍 Analyzing translation keys for current project...\n`);
-
-  // Find project's locales directory
-  const localesDir = getLocalesDir();
-  const projectRoot = process.cwd();
-
-  console.log(`📁 Project root: ${projectRoot}`);
-  console.log(`📁 Locales directory: ${localesDir}\n`);
-
-  // Find all source files in src directory
-  const srcDir = path.join(projectRoot, 'src');
-  const sourceFiles = findSourceFiles(srcDir);
-  console.log(`📄 Found ${sourceFiles.length} source files\n`);
-
-  // Extract keys from source code
-  const usedKeys = new Set();
-  for (const file of sourceFiles) {
-    const keys = extractKeysFromFile(file);
-    keys.forEach(key => usedKeys.add(key));
-  }
-
-  console.log(`🔑 Found ${usedKeys.size} translation keys in source code\n`);
-
-  // Load translation keys
-  const translationKeys = loadTranslationKeys(localesDir);
-  console.log(`📚 Found ${translationKeys.size} translation keys in en-US JSON files\n`);
-
-  // Find missing keys (used in code but not in translations)
-  const missingKeys = [];
-  usedKeys.forEach(key => {
-    if (!translationKeys.has(key)) {
-      missingKeys.push(key);
-    }
-  });
-
-  // Find unused keys (in translations but not used in code)
-  const unusedKeys = [];
-  translationKeys.forEach(key => {
-    if (!usedKeys.has(key)) {
-      unusedKeys.push(key);
-    }
-  });
-
-  // Generate report
-  console.log('═══════════════════════════════════════════════════════════\n');
-  console.log('📊 TRANSLATION KEY ANALYSIS REPORT\n');
-  console.log('═══════════════════════════════════════════════════════════\n');
-
-  if (missingKeys.length === 0) {
-    console.log('✅ All translation keys found in JSON files!\n');
-  } else {
-    console.log(`❌ Missing Keys: ${missingKeys.length}\n`);
-    console.log('Keys used in code but NOT found in translation files:\n');
-    missingKeys.sort().forEach(key => {
-      console.log(`   - ${key}`);
-    });
-    console.log('');
-  }
-
-  if (unusedKeys.length > 0) {
-    console.log(`⚠️  Unused Keys: ${unusedKeys.length}\n`);
-    console.log('Keys in translation files but NOT used in code:\n');
-    unusedKeys.sort().forEach(key => {
-      console.log(`   - ${key}`);
-    });
-    console.log('');
-  }
-
-  console.log('═══════════════════════════════════════════════════════════\n');
-  console.log('📈 Summary:\n');
-  console.log(`   Total keys in code:        ${usedKeys.size}`);
-  console.log(`   Total keys in translations: ${translationKeys.size}`);
-  console.log(`   Missing keys:              ${missingKeys.length}`);
-  console.log(`   Unused keys:               ${unusedKeys.length}`);
-  if (usedKeys.size > 0) {
-    console.log(`   Coverage:                  ${Math.round((1 - missingKeys.length / usedKeys.size) * 100)}%`);
-  }
-  console.log('');
-  console.log('═══════════════════════════════════════════════════════════\n');
-
-  if (missingKeys.length > 0) {
-    console.log('💡 Next Steps:\n');
-    console.log('   1. Add missing keys to en-US JSON files');
-    console.log('   2. Run: npm run i18n:translate to auto-translate');
-    console.log('   3. Re-run this analyzer to verify\n');
-    process.exit(1);
-  } else {
-    console.log('✅ Translation check passed!\n');
-    process.exit(0);
-  }
-}
-
-// Main
-analyzeProject();
-