Appearance
Simulator style tokenization plan (2026-03-11)
Background
The simulator UI had repeated hardcoded style values across multiple Vue components. This made global visual adjustments slow and error-prone.
Goal and scope
This iteration standardizes simulator styling by consolidating visual values into shared CSS variables and updating components to consume those tokens.
In scope:
- Tokenize colors, typography, spacing, radius, shadows, and transitions.
- Replace component-level hardcoded values with
--mp-*variables. - Keep existing interaction behavior and layout intent unchanged.
Out of scope:
- Functional changes in map rendering/runtime/event logic.
- Broad redesign of non-simulator surfaces.
Chosen approach
- Extend the token set in
SimulatorMapPlayground.vueroot to define a single source of truth for simulator visual language. - Refactor simulator component style blocks to reference shared tokens for controls, chips, panels, inputs, dialogs, and empty states.
- Add explicit token-first guidance to
AGENTS.mdto prevent future style-value drift.
Impacted files/modules
src/simulator/components/SimulatorMapPlayground.vuesrc/simulator/components/SimulatorActionBar.vuesrc/simulator/components/SimulatorEditorDialog.vuesrc/simulator/components/SimulatorEventItem.vuesrc/simulator/components/SimulatorEventsPanel.vuesrc/simulator/components/SimulatorInputField.vuesrc/simulator/components/SimulatorInspectorPanel.vuesrc/simulator/components/SimulatorParsedPanel.vuesrc/simulator/components/SimulatorPreviewPanel.vuesrc/simulator/components/SimulatorRoomSelectionPanel.vuesrc/simulator/components/SimulatorRuntimeField.vuesrc/simulator/components/SimulatorRuntimeGroup.vuesrc/simulator/components/SimulatorRuntimePanel.vuesrc/simulator/components/SimulatorTabs.vueAGENTS.md
Verification checklist
- [ ] Run
npm run lint. - [ ] Run
npx tsc --noEmit. - [ ] Confirm simulator buttons/chips/panels still render with expected states.
- [ ] Confirm logger toggle and session import/export controls keep behavior.