docs(mapgen-studio): JSDoc the load-bearing seams + honest-boundary notes

[mateicanavra]

P7 idiom wave: engine-contract JSDoc (StudioEngines, the Run-in-Game
orchestrator incl. the materialization-proof correctness boundary), the
authored-setup-state contract on Civ7StudioSetupConfig, documented
deliberate-opacity casts at the oRPC read seam (+ observedAt fallback
parity), and a stale Game-bar comment fix. Deliberately NOT folding the
per-feature oRPC error envelopes into one helper (distinct shapes; native
oRPC error-handling refactor tracked separately).

[mateicanavra]

• refactor(mapgen-studio): Water proof ledger → Water stats section; P7 ledger entry #1672
• refactor(studio-server): oRPC-native typed contract errors — declared .errors() maps, host-context defined-error mapping, client safe()/isDefinedError; delete all error wrappers #1671
• feat(mapgen-studio): config explorer v2 — flat nested accordion, wells retired #1670
• fix(mapgen-studio): status chip drops the seed suffix when the Game bar narrows #1669
• docs(mapgen-studio): JSDoc the load-bearing seams + honest-boundary notes #1668 👈 (View in Graphite)
• feat(mapgen-studio): wire the Explore command — live map reveal via canonical display.explore.request #1667
• feat(mapgen-studio): Water proof inspector — river/lake/floodplain truth lanes re-expressed in the ExplorePanel #1666
• fix(mapgen-studio): saved config launches exactly — selection replaces studio setup state, any drift shows Custom #1665
• chore(studio): post-main-restack reconciliation — regenerate bun.lock, port engines to the rivers deploy plan + content-marker proof gate, retarget save/deploy client types, restore studio-server test script #1664
• feat(mapgen-studio): Game bar v3 — gear setup disclosure, one combined status chip + hang-off popup (Bug diagnostics), ScanEye explore, play-in-loop autoplay glyph, Rocket Play CTA #1663
• feat(mapgen-studio): flat config accordion — full-bleed stage rows, recessed expansion slab + Y-wave system.md amendment and ledger #1662
• fix(mapgen-studio): tile grid reads at every zoom — fill-derived border ink + grid-preferring layer default #1661
• feat(mapgen-studio): saved-config precedence — drift detection + orange Modified affordance with click-to-resync #1660
• fix(mapgen-studio): run-in-game proof matches again — turbo passes SWOOPER_STUDIO_RUN_ID through the cached build + fail-fast bundle guard #1659
• docs(mapgen-studio): effect-native substrate spike — verdict: keep the hand-rolled shell, revisit at Effect v4 stable #1658
• feat(mapgen-studio): wire the shared tuner session through the daemon — one connection, health surface, scoped shutdown #1656
• feat(studio-server): Civ7TunerSession — Effect-scoped owner of the shared tuner connection + backoff gate #1655
• feat(direct-control): caller-owned shared session seam + graceful FIN close + timeout stats #1654
• feat(mapgen-studio): standalone Bun daemon owns the server surface — vite is frontend-only; legacy /api retired outright #1652 : 1 other dependent PR (#1653 )
• 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
• 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, 10:46 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jun 12, 11:11 PM UTC: Graphite rebased this pull request as part of a merge.
• Jun 12, 11:11 PM UTC: @mateicanavra merged this pull request with Graphite.