Appearance
VSCode Extension
The typekit-i18n VSCode extension improves authoring workflows for translation keys and raw translation files (.yaml, .yml, .csv).
Availability
- Marketplace listing: https://marketplace.visualstudio.com/items?itemName=number10.typekit-i18n-vscode
- Local package path in this repository:
packages/typekit-i18n-vscode
Core Features
- Key intelligence:
- Go to definition (
F12) fromt("...")/icu("...") - Find references (
Shift+F12) across code and translation files - Rename symbol (
F2) across code and translation files
- Go to definition (
- Diagnostics + quick fixes:
- Unknown key usage in code
- Missing locale values
- Duplicate key definitions
- Placeholder mismatch across locales
- CSV/YAML schema issues and value type validation
- ICU plural/selectordinal
otherbranch checks
- Completion + hover:
- Key completion with translation preview details
- Hover preview for configured locales
- Placeholder snippet insertion for parameterized keys
- Utility:
- Manual diagnostics refresh command
- Index refresh performance baseline command
Install from VSIX (Local)
Build extension package:
bash
pnpm --filter typekit-i18n-vscode package:vsixInstall in VSCode:
- Open Extensions view
- Open menu
... - Select
Install from VSIX... - Choose
packages/typekit-i18n-vscode/typekit-i18n-vscode-0.1.0.vsix
Extension Settings
typekitI18n.translationGlobs: additional translation file discovery globs. The extension also auto-discoversinputpaths fromtypekit.config.*andtypekit-i18n.config.*.typekitI18n.completionMode: completion behavior (fallback,always,alwaysPreferExtension).typekitI18n.enablePlaceholderSnippets: enables snippet insertion for placeholder data arguments.typekitI18n.previewLocales: locales shown in completion and hover previews.typekitI18n.previewMaxLocales: max locale count in completion and hover previews.
Status Output
The extension writes runtime status logs to the typekit-i18n output channel.
Logged events include:
- discovered/effective translation globs
- loaded typekit config files
- ignored/invalid config warnings
- watcher updates and refresh triggers
- refresh result summary and indexed file preview
- explicit "no translation files indexed" warning
Commands
typekit-i18n: Refresh Translation Indextypekit-i18n: Run Diagnosticstypekit-i18n: Measure Index Performance