@raycast/api 1.37.1 → 1.38.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/types/index.d.ts CHANGED
@@ -37,10 +37,13 @@ import { RefAttributes } from 'react';
37
37
  * }
38
38
  * ```
39
39
  */
40
- export declare const Action: FunctionComponent<ActionProps> & ConvenienceActions;
40
+ export declare const Action: FunctionComponent<ActionProps> & ConvenienceActions & {
41
+ Style: typeof ActionStyle;
42
+ };
41
43
 
42
44
  export declare namespace Action {
43
45
  export type Props = ActionProps;
46
+ export type Style = ActionStyle;
44
47
  export namespace CopyToClipboard {
45
48
  /**
46
49
  * Props of the {@link Action.CopyToClipboard} React component.
@@ -123,8 +126,9 @@ export declare namespace Action {
123
126
  * sections and can have keyboard shortcuts assigned.
124
127
  *
125
128
  * The first and second action become the primary and secondary action. They automatically get the default keyboard shortcuts assigned.
126
- * In {@link List} and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and
129
+ * In {@link List}, {@link Grid}, and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and
127
130
  * `⌘` `⇧` `↵` for the secondary.
131
+ * Keep in mind that while you can specify an alternative shortcut for the primary and secondary actions, it won't be displayed in the Action Panel.
128
132
  *
129
133
  * @example
130
134
  * ```typescript
@@ -194,7 +198,9 @@ declare type ActionPanelChildren_2 = ReactElement<ActionPanel.Section.Props> | R
194
198
  /**
195
199
  * @deprecated Use {@link Action} instead.
196
200
  */
197
- export declare const ActionPanelItem: FunctionComponent<ActionProps> & ConvenienceActions;
201
+ export declare const ActionPanelItem: FunctionComponent<ActionProps> & ConvenienceActions & {
202
+ Style: ActionStyle;
203
+ };
198
204
 
199
205
  /**
200
206
  * @deprecated Use {@link Action.Props} instead.
@@ -360,12 +366,23 @@ declare interface ActionProps {
360
366
  * The icon displayed for the action.
361
367
  */
362
368
  icon?: Image.ImageLike | undefined | null;
369
+ /**
370
+ * Defines the visual style of the Action.
371
+ *
372
+ * @remarks
373
+ * Use {@link Action.Style.Regular} for displaying a regular actions.
374
+ * Use {@link Action.Style.Destructive} when your action has something that user should be careful about.
375
+ * Use the confirmation {@link Alert} if the action is doing something that user cannot revert.
376
+ * @defaultValue {@link Action.Style.Regular}
377
+ */
378
+ style?: ActionStyle;
363
379
  /**
364
380
  * The keyboard shortcut for the item.
365
381
  *
366
382
  * @remarks
367
383
  * The first and second action in an {@link ActionPanel} become the primary and secondary action. They automatically get the default keyboard shortcuts assigned.
368
- * In {@link List} and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and `⌘` `⇧` `↵` for the secondary.
384
+ * In {@link List}, {@link Grid} ,and {@link Detail}, this is `↵` for the primary and `⌘` `↵` for the secondary action. In {@link Form} it's `⌘` `↵` for the primary and `⌘` `⇧` `↵` for the secondary.
385
+ * Keep in mind that while you can specify an alternative shortcut for the primary and secondary actions, it won't be displayed in the Action Panel.
369
386
  */
370
387
  shortcut?: Keyboard.Shortcut | undefined | null;
371
388
  /**
@@ -384,6 +401,19 @@ declare interface ActionsInterface {
384
401
  actions?: ReactNode;
385
402
  }
386
403
 
404
+ /**
405
+ * Defines the visual style of the Action.
406
+ *
407
+ * @remarks
408
+ * Use {@link Action.Style.Regular} for displaying a regular actions.
409
+ * Use {@link Action.Style.Destructive} when your action has something that user should be careful about.
410
+ * Use the confirmation {@link Alert} if the action is doing something that user cannot revert.
411
+ */
412
+ declare enum ActionStyle {
413
+ Regular = "regular",
414
+ Destructive = "destructive"
415
+ }
416
+
387
417
  export declare namespace Alert {
388
418
  /**
389
419
  * The options to create an {@link Alert}.
@@ -506,6 +536,26 @@ export declare interface Application {
506
536
  bundleId?: string;
507
537
  }
508
538
 
539
+ /**
540
+ * A record type holding the arguments (entered in Raycast Root Search Bar) that have been passed to the command.
541
+ */
542
+ declare interface Arguments {
543
+ /**
544
+ * The representation of arguments given that key here is the `name` defined in manifest file and value is the user's input
545
+ */
546
+ [item: string]: any;
547
+ }
548
+
549
+ /**
550
+ * An interface describing top-level props for arguments
551
+ */
552
+ export declare interface ArgumentsLaunchProps {
553
+ /**
554
+ * Use these values to populate the initial state for your command.
555
+ */
556
+ arguments?: Arguments;
557
+ }
558
+
509
559
  /**
510
560
  * Caching abstraction that stores data on disk and supports LRU (least recently used) access.
511
561
  * Since extensions can only consume up to a max. heap memory size, the cache only maintains a lightweight index in memory
@@ -513,7 +563,7 @@ export declare interface Application {
513
563
  *
514
564
  * The Cache class provides CRUD-style methods (get, set, remove) to update and retrieve data synchronously based on a key.
515
565
  * The data must be a string and it is up to the client to decide which serialization format to use.
516
- * (A typical use case would be to use JSON.stringify and JSON.parse.)
566
+ * A typical use case would be to use `JSON.stringify` and `JSON.parse`.
517
567
  *
518
568
  * @remarks By default, the cache is shared between the commands of an extension. Use {@link Cache.Options} to configure
519
569
  * a `namespace` per command if needed (for example, set it to `environment.commandName`).
@@ -576,9 +626,9 @@ export declare class Cache {
576
626
  }): void;
577
627
  /**
578
628
  * Registers a new subscriber that gets notified when cache data is set or removed.
579
- * @returns a function that can be used to remove the subscriber.
629
+ * @returns a function that can be called to remove the subscriber.
580
630
  */
581
- subscribe(subscription: Cache.Subscriber): Cache.Subscription;
631
+ subscribe(subscriber: Cache.Subscriber): Cache.Subscription;
582
632
  private maintainCapacity;
583
633
  private notifySubscribers;
584
634
  }
@@ -596,11 +646,12 @@ export declare namespace Cache {
596
646
  namespace?: string;
597
647
  /**
598
648
  * The parent directory for the cache data.
649
+ * @deprecated this parameter will be removed in the future – use the default directory.
599
650
  */
600
651
  directory?: string;
601
652
  /**
602
653
  * The capacity in bytes. If the stored data exceeds the capacity, the least recently used data is removed.
603
- * @default 10000000 (10 MB)
654
+ * The default capacity is 10 MB.
604
655
  */
605
656
  capacity?: number;
606
657
  }
@@ -1175,13 +1226,10 @@ declare interface ConvenienceActions {
1175
1226
  * <List>
1176
1227
  * <List.Item
1177
1228
  * title="Preview me"
1229
+ * quickLook={{ path: "~/Downloads/Raycast.dmg", name: "Some file" }}
1178
1230
  * actions={
1179
1231
  * <ActionPanel>
1180
- * <Action.ToggleQuickLook
1181
- * name="Some file"
1182
- * path="~/Downloads/Raycast.dmg"
1183
- * shortcut={{ modifiers: ["cmd"], key: "y" }}
1184
- * />
1232
+ * <Action.ToggleQuickLook shortcut={{ modifiers: ["cmd"], key: "y" }} />
1185
1233
  * </ActionPanel>
1186
1234
  * }
1187
1235
  * />
@@ -2080,6 +2128,10 @@ export declare interface Environment {
2080
2128
  * The theme used by the Raycast application.
2081
2129
  */
2082
2130
  theme: "light" | "dark";
2131
+ /**
2132
+ * The type of launch for the command (user initiated or background).
2133
+ */
2134
+ launchType: LaunchType;
2083
2135
  }
2084
2136
 
2085
2137
  /**
@@ -2096,6 +2148,7 @@ export declare interface Environment {
2096
2148
  * console.log(`Support path: ${environment.supportPath}`);
2097
2149
  * console.log(`Is development mode: ${environment.isDevelopment}`);
2098
2150
  * console.log(`Raycast theme: ${environment.theme}`);
2151
+ * console.log(`Raycast launchType: ${environment.launchType}`);
2099
2152
  * ```
2100
2153
  */
2101
2154
  export declare const environment: Environment;
@@ -3900,11 +3953,10 @@ declare interface GridMembers {
3900
3953
  * import { Grid } from "@raycast/api";
3901
3954
  *
3902
3955
  * function DrinkDropdown(props: DrinkDropdownProps) {
3903
- * const { isLoading = false, drinkTypes, onDrinkTypeChange } = props;
3956
+ * const { drinkTypes, onDrinkTypeChange } = props;
3904
3957
  * return (
3905
3958
  * <Grid.Dropdown
3906
3959
  * tooltip="Select Drink Type"
3907
- * disabled={isLoading}
3908
3960
  * storeValue={true}
3909
3961
  * onChange={(newValue) => {
3910
3962
  * onDrinkTypeChange(newValue);
@@ -4022,55 +4074,427 @@ declare interface GridProps extends ActionsInterface, NavigationChildInterface {
4022
4074
  * ```
4023
4075
  */
4024
4076
  export declare enum Icon {
4077
+ AddPerson = "add-person-16",
4078
+ Airplane = "airplane-16",
4079
+ AirplaneFilled = "airplane-filled-16",
4080
+ AirplaneLanding = "airplane-landing-16",
4081
+ AirplaneTakeoff = "airplane-takeoff-16",
4082
+ Airpods = "airpods-16",
4083
+ Alarm = "alarm-16",
4084
+ AlarmRinging = "alarm-ringing-16",
4085
+ AlignCentre = "align-centre-16",
4086
+ AlignLeft = "align-left-16",
4087
+ AlignRight = "align-right-16",
4088
+ AmericanFootball = "american-football-16",
4089
+ Anchor = "anchor-16",
4090
+ AppWindow = "app-window-16",
4091
+ AppWindowGrid2x2 = "app-window-grid-2x2-16",
4092
+ AppWindowGrid3x3 = "app-window-grid-3x3-16",
4093
+ AppWindowList = "app-window-list-16",
4094
+ AppWindowSidebarLeft = "app-window-sidebar-left-16",
4095
+ AppWindowSidebarRight = "app-window-sidebar-right-16",
4025
4096
  ArrowClockwise = "arrow-clockwise-16",
4026
- TwoArrowsClockwise = "arrow-2-clockwise-16",
4097
+ ArrowCounterClockwise = "arrow-counter-clockwise-16",
4098
+ ArrowDown = "arrow-down-16",
4099
+ ArrowDownCircle = "arrow-down-circle-16",
4100
+ ArrowDownCircleFilled = "arrow-down-circle-filled-16",
4101
+ ArrowLeft = "arrow-left-16",
4102
+ ArrowLeftCircle = "arrow-left-circle-16",
4103
+ ArrowLeftCircleFilled = "arrow-left-circle-filled-16",
4104
+ ArrowNe = "arrow-ne-16",
4027
4105
  ArrowRight = "arrow-right-16",
4106
+ ArrowRightCircle = "arrow-right-circle-16",
4107
+ ArrowRightCircleFilled = "arrow-right-circle-filled-16",
4108
+ ArrowUp = "arrow-up-16",
4109
+ ArrowUpCircle = "arrow-up-circle-16",
4110
+ ArrowUpCircleFilled = "arrow-up-circle-filled-16",
4111
+ AtSymbol = "at-symbol-16",
4112
+ BandAid = "band-aid-16",
4113
+ BankNote = "bank-note-16",
4114
+ BarChart = "bar-chart-16",
4115
+ BarCode = "bar-code-16",
4116
+ BathTub = "bath-tub-16",
4117
+ Battery = "battery-16",
4118
+ BatteryCharging = "battery-charging-16",
4119
+ BatteryDisabled = "battery-disabled-16",
4120
+ Bell = "bell-16",
4121
+ BellDisabled = "bell-disabled-16",
4122
+ Bike = "bike-16",
4028
4123
  Binoculars = "binoculars-16",
4029
- Bubble = "bubble-left-16",
4124
+ BlankDocument = "blank-document-16",
4125
+ Bluetooth = "bluetooth-16",
4126
+ Boat = "boat-16",
4127
+ Bold = "bold-16",
4128
+ Bolt = "bolt-16",
4129
+ BoltDisabled = "bolt-disabled-16",
4130
+ Book = "book-16",
4131
+ Bookmark = "bookmark-16",
4132
+ Box = "box-16",
4133
+ Brush = "brush-16",
4134
+ Bubble = "speech-bubble-16",
4135
+ Bug = "bug-16",
4136
+ BulletPoints = "bullet-points-16",
4137
+ BullsEye = "bulls-eye-16",
4138
+ Buoy = "buoy-16",
4139
+ Calculator = "calculator-16",
4030
4140
  Calendar = "calendar-16",
4031
- Checkmark = "checkmark-circle-16",
4141
+ Camera = "camera-16",
4142
+ Car = "car-16",
4143
+ Cart = "cart-16",
4144
+ Cd = "cd-16",
4145
+ Center = "center-16",
4146
+ Check = "check-16",
4147
+ CheckCircle = "check-circle-16",
4148
+ Checkmark = "check-circle-16",
4149
+ ChessPiece = "chess-piece-16",
4032
4150
  ChevronDown = "chevron-down-16",
4151
+ ChevronLeft = "chevron-left-16",
4152
+ ChevronRight = "chevron-right-16",
4033
4153
  ChevronUp = "chevron-up-16",
4034
4154
  Circle = "circle-16",
4035
- Clipboard = "doc-on-clipboard-16",
4155
+ CircleEllipsis = "circle-ellipsis-16",
4156
+ CircleFilled = "circle-filled-16",
4157
+ CircleProgress = "circle-progress-16",
4158
+ CircleProgress100 = "circle-progress-100-16",
4159
+ CircleProgress25 = "circle-progress-25-16",
4160
+ CircleProgress50 = "circle-progress-50-16",
4161
+ CircleProgress75 = "circle-progress-75-16",
4162
+ ClearFormatting = "clear-formatting-16",
4163
+ Clipboard = "copy-clipboard-16",
4036
4164
  Clock = "clock-16",
4037
- Desktop = "desktopcomputer-16",
4038
- Document = "doc-16",
4165
+ Cloud = "cloud-16",
4166
+ CloudLightning = "cloud-lightning-16",
4167
+ CloudRain = "cloud-rain-16",
4168
+ CloudSnow = "cloud-snow-16",
4169
+ CloudSun = "cloud-sun-16",
4170
+ Code = "code-16",
4171
+ CodeBlock = "code-block-16",
4172
+ Cog = "cog-16",
4173
+ Coin = "coin-16",
4174
+ Coins = "coins-16",
4175
+ Compass = "compass-16",
4176
+ ComputerChip = "computer-chip-16",
4177
+ Contrast = "contrast-16",
4178
+ CopyClipboard = "copy-clipboard-16",
4179
+ CreditCard = "credit-card-16",
4180
+ CricketBall = "cricket-ball-16",
4181
+ Crop = "crop-16",
4182
+ Crown = "crown-16",
4183
+ Crypto = "crypto-16",
4184
+ DeleteDocument = "delete-document-16",
4185
+ Desktop = "desktop-16",
4186
+ Dna = "dna-16",
4187
+ Document = "blank-document-16",
4039
4188
  Dot = "dot-16",
4040
- Download = "square-and-arrow-down-16",
4189
+ Download = "download-16",
4190
+ EditShape = "edit-shape-16",
4191
+ Eject = "eject-16",
4192
+ Ellipsis = "ellipsis-16",
4193
+ Emoji = "emoji-16",
4041
4194
  Envelope = "envelope-16",
4042
- ExclamationMark = "exclamation-mark-triangle-16",
4195
+ Eraser = "eraser-16",
4196
+ ExclamationMark = "important-01-16",
4197
+ Exclamationmark = "exclamationmark-16",
4198
+ Exclamationmark2 = "exclamationmark-2-16",
4199
+ Exclamationmark3 = "exclamationmark-3-16",
4043
4200
  Eye = "eye-16",
4044
- EyeSlash = "eye-slash-16",
4201
+ EyeDisabled = "eye-disabled-16",
4202
+ EyeDropper = "eye-dropper-16",
4203
+ Female = "female-16",
4204
+ FilmStrip = "film-strip-16",
4205
+ Filter = "filter-16",
4045
4206
  Finder = "finder-16",
4046
- Gear = "gearshape-16",
4047
- Globe = "globe-16",
4207
+ Fingerprint = "fingerprint-16",
4208
+ Folder = "folder-16",
4209
+ Footprints = "footprints-16",
4210
+ Forward = "forward-16",
4211
+ ForwardFilled = "forward-filled-16",
4212
+ FountainTip = "fountain-tip-16",
4213
+ FullSignal = "full-signal-16",
4214
+ GameController = "game-controller-16",
4215
+ Gauge = "gauge-16",
4216
+ Gear = "cog-16",
4217
+ Geopin = "geopin-16",
4218
+ Germ = "germ-16",
4219
+ Gift = "gift-16",
4220
+ Glasses = "glasses-16",
4221
+ Globe = "globe-01-16",
4222
+ Goal = "goal-16",
4048
4223
  Hammer = "hammer-16",
4049
- LevelMeter = "level-meter-16",
4224
+ HardDrive = "hard-drive-16",
4225
+ Hashtag = "hashtag-16",
4226
+ Headphones = "headphones-16",
4227
+ Heart = "heart-16",
4228
+ HeartDisabled = "heart-disabled-16",
4229
+ Heartbeat = "heartbeat-16",
4230
+ Highlight = "highlight-16",
4231
+ Hourglass = "hourglass-16",
4232
+ House = "house-16",
4233
+ Image = "image-16",
4234
+ Important = "important-01-16",
4235
+ Info = "info-01-16",
4236
+ Italics = "italics-16",
4237
+ Key = "key-16",
4238
+ Keyboard = "keyboard-16",
4239
+ Layers = "layers-16",
4240
+ Leaderboard = "leaderboard-16",
4241
+ Leaf = "leaf-16",
4242
+ LevelMeter = "signal-2-16",
4243
+ LightBulb = "light-bulb-16",
4244
+ LightBulbOff = "light-bulb-off-16",
4245
+ LineChart = "line-chart-16",
4050
4246
  Link = "link-16",
4051
- List = "main-list-view-16",
4052
- MagnifyingGlass = "magnifyingglass-16",
4053
- MemoryChip = "memorychip-16",
4054
- Message = "message-16",
4247
+ List = "app-window-list-16",
4248
+ Livestream = "livestream-01-16",
4249
+ Lock = "lock-16",
4250
+ LockDisabled = "lock-disabled-16",
4251
+ LockUnlocked = "lock-unlocked-16",
4252
+ Logout = "logout-16",
4253
+ Lorry = "lorry-16",
4254
+ Lowercase = "lowercase-16",
4255
+ MagnifyingGlass = "magnifying-glass-16",
4256
+ Male = "male-16",
4257
+ Map = "map-16",
4258
+ Mask = "mask-16",
4259
+ Maximize = "maximize-16",
4260
+ MedicalSupport = "medical-support-16",
4261
+ Megaphone = "megaphone-16",
4262
+ MemoryChip = "computer-chip-16",
4263
+ MemoryStick = "memory-stick-16",
4264
+ Message = "speech-bubble-16",
4265
+ Microphone = "microphone-16",
4266
+ MicrophoneDisabled = "microphone-disabled-16",
4267
+ Minimize = "minimize-16",
4268
+ Minus = "minus-16",
4269
+ MinusCircle = "minus-circle-16",
4270
+ MinusCircleFilled = "minus-circle-filled-16",
4271
+ Mobile = "mobile-16",
4272
+ Monitor = "monitor-16",
4273
+ Moon = "moon-16",
4274
+ Mountain = "mountain-16",
4275
+ Mouse = "mouse-16",
4276
+ Multiply = "multiply-16",
4277
+ Music = "music-16",
4278
+ Network = "network-16",
4279
+ NewDocument = "new-document-16",
4280
+ NewFolder = "new-folder-16",
4281
+ Number00 = "number-00-16",
4282
+ Number01 = "number-01-16",
4283
+ Number02 = "number-02-16",
4284
+ Number03 = "number-03-16",
4285
+ Number04 = "number-04-16",
4286
+ Number05 = "number-05-16",
4287
+ Number06 = "number-06-16",
4288
+ Number07 = "number-07-16",
4289
+ Number08 = "number-08-16",
4290
+ Number09 = "number-09-16",
4291
+ Number10 = "number-10-16",
4292
+ Number11 = "number-11-16",
4293
+ Number12 = "number-12-16",
4294
+ Number13 = "number-13-16",
4295
+ Number14 = "number-14-16",
4296
+ Number15 = "number-15-16",
4297
+ Number16 = "number-16-16",
4298
+ Number17 = "number-17-16",
4299
+ Number18 = "number-18-16",
4300
+ Number19 = "number-19-16",
4301
+ Number20 = "number-20-16",
4302
+ Number21 = "number-21-16",
4303
+ Number22 = "number-22-16",
4304
+ Number23 = "number-23-16",
4305
+ Number24 = "number-24-16",
4306
+ Number25 = "number-25-16",
4307
+ Number26 = "number-26-16",
4308
+ Number27 = "number-27-16",
4309
+ Number28 = "number-28-16",
4310
+ Number29 = "number-29-16",
4311
+ Number30 = "number-30-16",
4312
+ Number31 = "number-31-16",
4313
+ Number32 = "number-32-16",
4314
+ Number33 = "number-33-16",
4315
+ Number34 = "number-34-16",
4316
+ Number35 = "number-35-16",
4317
+ Number36 = "number-36-16",
4318
+ Number37 = "number-37-16",
4319
+ Number38 = "number-38-16",
4320
+ Number39 = "number-39-16",
4321
+ Number40 = "number-40-16",
4322
+ Number41 = "number-41-16",
4323
+ Number42 = "number-42-16",
4324
+ Number43 = "number-43-16",
4325
+ Number44 = "number-44-16",
4326
+ Number45 = "number-45-16",
4327
+ Number46 = "number-46-16",
4328
+ Number47 = "number-47-16",
4329
+ Number48 = "number-48-16",
4330
+ Number49 = "number-49-16",
4331
+ Number50 = "number-50-16",
4332
+ Number51 = "number-51-16",
4333
+ Number52 = "number-52-16",
4334
+ Number53 = "number-53-16",
4335
+ Number54 = "number-54-16",
4336
+ Number55 = "number-55-16",
4337
+ Number56 = "number-56-16",
4338
+ Number57 = "number-57-16",
4339
+ Number58 = "number-58-16",
4340
+ Number59 = "number-59-16",
4341
+ Number60 = "number-60-16",
4342
+ Number61 = "number-61-16",
4343
+ Number62 = "number-62-16",
4344
+ Number63 = "number-63-16",
4345
+ Number64 = "number-64-16",
4346
+ Number65 = "number-65-16",
4347
+ Number66 = "number-66-16",
4348
+ Number67 = "number-67-16",
4349
+ Number68 = "number-68-16",
4350
+ Number69 = "number-69-16",
4351
+ Number70 = "number-70-16",
4352
+ Number71 = "number-71-16",
4353
+ Number72 = "number-72-16",
4354
+ Number73 = "number-73-16",
4355
+ Number74 = "number-74-16",
4356
+ Number75 = "number-75-16",
4357
+ Number76 = "number-76-16",
4358
+ Number77 = "number-77-16",
4359
+ Number78 = "number-78-16",
4360
+ Number79 = "number-79-16",
4361
+ Number80 = "number-80-16",
4362
+ Number81 = "number-81-16",
4363
+ Number82 = "number-82-16",
4364
+ Number83 = "number-83-16",
4365
+ Number84 = "number-84-16",
4366
+ Number85 = "number-85-16",
4367
+ Number86 = "number-86-16",
4368
+ Number87 = "number-87-16",
4369
+ Number88 = "number-88-16",
4370
+ Number89 = "number-89-16",
4371
+ Number90 = "number-90-16",
4372
+ Number91 = "number-91-16",
4373
+ Number92 = "number-92-16",
4374
+ Number93 = "number-93-16",
4375
+ Number94 = "number-94-16",
4376
+ Number95 = "number-95-16",
4377
+ Number96 = "number-96-16",
4378
+ Number97 = "number-97-16",
4379
+ Number98 = "number-98-16",
4380
+ Number99 = "number-99-16",
4381
+ Paperclip = "paperclip-16",
4382
+ Patch = "patch-16",
4383
+ Pause = "pause-16",
4384
+ PauseFilled = "pause-filled-16",
4055
4385
  Pencil = "pencil-16",
4056
- Person = "person-crop-circle-16",
4386
+ Person = "person-16",
4387
+ PersonCircle = "person-circle-16",
4057
4388
  Phone = "phone-16",
4389
+ PhoneRinging = "phone-ringing-16",
4390
+ PieChart = "pie-chart-16",
4391
+ Pill = "pill-16",
4058
4392
  Pin = "pin-16",
4393
+ PinDisabled = "pin-disabled-16",
4394
+ Play = "play-16",
4395
+ PlayFilled = "play-filled-16",
4396
+ Plug = "plug-16",
4059
4397
  Plus = "plus-16",
4060
- Sidebar = "sidebar-right-16",
4061
- SpeakerArrowDown = "speaker-arrow-down-16",
4062
- SpeakerArrowUp = "speaker-arrow-up-16",
4063
- SpeakerSlash = "speaker-slash-16",
4398
+ PlusCircle = "plus-circle-16",
4399
+ PlusCircleFilled = "plus-circle-filled-16",
4400
+ PlusMinusDivideMultiply = "plus-minus-divide-multiply-16",
4401
+ Power = "power-16",
4402
+ Print = "print-16",
4403
+ QuestionMark = "question-mark-circle-16",
4404
+ QuestionMarkCircle = "question-mark-circle-16",
4405
+ QuotationMarks = "quotation-marks-16",
4406
+ QuoteBlock = "quote-block-16",
4407
+ Racket = "racket-16",
4408
+ Raindrop = "raindrop-16",
4409
+ RaycastLogoNeg = "raycast-logo-neg-16",
4410
+ RaycastLogoPos = "raycast-logo-pos-16",
4411
+ Receipt = "receipt-16",
4412
+ Redo = "redo-16",
4413
+ RemovePerson = "remove-person-16",
4414
+ Repeat = "repeat-16",
4415
+ Reply = "reply-16",
4416
+ Rewind = "rewind-16",
4417
+ RewindFilled = "rewind-filled-16",
4418
+ Rocket = "rocket-16",
4419
+ Rosette = "rosette-16",
4420
+ RotateAntiClockwise = "rotate-anti-clockwise-16",
4421
+ RotateClockwise = "rotate-clockwise-16",
4422
+ Ruler = "ruler-16",
4423
+ SaveDocument = "save-document-16",
4424
+ Shield = "shield-01-16",
4425
+ Shuffle = "shuffle-16",
4426
+ Sidebar = "app-window-sidebar-right-16",
4427
+ Signal1 = "signal-1-16",
4428
+ Signal2 = "signal-2-16",
4429
+ Signal3 = "signal-3-16",
4430
+ Snippets = "snippets-16",
4431
+ Snowflake = "snowflake-16",
4432
+ SoccerBall = "soccer-ball-16",
4433
+ SpeakerDown = "speaker-down-16",
4434
+ SpeakerHigh = "speaker-high-16",
4435
+ SpeakerLow = "speaker-low-16",
4436
+ SpeakerOff = "speaker-off-16",
4437
+ SpeakerOn = "speaker-on-16",
4438
+ SpeakerUp = "speaker-up-16",
4439
+ SpeechBubble = "speech-bubble-16",
4440
+ SpeechBubbleActive = "speech-bubble-active-16",
4441
+ SpeechBubbleImportant = "speech-bubble-important-16",
4064
4442
  Star = "star-16",
4065
- Text = "text-alignleft-16",
4066
- TextDocument = "doc-plaintext-16",
4067
- QuestionMark = "questionmark-circle-16",
4443
+ StarCircle = "star-circle-16",
4444
+ StarDisabled = "star-disabled-16",
4445
+ Stars = "stars-16",
4446
+ Stop = "stop-16",
4447
+ StopFilled = "stop-filled-16",
4448
+ Stopwatch = "stopwatch-16",
4449
+ Store = "store-16",
4450
+ StrikeThrough = "strike-through-16",
4451
+ Sun = "sun-16",
4452
+ Sunrise = "sunrise-16",
4453
+ Swatch = "swatch-16",
4454
+ Switch = "switch-16",
4455
+ Syringe = "syringe-16",
4456
+ Tag = "tag-16",
4457
+ Temperature = "temperature-16",
4458
+ TennisBall = "tennis-ball-16",
4068
4459
  Terminal = "terminal-16",
4460
+ Text = "text-16",
4461
+ TextCursor = "text-cursor-16",
4462
+ Torch = "torch-16",
4463
+ Train = "train-16",
4069
4464
  Trash = "trash-16",
4070
- Upload = "square-and-arrow-up-16",
4465
+ Tray = "tray-16",
4466
+ Tree = "tree-16",
4467
+ Trophy = "trophy-16",
4468
+ TwoPeople = "two-people-16",
4469
+ Umbrella = "umbrella-16",
4470
+ Underline = "underline-16",
4471
+ Undo = "undo-16",
4472
+ Upload = "upload-16",
4473
+ Uppercase = "uppercase-16",
4071
4474
  Video = "video-16",
4072
- Window = "macwindow-16",
4073
- XmarkCircle = "xmark-circle-16"
4475
+ Wallet = "wallet-16",
4476
+ Wand = "wand-16",
4477
+ Warning = "warning-16",
4478
+ Weights = "weights-16",
4479
+ Wifi = "wifi-16",
4480
+ WifiDisabled = "wifi-disabled-16",
4481
+ Window = "app-window-16",
4482
+ WrenchScrewdriver = "wrench-screwdriver-16",
4483
+ WristWatch = "wrist-watch-16",
4484
+ XMarkCircle = "x-mark-circle-16",
4485
+ XMarkCircleFilled = "x-mark-circle-filled-16",
4486
+ /** @deprecated Use {@link Icon.ArrowClockwise} instead. */
4487
+ TwoArrowsClockwise = "arrow-clockwise-16",
4488
+ /** @deprecated Use {@link Icon.EyeDisabled} instead. */
4489
+ EyeSlash = "eye-disabled-16",
4490
+ /** @deprecated Use {@link Icon.SpeakerDown} instead. */
4491
+ SpeakerArrowDown = "speaker-down-16",
4492
+ /** @deprecated Use {@link Icon.SpeakerUp} instead. */
4493
+ SpeakerArrowUp = "speaker-up-16",
4494
+ /** @deprecated Use {@link Icon.SpeakerOff} instead. */
4495
+ SpeakerSlash = "speaker-off-16",
4496
+ /** @deprecated Use {@link Icon.BlankDocument} instead. */
4497
+ TextDocument = "blank-document-16"
4074
4498
  }
4075
4499
 
4076
4500
  /**
@@ -4264,6 +4688,11 @@ declare const Item: FunctionComponent<ItemProps> & ItemMembers;
4264
4688
  */
4265
4689
  declare const Item_2: FunctionComponent<ItemProps_2>;
4266
4690
 
4691
+ /**
4692
+ * See {@link MenuBarExtra.Item}
4693
+ */
4694
+ declare const Item_3: FunctionComponent<ItemProps_3>;
4695
+
4267
4696
  declare type ItemAccessory = ({
4268
4697
  /**
4269
4698
  * An optional text that will be used as the label.
@@ -4364,7 +4793,7 @@ declare interface ItemProps extends ActionsInterface {
4364
4793
  */
4365
4794
  detail?: ReactNode;
4366
4795
  /**
4367
- * Optional information to preview files with Quick Look. Toggle the preview ith {@link Action.ToggleQuickLook}.
4796
+ * Optional information to preview files with Quick Look. Toggle the preview with {@link Action.ToggleQuickLook}.
4368
4797
  *
4369
4798
  * @remarks
4370
4799
  * If no `name` is specified, the file name of the given path is used.
@@ -4421,6 +4850,29 @@ declare interface ItemProps_2 extends ActionsInterface {
4421
4850
  actions?: ReactNode | null;
4422
4851
  }
4423
4852
 
4853
+ declare interface ItemProps_3 {
4854
+ /**
4855
+ * The main title displayed for this item.
4856
+ */
4857
+ title: string;
4858
+ /**
4859
+ * An optional icon for this item.
4860
+ */
4861
+ icon?: Image.ImageLike;
4862
+ /**
4863
+ * A tooltip to display when the cursor hovers the item.
4864
+ */
4865
+ tooltip?: string;
4866
+ /**
4867
+ * An action handler called when the user clicks the item.
4868
+ */
4869
+ onAction?: () => void;
4870
+ /**
4871
+ * A shortcut used to invoke this item when its parent menu is open.
4872
+ */
4873
+ shortcut?: Keyboard.Shortcut;
4874
+ }
4875
+
4424
4876
  export declare namespace Keyboard {
4425
4877
  /**
4426
4878
  * A keyboard shortcut is defined by one or more modifier keys (command, control, etc.) and a single key equivalent (a character or special key).
@@ -4539,7 +4991,18 @@ declare interface LabelProps_2 {
4539
4991
  /**
4540
4992
  * The top-level props that a Command receives on launch
4541
4993
  */
4542
- export declare type LaunchProps = FormLaunchProps;
4994
+ export declare type LaunchProps = ArgumentsLaunchProps | FormLaunchProps;
4995
+
4996
+ export declare enum LaunchType {
4997
+ /**
4998
+ * A regular launch through user interaction
4999
+ */
5000
+ UserInitiated = "userInitiated",
5001
+ /**
5002
+ * Scheduled through an interval and launched from background
5003
+ */
5004
+ Background = "background"
5005
+ }
4543
5006
 
4544
5007
  /**
4545
5008
  * See {@link Detail.Metadata.Link}
@@ -4786,11 +5249,10 @@ declare interface ListMembers {
4786
5249
  * import { List } from "@raycast/api";
4787
5250
  *
4788
5251
  * function DrinkDropdown(props: DrinkDropdownProps) {
4789
- * const { isLoading = false, drinkTypes, onDrinkTypeChange } = props;
5252
+ * const { drinkTypes, onDrinkTypeChange } = props;
4790
5253
  * return (
4791
5254
  * <List.Dropdown
4792
5255
  * tooltip="Select Drink Type"
4793
- * disabled={isLoading}
4794
5256
  * storeValue={true}
4795
5257
  * onChange={(newValue) => {
4796
5258
  * onDrinkTypeChange(newValue);
@@ -5034,6 +5496,42 @@ export declare type LocalStorageValue = LocalStorage.Value;
5034
5496
  export declare interface LocalStorageValues extends LocalStorage.Values {
5035
5497
  }
5036
5498
 
5499
+ export declare const MenuBarExtra: FunctionComponent<MenuBarExtraProps> & MenuBarExtraMembers;
5500
+
5501
+ export declare namespace MenuBarExtra {
5502
+ export type Props = MenuBarExtraProps;
5503
+ }
5504
+
5505
+ declare interface MenuBarExtraMembers {
5506
+ Item: typeof Item_3;
5507
+ Separator: typeof Separator_4;
5508
+ Submenu: typeof Submenu_2;
5509
+ }
5510
+
5511
+ declare interface MenuBarExtraProps {
5512
+ /**
5513
+ * Indicates to Raycast that it should not unload the command, as it is still executing. If you set make use of `isLoading`, you need to make sure you set it to `false` at the end of the task you are executing (such as an API call), so Raycast can then unload the command.
5514
+ * @defaultValue `false`
5515
+ */
5516
+ isLoading?: boolean;
5517
+ /**
5518
+ * The string that is displayed in the menu bar.
5519
+ */
5520
+ title?: string;
5521
+ /**
5522
+ * A tooltip to display when the cursor hovers the item in the menu bar.
5523
+ */
5524
+ tooltip?: string;
5525
+ /**
5526
+ * The icon that is displayed in the menu bar.
5527
+ */
5528
+ icon?: Image.ImageLike;
5529
+ /**
5530
+ * `MenuBarExtra.Item`s, `MenuBarExtra.Submenu`s, `MenuBarExtra.Separator` or a mix of either.
5531
+ */
5532
+ children?: ReactNode;
5533
+ }
5534
+
5037
5535
  /**
5038
5536
  * See {@link Detail.Metadata}
5039
5537
  */
@@ -5996,6 +6494,11 @@ declare const Separator_2: FunctionComponent<SeparatorProps_2>;
5996
6494
  */
5997
6495
  declare const Separator_3: FunctionComponent<SeparatorProps_3>;
5998
6496
 
6497
+ /**
6498
+ * See {@link MenuBarExtra.Separator}
6499
+ */
6500
+ declare const Separator_4: FunctionComponent<SeparatorProps_4>;
6501
+
5999
6502
  /**
6000
6503
  * See {@link Form.Separator.Props}
6001
6504
  */
@@ -6008,6 +6511,9 @@ declare interface SeparatorProps_2 {
6008
6511
  declare interface SeparatorProps_3 {
6009
6512
  }
6010
6513
 
6514
+ declare interface SeparatorProps_4 {
6515
+ }
6516
+
6011
6517
  /**
6012
6518
  * @deprecated Use {@link LocalStorage.setItem} instead
6013
6519
  */
@@ -6169,6 +6675,11 @@ export declare const specialKeys: any;
6169
6675
  */
6170
6676
  declare const Submenu: FunctionComponent<SubmenuProps>;
6171
6677
 
6678
+ /**
6679
+ * See {@link MenuBarExtra.Submenu}
6680
+ */
6681
+ declare const Submenu_2: FunctionComponent<SubmenuProps_2>;
6682
+
6172
6683
  declare type SubmenuChildren = ReactElement<SectionProps> | ReactElement<SectionProps>[] | SectionChildren | null;
6173
6684
 
6174
6685
  /**
@@ -6226,6 +6737,21 @@ declare interface SubmenuProps {
6226
6737
  onOpen?: () => void;
6227
6738
  }
6228
6739
 
6740
+ declare interface SubmenuProps_2 {
6741
+ /**
6742
+ * The main title displayed for this submenu.
6743
+ */
6744
+ title: string;
6745
+ /**
6746
+ * An optional icon for this submenu.
6747
+ */
6748
+ icon?: Image.ImageLike;
6749
+ /**
6750
+ * `MenuBarExtra.Item`s, `MenuBarExtra.Submenu`s, `MenuBarExtra.Separator` or a mix of either.
6751
+ */
6752
+ children?: ReactNode;
6753
+ }
6754
+
6229
6755
  /**
6230
6756
  * See {@link Action.SubmitForm.Props}
6231
6757
  */
@@ -6604,7 +7130,7 @@ export declare const ToastStyle: typeof Toast.Style;
6604
7130
  declare const ToggleQuickLook: FunctionComponent<ToggleQuickLookProps>;
6605
7131
 
6606
7132
  /**
6607
- * See {@link Action.Open.Props}
7133
+ * See {@link Action.ToggleQuickLook.Props}
6608
7134
  */
6609
7135
  declare interface ToggleQuickLookProps {
6610
7136
  /**
@@ -6695,6 +7221,28 @@ declare interface TrashProps {
6695
7221
  onTrash?: (paths: PathLike | PathLike[]) => void;
6696
7222
  }
6697
7223
 
7224
+ /**
7225
+ * Update the values of properties declared in the manifest of a command.
7226
+ *
7227
+ * @param metadata - An object with the values for the manifest properties to update.
7228
+ * Note that currently only `subtitle` is supported. Pass `null` to clear the custom subtitle.
7229
+ * @returns A Promise that resolves when the metadata has been updated.
7230
+ *
7231
+ * @example
7232
+ * ```typescript
7233
+ * import { open } from "@raycast/api";
7234
+ *
7235
+ * export default async () => {
7236
+ * await updateCommandMetadata({ subtitle: "My new subtitle" });
7237
+ * };
7238
+ * ```
7239
+ * @remarks The actual manifest file is not modified, so the update applies as
7240
+ * long as the command remains installed.
7241
+ */
7242
+ export declare function updateCommandMetadata(metadata: {
7243
+ subtitle?: string | null;
7244
+ }): Promise<void>;
7245
+
6698
7246
  /**
6699
7247
  * @deprecated No alternative :(
6700
7248
  */