feat: implement Phase 2 - Core Canvas Engine with layer system
Complete canvas rendering infrastructure and state management:
**Type System (types/)**
- Layer interface with blend modes, opacity, visibility
- Canvas state with zoom, pan, grid, rulers
- Tool types and settings interfaces
- Selection and pointer state types
**State Management (store/)**
- Layer store: CRUD operations, reordering, merging, flattening
- Canvas store: zoom (0.1x-10x), pan, grid, rulers, coordinate conversion
- Tool store: active tool, brush settings (size, opacity, hardness, flow)
- Full Zustand integration with selectors
**Utilities (lib/)**
- Canvas utils: create, clone, resize, load images, draw grid/checkerboard
- General utils: cn, clamp, lerp, distance, snap to grid, debounce, throttle
- Image data handling with error safety
**Components**
- CanvasWrapper: Multi-layer rendering with transformations
- Checkerboard transparency background
- Layer compositing with blend modes and opacity
- Grid overlay support
- Selection visualization
- Mouse wheel zoom (Ctrl+scroll)
- Middle-click or Shift+click panning
- LayersPanel: Interactive layer management
- Visibility toggle with eye icon
- Active layer selection
- Opacity display
- Delete with confirmation
- Sorted by z-order
- EditorLayout: Full editor interface
- Top toolbar with zoom controls (±, fit to screen, percentage)
- Canvas area with full viewport
- Right sidebar for layers panel
- "New Layer" button with auto-naming
**Features Implemented**
✓ Multi-layer canvas with proper z-ordering
✓ Layer visibility, opacity, blend modes
✓ Zoom: 10%-1000% with Ctrl+wheel
✓ Pan: Middle-click or Shift+drag
✓ Grid overlay (toggleable)
✓ Selection rendering
✓ Background color support
✓ Create/delete/duplicate layers
✓ Layer merging and flattening
**Performance**
- Dev server: 451ms startup
- Efficient canvas rendering with transformations
- Debounced/throttled event handlers ready
- Memory-safe image data operations
Ready for Phase 3: History & Undo System
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:20:06 +01:00
|
|
|
import { create } from 'zustand';
|
feat: implement UI state persistence and theme toggle
Major improvements to UI state management and user preferences:
- Add theme toggle with dark/light mode support
- Implement Zustand persist middleware for UI state
- Add ui-store for panel layout preferences (dock width, heights, tabs)
- Persist tool settings (active tool, size, opacity, hardness, etc.)
- Persist canvas view preferences (grid, rulers, snap-to-grid)
- Persist shape tool settings
- Persist collapsible section states
- Fix canvas coordinate transformation for centered rendering
- Constrain checkerboard and grid to canvas bounds
- Add icons to all tab buttons and collapsible sections
- Restructure panel-dock to use persisted state
Storage impact: ~3.5KB total across all preferences
Storage keys: tool-storage, canvas-view-storage, shape-storage, ui-storage
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 09:03:14 +01:00
|
|
|
import { persist } from 'zustand/middleware';
|
feat(phase-8): implement comprehensive selection system with marching ants
This commit completes Phase 8 of the paint-ui implementation, adding a full
selection system with multiple selection tools, operations, and visual feedback.
**New Files:**
- types/selection.ts: Selection types, masks, and state interfaces
- lib/selection-utils.ts: Selection mask generation and manipulation algorithms
- lib/selection-operations.ts: Copy/cut/paste/delete/fill/stroke operations
- store/selection-store.ts: Selection state management with Zustand
- core/commands/selection-command.ts: Undo/redo commands for selections
- tools/rectangular-selection-tool.ts: Rectangular marquee selection
- tools/elliptical-selection-tool.ts: Elliptical marquee selection
- tools/lasso-selection-tool.ts: Free-form polygon selection
- tools/magic-wand-tool.ts: Color-based flood-fill selection
- components/selection/selection-panel.tsx: Complete selection UI panel
- components/selection/index.ts: Selection components barrel export
**Updated Files:**
- components/canvas/canvas-with-tools.tsx: Added selection tools integration and marching ants animation
- components/editor/editor-layout.tsx: Integrated SelectionPanel into layout
- store/index.ts: Added selection-store export
- store/canvas-store.ts: Renamed Selection to CanvasSelection to avoid conflicts
- tools/index.ts: Added selection tool exports
- types/index.ts: Added selection types export
- types/canvas.ts: Renamed Selection interface to CanvasSelection
**Selection Tools:**
**Marquee Tools:**
- ✨ Rectangular Selection: Click-drag rectangular regions
- ✨ Elliptical Selection: Click-drag elliptical regions
**Free-form Tools:**
- ✨ Lasso Selection: Draw free-form polygon selections
- ✨ Magic Wand: Color-based flood-fill selection with tolerance
**Selection Modes:**
- 🔷 New: Replace existing selection
- ➕ Add: Add to existing selection
- ➖ Subtract: Remove from existing selection
- ⚡ Intersect: Keep only overlapping areas
**Selection Operations:**
- 📋 Copy/Cut/Paste: Standard clipboard operations with selection mask
- 🗑️ Delete: Remove selected pixels
- 🎨 Fill Selection: Fill with current color
- 🖌️ Stroke Selection: Outline selection with current color
- 🔄 Invert Selection: Invert selected/unselected pixels
- ❌ Clear Selection: Deselect all
**Technical Features:**
- Marching ants animation (animated dashed outline at 50ms interval)
- Selection masks using Uint8Array (0-255 values for anti-aliasing)
- Feathering support (0-250px gaussian blur on selection edges)
- Tolerance control for magic wand (0-255 color difference threshold)
- Scanline polygon fill algorithm for lasso tool
- Flood-fill with Set-based visited tracking for magic wand
- Selection bounds calculation for optimized operations
- Keyboard shortcuts (Ctrl+C, Ctrl+X, Ctrl+V, Ctrl+D, Ctrl+Shift+I)
- Undo/redo integration via selection commands
- Non-destructive operations with proper history tracking
**Algorithm Implementations:**
- Rectangular mask: Simple bounds-based pixel marking
- Elliptical mask: Distance formula from ellipse center
- Lasso mask: Scanline polygon fill with edge intersection
- Magic wand: BFS flood-fill with color tolerance matching
- Mask combination: Per-pixel operations (max, subtract, AND)
- Feathering: Separable box blur (horizontal + vertical passes)
- Mask inversion: Per-pixel NOT operation with bounds recalculation
**UI/UX Features:**
- 264px wide selection panel with all tools and operations
- Tool selection with visual feedback (highlighted active tool)
- Selection mode toggles (new/add/subtract/intersect)
- Feather and tolerance sliders with live value display
- Disabled state when no selection exists
- Keyboard shortcut hints next to operations
- Visual marching ants animation (animated dashes)
Build verified: ✓ Compiled successfully in 1302ms
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 02:24:12 +01:00
|
|
|
import type { CanvasState, CanvasSelection, Point } from '@/types';
|
feat: implement Phase 2 - Core Canvas Engine with layer system
Complete canvas rendering infrastructure and state management:
**Type System (types/)**
- Layer interface with blend modes, opacity, visibility
- Canvas state with zoom, pan, grid, rulers
- Tool types and settings interfaces
- Selection and pointer state types
**State Management (store/)**
- Layer store: CRUD operations, reordering, merging, flattening
- Canvas store: zoom (0.1x-10x), pan, grid, rulers, coordinate conversion
- Tool store: active tool, brush settings (size, opacity, hardness, flow)
- Full Zustand integration with selectors
**Utilities (lib/)**
- Canvas utils: create, clone, resize, load images, draw grid/checkerboard
- General utils: cn, clamp, lerp, distance, snap to grid, debounce, throttle
- Image data handling with error safety
**Components**
- CanvasWrapper: Multi-layer rendering with transformations
- Checkerboard transparency background
- Layer compositing with blend modes and opacity
- Grid overlay support
- Selection visualization
- Mouse wheel zoom (Ctrl+scroll)
- Middle-click or Shift+click panning
- LayersPanel: Interactive layer management
- Visibility toggle with eye icon
- Active layer selection
- Opacity display
- Delete with confirmation
- Sorted by z-order
- EditorLayout: Full editor interface
- Top toolbar with zoom controls (±, fit to screen, percentage)
- Canvas area with full viewport
- Right sidebar for layers panel
- "New Layer" button with auto-naming
**Features Implemented**
✓ Multi-layer canvas with proper z-ordering
✓ Layer visibility, opacity, blend modes
✓ Zoom: 10%-1000% with Ctrl+wheel
✓ Pan: Middle-click or Shift+drag
✓ Grid overlay (toggleable)
✓ Selection rendering
✓ Background color support
✓ Create/delete/duplicate layers
✓ Layer merging and flattening
**Performance**
- Dev server: 451ms startup
- Efficient canvas rendering with transformations
- Debounced/throttled event handlers ready
- Memory-safe image data operations
Ready for Phase 3: History & Undo System
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:20:06 +01:00
|
|
|
|
|
|
|
|
interface CanvasStore extends CanvasState {
|
|
|
|
|
/** Selection state */
|
feat(phase-8): implement comprehensive selection system with marching ants
This commit completes Phase 8 of the paint-ui implementation, adding a full
selection system with multiple selection tools, operations, and visual feedback.
**New Files:**
- types/selection.ts: Selection types, masks, and state interfaces
- lib/selection-utils.ts: Selection mask generation and manipulation algorithms
- lib/selection-operations.ts: Copy/cut/paste/delete/fill/stroke operations
- store/selection-store.ts: Selection state management with Zustand
- core/commands/selection-command.ts: Undo/redo commands for selections
- tools/rectangular-selection-tool.ts: Rectangular marquee selection
- tools/elliptical-selection-tool.ts: Elliptical marquee selection
- tools/lasso-selection-tool.ts: Free-form polygon selection
- tools/magic-wand-tool.ts: Color-based flood-fill selection
- components/selection/selection-panel.tsx: Complete selection UI panel
- components/selection/index.ts: Selection components barrel export
**Updated Files:**
- components/canvas/canvas-with-tools.tsx: Added selection tools integration and marching ants animation
- components/editor/editor-layout.tsx: Integrated SelectionPanel into layout
- store/index.ts: Added selection-store export
- store/canvas-store.ts: Renamed Selection to CanvasSelection to avoid conflicts
- tools/index.ts: Added selection tool exports
- types/index.ts: Added selection types export
- types/canvas.ts: Renamed Selection interface to CanvasSelection
**Selection Tools:**
**Marquee Tools:**
- ✨ Rectangular Selection: Click-drag rectangular regions
- ✨ Elliptical Selection: Click-drag elliptical regions
**Free-form Tools:**
- ✨ Lasso Selection: Draw free-form polygon selections
- ✨ Magic Wand: Color-based flood-fill selection with tolerance
**Selection Modes:**
- 🔷 New: Replace existing selection
- ➕ Add: Add to existing selection
- ➖ Subtract: Remove from existing selection
- ⚡ Intersect: Keep only overlapping areas
**Selection Operations:**
- 📋 Copy/Cut/Paste: Standard clipboard operations with selection mask
- 🗑️ Delete: Remove selected pixels
- 🎨 Fill Selection: Fill with current color
- 🖌️ Stroke Selection: Outline selection with current color
- 🔄 Invert Selection: Invert selected/unselected pixels
- ❌ Clear Selection: Deselect all
**Technical Features:**
- Marching ants animation (animated dashed outline at 50ms interval)
- Selection masks using Uint8Array (0-255 values for anti-aliasing)
- Feathering support (0-250px gaussian blur on selection edges)
- Tolerance control for magic wand (0-255 color difference threshold)
- Scanline polygon fill algorithm for lasso tool
- Flood-fill with Set-based visited tracking for magic wand
- Selection bounds calculation for optimized operations
- Keyboard shortcuts (Ctrl+C, Ctrl+X, Ctrl+V, Ctrl+D, Ctrl+Shift+I)
- Undo/redo integration via selection commands
- Non-destructive operations with proper history tracking
**Algorithm Implementations:**
- Rectangular mask: Simple bounds-based pixel marking
- Elliptical mask: Distance formula from ellipse center
- Lasso mask: Scanline polygon fill with edge intersection
- Magic wand: BFS flood-fill with color tolerance matching
- Mask combination: Per-pixel operations (max, subtract, AND)
- Feathering: Separable box blur (horizontal + vertical passes)
- Mask inversion: Per-pixel NOT operation with bounds recalculation
**UI/UX Features:**
- 264px wide selection panel with all tools and operations
- Tool selection with visual feedback (highlighted active tool)
- Selection mode toggles (new/add/subtract/intersect)
- Feather and tolerance sliders with live value display
- Disabled state when no selection exists
- Keyboard shortcut hints next to operations
- Visual marching ants animation (animated dashes)
Build verified: ✓ Compiled successfully in 1302ms
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 02:24:12 +01:00
|
|
|
selection: CanvasSelection;
|
feat: implement Phase 2 - Core Canvas Engine with layer system
Complete canvas rendering infrastructure and state management:
**Type System (types/)**
- Layer interface with blend modes, opacity, visibility
- Canvas state with zoom, pan, grid, rulers
- Tool types and settings interfaces
- Selection and pointer state types
**State Management (store/)**
- Layer store: CRUD operations, reordering, merging, flattening
- Canvas store: zoom (0.1x-10x), pan, grid, rulers, coordinate conversion
- Tool store: active tool, brush settings (size, opacity, hardness, flow)
- Full Zustand integration with selectors
**Utilities (lib/)**
- Canvas utils: create, clone, resize, load images, draw grid/checkerboard
- General utils: cn, clamp, lerp, distance, snap to grid, debounce, throttle
- Image data handling with error safety
**Components**
- CanvasWrapper: Multi-layer rendering with transformations
- Checkerboard transparency background
- Layer compositing with blend modes and opacity
- Grid overlay support
- Selection visualization
- Mouse wheel zoom (Ctrl+scroll)
- Middle-click or Shift+click panning
- LayersPanel: Interactive layer management
- Visibility toggle with eye icon
- Active layer selection
- Opacity display
- Delete with confirmation
- Sorted by z-order
- EditorLayout: Full editor interface
- Top toolbar with zoom controls (±, fit to screen, percentage)
- Canvas area with full viewport
- Right sidebar for layers panel
- "New Layer" button with auto-naming
**Features Implemented**
✓ Multi-layer canvas with proper z-ordering
✓ Layer visibility, opacity, blend modes
✓ Zoom: 10%-1000% with Ctrl+wheel
✓ Pan: Middle-click or Shift+drag
✓ Grid overlay (toggleable)
✓ Selection rendering
✓ Background color support
✓ Create/delete/duplicate layers
✓ Layer merging and flattening
**Performance**
- Dev server: 451ms startup
- Efficient canvas rendering with transformations
- Debounced/throttled event handlers ready
- Memory-safe image data operations
Ready for Phase 3: History & Undo System
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:20:06 +01:00
|
|
|
|
|
|
|
|
/** Set canvas dimensions */
|
|
|
|
|
setDimensions: (width: number, height: number) => void;
|
|
|
|
|
/** Set zoom level */
|
|
|
|
|
setZoom: (zoom: number) => void;
|
|
|
|
|
/** Zoom in (1.2x) */
|
|
|
|
|
zoomIn: () => void;
|
|
|
|
|
/** Zoom out (0.8x) */
|
|
|
|
|
zoomOut: () => void;
|
|
|
|
|
/** Fit canvas to viewport */
|
|
|
|
|
zoomToFit: (viewportWidth: number, viewportHeight: number) => void;
|
|
|
|
|
/** Zoom to actual size (100%) */
|
|
|
|
|
zoomToActual: () => void;
|
|
|
|
|
/** Set pan offset */
|
|
|
|
|
setPanOffset: (x: number, y: number) => void;
|
|
|
|
|
/** Pan by delta */
|
|
|
|
|
pan: (dx: number, dy: number) => void;
|
|
|
|
|
/** Reset pan to center */
|
|
|
|
|
resetPan: () => void;
|
|
|
|
|
/** Toggle grid visibility */
|
|
|
|
|
toggleGrid: () => void;
|
|
|
|
|
/** Set grid size */
|
|
|
|
|
setGridSize: (size: number) => void;
|
|
|
|
|
/** Toggle rulers */
|
|
|
|
|
toggleRulers: () => void;
|
|
|
|
|
/** Toggle snap to grid */
|
|
|
|
|
toggleSnapToGrid: () => void;
|
|
|
|
|
/** Set background color */
|
|
|
|
|
setBackgroundColor: (color: string) => void;
|
|
|
|
|
/** Set selection */
|
feat(phase-8): implement comprehensive selection system with marching ants
This commit completes Phase 8 of the paint-ui implementation, adding a full
selection system with multiple selection tools, operations, and visual feedback.
**New Files:**
- types/selection.ts: Selection types, masks, and state interfaces
- lib/selection-utils.ts: Selection mask generation and manipulation algorithms
- lib/selection-operations.ts: Copy/cut/paste/delete/fill/stroke operations
- store/selection-store.ts: Selection state management with Zustand
- core/commands/selection-command.ts: Undo/redo commands for selections
- tools/rectangular-selection-tool.ts: Rectangular marquee selection
- tools/elliptical-selection-tool.ts: Elliptical marquee selection
- tools/lasso-selection-tool.ts: Free-form polygon selection
- tools/magic-wand-tool.ts: Color-based flood-fill selection
- components/selection/selection-panel.tsx: Complete selection UI panel
- components/selection/index.ts: Selection components barrel export
**Updated Files:**
- components/canvas/canvas-with-tools.tsx: Added selection tools integration and marching ants animation
- components/editor/editor-layout.tsx: Integrated SelectionPanel into layout
- store/index.ts: Added selection-store export
- store/canvas-store.ts: Renamed Selection to CanvasSelection to avoid conflicts
- tools/index.ts: Added selection tool exports
- types/index.ts: Added selection types export
- types/canvas.ts: Renamed Selection interface to CanvasSelection
**Selection Tools:**
**Marquee Tools:**
- ✨ Rectangular Selection: Click-drag rectangular regions
- ✨ Elliptical Selection: Click-drag elliptical regions
**Free-form Tools:**
- ✨ Lasso Selection: Draw free-form polygon selections
- ✨ Magic Wand: Color-based flood-fill selection with tolerance
**Selection Modes:**
- 🔷 New: Replace existing selection
- ➕ Add: Add to existing selection
- ➖ Subtract: Remove from existing selection
- ⚡ Intersect: Keep only overlapping areas
**Selection Operations:**
- 📋 Copy/Cut/Paste: Standard clipboard operations with selection mask
- 🗑️ Delete: Remove selected pixels
- 🎨 Fill Selection: Fill with current color
- 🖌️ Stroke Selection: Outline selection with current color
- 🔄 Invert Selection: Invert selected/unselected pixels
- ❌ Clear Selection: Deselect all
**Technical Features:**
- Marching ants animation (animated dashed outline at 50ms interval)
- Selection masks using Uint8Array (0-255 values for anti-aliasing)
- Feathering support (0-250px gaussian blur on selection edges)
- Tolerance control for magic wand (0-255 color difference threshold)
- Scanline polygon fill algorithm for lasso tool
- Flood-fill with Set-based visited tracking for magic wand
- Selection bounds calculation for optimized operations
- Keyboard shortcuts (Ctrl+C, Ctrl+X, Ctrl+V, Ctrl+D, Ctrl+Shift+I)
- Undo/redo integration via selection commands
- Non-destructive operations with proper history tracking
**Algorithm Implementations:**
- Rectangular mask: Simple bounds-based pixel marking
- Elliptical mask: Distance formula from ellipse center
- Lasso mask: Scanline polygon fill with edge intersection
- Magic wand: BFS flood-fill with color tolerance matching
- Mask combination: Per-pixel operations (max, subtract, AND)
- Feathering: Separable box blur (horizontal + vertical passes)
- Mask inversion: Per-pixel NOT operation with bounds recalculation
**UI/UX Features:**
- 264px wide selection panel with all tools and operations
- Tool selection with visual feedback (highlighted active tool)
- Selection mode toggles (new/add/subtract/intersect)
- Feather and tolerance sliders with live value display
- Disabled state when no selection exists
- Keyboard shortcut hints next to operations
- Visual marching ants animation (animated dashes)
Build verified: ✓ Compiled successfully in 1302ms
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 02:24:12 +01:00
|
|
|
setSelection: (selection: Partial<CanvasSelection>) => void;
|
feat: implement Phase 2 - Core Canvas Engine with layer system
Complete canvas rendering infrastructure and state management:
**Type System (types/)**
- Layer interface with blend modes, opacity, visibility
- Canvas state with zoom, pan, grid, rulers
- Tool types and settings interfaces
- Selection and pointer state types
**State Management (store/)**
- Layer store: CRUD operations, reordering, merging, flattening
- Canvas store: zoom (0.1x-10x), pan, grid, rulers, coordinate conversion
- Tool store: active tool, brush settings (size, opacity, hardness, flow)
- Full Zustand integration with selectors
**Utilities (lib/)**
- Canvas utils: create, clone, resize, load images, draw grid/checkerboard
- General utils: cn, clamp, lerp, distance, snap to grid, debounce, throttle
- Image data handling with error safety
**Components**
- CanvasWrapper: Multi-layer rendering with transformations
- Checkerboard transparency background
- Layer compositing with blend modes and opacity
- Grid overlay support
- Selection visualization
- Mouse wheel zoom (Ctrl+scroll)
- Middle-click or Shift+click panning
- LayersPanel: Interactive layer management
- Visibility toggle with eye icon
- Active layer selection
- Opacity display
- Delete with confirmation
- Sorted by z-order
- EditorLayout: Full editor interface
- Top toolbar with zoom controls (±, fit to screen, percentage)
- Canvas area with full viewport
- Right sidebar for layers panel
- "New Layer" button with auto-naming
**Features Implemented**
✓ Multi-layer canvas with proper z-ordering
✓ Layer visibility, opacity, blend modes
✓ Zoom: 10%-1000% with Ctrl+wheel
✓ Pan: Middle-click or Shift+drag
✓ Grid overlay (toggleable)
✓ Selection rendering
✓ Background color support
✓ Create/delete/duplicate layers
✓ Layer merging and flattening
**Performance**
- Dev server: 451ms startup
- Efficient canvas rendering with transformations
- Debounced/throttled event handlers ready
- Memory-safe image data operations
Ready for Phase 3: History & Undo System
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:20:06 +01:00
|
|
|
/** Clear selection */
|
|
|
|
|
clearSelection: () => void;
|
|
|
|
|
/** Convert screen coordinates to canvas coordinates */
|
feat: implement UI state persistence and theme toggle
Major improvements to UI state management and user preferences:
- Add theme toggle with dark/light mode support
- Implement Zustand persist middleware for UI state
- Add ui-store for panel layout preferences (dock width, heights, tabs)
- Persist tool settings (active tool, size, opacity, hardness, etc.)
- Persist canvas view preferences (grid, rulers, snap-to-grid)
- Persist shape tool settings
- Persist collapsible section states
- Fix canvas coordinate transformation for centered rendering
- Constrain checkerboard and grid to canvas bounds
- Add icons to all tab buttons and collapsible sections
- Restructure panel-dock to use persisted state
Storage impact: ~3.5KB total across all preferences
Storage keys: tool-storage, canvas-view-storage, shape-storage, ui-storage
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 09:03:14 +01:00
|
|
|
screenToCanvas: (screenX: number, screenY: number, containerWidth?: number, containerHeight?: number) => Point;
|
feat: implement Phase 2 - Core Canvas Engine with layer system
Complete canvas rendering infrastructure and state management:
**Type System (types/)**
- Layer interface with blend modes, opacity, visibility
- Canvas state with zoom, pan, grid, rulers
- Tool types and settings interfaces
- Selection and pointer state types
**State Management (store/)**
- Layer store: CRUD operations, reordering, merging, flattening
- Canvas store: zoom (0.1x-10x), pan, grid, rulers, coordinate conversion
- Tool store: active tool, brush settings (size, opacity, hardness, flow)
- Full Zustand integration with selectors
**Utilities (lib/)**
- Canvas utils: create, clone, resize, load images, draw grid/checkerboard
- General utils: cn, clamp, lerp, distance, snap to grid, debounce, throttle
- Image data handling with error safety
**Components**
- CanvasWrapper: Multi-layer rendering with transformations
- Checkerboard transparency background
- Layer compositing with blend modes and opacity
- Grid overlay support
- Selection visualization
- Mouse wheel zoom (Ctrl+scroll)
- Middle-click or Shift+click panning
- LayersPanel: Interactive layer management
- Visibility toggle with eye icon
- Active layer selection
- Opacity display
- Delete with confirmation
- Sorted by z-order
- EditorLayout: Full editor interface
- Top toolbar with zoom controls (±, fit to screen, percentage)
- Canvas area with full viewport
- Right sidebar for layers panel
- "New Layer" button with auto-naming
**Features Implemented**
✓ Multi-layer canvas with proper z-ordering
✓ Layer visibility, opacity, blend modes
✓ Zoom: 10%-1000% with Ctrl+wheel
✓ Pan: Middle-click or Shift+drag
✓ Grid overlay (toggleable)
✓ Selection rendering
✓ Background color support
✓ Create/delete/duplicate layers
✓ Layer merging and flattening
**Performance**
- Dev server: 451ms startup
- Efficient canvas rendering with transformations
- Debounced/throttled event handlers ready
- Memory-safe image data operations
Ready for Phase 3: History & Undo System
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:20:06 +01:00
|
|
|
/** Convert canvas coordinates to screen coordinates */
|
|
|
|
|
canvasToScreen: (canvasX: number, canvasY: number) => Point;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
const DEFAULT_CANVAS_WIDTH = 800;
|
|
|
|
|
const DEFAULT_CANVAS_HEIGHT = 600;
|
|
|
|
|
const MIN_ZOOM = 0.1;
|
|
|
|
|
const MAX_ZOOM = 10;
|
|
|
|
|
const ZOOM_STEP = 1.2;
|
|
|
|
|
|
feat: implement UI state persistence and theme toggle
Major improvements to UI state management and user preferences:
- Add theme toggle with dark/light mode support
- Implement Zustand persist middleware for UI state
- Add ui-store for panel layout preferences (dock width, heights, tabs)
- Persist tool settings (active tool, size, opacity, hardness, etc.)
- Persist canvas view preferences (grid, rulers, snap-to-grid)
- Persist shape tool settings
- Persist collapsible section states
- Fix canvas coordinate transformation for centered rendering
- Constrain checkerboard and grid to canvas bounds
- Add icons to all tab buttons and collapsible sections
- Restructure panel-dock to use persisted state
Storage impact: ~3.5KB total across all preferences
Storage keys: tool-storage, canvas-view-storage, shape-storage, ui-storage
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 09:03:14 +01:00
|
|
|
export const useCanvasStore = create<CanvasStore>()(
|
|
|
|
|
persist(
|
|
|
|
|
(set, get) => ({
|
|
|
|
|
width: DEFAULT_CANVAS_WIDTH,
|
|
|
|
|
height: DEFAULT_CANVAS_HEIGHT,
|
|
|
|
|
zoom: 1,
|
|
|
|
|
offsetX: 0,
|
|
|
|
|
offsetY: 0,
|
2025-11-21 09:17:12 +01:00
|
|
|
backgroundColor: 'transparent',
|
feat: implement UI state persistence and theme toggle
Major improvements to UI state management and user preferences:
- Add theme toggle with dark/light mode support
- Implement Zustand persist middleware for UI state
- Add ui-store for panel layout preferences (dock width, heights, tabs)
- Persist tool settings (active tool, size, opacity, hardness, etc.)
- Persist canvas view preferences (grid, rulers, snap-to-grid)
- Persist shape tool settings
- Persist collapsible section states
- Fix canvas coordinate transformation for centered rendering
- Constrain checkerboard and grid to canvas bounds
- Add icons to all tab buttons and collapsible sections
- Restructure panel-dock to use persisted state
Storage impact: ~3.5KB total across all preferences
Storage keys: tool-storage, canvas-view-storage, shape-storage, ui-storage
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 09:03:14 +01:00
|
|
|
showGrid: false,
|
|
|
|
|
gridSize: 20,
|
|
|
|
|
showRulers: true,
|
|
|
|
|
snapToGrid: false,
|
|
|
|
|
selection: {
|
|
|
|
|
active: false,
|
|
|
|
|
x: 0,
|
|
|
|
|
y: 0,
|
|
|
|
|
width: 0,
|
|
|
|
|
height: 0,
|
|
|
|
|
},
|
feat: implement Phase 2 - Core Canvas Engine with layer system
Complete canvas rendering infrastructure and state management:
**Type System (types/)**
- Layer interface with blend modes, opacity, visibility
- Canvas state with zoom, pan, grid, rulers
- Tool types and settings interfaces
- Selection and pointer state types
**State Management (store/)**
- Layer store: CRUD operations, reordering, merging, flattening
- Canvas store: zoom (0.1x-10x), pan, grid, rulers, coordinate conversion
- Tool store: active tool, brush settings (size, opacity, hardness, flow)
- Full Zustand integration with selectors
**Utilities (lib/)**
- Canvas utils: create, clone, resize, load images, draw grid/checkerboard
- General utils: cn, clamp, lerp, distance, snap to grid, debounce, throttle
- Image data handling with error safety
**Components**
- CanvasWrapper: Multi-layer rendering with transformations
- Checkerboard transparency background
- Layer compositing with blend modes and opacity
- Grid overlay support
- Selection visualization
- Mouse wheel zoom (Ctrl+scroll)
- Middle-click or Shift+click panning
- LayersPanel: Interactive layer management
- Visibility toggle with eye icon
- Active layer selection
- Opacity display
- Delete with confirmation
- Sorted by z-order
- EditorLayout: Full editor interface
- Top toolbar with zoom controls (±, fit to screen, percentage)
- Canvas area with full viewport
- Right sidebar for layers panel
- "New Layer" button with auto-naming
**Features Implemented**
✓ Multi-layer canvas with proper z-ordering
✓ Layer visibility, opacity, blend modes
✓ Zoom: 10%-1000% with Ctrl+wheel
✓ Pan: Middle-click or Shift+drag
✓ Grid overlay (toggleable)
✓ Selection rendering
✓ Background color support
✓ Create/delete/duplicate layers
✓ Layer merging and flattening
**Performance**
- Dev server: 451ms startup
- Efficient canvas rendering with transformations
- Debounced/throttled event handlers ready
- Memory-safe image data operations
Ready for Phase 3: History & Undo System
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:20:06 +01:00
|
|
|
|
|
|
|
|
setDimensions: (width, height) => {
|
|
|
|
|
set({ width, height });
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
setZoom: (zoom) => {
|
|
|
|
|
const clampedZoom = Math.max(MIN_ZOOM, Math.min(MAX_ZOOM, zoom));
|
|
|
|
|
set({ zoom: clampedZoom });
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
zoomIn: () => {
|
|
|
|
|
const { zoom } = get();
|
|
|
|
|
get().setZoom(zoom * ZOOM_STEP);
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
zoomOut: () => {
|
|
|
|
|
const { zoom } = get();
|
|
|
|
|
get().setZoom(zoom / ZOOM_STEP);
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
zoomToFit: (viewportWidth, viewportHeight) => {
|
|
|
|
|
const { width, height } = get();
|
|
|
|
|
const padding = 40;
|
|
|
|
|
const scaleX = (viewportWidth - padding * 2) / width;
|
|
|
|
|
const scaleY = (viewportHeight - padding * 2) / height;
|
|
|
|
|
const zoom = Math.min(scaleX, scaleY, 1);
|
|
|
|
|
set({ zoom, offsetX: 0, offsetY: 0 });
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
zoomToActual: () => {
|
|
|
|
|
set({ zoom: 1 });
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
setPanOffset: (x, y) => {
|
|
|
|
|
set({ offsetX: x, offsetY: y });
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
pan: (dx, dy) => {
|
|
|
|
|
set((state) => ({
|
|
|
|
|
offsetX: state.offsetX + dx,
|
|
|
|
|
offsetY: state.offsetY + dy,
|
|
|
|
|
}));
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
resetPan: () => {
|
|
|
|
|
set({ offsetX: 0, offsetY: 0 });
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
toggleGrid: () => {
|
|
|
|
|
set((state) => ({ showGrid: !state.showGrid }));
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
setGridSize: (size) => {
|
|
|
|
|
set({ gridSize: Math.max(1, size) });
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
toggleRulers: () => {
|
|
|
|
|
set((state) => ({ showRulers: !state.showRulers }));
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
toggleSnapToGrid: () => {
|
|
|
|
|
set((state) => ({ snapToGrid: !state.snapToGrid }));
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
setBackgroundColor: (color) => {
|
|
|
|
|
set({ backgroundColor: color });
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
setSelection: (selection) => {
|
|
|
|
|
set((state) => ({
|
|
|
|
|
selection: { ...state.selection, ...selection },
|
|
|
|
|
}));
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
clearSelection: () => {
|
|
|
|
|
set({
|
|
|
|
|
selection: {
|
|
|
|
|
active: false,
|
|
|
|
|
x: 0,
|
|
|
|
|
y: 0,
|
|
|
|
|
width: 0,
|
|
|
|
|
height: 0,
|
|
|
|
|
},
|
|
|
|
|
});
|
|
|
|
|
},
|
|
|
|
|
|
feat: implement UI state persistence and theme toggle
Major improvements to UI state management and user preferences:
- Add theme toggle with dark/light mode support
- Implement Zustand persist middleware for UI state
- Add ui-store for panel layout preferences (dock width, heights, tabs)
- Persist tool settings (active tool, size, opacity, hardness, etc.)
- Persist canvas view preferences (grid, rulers, snap-to-grid)
- Persist shape tool settings
- Persist collapsible section states
- Fix canvas coordinate transformation for centered rendering
- Constrain checkerboard and grid to canvas bounds
- Add icons to all tab buttons and collapsible sections
- Restructure panel-dock to use persisted state
Storage impact: ~3.5KB total across all preferences
Storage keys: tool-storage, canvas-view-storage, shape-storage, ui-storage
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 09:03:14 +01:00
|
|
|
screenToCanvas: (screenX, screenY, containerWidth = 0, containerHeight = 0) => {
|
|
|
|
|
const { zoom, offsetX, offsetY, width, height } = get();
|
|
|
|
|
// The canvas is rendered with this transformation:
|
|
|
|
|
// 1. translate(offsetX + containerWidth/2, offsetY + containerHeight/2) - center in viewport with offset
|
|
|
|
|
// 2. scale(zoom) - apply zoom
|
|
|
|
|
// 3. translate(-width/2, -height/2) - position canvas so (0,0) is at top-left
|
|
|
|
|
//
|
|
|
|
|
// To reverse:
|
|
|
|
|
// 1. Subtract container center and offset
|
|
|
|
|
// 2. Divide by zoom
|
|
|
|
|
// 3. Add canvas center
|
feat: implement Phase 2 - Core Canvas Engine with layer system
Complete canvas rendering infrastructure and state management:
**Type System (types/)**
- Layer interface with blend modes, opacity, visibility
- Canvas state with zoom, pan, grid, rulers
- Tool types and settings interfaces
- Selection and pointer state types
**State Management (store/)**
- Layer store: CRUD operations, reordering, merging, flattening
- Canvas store: zoom (0.1x-10x), pan, grid, rulers, coordinate conversion
- Tool store: active tool, brush settings (size, opacity, hardness, flow)
- Full Zustand integration with selectors
**Utilities (lib/)**
- Canvas utils: create, clone, resize, load images, draw grid/checkerboard
- General utils: cn, clamp, lerp, distance, snap to grid, debounce, throttle
- Image data handling with error safety
**Components**
- CanvasWrapper: Multi-layer rendering with transformations
- Checkerboard transparency background
- Layer compositing with blend modes and opacity
- Grid overlay support
- Selection visualization
- Mouse wheel zoom (Ctrl+scroll)
- Middle-click or Shift+click panning
- LayersPanel: Interactive layer management
- Visibility toggle with eye icon
- Active layer selection
- Opacity display
- Delete with confirmation
- Sorted by z-order
- EditorLayout: Full editor interface
- Top toolbar with zoom controls (±, fit to screen, percentage)
- Canvas area with full viewport
- Right sidebar for layers panel
- "New Layer" button with auto-naming
**Features Implemented**
✓ Multi-layer canvas with proper z-ordering
✓ Layer visibility, opacity, blend modes
✓ Zoom: 10%-1000% with Ctrl+wheel
✓ Pan: Middle-click or Shift+drag
✓ Grid overlay (toggleable)
✓ Selection rendering
✓ Background color support
✓ Create/delete/duplicate layers
✓ Layer merging and flattening
**Performance**
- Dev server: 451ms startup
- Efficient canvas rendering with transformations
- Debounced/throttled event handlers ready
- Memory-safe image data operations
Ready for Phase 3: History & Undo System
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:20:06 +01:00
|
|
|
return {
|
feat: implement UI state persistence and theme toggle
Major improvements to UI state management and user preferences:
- Add theme toggle with dark/light mode support
- Implement Zustand persist middleware for UI state
- Add ui-store for panel layout preferences (dock width, heights, tabs)
- Persist tool settings (active tool, size, opacity, hardness, etc.)
- Persist canvas view preferences (grid, rulers, snap-to-grid)
- Persist shape tool settings
- Persist collapsible section states
- Fix canvas coordinate transformation for centered rendering
- Constrain checkerboard and grid to canvas bounds
- Add icons to all tab buttons and collapsible sections
- Restructure panel-dock to use persisted state
Storage impact: ~3.5KB total across all preferences
Storage keys: tool-storage, canvas-view-storage, shape-storage, ui-storage
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 09:03:14 +01:00
|
|
|
x: (screenX - containerWidth / 2 - offsetX) / zoom + width / 2,
|
|
|
|
|
y: (screenY - containerHeight / 2 - offsetY) / zoom + height / 2,
|
feat: implement Phase 2 - Core Canvas Engine with layer system
Complete canvas rendering infrastructure and state management:
**Type System (types/)**
- Layer interface with blend modes, opacity, visibility
- Canvas state with zoom, pan, grid, rulers
- Tool types and settings interfaces
- Selection and pointer state types
**State Management (store/)**
- Layer store: CRUD operations, reordering, merging, flattening
- Canvas store: zoom (0.1x-10x), pan, grid, rulers, coordinate conversion
- Tool store: active tool, brush settings (size, opacity, hardness, flow)
- Full Zustand integration with selectors
**Utilities (lib/)**
- Canvas utils: create, clone, resize, load images, draw grid/checkerboard
- General utils: cn, clamp, lerp, distance, snap to grid, debounce, throttle
- Image data handling with error safety
**Components**
- CanvasWrapper: Multi-layer rendering with transformations
- Checkerboard transparency background
- Layer compositing with blend modes and opacity
- Grid overlay support
- Selection visualization
- Mouse wheel zoom (Ctrl+scroll)
- Middle-click or Shift+click panning
- LayersPanel: Interactive layer management
- Visibility toggle with eye icon
- Active layer selection
- Opacity display
- Delete with confirmation
- Sorted by z-order
- EditorLayout: Full editor interface
- Top toolbar with zoom controls (±, fit to screen, percentage)
- Canvas area with full viewport
- Right sidebar for layers panel
- "New Layer" button with auto-naming
**Features Implemented**
✓ Multi-layer canvas with proper z-ordering
✓ Layer visibility, opacity, blend modes
✓ Zoom: 10%-1000% with Ctrl+wheel
✓ Pan: Middle-click or Shift+drag
✓ Grid overlay (toggleable)
✓ Selection rendering
✓ Background color support
✓ Create/delete/duplicate layers
✓ Layer merging and flattening
**Performance**
- Dev server: 451ms startup
- Efficient canvas rendering with transformations
- Debounced/throttled event handlers ready
- Memory-safe image data operations
Ready for Phase 3: History & Undo System
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:20:06 +01:00
|
|
|
};
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
canvasToScreen: (canvasX, canvasY) => {
|
|
|
|
|
const { zoom, offsetX, offsetY } = get();
|
|
|
|
|
return {
|
|
|
|
|
x: canvasX * zoom + offsetX,
|
|
|
|
|
y: canvasY * zoom + offsetY,
|
|
|
|
|
};
|
|
|
|
|
},
|
feat: implement UI state persistence and theme toggle
Major improvements to UI state management and user preferences:
- Add theme toggle with dark/light mode support
- Implement Zustand persist middleware for UI state
- Add ui-store for panel layout preferences (dock width, heights, tabs)
- Persist tool settings (active tool, size, opacity, hardness, etc.)
- Persist canvas view preferences (grid, rulers, snap-to-grid)
- Persist shape tool settings
- Persist collapsible section states
- Fix canvas coordinate transformation for centered rendering
- Constrain checkerboard and grid to canvas bounds
- Add icons to all tab buttons and collapsible sections
- Restructure panel-dock to use persisted state
Storage impact: ~3.5KB total across all preferences
Storage keys: tool-storage, canvas-view-storage, shape-storage, ui-storage
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 09:03:14 +01:00
|
|
|
}),
|
|
|
|
|
{
|
|
|
|
|
name: 'canvas-view-storage',
|
|
|
|
|
partialize: (state) => ({
|
|
|
|
|
backgroundColor: state.backgroundColor,
|
|
|
|
|
showGrid: state.showGrid,
|
|
|
|
|
gridSize: state.gridSize,
|
|
|
|
|
showRulers: state.showRulers,
|
|
|
|
|
snapToGrid: state.snapToGrid,
|
|
|
|
|
// Exclude: width, height, zoom, offsetX, offsetY, selection
|
|
|
|
|
}),
|
|
|
|
|
}
|
|
|
|
|
)
|
|
|
|
|
);
|