@raycast/api 1.38.0 → 1.38.1

package/api.d.ts

@@ -126,8 +126,9 @@ export declare namespace Action {
  * sections and can have keyboard shortcuts assigned.
  *
  * The first and second action become the primary and secondary action. They automatically get the default keyboard shortcuts assigned.
- * In {@link List} and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and
+ * In {@link List}, {@link Grid}, and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and
  * `⌘` `⇧` `↵` for the secondary.
+ * Keep in mind that while you can specify an alternative shortcut for the primary and secondary actions, it won't be displayed in the Action Panel.
  *
  * @example
  * ```typescript
@@ -198,9 +199,7 @@ declare type ActionPanelChildren_2 = ReactElement<ActionPanel.Section.Props> | R
  * @deprecated Use {@link Action} instead.
  */
 export declare const ActionPanelItem: FunctionComponent<ActionProps> & ConvenienceActions & {
-    Style: ActionStyle; /**
-    * @deprecated Use {@link Image.ImageLike} instead
-    */
+    Style: ActionStyle;
 };
 
 /**
@@ -382,7 +381,8 @@ declare interface ActionProps {
      *
      * @remarks
      * The first and second action in an {@link ActionPanel} become the primary and secondary action. They automatically get the default keyboard shortcuts assigned.
-     * In {@link List} and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and `⌘` `⇧` `↵` for the secondary.
+     * In {@link List}, {@link Grid} ,and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and `⌘` `⇧` `↵` for the secondary.
+     * Keep in mind that while you can specify an alternative shortcut for the primary and secondary actions, it won't be displayed in the Action Panel.
      */
     shortcut?: Keyboard.Shortcut | undefined | null;
     /**
@@ -537,7 +537,6 @@ export declare interface Application {
 }
 
 /**
- * @beta
  * A record type holding the arguments (entered in Raycast Root Search Bar) that have been passed to the command.
  */
 declare interface Arguments {
@@ -548,7 +547,6 @@ declare interface Arguments {
 }
 
 /**
- * @beta
  * An interface describing top-level props for arguments
  */
 export declare interface ArgumentsLaunchProps {
@@ -2131,7 +2129,6 @@ export declare interface Environment {
      */
     theme: "light" | "dark";
     /**
-     * @beta
      * The type of launch for the command (user initiated or background).
      */
     launchType: LaunchType;
@@ -4281,8 +4278,16 @@ export declare enum Icon {
     Network = "network-16",
     NewDocument = "new-document-16",
     NewFolder = "new-folder-16",
-    Number = "number-01-16",
     Number00 = "number-00-16",
+    Number01 = "number-01-16",
+    Number02 = "number-02-16",
+    Number03 = "number-03-16",
+    Number04 = "number-04-16",
+    Number05 = "number-05-16",
+    Number06 = "number-06-16",
+    Number07 = "number-07-16",
+    Number08 = "number-08-16",
+    Number09 = "number-09-16",
     Number10 = "number-10-16",
     Number11 = "number-11-16",
     Number12 = "number-12-16",
@@ -4684,7 +4689,6 @@ declare const Item: FunctionComponent<ItemProps> & ItemMembers;
 declare const Item_2: FunctionComponent<ItemProps_2>;
 
 /**
- * @beta
  * See {@link MenuBarExtra.Item}
  */
 declare const Item_3: FunctionComponent<ItemProps_3>;
@@ -4846,9 +4850,6 @@ declare interface ItemProps_2 extends ActionsInterface {
     actions?: ReactNode | null;
 }
 
-/**
- * @beta
- */
 declare interface ItemProps_3 {
     title: string;
     icon?: Image.ImageLike;
@@ -4973,14 +4974,10 @@ declare interface LabelProps_2 {
 }
 
 /**
- * @beta
  * The top-level props that a Command receives on launch
  */
 export declare type LaunchProps = ArgumentsLaunchProps | FormLaunchProps;
 
-/**
- * @beta
- */
 export declare enum LaunchType {
     /**
      * A regular launch through user interaction
@@ -5484,30 +5481,18 @@ export declare type LocalStorageValue = LocalStorage.Value;
 export declare interface LocalStorageValues extends LocalStorage.Values {
 }
 
-/**
- * @beta
- */
 export declare const MenuBarExtra: FunctionComponent<MenuBarExtraProps> & MenuBarExtraMembers;
 
-/**
- * @beta
- */
 export declare namespace MenuBarExtra {
     export type Props = MenuBarExtraProps;
 }
 
-/**
- * @beta
- */
 declare interface MenuBarExtraMembers {
     Item: typeof Item_3;
     Separator: typeof Separator_4;
     Submenu: typeof Submenu_2;
 }
 
-/**
- * @beta
- */
 declare interface MenuBarExtraProps {
     /**
      * @defaultValue `false`
@@ -6482,7 +6467,6 @@ declare const Separator_2: FunctionComponent<SeparatorProps_2>;
 declare const Separator_3: FunctionComponent<SeparatorProps_3>;
 
 /**
- * @beta
  * See {@link MenuBarExtra.Separator}
  */
 declare const Separator_4: FunctionComponent<SeparatorProps_4>;
@@ -6499,9 +6483,6 @@ declare interface SeparatorProps_2 {
 declare interface SeparatorProps_3 {
 }
 
-/**
- * @beta
- */
 declare interface SeparatorProps_4 {
 }
 
@@ -6667,7 +6648,6 @@ export declare const specialKeys: any;
 declare const Submenu: FunctionComponent<SubmenuProps>;
 
 /**
- * @beta
  * See {@link MenuBarExtra.Submenu}
  */
 declare const Submenu_2: FunctionComponent<SubmenuProps_2>;
@@ -6729,9 +6709,6 @@ declare interface SubmenuProps {
     onOpen?: () => void;
 }
 
-/**
- * @beta
- */
 declare interface SubmenuProps_2 {
     title: string | {
         value: string;
@@ -7211,7 +7188,6 @@ declare interface TrashProps {
 }
 
 /**
- * @beta
  * Update the values of properties declared in the manifest of a command.
  *
  * @param metadata - An object with the values for the manifest properties to update.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raycast/api",
-  "version": "1.38.0",
+  "version": "1.38.1",
   "description": "Build extensions for Raycast with React and Node.js.",
   "author": "Raycast Technologies Ltd.",
   "homepage": "https://developers.raycast.com",

package/types/index.d.ts

@@ -126,8 +126,9 @@ export declare namespace Action {
  * sections and can have keyboard shortcuts assigned.
  *
  * The first and second action become the primary and secondary action. They automatically get the default keyboard shortcuts assigned.
- * In {@link List} and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and
+ * In {@link List}, {@link Grid}, and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and
  * `⌘` `⇧` `↵` for the secondary.
+ * Keep in mind that while you can specify an alternative shortcut for the primary and secondary actions, it won't be displayed in the Action Panel.
  *
  * @example
  * ```typescript
@@ -198,9 +199,7 @@ declare type ActionPanelChildren_2 = ReactElement<ActionPanel.Section.Props> | R
  * @deprecated Use {@link Action} instead.
  */
 export declare const ActionPanelItem: FunctionComponent<ActionProps> & ConvenienceActions & {
-    Style: ActionStyle; /**
-    * @deprecated Use {@link Image.ImageLike} instead
-    */
+    Style: ActionStyle;
 };
 
 /**
@@ -382,7 +381,8 @@ declare interface ActionProps {
      *
      * @remarks
      * The first and second action in an {@link ActionPanel} become the primary and secondary action. They automatically get the default keyboard shortcuts assigned.
-     * In {@link List} and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and `⌘` `⇧` `↵` for the secondary.
+     * In {@link List}, {@link Grid} ,and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and `⌘` `⇧` `↵` for the secondary.
+     * Keep in mind that while you can specify an alternative shortcut for the primary and secondary actions, it won't be displayed in the Action Panel.
      */
     shortcut?: Keyboard.Shortcut | undefined | null;
     /**
@@ -536,6 +536,26 @@ export declare interface Application {
     bundleId?: string;
 }
 
+/**
+ * A record type holding the arguments (entered in Raycast Root Search Bar) that have been passed to the command.
+ */
+declare interface Arguments {
+    /**
+     * The representation of arguments given that key here is the `name` defined in manifest file and value is the user's input
+     */
+    [item: string]: any;
+}
+
+/**
+ * An interface describing top-level props for arguments
+ */
+export declare interface ArgumentsLaunchProps {
+    /**
+     * Use these values to populate the initial state for your command.
+     */
+    arguments?: Arguments;
+}
+
 /**
  * Caching abstraction that stores data on disk and supports LRU (least recently used) access.
  * Since extensions can only consume up to a max. heap memory size, the cache only maintains a lightweight index in memory
@@ -2108,7 +2128,10 @@ export declare interface Environment {
      * The theme used by the Raycast application.
      */
     theme: "light" | "dark";
-
+    /**
+     * The type of launch for the command (user initiated or background).
+     */
+    launchType: LaunchType;
 }
 
 /**
@@ -4255,8 +4278,16 @@ export declare enum Icon {
     Network = "network-16",
     NewDocument = "new-document-16",
     NewFolder = "new-folder-16",
-    Number = "number-01-16",
     Number00 = "number-00-16",
+    Number01 = "number-01-16",
+    Number02 = "number-02-16",
+    Number03 = "number-03-16",
+    Number04 = "number-04-16",
+    Number05 = "number-05-16",
+    Number06 = "number-06-16",
+    Number07 = "number-07-16",
+    Number08 = "number-08-16",
+    Number09 = "number-09-16",
     Number10 = "number-10-16",
     Number11 = "number-11-16",
     Number12 = "number-12-16",
@@ -4657,6 +4688,11 @@ declare const Item: FunctionComponent<ItemProps> & ItemMembers;
  */
 declare const Item_2: FunctionComponent<ItemProps_2>;
 
+/**
+ * See {@link MenuBarExtra.Item}
+ */
+declare const Item_3: FunctionComponent<ItemProps_3>;
+
 declare type ItemAccessory = ({
     /**
      * An optional text that will be used as the label.
@@ -4814,6 +4850,14 @@ declare interface ItemProps_2 extends ActionsInterface {
     actions?: ReactNode | null;
 }
 
+declare interface ItemProps_3 {
+    title: string;
+    icon?: Image.ImageLike;
+    tooltip?: string;
+    onAction?: () => void;
+    shortcut?: Keyboard.Shortcut;
+}
+
 export declare namespace Keyboard {
     /**
      * A keyboard shortcut is defined by one or more modifier keys (command, control, etc.) and a single key equivalent (a character or special key).
@@ -4929,6 +4973,22 @@ declare interface LabelProps_2 {
     text?: string;
 }
 
+/**
+ * The top-level props that a Command receives on launch
+ */
+export declare type LaunchProps = ArgumentsLaunchProps | FormLaunchProps;
+
+export declare enum LaunchType {
+    /**
+     * A regular launch through user interaction
+     */
+    UserInitiated = "userInitiated",
+    /**
+     * Scheduled through an interval and launched from background
+     */
+    Background = "background"
+}
+
 /**
  * See {@link Detail.Metadata.Link}
  */
@@ -5421,6 +5481,29 @@ export declare type LocalStorageValue = LocalStorage.Value;
 export declare interface LocalStorageValues extends LocalStorage.Values {
 }
 
+export declare const MenuBarExtra: FunctionComponent<MenuBarExtraProps> & MenuBarExtraMembers;
+
+export declare namespace MenuBarExtra {
+    export type Props = MenuBarExtraProps;
+}
+
+declare interface MenuBarExtraMembers {
+    Item: typeof Item_3;
+    Separator: typeof Separator_4;
+    Submenu: typeof Submenu_2;
+}
+
+declare interface MenuBarExtraProps {
+    /**
+     * @defaultValue `false`
+     */
+    isLoading?: boolean;
+    title?: string;
+    tooltip?: string;
+    icon?: Image.ImageLike;
+    children?: ReactNode;
+}
+
 /**
  * See {@link Detail.Metadata}
  */
@@ -6383,6 +6466,11 @@ declare const Separator_2: FunctionComponent<SeparatorProps_2>;
  */
 declare const Separator_3: FunctionComponent<SeparatorProps_3>;
 
+/**
+ * See {@link MenuBarExtra.Separator}
+ */
+declare const Separator_4: FunctionComponent<SeparatorProps_4>;
+
 /**
  * See {@link Form.Separator.Props}
  */
@@ -6395,6 +6483,9 @@ declare interface SeparatorProps_2 {
 declare interface SeparatorProps_3 {
 }
 
+declare interface SeparatorProps_4 {
+}
+
 /**
  * @deprecated Use {@link LocalStorage.setItem} instead
  */
@@ -6556,6 +6647,11 @@ export declare const specialKeys: any;
  */
 declare const Submenu: FunctionComponent<SubmenuProps>;
 
+/**
+ * See {@link MenuBarExtra.Submenu}
+ */
+declare const Submenu_2: FunctionComponent<SubmenuProps_2>;
+
 declare type SubmenuChildren = ReactElement<SectionProps> | ReactElement<SectionProps>[] | SectionChildren | null;
 
 /**
@@ -6613,6 +6709,15 @@ declare interface SubmenuProps {
     onOpen?: () => void;
 }
 
+declare interface SubmenuProps_2 {
+    title: string | {
+        value: string;
+        tooltip: string;
+    };
+    icon?: Image.ImageLike;
+    children?: ReactNode;
+}
+
 /**
  * See {@link Action.SubmitForm.Props}
  */
@@ -7082,6 +7187,28 @@ declare interface TrashProps {
     onTrash?: (paths: PathLike | PathLike[]) => void;
 }
 
+/**
+ * Update the values of properties declared in the manifest of a command.
+ *
+ * @param metadata - An object with the values for the manifest properties to update.
+ * Note that currently only `subtitle` is supported. Pass `null` to clear the custom subtitle.
+ * @returns A Promise that resolves when the metadata has been updated.
+ *
+ * @example
+ * ```typescript
+ * import { open } from "@raycast/api";
+ *
+ * export default async () => {
+ *   await updateCommandMetadata({ subtitle: "My new subtitle" });
+ * };
+ * ```
+ * @remarks The actual manifest file is not modified, so the update applies as
+ * long as the command remains installed.
+ */
+export declare function updateCommandMetadata(metadata: {
+    subtitle?: string | null;
+}): Promise<void>;
+
 /**
  * @deprecated No alternative :(
  */