i18ntk 4.6.0 → 4.7.0

package/CHANGELOG.md

@@ -3,9 +3,37 @@
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [4.6.0] - 2026-07-04
+
+## [4.7.0] - 2026-07-07
+
+### Added
+
+- **13 new FRAMEWORK_PATTERNS:** `i18ntk-runtime` (hooks, `<t>` component), `nuxt` (`$tc()`, `localePath()`), `lingui` (`<Translate>` component), `formatjs` (`<FormattedMessage>`), `ngx-translate` (pipe, service patterns), `next-intl`, `svelte-i18n`, `solid-i18n` (`<Translate>`), `fastapi`, `ruby-on-rails` (`I18n.t/l/translate`), `react-native-localize`, `ionic`. Each has framework-specific scanning regex patterns.
+- **8 missing FRAMEWORK_COMPATIBILITY entries:** `nuxt`, `nuxt-i18n`, `next-intl`, `ngx-translate`, `svelte-i18n`, `solid-i18n`, `expo`, `vanilla` with min versions.
+- **Non-Node project detection:** `detectFramework()` now checks Python (`requirements.txt`, `pyproject.toml`, `setup.py`), Rust (`Cargo.toml`), Go (`go.mod`), Ruby (`Gemfile`) when no `package.json` exists. Detects Django, Flask, FastAPI, Rails, and generic i18n usage.
+- **20+ new WRAPPER_SKIP_PATTERNS:** `I18n.t(`, `I18n.translate(`, `useTranslate(`, `t.get(`, `$tc(`, `translateService.instant(`, `formatMessage(`, `bundle.get_message(`, `i18n.NewMessage(`, `_(`, `fluent!`, `ts!` and more.
+- **Expanded KNOWN_WRAPPERS in Lens scanner:** Added `$_`, `$tc`, `gettext`, `gettext_lazy`, `I18n.t`, `I18n.translate`, `I18n.l`, `I18n.localize`.
+- **Expanded NAMESPACE_HELPERS in both scanners:** Added `useTranslate`, `useSpeak`, `withTranslation`.
+- **Framework-aware report-model.js:** `scanSourceFiles()` accepts optional framework parameter, uses `getFrameworkPatterns()` for framework-specific key extraction.
+- **Expanded CLI init framework list:** `checkI18nDependencies()` now scans 27+ npm package names instead of 7.
+- **Sandbox test suite:** 98 new tests covering framework detection against real package.json, requirements.txt, Cargo.toml, go.mod, Gemfile fixtures. Coverage validation for all FRAMEWORK_PATTERNS, FRAMEWORK_SUGGESTIONS, FRAMEWORK_COMPATIBILITY, WRAPPER_SKIP_PATTERNS, and SCANNER_EXTENSIONS.
+
+### Changed
+
+- **Version bumped to 4.7.0** for the comprehensive framework detection expansion.
+- **detectFramework()** no longer returns `null` when only non-Node project files are present. Cascades through 5 detection phases: Node → Python → Rust → Go → Ruby.
+
+## [4.6.1] - 2026-07-05
+
+### Fixed
+
+- **LANGUAGE_CONFIG missing 22+ languages:** `i18ntk-init.js` and `InitService.js` expanded from 21 to 61 languages with native names. All common ISO 639-1 codes now display proper names instead of "Unknown".
+- **Init silently truncating defaultLanguages:** When `defaultLanguages` is an empty array or `null`, init no longer silently falls back to 5 languages.
+- **Auto Translate exiting non-zero on success:** Residual untranslated values (placeholders, branded terms) no longer cause non-zero exit codes. Only real failures produce exit 1.
+- **supportedExtensions silently overridden:** `i18ntk-init.js` no longer unconditionally overrides `supportedExtensions` from config with the format adapter's single extension.
+- **allowedEnglishTerms in two places:** `validation-risk.js` now exports `resolveAllowedEnglishTerms()` which accepts both per-call options and project-level config terms as fallback sources.
+
+## [4.6.0] - 2026-07-04
 
 ### Added
 

package/README.md

@@ -1,4 +1,4 @@
-# i18ntk v4.6.0
+# i18ntk v4.7.0
 
 A zero-dependency internationalization toolkit for setup, scanning, analysis, validation, usage tracking, translation completion, automatic JSON locale translation, reporting, and runtime translation loading.
 
@@ -9,7 +9,7 @@ A zero-dependency internationalization toolkit for setup, scanning, analysis, va
 [![node](https://img.shields.io/badge/node-%3E%3D16-339933)](https://nodejs.org)
 [![dependencies](https://img.shields.io/badge/dependencies-0-success)](https://www.npmjs.com/package/i18ntk)
 [![license](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
-[![socket](https://socket.dev/api/badge/npm/package/i18ntk/4.6.0)](https://socket.dev/npm/package/i18ntk/overview/4.6.0)
+[![socket](https://socket.dev/api/badge/npm/package/i18ntk/4.7.0)](https://socket.dev/npm/package/i18ntk/overview/4.7.0)
 
 [![i18ntk Workbench](https://img.shields.io/badge/VS_Code-Workbench-007ACC?logo=visualstudiocode&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=VladNoskov.i18ntk-workbench)
 [![i18ntk Lens](https://img.shields.io/badge/VS_Code-Lens-007ACC?logo=visualstudiocode&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=VladNoskov.i18ntk-lens)
@@ -27,15 +27,15 @@ npm install -g i18ntk
 npx i18ntk --help
 ```
 
-## What's New in 4.6.0
+## What's New in 4.7.0
 
-- **25+ framework detections** — Rust, Remix, Gatsby, Astro, Qwik, SolidJS, Ember, React Native, Expo, Ionic added. All drawn from a single centralized detector.
-- **Rust support** — Cargo.toml detection and `.rs` file scanning with fluent/gettext-rs framework patterns.
-- **File extensions** — `.astro`, `.mdx`, `.mjs`, `.mts`, `.cjs`, `.cts`, `.rs` scanned across all tools.
-- **ICU/Fluent placeholder support** — Fluent `$variable` and ICU `{var, plural, ...}` patterns detected.
-- **JSX component detection** — `<Trans>`, `<FormattedMessage>`, `<Translate>` components recognized.
-- **Health score fix** — No more negative or misleadingly low scores.
-- **Centralized architecture** — Framework data, extensions, excludes, and patterns live in one module consumed by all tools.
+- **30+ framework detection patterns** — 13 new FRAMEWORK_PATTERNS: `i18ntk-runtime`, `nuxt`, `lingui`, `formatjs`, `ngx-translate`, `next-intl`, `svelte-i18n`, `solid-i18n`, `fastapi`, `ruby-on-rails`, `react-native-localize`, `ionic`. Each with framework-specific scan regexes for translation calls, JSX components, template directives, and pipes.
+- **Non-Node project detection** — Python (`requirements.txt`, `pyproject.toml`, `setup.py`), Rust (`Cargo.toml`), Go (`go.mod`), Ruby (`Gemfile`) now detected when no `package.json` exists. Detects Django, Flask, FastAPI, Rails, and generic i18n.
+- **20+ new WRAPPER_SKIP_PATTERNS** — Covers I18n.t(), useTranslate(), translateService.instant(), formatMessage(), bundle.get_message(), fluent!, ts! and more.
+- **Framework-aware report generation** — `report-model.js` accepts optional framework parameter and uses framework-specific patterns for key extraction.
+- **Expanded namespace helpers** — `useTranslate` (Qwik), `useSpeak` (Qwik), `withTranslation` (react-i18next) added.
+- **Attribute key detection** — `i18nKey=`, `t-key=`, `data-i18n=` attributes detected in source scanning.
+- **All frame works now have FRAMEWORK_COMPATIBILITY entries and FRAMEWORK_SUGGESTIONS** for consistent tooling.
 
 [Full changelog →](./CHANGELOG.md)
 
@@ -122,7 +122,7 @@ Example `.i18ntk-config`:
 
 ```json
 {
-  "version": "4.6.0",
+  "version": "4.6.1",
   "sourceDir": "./locales",
   "i18nDir": "./locales",
   "sourceLanguage": "en",

package/main/i18ntk-init.js

@@ -29,29 +29,56 @@ const { createPrompt, isInteractive } = require('../utils/prompt-helper');
 const { parseConfirmation } = require('../utils/localized-confirm');
 const { normalizeReportFormat, writeReportFile } = require('../utils/report-writer');
 
-// Language configurations with native names
-const LANGUAGE_CONFIG = {
-  'en': { name: 'English', nativeName: 'English' },
-  'de': { name: 'German', nativeName: 'Deutsch' },
-  'es': { name: 'Spanish', nativeName: 'Espa\u00f1ol' },
-  'fr': { name: 'French', nativeName: 'Fran\u00e7ais' },
-  'ru': { name: 'Russian', nativeName: '\u0420\u0443\u0441\u0441\u043a\u0438\u0439' },
-  'it': { name: 'Italian', nativeName: 'Italiano' },
-  'ja': { name: 'Japanese', nativeName: '\u65e5\u672c\u8a9e' },
-  'ko': { name: 'Korean', nativeName: '\ud55c\uad6d\uc5b4' },
-  'zh': { name: 'Chinese', nativeName: '\u4e2d\u6587' },
-  'ar': { name: 'Arabic', nativeName: '\u0627\u0644\u0639\u0631\u0628\u064a\u0629' },
-  'hi': { name: 'Hindi', nativeName: '\u0939\u093f\u0928\u094d\u0926\u0940' },
-  'nl': { name: 'Dutch', nativeName: 'Nederlands' },
-  'sv': { name: 'Swedish', nativeName: 'Svenska' },
-  'da': { name: 'Danish', nativeName: 'Dansk' },
-  'no': { name: 'Norwegian', nativeName: 'Norsk' },
-  'fi': { name: 'Finnish', nativeName: 'Suomi' },
-  'pl': { name: 'Polish', nativeName: 'Polski' },
-  'cs': { name: 'Czech', nativeName: '\u010ce\u0161tina' },
-  'hu': { name: 'Hungarian', nativeName: 'Magyar' },
-  'tr': { name: 'Turkish', nativeName: 'T\u00fcrk\u00e7e' }
-};
+// Language configurations with native names — comprehensive ISO 639-1 coverage
+const LANGUAGE_CONFIG = {
+  'af': { name: 'Afrikaans', nativeName: 'Afrikaans' },  'sq': { name: 'Albanian', nativeName: 'Shqip' },
+  'ar': { name: 'Arabic', nativeName: '\u0627\u0644\u0639\u0631\u0628\u064a\u0629' },  'hy': { name: 'Armenian', nativeName: '\u0540\u0561\u0575\u0565\u0580\u0565\u0576' },
+  'az': { name: 'Azerbaijani', nativeName: 'Az\u0259rbaycan' },  'eu': { name: 'Basque', nativeName: 'Euskara' },
+  'be': { name: 'Belarusian', nativeName: '\u0411\u0435\u043b\u0430\u0440\u0443\u0441\u043a\u0430\u044f' },
+  'bn': { name: 'Bengali', nativeName: '\u09ac\u09be\u0982\u09b2\u09be' },
+  'bs': { name: 'Bosnian', nativeName: 'Bosanski' },  'bg': { name: 'Bulgarian', nativeName: '\u0411\u044a\u043b\u0433\u0430\u0440\u0441\u043a\u0438' },
+  'ca': { name: 'Catalan', nativeName: 'Catal\u00e0' },  'zh': { name: 'Chinese', nativeName: '\u4e2d\u6587' },
+  'hr': { name: 'Croatian', nativeName: 'Hrvatski' },  'cs': { name: 'Czech', nativeName: '\u010ce\u0161tina' },
+  'da': { name: 'Danish', nativeName: 'Dansk' },  'nl': { name: 'Dutch', nativeName: 'Nederlands' },
+  'en': { name: 'English', nativeName: 'English' },  'et': { name: 'Estonian', nativeName: 'Eesti' },
+  'fi': { name: 'Finnish', nativeName: 'Suomi' },  'fr': { name: 'French', nativeName: 'Fran\u00e7ais' },
+  'ka': { name: 'Georgian', nativeName: '\u10e5\u10d0\u10e0\u10d7\u10e3\u10da\u10d8' },
+  'de': { name: 'German', nativeName: 'Deutsch' },  'el': { name: 'Greek', nativeName: '\u0395\u03bb\u03bb\u03b7\u03bd\u03b9\u03ba\u03ac' },
+  'gu': { name: 'Gujarati', nativeName: '\u0a97\u0ac1\u0a9c\u0ab0\u0abe\u0aa4\u0ac0' },
+  'he': { name: 'Hebrew', nativeName: '\u05e2\u05d1\u05e8\u05d9\u05ea' },
+  'hi': { name: 'Hindi', nativeName: '\u0939\u093f\u0928\u094d\u0926\u0940' },
+  'hu': { name: 'Hungarian', nativeName: 'Magyar' },  'is': { name: 'Icelandic', nativeName: '\u00cdslenska' },
+  'id': { name: 'Indonesian', nativeName: 'Bahasa Indonesia' },
+  'ga': { name: 'Irish', nativeName: 'Gaeilge' },  'it': { name: 'Italian', nativeName: 'Italiano' },
+  'ja': { name: 'Japanese', nativeName: '\u65e5\u672c\u8a9e' },
+  'kk': { name: 'Kazakh', nativeName: '\u049a\u0430\u0437\u0430\u049b' },
+  'ko': { name: 'Korean', nativeName: '\ud55c\uad6d\uc5b4' },
+  'lv': { name: 'Latvian', nativeName: 'Latvie\u0161u' },  'lt': { name: 'Lithuanian', nativeName: 'Lietuvi\u0173' },
+  'mk': { name: 'Macedonian', nativeName: '\u041c\u0430\u043a\u0435\u0434\u043e\u043d\u0441\u043a\u0438' },
+  'ms': { name: 'Malay', nativeName: 'Bahasa Melayu' },
+  'ml': { name: 'Malayalam', nativeName: '\u0d2e\u0d32\u0d2f\u0d3e\u0d33\u0d02' },
+  'mr': { name: 'Marathi', nativeName: '\u092e\u0930\u093e\u0920\u0940' },
+  'mn': { name: 'Mongolian', nativeName: '\u041c\u043e\u043d\u0433\u043e\u043b' },
+  'no': { name: 'Norwegian', nativeName: 'Norsk' },
+  'fa': { name: 'Persian', nativeName: '\u0641\u0627\u0631\u0633\u06cc' },
+  'pl': { name: 'Polish', nativeName: 'Polski' },  'pt': { name: 'Portuguese', nativeName: 'Portugu\u00eas' },
+  'pa': { name: 'Punjabi', nativeName: '\u0a2a\u0a70\u0a1c\u0a3e\u0a2c\u0a40' },
+  'ro': { name: 'Romanian', nativeName: 'Rom\u00e2n\u0103' },
+  'ru': { name: 'Russian', nativeName: '\u0420\u0443\u0441\u0441\u043a\u0438\u0439' },
+  'sr': { name: 'Serbian', nativeName: '\u0421\u0440\u043f\u0441\u043a\u0438' },
+  'sk': { name: 'Slovak', nativeName: 'Sloven\u010dina' },
+  'sl': { name: 'Slovenian', nativeName: 'Sloven\u0161\u010dina' },
+  'es': { name: 'Spanish', nativeName: 'Espa\u00f1ol' },
+  'sw': { name: 'Swahili', nativeName: 'Kiswahili' },  'sv': { name: 'Swedish', nativeName: 'Svenska' },
+  'tl': { name: 'Filipino', nativeName: 'Filipino' },
+  'ta': { name: 'Tamil', nativeName: '\u0ba4\u0bae\u0bbf\u0bb4\u0bcd' },
+  'te': { name: 'Telugu', nativeName: '\u0c24\u0c46\u0c32\u0c41\u0c17\u0c41' },
+  'th': { name: 'Thai', nativeName: '\u0e44\u0e17\u0e22' },
+  'tr': { name: 'Turkish', nativeName: 'T\u00fcrk\u00e7e' },
+  'uk': { name: 'Ukrainian', nativeName: '\u0423\u043a\u0440\u0430\u0457\u043d\u0441\u044c\u043a\u0430' },
+  'ur': { name: 'Urdu', nativeName: '\u0627\u0631\u062f\u0648' },
+  'vi': { name: 'Vietnamese', nativeName: 'Ti\u1ebfng Vi\u1ec7t' },
+};
 
 class I18nInitializer {
   constructor(config = {}) {
@@ -67,7 +94,9 @@ class I18nInitializer {
       ...config
     };
         this.format = getFormatAdapter(this.config.format);
-    this.config.supportedExtensions = [this.format.extension];
+    if (!this.config.supportedExtensions || !this.config.supportedExtensions.length) {
+      this.config.supportedExtensions = [this.format.extension];
+    }
     this.detectedFramework = detectFramework(process.cwd());
     if (this.detectedFramework && !this.config.translationPatterns) {
       this.config.translationPatterns = this.detectedFramework.patterns;
@@ -79,7 +108,9 @@ class I18nInitializer {
       : path.join(this.sourceDir, this.config.sourceLanguage);
     
     // Ensure defaultLanguages is properly initialized from config
-    this.config.defaultLanguages = this.config.defaultLanguages || ['en', 'de', 'es', 'fr', 'ru'];
+    if (!this.config.defaultLanguages || !Array.isArray(this.config.defaultLanguages) || this.config.defaultLanguages.length === 0) {
+      this.config.defaultLanguages = ['en', 'de', 'es', 'fr', 'ru'];
+    }
     
     // No longer create readline interface here - use CLI helpers
     this.rl = null;
@@ -107,13 +138,15 @@ class I18nInitializer {
       };
       
       const i18nFrameworks = [
-        'react-i18next',
-        'vue-i18n', 
-        'angular-i18n',
-        'i18next',
-        'next-i18next',
-        'svelte-i18n',
-        '@nuxtjs/i18n'
+        'react-i18next', 'vue-i18n', 'i18next', 'next-i18next',
+        'svelte-i18n', '@nuxtjs/i18n', 'next-intl', 'remix-i18next',
+        'i18next-remix', 'gatsby-plugin-react-i18next', 'gatsby-plugin-intl',
+        'sveltekit-i18n', 'astro-i18next', '@astrojs/i18n',
+        'qwik-speak', 'qwik-i18n', '@solid-primitives/i18n',
+        'ember-intl', 'react-native-localize', 'expo-localization',
+        '@ngx-translate/core', '@ionic/angular',
+        'formatjs', '@lingui/core', 'i18ntk-runtime', 'i18ntk/runtime',
+        'angular-i18n', '@angular/localize'
       ];
       
       const installedFrameworks = i18nFrameworks.filter(framework => dependencies[framework]);

package/main/i18ntk-translate.js

@@ -1131,10 +1131,13 @@ async function run(args) {
     }
   }
 
+  const hadRealErrors = grandTranslated === 0 && grandTotal > 0;
+  const hasResiduals = allResidualUntranslated.length > 0;
+
   return {
-    success: allResidualUntranslated.length === 0,
-    exitCode: allResidualUntranslated.length === 0 ? ExitCodes.SUCCESS : ExitCodes.VALIDATION_FAILED,
-    error: allResidualUntranslated.length === 0 ? undefined : 'Auto Translate left untranslated placeholder values',
+    success: !hadRealErrors,
+    exitCode: hadRealErrors ? ExitCodes.VALIDATION_FAILED : ExitCodes.SUCCESS,
+    error: hadRealErrors ? 'Auto Translate failed to translate any values' : undefined,
     total: grandTotal,
     translated: grandTranslated,
     skipped: grandSkipped,

package/main/manage/services/InitService.js

@@ -18,29 +18,56 @@ const AdminAuth = require('../../../utils/admin-auth');
 const { parseConfirmation } = require('../../../utils/localized-confirm');
 const { normalizeReportFormat, writeReportFile } = require('../../../utils/report-writer');
 
-// Language configurations with native names
-const LANGUAGE_CONFIG = {
-  'en': { name: 'English', nativeName: 'English' },
-  'de': { name: 'German', nativeName: 'Deutsch' },
-  'es': { name: 'Spanish', nativeName: 'Espa\u00f1ol' },
-  'fr': { name: 'French', nativeName: 'Fran\u00e7ais' },
-  'ru': { name: 'Russian', nativeName: '\u0420\u0443\u0441\u0441\u043a\u0438\u0439' },
-  'it': { name: 'Italian', nativeName: 'Italiano' },
-  'ja': { name: 'Japanese', nativeName: '\u65e5\u672c\u8a9e' },
-  'ko': { name: 'Korean', nativeName: '\ud55c\uad6d\uc5b4' },
-  'zh': { name: 'Chinese', nativeName: '\u4e2d\u6587' },
-  'ar': { name: 'Arabic', nativeName: '\u0627\u0644\u0639\u0631\u0628\u064a\u0629' },
-  'hi': { name: 'Hindi', nativeName: '\u0939\u093f\u0928\u094d\u0926\u0940' },
-  'nl': { name: 'Dutch', nativeName: 'Nederlands' },
-  'sv': { name: 'Swedish', nativeName: 'Svenska' },
-  'da': { name: 'Danish', nativeName: 'Dansk' },
-  'no': { name: 'Norwegian', nativeName: 'Norsk' },
-  'fi': { name: 'Finnish', nativeName: 'Suomi' },
-  'pl': { name: 'Polish', nativeName: 'Polski' },
-  'cs': { name: 'Czech', nativeName: '\u010ce\u0161tina' },
-  'hu': { name: 'Hungarian', nativeName: 'Magyar' },
-  'tr': { name: 'Turkish', nativeName: 'T\u00fcrk\u00e7e' }
-};
+// Language configurations with native names — comprehensive ISO 639-1 coverage
+const LANGUAGE_CONFIG = {
+  'af': { name: 'Afrikaans', nativeName: 'Afrikaans' },  'sq': { name: 'Albanian', nativeName: 'Shqip' },
+  'ar': { name: 'Arabic', nativeName: '\u0627\u0644\u0639\u0631\u0628\u064a\u0629' },  'hy': { name: 'Armenian', nativeName: '\u0540\u0561\u0575\u0565\u0580\u0565\u0576' },
+  'az': { name: 'Azerbaijani', nativeName: 'Az\u0259rbaycan' },  'eu': { name: 'Basque', nativeName: 'Euskara' },
+  'be': { name: 'Belarusian', nativeName: '\u0411\u0435\u043b\u0430\u0440\u0443\u0441\u043a\u0430\u044f' },
+  'bn': { name: 'Bengali', nativeName: '\u09ac\u09be\u0982\u09b2\u09be' },
+  'bs': { name: 'Bosnian', nativeName: 'Bosanski' },  'bg': { name: 'Bulgarian', nativeName: '\u0411\u044a\u043b\u0433\u0430\u0440\u0441\u043a\u0438' },
+  'ca': { name: 'Catalan', nativeName: 'Catal\u00e0' },  'zh': { name: 'Chinese', nativeName: '\u4e2d\u6587' },
+  'hr': { name: 'Croatian', nativeName: 'Hrvatski' },  'cs': { name: 'Czech', nativeName: '\u010ce\u0161tina' },
+  'da': { name: 'Danish', nativeName: 'Dansk' },  'nl': { name: 'Dutch', nativeName: 'Nederlands' },
+  'en': { name: 'English', nativeName: 'English' },  'et': { name: 'Estonian', nativeName: 'Eesti' },
+  'fi': { name: 'Finnish', nativeName: 'Suomi' },  'fr': { name: 'French', nativeName: 'Fran\u00e7ais' },
+  'ka': { name: 'Georgian', nativeName: '\u10e5\u10d0\u10e0\u10d7\u10e3\u10da\u10d8' },
+  'de': { name: 'German', nativeName: 'Deutsch' },  'el': { name: 'Greek', nativeName: '\u0395\u03bb\u03bb\u03b7\u03bd\u03b9\u03ba\u03ac' },
+  'gu': { name: 'Gujarati', nativeName: '\u0a97\u0ac1\u0a9c\u0ab0\u0abe\u0aa4\u0ac0' },
+  'he': { name: 'Hebrew', nativeName: '\u05e2\u05d1\u05e8\u05d9\u05ea' },
+  'hi': { name: 'Hindi', nativeName: '\u0939\u093f\u0928\u094d\u0926\u0940' },
+  'hu': { name: 'Hungarian', nativeName: 'Magyar' },  'is': { name: 'Icelandic', nativeName: '\u00cdslenska' },
+  'id': { name: 'Indonesian', nativeName: 'Bahasa Indonesia' },
+  'ga': { name: 'Irish', nativeName: 'Gaeilge' },  'it': { name: 'Italian', nativeName: 'Italiano' },
+  'ja': { name: 'Japanese', nativeName: '\u65e5\u672c\u8a9e' },
+  'kk': { name: 'Kazakh', nativeName: '\u049a\u0430\u0437\u0430\u049b' },
+  'ko': { name: 'Korean', nativeName: '\ud55c\uad6d\uc5b4' },
+  'lv': { name: 'Latvian', nativeName: 'Latvie\u0161u' },  'lt': { name: 'Lithuanian', nativeName: 'Lietuvi\u0173' },
+  'mk': { name: 'Macedonian', nativeName: '\u041c\u0430\u043a\u0435\u0434\u043e\u043d\u0441\u043a\u0438' },
+  'ms': { name: 'Malay', nativeName: 'Bahasa Melayu' },
+  'ml': { name: 'Malayalam', nativeName: '\u0d2e\u0d32\u0d2f\u0d3e\u0d33\u0d02' },
+  'mr': { name: 'Marathi', nativeName: '\u092e\u0930\u093e\u0920\u0940' },
+  'mn': { name: 'Mongolian', nativeName: '\u041c\u043e\u043d\u0433\u043e\u043b' },
+  'no': { name: 'Norwegian', nativeName: 'Norsk' },
+  'fa': { name: 'Persian', nativeName: '\u0641\u0627\u0631\u0633\u06cc' },
+  'pl': { name: 'Polish', nativeName: 'Polski' },  'pt': { name: 'Portuguese', nativeName: 'Portugu\u00eas' },
+  'pa': { name: 'Punjabi', nativeName: '\u0a2a\u0a70\u0a1c\u0a3e\u0a2c\u0a40' },
+  'ro': { name: 'Romanian', nativeName: 'Rom\u00e2n\u0103' },
+  'ru': { name: 'Russian', nativeName: '\u0420\u0443\u0441\u0441\u043a\u0438\u0439' },
+  'sr': { name: 'Serbian', nativeName: '\u0421\u0440\u043f\u0441\u043a\u0438' },
+  'sk': { name: 'Slovak', nativeName: 'Sloven\u010dina' },
+  'sl': { name: 'Slovenian', nativeName: 'Sloven\u0161\u010dina' },
+  'es': { name: 'Spanish', nativeName: 'Espa\u00f1ol' },
+  'sw': { name: 'Swahili', nativeName: 'Kiswahili' },  'sv': { name: 'Swedish', nativeName: 'Svenska' },
+  'tl': { name: 'Filipino', nativeName: 'Filipino' },
+  'ta': { name: 'Tamil', nativeName: '\u0ba4\u0bae\u0bbf\u0bb4\u0bcd' },
+  'te': { name: 'Telugu', nativeName: '\u0c24\u0c46\u0c32\u0c41\u0c17\u0c41' },
+  'th': { name: 'Thai', nativeName: '\u0e44\u0e17\u0e22' },
+  'tr': { name: 'Turkish', nativeName: 'T\u00fcrk\u00e7e' },
+  'uk': { name: 'Ukrainian', nativeName: '\u0423\u043a\u0440\u0430\u0457\u043d\u0441\u044c\u043a\u0430' },
+  'ur': { name: 'Urdu', nativeName: '\u0627\u0631\u062f\u0648' },
+  'vi': { name: 'Vietnamese', nativeName: 'Ti\u1ebfng Vi\u1ec7t' },
+};
 
 class InitService {
   constructor(config = {}) {
@@ -56,7 +83,9 @@ class InitService {
     };
 
     this.format = getFormatAdapter(this.config.format);
-    this.config.supportedExtensions = [this.format.extension];
+    if (!this.config.supportedExtensions || !this.config.supportedExtensions.length) {
+      this.config.supportedExtensions = [this.format.extension];
+    }
     this.detectedFramework = detectFramework(process.cwd());
     if (this.detectedFramework && !this.config.translationPatterns) {
       this.config.translationPatterns = this.detectedFramework.patterns;
@@ -68,7 +97,9 @@ class InitService {
       : path.join(this.sourceDir, this.config.sourceLanguage);
 
     // Ensure defaultLanguages is properly initialized from config
-    this.config.defaultLanguages = this.config.defaultLanguages || ['en', 'de', 'es', 'fr', 'ru'];
+    if (!this.config.defaultLanguages || !Array.isArray(this.config.defaultLanguages) || this.config.defaultLanguages.length === 0) {
+      this.config.defaultLanguages = ['en', 'de', 'es', 'fr', 'ru'];
+    }
   }
 
   // Check i18n dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18ntk",
-  "version": "4.6.0",
+  "version": "4.7.0",
   "description": "i18n Tool Kit - Zero-dependency internationalization toolkit for setup, scanning, analysis, validation, auto translation, fixing, reporting, and runtime translation loading.",
   "readmeFilename": "README.md",
   "keywords": [
@@ -179,27 +179,28 @@
   },
   "preferGlobal": true,
   "versionInfo": {
-    "version": "4.6.0",
-    "releaseDate": "07/04/2026",
-    "lastUpdated": "07/04/2026",
+    "version": "4.7.0",
+    "releaseDate": "07/07/2026",
+    "lastUpdated": "07/07/2026",
     "maintainer": "Vlad Noskov",
     "changelog": "./CHANGELOG.md",
     "documentation": "./README.md",
     "apiReference": "./docs/api/API_REFERENCE.md",
     "majorChanges": [
-      "FRAMEWORK DETECTION: Added 10 new framework detections — Rust (fluent, gettext-rs), Remix, Gatsby, Astro, Qwik, Solid, Ember, React Native, Expo, Ionic. Framework detection now unified across all code paths.",
-      "RUST SUPPORT: Cargo.toml detection added to FrameworkDetectionService; .rs file extension added to all scanners and source walkers.",
-      "FILE EXTENSIONS: Added .astro, .mdx, .mjs, .mts, .cjs, .cts, .rs to all file scan lists across CLI and VS Code extensions. Astro components, ESM modules, and Rust source files are now scanned for translation keys.",
-      "ACTIVATION EVENTS: Added 14 new framework-specific activation triggers (next.config, astro.config, remix.config, svelte.config, nuxt.config, gatsby-config, Cargo.toml) for faster VS Code extension startup.",
-      "ICU/FLUENT PLACEHOLDER SUPPORT: Added Fluent $variable and ICU MessageFormat {var, plural, ...} patterns to placeholder detection and comparison.",
-      "REACT JSX COMPONENT DETECTION: Added detection of <Trans i18nKey>, <FormattedMessage id>, <FormattedMessage defaultMessage>, <t message>, and <Translate id> JSX components in both VS Code extensions.",
-      "CONFIGURATION DEFAULTS: Updated exclude defaults and activation events with framework-specific directories (.nuxt, .output, .astro, .svelte-kit, .cache, __generated__, target).",
-      "HEALTH SCORE: Fixed health score calculation to prevent negative scores. Penalty is now capped and uses a linear decay curve instead of unbounded subtraction.",
-      "DOCUMENTATION: Updated README, CHANGELOG, and package metadata for 4.6.0. All supportedFrameworks now reflect actual detection capabilities.",
-      "COMPREHENSIVE TESTING: All 128+ tests pass across CLI (33), Workbench (65), and Lens (32) packages."
+      "BUG FIX: LANGUAGE_CONFIG expanded from 21 to 61 languages with comprehensive ISO 639-1 coverage. All common languages now display their native names in init output instead of 'Unknown'.",
+      "BUG FIX: defaultLanguages no longer silently truncates to 5 when the config value is an empty array or null. A validation guard preserves the caller's configured list.",
+      "BUG FIX: Auto Translate now exits 0 on success even when residual untranslated values exist (placeholders, branded terms, short labels). Only real failures (0 translated with >0 total) now produce non-zero exit codes.",
+      "BUG FIX: supportedExtensions is no longer unconditionally overridden by the format adapter during init. Users who configure extensions in .i18ntk-config keep them.",
+      "BUG FIX: allowedEnglishTerms now unifies between validation-risk.js and project config. resolveAllowedEnglishTerms() accepts both inline options and project-level .i18ntk-config terms as fallback sources.",
+      "FRAMEWORK DETECTION: Added 10 new framework detections — Rust, Remix, Gatsby, Astro, Qwik, SolidJS, Ember, React Native, Expo, Ionic. Centralized into framework-detector.js as single source of truth.",
+      "FILE EXTENSIONS: Added .astro, .mdx, .mjs, .mts, .cjs, .cts, .rs to all file scan lists via centralized SOURCE_EXTENSIONS and SCANNER_EXTENSIONS.",
+      "ICU/FLUENT PLACEHOLDER SUPPORT: Fluent $variable and ICU MessageFormat patterns added to placeholder detection and comparison.",
+      "JSX COMPONENT DETECTION: <Trans>, <FormattedMessage>, <Translate> JSX components detected in both VS Code extensions.",
+      "COMPREHENSIVE TESTING: All 384+ tests pass across CLI, Workbench, and Lens packages.",
+      "FRAMEWORK DETECTION v2: Added 13 additional FRAMEWORK_PATTERNS (i18ntk-runtime, nuxt, formatjs, lingui, ngx-translate, next-intl, svelte-i18n, solid-i18n, fastapi, ruby-on-rails, react-native-localize, ionic). Expanded detectFramework() to check Python/Rust/Go/Ruby project files. Added 20+ WRAPPER_SKIP_PATTERNS. Added 8 missing FRAMEWORK_COMPATIBILITY versions. Now supports 30+ frameworks across 15+ languages."
     ],
     "breakingChanges": [],
-    "nextVersion": "4.6.1",
+    "nextVersion": "4.7.1",
     "supportedNodeVersions": ">=16.0.0",
     "supportedFrameworks": {
       "react-i18next": ">=11.0.0",
@@ -228,18 +229,18 @@
       "fluent-rs": ">=0.16.0",
       "gettext-rs": ">=0.7.0"
     },
-    "supportPolicy": "Versions earlier than 4.6.0 may be unstable or insecure in CI automation. Upgrade to 4.6.0 or newer.",
+    "supportPolicy": "Versions earlier than 4.7.0 may be unstable or insecure in CI automation. Upgrade to 4.7.0 or newer.",
     "deprecations": [
       "4.3.0",
       "4.3.1",
       "4.3.2",
       "4.3.3"
     ],
-    "deprecationMessage": "i18ntk 4.3.x and earlier have known security vulnerabilities (path traversal, JSON DoS). Upgrade to i18ntk@4.6.0 or newer: npm install -g i18ntk@latest",
+    "deprecationMessage": "i18ntk 4.3.x and earlier have known security vulnerabilities (path traversal, JSON DoS). Upgrade to i18ntk@4.7.0 or newer: npm install -g i18ntk@latest",
     "securityAdvisories": [
       "GHSA-i18ntk-4.3.x-path-traversal: Backup command accepted arbitrary paths without validation (fixed in 4.4.1)",
       "GHSA-i18ntk-4.3.x-json-dos: Deeply nested JSON files could cause denial of service (fixed in 4.4.1)"
     ]
   },
-  "readme": "# i18ntk v4.6.0\n\nA zero-dependency internationalization toolkit for setup, scanning, analysis, validation, usage tracking, translation completion, automatic JSON locale translation, reporting, and runtime translation loading.\n\n![i18ntk Logo](https://raw.githubusercontent.com/vladnoskv/i18ntk/main/docs/screenshots/i18ntk-logo-public.PNG)\n\n[![npm version](https://img.shields.io/npm/v/i18ntk.svg?color=brightgreen)](https://www.npmjs.com/package/i18ntk)\n[![npm downloads](https://img.shields.io/npm/dt/i18ntk.svg)](https://www.npmjs.com/package/i18ntk)\n[![node](https://img.shields.io/badge/node-%3E%3D16-339933)](https://nodejs.org)\n[![dependencies](https://img.shields.io/badge/dependencies-0-success)](https://www.npmjs.com/package/i18ntk)\n[![license](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)\n[![socket](https://socket.dev/api/badge/npm/package/i18ntk/4.6.0)](https://socket.dev/npm/package/i18ntk/overview/4.6.0)\n\n[![i18ntk Workbench](https://img.shields.io/badge/VS_Code-Workbench-007ACC?logo=visualstudiocode&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=VladNoskov.i18ntk-workbench)\n[![i18ntk Lens](https://img.shields.io/badge/VS_Code-Lens-007ACC?logo=visualstudiocode&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=VladNoskov.i18ntk-lens)\n\n## Ecosystem\n\n- **i18ntk** — CLI toolkit and runtime (this package)\n- **i18ntk Workbench** — VS Code dashboard, reports, and key management\n- **i18ntk Lens** — inline hovers, CodeLens, and diagnostics\n\n## Install\n\n```bash\nnpm install -g i18ntk\nnpx i18ntk --help\n```\n\n## What's New in 4.6.0\n\n- **25+ framework detections** — Rust, Remix, Gatsby, Astro, Qwik, SolidJS, Ember, React Native, Expo, Ionic added. All drawn from a single centralized detector.\n- **Rust support** — Cargo.toml detection and `.rs` file scanning with fluent/gettext-rs framework patterns.\n- **File extensions** — `.astro`, `.mdx`, `.mjs`, `.mts`, `.cjs`, `.cts`, `.rs` scanned across all tools.\n- **ICU/Fluent placeholder support** — Fluent `$variable` and ICU `{var, plural, ...}` patterns detected.\n- **JSX component detection** — `<Trans>`, `<FormattedMessage>`, `<Translate>` components recognized.\n- **Health score fix** — No more negative or misleadingly low scores.\n- **Centralized architecture** — Framework data, extensions, excludes, and patterns live in one module consumed by all tools.\n\n[Full changelog →](./CHANGELOG.md)\n\n## Quick Start\n\n```bash\ni18ntk                                    # interactive menu\ni18ntk --command=analyze                  # coverage report\ni18ntk --command=validate                 # quality checks\ni18ntk --command=usage                    # key usage tracking\ni18ntk report --json --out ./reports      # full report\ni18ntk --command=complete                 # fill missing keys\ni18ntk --command=translate                # auto-translate\ni18ntk --command=summary                  # status overview\n```\n\nSee [docs/getting-started.md](./docs/getting-started.md) for the full onboarding guide.\n\n## Command Reference\n\n| Command     | Purpose                                    | Output                        |\n| ----------- | ------------------------------------------ | ----------------------------- |\n| `i18ntk`    | Interactive management menu                | —                             |\n| `init`      | Setup locale folders and target files      | Locale JSON, `.i18ntk-config` |\n| `analyze`   | Translation coverage comparison            | Reports                       |\n| `validate`  | Structure, quality, and risk validation    | Summary report                |\n| `usage`     | Map keys to source, find dead/missing keys | Usage report                  |\n| `report`    | Stable schema report (JSON/MD/HTML)        | stdout or file output         |\n| `scanner`   | Detect hardcoded text in source files      | Scanner report                |\n| `complete`  | Fill missing keys in target files          | Target locale JSON            |\n| `translate` | Auto-translate via provider AI             | Target locale JSON            |\n| `sizing`    | Expansion risk and layout analysis         | Sizing report                 |\n| `summary`   | Project translation status overview        | Console output                |\n| `fixer`     | Fix placeholders and markers               | Locale JSON                   |\n| `backup`    | Create/verify/restore locale backups       | Backup archives               |\n\nEach is available as `i18ntk --command=<name>` or standalone `i18ntk-<name>`.\n\n## Common Options\n\n```\n--code-dir <path>       Source code directory\n--locales-dir <path>    Locale files directory\n--output-dir <path>     Report output directory\n--source-locale <code>  Source language code (e.g. en)\n--framework <name>      Override framework detection\n--no-prompt             Skip interactive prompts\n--help                  Show help\n```\n\n## Auto Translate\n\n```bash\ni18ntk-translate locales/en/common.json de\ni18ntk-translate locales/en/common.json fr --dry-run --preserve-placeholders\n```\n\n**Providers:** Google (default), DeepL, LibreTranslate\n\n```bash\nexport DEEPL_API_KEY=\"your-key\"\ni18ntk-translate locales/en/common.json de --provider deepl --no-confirm\n```\n\n**Placeholder-aware translation** detects `{name}`, `{{count}}`, `%s`, `:id`, `${value}`, `$t(key)`, and ICU pattern syntax. The default mode is `--only-missing` — existing translations are preserved.\n\nProtected terms and keys via `i18ntk-auto-translate.json`:\n\n```json\n{\n  \"version\": 1,\n  \"terms\": [\"BrandName\", \"PRODUCT_CODE\"],\n  \"keys\": [\"app.brandName\", \"product.*.symbol\"],\n  \"values\": [\"BrandName Ltd\"],\n  \"patterns\": [\"[A-Z]{2,}-\\\\d+\"]\n}\n```\n\n[Auto Translate guide →](./docs/auto-translate.md)\n\n## Configuration\n\nExample `.i18ntk-config`:\n\n```json\n{\n  \"version\": \"4.6.0\",\n  \"sourceDir\": \"./locales\",\n  \"i18nDir\": \"./locales\",\n  \"sourceLanguage\": \"en\",\n  \"defaultLanguages\": [\"en\", \"de\", \"es\", \"fr\", \"ru\"],\n  \"keyStyle\": \"dot.notation\",\n  \"englishContentThresholdPercent\": 10,\n  \"allowedEnglishTerms\": [\"BrandName\"],\n  \"autoTranslate\": {\n    \"placeholderMode\": \"preserve\",\n    \"concurrency\": 12,\n    \"onlyMissingOrEnglish\": true\n  },\n  \"extensions\": {\n    \"workbench\": { \"localeDirectory\": \"./locales\", \"sourceLocale\": \"en\" },\n    \"lens\": { \"localeDirectory\": \"./locales\", \"sourceLocale\": \"en\", \"keyFormats\": [\"dot\", \"snake\"] }\n  }\n}\n```\n\n[Configuration reference →](./docs/api/CONFIGURATION.md)\n\n## Scanner\n\nDetects hardcoded text in 12+ languages with language-specific character ranges and stopword filtering. Framework-specific patterns for React, Vue, Angular, Svelte, Astro, Django, Flask, Python, Rust, Go, and more.\n\n```bash\ni18ntk-scanner --code-dir ./src --source-locale de\ni18ntk-scanner --code-dir ./src --source-locale ja --output-report\n```\n\n## Usage Analysis\n\nTracks key references, detects dead keys with confidence scores, resolves dynamic patterns (templates, arrays, object maps), and recommends namespace alignment.\n\n```bash\ni18ntk-usage --code-dir ./src --locales-dir ./locales --cleanup --dry-run-delete\n```\n\n## Runtime\n\n```js\nconst runtime = require('i18ntk/runtime');\nconst i18n = runtime.initRuntime({\n  baseDir: './locales',\n  language: 'en',\n  fallbackLanguage: 'en',\n});\n\nconsole.log(i18n.t('common.hello'));\ni18n.setLanguage('fr');\nconsole.log(i18n.getAvailableLanguages());\n```\n\n**Lazy loading** reduces memory on large locale folders:\n\n```js\nconst i18n = runtime.initRuntime({ baseDir: './locales', language: 'en', lazy: true });\n```\n\n**Per-call language overrides:**\n\n```js\ni18n.t('common.hello', {}, { language: 'de' });\n```\n\n**Batch translation:**\n\n```js\ni18n.translateBatch(['menu.home', 'menu.settings']);\n```\n\nProduction guidance:\n\n- Use the instance from `initRuntime()` — not module-level `runtime.t()` — in multi-tenant apps\n- Use `lazy: true` for large folders; `preload: true` for small sets\n- Call `refresh(language)` after deploying changed locale files\n- `i18ntk/runtime/enhanced` remains available for async/encryption compatibility\n\n[Runtime guide →](./docs/runtime.md)\n\n## Watch\n\n```js\nconst watchLocales = require('i18ntk/utils/watch-locales');\nconst watcher = watchLocales('./locales');\n\nwatcher.on('change', (filePath) => console.log('changed:', filePath));\nwatcher.on('add', (filePath) => console.log('added:', filePath));\nwatcher.stop();\n```\n\nFeatures: 300ms debounce, SHA-256 hash tracking, 50-directory cap. The callback form `watchLocales('./locales', onChange)` is still supported.\n\n## Documentation\n\n- [Getting Started](./docs/getting-started.md)\n- [Configuration](./docs/api/CONFIGURATION.md)\n- [API Reference](./docs/api/API_REFERENCE.md)\n- [Runtime API](./docs/runtime.md)\n- [Auto Translate](./docs/auto-translate.md)\n- [Scanner Guide](./docs/scanner-guide.md)\n- [Environment Variables](./docs/environment-variables.md)\n\n## Security\n\n- No API key required for default Auto Translate\n- Do not store secrets in locale files, `.i18ntk-config`, or protection files\n- Report issues via [SECURITY.md](./SECURITY.md)\n\n## Related\n\n| Tool             | Purpose                                     |\n| ---------------- | ------------------------------------------- |\n| i18ntk Workbench | VS Code localization health dashboard       |\n| i18ntk Lens      | Inline hovers, CodeLens, and diagnostics    |\n| PublishGuard     | Pre-publish safety scanner for npm packages |\n| ContextKit       | AI coding context manager                   |\n\n## License\n\nSee [LICENSE](./LICENSE).\n"
+  "readme": "# i18ntk v4.7.0\n\nA zero-dependency internationalization toolkit for setup, scanning, analysis, validation, usage tracking, translation completion, automatic JSON locale translation, reporting, and runtime translation loading.\n\n![i18ntk Logo](https://raw.githubusercontent.com/vladnoskv/i18ntk/main/docs/screenshots/i18ntk-logo-public.PNG)\n\n[![npm version](https://img.shields.io/npm/v/i18ntk.svg?color=brightgreen)](https://www.npmjs.com/package/i18ntk)\n[![npm downloads](https://img.shields.io/npm/dt/i18ntk.svg)](https://www.npmjs.com/package/i18ntk)\n[![node](https://img.shields.io/badge/node-%3E%3D16-339933)](https://nodejs.org)\n[![dependencies](https://img.shields.io/badge/dependencies-0-success)](https://www.npmjs.com/package/i18ntk)\n[![license](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)\n[![socket](https://socket.dev/api/badge/npm/package/i18ntk/4.7.0)](https://socket.dev/npm/package/i18ntk/overview/4.7.0)\n\n[![i18ntk Workbench](https://img.shields.io/badge/VS_Code-Workbench-007ACC?logo=visualstudiocode&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=VladNoskov.i18ntk-workbench)\n[![i18ntk Lens](https://img.shields.io/badge/VS_Code-Lens-007ACC?logo=visualstudiocode&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=VladNoskov.i18ntk-lens)\n\n## Ecosystem\n\n- **i18ntk** — CLI toolkit and runtime (this package)\n- **i18ntk Workbench** — VS Code dashboard, reports, and key management\n- **i18ntk Lens** — inline hovers, CodeLens, and diagnostics\n\n## Install\n\n```bash\nnpm install -g i18ntk\nnpx i18ntk --help\n```\n\n## What's New in 4.7.0\n\n- **30+ framework detection patterns** — 13 new FRAMEWORK_PATTERNS: `i18ntk-runtime`, `nuxt`, `lingui`, `formatjs`, `ngx-translate`, `next-intl`, `svelte-i18n`, `solid-i18n`, `fastapi`, `ruby-on-rails`, `react-native-localize`, `ionic`. Each with framework-specific scan regexes for translation calls, JSX components, template directives, and pipes.\n- **Non-Node project detection** — Python (`requirements.txt`, `pyproject.toml`, `setup.py`), Rust (`Cargo.toml`), Go (`go.mod`), Ruby (`Gemfile`) now detected when no `package.json` exists. Detects Django, Flask, FastAPI, Rails, and generic i18n.\n- **20+ new WRAPPER_SKIP_PATTERNS** — Covers I18n.t(), useTranslate(), translateService.instant(), formatMessage(), bundle.get_message(), fluent!, ts! and more.\n- **Framework-aware report generation** — `report-model.js` accepts optional framework parameter and uses framework-specific patterns for key extraction.\n- **Expanded namespace helpers** — `useTranslate` (Qwik), `useSpeak` (Qwik), `withTranslation` (react-i18next) added.\n- **Attribute key detection** — `i18nKey=`, `t-key=`, `data-i18n=` attributes detected in source scanning.\n- **All frame works now have FRAMEWORK_COMPATIBILITY entries and FRAMEWORK_SUGGESTIONS** for consistent tooling.\n\n[Full changelog →](./CHANGELOG.md)\n\n## Quick Start\n\n```bash\ni18ntk                                    # interactive menu\ni18ntk --command=analyze                  # coverage report\ni18ntk --command=validate                 # quality checks\ni18ntk --command=usage                    # key usage tracking\ni18ntk report --json --out ./reports      # full report\ni18ntk --command=complete                 # fill missing keys\ni18ntk --command=translate                # auto-translate\ni18ntk --command=summary                  # status overview\n```\n\nSee [docs/getting-started.md](./docs/getting-started.md) for the full onboarding guide.\n\n## Command Reference\n\n| Command     | Purpose                                    | Output                        |\n| ----------- | ------------------------------------------ | ----------------------------- |\n| `i18ntk`    | Interactive management menu                | —                             |\n| `init`      | Setup locale folders and target files      | Locale JSON, `.i18ntk-config` |\n| `analyze`   | Translation coverage comparison            | Reports                       |\n| `validate`  | Structure, quality, and risk validation    | Summary report                |\n| `usage`     | Map keys to source, find dead/missing keys | Usage report                  |\n| `report`    | Stable schema report (JSON/MD/HTML)        | stdout or file output         |\n| `scanner`   | Detect hardcoded text in source files      | Scanner report                |\n| `complete`  | Fill missing keys in target files          | Target locale JSON            |\n| `translate` | Auto-translate via provider AI             | Target locale JSON            |\n| `sizing`    | Expansion risk and layout analysis         | Sizing report                 |\n| `summary`   | Project translation status overview        | Console output                |\n| `fixer`     | Fix placeholders and markers               | Locale JSON                   |\n| `backup`    | Create/verify/restore locale backups       | Backup archives               |\n\nEach is available as `i18ntk --command=<name>` or standalone `i18ntk-<name>`.\n\n## Common Options\n\n```\n--code-dir <path>       Source code directory\n--locales-dir <path>    Locale files directory\n--output-dir <path>     Report output directory\n--source-locale <code>  Source language code (e.g. en)\n--framework <name>      Override framework detection\n--no-prompt             Skip interactive prompts\n--help                  Show help\n```\n\n## Auto Translate\n\n```bash\ni18ntk-translate locales/en/common.json de\ni18ntk-translate locales/en/common.json fr --dry-run --preserve-placeholders\n```\n\n**Providers:** Google (default), DeepL, LibreTranslate\n\n```bash\nexport DEEPL_API_KEY=\"your-key\"\ni18ntk-translate locales/en/common.json de --provider deepl --no-confirm\n```\n\n**Placeholder-aware translation** detects `{name}`, `{{count}}`, `%s`, `:id`, `${value}`, `$t(key)`, and ICU pattern syntax. The default mode is `--only-missing` — existing translations are preserved.\n\nProtected terms and keys via `i18ntk-auto-translate.json`:\n\n```json\n{\n  \"version\": 1,\n  \"terms\": [\"BrandName\", \"PRODUCT_CODE\"],\n  \"keys\": [\"app.brandName\", \"product.*.symbol\"],\n  \"values\": [\"BrandName Ltd\"],\n  \"patterns\": [\"[A-Z]{2,}-\\\\d+\"]\n}\n```\n\n[Auto Translate guide →](./docs/auto-translate.md)\n\n## Configuration\n\nExample `.i18ntk-config`:\n\n```json\n{\n  \"version\": \"4.6.1\",\n  \"sourceDir\": \"./locales\",\n  \"i18nDir\": \"./locales\",\n  \"sourceLanguage\": \"en\",\n  \"defaultLanguages\": [\"en\", \"de\", \"es\", \"fr\", \"ru\"],\n  \"keyStyle\": \"dot.notation\",\n  \"englishContentThresholdPercent\": 10,\n  \"allowedEnglishTerms\": [\"BrandName\"],\n  \"autoTranslate\": {\n    \"placeholderMode\": \"preserve\",\n    \"concurrency\": 12,\n    \"onlyMissingOrEnglish\": true\n  },\n  \"extensions\": {\n    \"workbench\": { \"localeDirectory\": \"./locales\", \"sourceLocale\": \"en\" },\n    \"lens\": { \"localeDirectory\": \"./locales\", \"sourceLocale\": \"en\", \"keyFormats\": [\"dot\", \"snake\"] }\n  }\n}\n```\n\n[Configuration reference →](./docs/api/CONFIGURATION.md)\n\n## Scanner\n\nDetects hardcoded text in 12+ languages with language-specific character ranges and stopword filtering. Framework-specific patterns for React, Vue, Angular, Svelte, Astro, Django, Flask, Python, Rust, Go, and more.\n\n```bash\ni18ntk-scanner --code-dir ./src --source-locale de\ni18ntk-scanner --code-dir ./src --source-locale ja --output-report\n```\n\n## Usage Analysis\n\nTracks key references, detects dead keys with confidence scores, resolves dynamic patterns (templates, arrays, object maps), and recommends namespace alignment.\n\n```bash\ni18ntk-usage --code-dir ./src --locales-dir ./locales --cleanup --dry-run-delete\n```\n\n## Runtime\n\n```js\nconst runtime = require('i18ntk/runtime');\nconst i18n = runtime.initRuntime({\n  baseDir: './locales',\n  language: 'en',\n  fallbackLanguage: 'en',\n});\n\nconsole.log(i18n.t('common.hello'));\ni18n.setLanguage('fr');\nconsole.log(i18n.getAvailableLanguages());\n```\n\n**Lazy loading** reduces memory on large locale folders:\n\n```js\nconst i18n = runtime.initRuntime({ baseDir: './locales', language: 'en', lazy: true });\n```\n\n**Per-call language overrides:**\n\n```js\ni18n.t('common.hello', {}, { language: 'de' });\n```\n\n**Batch translation:**\n\n```js\ni18n.translateBatch(['menu.home', 'menu.settings']);\n```\n\nProduction guidance:\n\n- Use the instance from `initRuntime()` — not module-level `runtime.t()` — in multi-tenant apps\n- Use `lazy: true` for large folders; `preload: true` for small sets\n- Call `refresh(language)` after deploying changed locale files\n- `i18ntk/runtime/enhanced` remains available for async/encryption compatibility\n\n[Runtime guide →](./docs/runtime.md)\n\n## Watch\n\n```js\nconst watchLocales = require('i18ntk/utils/watch-locales');\nconst watcher = watchLocales('./locales');\n\nwatcher.on('change', (filePath) => console.log('changed:', filePath));\nwatcher.on('add', (filePath) => console.log('added:', filePath));\nwatcher.stop();\n```\n\nFeatures: 300ms debounce, SHA-256 hash tracking, 50-directory cap. The callback form `watchLocales('./locales', onChange)` is still supported.\n\n## Documentation\n\n- [Getting Started](./docs/getting-started.md)\n- [Configuration](./docs/api/CONFIGURATION.md)\n- [API Reference](./docs/api/API_REFERENCE.md)\n- [Runtime API](./docs/runtime.md)\n- [Auto Translate](./docs/auto-translate.md)\n- [Scanner Guide](./docs/scanner-guide.md)\n- [Environment Variables](./docs/environment-variables.md)\n\n## Security\n\n- No API key required for default Auto Translate\n- Do not store secrets in locale files, `.i18ntk-config`, or protection files\n- Report issues via [SECURITY.md](./SECURITY.md)\n\n## Related\n\n| Tool             | Purpose                                     |\n| ---------------- | ------------------------------------------- |\n| i18ntk Workbench | VS Code localization health dashboard       |\n| i18ntk Lens      | Inline hovers, CodeLens, and diagnostics    |\n| PublishGuard     | Pre-publish safety scanner for npm packages |\n| ContextKit       | AI coding context manager                   |\n\n## License\n\nSee [LICENSE](./LICENSE).\n"
 }

package/utils/framework-detector.js

@@ -22,9 +22,17 @@ const FRAMEWORK_COMPATIBILITY = {
   'gatsby': { minVersion: '4.0.0' },
   'astro': { minVersion: '2.0.0' },
   'qwik': { minVersion: '1.0.0' },
+  'nuxt': { minVersion: '7.0.0' },
+  'nuxt-i18n': { minVersion: '7.0.0' },
+  'next-intl': { minVersion: '2.0.0' },
+  'ngx-translate': { minVersion: '13.0.0' },
+  'svelte-i18n': { minVersion: '3.0.0' },
+  'solid-i18n': { minVersion: '1.0.0' },
   'ember-intl': { minVersion: '5.0.0' },
   'react-native-localize': { minVersion: '2.0.0' },
-  'ionic': { minVersion: '6.0.0' }
+  'ionic': { minVersion: '6.0.0' },
+  'expo': { minVersion: '48.0.0' },
+  'vanilla': { minVersion: '1.0.0' }
 };
 
 // Define framework detection in order of specificity
@@ -462,6 +470,13 @@ const SOURCE_DIRS = [
 ];
 
 const FRAMEWORK_PATTERNS = {
+  'i18ntk-runtime': [
+    />([^<{][^<>{]*[^}>])</g,
+    /<button[^>]*>([^<]{2,99})<\/button>/g,
+    /i18n\.t\(["']([^"']{2,99})["']\)/g,
+    /useI18n\(\)\.t\(["']([^"']{2,99})["']\)/g,
+    /<t\s[\s\S]*?\bmessage\s*=\s*(?:\{|)(['"`])([^'"`}]+)\1[^>]*>/g
+  ],
   react: [
     /children:\s*["']([^"']{2,99})["']/g,
     /dangerouslySetInnerHTML={{\s*__html:\s*["']([^"']{2,99})["']/g,
@@ -476,6 +491,14 @@ const FRAMEWORK_PATTERNS = {
     /<button[^>]*>([^<]{2,99})<\/button>/g,
     /<(?:FormattedMessage|Trans)[\s\S]*?\b(?:id|defaultMessage|i18nKey)\s*=\s*(?:\{|)(['"`])([^'"`}]+)\1[^>]*>/g
   ],
+  nuxt: [
+    />([^<{][^<>{]*[^}>])</g,
+    /<button[^>]*>([^<]{2,99})<\/button>/g,
+    /\$t\(["']([^"']{2,99})["']\)/g,
+    /\$tc\(["']([^"']{2,99})["']\)/g,
+    /v-t=["']([^"']{2,99})["']/g,
+    /\blocalePath\(\s*\)/g
+  ],
   vue: [
     /v-text=["']([^"']{2,99})["']/g,
     /v-html=["']([^"']{2,99})["']/g,
@@ -562,6 +585,68 @@ const FRAMEWORK_PATTERNS = {
     /i18n\.NewMessage\([^,]+,\s*["']([^"']{2,99})["']\)/g,
     /t\.Get\([^,]+,\s*["']([^"']{2,99})["']\)/g
   ],
+  lingui: [
+    />([^<{][^<>{]*[^}>])</g,
+    /(?<![\w$.])t\s*\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /_\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /<Translate\s[\s\S]*?\bid\s*=\s*(?:\{|)(['"`])([^'"`}]+)\1[^>]*>/g
+  ],
+  formatjs: [
+    />([^<{][^<>{]*[^}>])</g,
+    /formatMessage\(\s*\{\s*id:\s*['"`]([^'"`]{2,99})['"`]/g,
+    /<FormattedMessage\s[\s\S]*?\bid\s*=\s*(?:\{|)(['"`])([^'"`}]+)\1[^>]*>/g
+  ],
+  'ngx-translate': [
+    />([^<{][^<>{]*[^}>])</g,
+    /\|\s*translate\s*[^}]*\}\}/g,
+    /translateService\.instant\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /translateService\.get\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /translate\s*=\s*["'`]([^"'`]{2,99})["'`]/g,
+    /\[innerHTML\]=["']([^"']{2,99})["']/g
+  ],
+  'next-intl': [
+    />([^<{][^<>{]*[^}>])</g,
+    /t\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /\buseTranslations\(\s*()\)/g
+  ],
+  'svelte-i18n': [
+    />([^<{][^<>{]*[^}>])</g,
+    /\$_\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /\$_\w*\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /\bt\.get\(\s*['"`]([^'"`]{2,99})['"`]/g
+  ],
+  'solid-i18n': [
+    />([^<{][^<>{]*[^}>])</g,
+    /\buseI18n\(\s*\)\s*\.\s*t\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /t\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /<Translate\s[\s\S]*?\bid\s*=\s*(?:\{|)(['"`])([^'"`}]+)\1[^>]*>/g
+  ],
+  fastapi: [
+    /_\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /i18n\.t\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /\{\{\s*_['"]([^'"]{2,99})['"]\s*\}\}/g,
+    /\{\{\s*gettext\(['"`]([^'"`]{2,99})['"`]\)\s*\}\}/g
+  ],
+  'ruby-on-rails': [
+    /I18n\.t\(\s*['"]([^'"]{2,99})['"]/g,
+    /I18n\.translate\(\s*['"]([^'"]{2,99})['"]/g,
+    /I18n\.l\(\s*['"]([^'"]{2,99})['"]/g,
+    /<%= t\(['"]([^'"]{2,99})['"]/g,
+    /<%= I18n\.t\(['"]([^'"]{2,99})['"]/g,
+    /(?<![\w$.])t\s*\(\s*['"]([^'"]{2,99})['"]/g
+  ],
+  'react-native-localize': [
+    />([^<{][^<>{]*[^}>])</g,
+    /\bi18n\.t\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /\bt\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /\btranslate\(\s*['"`]([^'"`]{2,99})['"`]/g
+  ],
+  ionic: [
+    />([^<{][^<>{]*[^}>])</g,
+    /\|\s*translate\s*[^}]*\}\}/g,
+    /translateService\.instant\(\s*['"`]([^'"`]{2,99})['"`]/g,
+    /translateService\.get\(\s*['"`]([^'"`]{2,99})['"`]/g
+  ],
   vanilla: [
     /t\(["']([^"']{2,99})["']\)/g,
     /i18n\.t\(["']([^"']{2,99})["']\)/g,
@@ -581,6 +666,18 @@ const FRAMEWORK_SUGGESTIONS = {
   solid: { hook: 'const [t] = useI18n();', usage: "{t('ui.KEY')}" },
   ember: { template: "{{t 'ui.KEY'}}", helper: "this.intl.t('ui.KEY')" },
   gatsby: { hook: 'const { t } = useTranslation();', usage: "{t('ui.KEY')}", plugin: "'gatsby-plugin-react-i18next'" },
+  nuxt: { directive: "{{ $t('ui.KEY') }}", method: "this.$t('ui.KEY')", component: "<NuxtLink :to=\"localePath('ui.KEY')\">" },
+  'i18ntk-runtime': { hook: 'const { t } = useI18n();', usage: "{t('ui.KEY')}", component: "<t message=\"ui.KEY\">text</t>" },
+  lingui: { hook: 'import { t } from \"@lingui/macro\";', usage: "{t('ui.KEY')}", component: "<Trans id=\"ui.KEY\">text</Trans>" },
+  formatjs: { hook: 'import { FormattedMessage, useIntl } from \"react-intl\";', usage: "intl.formatMessage({ id: 'ui.KEY' })", component: "<FormattedMessage id=\"ui.KEY\" />" },
+  'ngx-translate': { pipe: "{{ 'ui.KEY' | translate }}", service: "this.translateService.instant('ui.KEY')" },
+  'next-intl': { hook: 'const t = useTranslations();', usage: "{t('ui.KEY')}" },
+  'svelte-i18n': { store: "$_('ui.KEY')", method: "t.get('ui.KEY')" },
+  'solid-i18n': { hook: 'const [t] = useI18n();', usage: "{t('ui.KEY')}", component: "<Translate id=\"ui.KEY\" />" },
+  fastapi: { python: "from fastapi_i18n import _\n_('text')", template: "{{ _('text') }}" },
+  'ruby-on-rails': { helper: "t('ui.KEY')", method: "I18n.t('ui.KEY')", template: "<%= t('ui.KEY') %>" },
+  'react-native-localize': { hook: 'import { t } from \"i18n-js\";', usage: "{t('ui.KEY')}" },
+  ionic: { pipe: "{{ 'ui.KEY' | translate }}", service: "this.translateService.instant('ui.KEY')" },
   django: { template: "{% trans 'text' %}", python: "from django.utils.translation import gettext as _\n_('text')", model: "from django.utils.translation import gettext_lazy as _\n_('text')" },
   flask: { template: "{{ _('text') }}", python: "from flask_babel import gettext as _\n_('text')", lazy: "from flask_babel import lazy_gettext as _\n_('text')" },
   python: { gettext: "import gettext\ngettext.gettext('text')", underscore: "from gettext import gettext as _\n_('text')", lazy: "from gettext import gettext_lazy as _\n_('text')" },
@@ -591,8 +688,13 @@ const FRAMEWORK_SUGGESTIONS = {
 
 const WRAPPER_SKIP_PATTERNS = [
   't(', 'tx(', 'i18n.t(', 'i18n.translate(', 'translate(',
-  'useI18n(', 'useTranslation(', '__', '__t', '$_(', '$t(',
-  'gettext(', 'gettext_lazy(', 'lazy_gettext(', 'pgettext(', 'ngettext('
+  'useI18n(', 'useTranslation(', '__', '__t', '$_(', '$t(', '_(',
+  '$tc(', 'gettext(', 'gettext_lazy(', 'lazy_gettext(', 'pgettext(', 'ngettext(',
+  'I18n.t(', 'I18n.translate(', 'I18n.l(', 'I18n.localize(',
+  't.get(', 'useTranslate(', 'useSpeak(', 'withTranslation(',
+  'formatMessage(', 'bundle.get_message(', 'i18n.NewMessage(',
+  'i18n.Translate(', '_l(', '_n(', 't.set(', 'fluent!', 'ts!',
+  'translateService.instant(', 'translateService.get('
 ];
 
 function _keySnippet(text) {
@@ -643,83 +745,168 @@ function detectFramework(projectRoot) {
     throw new Error('Invalid project root path');
   }
 
-  const packageJsonPath = path.join(projectRoot, 'package.json');
   const detectedFrameworks = [];
 
-  // Only proceed if package.json exists
-  if (!SecurityUtils.safeExistsSync(packageJsonPath, projectRoot)) {
-    return null;
+  // Phase 1: Check package.json for Node.js-based i18n frameworks
+  const packageJsonPath = path.join(projectRoot, 'package.json');
+  if (SecurityUtils.safeExistsSync(packageJsonPath, projectRoot)) {
+    try {
+      const packageJsonContent = SecurityUtils.safeReadFileSync(packageJsonPath, projectRoot, 'utf8');
+      if (packageJsonContent) {
+        const packageJson = SecurityUtils.safeParseJSON(packageJsonContent);
+        if (packageJson) {
+          const deps = {
+            ...(packageJson.dependencies || {}),
+            ...(packageJson.devDependencies || {}),
+            ...(packageJson.peerDependencies || {})
+          };
+
+          const sortedFrameworks = Object.entries(FRAMEWORKS).sort((a, b) =>
+            (b[1].priority || 0) - (a[1].priority || 0)
+          );
+
+          for (const [id, framework] of sortedFrameworks) {
+            try {
+              const frameworkDeps = framework.deps || framework.dependencies || [];
+              const hasAnyDep = frameworkDeps.some(dep => dep in deps);
+              if (hasAnyDep) {
+                const mainDep = frameworkDeps[0];
+                const frameworkInfo = {
+                  id, name: framework.name || id, description: framework.description,
+                  confidence: id === 'i18ntk-runtime' ? 0.95 : 0.9,
+                  version: deps[mainDep] || '', priority: framework.priority || 0
+                };
+                detectedFrameworks.push(frameworkInfo);
+              }
+            } catch (_) { /* skip */ }
+          }
+        }
+      }
+    } catch (_) { /* skip */ }
   }
 
-  try {
-    // Read and parse package.json
-    const packageJsonContent = SecurityUtils.safeReadFileSync(packageJsonPath, projectRoot, 'utf8');
-    if (!packageJsonContent) {
-      return null;
-    }
-    const packageJson = SecurityUtils.safeParseJSON(packageJsonContent);
-    if (!packageJson) {
-      return null;
+  // Phase 2: Check Python project files (no package.json or no Node matches)
+  if (detectedFrameworks.length === 0) {
+    const pyProjectFiles = ['requirements.txt', 'setup.py', 'setup.cfg', 'pyproject.toml', 'Pipfile', 'Pipfile.lock'];
+    const hasPyProject = pyProjectFiles.some(f => SecurityUtils.safeExistsSync(path.join(projectRoot, f), projectRoot));
+    if (hasPyProject) {
+      const pyDeps = readPyProjectDeps(projectRoot);
+      const pyFrameworks = ['django', 'flask', 'fastapi', 'python'];
+      for (const id of pyFrameworks) {
+        const framework = FRAMEWORKS[id];
+        if (!framework) continue;
+        const frameworkDeps = framework.deps || [];
+        const hasAnyDep = frameworkDeps.some(dep => pyDeps.includes(dep.toLowerCase().replace(/[_-]/g, '')));
+        if (hasAnyDep) {
+          detectedFrameworks.push({
+            id, name: framework.name || id, description: framework.description,
+            confidence: 0.8, version: '', priority: framework.priority || 0
+          });
+        }
+      }
+      if (detectedFrameworks.length === 0 && hasPyProject) {
+        detectedFrameworks.push({
+          id: 'python', name: 'Python', description: 'Python project with gettext/i18n',
+          confidence: 0.5, version: '', priority: 0
+        });
+      }
     }
+  }
 
-    const deps = {
-      ...(packageJson.dependencies || {}),
-      ...(packageJson.devDependencies || {}),
-      ...(packageJson.peerDependencies || {})
-    };
-
-    // Sort frameworks by priority (highest first)
-    const sortedFrameworks = Object.entries(FRAMEWORKS).sort((a, b) =>
-      (b[1].priority || 0) - (a[1].priority || 0)
-    );
-
-    // Check each framework's dependencies
-    for (const [id, framework] of sortedFrameworks) {
+  // Phase 3: Check Rust project (Cargo.toml)
+  if (detectedFrameworks.length === 0) {
+    const cargoPath = path.join(projectRoot, 'Cargo.toml');
+    if (SecurityUtils.safeExistsSync(cargoPath, projectRoot)) {
       try {
-        const frameworkDeps = framework.deps || framework.dependencies || [];
-        const hasAnyDep = frameworkDeps.some(dep => dep in deps);
-
-        if (hasAnyDep) {
-          const mainDep = frameworkDeps[0];
-          const frameworkInfo = {
-            id,
-            name: framework.name || id,
-            description: framework.description,
-            confidence: 0.9, // Base confidence when dependencies are found
-            version: deps[mainDep] || '',
-            priority: framework.priority || 0
-          };
-
-          // Boost confidence for i18ntk-runtime
-          if (id === 'i18ntk-runtime') {
-            frameworkInfo.confidence = 0.95;
+        const cargoContent = SecurityUtils.safeReadFileSync(cargoPath, projectRoot, 'utf8');
+        if (cargoContent) {
+          const hasRustI18n = /fluent|rust-i18n|gettext/.test(cargoContent);
+          if (hasRustI18n || /^\[package\]/m.test(cargoContent)) {
+            detectedFrameworks.push({
+              id: 'rust', name: 'Rust', description: 'Rust project with i18n',
+              confidence: hasRustI18n ? 0.85 : 0.4, version: '', priority: 0
+            });
           }
-
-          detectedFrameworks.push(frameworkInfo);
         }
-      } catch (error) {
-        console.warn(`Error checking framework ${id}:`, error.message);
-        continue;
-      }
+      } catch (_) { /* skip */ }
     }
+  }
 
-    // Return the framework with highest confidence, if any
-    if (detectedFrameworks.length > 0) {
-      return detectedFrameworks.sort((a, b) => {
-        // First sort by confidence
-        const confidenceDiff = b.confidence - a.confidence;
-        if (confidenceDiff !== 0) return confidenceDiff;
+  // Phase 4: Check Go project (go.mod)
+  if (detectedFrameworks.length === 0) {
+    const goModPath = path.join(projectRoot, 'go.mod');
+    if (SecurityUtils.safeExistsSync(goModPath, projectRoot)) {
+      try {
+        const goModContent = SecurityUtils.safeReadFileSync(goModPath, projectRoot, 'utf8');
+        if (goModContent) {
+          const hasGoI18n = /go-i18n|x-text|i18n/.test(goModContent);
+          detectedFrameworks.push({
+            id: 'go', name: 'Go', description: 'Go project with i18n',
+            confidence: hasGoI18n ? 0.85 : 0.4, version: '', priority: 0
+          });
+        }
+      } catch (_) { /* skip */ }
+    }
+  }
 
-        // If confidence is equal, sort by priority
-        return (b.priority || 0) - (a.priority || 0);
-      })[0];
+  // Phase 5: Check Ruby project (Gemfile)
+  if (detectedFrameworks.length === 0) {
+    const gemfilePaths = ['Gemfile', 'gems.rb'];
+    for (const gf of gemfilePaths) {
+      const gemfilePath = path.join(projectRoot, gf);
+      if (SecurityUtils.safeExistsSync(gemfilePath, projectRoot)) {
+        try {
+          const gemfileContent = SecurityUtils.safeReadFileSync(gemfilePath, projectRoot, 'utf8');
+          if (gemfileContent) {
+            const hasRails = /rails/.test(gemfileContent);
+            const hasI18n = /i18n/.test(gemfileContent);
+            if (hasRails) {
+              detectedFrameworks.push({
+                id: 'ruby-on-rails', name: 'Ruby on Rails', description: 'Rails project with i18n',
+                confidence: hasI18n ? 0.9 : 0.7, version: '', priority: 0
+              });
+              break;
+            }
+            if (hasI18n) {
+              detectedFrameworks.push({
+                id: 'ruby-on-rails', name: 'Ruby on Rails', description: 'Ruby project with i18n',
+                confidence: 0.6, version: '', priority: 0
+              });
+              break;
+            }
+          }
+        } catch (_) { /* skip */ }
+      }
     }
+  }
 
-    return null;
-  } catch (error) {
-    console.error('Error detecting framework:', error);
-    return null;
+  // Return the framework with highest confidence, if any
+  if (detectedFrameworks.length > 0) {
+    return detectedFrameworks.sort((a, b) => {
+      const confidenceDiff = b.confidence - a.confidence;
+      if (confidenceDiff !== 0) return confidenceDiff;
+      return (b.priority || 0) - (a.priority || 0);
+    })[0];
   }
+
+  return null;
+}
+
+function readPyProjectDeps(projectRoot) {
+  const deps = [];
+  try {
+    const reqPath = path.join(projectRoot, 'requirements.txt');
+    if (SecurityUtils.safeExistsSync(reqPath, projectRoot)) {
+      const content = SecurityUtils.safeReadFileSync(reqPath, projectRoot, 'utf8');
+      if (content) {
+        for (const line of content.split('\n')) {
+          const stripped = line.replace(/[<>=!~].*$/, '').trim();
+          if (stripped && !stripped.startsWith('#')) deps.push(stripped.toLowerCase().replace(/[_-]/g, ''));
+        }
+      }
+    }
+  } catch (_) { /* skip */ }
+  return deps;
 }
 
 module.exports = { detectFramework, FRAMEWORKS, FRAMEWORK_COMPATIBILITY,

package/utils/report-model.js

@@ -2,7 +2,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { getSourceExtensions, getExcludeDirs } = require('./framework-detector');
+const { getSourceExtensions, getExcludeDirs, getFrameworkPatterns } = require('./framework-detector');
 const SecurityUtils = require('./security');
 
 const EXCLUDE_DIRS = new Set(getExcludeDirs());
@@ -83,7 +83,8 @@ function generateI18ntkReport(options = {}) {
     Object.keys(values).forEach(key => allKeys.add(key));
   }
 
-  const sourceScan = scanSourceFiles(sourceDir, new Set(Object.keys(sourceValues)));
+  const framework = options.framework || 'vanilla';
+  const sourceScan = scanSourceFiles(sourceDir, new Set(Object.keys(sourceValues)), framework);
   const usedKeys = sourceScan.usedKeys;
   const issues = [];
   const addIssue = issue => issues.push(normalizeIssue(issue, issues.length + 1, projectRoot));
@@ -288,7 +289,7 @@ function flattenObject(value, prefix = '', out = {}) {
   return out;
 }
 
-function scanSourceFiles(sourceDir, availableKeys) {
+function scanSourceFiles(sourceDir, availableKeys, framework) {
   const usedKeys = new Set();
   const usageLocations = new Map();
   const hardcodedTexts = [];
@@ -299,15 +300,25 @@ function scanSourceFiles(sourceDir, availableKeys) {
   for (const file of files) {
     const content = SecurityUtils.safeReadFileSync(file, basePath, 'utf8');
     const lines = content.split(/\r?\n/);
+    const frameworkPatterns = framework ? getFrameworkPatterns(framework) : [];
     const keyPatterns = [
       /\b(?:t|tx|__|_t)\s*\(\s*['"`]([^'"`]+)['"`]/g,
       /\bi18n\.t\s*\(\s*['"`]([^'"`]+)['"`]/g,
       /\bi18nKey\s*=\s*['"`]([^'"`]+)['"`]/g,
+      /\$t\(\s*['"`]([^'"`]+)['"`]/g,
+      /\|\s*translate/g,
+      /\{\{\s*t\s+['"`]([^'"`]+)['"`]/g,
+      /\b(I18n|i18n)\.(t|translate|localize|l)\s*\(\s*['"`]([^'"`]+)['"`]/g,
+      /\{\%\s*trans\s+['"`]([^'"`]+)['"`]\s*%\}/g,
+      /gettext\(['"`]([^'"`]+)['"`]\)/g,
+      /_\(['"`]([^'"`]+)['"`]\)/g,
+      /\$_\(\s*['"`]([^'"`]+)['"`]/g
     ];
-    for (const pattern of keyPatterns) {
+    for (const pattern of [...keyPatterns, ...frameworkPatterns]) {
       let match;
       while ((match = pattern.exec(content))) {
-        const key = match[1];
+        const key = match[1] || match[2];
+        if (!key) continue;
         usedKeys.add(key);
         const location = offsetToLocation(content, match.index);
         const list = usageLocations.get(key) || [];

package/utils/validation-risk.js

@@ -34,24 +34,32 @@ const ENGLISH_WORDS = new Set([
   'warning', 'when', 'with', 'without'
 ]);
 
-const DEFAULT_ALLOWED_ENGLISH_TERMS = new Set([
-  'api',
-]);
+const DEFAULT_ALLOWED_ENGLISH_TERMS = new Set(['api']);
+
+function resolveAllowedEnglishTerms(options, projectConfig) {
+  const terms = new Set(DEFAULT_ALLOWED_ENGLISH_TERMS);
+  const sources = [
+    options && options.allowedEnglishTerms,
+    projectConfig && projectConfig.allowedEnglishTerms
+  ];
+  for (const source of sources) {
+    if (Array.isArray(source)) {
+      source.forEach(term => {
+        if (typeof term === 'string' && term.trim()) {
+          terms.add(term.trim().toLowerCase());
+        }
+      });
+    }
+  }
+  return terms;
+}
 
 function normalizeLanguage(language) {
   return String(language || '').toLowerCase().split(/[-_]/)[0];
 }
 
 function toAllowedTermSet(terms) {
-  const allowed = new Set(DEFAULT_ALLOWED_ENGLISH_TERMS);
-  if (Array.isArray(terms)) {
-    terms.forEach(term => {
-      if (typeof term === 'string' && term.trim()) {
-        allowed.add(term.trim().toLowerCase());
-      }
-    });
-  }
-  return allowed;
+  return resolveAllowedEnglishTerms({ allowedEnglishTerms: terms });
 }
 
 function stripNonLanguageTokens(value) {
@@ -171,5 +179,6 @@ module.exports = {
   DEFAULT_ENGLISH_THRESHOLD_PERCENT,
   analyzeEnglishContent,
   detectTranslationContentRisks,
-  hasSecretLikeValue
+  hasSecretLikeValue,
+  resolveAllowedEnglishTerms
 };