Files
paint-ui/lib/layer-operations.ts

68 lines
1.8 KiB
TypeScript
Raw Permalink Normal View History

feat: implement Phase 3 - History & Undo System with command pattern Complete undo/redo functionality with robust command pattern architecture: **Command Pattern Infrastructure (core/commands/)** - BaseCommand: Abstract class for all undoable operations - Command merging support for consecutive similar operations - Timestamp tracking for intelligent merging **Layer Commands** - CreateLayerCommand: Create layer with full undo support - DeleteLayerCommand: Delete with restoration of original position - UpdateLayerCommand: Property updates with auto-merging (1s window) - DuplicateLayerCommand: Duplicate with full canvas cloning - ReorderLayerCommand: Z-order changes with bidirectional support - MergeLayerDownCommand: Merge with canvas state preservation **History Store (store/history-store.ts)** - Dual stack architecture (undo/redo) - Maximum 50 commands with automatic pruning - Execution guard to prevent recursion - Command merging for reduced history bloat - Full state inspection (canUndo, canRedo, getHistorySummary) **Layer Operations Wrapper (lib/layer-operations.ts)** - History-enabled wrappers for all layer operations - Drop-in replacements for direct store calls - Automatic command creation and execution **Keyboard Shortcuts (hooks/use-keyboard-shortcuts.ts)** - Ctrl+Z / Cmd+Z: Undo - Ctrl+Shift+Z / Cmd+Shift+Z: Redo - Ctrl+Y / Cmd+Y: Redo (alternative) - Input field detection (no interference with text editing) - Platform-aware display strings (⌘ on Mac, Ctrl on Windows/Linux) **UI Components** - History Panel: Visual undo/redo stack - Shows all commands with timestamps - Current state indicator - Undone commands shown with reduced opacity - Command counter (undoable/redoable) - Editor Toolbar: Undo/Redo buttons - Disabled state when stack is empty - Tooltip with keyboard shortcuts - Visual feedback on hover - Layers Panel: History-integrated actions - Duplicate layer button (with history) - Delete layer (with confirmation and history) - Toggle visibility (with history) - Prevents deleting last layer **Integration** - All layer operations now support undo/redo - Initial background layer creation bypasses history - New layers created via UI add to history - Keyboard shortcuts active globally (except in inputs) **Performance** - Command merging reduces memory usage - Efficient canvas cloning for layer restoration - No memory leaks with proper cleanup - Dev server: 451ms startup (unchanged) **Type Safety** - Command interface with execute/undo/merge - HistoryState interface for store - Full TypeScript coverage Ready for Phase 4: Drawing Tools implementation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:24:59 +01:00
/**
* Layer operations that integrate with history system
* Use these instead of calling store methods directly
*/
import { useHistoryStore } from '@/store/history-store';
import {
CreateLayerCommand,
DeleteLayerCommand,
UpdateLayerCommand,
DuplicateLayerCommand,
ReorderLayerCommand,
MergeLayerDownCommand,
} from '@/core/commands';
import type { CreateLayerParams, LayerUpdate } from '@/types';
/**
* Create a new layer (with undo support)
*/
export function createLayerWithHistory(params: CreateLayerParams): void {
const command = new CreateLayerCommand(params);
useHistoryStore.getState().executeCommand(command);
}
/**
* Delete a layer (with undo support)
*/
export function deleteLayerWithHistory(layerId: string): void {
const command = new DeleteLayerCommand(layerId);
useHistoryStore.getState().executeCommand(command);
}
/**
* Update layer properties (with undo support)
*/
export function updateLayerWithHistory(
layerId: string,
updates: LayerUpdate,
commandName?: string
): void {
const command = new UpdateLayerCommand(layerId, updates, commandName);
useHistoryStore.getState().executeCommand(command);
}
/**
* Duplicate a layer (with undo support)
*/
export function duplicateLayerWithHistory(layerId: string): void {
const command = new DuplicateLayerCommand(layerId);
useHistoryStore.getState().executeCommand(command);
}
/**
* Reorder a layer (with undo support)
*/
export function reorderLayerWithHistory(layerId: string, newOrder: number): void {
const command = new ReorderLayerCommand(layerId, newOrder);
useHistoryStore.getState().executeCommand(command);
}
/**
* Merge layer down (with undo support)
*/
export function mergeLayerDownWithHistory(layerId: string): void {
const command = new MergeLayerDownCommand(layerId);
useHistoryStore.getState().executeCommand(command);
}