Add localization support with @vscode/l10n

[Copilot]

Implements VS Code localization infrastructure to enable future multi-language support for all user-facing strings.

Changes

Localization Infrastructure

• src/strings.ts - Centralized l10n module with HTML escaping for security
• package.nls.json - Package metadata localization (command titles, settings descriptions)
• l10n/bundle.l10n.json - Runtime translations (English baseline)

String Extraction

• Replaced hardcoded strings in typeCommand.ts, highScoreCommand.ts, shareStatsCommand.ts
• Updated package.json to reference localization keys using %key% syntax
• Template strings use VS Code standard {0}, {1} placeholders

Security

• HTML escaping function prevents XSS in user-provided content (error messages)
• Template-based approach separates translatable text from markup

Example Usage

// Before
vscode.window.showInformationMessage(
    `High Scores - Keystrokes: ${highScore} keys/sec | WPM: ${wpmScore} words/min`
);

// After
vscode.window.showInformationMessage(
    strings.highScore.displayMessage(String(highScore), String(wpmScore))
);

Adding New Languages

Contributors can add translations without code changes:

1. Create l10n/bundle.l10n.{locale}.json (e.g., bundle.l10n.es.json)
2. Create package.nls.{locale}.json
3. VS Code auto-selects based on user locale

See docs/LOCALIZATION.md for guidelines.

Version: 1.1.4 → 1.2.0 (new feature)

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• update.code.visualstudio.com
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/typingspeedometer/typingspeedometer/node_modules/.bin/vscode-test (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Add localization strings

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.