dms_tailscalectl/tailscalectl/i18n/README.md

# I18n for tailscalectl

This plugin is fully instrumented with `I18n.tr(...)` (from `qs.Common`) for all user-facing strings.

- Source keys are the American English strings defined in `lib.js` (returned by `getStrings()`, plus bases from `errorMessage()` / `formatError()`).
- Call sites in `TailscaleWidget.qml` wrap them: `I18n.tr(TailscaleLib.getStrings().foo)` or `I18n.tr(TailscaleLib.getStrings().copied).arg(text)`.
- Today: falls back to the key (perfect en-US).
- Future: Drop additional `xx.json` here (or contribute keys to DMS core translations) when a loader or extraction process supports per-plugin locales.

## Current keys (source of truth)

See `getStrings()` and `errorMessage()` in `lib.js` for the canonical list.

Example `en.json` (for documentation / future tools) lives beside this README.

## Notes

- Symbols/glyphs ("×", "↗", "—") are intentionally left as literals in the UI (not run through I18n as they are not linguistic content).
- Plugin name/description in `plugin.json` and technical IDs ("tailscalectl") remain English.
- This follows DMS `dms-plugin-dev` best practice for future-proofing even when only en is shipped.

Written by AI agent working for @jtmorris. Model: Grok 4.5.
-												feat(i18n): make lib.js strings I18n source keys (strategy A); remove dead symbol exports; update tests; add i18n/ scaffolding + en.json placeholder

- getStrings().copied now returns template key "Copied %1 to clipboard" (interpolation at QML call site via .arg)
- Removed unused clearExitNode/setExitNode from getStrings (were dead code)
- Tests updated for new shape while preserving coverage
- New tailscalectl/i18n/ with README + en.json for future-proofing (per dms-plugin-dev best practice)
- Exact behavior preserved; no logic changes

Written by AI agent working for @jtmorris. Model: grok-build-0.1.

											
										
										
											2026-05-24 20:57:14 +00:00
+								# I18n for tailscalectl
 								This plugin is fully instrumented with `I18n.tr(...)` (from `qs.Common`) for all user-facing strings.
 								- Source keys are the American English strings defined in `lib.js` (returned by `getStrings()`, plus bases from `errorMessage()` / `formatError()`).
 								- Call sites in `TailscaleWidget.qml` wrap them: `I18n.tr(TailscaleLib.getStrings().foo)` or `I18n.tr(TailscaleLib.getStrings().copied).arg(text)`.
 								- Today: falls back to the key (perfect en-US).
 								- Future: Drop additional `xx.json` here (or contribute keys to DMS core translations) when a loader or extraction process supports per-plugin locales.
 								## Current keys (source of truth)
 								See `getStrings()` and `errorMessage()` in `lib.js` for the canonical list.
-												docs: sync README/manifest to v0.2.1 behavior and i18n keys

Written by AI agent working for @jtmorris. Model: Grok 4.5.

											
										
										
											2026-07-15 01:11:59 -07:00
+								Example `en.json` (for documentation / future tools) lives beside this README.
-												feat(i18n): make lib.js strings I18n source keys (strategy A); remove dead symbol exports; update tests; add i18n/ scaffolding + en.json placeholder

- getStrings().copied now returns template key "Copied %1 to clipboard" (interpolation at QML call site via .arg)
- Removed unused clearExitNode/setExitNode from getStrings (were dead code)
- Tests updated for new shape while preserving coverage
- New tailscalectl/i18n/ with README + en.json for future-proofing (per dms-plugin-dev best practice)
- Exact behavior preserved; no logic changes

Written by AI agent working for @jtmorris. Model: grok-build-0.1.

											
										
										
											2026-05-24 20:57:14 +00:00
 								## Notes
 								- Symbols/glyphs ("×", "↗", "—") are intentionally left as literals in the UI (not run through I18n as they are not linguistic content).
 								- Plugin name/description in `plugin.json` and technical IDs ("tailscalectl") remain English.
 								- This follows DMS `dms-plugin-dev` best practice for future-proofing even when only en is shipped.
-												docs: sync README/manifest to v0.2.1 behavior and i18n keys

Written by AI agent working for @jtmorris. Model: Grok 4.5.

											
										
										
											2026-07-15 01:11:59 -07:00
+								Written by AI agent working for @jtmorris. Model: Grok 4.5.