docs(mapgen-studio): add Pass-4 design fixes — game console dock, console icon contract, and config collapse

[mateicanavra]

This PR establishes the Pass 4 design frame for Mapgen Studio, documenting three user-grounded fixes and recording the decisions behind each.

Game console dock (E1): The Game console moves from the bottom-right footer to a slot directly beneath the world bar in AppHeader. The top zone now reads as "game" (world definition inputs + live game console) and the bottom zone as "studio" (the iteration loop). Option A — merging everything into one top bar — was ruled out after measuring the live app at 1600px, where the two bars together exceed available width and the instrument/settings kind mismatch would destroy the Pass 3 ownership boundary. The existing header height observer already reflows side panels, so the dock is a slot composition with no new measurement machinery.

Console icon-only contract (E2): Secondary repeated-use actions in dense consoles become icon-only and must carry aria-label + title + Tooltip. Auto-play start switches from Bot to FastForward (the game-UI convention for self-advancing play), Run in Game switches to SquareArrowOutUpRight (open-out semantics), and a disabled Binoculars placeholder is added for the forthcoming Explore action. Eye is reserved for layer-visibility toggles. Primary CTAs (Run, Save & Deploy, Setup) keep their labels.

Config object collapse (E3): Every config object gains a per-object header row (chevron + title + trailing action zone) and collapses by default. A sticky auto-expand toggle is added to the config toolbar, defaulting OFF. The header row is the intended future home for object-local Reset and Show-JSON actions. This applies identically in focused and unfocused modes.

The four stacked slices that implement these changes are pass4-frame, game-console-dock, game-console-icons, and config-collapse, each verified with OpenSpec --strict, tsc, vitest, and live visual proof.

[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 👈 (View in Graphite)
• 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
• 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:45 PM UTC: Graphite rebased this pull request as part of a merge.
• Jun 12, 9:45 PM UTC: @mateicanavra merged this pull request with Graphite.