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:
78
types/canvas.ts
Normal file
78
types/canvas.ts
Normal 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
3
types/index.ts
Normal file
@@ -0,0 +1,3 @@
|
||||
export * from './canvas';
|
||||
export * from './layer';
|
||||
export * from './tool';
|
||||
71
types/layer.ts
Normal file
71
types/layer.ts
Normal 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
83
types/tool.ts
Normal 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;
|
||||
}
|
||||
Reference in New Issue
Block a user