Feature Specification: macOS Menus

Created: 2026-09-28

Status: Implemented; checked in the direct build's window on 2026-09-28 against a scratch daemon, every menu driven through System Events

Input: User request: "The menu options on MacOS are small, normally you'd have a File, Edit, Window, and Help menu."

The direct-download build showed winit's default menu: the app menu alone. The App Store build had its own app and Window menus (014). Both builds now show the menus a Mac app is expected to have, with the window's own commands in them.

User Scenarios & Testing (mandatory)

A Mac user presses ⌘N and the dialog for a new virtual port opens over the Endpoints page. They paste a name copied from elsewhere with ⌘V, or with Edit > Paste. ⌘2 shows the Routes page and ⌘, the Settings page. Help > Midi Harbor Help opens the documentation.

Why this priority: it is the whole request.

Independent Test: Open the window, read its menus through the accessibility interface, and choose each item, by click and by shortcut, checking what the window does.

Acceptance Scenarios:

Given the window is open, When the menu bar is read, Then it holds the app menu, File, Edit, View, Window and Help, as contracts/menus.md lists them.
Given a text field has the focus, When Cut, Copy, Paste or Select All is chosen, by click or by shortcut, Then the field acts as it does on the key alone, and typing afterwards is not read as a shortcut.
Given no daemon answers, When a New item is chosen, Then nothing opens, since the dialog could not create anything.

Requirements (mandatory)

Functional Requirements

FR-U01: The window on macOS MUST show an app menu, File, Edit, View, Window and Help, in both builds, with the shortcuts contracts/menus.md gives.
FR-U02: The Edit menu's items MUST act on the focused text field whether chosen by click or by shortcut.
FR-U03: The App Store build MUST keep what 014 gave its menus: Command-Q closing to the menu bar and Command-Option-Q quitting.

Success Criteria (mandatory)

Measurable Outcomes

SC-U01: Every command the menus list works from the menu bar, by click and by shortcut.

Assumptions

A View menu lists the pages, on ⌘1 onwards, beside the four menus the owner named, as Mac apps put navigation there.
Undo and Redo are left out: the text fields keep no history.
Help opens the project's documentation and issue list on GitHub in the default browser.

2.6 KiB Raw Blame History