Shortcut Priority Model

Summary

Prox OS shortcuts must preserve normal browser, editor, input, and iframe behavior while keeping Shell-level navigation predictable. Shortcut handling is resolved from broadest host intent to most local app intent.

Priority Order

1. Browser and OS reserved shortcuts

   • Do not hijack browser tab management, address bar, refresh, or system accessibility shortcuts.

2. Global Prox OS shortcuts

   • Ctrl/Cmd + K: Universal Command Palette.
   • Ctrl/Cmd + Shift + K: Switcher.
   • Ctrl + Shift + ArrowUp: Prox Mission Control.
   • Ctrl + Shift + ,/.: previous or next Studio session.

3. Studio-level shortcuts

   • Studio Engine shortcuts should only apply while that Studio is active.
   • Desktop Runtime, Atlas, Grid, Ops, and local-only development engines must not each invent a conflicting global switching model.

4. Scene-level shortcuts

   • Scene navigation changes layout state inside the active Studio.
   • Scene shortcuts should no-op when the Studio has only one Scene.
   • Ctrl + ,/.: previous or next Scene in the active Studio.

5. App-level shortcuts

   • App-specific commands are scoped to the focused app or declared app contract.
   • Editors, inputs, and iframe apps keep their own local shortcut priority unless an explicit app contract delegates a shortcut to the Shell.

Universal Command Palette

Ctrl/Cmd + K opens the Universal Command Palette as a Shell-level overlay. It is global and covers the workspace and Alma. The palette now separates:

• Runtime Search
• Studio Search

Future tabs can add Dataset Search, Command Search, Docs Search, and AI Actions.

Website mode does not block registered global shortcuts. If a shortcut needs the managed window runtime, the handler may move the shell back to OS mode as part of the action, but the keypress should not be replaced by a generic "return to OS mode" notice.

Switcher

Ctrl/Cmd + Shift + K opens the Switcher. It is a fast switcher for open, recent, and pinned Studios. It is not Mission Control and it is not the command palette.

Prox Mission Control

Ctrl + Shift + ArrowUp opens Prox Mission Control. It shows Studio sessions in the top band and Scenes for the active Studio in the main area.

Scene And Studio Navigation

Comma and period distinguish local and global switching:

• Ctrl + ,: previous Scene inside the active Studio.
• Ctrl + .: next Scene inside the active Studio.
• Ctrl + Shift + ,: previous Studio session.
• Ctrl + Shift + .: next Studio session.

These shortcuts should avoid firing while typing in inputs, rich-text editors, or iframe surfaces. Studio session switching is global. Scene switching is local to the active Studio and should gracefully no-op when no adjacent Scene exists.

Focused Fields And Iframes

Global shortcuts should avoid firing while a user types in input, textarea, contenteditable, CodeMirror, Monaco, or textbox-like targets unless the shortcut is explicitly global and documented. Iframe apps are isolated by default and may delegate future shortcuts through explicit app contracts or postMessage protocols.

Future Work

• central shortcut registry;
• user shortcut remapping;
• conflict diagnostics in Keyboard Shortcuts and Developer Tools;
• app manifest shortcut declarations;
• iframe delegation contracts.