i18ntk Lens
i18ntk Lens adds fast inline translation visibility to VS Code. Hover values, CodeLens coverage hints, missing-key warnings, unused-key diagnostics, key navigation, and workspace settings — all close to your code. Lens is standalone and does not add an Activity Bar icon.
Latest in 1.3.0
- Multi-language document selectors: Python, Go, Rust, Ruby, Java, PHP, Handlebars added to hover, CodeLens, and CodeAction providers
- Expanded file scanning:
.py, .pyx, .pyi, .go, .rb, .java, .php, .hbs scanned for translation keys
- Extended KNOWN_WRAPPERS (9→18): Added
$_, $tc, gettext, gettext_lazy, I18n.t, I18n.translate, I18n.l, I18n.localize
- Extended NAMESPACE_HELPERS (7→10): Added
useTranslate (Qwik), useSpeak (Qwik), withTranslation (react-i18next)
- Attribute key detection:
i18nKey=, t-key=, data-i18n= now detected in source scanning
- Configurable copy formatter detection: accepts custom formatter names array
- Expanded locale auto-discovery:
app/i18n, content/locales, messages, lang, config/locales, assets/i18n, locale
Features
Inline Feedback
- Translation Hovers — hover
t('key') to see values in every configured language
- CodeLens — per-key coverage indicators showing how many target languages have translations
- Missing-Key Diagnostics — keys used in source but absent from target locale files
- Unused-Key Diagnostics — keys in locale files with no source references (advisory)
Key Navigation
i18ntk Lens: Open Key in Locale Files — jump from t('key') usage to the definition in JSON- Built-in scan from settings webview with custom wrapper support
Scanner
- Detects built-in wrappers:
t(), $t(), i18n.t(), useI18n(), useTranslation(), translate(), tx(), $_, $tc, gettext(), gettext_lazy(), I18n.t(), I18n.translate(), I18n.l(), I18n.localize()
- Configurable custom wrappers for project-specific patterns
- Namespace helpers:
useTranslations("scope"), useTranslate(), useSpeak(), withTranslation() expand to scoped key matching
- Imported locale JSON object detection:
import en from './locales/en.json'
- Dynamic template resolution from static values, arrays, and object maps
- Snake-case key format support alongside dot notation
Diagnostics
- Auto-translate residual detection from CLI resume reports
- Client boundary warnings for
'use client' + locale JSON imports
- Quick-fix: add intentionally unchanged keys to Auto Translate protection
Settings
| Setting |
Default |
Description |
i18ntkLens.localeDirectory |
./locales |
Locale files root |
i18ntkLens.sourceLocale |
en |
Source language |
i18ntkLens.maxScanFiles |
1000 |
Max source files per scan |
i18ntkLens.exclude |
[node_modules, dist, …] |
Excluded directories |
i18ntkLens.scanOnStartup |
false |
Auto-scan on activation |
i18ntkLens.autoScanOnSave |
false |
Auto-scan on file save |
i18ntkLens.keyFormats |
["dot", "snake"] |
Key format conventions |
i18ntkLens.customWrappers |
[] |
Additional wrapper function names |
i18ntkLens.extensionLanguage |
follow |
Extension UI language |
Commands
| Command |
Description |
i18ntkLens.scanWorkspace |
Run workspace scan |
i18ntkLens.openSettings |
Open settings webview |
i18ntkLens.openKeyInLocaleFiles |
Navigate from key to locale definition |
Previous Releases
See CHANGELOG.md for full version history.
Install
# VS Code Marketplace
# Search: i18ntk Lens by Vlad Noskov
# Or via CLI
code --install-extension VladNoskov.i18ntk-lens
License
MIT. See LICENSE.
| |
