@blastlauncher/runtime 1.0.1 → 3.0.0-alpha.0

package/dist/api/index.js

@@ -0,0 +1,82 @@
+export * from "./unsupported.generated.js";
+export { CopyToClipboard } from "./action.js";
+export { Image } from "./enums.generated.js";
+import { Image } from "./enums.generated.js";
+// Keep the stub-backed value while exposing the provider's erased type surface.
+import { AI as aiWithStubs } from "./unsupported.generated.js";
+export const AI = aiWithStubs;
+// Bind aliases to the public values, which include unsupported-member proxies.
+import { Action, ActionPanel as actionPanelWithStubs, Alert, Clipboard, Form as formWithStubs, List, LocalStorage, Toast, } from "./unsupported.generated.js";
+// Keep aliases on public facades without mutating the underlying implementations.
+export const ActionPanel = new Proxy(actionPanelWithStubs, {
+    get(target, key, receiver) {
+        return key === "Item" ? Action : Reflect.get(target, key, receiver);
+    },
+});
+const formAliases = {
+    DropdownItem: formWithStubs.Dropdown.Item,
+    DropdownSection: formWithStubs.Dropdown.Section,
+    TagPickerItem: formWithStubs.TagPicker.Item,
+};
+export const Form = new Proxy(formWithStubs, {
+    get(target, key, receiver) {
+        return Object.hasOwn(formAliases, key)
+            ? Reflect.get(formAliases, key)
+            : Reflect.get(target, key, receiver);
+    },
+});
+export const ActionPanelItem = Action;
+export const ActionPanelSection = ActionPanel.Section;
+export const ActionPanelSubmenu = ActionPanel.Submenu;
+export const AlertActionStyle = Alert.ActionStyle;
+export const CopyToClipboardAction = Action.CopyToClipboard;
+export const FormCheckbox = Form.Checkbox;
+export const FormDatePicker = Form.DatePicker;
+export const FormDropdown = Form.Dropdown;
+export const FormDropdownItem = Form.Dropdown.Item;
+export const FormDropdownSection = Form.Dropdown.Section;
+export const FormSeparator = Form.Separator;
+export const FormTagPicker = Form.TagPicker;
+export const FormTagPickerItem = Form.TagPicker.Item;
+export const FormTextArea = Form.TextArea;
+export const FormTextField = Form.TextField;
+export const ImageMask = Image.Mask;
+export const ListItem = List.Item;
+export const ListSection = List.Section;
+export const OpenAction = Action.Open;
+export const OpenInBrowserAction = Action.OpenInBrowser;
+export const OpenWithAction = Action.OpenWith;
+export const PasteAction = Action.Paste;
+export const PushAction = Action.Push;
+export const ShowInFinderAction = Action.ShowInFinder;
+export const SubmitFormAction = Action.SubmitForm;
+export const ToastStyle = Toast.Style;
+export const TrashAction = Action.Trash;
+export const allLocalStorageItems = LocalStorage.allItems;
+export const clearClipboard = Clipboard.clear;
+export const clearLocalStorage = LocalStorage.clear;
+export const copyTextToClipboard = Clipboard.copy;
+export const getLocalStorageItem = LocalStorage.getItem;
+export const pasteText = Clipboard.paste;
+export const removeLocalStorageItem = LocalStorage.removeItem;
+export const setLocalStorageItem = LocalStorage.setItem;
+export const unstable_AI = AI;
+/** @deprecated Use the key string directly. */
+export const specialKeys = Object.fromEntries([
+    "return",
+    "delete",
+    "deleteForward",
+    "tab",
+    "arrowUp",
+    "arrowDown",
+    "arrowLeft",
+    "arrowRight",
+    "pageUp",
+    "pageDown",
+    "home",
+    "end",
+    "space",
+    "escape",
+    "enter",
+    "backspace",
+].map((key) => [key, key]));

package/dist/api/keyboard.d.ts

@@ -0,0 +1,182 @@
+/** `Keyboard.KeyModifier`: the modifiers a shortcut may use. */
+export declare const KEY_MODIFIERS: readonly ["cmd", "ctrl", "opt", "shift", "alt", "windows"];
+export type KeyModifier = (typeof KEY_MODIFIERS)[number];
+/** `Keyboard.KeyEquivalent`: the keys a shortcut may use. */
+export declare const KEY_EQUIVALENTS: readonly ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", ".", ",", ";", "=", "+", "-", "[", "]", "{", "}", "«", "»", "(", ")", "/", "\\", "'", "`", "§", "^", "@", "$", "return", "delete", "deleteForward", "tab", "arrowUp", "arrowDown", "arrowLeft", "arrowRight", "pageUp", "pageDown", "home", "end", "space", "escape", "enter", "backspace"];
+export type KeyEquivalent = (typeof KEY_EQUIVALENTS)[number];
+export declare const Keyboard: {
+    Shortcut: {
+        Common: {
+            Copy: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            CopyDeeplink: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            CopyName: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            CopyPath: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            Save: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            Duplicate: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            Edit: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            MoveDown: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            MoveUp: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            New: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            Open: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            OpenWith: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            Pin: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            Refresh: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            Remove: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            RemoveAll: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+            ToggleQuickLook: {
+                macOS: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+                Windows: {
+                    modifiers: ("alt" | "cmd" | "ctrl" | "opt" | "shift" | "windows")[];
+                    key: "$" | "'" | "(" | ")" | "+" | "," | "-" | "." | "/" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | ";" | "=" | "@" | "[" | "\\" | "]" | "^" | "`" | "a" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowUp" | "b" | "backspace" | "c" | "d" | "delete" | "deleteForward" | "e" | "end" | "enter" | "escape" | "f" | "g" | "h" | "home" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "pageDown" | "pageUp" | "q" | "r" | "return" | "s" | "space" | "t" | "tab" | "u" | "v" | "w" | "x" | "y" | "z" | "{" | "}" | "§" | "«" | "»";
+                };
+            };
+        };
+    };
+};

package/dist/api/keyboard.js

@@ -0,0 +1,107 @@
+/** `Keyboard.KeyModifier`: the modifiers a shortcut may use. */
+export const KEY_MODIFIERS = ["cmd", "ctrl", "opt", "shift", "alt", "windows"];
+/** `Keyboard.KeyEquivalent`: the keys a shortcut may use. */
+export const KEY_EQUIVALENTS = [
+    "a",
+    "b",
+    "c",
+    "d",
+    "e",
+    "f",
+    "g",
+    "h",
+    "i",
+    "j",
+    "k",
+    "l",
+    "m",
+    "n",
+    "o",
+    "p",
+    "q",
+    "r",
+    "s",
+    "t",
+    "u",
+    "v",
+    "w",
+    "x",
+    "y",
+    "z",
+    "0",
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "6",
+    "7",
+    "8",
+    "9",
+    ".",
+    ",",
+    ";",
+    "=",
+    "+",
+    "-",
+    "[",
+    "]",
+    "{",
+    "}",
+    "«",
+    "»",
+    "(",
+    ")",
+    "/",
+    "\\",
+    "'",
+    "`",
+    "§",
+    "^",
+    "@",
+    "$",
+    "return",
+    "delete",
+    "deleteForward",
+    "tab",
+    "arrowUp",
+    "arrowDown",
+    "arrowLeft",
+    "arrowRight",
+    "pageUp",
+    "pageDown",
+    "home",
+    "end",
+    "space",
+    "escape",
+    "enter",
+    "backspace",
+];
+function shortcut(key, macOS, Windows, windowsKey = key) {
+    return { macOS: { modifiers: macOS, key }, Windows: { modifiers: Windows, key: windowsKey } };
+}
+// https://developers.raycast.com/api-reference/keyboard#keyboard.shortcut.common
+// The declarations supply the names; the public docs supply both platform mappings.
+export const Keyboard = {
+    Shortcut: {
+        Common: {
+            Copy: shortcut("c", ["cmd", "shift"], ["ctrl", "shift"]),
+            CopyDeeplink: shortcut("c", ["cmd", "shift"], ["ctrl", "shift"]),
+            CopyName: shortcut("c", ["cmd", "opt"], ["ctrl", "alt"]),
+            CopyPath: shortcut("c", ["cmd", "ctrl"], ["alt", "shift"]),
+            Save: shortcut("s", ["cmd"], ["ctrl"]),
+            Duplicate: shortcut("d", ["cmd"], ["ctrl", "shift"], "s"),
+            Edit: shortcut("e", ["cmd"], ["ctrl"]),
+            MoveDown: shortcut("arrowDown", ["cmd", "opt"], ["ctrl", "alt"]),
+            MoveUp: shortcut("arrowUp", ["cmd", "opt"], ["ctrl", "alt"]),
+            New: shortcut("n", ["cmd"], ["ctrl"]),
+            Open: shortcut("o", ["cmd"], ["ctrl"]),
+            OpenWith: shortcut("o", ["cmd", "shift"], ["ctrl", "shift"]),
+            Pin: shortcut(".", ["cmd"], ["ctrl"]),
+            Refresh: shortcut("r", ["cmd"], ["ctrl"]),
+            Remove: shortcut("x", ["ctrl"], ["ctrl"], "d"),
+            RemoveAll: shortcut("x", ["ctrl", "shift"], ["ctrl", "alt"], "d"),
+            ToggleQuickLook: shortcut("y", ["cmd"], ["ctrl"]),
+        },
+    },
+};

package/dist/api/launch.d.ts

@@ -0,0 +1,40 @@
+import type { FormValues } from "./form.js";
+import type { JsonValue } from "../reconciler/index.js";
+import { LaunchType } from "./enums.generated.js";
+export { LaunchType };
+/** `LaunchType`'s value union: the enum type from the declarations. */
+export type LaunchTypeValue = (typeof LaunchType)[keyof typeof LaunchType];
+/** `LaunchContext`: arbitrary JSON passed through `launchCommand({ context })`. */
+export type LaunchContext = Record<string, JsonValue>;
+/** `LaunchProps`: the top-level props a command receives on launch. */
+export type LaunchProps = {
+    /** Manifest argument values, keyed by the arguments' names. */
+    arguments: Record<string, string>;
+    launchType: LaunchTypeValue;
+    /** Only present when the command was started by `launchCommand`. */
+    launchContext?: LaunchContext;
+    draftValues?: FormValues;
+};
+/**
+ * `LaunchOptions`: command name and launch type, plus the fields the
+ * inter-extension form requires (`extensionName` and `ownerOrAuthorName`).
+ */
+export interface LaunchCommandOptions {
+    name: string;
+    type: LaunchTypeValue;
+    extensionName?: string;
+    ownerOrAuthorName?: string;
+    arguments?: Record<string, string> | null;
+    context?: LaunchContext | null;
+    fallbackText?: string | null;
+}
+/**
+ * Launches another command. Blast records the request and the host decides: a
+ * granted `command.launch` accepts it, a denial rejects it, and nothing starts
+ * a second session yet.
+ */
+export declare function launchCommand(options: LaunchCommandOptions): Promise<void>;
+/** Updates the current command's metadata in the host's own UI. */
+export declare function updateCommandMetadata(metadata: {
+    subtitle?: string | null;
+}): Promise<void>;

package/dist/api/launch.js

@@ -0,0 +1,27 @@
+import { requestCapability } from "./capability.js";
+import { LaunchType } from "./enums.generated.js";
+export { LaunchType };
+/**
+ * Launches another command. Blast records the request and the host decides: a
+ * granted `command.launch` accepts it, a denial rejects it, and nothing starts
+ * a second session yet.
+ */
+export async function launchCommand(options) {
+    const params = { name: options.name, type: options.type };
+    if (options.extensionName !== undefined)
+        params["extensionName"] = options.extensionName;
+    if (options.ownerOrAuthorName !== undefined) {
+        params["ownerOrAuthorName"] = options.ownerOrAuthorName;
+    }
+    if (options.arguments != null)
+        params["arguments"] = options.arguments;
+    if (options.context != null)
+        params["context"] = options.context;
+    if (options.fallbackText != null)
+        params["fallbackText"] = options.fallbackText;
+    await requestCapability("command.launch", params);
+}
+/** Updates the current command's metadata in the host's own UI. */
+export async function updateCommandMetadata(metadata) {
+    await requestCapability("command.metadata", metadata.subtitle === undefined ? {} : { subtitle: metadata.subtitle });
+}

package/dist/api/legacy.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+/** @deprecated Add `nanoid` as a dependency and use it instead. */
+export declare function randomId(): string;
+/** @deprecated Use `useRef` with `nanoid`. */
+export declare function useId(): string;
+/** Installs the command-root renderer before the runtime imports an extension. */
+export declare function setRenderMount(next: ((element: ReactNode) => void) | undefined): void;
+/** @deprecated Use `export default function Command() { ... }` instead. */
+export declare function render(element: ReactNode): void;

package/dist/api/legacy.js

@@ -0,0 +1,25 @@
+// Deprecated top-level helpers from `@raycast/api`: id generation and the
+// legacy `render` entry point that mounted a command's root element itself.
+import { useRef } from "react";
+/** @deprecated Add `nanoid` as a dependency and use it instead. */
+export function randomId() {
+    return crypto.randomUUID();
+}
+/** @deprecated Use `useRef` with `nanoid`. */
+export function useId() {
+    // One id per component instance, stable across re-renders.
+    const id = useRef(undefined);
+    id.current ??= randomId();
+    return id.current;
+}
+let mount;
+/** Installs the command-root renderer before the runtime imports an extension. */
+export function setRenderMount(next) {
+    mount = next;
+}
+/** @deprecated Use `export default function Command() { ... }` instead. */
+export function render(element) {
+    if (!mount)
+        throw new Error("render: no command root is mounted");
+    mount(element);
+}