typekit-i18n VSCode Extension

VSCode extension for typekit-i18n authoring workflows.

Status

• Current release: 0.3.0
• Initial release: 0.1.0
• Marketplace link: https://marketplace.visualstudio.com/items?itemName=number10.typekit-i18n-vscode

Features

• Key intelligence:
  • Go to definition (F12)
  • Find references (Shift+F12)
  • Rename symbol (F2)
  • Safe delete warning for still-referenced keys
• Diagnostics and quick fixes:
  • Unknown key usage in code
  • Missing locale values
  • Duplicate keys
  • Placeholder mismatch
  • CSV/YAML/JSON schema and value type checks
  • ICU plural/selectordinal other branch check
• Completion and hover:
  • Translation-aware key completion
  • Locale preview in completion and hover
  • Placeholder snippet insertion in data array format
• Utility:
  • Refresh translation index
  • Run diagnostics manually
  • Measure index refresh baseline (typekitI18n.measureIndexPerformance)

Scripts

• pnpm --filter typekit-i18n-vscode build
• pnpm --filter typekit-i18n-vscode dev
• pnpm --filter typekit-i18n-vscode lint
• pnpm --filter typekit-i18n-vscode package:vsix
• pnpm --filter typekit-i18n-vscode typecheck
• pnpm --filter typekit-i18n-vscode test

Current Scope

Implementation details and rollout plan are tracked in PLAN.md. Diagnostic code coverage is tracked in docs/DIAGNOSTICS.md.

Useful Settings

• typekitI18n.translationGlobs: additional translation file discovery globs (merged with detected input entries from typekit.config.* / typekit-i18n.config.* when present).
• typekitI18n.completionMode: fallback, always, or alwaysPreferExtension (default, keeps extension suggestions first).
• typekitI18n.enablePlaceholderSnippets: inserts t("key", { ... }) placeholder snippets on completion when applicable.
• typekitI18n.previewLocales: locales shown in completion/hover previews.
• typekitI18n.previewMaxLocales: max locale count shown in completion/hover previews.

Status Output

Open the typekit-i18n output channel in VSCode to inspect extension status logs.

Logged status includes:

• discovered and effective translation globs
• loaded typekit.config.* / typekit-i18n.config.* files
• non-fatal config discovery warnings
• watcher reconfiguration events
• refresh triggers (startup/settings/file changes)
• refresh result summary (files, keys, languages, diagnostics)
• explicit warning when no translation files were indexed

Local Installation

1. Build and package the extension:
   • pnpm --filter typekit-i18n-vscode package:vsix
2. Install the generated .vsix from VSCode:
   • Extensions view -> ... menu -> Install from VSIX...