hcie-rust-v3.05/.mimocode/plans/1783771837559-curious-river.md

Iced GUI — Remaining Tasks & Reprioritized Plan

Current Status

The iced GUI has ~5000 lines across 33 source files. It compiles successfully (16 warnings, 0 errors). Major features are working: dock layout, toolbox with SVG icons, menu system, canvas with checkerboard, dialogs, keyboard shortcuts, brush params, selection, vector shapes, layer management, and theme system.

---

Completed (reference — do not re-do)

#	Feature	Status	Files
1	Dock PaneGrid with centered canvas	DONE	dock/state.rs, dock/view.rs
2	Brush params wired (size/opacity/hardness/style)	DONE	app.rs
3	Adjustment dialogs (Brightness/Contrast, HSL)	DONE	dialogs/adjustments.rs
4	Selection tool (rectangular drag)	DONE	app.rs
5	Vector shape drawing (Rect/Circle/Line)	DONE	app.rs
6	Keyboard shortcuts (Ctrl+Z/Y/S/N/O/C/V, Esc)	DONE	app.rs
7	CLI file open (load_path)	DONE	main.rs, app.rs
8	Filter parameters (FilterParamChanged)	DONE	app.rs
9	Menu system (9 menus, dropdown items)	DONE	panels/menus.rs
10	Multi-document tab bar	DONE	dock/view.rs
11	Theme system (5 presets, ThemeColors)	DONE	theme.rs, iced-panel-adapter/theme.rs
12	Custom title bar (app name, version, doc info)	DONE	panels/title_bar.rs
13	Properties, Layer Details, Geometry panels	DONE	panels/*.rs
14	SVG icons (64 icons, tool rendering)	DONE	sidebar/mod.rs
15	Checkerboard on canvas	DONE	canvas/mod.rs
16	Clickable color palette swatches	DONE	sidebar/mod.rs
17	Constant pressure for mouse input	DONE	app.rs
18	Toolbox expand/collapse (1→2 column)	DONE	sidebar/mod.rs
19	AI Chat panel (UI only)	DONE	panels/ai_chat_panel.rs
20	Layer Styles panel	DONE	panels/layer_styles.rs
21	Script/AI Script panels	DONE	panels/script_panel.rs, ai_script_panel.rs

---

Remaining Tasks (prioritized)

P0 — High Impact, Must Fix

1. Custom Window Frame (decorations: false)

Impact: Professional look, eliminates OS chrome mismatch Files: main.rs (L58-66), app.rs (view method), panels/title_bar.rs

Current: OS title bar is visible, custom title bar is redundant below it. Need:

• Set decorations: false in window settings
• Add Message::WindowDrag, WindowMinimize, WindowMaximize, WindowClose
• Use iced::window::drag(), minimize(), toggle_maximize()
• Merge menu bar INTO title bar (Photoshop-style: app name | menu items | window controls, all in one 28px bar)
• Title bar: make entire bar draggable, buttons on right side

2. Menu Dropdown as Overlay (not inline)

Impact: Menus currently push content down when opened Files: panels/menus.rs, app.rs

Current: Dropdown renders below the menu bar as a column![bar, dropdown], shifting all content down. Need:

• Wrap main content + dropdown in iced::widget::Stack
• Position dropdown absolutely at top-left
• Add mouse_area backdrop to close on click-outside
• Keep active_menu tracking (already exists)
• Style dropdown with proper hover states per item

3. Unused Warning Cleanup (16 warnings)

Impact: Code cleanliness, prevents confusion Files: panels/styles.rs, panels/text_editor.rs, theme.rs

Warnings:

• panel_header unused in styles.rs → use in dock title bars
• hover_item_bg unused → wire into menu/tool hover states
• menubar_background unused → use in menu bar container
• dropdown_background unused → use in menu dropdown
• view in text_editor.rs → wire into text tool
• set_preset in theme.rs → add theme switcher to menu

---

P1 — Important UX Polish

4. Menu Actions Fully Wired

Impact: Many menu items dispatch to NoOp or incomplete handlers Files: app.rs (MenuAction handler ~L1340-1410)

Missing wiring:

• Edit menu: Cut (X), Select All (A), Deselect (D), Fill
• Image menu: Canvas Size, Image Size, Rotate CW/CCW/180, Flip H/V, Crop to Selection
• Layer menu: Duplicate, Delete, Clear, Layer Styles, Align
• Filter menu: Color & Light (Levels, Vibrance, Exposure, Posterize, Threshold, Dehaze)
• Select menu: Grow, Shrink, Feather (open SelectionOp dialog)
• View menu: Fit to Window (auto-calc zoom), Debug Mode
• File menu: Export PNG, Export JPEG, Close

5. Hover States for Tool Buttons & Menu Items

Impact: No visual feedback on hover Files: sidebar/mod.rs, panels/menus.rs

Currently: Buttons use static styles, no hover highlight. Need:

• Track hover state via iced::widget::mouse_area.on_hover() or iced hover interaction
• Apply colors.bg_hover on hover for tool buttons and menu items
• iced 0.13: use button::on_hover() or style closure that checks Status::Hovered

6. Panel Title Bar Modernization

Impact: Current title bars use generic styling Files: dock/view.rs

Currently: Title bars show text + close/maximize buttons. Missing:

• Panel type icon (from SVG assets) next to title
• Close/maximize buttons should be hover-only (opacity change)
• Use colors.bg_hover for header background (not hardcoded)
• Remove the horizontal_rule(1) still used in some places

---

P2 — Functional Completeness

7. Text Tool Implementation

Impact: Text tool is placeholder (TODO handlers) Files: app.rs (CanvasPointerPressed handler), new panel

Currently: Text tool selected, but no text input UI. Need:

• When Text tool active + click on canvas: show text input overlay
• Track: text content, font size, font family, alignment, color
• On confirm: call engine.draw_text() to rasterize
• Messages: TextSizeChanged, TextColorChanged, TextAccept, TextCancel (exist but unused)

8. Brush Editor (Advanced Params)

Impact: Only basic brush params are exposed (size/opacity/hardness/style) Files: panels/brushes.rs

Currently: 3 sliders + 4 style buttons. Need:

• Spacing slider (already in ToolState but not in UI)
• Jitter slider
• Scatter slider
• Brush preview canvas (show brush tip shape)
• Brush presets list (save/load)

9. AI Chat Connection

Impact: AI panel shows UI but doesn't connect to any provider Files: panels/ai_chat_panel.rs, app.rs

Currently: Provider buttons (Ollama/Claude/OpenAI) dispatch NoOp. Need:

• Wire to hcie-engine-api AI client (Ollama compatible)
• Async HTTP requests via iced::Subscription or Task::perform
• Stream responses into message list
• Map AI commands to engine operations

10. Settings Dialog

Impact: No way to configure app settings Files: new: dialogs/settings.rs

Need:

• Theme selector (switch between 5 presets)
• Tablet pressure curve settings
• Default brush params
• Canvas background color
• Grid/snap settings

---

P3 — Nice to Have

11. Context Menu on Panel Titles

• Right-click to Pin, Float, Close panel
• Would require mouse_area with secondary click detection

12. Dock Profiles / Reset Layout

• Save/restore panel arrangements
• "Reset to Default" button in Window menu

13. Import SVG/PSD/KRA

• Wire file open dialog to engine.open_image() for more formats
• Currently supports PNG/JPG/WebP only via engine

14. Export PNG/JPEG

• Use engine.get_composite_pixels() + image::save_buffer()
• Wire to File > Export menu items

15. Undo/Redo Visual Feedback

• Highlight current position in history panel
• Show undo count in status bar

---

Execution Order (recommended next session)

Phase	Task	Est. Time
1	Custom window frame (decorations: false + draggable title bar)	45 min
2	Menu overlay (Stack-based dropdown)	30 min
3	Wire unused style functions + fix warnings	15 min
4	Wire all menu actions	30 min
5	Hover states for tool/menu items	20 min
6	Panel title icons + modernize	20 min
7	Text tool	45 min
8	Brush editor (spacing/jitter/scatter)	30 min

Total: ~3.5 hours for P0+P1+P2 first 3 items

---

Verification

1. cargo check -p hcie-iced-gui — 0 warnings, 0 errors
2. cargo run -p hcie-iced-gui — launch and verify:
   • No OS title bar, custom title bar with drag
   • Menu dropdowns overlay without pushing content
   • All menu items dispatch correct actions
   • Tool buttons highlight on hover
   • Panel titles show icons
3. Test drawing: brush, eraser, vector shapes, text
4. Test dialogs: New Image, Adjustments, Close Confirm
5. Test dock: drag panels, resize splits, close/maximize