@raycast/api 1.36.1 → 1.38.0

package/api.d.ts

@@ -37,10 +37,13 @@ import { RefAttributes } from 'react';
  * }
  * ```
  */
-export declare const Action: FunctionComponent<ActionProps> & ConvenienceActions;
+export declare const Action: FunctionComponent<ActionProps> & ConvenienceActions & {
+    Style: typeof ActionStyle;
+};
 
 export declare namespace Action {
     export type Props = ActionProps;
+    export type Style = ActionStyle;
     export namespace CopyToClipboard {
         /**
          * Props of the {@link Action.CopyToClipboard} React component.
@@ -107,6 +110,12 @@ export declare namespace Action {
          */
         export type Props = TrashProps;
     }
+    export namespace ToggleQuickLook {
+        /**
+         * Props of the {@link Action.ToggleQuickLook} React component.
+         */
+        export type Props = ToggleQuickLookProps;
+    }
 }
 
 /**
@@ -188,7 +197,11 @@ declare type ActionPanelChildren_2 = ReactElement<ActionPanel.Section.Props> | R
 /**
  * @deprecated Use {@link Action} instead.
  */
-export declare const ActionPanelItem: FunctionComponent<ActionProps> & ConvenienceActions;
+export declare const ActionPanelItem: FunctionComponent<ActionProps> & ConvenienceActions & {
+    Style: ActionStyle; /**
+    * @deprecated Use {@link Image.ImageLike} instead
+    */
+};
 
 /**
  * @deprecated Use {@link Action.Props} instead.
@@ -354,6 +367,16 @@ declare interface ActionProps {
      * The icon displayed for the action.
      */
     icon?: Image.ImageLike | undefined | null;
+    /**
+     * Defines the visual style of the Action.
+     *
+     * @remarks
+     * Use {@link Action.Style.Regular} for displaying a regular actions.
+     * Use {@link Action.Style.Destructive} when your action has something that user should be careful about.
+     * Use the confirmation {@link Alert} if the action is doing something that user cannot revert.
+     * @defaultValue {@link Action.Style.Regular}
+     */
+    style?: ActionStyle;
     /**
      * The keyboard shortcut for the item.
      *
@@ -378,6 +401,19 @@ declare interface ActionsInterface {
     actions?: ReactNode;
 }
 
+/**
+ * Defines the visual style of the Action.
+ *
+ * @remarks
+ * Use {@link Action.Style.Regular} for displaying a regular actions.
+ * Use {@link Action.Style.Destructive} when your action has something that user should be careful about.
+ * Use the confirmation {@link Alert} if the action is doing something that user cannot revert.
+ */
+declare enum ActionStyle {
+    Regular = "regular",
+    Destructive = "destructive"
+}
+
 export declare namespace Alert {
     /**
      * The options to create an {@link Alert}.
@@ -500,6 +536,131 @@ export declare interface Application {
     bundleId?: string;
 }
 
+/**
+ * @beta
+ * 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;
+}
+
+/**
+ * @beta
+ * 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
+ * and stores the actual data in separate files on disk in the extension's support directory.
+ *
+ * The Cache class provides CRUD-style methods (get, set, remove) to update and retrieve data synchronously based on a key.
+ * The data must be a string and it is up to the client to decide which serialization format to use.
+ * A typical use case would be to use `JSON.stringify` and `JSON.parse`.
+ *
+ * @remarks By default, the cache is shared between the commands of an extension. Use {@link Cache.Options} to configure
+ * a `namespace` per command if needed (for example, set it to `environment.commandName`).
+ *
+ * @example
+ * ```typescript
+ * import { Cache } from "@raycast/api";
+ *
+ * const cache = new Cache();
+ * cache.set("items", JSON.stringify([{ id: "1", title: "Item 1" }]));
+ * console.log(JSON.parse(cache.get("items")));
+ * ```
+ */
+export declare class Cache {
+    static get STORAGE_DIRECTORY_NAME(): string;
+    static get DEFAULT_CAPACITY(): number;
+    private directory;
+    private namespace?;
+    private capacity;
+    private journal;
+    private storage;
+    private subscribers;
+    constructor(options?: Cache.Options);
+    /**
+     * @returns the full path to the directory where the data is stored on disk.
+     */
+    get storageDirectory(): string;
+    /**
+     * @returns the data for the given key. If there is no data for the key, `undefined` is returned.
+     * @remarks If you want to just check for the existence of a key, use {@link has}.
+     */
+    get(key: string): string | undefined;
+    /**
+     * @returns `true` if data for the key exists, `false` otherwise.
+     * @remarks You can use this method to check for entries without affecting the LRU access.
+     */
+    has(key: string): boolean;
+    /**
+     * @returns `true` if the cache is empty, `false` otherwise.
+     */
+    get isEmpty(): boolean;
+    /**
+     * Sets the data for the given key.
+     * If the data exceeds the configured `capacity`, the least recently used entries are removed.
+     * This also notifies registered subscribers (see {@link subscribe}).
+     */
+    set(key: string, data: string): void;
+    /**
+     * Removes the data for the given key.
+     * This also notifies registered subscribers (see {@link subscribe}).
+     * @returns `true` if data for the key was removed, `false` otherwise.
+     */
+    remove(key: string): boolean;
+    /**
+     * Clears all stored data.
+     * This also notifies registered subscribers (see {@link subscribe}) unless the  `notifySubscribers` option is set to `false`.
+     */
+    clear(options?: {
+        notifySubscribers: boolean;
+    }): void;
+    /**
+     * Registers a new subscriber that gets notified when cache data is set or removed.
+     * @returns a function that can be called to remove the subscriber.
+     */
+    subscribe(subscriber: Cache.Subscriber): Cache.Subscription;
+    private maintainCapacity;
+    private notifySubscribers;
+}
+
+export declare namespace Cache {
+    /**
+     * The options for creating a new {@link Cache}.
+     */
+    export interface Options {
+        /**
+         * If set, the Cache will be namespaced via a subdirectory.
+         * This can be useful to separate the caches for individual commands of an extension.
+         * By default, the cache is shared between the commands of an extension.
+         */
+        namespace?: string;
+        /**
+         * The parent directory for the cache data.
+         * @deprecated this parameter will be removed in the future – use the default directory.
+         */
+        directory?: string;
+        /**
+         * The capacity in bytes. If the stored data exceeds the capacity, the least recently used data is removed.
+         * The default capacity is 10 MB.
+         */
+        capacity?: number;
+    }
+    export type Subscriber = (key: string | undefined, data: string | undefined) => void;
+    export type Subscription = () => void;
+}
+
 /**
  * See {@link Form.Checkbox}
  */
@@ -1055,6 +1216,31 @@ declare interface ConvenienceActions {
      * ```
      */
     CreateQuicklink: typeof CreateQuicklink;
+    /**
+     * Action that toggles the Quick Look to preview a file.
+     *
+     * @example
+     * ```typescript
+     * import { ActionPanel, List, Action } from "@raycast/api";
+     *
+     * export default function Command() {
+     *   return (
+     *     <List>
+     *         <List.Item
+     *           title="Preview me"
+     *           quickLook={{ path: "~/Downloads/Raycast.dmg", name: "Some file" }}
+     *           actions={
+     *             <ActionPanel>
+     *               <Action.ToggleQuickLook shortcut={{ modifiers: ["cmd"], key: "y" }} />
+     *             </ActionPanel>
+     *           }
+     *         />
+     *     </ List>
+     *   );
+     * }
+     * ```
+     */
+    ToggleQuickLook: typeof ToggleQuickLook;
 }
 
 /**
@@ -1944,6 +2130,11 @@ export declare interface Environment {
      * The theme used by the Raycast application.
      */
     theme: "light" | "dark";
+    /**
+     * @beta
+     * The type of launch for the command (user initiated or background).
+     */
+    launchType: LaunchType;
 }
 
 /**
@@ -1960,6 +2151,7 @@ export declare interface Environment {
  * console.log(`Support path: ${environment.supportPath}`);
  * console.log(`Is development mode: ${environment.isDevelopment}`);
  * console.log(`Raycast theme: ${environment.theme}`);
+ * console.log(`Raycast launchType: ${environment.launchType}`);
  * ```
  */
 export declare const environment: Environment;
@@ -2007,6 +2199,18 @@ export declare namespace Form {
     export type Value = FormValue_2;
     export type Values = FormValues_2;
     export type Props = FormProps_2;
+    /**
+     * An interface describing event in callbacks {@link Form.Item.Props.onFocus} and {@link Form.Item.Props.onBlur}
+     */
+    export type Event<T extends FormValue_2> = FormEvent<T>;
+    export namespace Event {
+        /**
+         * Types of Form event {@link Form.Event}
+         * * `focus` - the type will be returned for the event of {@link Form.Item.Props.onFocus} callback
+         * * `blur` - the type will be returned for the event of {@link Form.Item.Props.onBlur} callback
+         */
+        export type Type = FormEventType;
+    }
     /**
      * A Ref Type for the {@link Form.TextField}.
      * Use refs to control your Form by calling `Form.TextField.focus()` or `Form.TextField.reset()` functions.
@@ -2637,9 +2841,37 @@ export declare interface FormDropdownSectionProps extends Form.Dropdown.Section.
 
 /**
  * An interface describing Form events in callbacks
- * @beta
+ *
+ * @example
+ * ```typescript
+ *import { Form } from "@raycast/api";
+ *
+ *export default function Main() {
+ *  return (
+ *    <Form>
+ *      <Form.TextField id="textField" title="Text Field" onBlur={logEvent} onFocus={logEvent} />
+ *      <Form.TextArea id="textArea" title="Text Area" onBlur={logEvent} onFocus={logEvent} />
+ *      <Form.Dropdown id="dropdown" title="Dropdown" onBlur={logEvent} onFocus={logEvent}>
+ *        {[1, 2, 3, 4, 5, 6, 7].map((num) => (
+ *          <Form.Dropdown.Item value={String(num)} title={String(num)} key={num} />
+ *        ))}
+ *      </Form.Dropdown>
+ *      <Form.TagPicker id="tagPicker" title="Tag Picker" onBlur={logEvent} onFocus={logEvent}>
+ *        {[1, 2, 3, 4, 5, 6, 7].map((num) => (
+ *          <Form.TagPicker.Item value={String(num)} title={String(num)} key={num} />
+ *        ))}
+ *      </Form.TagPicker>
+ *    </Form>
+ *  );
+ *}
+ *
+ *function logEvent(event: Form.Event) {
+ *  console.log(`Event '${event.type}' has happened for '${event.target.id}'. Current 'value': '${event.target.value}'`);
+ *}
+ *
+ * ```
  */
-declare interface FormEvent<T extends FormValue_2> {
+declare type FormEvent<T extends FormValue_2> = {
     /**
      * An interface containing target data related to the event
      */
@@ -2653,7 +2885,18 @@ declare interface FormEvent<T extends FormValue_2> {
          */
         value?: T;
     };
-}
+    /**
+     * A type of event
+     */
+    type: FormEventType;
+};
+
+/**
+ * Types of Form event ({@link Form.Event}).
+ * * `focus` will be returned for the event of {@link Form.Item.Props.onFocus} callback
+ * * `blur` will be returned for the event of {@link Form.Item.Props.onBlur} callback
+ */
+declare type FormEventType = "focus" | "blur";
 
 /**
  * @deprecated Use {@link Form.ItemProps} instead.
@@ -2678,6 +2921,11 @@ declare interface FormItemProps_2<T extends FormValue_2> {
      * An optional info message to describe the form item. It appears on the right side of the item with an info icon. When the icon is hovered, the info message is shown.
      */
     info?: string;
+    /**
+     * An optional error message to show the form item validation issues.
+     * If the `error` is present, the Form Item will be highlighted with red border and will show an error message on the right.
+     */
+    error?: string;
     /**
      * Indicates whether the value of the item should be persisted after submitting, and restored next time the form is rendered.
      */
@@ -2704,11 +2952,13 @@ declare interface FormItemProps_2<T extends FormValue_2> {
      */
     onChange?: (newValue: T) => void;
     /**
-     * The callback which will be triggered when the item loses focus.
-     * The `event` object contains data with {@link FormItemProps.id} and current {@link FormItemProps.value} for the item.
-     * @beta
+     * The callback that will be triggered when the item loses its focus.
      */
     onBlur?: (event: FormEvent<T>) => void;
+    /**
+     * The callback which will be triggered should be called when the item is focused.
+     */
+    onFocus?: (event: FormEvent<T>) => void;
 }
 
 /**
@@ -2786,6 +3036,17 @@ declare interface FormItemRef {
     reset: () => void;
 }
 
+/**
+ * An interface describing top-level props for Form drafts
+ */
+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;
+}
+
 declare interface FormMembers {
     /**
      * A form item with a checkbox.
@@ -3227,6 +3488,12 @@ export declare interface FormProps extends Form.Props {
  * Props of the {@link Form} React component.
  */
 declare interface FormProps_2 extends ActionsInterface, NavigationChildInterface {
+    /**
+     * Defines whether the Form.Items values will be preserved when user exits the screen.
+     * @remarks Keep in mind that drafts for forms nested in navigation is not supported yet. In the case you will see a warning about it.
+     * @defaultValue `false`
+     */
+    enableDrafts?: boolean;
     /**
      * The Form.Item elements of the form.
      */
@@ -3648,7 +3915,7 @@ declare interface GridMembers {
      * export default function Command() {
      *   return (
      *     <Grid>
-     *       <Grid.Item icon={Icon.Star} title="Augustiner Helles" subtitle="0,5 Liter" accessories={[{ text: "Germany" }]} />
+     *       <Grid.Item icon={Icon.Star} title="Augustiner Helles" subtitle="0,5 Liter" />
      *     </Grid>
      *   );
      * }
@@ -3689,11 +3956,10 @@ declare interface GridMembers {
      * import { Grid } from "@raycast/api";
      *
      * function DrinkDropdown(props: DrinkDropdownProps) {
-     *   const { isLoading = false, drinkTypes, onDrinkTypeChange } = props;
+     *   const { drinkTypes, onDrinkTypeChange } = props;
      *   return (
      *     <Grid.Dropdown
      *       tooltip="Select Drink Type"
-     *       disabled={isLoading}
      *       storeValue={true}
      *       onChange={(newValue) => {
      *         onDrinkTypeChange(newValue);
@@ -3811,55 +4077,419 @@ declare interface GridProps extends ActionsInterface, NavigationChildInterface {
  * ```
  */
 export declare enum Icon {
+    AddPerson = "add-person-16",
+    Airplane = "airplane-16",
+    AirplaneFilled = "airplane-filled-16",
+    AirplaneLanding = "airplane-landing-16",
+    AirplaneTakeoff = "airplane-takeoff-16",
+    Airpods = "airpods-16",
+    Alarm = "alarm-16",
+    AlarmRinging = "alarm-ringing-16",
+    AlignCentre = "align-centre-16",
+    AlignLeft = "align-left-16",
+    AlignRight = "align-right-16",
+    AmericanFootball = "american-football-16",
+    Anchor = "anchor-16",
+    AppWindow = "app-window-16",
+    AppWindowGrid2x2 = "app-window-grid-2x2-16",
+    AppWindowGrid3x3 = "app-window-grid-3x3-16",
+    AppWindowList = "app-window-list-16",
+    AppWindowSidebarLeft = "app-window-sidebar-left-16",
+    AppWindowSidebarRight = "app-window-sidebar-right-16",
     ArrowClockwise = "arrow-clockwise-16",
-    TwoArrowsClockwise = "arrow-2-clockwise-16",
+    ArrowCounterClockwise = "arrow-counter-clockwise-16",
+    ArrowDown = "arrow-down-16",
+    ArrowDownCircle = "arrow-down-circle-16",
+    ArrowDownCircleFilled = "arrow-down-circle-filled-16",
+    ArrowLeft = "arrow-left-16",
+    ArrowLeftCircle = "arrow-left-circle-16",
+    ArrowLeftCircleFilled = "arrow-left-circle-filled-16",
+    ArrowNe = "arrow-ne-16",
     ArrowRight = "arrow-right-16",
+    ArrowRightCircle = "arrow-right-circle-16",
+    ArrowRightCircleFilled = "arrow-right-circle-filled-16",
+    ArrowUp = "arrow-up-16",
+    ArrowUpCircle = "arrow-up-circle-16",
+    ArrowUpCircleFilled = "arrow-up-circle-filled-16",
+    AtSymbol = "at-symbol-16",
+    BandAid = "band-aid-16",
+    BankNote = "bank-note-16",
+    BarChart = "bar-chart-16",
+    BarCode = "bar-code-16",
+    BathTub = "bath-tub-16",
+    Battery = "battery-16",
+    BatteryCharging = "battery-charging-16",
+    BatteryDisabled = "battery-disabled-16",
+    Bell = "bell-16",
+    BellDisabled = "bell-disabled-16",
+    Bike = "bike-16",
     Binoculars = "binoculars-16",
-    Bubble = "bubble-left-16",
+    BlankDocument = "blank-document-16",
+    Bluetooth = "bluetooth-16",
+    Boat = "boat-16",
+    Bold = "bold-16",
+    Bolt = "bolt-16",
+    BoltDisabled = "bolt-disabled-16",
+    Book = "book-16",
+    Bookmark = "bookmark-16",
+    Box = "box-16",
+    Brush = "brush-16",
+    Bubble = "speech-bubble-16",
+    Bug = "bug-16",
+    BulletPoints = "bullet-points-16",
+    BullsEye = "bulls-eye-16",
+    Buoy = "buoy-16",
+    Calculator = "calculator-16",
     Calendar = "calendar-16",
-    Checkmark = "checkmark-circle-16",
+    Camera = "camera-16",
+    Car = "car-16",
+    Cart = "cart-16",
+    Cd = "cd-16",
+    Center = "center-16",
+    Check = "check-16",
+    CheckCircle = "check-circle-16",
+    Checkmark = "check-circle-16",
+    ChessPiece = "chess-piece-16",
     ChevronDown = "chevron-down-16",
+    ChevronLeft = "chevron-left-16",
+    ChevronRight = "chevron-right-16",
     ChevronUp = "chevron-up-16",
     Circle = "circle-16",
-    Clipboard = "doc-on-clipboard-16",
+    CircleEllipsis = "circle-ellipsis-16",
+    CircleFilled = "circle-filled-16",
+    CircleProgress = "circle-progress-16",
+    CircleProgress100 = "circle-progress-100-16",
+    CircleProgress25 = "circle-progress-25-16",
+    CircleProgress50 = "circle-progress-50-16",
+    CircleProgress75 = "circle-progress-75-16",
+    ClearFormatting = "clear-formatting-16",
+    Clipboard = "copy-clipboard-16",
     Clock = "clock-16",
-    Desktop = "desktopcomputer-16",
-    Document = "doc-16",
+    Cloud = "cloud-16",
+    CloudLightning = "cloud-lightning-16",
+    CloudRain = "cloud-rain-16",
+    CloudSnow = "cloud-snow-16",
+    CloudSun = "cloud-sun-16",
+    Code = "code-16",
+    CodeBlock = "code-block-16",
+    Cog = "cog-16",
+    Coin = "coin-16",
+    Coins = "coins-16",
+    Compass = "compass-16",
+    ComputerChip = "computer-chip-16",
+    Contrast = "contrast-16",
+    CopyClipboard = "copy-clipboard-16",
+    CreditCard = "credit-card-16",
+    CricketBall = "cricket-ball-16",
+    Crop = "crop-16",
+    Crown = "crown-16",
+    Crypto = "crypto-16",
+    DeleteDocument = "delete-document-16",
+    Desktop = "desktop-16",
+    Dna = "dna-16",
+    Document = "blank-document-16",
     Dot = "dot-16",
-    Download = "square-and-arrow-down-16",
+    Download = "download-16",
+    EditShape = "edit-shape-16",
+    Eject = "eject-16",
+    Ellipsis = "ellipsis-16",
+    Emoji = "emoji-16",
     Envelope = "envelope-16",
-    ExclamationMark = "exclamation-mark-triangle-16",
+    Eraser = "eraser-16",
+    ExclamationMark = "important-01-16",
+    Exclamationmark = "exclamationmark-16",
+    Exclamationmark2 = "exclamationmark-2-16",
+    Exclamationmark3 = "exclamationmark-3-16",
     Eye = "eye-16",
-    EyeSlash = "eye-slash-16",
+    EyeDisabled = "eye-disabled-16",
+    EyeDropper = "eye-dropper-16",
+    Female = "female-16",
+    FilmStrip = "film-strip-16",
+    Filter = "filter-16",
     Finder = "finder-16",
-    Gear = "gearshape-16",
-    Globe = "globe-16",
+    Fingerprint = "fingerprint-16",
+    Folder = "folder-16",
+    Footprints = "footprints-16",
+    Forward = "forward-16",
+    ForwardFilled = "forward-filled-16",
+    FountainTip = "fountain-tip-16",
+    FullSignal = "full-signal-16",
+    GameController = "game-controller-16",
+    Gauge = "gauge-16",
+    Gear = "cog-16",
+    Geopin = "geopin-16",
+    Germ = "germ-16",
+    Gift = "gift-16",
+    Glasses = "glasses-16",
+    Globe = "globe-01-16",
+    Goal = "goal-16",
     Hammer = "hammer-16",
-    LevelMeter = "level-meter-16",
+    HardDrive = "hard-drive-16",
+    Hashtag = "hashtag-16",
+    Headphones = "headphones-16",
+    Heart = "heart-16",
+    HeartDisabled = "heart-disabled-16",
+    Heartbeat = "heartbeat-16",
+    Highlight = "highlight-16",
+    Hourglass = "hourglass-16",
+    House = "house-16",
+    Image = "image-16",
+    Important = "important-01-16",
+    Info = "info-01-16",
+    Italics = "italics-16",
+    Key = "key-16",
+    Keyboard = "keyboard-16",
+    Layers = "layers-16",
+    Leaderboard = "leaderboard-16",
+    Leaf = "leaf-16",
+    LevelMeter = "signal-2-16",
+    LightBulb = "light-bulb-16",
+    LightBulbOff = "light-bulb-off-16",
+    LineChart = "line-chart-16",
     Link = "link-16",
-    List = "main-list-view-16",
-    MagnifyingGlass = "magnifyingglass-16",
-    MemoryChip = "memorychip-16",
-    Message = "message-16",
+    List = "app-window-list-16",
+    Livestream = "livestream-01-16",
+    Lock = "lock-16",
+    LockDisabled = "lock-disabled-16",
+    LockUnlocked = "lock-unlocked-16",
+    Logout = "logout-16",
+    Lorry = "lorry-16",
+    Lowercase = "lowercase-16",
+    MagnifyingGlass = "magnifying-glass-16",
+    Male = "male-16",
+    Map = "map-16",
+    Mask = "mask-16",
+    Maximize = "maximize-16",
+    MedicalSupport = "medical-support-16",
+    Megaphone = "megaphone-16",
+    MemoryChip = "computer-chip-16",
+    MemoryStick = "memory-stick-16",
+    Message = "speech-bubble-16",
+    Microphone = "microphone-16",
+    MicrophoneDisabled = "microphone-disabled-16",
+    Minimize = "minimize-16",
+    Minus = "minus-16",
+    MinusCircle = "minus-circle-16",
+    MinusCircleFilled = "minus-circle-filled-16",
+    Mobile = "mobile-16",
+    Monitor = "monitor-16",
+    Moon = "moon-16",
+    Mountain = "mountain-16",
+    Mouse = "mouse-16",
+    Multiply = "multiply-16",
+    Music = "music-16",
+    Network = "network-16",
+    NewDocument = "new-document-16",
+    NewFolder = "new-folder-16",
+    Number = "number-01-16",
+    Number00 = "number-00-16",
+    Number10 = "number-10-16",
+    Number11 = "number-11-16",
+    Number12 = "number-12-16",
+    Number13 = "number-13-16",
+    Number14 = "number-14-16",
+    Number15 = "number-15-16",
+    Number16 = "number-16-16",
+    Number17 = "number-17-16",
+    Number18 = "number-18-16",
+    Number19 = "number-19-16",
+    Number20 = "number-20-16",
+    Number21 = "number-21-16",
+    Number22 = "number-22-16",
+    Number23 = "number-23-16",
+    Number24 = "number-24-16",
+    Number25 = "number-25-16",
+    Number26 = "number-26-16",
+    Number27 = "number-27-16",
+    Number28 = "number-28-16",
+    Number29 = "number-29-16",
+    Number30 = "number-30-16",
+    Number31 = "number-31-16",
+    Number32 = "number-32-16",
+    Number33 = "number-33-16",
+    Number34 = "number-34-16",
+    Number35 = "number-35-16",
+    Number36 = "number-36-16",
+    Number37 = "number-37-16",
+    Number38 = "number-38-16",
+    Number39 = "number-39-16",
+    Number40 = "number-40-16",
+    Number41 = "number-41-16",
+    Number42 = "number-42-16",
+    Number43 = "number-43-16",
+    Number44 = "number-44-16",
+    Number45 = "number-45-16",
+    Number46 = "number-46-16",
+    Number47 = "number-47-16",
+    Number48 = "number-48-16",
+    Number49 = "number-49-16",
+    Number50 = "number-50-16",
+    Number51 = "number-51-16",
+    Number52 = "number-52-16",
+    Number53 = "number-53-16",
+    Number54 = "number-54-16",
+    Number55 = "number-55-16",
+    Number56 = "number-56-16",
+    Number57 = "number-57-16",
+    Number58 = "number-58-16",
+    Number59 = "number-59-16",
+    Number60 = "number-60-16",
+    Number61 = "number-61-16",
+    Number62 = "number-62-16",
+    Number63 = "number-63-16",
+    Number64 = "number-64-16",
+    Number65 = "number-65-16",
+    Number66 = "number-66-16",
+    Number67 = "number-67-16",
+    Number68 = "number-68-16",
+    Number69 = "number-69-16",
+    Number70 = "number-70-16",
+    Number71 = "number-71-16",
+    Number72 = "number-72-16",
+    Number73 = "number-73-16",
+    Number74 = "number-74-16",
+    Number75 = "number-75-16",
+    Number76 = "number-76-16",
+    Number77 = "number-77-16",
+    Number78 = "number-78-16",
+    Number79 = "number-79-16",
+    Number80 = "number-80-16",
+    Number81 = "number-81-16",
+    Number82 = "number-82-16",
+    Number83 = "number-83-16",
+    Number84 = "number-84-16",
+    Number85 = "number-85-16",
+    Number86 = "number-86-16",
+    Number87 = "number-87-16",
+    Number88 = "number-88-16",
+    Number89 = "number-89-16",
+    Number90 = "number-90-16",
+    Number91 = "number-91-16",
+    Number92 = "number-92-16",
+    Number93 = "number-93-16",
+    Number94 = "number-94-16",
+    Number95 = "number-95-16",
+    Number96 = "number-96-16",
+    Number97 = "number-97-16",
+    Number98 = "number-98-16",
+    Number99 = "number-99-16",
+    Paperclip = "paperclip-16",
+    Patch = "patch-16",
+    Pause = "pause-16",
+    PauseFilled = "pause-filled-16",
     Pencil = "pencil-16",
-    Person = "person-crop-circle-16",
+    Person = "person-16",
+    PersonCircle = "person-circle-16",
     Phone = "phone-16",
+    PhoneRinging = "phone-ringing-16",
+    PieChart = "pie-chart-16",
+    Pill = "pill-16",
     Pin = "pin-16",
+    PinDisabled = "pin-disabled-16",
+    Play = "play-16",
+    PlayFilled = "play-filled-16",
+    Plug = "plug-16",
     Plus = "plus-16",
-    Sidebar = "sidebar-right-16",
-    SpeakerArrowDown = "speaker-arrow-down-16",
-    SpeakerArrowUp = "speaker-arrow-up-16",
-    SpeakerSlash = "speaker-slash-16",
+    PlusCircle = "plus-circle-16",
+    PlusCircleFilled = "plus-circle-filled-16",
+    PlusMinusDivideMultiply = "plus-minus-divide-multiply-16",
+    Power = "power-16",
+    Print = "print-16",
+    QuestionMark = "question-mark-circle-16",
+    QuestionMarkCircle = "question-mark-circle-16",
+    QuotationMarks = "quotation-marks-16",
+    QuoteBlock = "quote-block-16",
+    Racket = "racket-16",
+    Raindrop = "raindrop-16",
+    RaycastLogoNeg = "raycast-logo-neg-16",
+    RaycastLogoPos = "raycast-logo-pos-16",
+    Receipt = "receipt-16",
+    Redo = "redo-16",
+    RemovePerson = "remove-person-16",
+    Repeat = "repeat-16",
+    Reply = "reply-16",
+    Rewind = "rewind-16",
+    RewindFilled = "rewind-filled-16",
+    Rocket = "rocket-16",
+    Rosette = "rosette-16",
+    RotateAntiClockwise = "rotate-anti-clockwise-16",
+    RotateClockwise = "rotate-clockwise-16",
+    Ruler = "ruler-16",
+    SaveDocument = "save-document-16",
+    Shield = "shield-01-16",
+    Shuffle = "shuffle-16",
+    Sidebar = "app-window-sidebar-right-16",
+    Signal1 = "signal-1-16",
+    Signal2 = "signal-2-16",
+    Signal3 = "signal-3-16",
+    Snippets = "snippets-16",
+    Snowflake = "snowflake-16",
+    SoccerBall = "soccer-ball-16",
+    SpeakerDown = "speaker-down-16",
+    SpeakerHigh = "speaker-high-16",
+    SpeakerLow = "speaker-low-16",
+    SpeakerOff = "speaker-off-16",
+    SpeakerOn = "speaker-on-16",
+    SpeakerUp = "speaker-up-16",
+    SpeechBubble = "speech-bubble-16",
+    SpeechBubbleActive = "speech-bubble-active-16",
+    SpeechBubbleImportant = "speech-bubble-important-16",
     Star = "star-16",
-    Text = "text-alignleft-16",
-    TextDocument = "doc-plaintext-16",
-    QuestionMark = "questionmark-circle-16",
+    StarCircle = "star-circle-16",
+    StarDisabled = "star-disabled-16",
+    Stars = "stars-16",
+    Stop = "stop-16",
+    StopFilled = "stop-filled-16",
+    Stopwatch = "stopwatch-16",
+    Store = "store-16",
+    StrikeThrough = "strike-through-16",
+    Sun = "sun-16",
+    Sunrise = "sunrise-16",
+    Swatch = "swatch-16",
+    Switch = "switch-16",
+    Syringe = "syringe-16",
+    Tag = "tag-16",
+    Temperature = "temperature-16",
+    TennisBall = "tennis-ball-16",
     Terminal = "terminal-16",
+    Text = "text-16",
+    TextCursor = "text-cursor-16",
+    Torch = "torch-16",
+    Train = "train-16",
     Trash = "trash-16",
-    Upload = "square-and-arrow-up-16",
+    Tray = "tray-16",
+    Tree = "tree-16",
+    Trophy = "trophy-16",
+    TwoPeople = "two-people-16",
+    Umbrella = "umbrella-16",
+    Underline = "underline-16",
+    Undo = "undo-16",
+    Upload = "upload-16",
+    Uppercase = "uppercase-16",
     Video = "video-16",
-    Window = "macwindow-16",
-    XmarkCircle = "xmark-circle-16"
+    Wallet = "wallet-16",
+    Wand = "wand-16",
+    Warning = "warning-16",
+    Weights = "weights-16",
+    Wifi = "wifi-16",
+    WifiDisabled = "wifi-disabled-16",
+    Window = "app-window-16",
+    WrenchScrewdriver = "wrench-screwdriver-16",
+    WristWatch = "wrist-watch-16",
+    XMarkCircle = "x-mark-circle-16",
+    XMarkCircleFilled = "x-mark-circle-filled-16",
+    /** @deprecated Use {@link Icon.ArrowClockwise} instead. */
+    TwoArrowsClockwise = "arrow-clockwise-16",
+    /** @deprecated Use {@link Icon.EyeDisabled} instead. */
+    EyeSlash = "eye-disabled-16",
+    /** @deprecated Use {@link Icon.SpeakerDown} instead. */
+    SpeakerArrowDown = "speaker-down-16",
+    /** @deprecated Use {@link Icon.SpeakerUp} instead. */
+    SpeakerArrowUp = "speaker-up-16",
+    /** @deprecated Use {@link Icon.SpeakerOff} instead. */
+    SpeakerSlash = "speaker-off-16",
+    /** @deprecated Use {@link Icon.BlankDocument} instead. */
+    TextDocument = "blank-document-16"
 }
 
 /**
@@ -4053,11 +4683,23 @@ declare const Item: FunctionComponent<ItemProps> & ItemMembers;
  */
 declare const Item_2: FunctionComponent<ItemProps_2>;
 
-declare interface ItemAccessory {
+/**
+ * @beta
+ * See {@link MenuBarExtra.Item}
+ */
+declare const Item_3: FunctionComponent<ItemProps_3>;
+
+declare type ItemAccessory = ({
     /**
      * An optional text that will be used as the label.
      */
     text?: string | undefined | null;
+} | {
+    /**
+     * 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.).
+     */
+    date?: Date | undefined | null;
+}) & {
     /**
      * An optional {@link Image.ImageLike} that will be used as the icon.
      * @remarks
@@ -4068,7 +4710,7 @@ declare interface ItemAccessory {
      * An optional tooltip shown when the accessory is hovered.
      */
     tooltip?: string | undefined | null;
-}
+};
 
 declare interface ItemMembers {
     /**
@@ -4146,6 +4788,16 @@ declare interface ItemProps extends ActionsInterface {
      * The `List.Item.Detail` to be rendered in the right side area when the parent List is showing details and the item is selected.
      */
     detail?: ReactNode;
+    /**
+     * Optional information to preview files with Quick Look. Toggle the preview with {@link Action.ToggleQuickLook}.
+     *
+     * @remarks
+     * If no `name` is specified, the file name of the given path is used.
+     */
+    quickLook?: {
+        name?: string | null;
+        path: string;
+    };
 }
 
 declare interface ItemProps_2 extends ActionsInterface {
@@ -4155,34 +4807,56 @@ declare interface ItemProps_2 extends ActionsInterface {
      */
     id?: string;
     /**
-     * An image, optionally with a tooltip, representing the content of the grid item.
+     * An image or color, optionally with a tooltip, representing the content of the grid item.
      */
     content: Image.ImageLike | {
-        value: Image.ImageLike;
+        color: Color.ColorLike;
+    } | {
+        value: Image.ImageLike | {
+            color: Color.ColorLike;
+        };
         tooltip: string;
     };
     /**
-     * The main title displayed for that item, optionally with a tooltip.
+     * An optional title displayed below the content.
      */
-    title?: string | {
-        value: string;
-        tooltip: string;
-    };
+    title?: string;
     /**
-     * An optional subtitle displayed next to the main title, optionally with a tooltip.
+     * An optional subtitle displayed below the title.
      */
-    subtitle?: string | {
-        value: string;
-        tooltip: string;
-    };
+    subtitle?: string;
     /**
      * An optional property used for providing additional indexable strings for search.
      * When filtering the list in Raycast through the search bar, the keywords will be searched in addition to the title.
      */
     keywords?: string[];
+    /**
+     * Optional information to preview files with Quick Look. Toggle the preview ith {@link Action.ToggleQuickLook}.
+     *
+     * @remarks
+     * If no `name` is specified, the file name of the given path is used.
+     */
+    quickLook?: {
+        name?: string | null;
+        path: string;
+    };
+    /**
+     * An {@link ActionPanel} that will be updated for the selected grid item.
+     */
     actions?: ReactNode | null;
 }
 
+/**
+ * @beta
+ */
+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).
@@ -4298,6 +4972,26 @@ declare interface LabelProps_2 {
     text?: string;
 }
 
+/**
+ * @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
+     */
+    UserInitiated = "userInitiated",
+    /**
+     * Scheduled through an interval and launched from background
+     */
+    Background = "background"
+}
+
 /**
  * See {@link Detail.Metadata.Link}
  */
@@ -4543,11 +5237,10 @@ declare interface ListMembers {
      * import { List } from "@raycast/api";
      *
      * function DrinkDropdown(props: DrinkDropdownProps) {
-     *   const { isLoading = false, drinkTypes, onDrinkTypeChange } = props;
+     *   const { drinkTypes, onDrinkTypeChange } = props;
      *   return (
      *     <List.Dropdown
      *       tooltip="Select Drink Type"
-     *       disabled={isLoading}
      *       storeValue={true}
      *       onChange={(newValue) => {
      *         onDrinkTypeChange(newValue);
@@ -4791,6 +5484,41 @@ 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`
+     */
+    isLoading?: boolean;
+    title?: string;
+    tooltip?: string;
+    icon?: Image.ImageLike;
+    children?: ReactNode;
+}
+
 /**
  * See {@link Detail.Metadata}
  */
@@ -5753,6 +6481,12 @@ 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>;
+
 /**
  * See {@link Form.Separator.Props}
  */
@@ -5765,6 +6499,12 @@ declare interface SeparatorProps_2 {
 declare interface SeparatorProps_3 {
 }
 
+/**
+ * @beta
+ */
+declare interface SeparatorProps_4 {
+}
+
 /**
  * @deprecated Use {@link LocalStorage.setItem} instead
  */
@@ -5926,6 +6666,12 @@ export declare const specialKeys: any;
  */
 declare const Submenu: FunctionComponent<SubmenuProps>;
 
+/**
+ * @beta
+ * See {@link MenuBarExtra.Submenu}
+ */
+declare const Submenu_2: FunctionComponent<SubmenuProps_2>;
+
 declare type SubmenuChildren = ReactElement<SectionProps> | ReactElement<SectionProps>[] | SectionChildren | null;
 
 /**
@@ -5964,6 +6710,35 @@ declare interface SubmenuProps {
      * Use {@link ActionPanel.Submenu} as parent when specifying sub-menu's children to make code is more readable.
      */
     children?: ReactNode;
+    /**
+     * Callback that is triggered when the Submenu is opened.
+     *
+     * This callback can be used to fetch its content lazily:
+     * ```js
+     * function LazySubmenu() {
+     *   const [content, setContent] = useState(null)
+     *
+     *   return (
+     *     <ActionPanel.Submenu onOpen={() => fetchSubmenuContent().then(setContent)}>
+     *       {content}
+     *     </ActionPanel.Submenu>
+     *   )
+     * }
+     * ```
+     */
+    onOpen?: () => void;
+}
+
+/**
+ * @beta
+ */
+declare interface SubmenuProps_2 {
+    title: string | {
+        value: string;
+        tooltip: string;
+    };
+    icon?: Image.ImageLike;
+    children?: ReactNode;
 }
 
 /**
@@ -6147,6 +6922,12 @@ declare interface TextAreaProps extends FormItemProps_2<string> {
      * Placeholder text shown in the text area.
      */
     placeholder?: string;
+    /**
+     * Whether markdown will be highlighted in the TextArea or not.
+     * When enabled, markdown shortcuts starts to work for the TextArea (pressing `⌘ + B` will add `**bold**` around the selected text, `⌘ + I` will make the selected text italic, etc.)
+     * @defaultValue `false`
+     */
+    enableMarkdown?: boolean;
 }
 
 /**
@@ -6332,6 +7113,34 @@ export declare interface ToastOptions extends Toast.Options {
  */
 export declare const ToastStyle: typeof Toast.Style;
 
+/**
+ * See {@link Action.ToggleQuickLook}
+ */
+declare const ToggleQuickLook: FunctionComponent<ToggleQuickLookProps>;
+
+/**
+ * See {@link Action.ToggleQuickLook.Props}
+ */
+declare interface ToggleQuickLookProps {
+    /**
+     * The title for the action.
+     * @defaultValue `"Quick Look"`
+     */
+    title?: string;
+    /**
+     * The icon displayed for the action.
+     * @defaultValue {@link Icon.Eye}
+     */
+    icon?: Image.ImageLike;
+    /**
+     * The keyboard shortcut for the action.
+     *
+     * @remarks
+     * The recommended system-wide keyboard shortcut is "⌘ + Y".
+     */
+    shortcut?: Keyboard.Shortcut;
+}
+
 /**
  * See {@link Action.Trash}
  */
@@ -6401,6 +7210,29 @@ declare interface TrashProps {
     onTrash?: (paths: PathLike | PathLike[]) => void;
 }
 
+/**
+ * @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.
+ * 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 :(
  */