Files
galaxy-game/ui/docs
Ilia Denisov 4a23c357e5
Tests · UI / test (push) Waiting to run
Tests · UI / test (pull_request) Waiting to run
feat(ui): F8-05 — game-mode chrome cleanup + inspector compact rows (#48)
Drains six F8 polish items (parent #43) in one feature:

а) Chrome cleanup
- п.6 — remove the AccountMenu (settings/sessions/theme/language/logout
  ∼ rudimentary in-game) and replace it with a single icon-button
  light/dark theme toggle. The toggle flips an in-memory `theme.override`;
  game-shell unmount calls `theme.clearOverride()` so the lobby (and
  any re-entry) re-projects the persisted lobby choice.
- п.8 — remove the wrap-scrolling radio from the map gear popover. The
  per-game `wrapMode` store and the renderer's no-wrap path stay in
  place for a future engine-side topology feature; only the UI surface
  is dropped (wrap is a server-side concept, not a per-session UI
  affordance).

б) Inspector compact rows (single idiom: select + ✓ apply / ✗ cancel,
or contextual edit/remove/add)
- п.13 — planet name is now click-to-edit: clicking the name opens an
  inline `<input>` + ✓ confirm icon; Escape cancels; the explicit
  Rename action button and Cancel button are gone.
- п.14 — production becomes one row: primary `<select>` picks
  industry/materials/research/ship, conditional secondary `<select>`
  picks the target (tech / science / ship class) for research and
  ship contexts. Apply is gated until row state differs from the
  planet's current effective production; auto-submit-on-click is
  replaced by the apply-gate.
- п.16 — cargo routes collapse to one row: a single dropdown
  (COL/CAP/MAT/EMP plus a placeholder that absorbs the old section
  title) and contextual action buttons (add / edit + remove) to the
  right. After a successful pick or remove the dropdown stays on the
  type the user just acted on.
- п.32 — stationed ship groups hoist the race column into a dropdown
  above the table. The dropdown seeds with the player's own race when
  local groups are stationed here, otherwise the first race
  alphabetically; rendered only when more than one race is in orbit.
  The race column is dropped in both single- and multi-race modes —
  the dropdown's value already names the active race.

Tests: unit and Playwright e2e updated for every changed test-id and
flow; new coverage added for `theme.override`, the in-game toggle, the
apply-gate behaviour, and the stationed-race dropdown. i18n keys for
the removed menu items, the wrap radios, the cargo title, and the
explicit `rename.cancel` are dropped from both locales; new
`game.shell.theme_toggle.*`, `production.main/target.*`,
`production.apply/cancel`, `cargo.placeholder`, and
`ship_groups.race_filter.aria` keys land.

Docs synced: `docs/FUNCTIONAL.md` §6.7 + `docs/FUNCTIONAL_ru.md`
mirror drop the torus / no-wrap radio mention; `ui/docs/design-system.md`
documents the lobby-owned persisted picker + the in-game ephemeral
override channel.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 13:38:42 +02:00
..
2026-05-07 07:18:55 +02:00

UI client — topic docs

Deeper, topic-based documentation for the Galaxy web/cross-platform UI client, beyond what fits in ../README.md. Each file describes how one area works (current state); the staged build history lives in ../PLAN.md, the active web finalization in ../PLAN-finalize.md, and deferred work in ../ROADMAP.md.

Foundation & platform

  • design-system.md — the design tokens (colour / spacing / typography), the light/dark theming mechanism, and the component migration conventions.
  • a11y.md — the WCAG 2.2 AA approach: axe + keyboard test gates, the shared a11y primitives, coverage by area, and the map-canvas alternative.
  • error-state-ux.md — the central error surface (taxonomy → translated/actionable messages), the shared ViewState placeholder, the selected-planet ring, and bottom-sheet dismissal.
  • navigation.md — routes, the sidebar tabs, and the state-preservation rules across view/tab switches.
  • storage.md — the KeyStore and Cache abstractions and their web (IndexedDB) implementations.
  • game-state.md — decoding the FlatBuffers report into GameReport and the GameState / rendered-report stores.
  • sync-protocol.md — order-draft sync, turn cutoff, conflict handling, and auto-pause.
  • events.md — the signed push channel and event handling.
  • calc-bridge.md — the pkg/calc → WASM → TypeScript bridge, with the live function surface and parity rules.
  • wasm-toolchain.md — building ui/core to core.wasm with TinyGo.
  • pwa-strategy.md — the installable/offline PWA: the native service worker, manifest, icons, and the Playwright PWA gate.
  • testing.md — the UI test layers (Vitest + Playwright).

Auth & lobby

  • auth-flow.md — device keypair, email-code login, and request signing on the client.
  • lobby.md — the lobby/game-list UI and membership flows.

Map & active views

Tools & inspectors

Combat & comms

Localisation

  • i18n.md — the localisation mechanism and translation bundles.