Files
paint-ui/components/editor/editor-layout.tsx
Sebastian Krüger 5c4763cb62 feat(phase-12): add professional UI polish with status bar, navigator, and shortcuts help
Implements comprehensive quality-of-life improvements for professional editing experience:

**1. Status Bar Component** (`components/editor/status-bar.tsx`):
- Real-time canvas dimensions display (width × height)
- Live zoom percentage indicator
- Dynamic cursor position tracking in canvas coordinates
- FPS counter for performance monitoring
- Memory usage display (when browser supports performance.memory)
- Icons for each metric (Maximize2, ZoomIn, MousePointer, Activity, HardDrive)
- Fixed bottom position with clean UI
- Updates at 60 FPS for smooth cursor tracking
- Memory updates every 2 seconds to reduce overhead

**2. Mini-Map / Navigator** (`components/canvas/mini-map.tsx`):
- Live thumbnail preview of entire canvas
- Renders all visible layers with proper stacking order
- Checkerboard background for transparency visualization
- Interactive viewport indicator (blue rectangle with semi-transparent fill)
- Click or drag to pan viewport to different canvas areas
- Collapsible with expand/minimize toggle button
- Maintains canvas aspect ratio (max 200px)
- Positioned in bottom-right corner as floating overlay
- Zoom percentage display at bottom
- Smart scaling for optimal thumbnail size
- Cursor changes to pointer/grabbing during interaction

**3. Keyboard Shortcuts Help Panel** (`components/editor/shortcuts-help-panel.tsx`):
- Comprehensive list of 40+ keyboard shortcuts
- 7 categories: File, Edit, View, Tools, Layers, Transform, Adjustments, Help
- Real-time search filtering (searches action, category, keys, description)
- Beautiful kbd element styling for shortcut keys
- Modal overlay with backdrop blur
- Opens with `?` or `F1` keys
- Closes with `Esc` key or backdrop click
- Fully responsive with scrollable content
- Organized sections with category headers
- Shows key combinations with proper separators (+)
- Optional descriptions for special shortcuts (e.g., "Hold to pan")
- Footer with helpful hints

**Integration Changes:**

**Canvas Component** (`canvas-with-tools.tsx`):
- Added `onCursorMove` prop callback for cursor position reporting
- Modified `handlePointerMove` to report canvas coordinates
- Created `handlePointerLeave` to clear cursor when leaving canvas
- Integrated MiniMap component as overlay

**Editor Layout** (`editor-layout.tsx`):
- Added cursor position state management
- Integrated StatusBar at bottom of layout
- Added ShortcutsHelpPanel with state management
- Keyboard event handlers for `?` and `F1` to open shortcuts
- Cursor position passed down to CanvasWithTools and up to StatusBar

**Features:**
- Non-intrusive overlays that don't block canvas interaction
- All components optimized for performance
- Responsive design adapts to different screen sizes
- Professional appearance matching app theme
- Smooth animations and transitions
- Real-time updates without lag

**User Experience Improvements:**
- Quick access to all shortcuts via `?` or `F1`
- Always-visible status information in bottom bar
- Easy canvas navigation with mini-map
- Performance monitoring at a glance
- Professional editor feel with polished UI

All features tested and working smoothly with no performance impact.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 17:51:32 +01:00

219 lines
7.1 KiB
TypeScript

'use client';
import { useEffect, useState } from 'react';
import { useCanvasStore, useLayerStore } from '@/store';
import { useHistoryStore } from '@/store/history-store';
import { CanvasWithTools } from '@/components/canvas/canvas-with-tools';
import { FileMenu } from './file-menu';
import { ToolOptions } from './tool-options';
import { PanelDock } from './panel-dock';
import { ThemeToggle } from './theme-toggle';
import { StatusBar } from './status-bar';
import { ShortcutsHelpPanel } from './shortcuts-help-panel';
import { ToolPalette } from '@/components/tools';
import { useKeyboardShortcuts } from '@/hooks/use-keyboard-shortcuts';
import { useFileOperations } from '@/hooks/use-file-operations';
import { useDragDrop } from '@/hooks/use-drag-drop';
import { useClipboard } from '@/hooks/use-clipboard';
import { createLayerWithHistory } from '@/lib/layer-operations';
import { Plus, ZoomIn, ZoomOut, Maximize, Undo, Redo, Upload } from 'lucide-react';
import { cn } from '@/lib/utils';
export function EditorLayout() {
const { zoom, zoomIn, zoomOut, zoomToFit } = useCanvasStore();
const { layers } = useLayerStore();
const { undo, redo, canUndo, canRedo } = useHistoryStore();
const { handleDataTransfer } = useFileOperations();
const [cursorPos, setCursorPos] = useState<{ x: number; y: number } | undefined>();
const [showShortcuts, setShowShortcuts] = useState(false);
// Handle ? and F1 keys for shortcuts panel
useEffect(() => {
const handleKeyDown = (e: KeyboardEvent) => {
if (e.key === '?' || e.key === 'F1') {
e.preventDefault();
setShowShortcuts(true);
}
};
window.addEventListener('keydown', handleKeyDown);
return () => window.removeEventListener('keydown', handleKeyDown);
}, []);
// Enable keyboard shortcuts
useKeyboardShortcuts();
// Enable drag & drop
const { isDragging, handleDragOver, handleDragLeave, handleDrop } = useDragDrop(handleDataTransfer);
// Enable clipboard paste
useClipboard(handleDataTransfer);
// Initialize with a default layer (without history)
useEffect(() => {
if (layers.length === 0) {
const { createLayer } = useLayerStore.getState();
createLayer({
name: 'Layer 1',
width: 800,
height: 600,
// No fillColor - layer is transparent by default
});
}
}, []);
const handleNewLayer = () => {
createLayerWithHistory({
name: `Layer ${layers.length + 1}`,
width: 800,
height: 600,
});
};
const handleZoomToFit = () => {
// Approximate viewport size (accounting for panels)
const viewportWidth = window.innerWidth - 344; // Subtract sidebar width (64px tools + 280px panels)
const viewportHeight = window.innerHeight - 88; // Subtract toolbar height (48px header + 40px tool adjustments)
zoomToFit(viewportWidth, viewportHeight);
};
return (
<div
className="flex h-screen flex-col overflow-hidden"
onDragOver={handleDragOver}
onDragLeave={handleDragLeave}
onDrop={handleDrop}
>
{/* Drag overlay */}
{isDragging && (
<div className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 backdrop-blur-sm">
<div className="flex flex-col items-center gap-4 p-8 bg-card border-2 border-dashed border-primary rounded-lg">
<Upload className="h-16 w-16 text-primary" />
<p className="text-lg font-semibold text-foreground">
Drop image or project file
</p>
<p className="text-sm text-muted-foreground">
Supports: PNG, JPG, WEBP, .paint
</p>
</div>
</div>
)}
{/* Header Bar */}
<div className="flex h-12 items-center justify-between border-b border-border bg-card px-4">
{/* Left: Title and File Menu */}
<div className="flex items-center gap-4">
<h1 className="text-lg font-semibold bg-gradient-to-r from-primary via-accent to-primary bg-clip-text text-transparent">
Paint UI
</h1>
<FileMenu />
</div>
{/* Right: Controls */}
<div className="flex items-center gap-2">
{/* History controls */}
<button
onClick={undo}
disabled={!canUndo()}
className={cn(
'rounded-md p-2 transition-colors',
canUndo()
? 'hover:bg-accent text-foreground'
: 'text-muted-foreground cursor-not-allowed'
)}
title="Undo (Ctrl+Z)"
>
<Undo className="h-4 w-4" />
</button>
<button
onClick={redo}
disabled={!canRedo()}
className={cn(
'rounded-md p-2 transition-colors',
canRedo()
? 'hover:bg-accent text-foreground'
: 'text-muted-foreground cursor-not-allowed'
)}
title="Redo (Ctrl+Shift+Z)"
>
<Redo className="h-4 w-4" />
</button>
<div className="w-px h-6 bg-border mx-1" />
{/* Zoom controls */}
<button
onClick={zoomOut}
className="rounded-md p-2 hover:bg-accent transition-colors"
title="Zoom Out"
>
<ZoomOut className="h-4 w-4" />
</button>
<span className="min-w-[4rem] text-center text-sm text-muted-foreground">
{Math.round(zoom * 100)}%
</span>
<button
onClick={zoomIn}
className="rounded-md p-2 hover:bg-accent transition-colors"
title="Zoom In"
>
<ZoomIn className="h-4 w-4" />
</button>
<button
onClick={handleZoomToFit}
className="rounded-md p-2 hover:bg-accent transition-colors"
title="Fit to Screen"
>
<Maximize className="h-4 w-4" />
</button>
<div className="w-px h-6 bg-border mx-1" />
{/* Theme Toggle */}
<ThemeToggle />
<div className="w-px h-6 bg-border mx-1" />
{/* New Layer */}
<button
onClick={handleNewLayer}
className="flex items-center gap-2 rounded-md bg-primary px-3 py-1.5 text-sm font-medium text-primary-foreground hover:bg-primary/90 transition-colors"
>
<Plus className="h-4 w-4" />
New Layer
</button>
</div>
</div>
{/* Tool Adjustments Bar */}
<div className="flex h-10 items-center border-b border-border bg-card/50">
<ToolOptions />
</div>
{/* Main content */}
<div className="flex flex-1 overflow-hidden">
{/* Left: Tool Palette */}
<ToolPalette />
{/* Center: Canvas */}
<div className="flex-1">
<CanvasWithTools onCursorMove={setCursorPos} />
</div>
{/* Right: Panel Dock */}
<PanelDock />
</div>
{/* Status Bar */}
<StatusBar cursorX={cursorPos?.x} cursorY={cursorPos?.y} />
{/* Shortcuts Help Panel */}
<ShortcutsHelpPanel isOpen={showShortcuts} onClose={() => setShowShortcuts(false)} />
</div>
);
}