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.

It is a lightweight companion to the zero-dependency i18ntk npm package. Lens is standalone and does not add an Activity Bar container, so if i18ntk Workbench is installed too, Workbench remains the single i18ntk sidebar while Lens keeps the editor feedback close to your code.

Latest in 1.0.3

• Source scanning no longer treats arbitrary function calls or methods like get("next"), headers.get("etag"), or clearWaitlist("admin.panel") as translation keys.
• Explicit translation wrappers, configured custom wrappers, namespace helpers, dynamic templates, and imported locale-object reads remain supported.
• Unused-key diagnostics are advisory; verify usages before deleting locale keys.

Latest in 1.0.2

• Dynamic template keys can now resolve exact static runtime candidates from string constants, string arrays, and iterator callbacks.
• Scoped runtime helpers such as useTranslations("news.page") and imported locale JSON objects such as common.save reduce missing/unused false positives.
• Dot and snake key formats can be enabled together in settings.

i18ntk CLI Companion

The main i18ntk npm package powers the broader workflow:

• setup, scan, analyze, validate, usage, sizing, completion, summary, backup, fixer, and Auto Translate commands
• zero runtime dependencies
• Node.js >=16.0.0
• local-first operation, with provider network calls only when you run Auto Translate
• public npm stats and package health through the badges above

Install

Install i18ntk Lens from the VS Code Marketplace.

For the full command-line workflow, install the CLI in your project:

npm install i18ntk

Requirements:

• VS Code ^1.90.0
• Node.js >=18.0.0
• JSON locale files in a supported layout

Quick Start

1. Open a project with locale files, for example locales/en/common.json and locales/fr/common.json.
2. Lens auto-scans when the extension activates.
3. Hover over a detected translation key to see values across locales.
4. Use CodeLens or i18ntk Lens: Open Key in Locale Files to jump to locale files.
5. Use i18ntk Lens: Open Settings to configure locale discovery, source locale, scan limits, exclusions, and custom wrappers.

What You Get

• Hover translations: shows values for t("key"), i18n.t("key"), translate("key"), $t("key"), configured custom wrappers, scoped runtime helpers, and imported locale JSON objects.
• CodeLens indicators: shows whether target locales are missing for each detected key.
• Missing key diagnostics: warns in source files when a used key has no value in one or more locales.
• Unused key diagnostics: marks source-locale keys that appear unused.
• Open key across files: jumps from a source key to matching locale files.
• Settings webview: manages locale directory, source locale, scan limits, exclusions, and custom wrappers.
• Inline-only UI: no duplicate i18ntk Activity Bar icon when Workbench is installed.
• Local-first behavior: reads workspace files locally and sends no telemetry.

Command Reference

Settings

Supported Layouts

Lens auto-detects:

• locales/
• i18n/
• translations/
• public/locales/
• src/locales/

Directory-per-locale:

locales/en/common.json
locales/fr/common.json

Flat files:

locales/en.json
locales/fr.json

Nested JSON keys are flattened to dot notation. For example, checkout.payment.title maps to deeply nested JSON.

CLI Companion

Lens focuses on inline editor feedback. For setup, analysis, validation, usage reports, completion, summary output, and Auto Translate from the terminal, install the CLI:

npm install i18ntk

Common CLI commands:

npx i18ntk --help
npx i18ntk --command=analyze
npx i18ntk --command=validate
npx i18ntk --command=usage
npx i18ntk --command=summary
npx i18ntk-translate locales/en/common.json fr --report-stdout

Use i18ntk Workbench when you want the VS Code sidebar, reports, key management, setup flow, and CLI-backed Auto Translate from inside the editor.

Workbench and Lens

• Install i18ntk Lens when you want fast inline hovers, CodeLens, warnings, and settings.
• Install i18ntk Workbench when you want the sidebar, reports, key management, setup flow, and Auto Translate entry points.
• Install both when you want the full sidebar plus inline editor feedback. Workbench owns the Activity Bar icon; Lens stays inline-only so the sidebar remains clean.

Related Tools

Privacy

i18ntk Lens reads workspace files locally. No data is sent anywhere, and no telemetry is collected.

License

MIT. See LICENSE.