Lutra/docs/localization-parity.md
danny f41df518b5 M1.12: notifications as toasts
The host publishes picker, command-line and pump errors as notification
events (Engine::notify, same id sequence) instead of stderr, keeps
notifications and watchFailed published before engine_ready and replays
them after the state replay, so startup warnings (corrupt settings,
journal entries) reach the UI. ipc.ts announces engine_ready once all
subscriptions started together are registered.

Frontend: notifications store and NotificationStack (bottom right, info
auto-dismissed after 5 s, warnings/errors stay, close button and Escape,
at most 5 visible with "+n more", role status/alert); watchFailed maps to
a warning toast; failed commands without their own UI raise an error
toast. Catalog keys notification.settings.*, project.*, vfs.*, watch.*,
command.* plus the runtime allow-list. Docs updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 16:20:45 +02:00

31 lines
1.9 KiB
Markdown

# Localization checklist
> **Status:** English catalog covers 100% of UI strings (M1.11); German not started · **Last updated:** 2026-10-16
| Language | Code | Status | Translated |
|---|---|---|---:|
| English | `en` | source catalog (`ui/src/i18n/en.json`) | 100% of UI strings (46 keys, measured by the catalog test) |
| German | `de` | planned (G14) | 0% |
All interface strings go through the message catalog: `t(key, params?)` from `ui/src/i18n`, flat dotted keys grouped by area (`app.*`, `project.*`, `editor.*`, `common.*`), `{name}` placeholders. Lint (`vue/no-bare-strings-in-template`, error) rejects bare text in templates; a Vitest scan checks that every key passed to `t` exists in `en.json` and that the catalog has no unused keys.
## Checklist
- [x] English message catalog and `t` helper (M1.11)
- [x] Lint rule against bare template strings (M1.11)
- [x] Every UI string in `ui/src` from the catalog: templates, `title` and `aria-label` attributes, notices, frontend error texts (M1.11)
- [x] Notification texts: engine and host notifications carry a `messageKey` with params; all 12 notification message keys are in the catalog (M1.7, M1.12), `message` is only the English fallback
- [ ] Engine messages: `EngineError.message` and other texts the engine sends are English only; they need message keys and params (G14)
- [ ] Setting labels and descriptions from `settings.list` (`labelKey`, `descriptionKey`) in the catalog (M1.9b)
- [ ] Language switch through `ui.language`; the catalog becomes reactive (G14)
- [ ] Plural forms and number/date formatting per locale (G14)
- [ ] German catalog (G14)
- [ ] Native menus and dialogs of the desktop shell (folder picker title, app menu) (G14)
## Revision history
| Date | Change | Summary |
|---|---|---|
| 2026-10-16 | minor | M1.12: notification keys, key count 46 |
| 2026-10-15 | minor | M1.11: English catalog, lint rule, checklist; engine-message gap |
| 2026-10-13 | major | Baseline |