@raycast/api 1.43.2 → 1.45.0

package/api.d.ts

@@ -550,13 +550,8 @@ declare interface Arguments {
     [item: string]: any;
 }
 
-/**
- * An interface describing top-level props for arguments
- */
+/** @deprecated Use {@Link LaunchProps} directly */
 export declare interface ArgumentsLaunchProps {
-    /**
-     * Use these values to populate the initial state for your command.
-     */
     arguments?: Arguments;
 }
 
@@ -732,7 +727,7 @@ export declare namespace Clipboard {
      * };
      * ```
      */
-    export function copy(content: string | Content): Promise<void>;
+    export function copy(content: string | number | Content): Promise<void>;
     /**
      * Clears the current clipboard contents.
      *
@@ -763,7 +758,7 @@ export declare namespace Clipboard {
      * };
      * ```
      */
-    export function paste(content: string | Content): Promise<void>;
+    export function paste(content: string | number | Content): Promise<void>;
     /**
      * Reads the clipboard as plain text.
      *
@@ -804,19 +799,26 @@ export declare namespace Clipboard {
     } | {
         /**
          * The file representation of the content.
-         *
-         * @remarks
-         * At the moment only file paths represented as a string are supported.
          */
         file: PathLike;
+    } | {
+        /**
+         * The HTML representation of the content.
+         */
+        html: string;
+        /**
+         * The alternative text representation of the content.
+         */
+        text?: string;
     };
 }
 
 /**
  * Closes the main Raycast window.
  *
- * @param options - Can be used to clear the root search. Defaults to not clearing the root search after
- * the window was closed.
+ * @param options - A parameter object with the properties:
+ * `clearRootSearch`: clears the text in the root search bar and scrolls to the top; default is `false`
+ * `popToRootType`: defines the pop to root behavior ({@link PopToRootType}); the default is to to respect the user's "Pop to Root Search" preference in Raycast
  * @returns A Promise that resolves when the main window is closed.
  *
  * @example
@@ -832,6 +834,7 @@ export declare namespace Clipboard {
  */
 export declare function closeMainWindow(options?: {
     clearRootSearch?: boolean;
+    popToRootType?: PopToRootType;
 }): Promise<void>;
 
 /**
@@ -849,7 +852,6 @@ export declare function closeMainWindow(options?: {
  *  <List>
  *    <List.Item title="Blue" icon={{ source: Icon.Circle, tintColor: Color.Blue }} />
  *    <List.Item title="Green" icon={{ source: Icon.Circle, tintColor: Color.Green }} />
- *    <List.Item title="Brown" icon={{ source: Icon.Circle, tintColor: Color.Brown }} />
  *    <List.Item title="Magenta" icon={{ source: Icon.Circle, tintColor: Color.Magenta }} />
  *    <List.Item title="Orange" icon={{ source: Icon.Circle, tintColor: Color.Orange }} />
  *    <List.Item title="Purple" icon={{ source: Icon.Circle, tintColor: Color.Purple }} />
@@ -864,7 +866,6 @@ export declare function closeMainWindow(options?: {
  */
 export declare enum Color {
     Blue = "raycast-blue",
-    Brown = "raycast-brown",
     Green = "raycast-green",
     Magenta = "raycast-magenta",
     Orange = "raycast-orange",
@@ -949,6 +950,12 @@ export declare namespace Color {
      * - Keywords, e.g. `red`
      */
     export type Raw = string;
+    /** The standard colors. Use those colors for consistency.
+     *
+     * @remarks
+     * The colors automatically adapt to the Raycast theme (light or dark).
+     */
+    const Brown: Color.Dynamic;
 }
 
 /**
@@ -1313,9 +1320,9 @@ export declare interface CopyToClipboardActionProps extends Action.CopyToClipboa
  */
 declare interface CopyToClipboardProps {
     /**
-     * The contents that will be written to the clipboard as string.
+     * The contents that will be copied to the clipboard.
      */
-    content: string | number;
+    content: string | number | Clipboard.Content;
     /**
      * An optional title for the action.
      * @defaultValue `"Copy to Clipboard"`
@@ -1336,7 +1343,7 @@ declare interface CopyToClipboardProps {
      * @remarks
      * This is handy when you want to act on the copied content, e.g. up-rank recently copied content.
      */
-    onCopy?: (content: string | number) => void;
+    onCopy?: (content: string | number | Clipboard.Content) => void;
 }
 
 /**
@@ -1878,14 +1885,20 @@ declare interface DropdownMembers_2 {
 /**
  * See {@link Form.Dropdown.Props}
  */
-declare interface DropdownProps extends FormItemProps_2<string> {
+declare interface DropdownProps extends FormItemProps_2<string>, SearchBarInterface {
+    /**
+     * Placeholder text that will be shown in the dropdown search field.
+     *
+     * @defaultValue `"Search..."`
+     */
+    placeholder?: string;
     /**
      * Sections or items. If {@link Form.Dropdown.Item} elements are specified, a default section is automatically created.
      */
     children?: ReactNode;
 }
 
-declare interface DropdownProps_2 {
+declare interface DropdownProps_2 extends SearchBarInterface {
     /**
      * ID of the dropdown.
      */
@@ -2032,12 +2045,16 @@ export declare interface Environment {
      * The theme used by the Raycast application.
      */
     theme: "light" | "dark";
+    /**
+     * The text size used by the Raycast application.
+     */
+    textSize: "medium" | "large";
     /**
      * The type of launch for the command (user initiated or background).
      */
     launchType: LaunchType;
     /**
-     * Any custom context values passed from a programmatic command launch via `launchCommand`.
+     * @deprecated Use the top-level prop `launchContext` instead.
      */
     launchContext?: LaunchContext;
 }
@@ -3048,14 +3065,8 @@ declare interface FormItemRef {
     reset: () => void;
 }
 
-/**
- * An interface describing top-level props for Form drafts
- */
+/** @deprecated Use {@Link LaunchProps} directly */
 export declare interface FormLaunchProps {
-    /**
-     * When a user enters the command via a draft, this object will contain the user inputs that were saved as a draft.
-     * Use its values to populate the initial state for your Form.
-     */
     draftValues?: Form.Values;
 }
 
@@ -3748,7 +3759,7 @@ export declare function getApplications(path?: PathLike): Promise<Application[]>
  * Returns the default application that the file would be opened with.
  *
  * @param path - The path of the file or folder to get the default application for.
- * @returns The default {@link Application} that would open the file. Throws an error if no application was found.
+ * @returns A Promise that resolves with the default {@link Application} that would open the file. If no application was found, the promise will be rejected.
  *
  * @example
  * ```typescript
@@ -3762,6 +3773,23 @@ export declare function getApplications(path?: PathLike): Promise<Application[]>
  */
 export declare function getDefaultApplication(path: PathLike): Promise<Application>;
 
+/**
+ * Returns the frontmost application.
+ *
+ * @returns A Promise that resolves with the frontmost {@link Application}. If no application was found, the promise will be rejected.
+ *
+ * @example
+ * ```typescript
+ * import { getFrontmostApplication } from "@raycast/api";
+ *
+ * export default async () => {
+ *   const frontmostApplication = await getFrontmostApplication();
+ *   console.log(`The frontmost application is: ${frontmostApplication.name}`);
+ * };
+ * ```
+ */
+export declare function getFrontmostApplication(): Promise<Application>;
+
 /**
  * @deprecated Use {@link LocalStorage.getItem} instead
  */
@@ -3796,8 +3824,7 @@ export declare function getPreferenceValues<Values extends PreferenceValues = Pr
 /**
  * Gets the selected items from Finder.
  *
- * @throws An error when Finder is not the frontmost application.
- * @returns A Promise that resolves with the selected file system items.
+ * @returns A Promise that resolves with the selected file system items. If Finder is not the frontmost application, the promise will be rejected.
  *
  * @example
  * ```typescript
@@ -3824,8 +3851,7 @@ export declare function getSelectedFinderItems(): Promise<FileSystemItem[]>;
 /**
  * Gets the selected text of the frontmost application.
  *
- * @throws An error when no text is selected in the frontmost application.
- * @returns A Promise that resolves with the selected text.
+ * @returns A Promise that resolves with the selected text. If no text is selected in the frontmost application, the promise will be rejected.
  *
  * @example
  * ```typescript
@@ -4138,7 +4164,7 @@ declare interface GridMembers {
     Dropdown: typeof Dropdown_2;
 }
 
-declare interface GridProps extends ActionsInterface, NavigationChildInterface {
+declare interface GridProps extends ActionsInterface, NavigationChildInterface, SearchBarInterface {
     /**
      * A reference to an {@link ActionPanel}. It will only be shown when there aren't any children.
      */
@@ -4198,19 +4224,6 @@ declare interface GridProps extends ActionsInterface, NavigationChildInterface {
      * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
      */
     enableFiltering?: boolean;
-    /**
-     * Toggles Raycast filtering. When `true`, Raycast will use the query in the search bar to filter the
-     * items. When `false`, the extension needs to take care of the filtering.
-     *
-     * You can further define how native filtering orders grid sections by setting an object with a `keepSectionOrder` property:
-     * When `true`, ensures that Raycast filtering maintains the section order as defined in the extension.
-     * When `false`, filtering may change the section order depending on the ranking values of the items.
-     *
-     * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
-     */
-    filtering?: boolean | {
-        keepSectionOrder: boolean;
-    };
     /**
      * Placeholder text that will be shown in the search bar.
      *
@@ -4221,19 +4234,6 @@ declare interface GridProps extends ActionsInterface, NavigationChildInterface {
      * Selects the item with the specified id.
      */
     selectedItemId?: string;
-    /**
-     * Defines whether the {@link Grid.Props.onSearchTextChange} will be triggered on every keyboard press or with a delay for throttling the events.
-     * Recommended to set to `true` when using custom filtering logic with asynchronous operations (e.g. network requests).
-     * @defaultValue `false`
-     */
-    throttle?: boolean;
-    /**
-     * Callback triggered when the search bar text changes.
-     *
-     * @remarks
-     * Specifying this implicitly toggles `filtering` to false. To enable native filtering when using `onSearchTextChange`, explicitly set `filtering` to true.
-     */
-    onSearchTextChange?: (text: string) => void;
 }
 
 /**
@@ -4883,14 +4883,34 @@ declare const Item_3: FunctionComponent<ItemProps_3>;
 
 declare type ItemAccessory = ({
     /**
-     * An optional text that will be used as the label.
+     * An optional text that will be used as the label, optionally colored.
+     * Color changes the text color to the provided color.
+     * Defaults to {@link Color.SecondaryText}.
+     */
+    text?: string | undefined | null | {
+        value: string | undefined | null;
+        color?: Color;
+    };
+} | {
+    /**
+     * An optional Date that will be used as the label, optionally colored. The date is formatted relatively to the current time (for example `new Date()` will be displayed as `"now"`, yesterday's Date will be displayed as "1d", etc.).
+     * Color changes the text color to the provided color.
+     * Defaults to {@link Color.SecondaryText}.
      */
-    text?: string | undefined | null;
+    date?: Date | undefined | null | {
+        value: Date | undefined | null;
+        color?: Color;
+    };
 } | {
     /**
-     * An optional Date that will be used as the label. The date is formatted relatively to the current time (for example `new Date()` will be displayed as `"now"`, yesterday's Date will be displayed as "1d", etc.).
+     * A string or Date that will be used as the label, optionally colored. The date is formatted relatively to the current time (for example `new Date()` will be displayed as `"now"`, yesterday's Date will be displayed as "1d", etc.).
+     * Color changes the text color to the provided color and sets a transparent background with the same color.
+     * Defaults to {@link Color.SecondaryText}.
      */
-    date?: Date | undefined | null;
+    tag: string | Date | undefined | null | {
+        value: string | Date | undefined | null;
+        color?: Color;
+    };
 }) & {
     /**
      * An optional {@link Image.ImageLike} that will be used as the icon.
@@ -4967,14 +4987,14 @@ declare interface ItemProps extends ActionsInterface {
      */
     title: string | {
         value: string;
-        tooltip: string;
+        tooltip?: string | null;
     };
     /**
      * An optional subtitle displayed next to the main title, optionally with a tooltip.
      */
     subtitle?: string | {
-        value: string | undefined | null;
-        tooltip: string;
+        value?: string | null;
+        tooltip?: string | null;
     };
     /**
      * An optional property used for providing additional indexable strings for search.
@@ -5072,7 +5092,7 @@ declare interface ItemProps_3 {
      */
     title: string;
     /**
-     * The subtitle displayed for this item in a slightly dimmed text color.
+     * The subtitle displayed for this item.
      */
     subtitle?: string;
     /**
@@ -5184,8 +5204,12 @@ declare interface LabelProps {
     icon?: Image.ImageLike | undefined | null;
     /**
      * The text value of the item.
+     * Specifying `color` will display the text in the provided color. Defaults to {@link Color.SecondaryText}.
      */
-    text?: string;
+    text?: string | {
+        value: string;
+        color?: Color | null;
+    };
 }
 
 /**
@@ -5226,7 +5250,37 @@ declare interface LaunchContext {
 /**
  * The top-level props that a Command receives on launch
  */
-export declare type LaunchProps = ArgumentsLaunchProps | FormLaunchProps;
+export declare type LaunchProps<T extends {
+    arguments?: Arguments;
+    draftValues?: Form.Values;
+    launchContext?: LaunchContext;
+} = {
+    arguments: Arguments;
+    draftValues: Form.Values;
+    launchContext?: LaunchContext;
+}> = {
+    /**
+     * The type of launch for the command (user initiated or background).
+     */
+    launchType: LaunchType;
+    /**
+     * Use these values to populate the initial state for your command.
+     */
+    arguments: T["arguments"];
+    /**
+     * When a user enters the command via a draft, this object will contain the user inputs that were saved as a draft.
+     * Use its values to populate the initial state for your Form.
+     */
+    draftValues?: T["draftValues"];
+    /**
+     * When the command is launched programmatically via `launchCommand`, this object contains the value passed to `context`.
+     */
+    launchContext?: T["launchContext"];
+    /**
+     * When the command is launched as a fallback command, this string contains the text of the root search.
+     */
+    fallbackText?: string;
+};
 
 export declare enum LaunchType {
     /**
@@ -5567,7 +5621,7 @@ declare interface ListMembers {
 export declare interface ListProps extends List.Props {
 }
 
-declare interface ListProps_2 extends ActionsInterface, NavigationChildInterface {
+declare interface ListProps_2 extends ActionsInterface, NavigationChildInterface, SearchBarInterface {
     /**
      * A reference to an {@link ActionPanel}. It will only be shown when there aren't any children.
      */
@@ -5602,19 +5656,6 @@ declare interface ListProps_2 extends ActionsInterface, NavigationChildInterface
      * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
      */
     enableFiltering?: boolean;
-    /**
-     * Toggles Raycast filtering. When `true`, Raycast will use the query in the search bar to filter the
-     * items. When `false`, the extension needs to take care of the filtering.
-     *
-     * You can further define how native filtering orders list sections by setting an object with a `keepSectionOrder` property:
-     * When `true`, ensures that Raycast filtering maintains the section order as defined in the extension.
-     * When `false`, filtering may change the section order depending on the ranking values of list items.
-     *
-     * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
-     */
-    filtering?: boolean | {
-        keepSectionOrder: boolean;
-    };
     /**
      * Placeholder text that will be shown in the search bar.
      *
@@ -5625,19 +5666,6 @@ declare interface ListProps_2 extends ActionsInterface, NavigationChildInterface
      * Selects the item with the specified id.
      */
     selectedItemId?: string;
-    /**
-     * Defines whether the {@link List.Props.onSearchTextChange} will be triggered on every keyboard press or with a delay for throttling the events.
-     * Recommended to set to `true` when using custom filtering logic with asynchronous operations (e.g. network requests).
-     * @defaultValue `false`
-     */
-    throttle?: boolean;
-    /**
-     * Callback triggered when the search bar text changes.
-     *
-     * @remarks
-     * Specifying this implicitly toggles `filtering` to false. To enable native filtering when using `onSearchTextChange`, explicitly set `filtering` to `true`.
-     */
-    onSearchTextChange?: (text: string) => void;
     /**
      * Whether the List should have an area on the right side of the items to show additional details about the selected item.
      *
@@ -6039,10 +6067,10 @@ export declare namespace OAuth {
              */
             providerName: string;
             /**
-             * An icon referenced from the assets folder, displayed in the OAuth overlay.
+             * An icon displayed in the OAuth overlay.
              * Make sure to provide at least a size of 64x64 pixels.
              */
-            providerIcon: string;
+            providerIcon?: Image.ImageLike;
             /**
              * An optional ID for associating the client with a provider.
              * Only set this if you use multiple different clients in your extension.
@@ -6074,7 +6102,7 @@ export declare namespace OAuth {
     export class PKCEClient {
         redirectMethod: RedirectMethod;
         providerName: string;
-        providerIcon: string;
+        providerIcon?: Image.ImageLike;
         providerId?: string;
         description?: string;
         private resolvesOnRedirect?;
@@ -6541,12 +6569,12 @@ export declare interface PasteActionProps extends Action.Paste.Props {
  */
 declare interface PasteProps {
     /**
-     * The contents that will be written to the clipboard as string.
+     * The contents that will be pasted to the frontmost application.
      */
-    content: string | number;
+    content: string | number | Clipboard.Content;
     /**
      * An optional title for the action.
-     * @defaultValue `"Paste in Active app"`
+     * @defaultValue `"Paste in Active App"`
      */
     title?: string;
     /**
@@ -6564,7 +6592,7 @@ declare interface PasteProps {
      * @remarks
      * This is handy when you want to act on the pasted content, e.g. up-rank recently pasted content.
      */
-    onPaste?: (content: string | number) => void;
+    onPaste?: (content: string | number | Clipboard.Content) => void;
 }
 
 /**
@@ -6599,6 +6627,24 @@ export declare function popToRoot(options?: {
     clearSearchBar?: boolean;
 }): Promise<void>;
 
+/**
+ * Defines the pop to root behavior when the main window is closed.
+ */
+export declare enum PopToRootType {
+    /**
+     * Respects the user's "Pop to Root Search" preference in Raycast
+     */
+    Default = "default",
+    /**
+     * Immediately pops back to root
+     */
+    Immediate = "immediate",
+    /**
+     * Prevents Raycast from popping back to root
+     */
+    Suspended = "suspended"
+}
+
 /**
  * @deprecated Use {@link getPreferenceValues} instead.
  */
@@ -6768,6 +6814,44 @@ export declare const removeLocalStorageItem: typeof LocalStorage.removeItem;
  */
 export declare const render: any;
 
+/**
+ * Views that support a search bar.
+ */
+declare interface SearchBarInterface {
+    /**
+     * Toggles Raycast filtering. When `true`, Raycast will use the query in the search bar to filter the
+     * items. When `false`, the extension needs to take care of the filtering.
+     *
+     * You can further define how native filtering orders sections by setting an object with a `keepSectionOrder` property:
+     * When `true`, ensures that Raycast filtering maintains the section order as defined in the extension.
+     * When `false`, filtering may change the section order depending on the ranking values of items.
+     *
+     * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
+     */
+    filtering?: boolean | {
+        keepSectionOrder: boolean;
+    };
+    /**
+     * Indicates whether a loading indicator should be shown or hidden next to the search bar
+     *
+     * @defaultValue `false`
+     */
+    isLoading?: boolean;
+    /**
+     * Defines whether the `onSearchTextChange` handler will be triggered on every keyboard press or with a delay for throttling the events.
+     * Recommended to set to `true` when using custom filtering logic with asynchronous operations (e.g. network requests).
+     * @defaultValue `false`
+     */
+    throttle?: boolean;
+    /**
+     * Callback triggered when the search bar text changes.
+     *
+     * @remarks
+     * Specifying this implicitly toggles `filtering` to false. To enable native filtering when using `onSearchTextChange`, explicitly set `filtering` to true.
+     */
+    onSearchTextChange?: (text: string) => void;
+}
+
 /**
  * See {@link ActionPanel.Section}
  */
@@ -7066,7 +7150,7 @@ declare type SubmenuChildren = ReactElement<SectionProps> | ReactElement<Section
 /**
  * See {@link ActionPanel.Submenu.Props}.
  */
-declare interface SubmenuProps {
+declare interface SubmenuProps extends SearchBarInterface {
     /**
      * ID of the submenu.
      * @deprecated - This is an internal prop which should not have been exposed. You can safely remove it.
@@ -7156,7 +7240,7 @@ export declare const SubmitFormAction: {
 /**
  * @deprecated Use {@link Action.SunmitForm.Props} instead.
  */
-export declare interface SubmitFormActionProps<T> extends Action.SubmitForm.Props<T> {
+export declare interface SubmitFormActionProps<T extends Form.Values> extends Action.SubmitForm.Props<T> {
 }
 
 /**

package/package.json

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

package/types/index.d.ts

@@ -550,13 +550,8 @@ declare interface Arguments {
     [item: string]: any;
 }
 
-/**
- * An interface describing top-level props for arguments
- */
+/** @deprecated Use {@Link LaunchProps} directly */
 export declare interface ArgumentsLaunchProps {
-    /**
-     * Use these values to populate the initial state for your command.
-     */
     arguments?: Arguments;
 }
 
@@ -732,7 +727,7 @@ export declare namespace Clipboard {
      * };
      * ```
      */
-    export function copy(content: string | Content): Promise<void>;
+    export function copy(content: string | number | Content): Promise<void>;
     /**
      * Clears the current clipboard contents.
      *
@@ -763,7 +758,7 @@ export declare namespace Clipboard {
      * };
      * ```
      */
-    export function paste(content: string | Content): Promise<void>;
+    export function paste(content: string | number | Content): Promise<void>;
     /**
      * Reads the clipboard as plain text.
      *
@@ -804,19 +799,26 @@ export declare namespace Clipboard {
     } | {
         /**
          * The file representation of the content.
-         *
-         * @remarks
-         * At the moment only file paths represented as a string are supported.
          */
         file: PathLike;
+    } | {
+        /**
+         * The HTML representation of the content.
+         */
+        html: string;
+        /**
+         * The alternative text representation of the content.
+         */
+        text?: string;
     };
 }
 
 /**
  * Closes the main Raycast window.
  *
- * @param options - Can be used to clear the root search. Defaults to not clearing the root search after
- * the window was closed.
+ * @param options - A parameter object with the properties:
+ * `clearRootSearch`: clears the text in the root search bar and scrolls to the top; default is `false`
+ * `popToRootType`: defines the pop to root behavior ({@link PopToRootType}); the default is to to respect the user's "Pop to Root Search" preference in Raycast
  * @returns A Promise that resolves when the main window is closed.
  *
  * @example
@@ -832,6 +834,7 @@ export declare namespace Clipboard {
  */
 export declare function closeMainWindow(options?: {
     clearRootSearch?: boolean;
+    popToRootType?: PopToRootType;
 }): Promise<void>;
 
 /**
@@ -849,7 +852,6 @@ export declare function closeMainWindow(options?: {
  *  <List>
  *    <List.Item title="Blue" icon={{ source: Icon.Circle, tintColor: Color.Blue }} />
  *    <List.Item title="Green" icon={{ source: Icon.Circle, tintColor: Color.Green }} />
- *    <List.Item title="Brown" icon={{ source: Icon.Circle, tintColor: Color.Brown }} />
  *    <List.Item title="Magenta" icon={{ source: Icon.Circle, tintColor: Color.Magenta }} />
  *    <List.Item title="Orange" icon={{ source: Icon.Circle, tintColor: Color.Orange }} />
  *    <List.Item title="Purple" icon={{ source: Icon.Circle, tintColor: Color.Purple }} />
@@ -864,7 +866,6 @@ export declare function closeMainWindow(options?: {
  */
 export declare enum Color {
     Blue = "raycast-blue",
-    Brown = "raycast-brown",
     Green = "raycast-green",
     Magenta = "raycast-magenta",
     Orange = "raycast-orange",
@@ -949,6 +950,12 @@ export declare namespace Color {
      * - Keywords, e.g. `red`
      */
     export type Raw = string;
+    /** The standard colors. Use those colors for consistency.
+     *
+     * @remarks
+     * The colors automatically adapt to the Raycast theme (light or dark).
+     */
+    const Brown: Color.Dynamic;
 }
 
 /**
@@ -1313,9 +1320,9 @@ export declare interface CopyToClipboardActionProps extends Action.CopyToClipboa
  */
 declare interface CopyToClipboardProps {
     /**
-     * The contents that will be written to the clipboard as string.
+     * The contents that will be copied to the clipboard.
      */
-    content: string | number;
+    content: string | number | Clipboard.Content;
     /**
      * An optional title for the action.
      * @defaultValue `"Copy to Clipboard"`
@@ -1336,7 +1343,7 @@ declare interface CopyToClipboardProps {
      * @remarks
      * This is handy when you want to act on the copied content, e.g. up-rank recently copied content.
      */
-    onCopy?: (content: string | number) => void;
+    onCopy?: (content: string | number | Clipboard.Content) => void;
 }
 
 /**
@@ -1878,14 +1885,20 @@ declare interface DropdownMembers_2 {
 /**
  * See {@link Form.Dropdown.Props}
  */
-declare interface DropdownProps extends FormItemProps_2<string> {
+declare interface DropdownProps extends FormItemProps_2<string>, SearchBarInterface {
+    /**
+     * Placeholder text that will be shown in the dropdown search field.
+     *
+     * @defaultValue `"Search..."`
+     */
+    placeholder?: string;
     /**
      * Sections or items. If {@link Form.Dropdown.Item} elements are specified, a default section is automatically created.
      */
     children?: ReactNode;
 }
 
-declare interface DropdownProps_2 {
+declare interface DropdownProps_2 extends SearchBarInterface {
     /**
      * ID of the dropdown.
      */
@@ -2032,12 +2045,16 @@ export declare interface Environment {
      * The theme used by the Raycast application.
      */
     theme: "light" | "dark";
+    /**
+     * The text size used by the Raycast application.
+     */
+    textSize: "medium" | "large";
     /**
      * The type of launch for the command (user initiated or background).
      */
     launchType: LaunchType;
     /**
-     * Any custom context values passed from a programmatic command launch via `launchCommand`.
+     * @deprecated Use the top-level prop `launchContext` instead.
      */
     launchContext?: LaunchContext;
 }
@@ -3048,14 +3065,8 @@ declare interface FormItemRef {
     reset: () => void;
 }
 
-/**
- * An interface describing top-level props for Form drafts
- */
+/** @deprecated Use {@Link LaunchProps} directly */
 export declare interface FormLaunchProps {
-    /**
-     * When a user enters the command via a draft, this object will contain the user inputs that were saved as a draft.
-     * Use its values to populate the initial state for your Form.
-     */
     draftValues?: Form.Values;
 }
 
@@ -3748,7 +3759,7 @@ export declare function getApplications(path?: PathLike): Promise<Application[]>
  * Returns the default application that the file would be opened with.
  *
  * @param path - The path of the file or folder to get the default application for.
- * @returns The default {@link Application} that would open the file. Throws an error if no application was found.
+ * @returns A Promise that resolves with the default {@link Application} that would open the file. If no application was found, the promise will be rejected.
  *
  * @example
  * ```typescript
@@ -3762,6 +3773,23 @@ export declare function getApplications(path?: PathLike): Promise<Application[]>
  */
 export declare function getDefaultApplication(path: PathLike): Promise<Application>;
 
+/**
+ * Returns the frontmost application.
+ *
+ * @returns A Promise that resolves with the frontmost {@link Application}. If no application was found, the promise will be rejected.
+ *
+ * @example
+ * ```typescript
+ * import { getFrontmostApplication } from "@raycast/api";
+ *
+ * export default async () => {
+ *   const frontmostApplication = await getFrontmostApplication();
+ *   console.log(`The frontmost application is: ${frontmostApplication.name}`);
+ * };
+ * ```
+ */
+export declare function getFrontmostApplication(): Promise<Application>;
+
 /**
  * @deprecated Use {@link LocalStorage.getItem} instead
  */
@@ -3796,8 +3824,7 @@ export declare function getPreferenceValues<Values extends PreferenceValues = Pr
 /**
  * Gets the selected items from Finder.
  *
- * @throws An error when Finder is not the frontmost application.
- * @returns A Promise that resolves with the selected file system items.
+ * @returns A Promise that resolves with the selected file system items. If Finder is not the frontmost application, the promise will be rejected.
  *
  * @example
  * ```typescript
@@ -3824,8 +3851,7 @@ export declare function getSelectedFinderItems(): Promise<FileSystemItem[]>;
 /**
  * Gets the selected text of the frontmost application.
  *
- * @throws An error when no text is selected in the frontmost application.
- * @returns A Promise that resolves with the selected text.
+ * @returns A Promise that resolves with the selected text. If no text is selected in the frontmost application, the promise will be rejected.
  *
  * @example
  * ```typescript
@@ -4138,7 +4164,7 @@ declare interface GridMembers {
     Dropdown: typeof Dropdown_2;
 }
 
-declare interface GridProps extends ActionsInterface, NavigationChildInterface {
+declare interface GridProps extends ActionsInterface, NavigationChildInterface, SearchBarInterface {
     /**
      * A reference to an {@link ActionPanel}. It will only be shown when there aren't any children.
      */
@@ -4198,19 +4224,6 @@ declare interface GridProps extends ActionsInterface, NavigationChildInterface {
      * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
      */
     enableFiltering?: boolean;
-    /**
-     * Toggles Raycast filtering. When `true`, Raycast will use the query in the search bar to filter the
-     * items. When `false`, the extension needs to take care of the filtering.
-     *
-     * You can further define how native filtering orders grid sections by setting an object with a `keepSectionOrder` property:
-     * When `true`, ensures that Raycast filtering maintains the section order as defined in the extension.
-     * When `false`, filtering may change the section order depending on the ranking values of the items.
-     *
-     * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
-     */
-    filtering?: boolean | {
-        keepSectionOrder: boolean;
-    };
     /**
      * Placeholder text that will be shown in the search bar.
      *
@@ -4221,19 +4234,6 @@ declare interface GridProps extends ActionsInterface, NavigationChildInterface {
      * Selects the item with the specified id.
      */
     selectedItemId?: string;
-    /**
-     * Defines whether the {@link Grid.Props.onSearchTextChange} will be triggered on every keyboard press or with a delay for throttling the events.
-     * Recommended to set to `true` when using custom filtering logic with asynchronous operations (e.g. network requests).
-     * @defaultValue `false`
-     */
-    throttle?: boolean;
-    /**
-     * Callback triggered when the search bar text changes.
-     *
-     * @remarks
-     * Specifying this implicitly toggles `filtering` to false. To enable native filtering when using `onSearchTextChange`, explicitly set `filtering` to true.
-     */
-    onSearchTextChange?: (text: string) => void;
 }
 
 /**
@@ -4883,14 +4883,34 @@ declare const Item_3: FunctionComponent<ItemProps_3>;
 
 declare type ItemAccessory = ({
     /**
-     * An optional text that will be used as the label.
+     * An optional text that will be used as the label, optionally colored.
+     * Color changes the text color to the provided color.
+     * Defaults to {@link Color.SecondaryText}.
+     */
+    text?: string | undefined | null | {
+        value: string | undefined | null;
+        color?: Color;
+    };
+} | {
+    /**
+     * An optional Date that will be used as the label, optionally colored. The date is formatted relatively to the current time (for example `new Date()` will be displayed as `"now"`, yesterday's Date will be displayed as "1d", etc.).
+     * Color changes the text color to the provided color.
+     * Defaults to {@link Color.SecondaryText}.
      */
-    text?: string | undefined | null;
+    date?: Date | undefined | null | {
+        value: Date | undefined | null;
+        color?: Color;
+    };
 } | {
     /**
-     * An optional Date that will be used as the label. The date is formatted relatively to the current time (for example `new Date()` will be displayed as `"now"`, yesterday's Date will be displayed as "1d", etc.).
+     * A string or Date that will be used as the label, optionally colored. The date is formatted relatively to the current time (for example `new Date()` will be displayed as `"now"`, yesterday's Date will be displayed as "1d", etc.).
+     * Color changes the text color to the provided color and sets a transparent background with the same color.
+     * Defaults to {@link Color.SecondaryText}.
      */
-    date?: Date | undefined | null;
+    tag: string | Date | undefined | null | {
+        value: string | Date | undefined | null;
+        color?: Color;
+    };
 }) & {
     /**
      * An optional {@link Image.ImageLike} that will be used as the icon.
@@ -4967,14 +4987,14 @@ declare interface ItemProps extends ActionsInterface {
      */
     title: string | {
         value: string;
-        tooltip: string;
+        tooltip?: string | null;
     };
     /**
      * An optional subtitle displayed next to the main title, optionally with a tooltip.
      */
     subtitle?: string | {
-        value: string | undefined | null;
-        tooltip: string;
+        value?: string | null;
+        tooltip?: string | null;
     };
     /**
      * An optional property used for providing additional indexable strings for search.
@@ -5072,7 +5092,7 @@ declare interface ItemProps_3 {
      */
     title: string;
     /**
-     * The subtitle displayed for this item in a slightly dimmed text color.
+     * The subtitle displayed for this item.
      */
     subtitle?: string;
     /**
@@ -5184,8 +5204,12 @@ declare interface LabelProps {
     icon?: Image.ImageLike | undefined | null;
     /**
      * The text value of the item.
+     * Specifying `color` will display the text in the provided color. Defaults to {@link Color.SecondaryText}.
      */
-    text?: string;
+    text?: string | {
+        value: string;
+        color?: Color | null;
+    };
 }
 
 /**
@@ -5226,7 +5250,37 @@ declare interface LaunchContext {
 /**
  * The top-level props that a Command receives on launch
  */
-export declare type LaunchProps = ArgumentsLaunchProps | FormLaunchProps;
+export declare type LaunchProps<T extends {
+    arguments?: Arguments;
+    draftValues?: Form.Values;
+    launchContext?: LaunchContext;
+} = {
+    arguments: Arguments;
+    draftValues: Form.Values;
+    launchContext?: LaunchContext;
+}> = {
+    /**
+     * The type of launch for the command (user initiated or background).
+     */
+    launchType: LaunchType;
+    /**
+     * Use these values to populate the initial state for your command.
+     */
+    arguments: T["arguments"];
+    /**
+     * When a user enters the command via a draft, this object will contain the user inputs that were saved as a draft.
+     * Use its values to populate the initial state for your Form.
+     */
+    draftValues?: T["draftValues"];
+    /**
+     * When the command is launched programmatically via `launchCommand`, this object contains the value passed to `context`.
+     */
+    launchContext?: T["launchContext"];
+    /**
+     * When the command is launched as a fallback command, this string contains the text of the root search.
+     */
+    fallbackText?: string;
+};
 
 export declare enum LaunchType {
     /**
@@ -5567,7 +5621,7 @@ declare interface ListMembers {
 export declare interface ListProps extends List.Props {
 }
 
-declare interface ListProps_2 extends ActionsInterface, NavigationChildInterface {
+declare interface ListProps_2 extends ActionsInterface, NavigationChildInterface, SearchBarInterface {
     /**
      * A reference to an {@link ActionPanel}. It will only be shown when there aren't any children.
      */
@@ -5602,19 +5656,6 @@ declare interface ListProps_2 extends ActionsInterface, NavigationChildInterface
      * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
      */
     enableFiltering?: boolean;
-    /**
-     * Toggles Raycast filtering. When `true`, Raycast will use the query in the search bar to filter the
-     * items. When `false`, the extension needs to take care of the filtering.
-     *
-     * You can further define how native filtering orders list sections by setting an object with a `keepSectionOrder` property:
-     * When `true`, ensures that Raycast filtering maintains the section order as defined in the extension.
-     * When `false`, filtering may change the section order depending on the ranking values of list items.
-     *
-     * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
-     */
-    filtering?: boolean | {
-        keepSectionOrder: boolean;
-    };
     /**
      * Placeholder text that will be shown in the search bar.
      *
@@ -5625,19 +5666,6 @@ declare interface ListProps_2 extends ActionsInterface, NavigationChildInterface
      * Selects the item with the specified id.
      */
     selectedItemId?: string;
-    /**
-     * Defines whether the {@link List.Props.onSearchTextChange} will be triggered on every keyboard press or with a delay for throttling the events.
-     * Recommended to set to `true` when using custom filtering logic with asynchronous operations (e.g. network requests).
-     * @defaultValue `false`
-     */
-    throttle?: boolean;
-    /**
-     * Callback triggered when the search bar text changes.
-     *
-     * @remarks
-     * Specifying this implicitly toggles `filtering` to false. To enable native filtering when using `onSearchTextChange`, explicitly set `filtering` to `true`.
-     */
-    onSearchTextChange?: (text: string) => void;
     /**
      * Whether the List should have an area on the right side of the items to show additional details about the selected item.
      *
@@ -6039,10 +6067,10 @@ export declare namespace OAuth {
              */
             providerName: string;
             /**
-             * An icon referenced from the assets folder, displayed in the OAuth overlay.
+             * An icon displayed in the OAuth overlay.
              * Make sure to provide at least a size of 64x64 pixels.
              */
-            providerIcon: string;
+            providerIcon?: Image.ImageLike;
             /**
              * An optional ID for associating the client with a provider.
              * Only set this if you use multiple different clients in your extension.
@@ -6074,7 +6102,7 @@ export declare namespace OAuth {
     export class PKCEClient {
         redirectMethod: RedirectMethod;
         providerName: string;
-        providerIcon: string;
+        providerIcon?: Image.ImageLike;
         providerId?: string;
         description?: string;
         private resolvesOnRedirect?;
@@ -6541,12 +6569,12 @@ export declare interface PasteActionProps extends Action.Paste.Props {
  */
 declare interface PasteProps {
     /**
-     * The contents that will be written to the clipboard as string.
+     * The contents that will be pasted to the frontmost application.
      */
-    content: string | number;
+    content: string | number | Clipboard.Content;
     /**
      * An optional title for the action.
-     * @defaultValue `"Paste in Active app"`
+     * @defaultValue `"Paste in Active App"`
      */
     title?: string;
     /**
@@ -6564,7 +6592,7 @@ declare interface PasteProps {
      * @remarks
      * This is handy when you want to act on the pasted content, e.g. up-rank recently pasted content.
      */
-    onPaste?: (content: string | number) => void;
+    onPaste?: (content: string | number | Clipboard.Content) => void;
 }
 
 /**
@@ -6599,6 +6627,24 @@ export declare function popToRoot(options?: {
     clearSearchBar?: boolean;
 }): Promise<void>;
 
+/**
+ * Defines the pop to root behavior when the main window is closed.
+ */
+export declare enum PopToRootType {
+    /**
+     * Respects the user's "Pop to Root Search" preference in Raycast
+     */
+    Default = "default",
+    /**
+     * Immediately pops back to root
+     */
+    Immediate = "immediate",
+    /**
+     * Prevents Raycast from popping back to root
+     */
+    Suspended = "suspended"
+}
+
 /**
  * @deprecated Use {@link getPreferenceValues} instead.
  */
@@ -6768,6 +6814,44 @@ export declare const removeLocalStorageItem: typeof LocalStorage.removeItem;
  */
 export declare const render: any;
 
+/**
+ * Views that support a search bar.
+ */
+declare interface SearchBarInterface {
+    /**
+     * Toggles Raycast filtering. When `true`, Raycast will use the query in the search bar to filter the
+     * items. When `false`, the extension needs to take care of the filtering.
+     *
+     * You can further define how native filtering orders sections by setting an object with a `keepSectionOrder` property:
+     * When `true`, ensures that Raycast filtering maintains the section order as defined in the extension.
+     * When `false`, filtering may change the section order depending on the ranking values of items.
+     *
+     * @defaultValue `false` when `onSearchTextChange` is specified, `true` otherwise.
+     */
+    filtering?: boolean | {
+        keepSectionOrder: boolean;
+    };
+    /**
+     * Indicates whether a loading indicator should be shown or hidden next to the search bar
+     *
+     * @defaultValue `false`
+     */
+    isLoading?: boolean;
+    /**
+     * Defines whether the `onSearchTextChange` handler will be triggered on every keyboard press or with a delay for throttling the events.
+     * Recommended to set to `true` when using custom filtering logic with asynchronous operations (e.g. network requests).
+     * @defaultValue `false`
+     */
+    throttle?: boolean;
+    /**
+     * Callback triggered when the search bar text changes.
+     *
+     * @remarks
+     * Specifying this implicitly toggles `filtering` to false. To enable native filtering when using `onSearchTextChange`, explicitly set `filtering` to true.
+     */
+    onSearchTextChange?: (text: string) => void;
+}
+
 /**
  * See {@link ActionPanel.Section}
  */
@@ -7066,7 +7150,7 @@ declare type SubmenuChildren = ReactElement<SectionProps> | ReactElement<Section
 /**
  * See {@link ActionPanel.Submenu.Props}.
  */
-declare interface SubmenuProps {
+declare interface SubmenuProps extends SearchBarInterface {
     /**
      * ID of the submenu.
      * @deprecated - This is an internal prop which should not have been exposed. You can safely remove it.
@@ -7156,7 +7240,7 @@ export declare const SubmitFormAction: {
 /**
  * @deprecated Use {@link Action.SunmitForm.Props} instead.
  */
-export declare interface SubmitFormActionProps<T> extends Action.SubmitForm.Props<T> {
+export declare interface SubmitFormActionProps<T extends Form.Values> extends Action.SubmitForm.Props<T> {
 }
 
 /**