@elabs-ai/components-ui 4.0.0 → 4.1.0

package/src/components/locale-provider/messages.ts

@@ -1,5 +1,26 @@
 "use client";
 
+/**
+ * ICU cardinal-plural category, per `Intl.PluralRules` ("zero" | "one" | "two"
+ * | "few" | "many" | "other"). Locales vary in which categories they use —
+ * English has only "one"/"other"; Polish and Russian also use "few"/"many" —
+ * so a `PluralMessage` may omit any category it doesn't need. `"other"` is the
+ * universal fallback every locale defines.
+ */
+export type PluralCategory = Intl.LDMLPluralRule;
+
+/**
+ * A per-count message: one string per plural category, selected at render
+ * time via `Intl.PluralRules(locale).select(count)`. Each string still
+ * supports the same `{name}`-style interpolation as a plain message.
+ * Note: when passed to `t()`, `count` in `vars` must be a number, not a
+ * numeric string, to select the correct plural category.
+ */
+export type PluralMessage = Partial<Record<PluralCategory, string>>;
+
+/** A single message value: a plain string, or a plural-form map. */
+export type MessageValue = string | PluralMessage;
+
 /**
  * Shipped English (en-US) default microcopy bundle.
  *
@@ -7,7 +28,7 @@
  * translate cleanly into any target locale. Keep this list small and real —
  * only add a key here when a component actually needs it.
  */
-export const DEFAULT_MESSAGES: Record<string, string> = {
+export const DEFAULT_MESSAGES: Record<string, MessageValue> = {
   // ── Generic (shared across packages — reuse these before minting a new key) ──
   close: "Close",
   copy: "Copy",
@@ -20,6 +41,11 @@ export const DEFAULT_MESSAGES: Record<string, string> = {
   loading: "Loading…",
   more: "More",
   selectAll: "Select all",
+  // Cardinal-plural example (#19) — a shared "N item(s) selected" microcopy
+  // any multi-select surface can reuse via `t("itemsSelected", { count })`.
+  // Demonstrates the plural-form shape: pick the primitive over inventing a
+  // near-duplicate flat string per component.
+  itemsSelected: { one: "{count} item selected", other: "{count} items selected" },
 
   // ── @elabs-ai/components-ui ───────────────────────────────────────────────────────────────
   "ui.metricCard.loading": "Loading metric…",
@@ -43,6 +69,24 @@ export const DEFAULT_MESSAGES: Record<string, string> = {
   "ui.modelPicker.loadFailed": "Couldn't load the list",
   "ui.modelPicker.nothingYet": "Nothing to show yet",
   "ui.modelPicker.retry": "Retry",
+  // KeyboardShortcuts (#113). `emptyFiltered` keeps the user's own query in the
+  // sentence so the empty state says WHY it is empty, not merely that it is.
+  "ui.keyboardShortcuts.searchPlaceholder": "Search shortcuts…",
+  "ui.keyboardShortcuts.emptyTitle": "No shortcuts found",
+  "ui.keyboardShortcuts.emptyFiltered": "No shortcuts match “{query}”.",
+  "ui.keyboardShortcuts.empty": "No shortcuts to show.",
+  // WorkspacePicker (#111). It composes ModelPicker, so it carries its OWN
+  // label/search strings rather than inheriting the generic "Choose a target".
+  // `current` is appended into the row's meta so the in-force workspace reaches
+  // the option's accessible name as a WORD, not only a check glyph (1.4.1).
+  "ui.workspacePicker.label": "Choose a workspace",
+  "ui.workspacePicker.placeholder": "No workspace selected",
+  "ui.workspacePicker.recent": "Recent workspaces",
+  "ui.workspacePicker.searchPlaceholder": "Search workspaces…",
+  "ui.workspacePicker.current": "Current",
+  "ui.workspacePicker.pathLabel": "Workspace path",
+  "ui.workspacePicker.pathPlaceholder": "/path/to/project…",
+  "ui.workspacePicker.openPath": "Open",
   // ViewToolbar (#331). `removeFilter` deliberately WRAPS the visible chip text
   // so the accessible name contains it (WCAG 2.5.3 Label in Name).
   "ui.viewToolbar.about": "About this view",
@@ -81,6 +125,54 @@ export const DEFAULT_MESSAGES: Record<string, string> = {
   "ui.confirmDialog.cancel": "Cancel",
   "ui.advancedGroup.title": "Advanced",
   "ui.advancedGroup.changed": "{count} changed",
+  // SchemaForm — the spec-driven config-form renderer (issue #22).
+  "ui.schemaForm.selectPlaceholder": "Select…",
+  "ui.schemaForm.label": "Form",
+  "ui.schemaForm.submit": "Submit",
+  "ui.schemaForm.submitting": "Submitting…",
+  "ui.schemaForm.submitted": "Submitted",
+  // SchemaFormTestAction — a form/group-level "Test connection" affordance
+  // (issue #22 maintainer ruling, 2026-09-01), independent of field validity
+  // and never gating submit.
+  "ui.schemaForm.testAction.label": "Test connection",
+  "ui.schemaForm.testAction.pending": "Testing…",
+  "ui.schemaForm.testAction.success": "Connected",
+  "ui.schemaForm.testAction.failure": "Test failed",
+  // Pagination's ellipsis (sr-only — the visible glyph is decorative).
+  "ui.pagination.morePages": "More pages",
+  // Pagination's prev/next links — the ACCESSIBLE NAME (`aria-label`), distinct
+  // from the visible `previous`/`next` text below it: an `aria-label` overrides
+  // visible text content as the accessible name, so leaving these hardcoded in
+  // English meant a non-English `LocaleProvider` translated the visible label
+  // but a screen-reader user still heard English (#12/#53 review, P2).
+  "ui.pagination.previous": "Go to previous page",
+  "ui.pagination.next": "Go to next page",
+  // Sidebar's mobile Sheet title (sr-only header — the sheet itself has no
+  // visible chrome, so this is only ever read by assistive tech).
+  "ui.sidebar.title": "Sidebar",
+  // ContextRail's switcher count phrase (composed into the accessible name,
+  // e.g. "Sources 3 items") and its default empty-state copy.
+  "ui.contextRail.sectionCount": { one: "{count} item", other: "{count} items" },
+  "ui.contextRail.empty": "No sections",
+  // SideDock's resize handle — its sr-only label and its live width readout.
+  "ui.sideDock.resize": "Resize",
+  "ui.sideDock.widthValue": { one: "{size} pixel", other: "{size} pixels" },
+  // Tree's error row — shared by the virtualized and non-virtualized branches.
+  "ui.tree.failedToLoad": "Failed to load",
+  // ThemeSwitcher's "follow the OS" option, in both dropdown and toggle modes.
+  "ui.themeSwitcher.system": "System",
+  "ui.navNotifications.label": "Notifications",
+  "ui.teamSwitcher.label": "Teams",
+  "ui.teamSwitcher.addTeam": "Add team",
+  // Table's own scroll wrapper (#366). Rendered ONLY when the wrapper actually
+  // overflows, so it is never announced for a table that fits — see
+  // `packages/ui/src/components/table/table.tsx`. Deliberately a `ui.*`
+  // sibling of `data.table.scrollRegion` rather than a shared cross-package
+  // key: `Table` is a `@elabs-ai/components-ui` component and each package
+  // keeps its own namespace even where the English string coincides (compare
+  // `viewer.content` vs this), so a translator can phrase either
+  // independently and neither package depends on a string owned by another.
+  "ui.table.scrollRegion": "Table contents, scrollable",
 
   // ── @elabs-ai/components-data ─────────────────────────────────────────────────────────────
   // The scroll region's accessible name is rendered ONLY when the table actually
@@ -89,6 +181,57 @@ export const DEFAULT_MESSAGES: Record<string, string> = {
   // Fallback name for a row's activation control when the row's first cell holds
   // no primitive value to name it after (see `rowActionLabel`).
   "data.table.rowAction": "Activate row",
+  // createSelectionColumn (#11) — the header select-all checkbox and each row's
+  // own checkbox. Kept table-scoped (not the generic `selectAll` key) so a
+  // translator can phrase "rows" distinctly from other bulk-select surfaces.
+  "data.table.selectAllRows": "Select all rows",
+  // `selectRowNamed` names each row's checkbox from its own first data column
+  // (#11 I4) so screen-reader users hear "Select Alpha", not `selectRow`'s
+  // identical generic label repeated on every row; `selectRow` stays the
+  // fallback when no data column value is derivable.
+  "data.table.selectRowNamed": "Select {name}",
+  "data.table.selectRow": "Select row",
+  // Column resizing (#12) — the accessible name for the WAI-ARIA
+  // separator-as-slider resize handle at the end of a resizable header cell.
+  "data.table.resizeColumn": "Resize column, {name}",
+  // #51 — the handle's accessible VALUE, paired with aria-valuenow (which
+  // stays a plain number for AT/TanStack). A bare number reads as a
+  // dimensionless ordinal; the unit makes it a size. A `PluralMessage` (PR
+  // #81 review, "Format the announced resize value for the active locale") —
+  // the call site passes both `count` (the raw number, so a locale whose
+  // plural rules select something other than "other" for a given size is
+  // reachable) and `size` (pre-formatted via `formatNumber`, so a locale
+  // override renders locale-appropriate digits/grouping instead of a raw
+  // Latin-digit JS number).
+  "data.table.resizeColumnValue": { one: "{size} pixel", other: "{size} pixels" },
+  // Row drag-reorder (#13). `reorderHandle`/`reorderColumnHeader` name the
+  // grip control and its column; the four `reorder*` announcement keys back
+  // the aria-live region dnd-kit's `accessibility.announcements` renders on
+  // pickup/move/drop/cancel (WCAG 4.1.3) — `position`/`total` are 1-based so
+  // the announcement reads like "3 of 8", not a 0-based index.
+  "data.table.reorderColumnHeader": "Reorder",
+  "data.table.reorderHandle": "Reorder {name}",
+  "data.table.reorderPickedUp": "Picked up {name}.",
+  "data.table.reorderMoved": "{name} moved to position {position} of {total}.",
+  "data.table.reorderDropped": "{name} dropped at position {position} of {total}.",
+  "data.table.reorderCancelled":
+    "Reordering cancelled. {name} returned to position {position} of {total}.",
+  // #98: `@dnd-kit` renders two more AT-visible strings for this same
+  // feature that this repo's source never writes — the hidden keyboard
+  // usage instructions (wired to the grip via `aria-describedby`) and the
+  // activator's `aria-roledescription`. Both ship a hardcoded English
+  // default deep inside the library; localizing them means overriding them
+  // explicitly with these two keys. The English DEFAULT below is dnd-kit's
+  // own default text verbatim (`defaultScreenReaderInstructions.draggable`
+  // in `@dnd-kit/core`, and `useSortable`'s `roleDescription: 'sortable'` in
+  // `@dnd-kit/sortable`) — not a rewrite — so an English consumer with no
+  // `LocaleProvider` override sees byte-identical output to before this
+  // fix; only a `messages` override changes it.
+  "data.table.reorderInstructions":
+    "\n    To pick up a draggable item, press the space bar.\n    While dragging, use the arrow keys to move the item.\n    Press space again to drop the item in its new position, or press escape to cancel.\n  ",
+  "data.table.reorderRoleDescription": "sortable",
+  "data.facetFilter.clearFilters": "Clear filters",
+  "data.columnPicker.toggleColumns": "Toggle columns",
 
   // ── @elabs-ai/components-charts ───────────────────────────────────────────────────────────
   // Shared caption for any bare chart surface's layout-shaped skeleton
@@ -105,6 +248,12 @@ export const DEFAULT_MESSAGES: Record<string, string> = {
   // Announced when `copyValueOnActivate` puts a datapoint's exact value on the
   // clipboard — the recovery path for a compact axis label.
   "charts.datapoint.copied": "Exact value copied",
+  // ChartFrame's SVG/PNG export actions (RM-025). Each string is used twice —
+  // as the icon button's `aria-label` (its ONLY accessible name) and as the
+  // tooltip a sighted user reads — so one key serves both and they cannot
+  // drift apart in translation.
+  "charts.chartFrame.exportSvg": "Export as SVG",
+  "charts.chartFrame.exportPng": "Export as PNG",
 
   // ── @elabs-ai/components-ai ───────────────────────────────────────────────────────────────
   // Namespaced `ai.<area>.<key>` so package microcopy can't collide with the
@@ -120,25 +269,66 @@ export const DEFAULT_MESSAGES: Record<string, string> = {
   "ai.promptInput.uploadFiles": "Upload files",
   "ai.promptInput.submit": "Submit",
   "ai.promptInput.stop": "Stop",
+  "ai.agent.instructions": "Instructions",
+  "ai.agent.tools": "Tools",
   "ai.codeBlock.generating": "Generating…",
   "ai.composer.placeholder": "Ask me anything…",
-  "ai.context.usage": "Model context usage",
+  "ai.tokenUsage.usage": "Model context usage",
+  "ai.tokenUsage.totalCost": "Total cost",
+  "ai.tokenUsage.input": "Input",
+  "ai.tokenUsage.output": "Output",
+  "ai.tokenUsage.reasoning": "Reasoning",
+  "ai.tokenUsage.cache": "Cache",
   "ai.contextPanel.back": "Back to context",
   "ai.contextPanel.toggle": "Toggle context panel",
+  // The mobile Sheet's sr-only title (#18) — distinct from `contextPanel.toggle`,
+  // which labels the button that opens/closes it.
+  "ai.contextPanel.title": "Context panel",
   "ai.environmentVariables.toggleVisibility": "Toggle value visibility",
   "ai.gallery.label": "Image gallery",
   "ai.gallery.expandImage": "Expand image",
   "ai.gallery.downloadImage": "Download image",
+  "ai.gallery.noImages": "No images",
+  "ai.gallery.noDetails": "No details",
+  // Shared by Tool's technical view and SchemaDisplay's request panel.
+  "ai.schemaDisplay.parameters": "Parameters",
+  "ai.schemaDisplay.response": "Response",
+  // ReasoningTrigger's default not-yet-timed message (before `duration` is known).
+  "ai.reasoning.thoughtDefault": "Thought for a few seconds",
+  "ai.stackTrace.empty": "No stack frames",
+  "ai.webPreview.noConsoleOutput": "No console output",
+  // PlanTrigger's icon-only collapse/expand control (sr-only).
+  "ai.plan.togglePlan": "Toggle plan",
   "ai.message.actions": "Message actions",
   "ai.message.editMessage": "Edit message",
   "ai.message.feedback": "Message feedback",
   "ai.message.previousBranch": "Previous branch",
   "ai.message.nextBranch": "Next branch",
+  "ai.messageCompare.error": "Error",
+  "ai.messageCompare.tabs": "Compare responses",
   "ai.persona.idle": "Assistant idle",
   "ai.persona.listening": "Assistant listening",
   "ai.persona.thinking": "Assistant thinking…",
   "ai.persona.speaking": "Assistant speaking",
   "ai.persona.asleep": "Assistant asleep",
+  // Optional-peer lazy engines (issue #33) — one shared pair every lazy
+  // boundary's missing-dependency panel resolves through, plus one
+  // `feature`-name key per boundary that renders it (mermaid, the terminal).
+  "ai.error.engineMissing": "{feature} unavailable",
+  "ai.error.engineMissingBody": "{feature} needs {packages} to be installed.",
+  "ai.error.retry": "Try again",
+  "ai.mermaid.feature": "Mermaid diagrams",
+  "ai.mermaid.renderError": "Diagram couldn't be drawn",
+  "ai.terminal.feature": "Interactive terminal",
+  "ai.terminal.renderError": "Terminal couldn't start",
+  "ai.audioPlayer.feature": "Audio player",
+  "ai.audioPlayer.renderError": "Audio player couldn't load",
+  // AudioVisualizer. Announced through a throttled `role="status"` region —
+  // the canvas itself is decorative (see .claude/rules/loading-states.md and
+  // issue #21's accessibility guidance).
+  "ai.audioVisualizer.idle": "Microphone not connected",
+  "ai.audioVisualizer.silent": "No input detected",
+  "ai.audioVisualizer.active": "Microphone active",
   "ai.selectionToolbar.label": "Selection actions",
   "ai.webPreview.urlPlaceholder": "Enter URL...",
   "ai.micSelector.searchPlaceholder": "Search microphones...",
@@ -148,6 +338,60 @@ export const DEFAULT_MESSAGES: Record<string, string> = {
   "ai.voiceSelector.playPreview": "Play preview",
   "ai.voiceSelector.pausePreview": "Pause preview",
 
+  // TurnStatus / SessionStatusBar (#105). `label` itself is caller-supplied
+  // ("Working…", "Editing files…") and rendered verbatim, so it needs no key
+  // here — only the component-owned completed-turn sentence and controls do.
+  "ai.turnStatus.completedIn": "Turn completed in {elapsed}",
+  "ai.turnStatus.completed": "Turn completed",
+  "ai.turnStatus.scrollToBottom": "Scroll to bottom",
+  "ai.sessionStatusBar.connections": "{connected} of {total} connections",
+  "ai.sessionStatusBar.connecting": "Connecting…",
+  // SessionHeader (#110). The section headings and the quick-action group name
+  // are component-owned chrome; the capability/what's-new item text itself is
+  // caller-supplied and rendered verbatim.
+  "ai.sessionHeader.capabilities": "Capabilities",
+  "ai.sessionHeader.whatsNew": "What’s new",
+  "ai.sessionHeader.quickActions": "Quick actions",
+  // PermissionModeSelect (#104). The in-force marker is a WORD inside the mode
+  // label, so the current mode survives greyscale and reaches the accessible name.
+  "ai.permissionModeSelect.current": "Current",
+  // AgentEvent (#109). The pass/fail WORD is the non-colour channel — the tone
+  // is redundant with it, so a check outcome survives greyscale (WCAG 1.4.1).
+  "ai.agentEvent.checkPassed": "Passed",
+  "ai.agentEvent.checkFailed": "Failed",
+  "ai.agentEvent.checksSummary": "{passed}/{ran} checks passed",
+  "ai.agentEvent.phaseBefore": "Before",
+  "ai.agentEvent.phaseAfter": "After",
+  "ai.agentEvent.phaseLifecycle": "Lifecycle",
+  // DiffView (#102). `addedLine` / `removedLine` are the sr-only polarity
+  // prefixes — the +/− glyph is aria-hidden, so these WORDS are the channel a
+  // greyscale or screen-reader user recovers the polarity from (WCAG 1.4.1).
+  // They intentionally end in a space so they read as a prefix to the code line.
+  "ai.diffView.addedLine": "Added: ",
+  "ai.diffView.removedLine": "Removed: ",
+  "ai.diffView.statsSummary": "{additions} additions, {deletions} deletions",
+  "ai.diffView.showMore": { one: "Show {count} more line", other: "Show {count} more lines" },
+  "ai.diffView.pagerLegend": "Arrow keys scroll, Page Up/Down page, Home/End jump",
+  "ai.diffView.regionLabel": "Code diff",
+  "ai.diffView.loading": "Loading diff…",
+  // ApprovalCard (#103). The SCOPE sentence is what makes an N-option
+  // permission prompt safe to answer: "Yes" and "Yes, and don't ask again" look
+  // alike and mean very different things. Each option links its scope sentence
+  // through aria-describedby, so the blast radius of a choice reaches assistive
+  // tech as words — never as a colour or a data-* attribute.
+  "ai.approvalCard.scopeOnceDescription": "Applies to this action only.",
+  "ai.approvalCard.scopeSessionDescription":
+    "Applies to actions like this for the rest of this session.",
+  "ai.approvalCard.scopeAlwaysDescription": "Applies to actions like this from now on.",
+  "ai.approvalCard.scopeDenyDescription": "Rejects this action.",
+  "ai.approvalCard.reasonLabel": "Reason",
+  "ai.approvalCard.reasonPlaceholder": "Add a reason (optional)…",
+  // PromptInputSlash (#106). `listLabel` goes to cmdk's own `label` prop, not
+  // `aria-label` — cmdk overwrites a consumer `aria-label` on CommandList and
+  // reads its accessible name off `label` instead.
+  "ai.promptInputSlash.listLabel": "Commands",
+  "ai.promptInputSlash.empty": "No matching commands.",
+
   // ── Streamdown chrome (third-party rendering surface) ──────────────────────
   // `streamdown` renders its OWN controls inside every streamed-markdown block
   // (code header, table menus, Mermaid toolbar, external-link interstitial) and
@@ -297,4 +541,259 @@ export const DEFAULT_MESSAGES: Record<string, string> = {
   "viewer.highlight.previous": "Previous passage",
   "viewer.highlight.next": "Next passage",
   "viewer.highlight.count": "Passage {index} of {total}",
+
+  // ── @elabs-ai/components-terminal ─────────────────────────────────────────
+  // Terminal (the read-only ANSI log): the ONE live-region announcement for
+  // its `isStreaming` rung. The blinking cursor block is the only other
+  // streaming signal and it is purely visual, so without this a screen-reader
+  // user attached to a running build or deploy log gets no indication that
+  // anything is still arriving.
+  "terminal.output.streaming": "Streaming output…",
+  // TerminalTranscriptRow (#117 T2): the gutter's meaning as words, so the
+  // "who spoke / what it printed / did it fail" grammar survives greyscale
+  // and reaches assistive tech, not only the glyph + colour.
+  "terminal.transcriptRow.user": "Prompt",
+  "terminal.transcriptRow.agent": "Agent",
+  "terminal.transcriptRow.output": "Output",
+  "terminal.transcriptRow.error": "Error",
+  "terminal.transcriptRow.exitCode": "Exit {code}",
+  // TerminalTodoList (#117 T5): the three-state checklist's announced word
+  // per row — the second, non-colour channel beside the ✔ / ◼ / ◻ glyph and
+  // the strikethrough/bold treatment. Wording verified 2026-09-01 against
+  // Claude Code v2.1.207's own upstream state words, parentheses included.
+  "terminal.todoList.done": "(completed)",
+  "terminal.todoList.active": "(in progress)",
+  "terminal.todoList.pending": "(pending)",
+  // TerminalEventLine (#117 T6): the lifecycle/hook event line. `outcome*` is
+  // the sr-only word beside the (always aria-hidden) StatusIcon glyph —
+  // never omitted for the default "ok" case, so "succeeded" is exactly as
+  // recoverable as "failed". `hooksTotal`/`hooksResult` are the terminal's
+  // own literal `[hooks: …]` bracket vocabulary, verified live 2026-09-01
+  // against Grok CLI v0.2.93; `hooksFailed` is the sr-only, count-aware
+  // "N hooks failed" that makes a partial hook failure (e.g. `3/1`) read as
+  // bad without relying on colour.
+  "terminal.eventLine.outcomeOk": "Succeeded",
+  "terminal.eventLine.outcomeBlocked": "Blocked",
+  "terminal.eventLine.outcomeFailed": "Failed",
+  "terminal.eventLine.phaseBefore": "Before",
+  "terminal.eventLine.phaseAfter": "After",
+  "terminal.eventLine.phaseLifecycle": "Lifecycle",
+  "terminal.eventLine.hooksTotal": "[hooks: {total}]",
+  "terminal.eventLine.hooksResult": "[hooks: {ran}/{passed}]",
+  "terminal.eventLine.hooksFailed": {
+    one: "{count} hook failed",
+    other: "{count} hooks failed",
+  },
+  // TerminalWorking (#117 T3): the in-turn footer's default label and its two
+  // icon-only controls' accessible names. No generic "stop"/"scroll to
+  // bottom" key exists yet (only the ai-namespaced `ai.promptInput.stop` /
+  // `ai.turnStatus.scrollToBottom`), so these are minted under the package's
+  // own namespace rather than borrowed cross-package.
+  "terminal.working.label": "Waiting for response…",
+  "terminal.working.stop": "Stop",
+  "terminal.working.scrollToBottom": "Scroll to bottom",
+  // TerminalStatusBar (#117 T4): the ambient chrome row's accessible name and
+  // the sr-only words beside its aria-hidden numerals/glyphs. Mirrors
+  // `ai.sessionStatusBar.connections`' wording under this package's own
+  // namespace (cannot import the `ai` key — sibling packages never import
+  // each other, `.claude/rules/terminal-components.md` § Reuse means
+  // promotion). `disconnected` and `stepsComplete` ("steps complete") are
+  // verified live 2026-09-01 against Grok CLI v0.2.93.
+  "terminal.statusBar.label": "Session status",
+  "terminal.statusBar.connecting": "Connecting…",
+  "terminal.statusBar.connections": "{connected} of {total} connections",
+  "terminal.statusBar.disconnected": "Disconnected",
+  "terminal.statusBar.context": "{used} of {limit} context used",
+  "terminal.statusBar.stepsComplete": "{current} of {total} steps complete",
+  // TerminalBanner (#117 T7): the launch card above an empty transcript.
+  // Mirrors `ai.sessionHeader.*`'s wording under this package's own
+  // namespace — sibling packages never import each other's locale keys
+  // (`.claude/rules/terminal-components.md` § Reuse means promotion).
+  "terminal.banner.capabilities": "Capabilities",
+  "terminal.banner.whatsNew": "What’s new",
+  "terminal.banner.quickActions": "Quick actions",
+  // TerminalToolCall (#117 T8): the tool-call row's status word (announced
+  // beside the glyph via TerminalRow's gutterLabel — never colour alone),
+  // the result row's swapped heading (mirrors ToolOutput's own "Result"/
+  // "Error" heading swap, `@elabs-ai/components-ai`), and the expand
+  // trigger's accessible name. Unlike upstream's inert `"(ctrl+o to
+  // expand)"` hint text, this IS a real focusable control's label — no CLI
+  // chord required.
+  "terminal.toolCall.succeeded": "Succeeded",
+  "terminal.toolCall.failed": "Failed",
+  "terminal.toolCall.running": "Running",
+  "terminal.toolCall.result": "Result",
+  "terminal.toolCall.error": "Error",
+  "terminal.toolCall.expandHint": "Show details",
+  // TerminalDiffHunk (#117 T9): the header's fixed "Update ({file})" phrase,
+  // and the collapsed-context-run disclosure's count-aware label. Mirrors
+  // `ai.diffView.showMore`'s wording under this package's own namespace —
+  // sibling packages never import each other's locale keys
+  // (`.claude/rules/terminal-components.md` § Reuse means promotion). The
+  // per-line `add`/`del` polarity words are NOT duplicated here: they ride
+  // the shared `diffLineAccessibleLabel()` keys (`ai.diffView.addedLine` /
+  // `ai.diffView.removedLine`) above, the actual promoted channel.
+  "terminal.diffHunk.header": "Update ({file})",
+  "terminal.diffHunk.showMore": {
+    one: "Show {count} more line",
+    other: "Show {count} more lines",
+  },
+  // TerminalPermission (#117 T10): the per-call scoped approval prompt's
+  // default title/question and its three scoped option labels, verified
+  // live 2026-09-01 against Claude Code v2.1.207. The third option is the
+  // vendor-free `deny` scope: upstream names its own product in this label,
+  // ours reads "the agent" instead (#117 acceptance criterion). The reason
+  // field reuses `ai.approvalCard.reasonLabel`/`reasonPlaceholder` and the
+  // option descriptions reuse `APPROVAL_SCOPE_DESCRIPTION_KEYS` — both
+  // already generic, so nothing new is minted for either.
+  "terminal.permission.title": "Bash command",
+  "terminal.permission.question": "Do you want to proceed?",
+  "terminal.permission.optionOnce": "Yes",
+  "terminal.permission.optionSession": "Yes, and don’t ask again this session",
+  "terminal.permission.optionDeny": "No, and tell the agent what to do differently",
+  // TerminalComposer (#117 T11): the prompt composer's placeholder, its
+  // merged submit/stop affordance's accessible name (mirrors
+  // `ai.promptInput.submit`/`stop` under this package's own namespace —
+  // sibling packages never import each other's locale keys,
+  // `.claude/rules/terminal-components.md` § Reuse means promotion), the
+  // effort scale's default accessible name, and the shortcut-hint row's
+  // three default words.
+  "terminal.composer.placeholder": "Type your next instruction…",
+  "terminal.composer.submit": "Send",
+  "terminal.composer.stop": "Stop",
+  "terminal.composer.effort": "Effort",
+  "terminal.composer.shortcutSend": "send",
+  "terminal.composer.shortcutNewline": "newline",
+  "terminal.composer.shortcutCancel": "cancel",
+  // TerminalSlashMenu (#117 T12): the `/`-command palette's listbox
+  // accessible name (mirrors `ai.promptInputSlash.listLabel`'s wording under
+  // this package's own namespace — sibling packages never import each
+  // other's locale keys, `.claude/rules/terminal-components.md` § Reuse
+  // means promotion). The empty state reuses the generic `noResults` key
+  // rather than minting a second one.
+  "terminal.slashMenu.listLabel": "Commands",
+  // ── @elabs-ai/components-process ──────────────────────────────────────────────────────────
+  // ProcessMap (RM-051). Namespaced `process.<area>.<key>` like every other
+  // package; a sibling package's keys are never reused across the boundary.
+  // The table twin's column headers are here because that table IS the
+  // accessible reading of the canvas — an untranslated header would leave a
+  // screen-reader user with numbers and no measure name.
+  "process.map.loading": "Discovering the process…",
+  "process.map.empty": "No activities to map",
+  "process.map.emptyBody":
+    "This log has no events, or the abstraction hid every activity. Widen the abstraction or load a different log.",
+  "process.map.label": "Process map",
+  "process.map.filter": "Filter…",
+  "process.map.activityCaption": "Activities — {metric} per activity",
+  "process.map.transitionCaption": "Transitions — {metric} per directly-follows pair",
+  "process.map.columnActivity": "Activity",
+  "process.map.columnRole": "Role",
+  "process.map.columnRework": "Rework",
+  "process.map.columnFrom": "From",
+  "process.map.columnTo": "To",
+  "process.map.columnShape": "Shape",
+  // State column (#373) — the table twin's own channel for the selection/filter state the
+  // canvas already says through real text in its accessible names; the twin used to carry
+  // it only as a `data-*` attribute, which reaches no user.
+  "process.map.columnState": "State",
+  // The State column's own CELL values (#413 review, PRRT_kwDOT6D7ts6gJX2C). #373 localized
+  // the column HEADER but left every cell printing the literal English word — since that cell
+  // is also the row's screen-reader channel for its selection/filter state
+  // (`selectionStateLabel` below is the un-localized canonical word `process-map.tsx` maps
+  // through these keys at the render site), a non-English `LocaleProvider` left both the
+  // visible AND the accessible content untranslated. `"associated"` (the ordinary case) has
+  // no key: it prints nothing, by design.
+  "process.map.stateSelected": "Selected",
+  "process.map.stateExcluded": "Excluded",
+  // Filter-intent menu item ACCESSIBLE names (#346). A transition's menu offers the same
+  // four intents once per endpoint (eight items total); the visible text
+  // (`PROCESS_FILTER_INTENT_LABELS` in map-model.ts) stays unsuffixed and compact, so these
+  // compose the activity into the item's real accessible name instead — the channel a
+  // screen-reader user actually hears, and the one the visible-only text left ambiguous.
+  "process.map.filterIntentWith": "Keep cases containing {activity}",
+  "process.map.filterIntentWithout": "Keep cases without {activity}",
+  "process.map.filterIntentStartsWith": "Keep cases starting with {activity}",
+  "process.map.filterIntentEndsWith": "Keep cases ending with {activity}",
+  // The map's own live-region summary (#375) — one polite `role="status"` announces what
+  // the active selection/filter just changed, mirroring `AbstractionControls`' hidden-count
+  // summary below: two independently-pluralized fragments, composed at the call site
+  // (`process-map.tsx`) rather than merged into one message, for the same reason.
+  "process.map.excludedActivities": {
+    one: "{count} of {total} activity excluded",
+    other: "{count} of {total} activities excluded",
+  },
+  "process.map.excludedTransitions": {
+    one: "{count} of {total} transition excluded",
+    other: "{count} of {total} transitions excluded",
+  },
+  // The live region's AFFECTED-SET fragments (#413 review, PRRT_kwDOT6D7ts6gJX2I). Counts
+  // alone are not enough: two selections/filters that exclude DIFFERENT elements but land on
+  // the SAME counts produce byte-for-byte identical text, so the polite region — which
+  // announces content CHANGES, not model changes — stays silent even though the map
+  // re-inked. Naming which elements are excluded makes the string track the actual set, not
+  // only its size. Composed at the call site alongside the two counts above, and omitted
+  // entirely when nothing of that kind is excluded (so the common case stays as short as
+  // before this fix).
+  "process.map.excludedActivityNames": "excluding {names}",
+  "process.map.excludedTransitionNames": "excluding {names}",
+  // AbstractionControls (RM-052, issue #227). The two sliders' own labels,
+  // the invert switch, the "Auto" heuristic button, and the hidden-count
+  // status line. `hiddenActivities`/`hiddenPaths` are separate `PluralMessage`s
+  // (not one combined key) because `t()` selects its plural category from a
+  // SINGLE `count` var — see `resolveMessage` in `locale-provider.tsx` — so
+  // the two independently-pluralizable counts are composed as two `t()` calls
+  // joined at the call site (`abstraction-controls.tsx`), not one key with two
+  // numbers.
+  "process.abstractionControls.label": "Abstraction",
+  "process.abstractionControls.activities": "Activities",
+  "process.abstractionControls.paths": "Paths",
+  "process.abstractionControls.invert": "Invert",
+  "process.abstractionControls.auto": "Auto",
+  "process.abstractionControls.hiddenActivities": {
+    one: "{count} activity hidden",
+    other: "{count} activities hidden",
+  },
+  "process.abstractionControls.hiddenPaths": {
+    one: "{count} path hidden",
+    other: "{count} paths hidden",
+  },
+  // MetricLayerSwitch (RM-052, issue #227). The Frequency/Performance/Rework
+  // toggle group, the node/edge metric selects' field labels, and the lock
+  // toggle's two accessible-name states. The per-VALUE metric labels
+  // ("Occurrences", "Share of transitions", …) are deliberately NOT
+  // duplicated here — they are read straight from `nodeMetricLabel`/
+  // `edgeMetricLabel` (`process-map/map-model.ts`), which already resolve
+  // each `ProcessMetric` to its correct, audience-specific text; see
+  // `metric-layer-switch.tsx`'s module docblock.
+  "process.metricLayerSwitch.label": "Metric",
+  "process.metricLayerSwitch.layer": "Metric layer",
+  "process.metricLayerSwitch.frequency": "Frequency",
+  "process.metricLayerSwitch.performance": "Performance",
+  "process.metricLayerSwitch.rework": "Rework",
+  "process.metricLayerSwitch.node": "Activity",
+  "process.metricLayerSwitch.edge": "Transition",
+  "process.metricLayerSwitch.lockOn": "Unlock activity and transition metrics",
+  "process.metricLayerSwitch.lockOff": "Lock activity and transition metrics together",
+  // ProcessKpiStrip (RM-052, issue #227). Six tiles' labels, plus the
+  // conformance tile's genuine "not available" state (no conformance model
+  // has run yet) — a real state, not a fabricated 0%.
+  "process.kpiStrip.cases": "Cases",
+  "process.kpiStrip.events": "Events",
+  "process.kpiStrip.variants": "Variants",
+  "process.kpiStrip.medianThroughput": "Median throughput",
+  "process.kpiStrip.reworkRate": "Rework rate",
+  "process.kpiStrip.conformance": "Conformance",
+  "process.kpiStrip.conformanceUnavailable": "Not available",
+  "process.kpiStrip.conformanceUnavailableHint": "Run conformance checking to see this metric.",
+  // Sparkline text alternative (#359). `Sparkline`'s own default alt text is more
+  // informative than the tile's own label — passing the label straight through
+  // overrode it and left a screen-reader user hearing the tile's name twice with no
+  // sense of the trend. `direction` is itself a resolved `t()` value (trendRising/
+  // Falling/Steady), composed into this template the same way `hiddenSummary`
+  // (abstraction-controls.tsx) composes two already-localized fragments.
+  "process.kpiStrip.trendAlt":
+    "{subject}, {periods}-period trend, {direction} from {first} to {last}",
+  "process.kpiStrip.trendRising": "rising",
+  "process.kpiStrip.trendFalling": "falling",
+  "process.kpiStrip.trendSteady": "steady",
 };

package/src/components/match-highlight/match-highlight.stories.tsx

@@ -4,7 +4,7 @@ import { Button } from "../button";
 import { MatchHighlight, queryToRanges } from "./match-highlight";
 
 const meta = {
-  title: "Typography/MatchHighlight",
+  title: "Display/MatchHighlight",
   component: MatchHighlight,
   tags: ["autodocs"],
   parameters: {

package/src/components/mention-input/mention-input-mirror.stories.tsx

@@ -25,6 +25,14 @@ import type { MentionOption, MentionValue } from "./mention-value";
  * lock that only holds when it runs alone is not a lock at all in CI — so it
  * gets its own story file, which the runner loads as its own test file.
  *
+ * It shares the `Forms/MentionInput` TITLE with the main story file so it reads
+ * as one sidebar entry rather than a sub-group of its own (RM-005). That is a
+ * sidebar concern only: `@storybook/addon-vitest` turns each story FILE into its
+ * own test file, so the isolation above survives the shared title. Do NOT
+ * "finish the job" by moving these stories into `mention-input.stories.tsx` —
+ * that is the exact co-residency the audit measured as green-with-the-bug (ADR
+ * 0023 §6).
+ *
  * ### What it pins
  *
  * Every box-affecting property of the field is nailed to absolute pixels, so
@@ -39,7 +47,7 @@ import type { MentionOption, MentionValue } from "./mention-value";
  * the test rather than argued for in a comment.
  */
 const meta = {
-  title: "Forms/MentionInput/Mirror re-measure",
+  title: "Forms/MentionInput",
   component: MentionInput,
   parameters: {
     docs: {