hcie-rust-v3.05/.mimocode/plans/1783749335099-nimble-moon.md

# Plan: Full egui → Iced Feature Port

## Scope

Port ALL egui GUI features to Iced. The egui GUI has:
- 11 dockable panels + document tabs
- 4 external panel crates (filters, AI chat, script, AI script)
- 14 modal dialogs
- 10 top-level menus
- 20 toolbox slots (30+ tools)
- Brush panel (30+ styles, 3 view modes)
- Color panel (HSL wheel, HSV square, palettes)
- Brush editor (4 tabs, live preview)
- Shell infrastructure (viewer, tablet, clipboard, themes)
- ~60 unique features total

---

## Phase 1: Fix Critical Bugs + Working Canvas (MUST DO FIRST)

**Files:** `app.rs`, `canvas/mod.rs`

### 1.1 Fix `ButtonPressed` → dispatch `CanvasPointerPressed`
- Add `last_cursor_pos: Option<(f32, f32)>` to `HcieIcedApp`
- Track cursor position in `CursorMoved` handler
- `ButtonPressed` dispatches `CanvasPointerPressed` using tracked position

### 1.2 Call `refresh_composite()` after every stroke
- After `CanvasPointerMoved` and `CanvasPointerReleased`, call `canvas::render::refresh_composite()`

### 1.3 Fix coordinate mapping with `mouse_area`
- Wrap canvas with `iced::widget::mouse_area`
- `on_press`, `on_move`, `on_scroll` provide widget-relative coords
- Simplify `screen_to_canvas` to just divide by zoom

### 1.4 Request repaint after state changes
- Return `iced::Task::perform(async {}, |_| Message::CompositeRefresh)` from drawing messages

### 1.5 Remove global subscription
- Remove `iced::event::listen_with`
- All events come from `mouse_area` on canvas

---

## Phase 2: Core Panels

### 2.1 Layers Panel
**File:** New `panels/layers.rs`

- Layer list with visibility toggle, opacity slider, blend mode selector
- Active layer highlighting
- Lock toggle
- Add/delete/merge down/flatten buttons
- Hierarchical group fold/collapse
- Reorder (move up/down buttons)
- Uses `engine.layer_infos()`, `engine.set_layer_visible()`, `engine.set_layer_opacity()`, `engine.set_layer_blend_mode()`, etc.

### 2.2 History Panel
**File:** New `panels/history.rs`

- Undo/redo timeline list
- Jump-to-history-index on click
- Shows `engine.history_description(idx)` for each entry
- Current position highlighting

### 2.3 Properties Panel
**File:** New `panels/properties.rs`

- Dynamic properties based on active tool
- Text tool: font, size, color, alignment
- Vector shapes: position, size, rotation, fill/stroke
- Brush: size, opacity, hardness

### 2.4 Brushes & Tips Panel
**File:** New `panels/brushes.rs`

- Brush preset browser with categories
- Grid/list/card view modes
- Brush style selection (30+ styles)
- Size/opacity/hardness sliders
- Rendered stroke preview
- Custom preset save/load
- Uses `engine.set_brush_tip()`, `engine.set_color()`, etc.

### 2.5 Color Palette Panel
**File:** New `panels/color_panel.rs`

- HSV saturation/value square
- Hue slider
- RGB sliders with numeric inputs
- Hex input
- Palette grid (saved swatches)
- Recent colors

### 2.6 Toolbar (Top)
**File:** New `panels/toolbar.rs`

- New/Open/Save buttons
- Undo/Redo buttons
- Zoom in/out/reset
- Active tool mode + size/opacity sliders
- Theme toggle

### 2.7 Status Bar (Bottom)
**File:** New `panels/status_bar.rs`

- Active tool name
- Canvas coordinates
- Zoom slider (logarithmic)
- Canvas dimensions

---

## Phase 3: Tool-Specific Panels

### 3.1 Text Editor Panel
**File:** New `panels/text_editor.rs`

- Font selector, size, color
- Alignment (left/center/right/justify)
- Orientation (horizontal/vertical)
- Text effects (rotation, warp, extrude)
- Accept/Cancel buttons

### 3.2 Vector Geometry Panel
**File:** New `panels/geometry.rs`

- List vector shapes on active layer
- Per-shape: position, size, rotation, fill, stroke, line cap
- Boolean operations between shapes

### 3.3 Layer Styles Panel
**File:** New `panels/layer_styles.rs`

- 10 style types with toggles
- Drop shadow, inner shadow, outer/inner glow
- Bevel/emboss, satin, color/gradient/pattern overlay, stroke
- Per-style parameter sliders and color pickers

### 3.4 Layer Details Panel
**File:** New `panels/layer_details.rs`

- Layer ID, name, fill opacity
- Clipping mask toggle
- Adjustment type display
- Effects list

---

## Phase 4: Filter System

### 4.1 Filters Panel (ported from `egui-panel-filters`)
**File:** New `panels/filters.rs`

- Category tree (Blur, Sharpen, Pixelate, Distort, Stylize, Color & Light, Restore, Noise & Pattern, Procedural Textures)
- Filter selection with bullet indicators
- Dynamic parameter panel via `iced-panel-adapter`
- Apply/Reset buttons
- Instant preview for applicable filters

### 4.2 Filter Dialogs
**File:** New `dialogs/filters.rs`

- Parameter dialogs for each filter category
- Uses `ModulePanel` + `render_module_panel()` from iced-panel-adapter

---

## Phase 5: Menus

### 5.1 Menu Bar
**File:** New `panels/menus.rs`

- File: New, Open, Save, Save As, Import, Export, Close, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Fill, Free Transform, Preferences
- Tools: All tool shortcuts
- Image: Adjustments, Image Size, Canvas Size, Rotation, Flip
- Layer: New, Delete, Merge Down, Flatten, Styles, Align
- Filter: All filter categories with submenus
- Select: All, Deselect, Invert, Grow, Shrink, Feather
- View: Zoom, Reset Pan, Panels submenu, Theme submenu
- Window: Documents list, Dock Layout
- Help: About

---

## Phase 6: Dialogs

### 6.1 New Image Dialog
### 6.2 Adjustments Dialog (Brightness/Contrast, HSL)
### 6.3 Close Confirm Dialog
### 6.4 Selection Operation Dialog
### 6.5 Settings/Preferences Dialog
### 6.6 Expand Canvas Dialog

---

## Phase 7: External Panel Crates

### 7.1 iced-panel-filters (port from egui-panel-filters)
- All 35+ filter definitions
- Parameter panels via iced-panel-adapter
- Instant preview integration

### 7.2 iced-panel-ai-chat (port from egui-panel-ai-chat)
- Streaming chat UI
- LLM connectivity (Ollama, OpenAI)
- Tool calling (execute on canvas)
- DSL script execution

### 7.3 iced-panel-script (port from egui-panel-script)
- Script editor with line numbers
- DSL parser and executor
- Command reference

### 7.4 iced-panel-ai-script (port from egui-panel-ai-script)
- AI-assisted script generation
- Multiple LLM providers

---

## Phase 8: Infrastructure

### 8.1 Tablet/Stylus Input
- Pen pressure via evdev or winit events
- Map pressure to stroke_to()

### 8.2 Clipboard
- Copy/paste images via arboard
- PNG clipboard support

### 8.3 File I/O
- Open/Save/Import/Export
- Recent files list
- Format support (PNG, JPG, WebP, PSD, KRA, HCIE native)

### 8.4 Themes
- 5 theme presets
- Theme switching at runtime

### 8.5 Multi-Document Tabs
- Tab bar for multiple open documents
- Tab switching

---

## Phase 9: Dock Layout

### 9.1 Pane Grid Layout
- Use iced's `PaneGrid` for dockable panels
- Panel drag-and-drop
- Panel resize
- Layout save/load

---

## Verification

After each phase:
1. `cargo build -p hcie-iced-gui` — compiles
2. `cargo run -p hcie-iced-gui` — visual verification
3. `cargo build -p hcie-gui-egui` — no regression