i18ntk 4.7.0 → 4.7.2

package/CHANGELOG.md

@@ -2,7 +2,40 @@
 
 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/),
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+
+## [4.7.2] - 2026-07-07
+
+### Fixed
+
+- **Dynamic CLI language selector** — Option 12 now derives available languages and native display names from `SettingsManager.getAvailableLanguages()` instead of stale hardcoded 7-language lists.
+- **Future-proof prompt range** — Language selection prompts now render the numeric upper bound from the current available language count, so future UI locale expansion does not leave stale `0-8` prompt text behind.
+- **Fallback manager parity** — `main/manage/index.js` now instantiates `SettingsManager`, shows the real current UI language, persists `language` and `uiLanguage`, and uses the same 23-language registry as the rest of the CLI.
+
+## [4.7.1] - 2026-07-07
+
+### Added
+
+- **23 UI locale languages** — Expanded from 7 to 23: Italian, Portuguese, Dutch, Polish, Swedish, Ukrainian, Czech, Turkish, Korean, Arabic, Hindi, Thai, Vietnamese, Hebrew, Greek, Hungarian. All 2,211 keys auto-translated with placeholder preservation via i18ntk's own pipeline. 95-98% translation completeness, 0 missing keys.
+- **Native language names** — `settings.languages.{code}` entries added to all 23 locale files with names in native script (Italiano, 日本語, العربية, हिन्दी, etc.). `getAvailableLanguages()` returns all 23 with display names.
+- **Settings schema expanded** — `language` and `uiLanguage` enum constraints expanded from 7 to 23 entries. Language selector in settings UI and CLI picks up all available languages.
+
+### Changed
+
+- **Framework detection centralized** — `manage/index.js` `detectEnvironmentAndFramework()` now calls `detectProjectFramework()` from the centralized detector instead of a 6-framework inline check. Detects all 30+ supported frameworks.
+- **Hardcoded `framework.supported` removed** — Config templates (`config-manager.js`) and runtime config (`.i18ntk-config`) no longer ship a static framework list. Only actually-detected frameworks appear.
+- **`checkI18nDependencies()` expanded** — Framework package lists unified across `manage/index.js`, `i18ntk-manage.js`, `InitService.js`, and `FrameworkDetectionService.js` (8→29 entries each).
+- **Hardcoded 7-language lists expanded to 23** — Updated in 12 production files: `i18n-usage.js`, `i18n-validate.js`, `ValidateCommand.js`, `UsageService.js`, `FrameworkDetectionService.js`, `ConfigurationService.js`, `i18ntk-manage.js`, `locale-optimizer.js` ×2, `env-manager.js`, `i18ntk-ui.js`, `manage/index.js`.
+- **Default config template expanded** — `config-helper.js` `supportedLanguages` and template skeleton files expanded from 8 to 23 languages.
+- **Missing key validator** — Default constructor argument expanded from 7 to 23 languages.
+- **Version bumped to 4.7.1** for language expansion and framework detection cleanup.
+
+### Verified
+
+- Language switching tested via `i18n-helper.loadTranslations()` across all 23 locales — all return non-English values.
+- 69 core tests pass, 98 sandbox tests pass.
+- Package JSON manifest sync test passes (version, versionInfo, nextVersion aligned).
+- All 23 locale files have valid JSON syntax.
 
 ## [4.7.0] - 2026-07-07
 

package/README.md

@@ -1,4 +1,4 @@
-# i18ntk v4.7.0
+# i18ntk v4.7.2
 
 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.7.0)](https://socket.dev/npm/package/i18ntk/overview/4.7.0)
+[![socket](https://socket.dev/api/badge/npm/package/i18ntk/4.7.2)](https://socket.dev/npm/package/i18ntk/overview/4.7.2)
 
 [![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,6 +27,18 @@ npm install -g i18ntk
 npx i18ntk --help
 ```
 
+## What's New in 4.7.2
+
+- **Dynamic Language Selector** — The interactive "Change UI Language" menu now derives its options and display names from the package language registry, including the fallback `manage/index.js` entrypoint.
+- **Future-Proof Prompt Range** — The language selection prompt now renders `0-N` from the installed UI locale count instead of using a stale translated `0-8` range, so future locale expansion updates automatically.
+
+## What's New in 4.7.1
+
+- **23 UI Languages** — Expanded from 7 to 23: Italian, Portuguese, Dutch, Polish, Swedish, Ukrainian, Czech, Turkish, Korean, Arabic, Hindi, Thai, Vietnamese, Hebrew, Greek, Hungarian. All 2,211 keys auto-translated and verified.
+- **Framework Detection Cleanup** — Removed hardcoded `framework.supported` lists from config templates. `manage/index.js` now uses centralized `detectProjectFramework()` covering all 30+ frameworks. Only detected frameworks appear in setup — no more static catalog.
+- **Language Selector** — Settings UI, `getAvailableLanguages()`, and schema enums all expanded from 7 to 23 languages with native names.
+- **12 Production Files Updated** — Hardcoded 7-language arrays expanded to 23: validators, locale optimizers, env manager, usage tracking, UI, and config helpers.
+
 ## What's New in 4.7.0
 
 - **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.
@@ -36,8 +48,7 @@ npx i18ntk --help
 - **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)
+  [Full changelog →](./CHANGELOG.md)
 
 ## Quick Start
 

package/main/i18ntk-ui.js

@@ -5,11 +5,25 @@
 
 const fs = require('fs');
 const path = require('path');
-const SettingsManager = require('../settings/settings-manager');
-const SecurityUtils = require('../utils/security');
-const legacyConfigManager = require('../utils/config-manager');
-const { getIcon, isUnicodeSupported } = require('../utils/terminal-icons');
-const configManager = new SettingsManager();
+const SettingsManager = require('../settings/settings-manager');
+const SecurityUtils = require('../utils/security');
+const legacyConfigManager = require('../utils/config-manager');
+const { getIcon, isUnicodeSupported } = require('../utils/terminal-icons');
+const { formatLanguagePrompt } = require('../utils/language-menu');
+const configManager = new SettingsManager();
+
+function getSupportedUiLanguages() {
+    return configManager.getAvailableLanguages();
+}
+
+function getSupportedUiLanguageCodes() {
+    return getSupportedUiLanguages().map(language => language.code);
+}
+
+function getSupportedUiLanguageName(langCode) {
+    const language = getSupportedUiLanguages().find(item => item.code === langCode);
+    return language ? language.name : langCode;
+}
 
 class UIi18n {
     constructor() {
@@ -99,12 +113,12 @@ this.translations = {};
      * Detect which UI locales are currently installed
      * @returns {string[]} Array of available language codes
      */
-    detectAvailableLanguages() {
-        const all = ['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'];
-        return all.filter(lang => {
-            const filePath = path.join(this.uiLocalesDir, `${lang}.json`);
-            return SecurityUtils.safeExistsSync(filePath, this.getValidationBase(filePath));
-        });
+    detectAvailableLanguages() {
+        const all = getSupportedUiLanguageCodes();
+        return all.filter(lang => {
+            const filePath = path.join(this.uiLocalesDir, `${lang}.json`);
+            return SecurityUtils.safeExistsSync(filePath, this.getValidationBase(filePath));
+        });
     }
 
     /**
@@ -481,27 +495,17 @@ this.translations = {};
      * @param {string} langCode - Language code
      * @returns {string} Display name of the language
      */
-    getLanguageDisplayName(langCode) {
-        const displayNames = {
-            'en': 'English',
-            'de': 'Deutsch (German)',
-            'es': 'Español (Spanish)',
-            'fr': 'Français (French)',
-            'ru': 'Русский (Russian)',
-            'ja': '日本語 (Japanese)',
-            'zh': '中文 (Chinese)'
-         };
-
-        // Hardcoded texts that are not part of the i18n system but need to be displayed
-        this.hardcodedTexts = {
-            autoDetectedI18nDirectory: this.t('ui.autoDetectedI18nDirectory'),
+    getLanguageDisplayName(langCode) {
+        // Hardcoded texts that are not part of the i18n system but need to be displayed
+        this.hardcodedTexts = {
+            autoDetectedI18nDirectory: this.t('ui.autoDetectedI18nDirectory'),
             executingCommand: this.t('ui.executingCommand'),
             unknownCommand: this.t('ui.unknownCommand'),
             errorExecutingCommand: this.t('ui.errorExecutingCommand')
-        
-        };
-        return displayNames[langCode] || langCode;
-    }
+
+        };
+        return getSupportedUiLanguageName(langCode);
+    }
 
     /**
      * Interactive language selection menu
@@ -528,7 +532,8 @@ this.translations = {};
                console.log(this.t('language.languageOption', { index: index + 1, displayName, current }));
             });
             
-            rl.question('\n' + this.t('language.prompt'), async (answer) => {
+            const languagePrompt = formatLanguagePrompt(this.t('language.prompt'), this.availableLanguages.length);
+            rl.question('\n' + languagePrompt, async (answer) => {
                 const choice = parseInt(answer);
 
                 if (choice === 0) {

package/main/i18ntk-usage.js

@@ -1208,7 +1208,7 @@ Analysis Features (v1.10.1):
           });
         
         for (const lang of allLanguageDirs) {
-          if (['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(lang)) {
+          if (['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(lang)) {
             languages.add(lang);
           }
         }
@@ -1217,7 +1217,7 @@ Analysis Features (v1.10.1):
         const directFiles = fs.readdirSync(this.i18nDir)
           .filter(file => file.endsWith('.json'))
           .map(file => path.basename(file, '.json'))
-          .filter(lang => ['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(lang));
+          .filter(lang => ['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(lang));
         
         directFiles.forEach(lang => languages.add(lang));
       } catch (error) {

package/main/i18ntk-validate.js

@@ -186,7 +186,7 @@ class I18nValidator {
           baseArgs.enforceKeyStyle = val === undefined ? true : val !== 'false';
         } else if (sanitizedArg.startsWith('--') && !sanitizedArg.includes('=')) {
           const key = sanitizedArg.substring(2);
-          if (['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(key)) {
+          if (['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(key)) {
             baseArgs.uiLanguage = key;
           }
         }

package/main/manage/commands/ValidateCommand.js

@@ -163,7 +163,7 @@ class ValidateCommand {
                 const sanitizedArg = SecurityUtils.sanitizeInput(arg);
                 if (sanitizedArg.startsWith('--') && !sanitizedArg.includes('=')) {
                     const key = sanitizedArg.substring(2);
-                    if (['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(key)) {
+                    if (['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(key)) {
                         baseArgs.uiLanguage = key;
                     }
                 }

package/main/manage/index.js

@@ -17,21 +17,25 @@ const path = require('path');
 const fs = require('fs');
 const AdminAuth = require('../../utils/admin-auth');
 const SecurityUtils = require('../../utils/security');
-const configManager = require('../../settings/settings-manager');
+const SettingsManager = require('../../settings/settings-manager');
 const { validateSourceDir } = require('../../utils/config-helper');
 const { checkInitialized } = require('../../utils/init-helper');
 const { showFrameworkWarningOnce } = require('../../utils/cli-helper');
 const { createPrompt, isInteractive } = require('../../utils/prompt-helper');
 const { loadTranslations, t, refreshLanguageFromSettings} = require('../../utils/i18n-helper');
+const { formatLanguagePrompt } = require('../../utils/language-menu');
 const cliHelper = require('../../utils/cli-helper');
 const { printUpgradeWarningIfOutdated } = require('../../utils/npm-version-warning');
 const { blue } = require('../../utils/colors-new');
 const { loadConfig, saveConfig, ensureConfigDefaults } = require('../../utils/config');
 const { buildMainMenuLines } = require('../../utils/menu-layout');
 const SettingsCLI = require('../../settings/settings-cli');
-const pkg = require('../../package.json');
+const pkg = require('../../package.json');
 const SetupEnforcer = require('../../utils/setup-enforcer');
 const CommandRouter = require('./commands/CommandRouter');
+const { detectProjectFramework } = require('../../utils/framework-detector');
+
+const configManager = new SettingsManager();
 
 // Import services to replace circular dependencies
 const ConfigurationService = require('./services/ConfigurationService');
@@ -142,7 +146,7 @@ class I18nManager {
                     const hasLanguageDirs = items.some(item => {
                         const itemPath = path.join(resolvedPath, item);
                         return fs.statSync(itemPath).isDirectory() &&
-                               ['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(item);
+                               ['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(item);
                     });
 
                     if (hasLanguageDirs) {
@@ -201,15 +205,15 @@ class I18nManager {
             };
 
             const i18nFrameworks = [
-                'react-i18next',
-                'vue-i18n',
-                'angular-i18n',
-                'i18next',
-                'next-i18next',
-                'svelte-i18n',
-                '@nuxtjs/i18n',
-                'i18ntk-runtime',
-                'i18ntk'
+                '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', 'i18ntk'
             ];
 
             const installedFrameworks = i18nFrameworks.filter(framework => dependencies[framework]);
@@ -292,7 +296,7 @@ class I18nManager {
                         break;
                     default:
                         // Handle language shorthand flags like --de, --fr
-                        if (['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(sanitizedKey)) {
+                        if (['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(sanitizedKey)) {
                             parsed.uiLanguage = sanitizedKey;
                         }
                         break;
@@ -690,15 +694,10 @@ class I18nManager {
                     detectedFramework = 'i18ntk-runtime';
                 }
 
-                // Only check other frameworks if i18ntk-runtime wasn't detected
+                // Use centralized framework detector
                 if (detectedFramework !== 'i18ntk-runtime') {
-                    if (deps.react || deps['react-dom']) detectedFramework = 'react';
-                    else if (deps.vue || deps['vue-router']) detectedFramework = 'vue';
-                    else if (deps['@angular/core']) detectedFramework = 'angular';
-                    else if (deps.next) detectedFramework = 'nextjs';
-                    else if (deps.nuxt) detectedFramework = 'nuxt';
-                    else if (deps.svelte) detectedFramework = 'svelte';
-                    else detectedFramework = 'generic';
+                    const centralDetected = detectProjectFramework(process.cwd());
+                    detectedFramework = (centralDetected && centralDetected !== 'vanilla') ? centralDetected : 'generic';
                 }
             } catch (error) {
                 detectedFramework = 'generic';
@@ -1008,40 +1007,46 @@ class I18nManager {
 
     // ... existing code for showLanguageMenu, showDebugMenu, deleteReports, showSettingsMenu, etc. ...
 
-    async showLanguageMenu() {
-        console.log(`\n${t('language.title')}`);
-        console.log(t('language.separator'));
-        console.log(t('language.current', { language: 'English' })); // Simplified since we don't have UIi18n
-        console.log('\n' + t('language.available'));
-
-        const languages = [
-            { code: 'en', name: 'English' },
-            { code: 'de', name: 'Deutsch' },
-            { code: 'es', name: 'Español' },
-            { code: 'fr', name: 'Français' },
-            { code: 'ru', name: 'Русский' },
-            { code: 'ja', name: '日本語' },
-            { code: 'zh', name: '中文' }
-        ];
-
-        languages.forEach((lang, index) => {
-            const current = 'en' === 'en' ? ' ✓' : '';
-            console.log(t('language.languageOption', { index: index + 1, displayName: lang.name, current }));
-        });
+    async showLanguageMenu() {
+        const settings = configManager.loadSettings ? configManager.loadSettings() : (configManager.getConfig ? configManager.getConfig() : {});
+        const currentLanguage = settings.uiLanguage || settings.language || this.config.uiLanguage || this.config.language || 'en';
+        const languages = configManager.getAvailableLanguages ? configManager.getAvailableLanguages() : [
+            { code: 'en', name: 'English' }
+        ];
+        const currentLanguageName = languages.find(lang => lang.code === currentLanguage)?.name || currentLanguage;
+
+        console.log(`\n${t('language.title')}`);
+        console.log(t('language.separator'));
+        console.log(t('language.current', { language: currentLanguageName }));
+        console.log('\n' + t('language.available'));
+
+        languages.forEach((lang, index) => {
+            const current = lang.code === currentLanguage ? ' ✓' : '';
+            console.log(t('language.languageOption', { index: index + 1, displayName: lang.name, current }));
+        });
 
         console.log(`0. ${t('language.backToMainMenu')}`);
 
-        const choice = await this.prompt('\n' + t('language.prompt'));
+        const languagePrompt = formatLanguagePrompt(t('language.prompt'), languages.length);
+        const choice = await this.prompt('\n' + languagePrompt);
         const choiceNum = parseInt(choice);
 
         if (choiceNum === 0) {
             await this.showInteractiveMenu();
             return;
-        } else if (choiceNum >= 1 && choiceNum <= languages.length) {
-            const selectedLang = languages[choiceNum - 1];
-            console.log(t('language.changed', { language: selectedLang.name }));
-
-            // Force reload translations for the entire system
+        } else if (choiceNum >= 1 && choiceNum <= languages.length) {
+            const selectedLang = languages[choiceNum - 1];
+            settings.language = selectedLang.code;
+            settings.uiLanguage = selectedLang.code;
+            if (configManager.saveSettings) {
+                await configManager.saveSettings(settings);
+            } else if (configManager.saveConfig) {
+                await configManager.saveConfig(settings);
+            }
+
+            console.log(t('language.changed', { language: selectedLang.name }));
+
+            // Force reload translations for the entire system
             loadTranslations(selectedLang.code);
 
             // Return to main menu with new language

package/main/manage/managers/LanguageMenu.js

@@ -6,6 +6,7 @@
 const { t } = require('../../../utils/i18n-helper');
 const { loadTranslations } = require('../../../utils/i18n-helper');
 const SecurityUtils = require('../../../utils/security');
+const { formatLanguagePrompt } = require('../../../utils/language-menu');
 
 module.exports = class LanguageMenu {
   constructor(manager) {
@@ -30,7 +31,8 @@ module.exports = class LanguageMenu {
 
     console.log(`0. ${t('language.backToMainMenu')}`);
 
-    const choice = await this.manager.prompt('\n' + t('language.prompt'));
+    const languagePrompt = formatLanguagePrompt(t('language.prompt'), this.ui.availableLanguages.length);
+    const choice = await this.manager.prompt('\n' + languagePrompt);
     const choiceNum = parseInt(choice);
 
     if (choiceNum === 0) {

package/main/manage/services/ConfigurationService.js

@@ -311,7 +311,7 @@ module.exports = class ConfigurationService {
             break;
           default:
             // Handle language shorthand flags like --de, --fr
-            if (['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(sanitizedKey)) {
+            if (['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(sanitizedKey)) {
               parsed.uiLanguage = sanitizedKey;
             }
             break;

package/main/manage/services/FrameworkDetectionService.js

@@ -330,7 +330,7 @@ module.exports = class FrameworkDetectionService {
           const hasLanguageDirs = items.some(item => {
             const itemPath = path.join(resolvedPath, item);
             return fs.statSync(itemPath).isDirectory() &&
-                   ['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(item);
+                   ['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(item);
           });
 
           if (hasLanguageDirs) {

package/main/manage/services/UsageService.js

@@ -674,7 +674,7 @@ class UsageService {
           });
 
         for (const lang of allLanguageDirs) {
-          if (['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(lang)) {
+          if (['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(lang)) {
             languages.add(lang);
           }
         }
@@ -683,7 +683,7 @@ class UsageService {
         const directFiles = fs.readdirSync(this.i18nDir)
           .filter(file => file.endsWith('.json'))
           .map(file => path.basename(file, '.json'))
-          .filter(lang => ['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'].includes(lang));
+          .filter(lang => ['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'].includes(lang));
 
         directFiles.forEach(lang => languages.add(lang));
       } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18ntk",
-  "version": "4.7.0",
+  "version": "4.7.2",
   "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,7 +179,7 @@
   },
   "preferGlobal": true,
   "versionInfo": {
-    "version": "4.7.0",
+    "version": "4.7.2",
     "releaseDate": "07/07/2026",
     "lastUpdated": "07/07/2026",
     "maintainer": "Vlad Noskov",
@@ -197,10 +197,14 @@
       "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."
+      "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.",
+      "UI LOCALE EXPANSION: Expanded from 7 to 23 languages (Italian, Portuguese, Dutch, Polish, Swedish, Ukrainian, Czech, Turkish, Korean, Arabic, Hindi, Thai, Vietnamese, Hebrew, Greek, Hungarian). All 2,211 keys auto-translated with placeholder preservation. Native language names in all locale files. getAvailableLanguages(), settings schema enums, and UI language picker expanded to 23. 95-98% translated per language, 0 missing keys.",
+      "FRAMEWORK DETECTION CLEANUP: manage/index.js now uses centralized detectProjectFramework() instead of 6-framework inline check. Removed hardcoded framework.supported from config templates — only detected frameworks appear. checkI18nDependencies() unified across 4 modules (8→29 entries). 12 production files updated — hardcoded 7-language arrays expanded to 23.",
+      "PATCH: CLI language selector now derives display names and options from SettingsManager.getAvailableLanguages(), including the fallback manage/index.js entrypoint.",
+      "PATCH: Language selection prompts now render their numeric range dynamically from the installed UI locale count, preventing stale bounds during future locale expansion."
     ],
     "breakingChanges": [],
-    "nextVersion": "4.7.1",
+    "nextVersion": "4.7.3",
     "supportedNodeVersions": ">=16.0.0",
     "supportedFrameworks": {
       "react-i18next": ">=11.0.0",
@@ -229,18 +233,18 @@
       "fluent-rs": ">=0.16.0",
       "gettext-rs": ">=0.7.0"
     },
-    "supportPolicy": "Versions earlier than 4.7.0 may be unstable or insecure in CI automation. Upgrade to 4.7.0 or newer.",
+    "supportPolicy": "Versions earlier than 4.7.0 may be unstable or insecure in CI automation. Upgrade to 4.7.2 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.7.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.2 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.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"
+  "readme": "# i18ntk v4.7.2\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.2)](https://socket.dev/npm/package/i18ntk/overview/4.7.2)\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.2\n\n- **Dynamic Language Selector** — The interactive \"Change UI Language\" menu now derives its options and display names from the package language registry, including the fallback `manage/index.js` entrypoint.\n- **Future-Proof Prompt Range** — The language selection prompt now renders `0-N` from the installed UI locale count instead of using a stale translated `0-8` range, so future locale expansion updates automatically.\n\n## What's New in 4.7.1\n\n- **23 UI Languages** — Expanded from 7 to 23: Italian, Portuguese, Dutch, Polish, Swedish, Ukrainian, Czech, Turkish, Korean, Arabic, Hindi, Thai, Vietnamese, Hebrew, Greek, Hungarian. All 2,211 keys auto-translated and verified.\n- **Framework Detection Cleanup** — Removed hardcoded `framework.supported` lists from config templates. `manage/index.js` now uses centralized `detectProjectFramework()` covering all 30+ frameworks. Only detected frameworks appear in setup — no more static catalog.\n- **Language Selector** — Settings UI, `getAvailableLanguages()`, and schema enums all expanded from 7 to 23 languages with native names.\n- **12 Production Files Updated** — Hardcoded 7-language arrays expanded to 23: validators, locale optimizers, env manager, usage tracking, UI, and config helpers.\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  [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/settings/settings-manager.js

@@ -780,13 +780,13 @@ class SettingsManager {
                 language: {
                     type: 'string',
                     description: 'Default language for translations',
-                    enum: ['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'],
+                    enum: ['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'],
                     default: 'en'
                 },
                 uiLanguage: {
                     type: 'string',
                     description: 'UI language for toolkit interface',
-                    enum: ['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'],
+                    enum: ['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'],
                     default: 'en'
                 },
                 theme: {
@@ -1129,9 +1129,25 @@ class SettingsManager {
             { code: 'de', name: 'Deutsch' },
             { code: 'es', name: 'Español' },
             { code: 'fr', name: 'Français' },
+            { code: 'it', name: 'Italiano' },
+            { code: 'pt', name: 'Português' },
+            { code: 'nl', name: 'Nederlands' },
+            { code: 'pl', name: 'Polski' },
+            { code: 'sv', name: 'Svenska' },
+            { code: 'uk', name: 'Українська' },
+            { code: 'cs', name: 'Čeština' },
+            { code: 'tr', name: 'Türkçe' },
             { code: 'ru', name: 'Русский' },
             { code: 'ja', name: '日本語' },
-            { code: 'zh', name: '中文' }
+            { code: 'ko', name: '한국어' },
+            { code: 'zh', name: '中文' },
+            { code: 'ar', name: 'العربية' },
+            { code: 'hi', name: 'हिन्दी' },
+            { code: 'th', name: 'ไทย' },
+            { code: 'vi', name: 'Tiếng Việt' },
+            { code: 'he', name: 'עברית' },
+            { code: 'el', name: 'Ελληνικά' },
+            { code: 'hu', name: 'Magyar' }
         ];
     }
 }