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

1.9 KiB

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

  • English message catalog and t helper (M1.11)
  • Lint rule against bare template strings (M1.11)
  • Every UI string in ui/src from the catalog: templates, title and aria-label attributes, notices, frontend error texts (M1.11)
  • 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