feat(mapgen-studio): token-driven chrome, a11y landmarks/live-regions/aria, and OptionSelect adapter

[mateicanavra]

This PR delivers a presentation and accessibility pass over the Mapgen Studio chrome. No behavior, data contracts, or generation logic are changed.

Accessibility

AppFooter diagnostics restored for assistive tech and static markup. The prior Radix Tooltip migration moved operational diagnostics (Run-in-Game request id, failure reason, save/deploy status, live-sync hint, autoplay hint) into hover-only TooltipContent, making them invisible to screen readers and absent from static markup. Each diagnostic is now mirrored onto its visible trigger via aria-label and an in-DOM title. The footer wraps its own TooltipProvider so hints work in bare-mount test contexts without an ancestor provider, fixing the 8 previously-failing static-markup parity assertions.

Landmark structure and skip link. The deck.gl canvas host is wrapped in <main aria-label="Map preview">. The left and right docks are rendered as <aside> elements with descriptive labels. A visually-hidden skip-to-main link is the first focusable element in the shell.

Live regions. ErrorBanner gains role="alert" and aria-live="assertive". A visually-hidden aria-live="polite" region in StudioShell mirrors the volatile run/live/operation status without stealing focus.

Disclosure and selection state. aria-expanded and aria-controls are added to the collapsible section headers in ExplorePanel (Stage, Step, Layers), RecipePanel (Recipe, Config), and AppHeader (Setup). Active Stage, Step, and Layer items expose aria-current; render-mode and space toggle buttons expose aria-pressed.

Token-driven controls

OptionSelect adapter. A thin OptionSelect component wraps the token-driven Radix Select (src/components/ui/select) behind the simple value/onValueChange/options shape the legacy native <select> used. Empty option values map to an internal sentinel so Radix's non-empty value requirement is satisfied while the visible placeholder and emitted values are unchanged.

AppHeader and RecipePanel selects migrated. World Size, Players, Config, Resources, Leader, Civilization, Difficulty, and Game Speed dropdowns in AppHeader, and the Recipe and Config dropdowns in RecipePanel, all move from the legacy lightMode native select to OptionSelect. The lightMode prop is dropped from these call sites.

RJSF override widgets re-skinned. TextWidget, TextareaWidget, NumberWidget, SelectWidget, CheckboxWidget, SwitchWidget, and TagSelectWidget are rebuilt on the src/components/ui primitives. The lightMode prop and off-token ring-gray-400 are removed. The SelectWidget uses the same sentinel mapping as OptionSelect. Enum-to-typed-value mapping and emptyValue normalization are preserved byte-for-byte.

Stage craft and type scale

Token-referenced CanvasStage backdrop. The hard-coded lightMode hex ternary for the backdrop is replaced with bg-background. The radial vignette and grid are drawn using --muted-foreground at low alpha (luminance, not chroma). lightMode is still forwarded to DeckCanvas because it governs deck.gl scene rendering.

"Awaiting matter" empty state. The bare centered "Click Run to generate a map" text is replaced with a contour-framed panel over a coarse graticule field, so the empty stage reads as a ready survey console rather than dead space.

Named type scale. Ad-hoc text-[10px] and text-[11px] utilities in AppHeader, RecipePanel, and ExplorePanel adopt the text-label and text-data tokens.

Dead code removed

The unused src/ui/components/ui/AlertDialog.tsx (a hand-rolled re-implementation with no importers) and its barrel re-export are deleted.

[github-actions]

Railway preview (MapGen Studio): not provisioned for this PR.

Policy (Graphite stacks): previews are created only for the top-of-stack PR by default.

• To force a preview for this PR: add label railway-preview
• To suppress a preview: add label no-railway-preview

Debug: {"isClosed":false,"isFork":false,"suppress":false,"force":false,"isTopOfStack":false,"hasToken":true,"draft":false}

[mateicanavra]

• feat(mapgen-studio): standalone Bun daemon owns the server surface — vite is frontend-only; legacy /api retired outright #1652 : 2 dependent PRs (#1653 , #1654 )
• refactor(mapgen-studio): control-oRPC mount on the fetch adapter behind a Connect shim #1651
• refactor(mapgen-studio): extract studio engines out of vite.config into src/server/studio (verbatim move, no topology change) #1650
• docs(mapgen-studio): bun-server workstream frame — P5b cutover proposal/design/tasks/spec (strict valid) #1649
• fix(mapgen): projection step phases carry their subject domain, not 'gameplay' #1648
• refactor(mapgen-studio): recipe-dag oRPC mount — fetch adapter, per-request ssrLoadModule, shared node⇄web bridge #1647
• feat(mapgen-studio): add Pipeline stage view with Map|Pipeline switcher, TanStack Query DAG data layer, and token-driven PipelineStage chrome #1646
• docs(mapgen-studio): add pipeline DAG stage-view workstream record, proposal, design, spec deltas, and tasks #1645
• docs(mapgen-studio): mark X6 and X7 as executed with hex-convention audit and world-console map-params revision notes #1644
• feat(mapgen-studio): remove Resources control from World console, codify pipeline-input zone boundary rule #1643
• fix(studio): render game's odd-R hex geometry for both tile spaces and retune tile border to graphite #1642
• docs(mapgen-studio): record Pass-5 design fixes (toolbar v2, tile orientation, grid icon, flash guard, pre-run cursor) #1641
• fix(mapgen-studio): apply flash guard to :root for between-navigations clear color #1640
• feat(mapgen-studio): disable canvas controller and grab cursor pre-run #1639
• fix(mapgen-studio): odd-Q flat-top orientation, canonical hex-space lattice, and tile-mesh contract #1638
• fix(mapgen-studio): replace empty grid toggle placeholder with Grid3x3 lucide icon #1637
• feat(mapgen-studio): toolbar architecture v2 — top = Game bar, bottom = World/Map console with History affordance #1636
• docs(mapgen-studio): add Pass 5 design-fixes spec (toolbar architecture v2, tile orientation, canvas affordances) #1635
• feat(mapgen-studio): add collapsible config objects with per-object header anatomy, sticky auto-expand-on-scroll toggle, and useConfigCollapse hook #1634
• feat(mapgen-studio): icon-only autoplay and run-in-game buttons, add Explore placeholder #1633
• feat(studio): dock game console beneath world bar, remove it from footer #1632
• docs(mapgen-studio): add Pass-4 design fixes — game console dock, console icon contract, and config collapse #1631
• feat(explore-toolbar): regroup into VIEW/LAYER clusters and relocate debug toggle to data list header #1630
• feat(mapgen-studio): extract GameConsole component and split footer into centered studio console and right-docked game console #1629
• feat(mapgen-studio): replace border-l indent ladder with page-tint well surface and codify 4/8/12px rhythm tiers #1628
• docs(mapgen-studio-no-hardcoded-defaults): mark all tasks as executed #1627
• fix(mapgen-studio): replace global reset with body-only flash guard and align theme bootstrap with useTheme system-preference resolution #1626
• docs(mapgen-studio): pass-3 frame — spacing substrate repair, config surface elevation, footer console split, explore toolbar grouping, and no-hardcoded-defaults law #1625
• fix(mapgen-studio): sync .dark class to theme preference at runtime #1624
• fix(mapgen-studio): add rAF backstop timeout to prevent viz commits being starved in backgrounded documents #1623
• feat(mapgen-studio): wrap Render and Space toolbar options in segmented controls #1622
• feat(mapgen-studio): remove Run button from RecipePanel footer, promote Save & Deploy to full-width, and expand resource mode labels #1621
• fix(mapgen-studio): split field label to foreground tier and gate error live regions on rawErrors #1620
• feat(mapgen-studio): pin docks between header and footer with bottom constraint, pointer-events pass-through, and LAYOUT geometry update #1619
• docs(mapgen-studio): add pass-2 design-fix frame, five OpenSpec slices (layout geometry, form hierarchy, run console, explore toolbar, first-run visibility) #1618
• feat(studio): a11y fixes — Radix save menu, rjsf error association, skip-link target, and group disclosure names #1617
• refactor(mapgen-studio): remove legacy createTheme/lightMode prop threading and dead field primitives; migrate rjsf chrome to design-system tokens #1616
• refactor(mapgen-studio): centralize ORPCError data cast, drop dead success fallbacks, and narrow router to contract-derived type #1615
• feat(mapgen-studio): migrate authoring/run state to Zustand persist stores, reads to TanStack Query, and fix runInGame contract selectedConfig.id optional #1614
• feat(mapgen-studio): token-driven chrome, a11y landmarks/live-regions/aria, and OptionSelect adapter #1613 👈 (View in Graphite)
• fix(mapgen-studio): wrap AppFooter test in TooltipProvider and add @ alias to vitest config #1612
• feat(mapgen-studio): decompose App.tsx into StudioProviders/StudioShell + chrome tree #1611
• feat(mapgen-studio): migrate client transport to oRPC, add TanStack Query client, and introduce Zustand viewStore #1610
• feat(studio-server): implement effect-orpc router, mount /rpc, and add typed client with TanStack Query utils #1609
• refactor(studio): decompose App.tsx non-React corpus into feature modules and shared utilities #1608
• refactor(studio): reskin shell chrome onto design tokens, shadcn primitives, and sonner toast #1607
• feat(mapgen-studio): add canonical token-driven shadcn primitive library with Radix UI and sonner #1606
• docs(studio): add control-oRPC seam doc, thin LiveControlPort adapter design, and re-baseline server-contract audit + target architecture for live-read surface #1605
• feat(mapgen-studio): Tailwind v4 + shadcn design system foundation — tokens, .dark theming, substrate elevation, self-hosted fonts #1657
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[mateicanavra]

Merge activity

• Jun 12, 8:50 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jun 12, 9:09 PM UTC: Graphite rebased this pull request as part of a merge.
• Jun 12, 9:09 PM UTC: @mateicanavra merged this pull request with Graphite.