WORK-505
ID:WORK-505Status:done

Localize layout chrome (Zone 3) and computed transforms (Zone 4)

The two server-side chrome surfaces that are visible on every page: ~14 layout strings and the 4 computed-navigation strings. Both already receive config-derived data, so this is mostly wiring resolveLocaleString.

Priority:highComplexity:simpleMilestone:v0.29.0Source:SPEC-035
main View source

Criteria completion

Criteria completion: 3 of 3 (100%) checked; history from Jul 17 to Jul 230%25%50%75%100%Jul 17Jul 23

Relationships

Implements 1
Related 2
Branches 2
main current done
claude/milestone-v0-29-0-stzywk doneclaude/multi-language-support-spec-5zzt9q ready
History 3
  1. f198cbc
    • ☑ All Zone 3 layout strings and aria-labels resolve through `resolveLocaleString` with `layout.*` keys.
    • ☑ All Zone 4 computed strings resolve with `core.*` keys.
    • ☑ Zero-config English output unchanged.
    by bjornolofandersson
  2. 9c7bd86
    Created (ready)by bjornolofandersson
  3. d92ad0c
    Content editedby Claude
    plan: accept SPEC-035, add v0.29.0 milestone + i18n work breakdown

Scope

  • Zone 3 — layout chrome (packages/transform/src/layouts.ts): resolve all visible text and aria-labels via resolveLocaleString with layout.* keys — "Open menu", "Close menu", "Search", "Menu", "Toggle navigation", "Navigation menu", "Page navigation", "Plan navigation", "Toggle color theme", "Jump to section", "Plan".
  • Zone 4 — computed transforms (packages/transform/src/computed.ts): buildToc() → core.toc.title ("On this page"); buildPrevNext() → core.prevNext.previous / .next; buildVersionSwitcher() → core.versionSwitcher.label.
  • Pass the LocaleContext into the layout builders and computed functions.
  • Tests: a German locale renders translated chrome; missing keys fall back to English.

Acceptance Criteria

  • All Zone 3 layout strings and aria-labels resolve through resolveLocaleString with layout.* keys.
  • All Zone 4 computed strings resolve with core.* keys.
  • Zero-config English output unchanged.

Blocked by

  • WORK-502

References

  • SPEC-035 — Zones 3 & 4.

Resolution

Completed: 2026-07-17

Branch: claude/milestone-v0-29-0-stzywk

What was done

  • Zone 4 (computed.ts): buildToc/buildPrevNext/buildVersionSwitcher take an optional LocaleContext and resolve core.toc.title, core.prevNext.previous/.next, core.versionSwitcher.label.
  • Zone 3 (layout.ts): added a LAYOUT_STRINGS catalog (layout.* → English) + reverse index; localizeChromeText swaps any chrome attribute value or text node that exactly matches a known layout string. Threaded locale through layoutTransform → resolveComputed/resolveSlot/resolveSource/buildLayoutChrome, plus slot attrs.
  • renderPage (adapter.ts) forwards an optional locale to layoutTransform.
  • Exported LAYOUT_STRINGS for the extract tooling. Tests in i18n-chrome.test.ts (6).

Notes

  • locale is optional everywhere → English default is byte-identical (612 transform tests pass). Only exact matches to the catalog are localized, so author/page content is never touched. Passing the site locale into renderPage from each adapter is completed in WORK-511.