Files
paint-ui/hooks/use-keyboard-shortcuts.ts
Sebastian Krüger 4f5c78df30 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

124 lines
2.7 KiB
TypeScript

import { useEffect } from 'react';
import { useHistoryStore } from '@/store/history-store';
/**
* Keyboard shortcuts configuration
*/
interface KeyboardShortcut {
key: string;
ctrl?: boolean;
shift?: boolean;
alt?: boolean;
meta?: boolean;
handler: () => void;
description: string;
}
/**
* Hook to manage keyboard shortcuts
*/
export function useKeyboardShortcuts() {
const { undo, redo, canUndo, canRedo } = useHistoryStore();
useEffect(() => {
const shortcuts: KeyboardShortcut[] = [
{
key: 'z',
ctrl: true,
shift: false,
handler: () => {
if (canUndo()) {
undo();
}
},
description: 'Undo',
},
{
key: 'z',
ctrl: true,
shift: true,
handler: () => {
if (canRedo()) {
redo();
}
},
description: 'Redo',
},
{
key: 'y',
ctrl: true,
handler: () => {
if (canRedo()) {
redo();
}
},
description: 'Redo (alternative)',
},
];
const handleKeyDown = (e: KeyboardEvent) => {
// Check if we're in an input field
const target = e.target as HTMLElement;
if (
target.tagName === 'INPUT' ||
target.tagName === 'TEXTAREA' ||
target.isContentEditable
) {
return;
}
for (const shortcut of shortcuts) {
const ctrlMatch = shortcut.ctrl ? (e.ctrlKey || e.metaKey) : !e.ctrlKey && !e.metaKey;
const shiftMatch = shortcut.shift ? e.shiftKey : !e.shiftKey;
const altMatch = shortcut.alt ? e.altKey : !e.altKey;
if (
e.key.toLowerCase() === shortcut.key.toLowerCase() &&
ctrlMatch &&
shiftMatch &&
altMatch
) {
e.preventDefault();
shortcut.handler();
break;
}
}
};
window.addEventListener('keydown', handleKeyDown);
return () => {
window.removeEventListener('keydown', handleKeyDown);
};
}, [undo, redo, canUndo, canRedo]);
}
/**
* Get keyboard shortcut display string
*/
export function getShortcutDisplay(shortcut: {
key: string;
ctrl?: boolean;
shift?: boolean;
alt?: boolean;
meta?: boolean;
}): string {
const parts: string[] = [];
const isMac = typeof navigator !== 'undefined' && /Mac|iPhone|iPad|iPod/.test(navigator.platform);
if (shortcut.ctrl || shortcut.meta) {
parts.push(isMac ? '⌘' : 'Ctrl');
}
if (shortcut.shift) {
parts.push(isMac ? '⇧' : 'Shift');
}
if (shortcut.alt) {
parts.push(isMac ? '⌥' : 'Alt');
}
parts.push(shortcut.key.toUpperCase());
return parts.join(isMac ? '' : '+');
}