refactor(scripts): rename validation scripts from locales to translations

- Rename validate-locales-refs.mjs to validate-translations-refs.mjs
- Rename validate-locales-structure.mjs to validate-translations-structure.mjs
- Align script names with new translations directory structure

Author: ericyangpan

…ripts/validate/validate-locales-refs.mjs …/validate/validate-translations-refs.mjsscripts/validate/validate-locales-refs.mjs renamed to scripts/validate/validate-translations-refs.mjs scripts/validate/validate-locales-refs.mjs renamed to scripts/validate/validate-translations-refs.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * Validates i18n reference syntax in locale files
+ * Validates i18n reference syntax in translation files
  *
  * This script checks:
  * 1. All @:path references point to valid paths
@@ -20,22 +20,22 @@ import { extractReferences, getValueByPath, resolveReference } from '../../src/i
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
 const rootDir = path.join(__dirname, '../..')
-const localesDir = path.join(rootDir, 'locales')
+const translationsDir = path.join(rootDir, 'translations')
 
 /**
- * Discover all available locales by scanning the locales directory
- * A locale is valid if:
+ * Discover all available translations by scanning the translations directory
+ * A translation is valid if:
  * 1. It's a directory (not a file)
  * 2. It's not in the exclude list (e.g., _archive)
  * 3. It contains an index.ts file
  * @returns {string[]} - Array of locale codes
  */
 function discoverLocales() {
-  if (!fs.existsSync(localesDir)) {
-    throw new Error(`Locales directory not found: ${localesDir}`)
+  if (!fs.existsSync(translationsDir)) {
+    throw new Error(`Translations directory not found: ${translationsDir}`)
   }
 
-  const entries = fs.readdirSync(localesDir, { withFileTypes: true })
+  const entries = fs.readdirSync(translationsDir, { withFileTypes: true })
   const locales = []
 
   for (const entry of entries) {
@@ -51,8 +51,8 @@ function discoverLocales() {
       continue
     }
 
-    // Check if it's a valid locale directory (has index.ts)
-    const indexPath = path.join(localesDir, localeName, 'index.ts')
+    // Check if it's a valid translation directory (has index.ts)
+    const indexPath = path.join(translationsDir, localeName, 'index.ts')
     if (fs.existsSync(indexPath)) {
       locales.push(localeName)
     }
@@ -62,7 +62,7 @@ function discoverLocales() {
   return locales.sort()
 }
 
-// Discover locales dynamically
+// Discover translations dynamically
 const LOCALES = discoverLocales()
 
 /**
@@ -87,16 +87,16 @@ function toCamelCase(filename) {
 }
 
 /**
- * Load messages from a locale by dynamically reading JSON files
- * This mimics the structure in locales/{locale}/index.ts
+ * Load messages from a translation by dynamically reading JSON files
+ * This mimics the structure in translations/{locale}/index.ts
  * @param {string} locale - The locale code
  * @returns {{messages: Record<string, unknown>, fileMap: Map<string, string>}} - The messages object and file mapping
  */
 function loadMessages(locale) {
-  const localeDir = path.join(localesDir, locale)
+  const localeDir = path.join(translationsDir, locale)
 
   if (!fs.existsSync(localeDir)) {
-    throw new Error(`Locale directory not found: ${localeDir}`)
+    throw new Error(`Translation directory not found: ${localeDir}`)
   }
 
   const messages = {}
@@ -309,7 +309,7 @@ function findSimilarPaths(targetPath, messages, maxSuggestions = 3) {
 }
 
 /**
- * Validate references in a locale
+ * Validate references in a translation
  * @param {string} locale - The locale code
  * @returns {{errors: Array<{path: string, filePath: string, message: string, suggestion?: string}>, warnings: Array<{path: string, filePath: string, message: string}>}}
  */
@@ -368,12 +368,12 @@ function validateLocale(locale) {
         } catch (_error) {
           // Path doesn't exist or is invalid
           const similarPaths = findSimilarPaths(ref.path, messages, 3)
-          let suggestion = `The path "${ref.path}" does not exist in the locale messages.`
+          let suggestion = `The path "${ref.path}" does not exist in the translation messages.`
 
           if (similarPaths.length > 0) {
             suggestion += `\n   Did you mean one of these?\n${similarPaths.map(p => `   • ${p}`).join('\n')}`
           } else {
-            suggestion += `\n   Check that the path is correct and the referenced key exists in your locale files.`
+            suggestion += `\n   Check that the path is correct and the referenced key exists in your translation files.`
           }
 
           errors.push({
@@ -434,16 +434,16 @@ function validateLocale(locale) {
         filePath: 'unknown',
         message: `Resolution error`,
         details: `Failed to resolve references: ${error.message}`,
-        suggestion: `Check for syntax errors or circular references in your locale files.`,
+        suggestion: `Check for syntax errors or circular references in your translation files.`,
       })
     }
   } catch (error) {
     errors.push({
       path: 'root',
       filePath: 'unknown',
       message: `Load error`,
-      details: `Failed to load locale ${locale}: ${error.message}`,
-      suggestion: `Check that the locale directory exists and all JSON files are valid.`,
+      details: `Failed to load translation ${locale}: ${error.message}`,
+      suggestion: `Check that the translation directory exists and all JSON files are valid.`,
     })
   }
 
@@ -469,14 +469,14 @@ function formatFilePath(filePath) {
  * Main validation function
  */
 function main() {
-  console.log('🔍 Validating i18n reference syntax in locale files...\n')
+  console.log('🔍 Validating i18n reference syntax in translation files...\n')
 
   let totalErrors = 0
   let totalWarnings = 0
   const localeResults = []
 
   for (const locale of LOCALES) {
-    console.log(`\n📂 Checking locale: ${locale}`)
+    console.log(`\n📂 Checking translation: ${locale}`)
     const result = validateLocale(locale)
     localeResults.push({ locale, ...result })
 
@@ -522,7 +522,7 @@ function main() {
   // Summary
   console.log(`\n${'='.repeat(70)}`)
   console.log('📊 Summary:')
-  console.log(`   Locales checked: ${LOCALES.length}`)
+  console.log(`   Translations checked: ${LOCALES.length}`)
   console.log(`   Total errors: ${totalErrors}`)
   console.log(`   Total warnings: ${totalWarnings}`)
   console.log('='.repeat(70))

…/validate/validate-locales-structure.mjs …date/validate-translations-structure.mjsscripts/validate/validate-locales-structure.mjs renamed to scripts/validate/validate-translations-structure.mjs scripts/validate/validate-locales-structure.mjs renamed to scripts/validate/validate-translations-structure.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 
 /**
- * Validates that all locale structures are identical
+ * Validates that all translation structures are identical
  *
  * This script checks:
- * 1. All locales have the same file structure (same JSON files)
+ * 1. All translations have the same file structure (same JSON files)
  * 2. All JSON files have the same key structure (same nested keys)
- * 3. Reports any structural differences between locales
+ * 3. Reports any structural differences between translations
  */
 
 import fs from 'node:fs'
@@ -16,18 +16,18 @@ import { fileURLToPath } from 'node:url'
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
 const rootDir = path.join(__dirname, '../..')
-const localesDir = path.join(rootDir, 'locales')
+const translationsDir = path.join(rootDir, 'translations')
 
 /**
- * Discover all available locales by scanning the locales directory
+ * Discover all available translations by scanning the translations directory
  * @returns {string[]} - Array of locale codes
  */
 function discoverLocales() {
-  if (!fs.existsSync(localesDir)) {
-    throw new Error(`Locales directory not found: ${localesDir}`)
+  if (!fs.existsSync(translationsDir)) {
+    throw new Error(`Translations directory not found: ${translationsDir}`)
   }
 
-  const entries = fs.readdirSync(localesDir, { withFileTypes: true })
+  const entries = fs.readdirSync(translationsDir, { withFileTypes: true })
   const locales = []
 
   for (const entry of entries) {
@@ -43,8 +43,8 @@ function discoverLocales() {
       continue
     }
 
-    // Check if it's a valid locale directory (has index.ts)
-    const indexPath = path.join(localesDir, localeName, 'index.ts')
+    // Check if it's a valid translation directory (has index.ts)
+    const indexPath = path.join(translationsDir, localeName, 'index.ts')
     if (fs.existsSync(indexPath)) {
       locales.push(localeName)
     }
@@ -89,17 +89,17 @@ function collectKeys(obj, prefix, keys) {
 }
 
 /**
- * Get the structure of a locale (files and keys)
+ * Get the structure of a translation (files and keys)
  * @param {string} locale - The locale code
  * @returns {{files: Map<string, Set<string>>, fileList: string[]}} - Structure information
  */
 function getLocaleStructure(locale) {
-  const localeDir = path.join(localesDir, locale)
+  const localeDir = path.join(translationsDir, locale)
   const files = new Map()
   const fileList = []
 
   if (!fs.existsSync(localeDir)) {
-    throw new Error(`Locale directory not found: ${localeDir}`)
+    throw new Error(`Translation directory not found: ${localeDir}`)
   }
 
   /**
@@ -178,23 +178,23 @@ function compareSets(set1, set2) {
  * Main validation function
  */
 function main() {
-  console.log('🔍 Validating locale structures...\n')
+  console.log('🔍 Validating translation structures...\n')
 
   const locales = discoverLocales()
 
   if (locales.length === 0) {
-    console.error('❌ No locales found!')
+    console.error('❌ No translations found!')
     process.exit(1)
   }
 
   if (locales.length === 1) {
-    console.log(`⚠️  Only one locale found (${locales[0]}), nothing to compare.`)
+    console.log(`⚠️  Only one translation found (${locales[0]}), nothing to compare.`)
     process.exit(0)
   }
 
-  console.log(`Found ${locales.length} locales: ${locales.join(', ')}\n`)
+  console.log(`Found ${locales.length} translations: ${locales.join(', ')}\n`)
 
-  // Get structure for each locale
+  // Get structure for each translation
   const structures = new Map()
   let hasErrors = false
 
@@ -212,15 +212,15 @@ function main() {
     process.exit(1)
   }
 
-  // Use the first locale as reference
+  // Use the first translation as reference
   const referenceLocale = locales[0]
   const referenceStructure = structures.get(referenceLocale)
 
   console.log(`Using ${referenceLocale} as reference structure\n`)
 
   const errors = []
 
-  // Compare each locale with the reference
+  // Compare each translation with the reference
   for (let i = 1; i < locales.length; i++) {
     const locale = locales[i]
     const structure = structures.get(locale)
@@ -290,7 +290,7 @@ function main() {
     console.error('❌ Structure differences found:\n')
 
     for (const error of errors) {
-      console.error(`📂 Locale: ${error.locale}`)
+      console.error(`📂 Translation: ${error.locale}`)
 
       if (error.type === 'file_list') {
         console.error('   Type: File list mismatch')
@@ -331,16 +331,16 @@ function main() {
     }
 
     console.error('='.repeat(70))
-    console.error('❌ Validation failed! Locale structures are not identical.')
+    console.error('❌ Validation failed! Translation structures are not identical.')
     console.error('='.repeat(70))
     process.exit(1)
   }
 
   // Success
   console.log('='.repeat(70))
-  console.log('✅ All locale structures are identical!')
+  console.log('✅ All translation structures are identical!')
   console.log('='.repeat(70))
-  console.log(`\nChecked ${locales.length} locales:`)
+  console.log(`\nChecked ${locales.length} translations:`)
   locales.forEach(locale => {
     const structure = structures.get(locale)
     console.log(`   • ${locale}: ${structure.fileList.length} files`)