feat(phase-6): implement comprehensive file operations system

This commit completes Phase 6 of the paint-ui implementation, adding full
file import/export capabilities with drag-drop and clipboard support.

**New Files:**
- lib/file-utils.ts: Core file operations (open, save, export, project format)
- hooks/use-file-operations.ts: React hook for file operations
- hooks/use-drag-drop.ts: Drag & drop state management
- hooks/use-clipboard.ts: Clipboard paste event handling
- components/editor/file-menu.tsx: File menu dropdown component
- components/modals/export-dialog.tsx: Export dialog with format/quality options
- components/modals/new-image-dialog.tsx: New image dialog with presets
- components/modals/index.ts: Modals barrel export

**Updated Files:**
- components/editor/editor-layout.tsx: Integrated FileMenu, drag-drop overlay, clipboard paste
- components/editor/index.ts: Added file-menu export

**Features:**
- ✨ Create new images with dimension presets (Full HD, HD, 800x600, custom)
- ✨ Open image files (PNG, JPG, WEBP) as new layers
- ✨ Save/load .paint project files (JSON with base64 layer data)
- ✨ Export as PNG/JPEG/WEBP with quality control
- ✨ Drag & drop file upload with visual overlay
- ✨ Clipboard paste support (Ctrl+V)
- ✨ File type validation and error handling
- ✨ DataTransfer API integration for unified file handling

**Project File Format (.paint):**
- JSON structure with version, dimensions, layer metadata
- Base64-encoded PNG data for each layer
- Preserves layer properties (opacity, blend mode, order, visibility)

Build verified: ✓ Compiled successfully in 1233ms

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

Co-Authored-By: Claude <noreply@anthropic.com>

components/editor/editor-layout.tsx

@@ -6,21 +6,32 @@ import { useHistoryStore } from '@/store/history-store';
 import { CanvasWithTools } from '@/components/canvas/canvas-with-tools';
 import { LayersPanel } from '@/components/layers/layers-panel';
 import { HistoryPanel } from './history-panel';
+import { FileMenu } from './file-menu';
 import { ToolPalette, ToolSettings } from '@/components/tools';
 import { ColorPanel } from '@/components/colors';
 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 } from 'lucide-react';
+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();
 
   // 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) {
@@ -50,13 +61,34 @@ export function EditorLayout() {
   };
 
   return (
-    <div className="flex h-screen flex-col overflow-hidden">
+    <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>
+      )}
+
       {/* Toolbar */}
       <div className="flex h-14 items-center justify-between border-b border-border bg-card px-4">
-        <div className="flex items-center gap-2">
+        <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>
 
         {/* History controls */}

components/editor/file-menu.tsx

@@ -0,0 +1,135 @@
+'use client';
+
+import { useState, useRef } from 'react';
+import { useFileOperations } from '@/hooks/use-file-operations';
+import { ExportDialog } from '@/components/modals/export-dialog';
+import { NewImageDialog } from '@/components/modals/new-image-dialog';
+import {
+  FileImage,
+  FolderOpen,
+  Download,
+  Save,
+  ChevronDown,
+} from 'lucide-react';
+import { cn } from '@/lib/utils';
+
+export function FileMenu() {
+  const {
+    createNewImage,
+    handleFileInput,
+    exportImage,
+    saveProject,
+  } = useFileOperations();
+
+  const [isMenuOpen, setIsMenuOpen] = useState(false);
+  const [isNewDialogOpen, setIsNewDialogOpen] = useState(false);
+  const [isExportDialogOpen, setIsExportDialogOpen] = useState(false);
+  const fileInputRef = useRef<HTMLInputElement>(null);
+
+  const handleOpenFile = () => {
+    fileInputRef.current?.click();
+    setIsMenuOpen(false);
+  };
+
+  const handleFileChange = async (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target.files?.[0];
+    if (file) {
+      await handleFileInput(file);
+    }
+    // Reset input
+    if (fileInputRef.current) {
+      fileInputRef.current.value = '';
+    }
+  };
+
+  const handleSaveProject = () => {
+    saveProject('project');
+    setIsMenuOpen(false);
+  };
+
+  return (
+    <>
+      <div className="relative">
+        <button
+          onClick={() => setIsMenuOpen(!isMenuOpen)}
+          className="flex items-center gap-2 px-3 py-2 hover:bg-accent rounded-md transition-colors"
+        >
+          <span className="text-sm font-medium">File</span>
+          <ChevronDown className="h-4 w-4" />
+        </button>
+
+        {isMenuOpen && (
+          <>
+            <div
+              className="fixed inset-0 z-10"
+              onClick={() => setIsMenuOpen(false)}
+            />
+            <div className="absolute left-0 top-full mt-1 w-48 bg-card border border-border rounded-md shadow-lg z-20">
+              <button
+                onClick={() => {
+                  setIsNewDialogOpen(true);
+                  setIsMenuOpen(false);
+                }}
+                className="flex items-center gap-3 w-full px-4 py-2 text-sm hover:bg-accent transition-colors"
+              >
+                <FileImage className="h-4 w-4" />
+                New Image
+              </button>
+
+              <button
+                onClick={handleOpenFile}
+                className="flex items-center gap-3 w-full px-4 py-2 text-sm hover:bg-accent transition-colors"
+              >
+                <FolderOpen className="h-4 w-4" />
+                Open...
+              </button>
+
+              <div className="h-px bg-border my-1" />
+
+              <button
+                onClick={handleSaveProject}
+                className="flex items-center gap-3 w-full px-4 py-2 text-sm hover:bg-accent transition-colors"
+              >
+                <Save className="h-4 w-4" />
+                Save Project
+              </button>
+
+              <button
+                onClick={() => {
+                  setIsExportDialogOpen(true);
+                  setIsMenuOpen(false);
+                }}
+                className="flex items-center gap-3 w-full px-4 py-2 text-sm hover:bg-accent transition-colors"
+              >
+                <Download className="h-4 w-4" />
+                Export Image...
+              </button>
+            </div>
+          </>
+        )}
+      </div>
+
+      {/* Hidden file input */}
+      <input
+        ref={fileInputRef}
+        type="file"
+        accept="image/*,.paint"
+        onChange={handleFileChange}
+        className="hidden"
+      />
+
+      {/* Dialogs */}
+      <NewImageDialog
+        isOpen={isNewDialogOpen}
+        onClose={() => setIsNewDialogOpen(false)}
+        onCreate={createNewImage}
+      />
+
+      <ExportDialog
+        isOpen={isExportDialogOpen}
+        onClose={() => setIsExportDialogOpen(false)}
+        onExport={exportImage}
+      />
+    </>
+  );
+}

components/editor/index.ts

@@ -1,2 +1,3 @@
 export * from './editor-layout';
 export * from './history-panel';
+export * from './file-menu';

components/modals/export-dialog.tsx

@@ -0,0 +1,134 @@
+'use client';
+
+import { useState } from 'react';
+import { X, Download } from 'lucide-react';
+import { cn } from '@/lib/utils';
+
+interface ExportDialogProps {
+  isOpen: boolean;
+  onClose: () => void;
+  onExport: (format: 'png' | 'jpeg' | 'webp', quality: number, filename: string) => void;
+  defaultFilename?: string;
+}
+
+export function ExportDialog({
+  isOpen,
+  onClose,
+  onExport,
+  defaultFilename = 'image',
+}: ExportDialogProps) {
+  const [format, setFormat] = useState<'png' | 'jpeg' | 'webp'>('png');
+  const [quality, setQuality] = useState(100);
+  const [filename, setFilename] = useState(defaultFilename);
+
+  if (!isOpen) return null;
+
+  const handleExport = () => {
+    onExport(format, quality / 100, filename);
+    onClose();
+  };
+
+  return (
+    <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/50" onClick={onClose}>
+      <div
+        className="bg-card border border-border rounded-lg shadow-lg w-full max-w-md"
+        onClick={(e) => e.stopPropagation()}
+      >
+        {/* Header */}
+        <div className="flex items-center justify-between p-4 border-b border-border">
+          <h2 className="text-lg font-semibold text-card-foreground">Export Image</h2>
+          <button
+            onClick={onClose}
+            className="p-1 hover:bg-accent rounded transition-colors"
+          >
+            <X className="h-5 w-5" />
+          </button>
+        </div>
+
+        {/* Content */}
+        <div className="p-4 space-y-4">
+          {/* Filename */}
+          <div className="space-y-2">
+            <label className="text-sm font-medium text-card-foreground">
+              Filename
+            </label>
+            <input
+              type="text"
+              value={filename}
+              onChange={(e) => setFilename(e.target.value)}
+              className="w-full px-3 py-2 rounded-md border border-border bg-background text-foreground"
+              placeholder="Enter filename"
+            />
+          </div>
+
+          {/* Format */}
+          <div className="space-y-2">
+            <label className="text-sm font-medium text-card-foreground">
+              Format
+            </label>
+            <div className="grid grid-cols-3 gap-2">
+              {(['png', 'jpeg', 'webp'] as const).map((fmt) => (
+                <button
+                  key={fmt}
+                  onClick={() => setFormat(fmt)}
+                  className={cn(
+                    'py-2 px-4 rounded-md border-2 transition-colors uppercase',
+                    format === fmt
+                      ? 'border-primary bg-primary text-primary-foreground'
+                      : 'border-border hover:border-primary/50'
+                  )}
+                >
+                  {fmt}
+                </button>
+              ))}
+            </div>
+          </div>
+
+          {/* Quality (for JPEG/WEBP) */}
+          {(format === 'jpeg' || format === 'webp') && (
+            <div className="space-y-2">
+              <div className="flex justify-between items-center">
+                <label className="text-sm font-medium text-card-foreground">
+                  Quality
+                </label>
+                <span className="text-sm text-muted-foreground">{quality}%</span>
+              </div>
+              <input
+                type="range"
+                min="1"
+                max="100"
+                value={quality}
+                onChange={(e) => setQuality(Number(e.target.value))}
+                className="w-full"
+              />
+            </div>
+          )}
+
+          {/* Info */}
+          <div className="p-3 bg-muted rounded-md text-sm text-muted-foreground">
+            {format === 'png' && '• PNG: Lossless, supports transparency'}
+            {format === 'jpeg' && '• JPEG: Lossy, smaller file size, no transparency'}
+            {format === 'webp' && '• WEBP: Modern format, smaller size, supports transparency'}
+          </div>
+        </div>
+
+        {/* Footer */}
+        <div className="flex justify-end gap-2 p-4 border-t border-border">
+          <button
+            onClick={onClose}
+            className="px-4 py-2 rounded-md hover:bg-accent transition-colors"
+          >
+            Cancel
+          </button>
+          <button
+            onClick={handleExport}
+            className="flex items-center gap-2 px-4 py-2 rounded-md bg-primary text-primary-foreground hover:bg-primary/90 transition-colors"
+          >
+            <Download className="h-4 w-4" />
+            Export
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}

components/modals/index.ts

@@ -0,0 +1,2 @@
+export * from './export-dialog';
+export * from './new-image-dialog';

components/modals/new-image-dialog.tsx

@@ -0,0 +1,143 @@
+'use client';
+
+import { useState } from 'react';
+import { X, Image } from 'lucide-react';
+
+interface NewImageDialogProps {
+  isOpen: boolean;
+  onClose: () => void;
+  onCreate: (width: number, height: number, backgroundColor: string) => void;
+}
+
+const PRESETS = [
+  { name: 'Custom', width: 800, height: 600 },
+  { name: '1920×1080 (Full HD)', width: 1920, height: 1080 },
+  { name: '1280×720 (HD)', width: 1280, height: 720 },
+  { name: '800×600', width: 800, height: 600 },
+  { name: '640×480', width: 640, height: 480 },
+];
+
+export function NewImageDialog({ isOpen, onClose, onCreate }: NewImageDialogProps) {
+  const [width, setWidth] = useState(800);
+  const [height, setHeight] = useState(600);
+  const [backgroundColor, setBackgroundColor] = useState('#ffffff');
+
+  if (!isOpen) return null;
+
+  const handleCreate = () => {
+    onCreate(width, height, backgroundColor);
+    onClose();
+  };
+
+  return (
+    <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/50" onClick={onClose}>
+      <div
+        className="bg-card border border-border rounded-lg shadow-lg w-full max-w-md"
+        onClick={(e) => e.stopPropagation()}
+      >
+        {/* Header */}
+        <div className="flex items-center justify-between p-4 border-b border-border">
+          <h2 className="text-lg font-semibold text-card-foreground">New Image</h2>
+          <button
+            onClick={onClose}
+            className="p-1 hover:bg-accent rounded transition-colors"
+          >
+            <X className="h-5 w-5" />
+          </button>
+        </div>
+
+        {/* Content */}
+        <div className="p-4 space-y-4">
+          {/* Presets */}
+          <div className="space-y-2">
+            <label className="text-sm font-medium text-card-foreground">
+              Presets
+            </label>
+            <select
+              className="w-full px-3 py-2 rounded-md border border-border bg-background text-foreground"
+              onChange={(e) => {
+                const preset = PRESETS[Number(e.target.value)];
+                setWidth(preset.width);
+                setHeight(preset.height);
+              }}
+            >
+              {PRESETS.map((preset, index) => (
+                <option key={index} value={index}>
+                  {preset.name}
+                </option>
+              ))}
+            </select>
+          </div>
+
+          {/* Dimensions */}
+          <div className="grid grid-cols-2 gap-4">
+            <div className="space-y-2">
+              <label className="text-sm font-medium text-card-foreground">
+                Width
+              </label>
+              <input
+                type="number"
+                min="1"
+                max="4000"
+                value={width}
+                onChange={(e) => setWidth(Number(e.target.value))}
+                className="w-full px-3 py-2 rounded-md border border-border bg-background text-foreground"
+              />
+            </div>
+            <div className="space-y-2">
+              <label className="text-sm font-medium text-card-foreground">
+                Height
+              </label>
+              <input
+                type="number"
+                min="1"
+                max="4000"
+                value={height}
+                onChange={(e) => setHeight(Number(e.target.value))}
+                className="w-full px-3 py-2 rounded-md border border-border bg-background text-foreground"
+              />
+            </div>
+          </div>
+
+          {/* Background Color */}
+          <div className="space-y-2">
+            <label className="text-sm font-medium text-card-foreground">
+              Background Color
+            </label>
+            <div className="flex gap-2">
+              <input
+                type="color"
+                value={backgroundColor}
+                onChange={(e) => setBackgroundColor(e.target.value)}
+                className="w-20 h-10 rounded-md border border-border cursor-pointer"
+              />
+              <input
+                type="text"
+                value={backgroundColor}
+                onChange={(e) => setBackgroundColor(e.target.value)}
+                className="flex-1 px-3 py-2 rounded-md border border-border bg-background text-foreground font-mono uppercase"
+              />
+            </div>
+          </div>
+        </div>
+
+        {/* Footer */}
+        <div className="flex justify-end gap-2 p-4 border-t border-border">
+          <button
+            onClick={onClose}
+            className="px-4 py-2 rounded-md hover:bg-accent transition-colors"
+          >
+            Cancel
+          </button>
+          <button
+            onClick={handleCreate}
+            className="flex items-center gap-2 px-4 py-2 rounded-md bg-primary text-primary-foreground hover:bg-primary/90 transition-colors"
+          >
+            <Image className="h-4 w-4" />
+            Create
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}