{ "name": "i18ntk", "version": "4.7.3", "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": [ "i18ntk", "i18n", "i18n toolkit", "i18n tool kit", "internationalization", "localization", "translation", "auto-translation", "google-translate", "l10n", "multilingual", "i18next", "react-i18next", "vue-i18n", "angular-i18n", "next-i18next", "nodejs", "javascript", "typescript", "cli", "command-line", "developer-tools", "translation-management", "framework-detection", "zero-dependency", "security", "json" ], "homepage": "https://github.com/vladnoskv/i18ntk#readme", "bugs": { "url": "https://github.com/vladnoskv/i18ntk/issues" }, "repository": { "type": "git", "url": "git+https://github.com/vladnoskv/i18ntk.git" }, "funding": { "type": "individual", "url": "https://www.charitynavigator.org/" }, "license": "MIT", "author": { "name": "Vlad Noskov", "url": "https://github.com/vladnoskv" }, "type": "commonjs", "main": "main/manage/index.js", "types": "runtime/i18ntk.d.ts", "exports": { ".": "./main/manage/index.js", "./runtime": { "types": "./runtime/index.d.ts", "require": "./runtime/index.js", "default": "./runtime/index.js" }, "./runtime/enhanced": { "types": "./runtime/enhanced.d.ts", "require": "./runtime/enhanced.js", "default": "./runtime/enhanced.js" }, "./runtime/*": "./runtime/*", "./report": "./utils/report-model.js", "./ui-locales/*": "./ui-locales/*", "./package.json": "./package.json" }, "bin": { "i18ntk": "main/manage/index.js", "i18ntk-setup": "main/i18ntk-setup.js", "i18ntk-manage": "main/manage/index.js", "i18ntk-init": "main/i18ntk-init.js", "i18ntk-analyze": "main/i18ntk-analyze.js", "i18ntk-validate": "main/i18ntk-validate.js", "i18ntk-usage": "main/i18ntk-usage.js", "i18ntk-complete": "main/i18ntk-complete.js", "i18ntk-sizing": "main/i18ntk-sizing.js", "i18ntk-summary": "main/i18ntk-summary.js", "i18ntk-doctor": "main/i18ntk-doctor.js", "i18ntk-report": "main/i18ntk-report.js", "i18ntk-fixer": "main/i18ntk-fixer.js", "i18ntk-scanner": "main/i18ntk-scanner.js", "i18ntk-backup": "main/i18ntk-backup.js", "i18ntk-translate": "main/i18ntk-translate.js" }, "files": [ "main/i18ntk-analyze.js", "main/i18ntk-backup-class.js", "main/i18ntk-backup.js", "main/i18ntk-translate.js", "main/i18ntk-complete.js", "main/i18ntk-doctor.js", "main/i18ntk-fixer.js", "main/i18ntk-init.js", "main/i18ntk-scanner.js", "main/i18ntk-setup.js", "main/i18ntk-report.js", "main/i18ntk-sizing.js", "main/i18ntk-summary.js", "main/i18ntk-ui.js", "main/i18ntk-usage.js", "main/i18ntk-validate.js", "main/i18ntk-go.js", "main/i18ntk-java.js", "main/i18ntk-js.js", "main/i18ntk-php.js", "main/i18ntk-py.js", "main/manage/", "runtime/", "settings/language-config.json", "settings/settings-cli.js", "settings/settings-manager.js", "ui-locales/", "utils/admin-auth.js", "utils/admin-cli.js", "utils/cli-helper.js", "utils/cli.js", "utils/colors-new.js", "utils/config-helper.js", "utils/config-manager.js", "utils/config.js", "utils/env-manager.js", "utils/exit-codes.js", "utils/extractor-manager.js", "utils/extractors/regex.js", "utils/english-placeholder-checker.js", "utils/format-manager.js", "utils/formats/json.js", "utils/translate/placeholder.js", "utils/translate/api.js", "utils/translate/safe-network.js", "utils/translate/traverse.js", "utils/translate/report.js", "utils/translate/cli.js", "utils/translate/protection.js", "utils/framework-detector.js", "utils/i18n-helper.js", "utils/init-helper.js", "utils/json-output.js", "utils/localized-confirm.js", "utils/mini-commander.js", "utils/locale-optimizer.js", "utils/language-menu.js", "utils/logger.js", "utils/menu-layout.js", "utils/npm-version-warning.js", "utils/plugin-loader.js", "utils/prompt-helper.js", "utils/prompt.js", "utils/promptPin.js", "utils/report-writer.js", "utils/report-model.js", "utils/secure-errors.js", "utils/security.js", "utils/setup-enforcer.js", "utils/terminal-icons.js", "utils/usage-source.js", "utils/usage-insights.js", "utils/validation-risk.js", "utils/version-utils.js", "utils/watch-locales.js", "LICENSE", "README.md", "CHANGELOG.md", "CODE_OF_CONDUCT.md", "CONTRIBUTING.md", "FUNDING.md", "SECURITY.md" ], "sideEffects": false, "engines": { "node": ">=16.0.0", "npm": ">=8.0.0" }, "publishConfig": { "access": "public" }, "preferGlobal": true, "versionInfo": { "version": "4.7.3", "releaseDate": "07/07/2026", "lastUpdated": "07/07/2026", "maintainer": "Vlad Noskov", "changelog": "./CHANGELOG.md", "documentation": "./README.md", "apiReference": "./docs/api/API_REFERENCE.md", "majorChanges": [ "BUG FIX: LANGUAGE_CONFIG expanded from 21 to 61 languages with comprehensive ISO 639-1 coverage. All common languages now display their native names in init output instead of 'Unknown'.", "BUG FIX: defaultLanguages no longer silently truncates to 5 when the config value is an empty array or null. A validation guard preserves the caller's configured list.", "BUG FIX: Auto Translate now exits 0 on success even when residual untranslated values exist (placeholders, branded terms, short labels). Only real failures (0 translated with >0 total) now produce non-zero exit codes.", "BUG FIX: supportedExtensions is no longer unconditionally overridden by the format adapter during init. Users who configure extensions in .i18ntk-config keep them.", "BUG FIX: allowedEnglishTerms now unifies between validation-risk.js and project config. resolveAllowedEnglishTerms() accepts both inline options and project-level .i18ntk-config terms as fallback sources.", "FRAMEWORK DETECTION: Added 10 new framework detections — Rust, Remix, Gatsby, Astro, Qwik, SolidJS, Ember, React Native, Expo, Ionic. Centralized into framework-detector.js as single source of truth.", "FILE EXTENSIONS: Added .astro, .mdx, .mjs, .mts, .cjs, .cts, .rs to all file scan lists via centralized SOURCE_EXTENSIONS and SCANNER_EXTENSIONS.", "ICU/FLUENT PLACEHOLDER SUPPORT: Fluent $variable and ICU MessageFormat patterns added to placeholder detection and comparison.", "JSX COMPONENT DETECTION: , , 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.", "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.4", "supportedNodeVersions": ">=16.0.0", "supportedFrameworks": { "react-i18next": ">=11.0.0", "vue-i18n": ">=9.0.0", "angular-i18n": ">=12.0.0", "next-i18next": ">=13.0.0", "next-intl": ">=3.0.0", "nuxt-i18n": ">=8.0.0", "svelte-i18n": ">=3.0.0", "sveltekit-i18n": ">=2.0.0", "astro-i18next": ">=0.1.0", "remix-i18next": ">=14.0.0", "gatsby-plugin-react-i18next": ">=5.0.0", "qwik-speak": ">=0.11.0", "react-native-localize": ">=2.0.0", "expo-localization": ">=14.0.0", "ionic-angular": ">=6.0.0", "ember-intl": ">=5.0.0", "formatjs": ">=2.0.0", "i18next": ">=21.0.0", "django": ">=3.0.0", "flask-babel": ">=2.0.0", "fastapi": ">=0.70.0", "spring-boot": ">=2.5.0", "laravel": ">=8.0.0", "fluent-rs": ">=0.16.0", "gettext-rs": ">=0.7.0" }, "supportPolicy": "Versions earlier than 4.7.3 may be unstable or insecure in CI automation. Upgrade to 4.7.3 or newer.", "deprecations": [ "4.3.0", "4.3.1", "4.3.2", "4.3.3", "4.7.2" ], "deprecationMessage": "i18ntk 4.3.x and earlier have known security vulnerabilities (path traversal, JSON DoS). i18ntk 4.7.2 has a missing-module bug. Upgrade to i18ntk@4.7.3 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.3\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.3)](https://socket.dev/npm/package/i18ntk/overview/4.7.3)\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.3\n\n- **Publish integrity fix** — `language-menu.js` and `promptPin.js` now included in npm package. Fixes `MODULE_NOT_FOUND` crash on install. **4.7.2 is deprecated.**\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=` or standalone `i18ntk-`.\n\n## Common Options\n\n```\n--code-dir Source code directory\n--locales-dir Locale files directory\n--output-dir Report output directory\n--source-locale Source language code (e.g. en)\n--framework 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" }