@raycast/api 1.78.0 → 1.79.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raycast/api",
-  "version": "1.78.0",
+  "version": "1.79.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

@@ -2466,7 +2466,6 @@ export declare interface Environment {
  * console.log(`Is development mode: ${environment.isDevelopment}`);
  * console.log(`Raycast appearance: ${environment.appearance}`);
  * console.log(`Raycast launchType: ${environment.launchType}`);
- * console.log(`Raycast launchContext: ${environment.launchContext}`);
  * ```
  */
 export declare const environment: Environment;
@@ -5163,6 +5162,7 @@ export declare enum Icon {
     WristWatch = "wrist-watch-16",
     XMarkCircle = "x-mark-circle-16",
     XMarkCircleFilled = "x-mark-circle-filled-16",
+    XMarkCircleHalfDash = "x-mark-circle-half-dash-16",
     XMarkTopRightSquare = "x-mark-top-right-square-16",
     Xmark = "xmark-16",
     /** @deprecated Use {@link Icon.ArrowClockwise} instead. */
@@ -5376,7 +5376,7 @@ declare type InterExtensionLaunchOptions = {
     type: LaunchType;
     /** Optional object for the argument properties and values as defined in the extension's manifest, for example: `{ "argument1": "value1" }` */
     arguments?: Arguments | null;
-    /** Arbitrary object for custom data that should be passed to the command and accessible as `environment.launchContext`; the object must be JSON serializable (Dates and Buffers supported) */
+    /** Arbitrary object for custom data that should be passed to the command and accessible as {@link LaunchProps}; the object must be JSON serializable (Dates and Buffers supported) */
     context?: LaunchContext | null;
     /** Optional string to send as fallback text to the command */
     fallbackText?: string | null;
@@ -5392,7 +5392,7 @@ declare type IntraExtensionLaunchOptions = {
     type: LaunchType;
     /** Optional object for the argument properties and values as defined in the extension's manifest, for example: `{ "argument1": "value1" }` */
     arguments?: Arguments | null;
-    /** Arbitrary object for custom data that should be passed to the command and accessible as `environment.launchContext`; the object must be JSON serializable (Dates and Buffers supported) */
+    /** Arbitrary object for custom data that should be passed to the command and accessible as {@link LaunchProps}; the object must be JSON serializable (Dates and Buffers supported) */
     context?: LaunchContext | null;
     /** Optional string to send as fallback text to the command */
     fallbackText?: string | null;
@@ -6694,8 +6694,9 @@ declare interface LabelProps {
       * Push a new view component to the navigation stack.
       *
       * @param component - The React component to push to the navigation stack.
+      * @param onPop - A callback that is called when the component will be popped from the navigation stack.
       */
-     push: (component: ReactNode) => void;
+     push: (component: ReactNode, onPop?: () => void) => void;
      /**
       * Pop current view component from the navigation stack.
       */
@@ -7531,6 +7532,10 @@ declare interface LabelProps {
       * This is handy when you want to act on the pushed target view, e.g. uprank a selected list item.
       */
      onPush?: () => void;
+     /**
+      * Callback when the target view will be popped.
+      */
+     onPop?: () => void;
  }
 
  declare interface Quicklink {
@@ -8610,10 +8615,10 @@ declare interface LabelProps {
       *
       * @example
       * ```typescript
-      * import { getDesktops, showToast } from "@raycast/api";
+      * import { WindowManagement, showToast } from "@raycast/api";
       *
       * export default async function Command() {
-      *   const desktops = await getDesktops();
+      *   const desktops = await WindowManagement.getDesktops();
       *   const screens = Set(desktops.map((desktop) => desktop.screenId));
       *   showToast({title: `Found ${desktops.length} desktops on ${screens.size} screens.`});
       * }
@@ -8628,16 +8633,16 @@ declare interface LabelProps {
       *
       * @example
       * ```typescript
-      * import { getWindowsOnActiveDesktop, setWindowBounds, showToast } from "@raycast/api";
+      * import { WindowManagement, showToast } from "@raycast/api";
       *
       * export default async function Command() {
-      *   const windows = await getWindowsOnActiveDesktop();
+      *   const windows = await WindowManagement.getWindowsOnActiveDesktop();
       *   const chrome = windows.find((x) => x.application?.bundleId === "com.google.Chrome");
       *   if (!chrome) {
       *     showToast({ title: "Couldn't find chrome", style: Toast.Style.Failure });
       *     return;
       *   }
-      *   setWindowBounds({ id: chrome.id, bounds: { position: { x: 100 } } })
+      *   WindowManagement.setWindowBounds({ id: chrome.id, bounds: { position: { x: 100 } } })
       * }
       * ```
       */
@@ -8649,12 +8654,12 @@ declare interface LabelProps {
       *
       * @example
       * ```typescript
-      * import { getActiveWindow, setWindowBounds, showToast } from "@raycast/api";
+      * import { WindowManagement, showToast } from "@raycast/api";
       *
       * export default async function Command() {
       *   try {
-      *     const window = await getActiveWindow();
-      *     setWindowBounds({ id: window.id, bounds: { position: { x: 100 } } })
+      *     const window = await WindowManagement.getActiveWindow();
+      *     WindowManagement.setWindowBounds({ id: window.id, bounds: { position: { x: 100 } } })
       *   } catch (error) {
       *     showToast({ title: "Could not move window", message: error.message, style: Toast.Style.Failure });
       *   }