feat: v0.7.0 Monorepo & Paint Enhancements

- Phase 26: pnpm monorepo scaffold (app/ rename, workspace config)
- Phase 33: 3-mode paint system (flat/FX/physical), inline 4-mode color
  picker (Box/TSL/RVB/CMYK), FX wireframe overlay, stroke draw-reveal
  animation, circle cursor, brush persistence, undo/FX cache fixes

Phases 27-32 (engine adapter approach) abandoned — deferred to v0.8.0.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: electroheadfx

.planning/MILESTONES.md

@@ -1,5 +1,37 @@
 # Milestones
 
+## v0.7.0 Monorepo & Paint Enhancements (Shipped: 2026-04-05)
+
+**Phases completed:** 2 phases, 23 plans, 40 tasks
+
+**Key accomplishments:**
+
+- Renamed Application/ to app/ via isolated git mv with full --follow history, moved lockfile to workspace root, updated .gitignore for monorepo paths
+- 1. [Rule 1 - Bug] Removed redundant pnpm.onlyBuiltDependencies from paint package.json
+- Full monorepo verification suite — 8 automated checks passed, dev server and Tauri build confirmed working
+- Fixed all undo/redo rendering bugs with _notifyVisualChange + FX cache invalidation, enabled immediate FX brush drawing, and implemented 4 UX quick wins (auto-enter paint mode, no-confirm clear, orange exit button, sidebar reorder)
+- Brush color/size persist via LazyStore with #203769/35px defaults, plus circle cursor overlay that scales with zoom
+- Realtime color picker without Apply/Cancel buttons, no dark overlay, positioned near mouse click with bounds clamping
+- 3-mode paint system with flat/FX exclusivity, conversion dialogs, transparent flat background, and layer blend/opacity controls in paint edit mode
+- 4-mode inline color picker (Box HSV/TSL/RVB/CMYK) with HEX input, recent + favorite swatches persisted via LazyStore
+- Dashed wireframe path and bounding box overlay for selected FX strokes with expanded bounding-box hit testing
+- Speed-based stroke animation distributing points across frames with inverse distance weighting and atomic single-Cmd+Z undo
+- Fixed infinite re-render loop in InlineColorPicker via useRef guard and restored blend mode functionality in paint edit mode
+- FX cache invalidation on clearFrame/color change, color-aware cache keys, activePaintMode with persistence, and mode-aware white/transparent background
+- Fixed cursor position offset with high-contrast visibility, strengthened exit button pulsate, modal conversion dialog with dark overlay, and multi-stroke animation support
+- InlineColorPicker relocated from sidebar to canvas-adjacent panel with shared paintStore signal for cross-component visibility control
+- Per-layer paint mode with brushStyle reset on mode switch, frame content inference, and flat-to-FX stroke batch conversion
+- Exit Paint Mode button pulsate animation replaced with glow-only effect (orange-to-red background + box-shadow), scale bounce removed
+- Await initFromPreferences before render so brush color/size persist across restart
+- paintVersion bump after FX cache refresh in setBrushColor triggers immediate preview re-render without requiring pointer movement
+- Fixed circle cursor centering by calculating cursorPos relative to overlayRef instead of containerRef
+- Auto-set white bg on FX mode switch with per-frame bgColor persistence in paint sidecar JSON
+- Removed createPortal and fixed positioning from InlineColorPicker so it renders inside the CanvasArea 260px flex container
+- CSS linear-gradient backgrounds on TSL/RVB/CMYK slider tracks with rAF-throttled drag for smooth interaction
+- Simplified brush stroke hit testing to bbox-only selection and verified wireframe renders for all brush types
+
+---
+
 ## v0.6.0 Various Enhancements (Shipped: 2026-04-03)
 
 **Phases:** 4 (Phases 22-25) | **Plans:** 14 | **Tasks:** 28

.planning/PROJECT.md

@@ -88,32 +88,25 @@ Users can import key photographs, arrange them into timed sequences with FX laye
 - ✓ Bezier/spline stroke path editing with anchor/handle manipulation — v0.6.0
 - ✓ Add, move, and delete bezier control points on existing strokes — v0.6.0
 - ✓ Stroke list panel with drag-reorder, delete, selection sync, and visibility toggle — v0.6.0
+- ✓ Paint undo/redo FX cache invalidation and visual refresh for all operations — v0.7.0 Phase 33
+- ✓ Brush preferences persistence (color, size) with session restore — v0.7.0 Phase 33
+- ✓ Circle cursor overlay at brush size with zoom scaling — v0.7.0 Phase 33
+- ✓ 3-mode paint system (flat/FX/physical-placeholder) with per-frame mode exclusivity — v0.7.0 Phase 33
+- ✓ Inline color picker with 4 modes (Box/TSL/RVB/CMYK) and swatches — v0.7.0 Phase 33
+- ✓ Modal color picker: no buttons, no overlay, positioned near mouse — v0.7.0 Phase 33
+- ✓ FX stroke wireframe overlay for selection visibility — v0.7.0 Phase 33
+- ✓ Stroke draw-reveal animation with speed-based distribution — v0.7.0 Phase 33
+- ✓ Inline color picker positioned adjacent to canvas (left panel, 260px) — v0.7.0 Phase 33
 
 ### Active
 
-- [ ] pnpm monorepo scaffold with `app/` and `packages/efx-physic-paint/`
-- [ ] Replace `perfect-freehand` + `p5.brush` with `@efxlab/efx-physic-paint` physics brush engine
-- [ ] Connect existing paint features to new engine API (strokes, FX styles, eraser, onion skinning)
-- [ ] Paper/canvas texture support via `efx-physic-paint`
-- [ ] Transparency layer support via `efx-physic-paint`
-- [ ] New JSON brush format integration
-- [ ] Brush caching, re-render, and physics integration
-- [ ] Adapt `efx-physic-paint` API for editor-specific requirements
+- [ ] efx-physic-paint as standalone window with transport to editor (v0.8.0)
 
-## Current Milestone: v0.7.0 Pure Monorepo & Paint Engine Swap
+## Latest Milestone: v0.7.0 Monorepo & Paint Enhancements (Shipped 2026-04-05)
 
-**Goal:** Convert to pnpm monorepo with `efx-physic-paint` as a workspace package, then replace the `perfect-freehand` + `p5.brush` painting engine with the new physics-based paint engine.
+2 completed phases (26, 33), 23 plans, 112 commits. Phases 27-32 failed (adapter approach abandoned — efx-physic-paint deferred to v0.8.0 as standalone window). See `.planning/MILESTONES.md` for details.
 
-**Target features:**
-- Monorepo scaffold: root `package.json`, `pnpm-workspace.yaml`, lockfile migration, rename `Application/` to `app/`, copy `efx-physic-paint` into `packages/`
-- Replace `perfect-freehand` + `p5.brush` with `@efxlab/efx-physic-paint` brush engine (physics, transparency, animation support)
-- Connect existing paint features (stroke rendering, FX brush styles, eraser, onion skinning) to the new engine API
-- Paper/canvas texture support and transparency layers via `efx-physic-paint`
-- Brush caching, re-render, and physics integration
-- New JSON brush format support
-- Adapt `efx-physic-paint` API where needed for editor-specific requirements
-
-## Latest Milestone: v0.6.0 Various Enhancements (Shipped 2026-04-03)
+## Previous Milestone: v0.6.0 Various Enhancements (Shipped 2026-04-03)
 
 4 phases, 14 plans over 8 days. See `.planning/MILESTONES.md` for details.
 
@@ -130,13 +123,11 @@ Users can import key photographs, arrange them into timed sequences with FX laye
 
 ## Context
 
-Shipped v0.6.0 with ~40,688 LOC TypeScript across 107 commits since v0.5.0 (8 days).
-Tech stack: Tauri 2.0, Preact + Preact Signals, Motion Canvas (@efxlab v4.0.0), Vite 5, Tailwind CSS v4, pnpm, p5.brush (standalone), fit-curve, bezier-js.
-Architecture: 13 reactive signal stores, Rust image pipeline, Canvas 2D PreviewRenderer with multi-layer compositing (including paint layers with per-frame FX cache and bezier-aware rendering), WebGL2 GPU blur/GLSL runtime/motion blur, p5.brush adapter for spectral pigment mixing, bezierPath.ts math module (10 pure functions for curve conversion, sampling, editing), StrokeList component with SortableJS, PaintOverlay with pen tool bezier interaction system, perfect-freehand brush engine, paint sidecar JSON persistence, sub-frame accumulation export pipeline, command-pattern undo/redo engine with snapshot-before/commit-on-release pattern for all transform gestures, tinykeys keyboard shortcuts, exportRenderer with FFmpeg encoding.
+Shipped v0.7.0 with 112 commits across 80 files (10k insertions). pnpm monorepo with app/ + packages/efx-physic-paint/. Paint engine enhanced with 3-mode system (flat/FX/physical), inline 4-mode color picker, wireframe overlay, stroke animation, circle cursor, and brush persistence.
+Tech stack: Tauri 2.0, Preact + Preact Signals, Motion Canvas (@efxlab v4.0.0), Vite 5, Tailwind CSS v4, pnpm workspaces, p5.brush (standalone), perfect-freehand, fit-curve, bezier-js.
+Architecture: 13 reactive signal stores, Rust image pipeline, Canvas 2D PreviewRenderer with multi-layer compositing (including paint layers with per-frame FX cache and bezier-aware rendering), WebGL2 GPU blur/GLSL runtime/motion blur, p5.brush adapter for spectral pigment mixing, 3-mode paint system with per-frame mode exclusivity, inline color picker with LazyStore persistence, bezierPath.ts math module, StrokeList with SortableJS, PaintOverlay with pen/bezier interaction, paint sidecar JSON persistence, sub-frame accumulation export pipeline, command-pattern undo/redo engine, tinykeys shortcuts, exportRenderer with FFmpeg encoding.
 Project format: .mce v15 with backward compatibility (v1 through v15).
 
-v0.7.0 context: `efx-physic-paint` (v0.1.0) is a standalone physics-based paint engine at `~/Dev/efx-physic-paint`. It supports physics brush rendering, transparency, animation, and a JSON brush format — but has no bezier editing. It will be copied into `packages/efx-physic-paint/` as a workspace package. `Application/` will be renamed to `app/`. The `perfect-freehand` + `p5.brush` stack will be replaced by the new engine. Bezier path editing (fit-curve, bezier-js) remains in the editor.
-
 Known technical debt:
 - S key shortcut lacks isPaintEditMode() guard (low severity) — from v0.6.0
 - 2 medium-severity export edge cases (content-overlay image preload, FX generator frame offset) — carried from v0.2.0
@@ -221,4 +212,4 @@ This document evolves at phase transitions and milestone boundaries.
 4. Update Context with current state
 
 ---
-*Last updated: 2026-04-03 after starting v0.7.0 milestone — monorepo & paint engine swap*
+*Last updated: 2026-04-05 after Phase 33 complete — paint engine enhanced with bug fixes, 3-mode system, inline color picker, wireframe overlay, stroke animation*

.planning/REQUIREMENTS.md

@@ -23,6 +23,22 @@
 - [ ] **ENGN-05**: Per-frame FX cache with aggressive caching -- engine rendering is not real-time, all frames pre-rendered and cached for playback and animation propagation
 - [ ] **ENGN-06**: Old v0.6.0 project strokes render via existing Canvas 2D flat brush path; default brush preset for new strokes is **flat**
 
+### Enhanced Current Engine
+
+- [ ] **ECUR-01**: `Cmd+Z` after any paint operation (draw, clear, undo in FX mode) immediately re-renders canvas with correct visual state for both flat and FX strokes
+- [x] **ECUR-02**: Selecting an FX brush style (watercolor, ink, charcoal, pencil, marker) in FX mode actually paints in that style during drawing — no manual reselection required
+- [x] **ECUR-03**: Brush color and size persist across sessions in app preferences, defaulting to `#203769` at 35px
+- [x] **ECUR-04**: Paint brush shows a circle cursor at the current brush pixel size, scaling with canvas zoom (Photoshop behavior)
+- [ ] **ECUR-05**: Creating a new paint layer auto-switches to paint edit mode (equivalent to pressing `[p]`)
+- [ ] **ECUR-06**: "Clear Brush" button deletes all strokes on current frame; `Cmd+Z` properly undoes clear and re-renders
+- [x] **ECUR-07**: "Exit Paint Mode" button is larger and styled in orange with CSS pulsate color animation
+- [ ] **ECUR-08**: STROKES panel moves before SELECTION panel in sidebar ordering
+- [x] **ECUR-09**: Three brush modes in UI (Paint flat, FX Paint, Physical Paint grayed-out placeholder) with per-frame mutual exclusivity and conversion dialogs
+- [x] **ECUR-10**: Inline color picker on canvas side with 4 modes (Box/TSL/RVB/CMYK), HEX input, auto-apply, recent colors + saved favorites in persistent swatches
+- [ ] **ECUR-11**: Modal color picker removes Apply/Cancel buttons (realtime apply), removes dark overlay, opens near mouse position clamped to window bounds
+- [ ] **ECUR-12**: Selected FX stroke shows visible wireframe/path overlay for easy grab; transform bounding box for move within selection bounds
+- [x] **ECUR-13**: Stroke draw-reveal animation distributes selected stroke's points across target frame range using speed-based distribution (slow drawing = more frames, fast = fewer); single atomic undo
+
 ### Paint Tools
 
 - [ ] **PAINT-01**: User can draw freehand strokes with pressure sensitivity via physics engine
@@ -84,6 +100,19 @@
 | ENGN-04 | Phase 28 | Pending |
 | ENGN-05 | Phase 28 | Pending |
 | ENGN-06 | Phase 28 | Pending |
+| ECUR-01 | Phase 33 | Pending |
+| ECUR-02 | Phase 33 | Complete |
+| ECUR-03 | Phase 33 | Complete |
+| ECUR-04 | Phase 33 | Complete |
+| ECUR-05 | Phase 33 | Pending |
+| ECUR-06 | Phase 33 | Pending |
+| ECUR-07 | Phase 33 | Complete |
+| ECUR-08 | Phase 33 | Pending |
+| ECUR-09 | Phase 33 | Complete |
+| ECUR-10 | Phase 33 | Complete |
+| ECUR-11 | Phase 33 | Pending |
+| ECUR-12 | Phase 33 | Pending |
+| ECUR-13 | Phase 33 | Complete |
 | PAINT-01 | Phase 29 | Pending |
 | PAINT-02 | Phase 29 | Pending |
 | PAINT-03 | Phase 29 | Pending |
@@ -104,10 +133,10 @@
 | PERS-03 | Phase 32 | Pending |
 
 **Coverage:**
-- v0.7.0 requirements: 30 total
-- Mapped to phases: 30
+- v0.7.0 requirements: 43 total
+- Mapped to phases: 43
 - Unmapped: 0
 
 ---
 *Requirements defined: 2026-04-03*
-*Last updated: 2026-04-03 after roadmap creation*
+*Last updated: 2026-04-05 after adding ECUR requirements for Phase 33*