Merge pull request #49 from mrgoonie/goon

feat: clipboard improvements and editor settings persistence

Author: mrgoonie

.gitignore

@@ -70,4 +70,5 @@ prompt.md
 # Gemini CLI settings (symlink to .claude/.mcp.json)
 .gemini/settings.json
 .claude/settings.bak.json
-.claude/active-plan
+.claude/active-plan
+.claude

.repomixignore

@@ -0,0 +1,22 @@
+docs/*
+plans/*
+assets/*
+dist/*
+coverage/*
+build/*
+ios/*
+android/*
+tests/*
+__tests__/*
+__pycache__/*
+node_modules/*
+
+.opencode/*
+.claude/*
+.serena/*
+.pnpm-store/*
+.github/*
+.dart_tool/*
+.idea/*
+.husky/*
+.venv/*

CLAUDE.md

@@ -0,0 +1,46 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Role & Responsibilities
+
+Your role is to analyze user requirements, delegate tasks to appropriate sub-agents, and ensure cohesive delivery of features that meet specifications and architectural standards.
+
+## Workflows
+
+- Primary workflow: `./.claude/workflows/primary-workflow.md`
+- Development rules: `./.claude/workflows/development-rules.md`
+- Orchestration protocols: `./.claude/workflows/orchestration-protocol.md`
+- Documentation management: `./.claude/workflows/documentation-management.md`
+- And other workflows: `./.claude/workflows/*`
+
+**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
+**IMPORTANT:** You must follow strictly the development rules in `./.claude/workflows/development-rules.md` file.
+**IMPORTANT:** Before you plan or proceed any implementation, always read the `./README.md` file first to get context.
+**IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
+**IMPORTANT:** In reports, list any unresolved questions at the end, if any.
+
+## Python Scripts (Skills)
+
+When running Python scripts from `.claude/skills/`, use the venv Python interpreter:
+- **Linux/macOS:** `.claude/skills/.venv/bin/python3 scripts/xxx.py`
+- **Windows:** `.claude\skills\.venv\Scripts\python.exe scripts\xxx.py`
+
+This ensures packages installed by `install.sh` (google-genai, pypdf, etc.) are available.
+
+## Documentation Management
+
+We keep all important docs in `./docs` folder and keep updating them, structure like below:
+
+```
+./docs
+├── project-overview-pdr.md
+├── code-standards.md
+├── codebase-summary.md
+├── design-guidelines.md
+├── deployment-guide.md
+├── system-architecture.md
+└── project-roadmap.md
+```
+
+**IMPORTANT:** *MUST READ* and *MUST COMPLY* all *INSTRUCTIONS* in project `./CLAUDE.md`, especially *WORKFLOWS* section is *CRITICALLY IMPORTANT*, this rule is *MANDATORY. NON-NEGOTIABLE. NO EXCEPTIONS. MUST REMEMBER AT ALL TIMES!!!*

README.md

@@ -95,15 +95,35 @@ Coming soon. See GitHub releases for previews.
 
 ### Keyboard Shortcuts
 
+**Global Hotkeys (Customizable):**
 | Shortcut | Action |
 |----------|--------|
 | `Ctrl+PrintScreen` | Region capture (default) |
 | `PrintScreen` | Fullscreen capture |
 | `Ctrl+Shift+PrintScreen` | Window capture |
-| `Ctrl+S` | Export screenshot |
-| `Escape` | Cancel current operation |
 
-*Note: Global hotkeys are customizable in Settings → Hotkeys*
+*Customizable in Settings → Hotkeys*
+
+**Editor Shortcuts (App Window):**
+
+| Shortcut | Action |
+|----------|--------|
+| `V` | Select tool (pointer/move) |
+| `R` | Rectangle annotation |
+| `E` | Ellipse annotation |
+| `A` | Arrow annotation |
+| `L` | Line annotation |
+| `T` | Text annotation |
+| `C` | Crop tool |
+| `Ctrl+Z` | Undo annotation |
+| `Ctrl+Shift+Z` or `Ctrl+Y` | Redo annotation |
+| `Delete` / `Backspace` | Delete selected annotation |
+| `Escape` | Deselect / cancel crop mode |
+| `Ctrl+O` | Import image file |
+| `Ctrl+V` | Paste image from clipboard |
+| `Ctrl+S` | Quick save |
+| `Ctrl+Shift+S` | Export with format dialog |
+| `Ctrl+C` | Copy to clipboard |
 
 ---
 
@@ -132,7 +152,10 @@ Access via Settings icon in title bar (⚙️).
 
 #### Export
 - **Default format** - PNG or JPEG
-- **JPEG quality** - 0-100 (default: 95)
+- **JPEG quality** - 0-100 slider (default: 95)
+  - 95+ = visually lossless
+  - 75-90 = balanced (recommended)
+  - 50-75 = compressed (smaller files)
 - **Include background** - Apply gradient to exported image
 
 ### Editor Settings
@@ -332,17 +355,16 @@ Contributions welcome! Please:
 - PNG export
 - Configuration dialog
 
-### v1.1 (In Progress)
-- Advanced annotations (arrow, line, text)
-- Non-destructive cropping
-- Gradient backgrounds
-- JPEG export
-- Output aspect ratios
+### v1.2 (Completed)
+- Undo/redo ✓
+- Keyboard shortcuts ✓
+- Clipboard import ✓
+- JPEG quality control ✓
 
-### v1.2 (Planned)
-- Undo/redo
-- Keyboard shortcuts reference
+### v1.3 (Planned)
 - Dark/light theme toggle
+- Batch export operations
+- Cloud sync for settings
 
 ### v2.0 (Future)
 - Screen recording
@@ -415,12 +437,22 @@ See [LICENSE](./LICENSE) file for details.
 
 ## Changelog
 
+### v1.2 (2025-12-24)
+- ✨ Clipboard image import via Ctrl+V
+- ✨ Configurable JPEG compression quality (0-100 scale)
+- ✨ Comprehensive keyboard shortcuts for all tools
+- ✨ Tool selection via single-key shortcuts (V, R, E, A, L, T, C)
+- ✨ Editor annotations with Undo/Redo shortcuts
+- 🚀 Performance improvements for clipboard operations
+- 📝 Enhanced documentation with keyboard reference
+
 ### v1.1 (2025-12-03)
 - ✨ Add arrow and line annotations
 - ✨ Add text annotation tool
 - ✨ Implement non-destructive cropping
 - ✨ Add 24 gradient background presets
 - ✨ Support multiple output aspect ratios
+- ✨ Copy file path button + auto-copy on quick save
 - 🚀 Performance improvements for large images
 - 📝 Complete documentation suite
 

app.go

@@ -89,13 +89,9 @@ func (a *App) startup(ctx context.Context) {
 	a.lastWidth = cfg.Window.Width
 	a.lastHeight = cfg.Window.Height
 
-	// Handle "start minimized to tray" setting
+	// Track hidden state if app started minimized to tray (set via Wails StartHidden option)
 	if cfg.Startup.MinimizeToTray {
-		// Use goroutine with delay to let window fully initialize first
-		go func() {
-			time.Sleep(100 * time.Millisecond)
-			runtime.WindowHide(a.ctx)
-		}()
+		a.isWindowHidden = true
 	}
 }
 
@@ -750,3 +746,17 @@ func (a *App) SetSkippedVersion(version string) error {
 func (a *App) GetSkippedVersion() string {
 	return a.config.Update.SkippedVersion
 }
+
+// GetEditorConfig returns the current editor panel settings
+func (a *App) GetEditorConfig() *config.EditorConfig {
+	return &a.config.Editor
+}
+
+// SaveEditorConfig saves editor panel settings to persistent config
+func (a *App) SaveEditorConfig(editor *config.EditorConfig) error {
+	if editor == nil {
+		return nil
+	}
+	a.config.Editor = *editor
+	return a.config.Save()
+}