chore(conductor): Add new track 'UI Theme Overhaul & Style System'

This commit is contained in:
2026-03-08 13:01:14 -04:00
parent 5e6a38a790
commit 711750f1c3
5 changed files with 116 additions and 17 deletions

View File

@@ -0,0 +1,5 @@
# Track ui_theme_overhaul_20260308 Context
- [Specification](./spec.md)
- [Implementation Plan](./plan.md)
- [Metadata](./metadata.json)

View File

@@ -0,0 +1,8 @@
{
"track_id": "ui_theme_overhaul_20260308",
"type": "feature",
"status": "new",
"created_at": "2026-03-08T13:00:00Z",
"updated_at": "2026-03-08T13:00:00Z",
"description": "Improve default font (Inter/Maple Mono), implement professional subtle rounded theme using imgui-bundle, custom shaders (corners, blur, AA), multi-viewport toggle, and layout presets."
}

View File

@@ -0,0 +1,43 @@
# Implementation Plan: UI Theme Overhaul & Style System
## Phase 1: Research & Typography
- [ ] Task: Research `imgui-bundle` text rendering and theme APIs.
- [ ] Identify the best way to load and render high-quality fonts (Inter/Maple Mono).
- [ ] Check for Freetype support or specialized rendering forks within the current environment.
- [ ] Task: Implement Professional Typography.
- [ ] Integrate Inter and Maple Mono font assets.
- [ ] Update the font loading logic in `src/gui_2.py` (or a dedicated theme module).
- [ ] Verify font rendering quality and scaling across the UI.
- [ ] Task: Conductor - User Manual Verification 'Phase 1: Research & Typography' (Protocol in workflow.md)
## Phase 2: Professional Style & Theming
- [ ] Task: Implement the "Subtle Rounding" Professional Theme.
- [ ] Define the professional color palette and style variables (rounding, padding, spacing).
- [ ] Utilize `imgui-bundle`'s styling APIs to apply the theme globally.
- [ ] Refactor existing hardcoded styling in `src/gui_2.py` to use the new theme system.
- [ ] Task: Write visual regression tests or simulation scripts to verify the new theme's consistency.
- [ ] Task: Conductor - User Manual Verification 'Phase 2: Professional Style & Theming' (Protocol in workflow.md)
## Phase 3: Advanced Visual Effects (Shaders)
- [ ] Task: Implement Custom UI Shaders.
- [ ] Develop and integrate shaders for rounded window corners and soft shadows.
- [ ] Develop and integrate shaders for glass/acrylic (blur) effects on selected panels.
- [ ] Develop and integrate shaders for improved text anti-aliasing.
- [ ] Task: Perform a performance audit to ensure shaders do not degrade FPS.
- [ ] Task: Conductor - User Manual Verification 'Phase 3: Advanced Visual Effects (Shaders)' (Protocol in workflow.md)
## Phase 4: Layout Management & Multi-Viewport
- [ ] Task: Implement Multi-Viewport Support.
- [ ] Add the "Multi-Viewport" toggle checkbox to the main menu bar.
- [ ] Ensure the application correctly handles panel detachment and re-attachment.
- [ ] Task: Implement UI Layout Presets.
- [ ] Create a management system (Save/Load/Delete) for window layout presets.
- [ ] Ensure presets capture window geometry and the Multi-Viewport state.
- [ ] Persist layout presets to the project configuration (`manual_slop.toml` or a dedicated file).
- [ ] Task: Verify layout restoration accuracy across multiple presets.
- [ ] Task: Conductor - User Manual Verification 'Phase 4: Layout Management & Multi-Viewport' (Protocol in workflow.md)
## Phase 5: Final Polish & Verification
- [ ] Task: Conduct a final UI audit for "professionalism" and consistency.
- [ ] Task: Run the full simulation suite to ensure no regressions in tool interaction or workflow.
- [ ] Task: Conductor - User Manual Verification 'Phase 5: Final Polish & Verification' (Protocol in workflow.md)

View File

@@ -0,0 +1,39 @@
# Specification: UI Theme Overhaul & Style System
## Overview
This track aims to modernize the application's appearance by implementing a professional, high-fidelity UI theme using `imgui-bundle`'s native styling and theming capabilities. It focuses on improving typography, visual shapes, and introducing advanced features like custom shaders, multi-viewport support, and user-managed layout presets.
## Functional Requirements
- **Professional Typography:**
- Replace the default ImGui font with a high-quality, professional font family (e.g., **Inter** or **Maple Mono**).
- Implement proper font scaling and anti-aliasing.
- **Style & Theming System:**
- Utilize `imgui-bundle`'s recommended styling APIs to define a cohesive "professional" theme.
- Implement a "Subtle Rounding" aesthetic for windows, buttons, and other UI elements.
- Research and implement the latest text rendering techniques supported by `imgui-bundle` or its forks (e.g., Freetype integration).
- **Advanced Visual Effects (Shaders):**
- Explore and implement custom shaders for:
- Rounded window corners and soft shadows.
- Glass/Acrylic (blur) effects for panels.
- Improved text anti-aliasing via specialized shaders.
- **Multi-Viewport Support:**
- Add a toggle in the main menu bar to enable/disable ImGui's **Multi-Viewport** feature (allowing panels to be dragged outside the main application window).
- **UI Layout Presets:**
- Implement a system for users to save and manage custom window layouts.
- Layout presets must capture window positions, sizes, and the current **Multi-Viewport** state.
## Non-Functional Requirements
- **Performance:** Ensure that custom shaders and advanced rendering do not significantly impact the application's frame rate (FPS).
- **Compatibility:** The new theme and style system must be compatible across all supported platforms (win32).
- **Reliability:** Layout presets must be persisted correctly and restored accurately.
## Acceptance Criteria
- [ ] The default font is changed to Inter or Maple Mono with high-quality rendering.
- [ ] The UI has a consistent "Subtle Rounding" aesthetic across all standard widgets.
- [ ] A "Multi-Viewport" toggle is available in the menu bar and works as expected.
- [ ] Users can save multiple window layout presets and switch between them.
- [ ] Custom shaders are implemented for at least one major effect (e.g., rounded corners or acrylic blur) without degrading performance.
## Out of Scope
- Complete redesign of the Hub-based layout logic (only styling/theming).
- Cloud-based layout synchronization.