i18ntk 4.7.0 → 4.7.1

package/CHANGELOG.md

@@ -4,6 +4,31 @@ 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/),
 
+## [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
 
 ### Added

package/README.md

@@ -1,4 +1,4 @@
-# i18ntk v4.7.0
+# i18ntk v4.7.1
 
 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.1)](https://socket.dev/npm/package/i18ntk/overview/4.7.1)
 
 [![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,13 @@ npm install -g i18ntk
 npx i18ntk --help
 ```
 
+## 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 +43,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

@@ -100,7 +100,7 @@ this.translations = {};
      * @returns {string[]} Array of available language codes
      */
     detectAvailableLanguages() {
-        const all = ['en', 'de', 'es', 'fr', 'ru', 'ja', 'zh'];
+        const all = ['en', 'de', 'es', 'fr', 'it', 'pt', 'nl', 'pl', 'sv', 'uk', 'cs', 'tr', 'ru', 'ja', 'ko', 'zh', 'ar', 'hi', 'th', 'vi', 'he', 'el', 'hu'];
         return all.filter(lang => {
             const filePath = path.join(this.uiLocalesDir, `${lang}.json`);
             return SecurityUtils.safeExistsSync(filePath, this.getValidationBase(filePath));

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

@@ -29,9 +29,10 @@ 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');
 
 // Import services to replace circular dependencies
 const ConfigurationService = require('./services/ConfigurationService');
@@ -142,7 +143,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 +202,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 +293,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 +691,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';

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.1",
   "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.1",
     "releaseDate": "07/07/2026",
     "lastUpdated": "07/07/2026",
     "maintainer": "Vlad Noskov",
@@ -197,10 +197,12 @@
       "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."
     ],
     "breakingChanges": [],
-    "nextVersion": "4.7.1",
+    "nextVersion": "4.7.2",
     "supportedNodeVersions": ">=16.0.0",
     "supportedFrameworks": {
       "react-i18next": ">=11.0.0",
@@ -229,18 +231,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.1 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.1 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.1\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.1)](https://socket.dev/npm/package/i18ntk/overview/4.7.1)\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.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' }
         ];
     }
 }