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>
This commit is contained in:
2025-11-20 21:20:06 +01:00
parent 6f52b74037
commit 4b01e92b88
18 changed files with 1371 additions and 51 deletions

78
types/canvas.ts Normal file
View File

@@ -0,0 +1,78 @@
/**
* Canvas state interface
*/
export interface CanvasState {
/** Canvas width in pixels */
width: number;
/** Canvas height in pixels */
height: number;
/** Current zoom level (1 = 100%) */
zoom: number;
/** Pan offset X */
offsetX: number;
/** Pan offset Y */
offsetY: number;
/** Background color */
backgroundColor: string;
/** Show grid overlay */
showGrid: boolean;
/** Grid size in pixels */
gridSize: number;
/** Show rulers */
showRulers: boolean;
/** Snap to grid */
snapToGrid: boolean;
}
/**
* Selection interface for selected regions
*/
export interface Selection {
/** Is there an active selection */
active: boolean;
/** Selection bounds */
x: number;
y: number;
width: number;
height: number;
/** Selection path (for complex selections) */
path?: Path2D;
}
/**
* Mouse/pointer state
*/
export interface PointerState {
/** Is pointer currently down */
isDown: boolean;
/** Current X position (canvas coordinates) */
x: number;
/** Current Y position (canvas coordinates) */
y: number;
/** Previous X position */
prevX: number;
/** Previous Y position */
prevY: number;
/** Pressure (0-1, for stylus) */
pressure: number;
}
/**
* Viewport transformation
*/
export interface Viewport {
/** Scale factor */
scale: number;
/** Translation X */
translateX: number;
/** Translation Y */
translateY: number;
}
/**
* Canvas to screen coordinate conversion result
*/
export interface Point {
x: number;
y: number;
}

3
types/index.ts Normal file
View File

@@ -0,0 +1,3 @@
export * from './canvas';
export * from './layer';
export * from './tool';

71
types/layer.ts Normal file
View File

@@ -0,0 +1,71 @@
/**
* Blend modes for layer compositing
*/
export type BlendMode =
| 'normal'
| 'multiply'
| 'screen'
| 'overlay'
| 'darken'
| 'lighten'
| 'color-dodge'
| 'color-burn'
| 'hard-light'
| 'soft-light'
| 'difference'
| 'exclusion'
| 'hue'
| 'saturation'
| 'color'
| 'luminosity';
/**
* Layer interface representing a single layer in the canvas
*/
export interface Layer {
/** Unique identifier for the layer */
id: string;
/** Display name of the layer */
name: string;
/** Canvas element containing the layer's image data */
canvas: HTMLCanvasElement | null;
/** Visibility state */
visible: boolean;
/** Opacity (0-1) */
opacity: number;
/** Blend mode for compositing */
blendMode: BlendMode;
/** Z-index order (higher = on top) */
order: number;
/** Lock state (prevents editing) */
locked: boolean;
/** Layer dimensions */
width: number;
height: number;
/** Position offset */
x: number;
y: number;
/** Timestamp of creation */
createdAt: number;
/** Timestamp of last modification */
updatedAt: number;
}
/**
* Partial layer data for updates
*/
export type LayerUpdate = Partial<Omit<Layer, 'id' | 'createdAt'>>;
/**
* Layer creation parameters
*/
export interface CreateLayerParams {
name?: string;
width: number;
height: number;
x?: number;
y?: number;
opacity?: number;
blendMode?: BlendMode;
fillColor?: string;
}

83
types/tool.ts Normal file
View File

@@ -0,0 +1,83 @@
import type { PointerState } from './canvas';
/**
* Available tool types
*/
export type ToolType =
| 'select'
| 'move'
| 'pencil'
| 'brush'
| 'eraser'
| 'fill'
| 'eyedropper'
| 'text'
| 'shape'
| 'crop'
| 'clone'
| 'blur'
| 'sharpen';
/**
* Tool settings interface
*/
export interface ToolSettings {
/** Brush/pencil size */
size: number;
/** Opacity (0-1) */
opacity: number;
/** Hardness (0-1) */
hardness: number;
/** Color */
color: string;
/** Flow rate (0-1) */
flow: number;
/** Spacing between brush stamps */
spacing: number;
}
/**
* Tool state interface
*/
export interface ToolState {
/** Currently active tool */
activeTool: ToolType;
/** Tool-specific settings */
settings: ToolSettings;
/** Custom cursor */
cursor: string;
}
/**
* Tool event handlers
*/
export interface ToolHandlers {
onPointerDown?: (pointer: PointerState, ctx: CanvasRenderingContext2D) => void;
onPointerMove?: (pointer: PointerState, ctx: CanvasRenderingContext2D) => void;
onPointerUp?: (pointer: PointerState, ctx: CanvasRenderingContext2D) => void;
onActivate?: () => void;
onDeactivate?: () => void;
}
/**
* Shape types for shape tool
*/
export type ShapeType =
| 'rectangle'
| 'ellipse'
| 'line'
| 'arrow'
| 'polygon'
| 'star';
/**
* Shape tool settings
*/
export interface ShapeSettings {
type: ShapeType;
fill: boolean;
stroke: boolean;
strokeWidth: number;
fillColor: string;
strokeColor: string;
}