46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
---
|
|
epic: 7
|
|
story: 7.5
|
|
title: "Global Hotkey (QuickCalc)"
|
|
status: draft
|
|
---
|
|
|
|
## Epic 7 — macOS App (Swift/SwiftUI)
|
|
**Goal:** A beautiful, native macOS app that feels like it belongs on the platform.
|
|
|
|
### Story 7.5: Global Hotkey (QuickCalc)
|
|
|
|
As a **macOS user**,
|
|
I want a configurable global hotkey that opens a floating QuickCalc panel,
|
|
So that I can type a quick calculation, copy the result, and dismiss without leaving my current workflow.
|
|
|
|
**Acceptance Criteria:**
|
|
|
|
**Given** the default configuration
|
|
**When** the user presses Option+Space from any application
|
|
**Then** a floating QuickCalc panel appears centered on screen
|
|
|
|
**Given** the QuickCalc panel is open
|
|
**When** the user types a calculation (e.g., `1920 / 3`)
|
|
**Then** the result is displayed immediately in the panel
|
|
|
|
**Given** the QuickCalc panel shows a result
|
|
**When** the user presses Cmd+C
|
|
**Then** the result value is copied to the system clipboard
|
|
|
|
**Given** the result has been copied
|
|
**When** the user presses Escape
|
|
**Then** the QuickCalc panel dismisses
|
|
|
|
**Given** the user wants to customize the hotkey
|
|
**When** the user opens CalcPad preferences and changes the QuickCalc shortcut
|
|
**Then** the new shortcut is immediately active and the old one is deregistered
|
|
|
|
**Given** another app has registered the same hotkey
|
|
**When** CalcPad attempts to register it
|
|
**Then** CalcPad notifies the user of the conflict and allows selecting an alternative
|
|
|
|
**Given** the QuickCalc panel is open
|
|
**When** the user presses Cmd+V to paste into the frontmost app
|
|
**Then** the panel dismisses first, then the paste occurs in the previously frontmost app (or the user can manually switch)
|