@rbxts/types 1.0.918 → 1.0.919

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.
@@ -131,6 +131,7 @@ interface Services {
131
131
  ModerationService: ModerationService;
132
132
  OmniRecommendationsService: OmniRecommendationsService;
133
133
  OpenCloudService: OpenCloudService;
134
+ Packages: Packages;
134
135
  PackageUIService: PackageUIService;
135
136
  PartyEmulatorService: PartyEmulatorService;
136
137
  PatchBundlerFileWatch: PatchBundlerFileWatch;
@@ -2251,7 +2252,7 @@ interface Instance extends RBXObject {
2251
2252
  */
2252
2253
  Parent: Instance | undefined;
2253
2254
  /**
2254
- * Turns the instance to be a sandboxed container.
2255
+ * When enabled, the instance can only access abilities in its `Capabilities` list.
2255
2256
  *
2256
2257
  * - **ThreadSafety**: ReadSafe
2257
2258
  * - **Tags**: NotReplicated
@@ -2578,7 +2579,7 @@ interface Instance extends RBXObject {
2578
2579
  WaitForChild(this: Instance, childName: string | number): Instance;
2579
2580
  WaitForChild(this: Instance, childName: string | number, timeOut: number): Instance | undefined;
2580
2581
  /**
2581
- * Fires when the `Instance.Parent` property of the object or one of its ancestors is changed.
2582
+ * Fires when the `Instance.Parent` property of this object or one of its ancestors is changed.
2582
2583
  *
2583
2584
  * - **ThreadSafety**: Unsafe
2584
2585
  *
@@ -28246,6 +28247,18 @@ interface MLService extends Instance {
28246
28247
  * @deprecated
28247
28248
  */
28248
28249
  readonly _nominal_MLService: unique symbol;
28250
+ /**
28251
+ * - **ThreadSafety**: Unsafe
28252
+ *
28253
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/MLService#IsPostProcessReady)
28254
+ */
28255
+ IsPostProcessReady(this: MLService): boolean;
28256
+ /**
28257
+ * - **ThreadSafety**: Unsafe
28258
+ *
28259
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/MLService#SetPostProcessEnabled)
28260
+ */
28261
+ SetPostProcessEnabled(this: MLService, enabled: boolean): void;
28249
28262
  /**
28250
28263
  * - **ThreadSafety**: Unsafe
28251
28264
  * - **Tags**: Yields
@@ -28255,6 +28268,13 @@ interface MLService extends Instance {
28255
28268
  * @param assetId
28256
28269
  */
28257
28270
  CreateSessionAsync(this: MLService, assetId: string): MLSession;
28271
+ /**
28272
+ * - **ThreadSafety**: Unsafe
28273
+ * - **Tags**: Yields
28274
+ *
28275
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/MLService#LoadPostProcessModelAsync)
28276
+ */
28277
+ LoadPostProcessModelAsync(this: MLService, assetId: number): void;
28258
28278
  }
28259
28279
  /**
28260
28280
  * Describes the appearance of a makeup item for the `HumanoidDescription`.
@@ -28461,6 +28481,8 @@ interface MarketplaceService extends Instance {
28461
28481
  */
28462
28482
  PromptGamePassPurchase(this: MarketplaceService, player: Player, gamePassId: number): void;
28463
28483
  /**
28484
+ * **Deprecated:** This method has been superseded by `PromptRobloxSubscriptionPurchase()`.
28485
+ *
28464
28486
  * Prompts a user to purchase Roblox Premium.
28465
28487
  *
28466
28488
  * - **ThreadSafety**: Unsafe
@@ -33582,6 +33604,8 @@ interface Workspace extends WorldRoot {
33582
33604
  */
33583
33605
  DistributedGameTime: number;
33584
33606
  /**
33607
+ * Controls whether parts that fall below `Workspace.FallenPartsDestroyHeight` are automatically destroyed.
33608
+ *
33585
33609
  * - **ThreadSafety**: ReadSafe
33586
33610
  *
33587
33611
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/Workspace#FallHeightEnabled)
@@ -33612,6 +33636,8 @@ interface Workspace extends WorldRoot {
33612
33636
  */
33613
33637
  Gravity: number;
33614
33638
  /**
33639
+ * The world position at which new objects are placed when inserted from the toolbox.
33640
+ *
33615
33641
  * - **ThreadSafety**: ReadSafe
33616
33642
  * - **Tags**: NotReplicated
33617
33643
  *
@@ -33630,6 +33656,8 @@ interface Workspace extends WorldRoot {
33630
33656
  */
33631
33657
  get InterpolationThrottling(): Enum.InterpolationThrottlingMode;
33632
33658
  /**
33659
+ * Controls whether animation retargeting is enabled for character animations.
33660
+ *
33633
33661
  * - **ThreadSafety**: ReadSafe
33634
33662
  *
33635
33663
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/Workspace#Retargeting)
@@ -33803,6 +33831,21 @@ interface PackageUIService extends Instance {
33803
33831
  */
33804
33832
  readonly _nominal_PackageUIService: unique symbol;
33805
33833
  }
33834
+ /**
33835
+ * - **Tags**: NotCreatable, Service
33836
+ *
33837
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/Packages)
33838
+ */
33839
+ interface Packages extends Instance {
33840
+ /**
33841
+ * **DO NOT USE!**
33842
+ *
33843
+ * This field exists to force TypeScript to recognize this as a nominal type
33844
+ * @hidden
33845
+ * @deprecated
33846
+ */
33847
+ readonly _nominal_Packages: unique symbol;
33848
+ }
33806
33849
  /**
33807
33850
  * An abstract class for pages objects.
33808
33851
  *
@@ -35724,6 +35767,8 @@ interface Player extends Instance {
35724
35767
  * - **Tags**: Yields
35725
35768
  *
35726
35769
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/Player#GetFriendsWhoPlayedAsync)
35770
+ * @param this An object that represents a presently connected client to the experience.
35771
+ * @returns An array of user IDs.
35727
35772
  */
35728
35773
  GetFriendsWhoPlayedAsync(this: Player): Array<unknown>;
35729
35774
  /**
@@ -37778,6 +37823,12 @@ interface RecommendationService extends Instance {
37778
37823
  * - `DepartureIntent` — The `RecommendationDepartureIntent` indicating the user's intent when leaving a view. For example, `Positive` if the view is considered good.
37779
37824
  */
37780
37825
  LogImpressionEvent(this: RecommendationService, impressionType: CastsToEnum<Enum.RecommendationImpressionType>, itemId: string, tracingId: string, impressionEventDetails?: object): void;
37826
+ /**
37827
+ * - **ThreadSafety**: Unsafe
37828
+ *
37829
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/RecommendationService#LogPreferenceEvent)
37830
+ */
37831
+ LogPreferenceEvent(this: RecommendationService, preferenceType: CastsToEnum<Enum.RecommendationPreferenceType>, targetType: CastsToEnum<Enum.RecommendationPreferenceTargetType>, targetId: string, tracingId?: string, itemId?: string): void;
37781
37832
  /**
37782
37833
  * - **ThreadSafety**: Unsafe
37783
37834
  * - **Tags**: Yields
@@ -38404,6 +38455,7 @@ interface RunService extends Instance {
38404
38455
  * @param this Service responsible for all runtime activity and progression of time.
38405
38456
  * @param function The function to call. This function will be passed one parameter called `deltaTime` which shows how much time passed between the beginning of the previous simulation step and the beginning of the current simulation step.
38406
38457
  * @param frequency Optional `StepFrequency` value indicating the frequency at which to call the bound function. If not provided, the default frequency will be used.
38458
+ * @param priority Optional priority of the binding as an integer; it determines the order in which bound functions are called within a simulation step. Lower numbers are called first. If two bindings have the same priority, the order between them is unspecified. Defaults to 2000.
38407
38459
  */
38408
38460
  BindToSimulation(this: RunService, callback: Callback, frequency?: CastsToEnum<Enum.StepFrequency>, priority?: number): RBXScriptConnection;
38409
38461
  /**
@@ -39666,6 +39718,12 @@ interface DataModel extends ServiceProvider<Services> {
39666
39718
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/DataModel#Loaded)
39667
39719
  */
39668
39720
  readonly Loaded: RBXScriptSignal<() => void>;
39721
+ /**
39722
+ * - **ThreadSafety**: Unsafe
39723
+ *
39724
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/DataModel#ServerLifecycleChanged)
39725
+ */
39726
+ readonly ServerLifecycleChanged: RBXScriptSignal<(serverLifecycleChangedEvent: object) => void>;
39669
39727
  /**
39670
39728
  * **Deprecated:** This function is deprecated. It is recommended to use `DataModel:BindToClose()` instead.
39671
39729
  *
@@ -42130,6 +42188,8 @@ interface StudioDeviceEmulatorService extends Instance {
42130
42188
  readonly _nominal_StudioDeviceEmulatorService: unique symbol;
42131
42189
  }
42132
42190
  /**
42191
+ * Service allowing you to control Studio's Device Simulator.
42192
+ *
42133
42193
  * - **Tags**: NotCreatable, Service, NotReplicated
42134
42194
  *
42135
42195
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/StudioDeviceSimulatorService)
@@ -42254,12 +42314,15 @@ interface StudioTestService extends Instance {
42254
42314
  * - **ThreadSafety**: Unsafe
42255
42315
  *
42256
42316
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/StudioTestService#AddPlayers)
42317
+ * @param this Service allowing plugins to automate and customize Test and Run mode testing.
42318
+ * @param numPlayers
42257
42319
  */
42258
42320
  AddPlayers(this: StudioTestService, numPlayers: number): void;
42259
42321
  /**
42260
42322
  * - **ThreadSafety**: Unsafe
42261
42323
  *
42262
42324
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/StudioTestService#CanLeaveTest)
42325
+ * @param this Service allowing plugins to automate and customize Test and Run mode testing.
42263
42326
  */
42264
42327
  CanLeaveTest(this: StudioTestService): boolean;
42265
42328
  /**
@@ -42282,6 +42345,7 @@ interface StudioTestService extends Instance {
42282
42345
  * - **ThreadSafety**: Unsafe
42283
42346
  *
42284
42347
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/StudioTestService#LeaveTest)
42348
+ * @param this Service allowing plugins to automate and customize Test and Run mode testing.
42285
42349
  */
42286
42350
  LeaveTest(this: StudioTestService): void;
42287
42351
  }
@@ -42411,9 +42475,13 @@ interface StyleRule extends StyleBase {
42411
42475
  */
42412
42476
  readonly SelectorError: string;
42413
42477
  /**
42478
+ * Returns the default transition applied to all properties of the `StyleRule` that don't have an explicit transition set.
42479
+ *
42414
42480
  * - **ThreadSafety**: Unsafe
42415
42481
  *
42416
42482
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/StyleRule#GetDefaultPropertyTransition)
42483
+ * @param this Defines style properties which override properties on the instances affected by the `Selector` property.
42484
+ * @returns The default transition as a `TweenInfo` or string token, or `nil` if no default transition is set.
42417
42485
  */
42418
42486
  GetDefaultPropertyTransition(this: StyleRule): unknown;
42419
42487
  /**
@@ -42438,16 +42506,23 @@ interface StyleRule extends StyleBase {
42438
42506
  */
42439
42507
  GetProperty(this: StyleRule, name: string): unknown;
42440
42508
  /**
42509
+ * Returns a dictionary of all property transitions set on the `StyleRule`.
42510
+ *
42441
42511
  * - **ThreadSafety**: Unsafe
42442
42512
  *
42443
42513
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/StyleRule#GetPropertyTransitions)
42444
42514
  * @param this Defines style properties which override properties on the instances affected by the `Selector` property.
42515
+ * @returns Dictionary of key-value pairs mapping property names to their transition parameters.
42445
42516
  */
42446
42517
  GetPropertyTransitions(this: StyleRule): object;
42447
42518
  /**
42519
+ * Sets or clears a default transition that applies to all properties of the `StyleRule` that don't have an explicit transition set.
42520
+ *
42448
42521
  * - **ThreadSafety**: Unsafe
42449
42522
  *
42450
42523
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/StyleRule#SetDefaultPropertyTransition)
42524
+ * @param this Defines style properties which override properties on the instances affected by the `Selector` property.
42525
+ * @param transitionParams Either a `TweenInfo`, a token string defining the default transition timing, or `nil` to remove the default transition.
42451
42526
  */
42452
42527
  SetDefaultPropertyTransition(this: StyleRule, transitionParams: unknown): void;
42453
42528
  /**
@@ -42470,17 +42545,24 @@ interface StyleRule extends StyleBase {
42470
42545
  */
42471
42546
  SetProperty(this: StyleRule, name: string, value: unknown): void;
42472
42547
  /**
42548
+ * Sets or clears the transition for a single property on the `StyleRule`.
42549
+ *
42473
42550
  * - **ThreadSafety**: Unsafe
42474
42551
  *
42475
42552
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/StyleRule#SetPropertyTransition)
42553
+ * @param this Defines style properties which override properties on the instances affected by the `Selector` property.
42554
+ * @param property String name of the property to set a transition for, for example `"BackgroundColor3"` or `"Size"`.
42555
+ * @param transitionParams A `TweenInfo` or token string defining the transition timing, or `nil` to remove the transition for this property.
42476
42556
  */
42477
42557
  SetPropertyTransition(this: StyleRule, property: string, transitionParams: unknown): void;
42478
42558
  /**
42559
+ * Lets you declare and set transitions for multiple properties of the `StyleRule` at once.
42560
+ *
42479
42561
  * - **ThreadSafety**: Unsafe
42480
42562
  *
42481
42563
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/StyleRule#SetPropertyTransitions)
42482
42564
  * @param this Defines style properties which override properties on the instances affected by the `Selector` property.
42483
- * @param properties
42565
+ * @param properties Dictionary of property names to transition parameters.
42484
42566
  */
42485
42567
  SetPropertyTransitions(this: StyleRule, properties: object): void;
42486
42568
  }
@@ -45943,7 +46025,7 @@ interface UICorner extends UIComponent {
45943
46025
  */
45944
46026
  set BottomRightRadius(value: UDim);
45945
46027
  /**
45946
- * Determines the radius of the component.
46028
+ * Sets all four corner radii at once and reads from `TopLeftRadius`.
45947
46029
  *
45948
46030
  * - **ThreadSafety**: ReadSafe
45949
46031
  *
@@ -47402,6 +47484,16 @@ interface UserInputService extends Instance {
47402
47484
  * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/UserInputService#VREnabled)
47403
47485
  */
47404
47486
  readonly VREnabled: boolean;
47487
+ /**
47488
+ * Creates a `VirtualInput` object that a Studio plugin can use to simulate mouse, keyboard, and pointer input.
47489
+ *
47490
+ * - **ThreadSafety**: Unsafe
47491
+ *
47492
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/UserInputService#CreateVirtualInput)
47493
+ * @param this `UserInputService` is primarily used to detect the input types available on a user's device, as well as detect input events.
47494
+ * @returns A new `VirtualInput` object, or `nil` if the feature is not available.
47495
+ */
47496
+ CreateVirtualInput(this: UserInputService): RBXObject;
47405
47497
  /**
47406
47498
  * Returns whether the given `UserInputType` gamepad supports a button corresponding with the given `KeyCode`.
47407
47499
  *
@@ -49780,6 +49872,72 @@ interface VirtualInput extends RBXObject {
49780
49872
  * @deprecated
49781
49873
  */
49782
49874
  readonly _nominal_VirtualInput: unique symbol;
49875
+ /**
49876
+ * Injects a keyboard key press or release event.
49877
+ *
49878
+ * - **ThreadSafety**: Unsafe
49879
+ *
49880
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/VirtualInput#SendKey)
49881
+ * @param this Allows Studio plugins to simulate mouse, keyboard, and pointer input as if it were performed by a real player.
49882
+ * @param isPressed Whether to simulate a key press (`true`) or a key release (`false`).
49883
+ * @param keyCode The `KeyCode` of the key to inject.
49884
+ * @param isRepeatedKey Whether this is an auto-repeat event, as occurs when a key is held down. Only valid for text-manipulation keys such as `KeyCode.Backspace`, `KeyCode.Delete`, and the arrow keys. Defaults to `false`.
49885
+ */
49886
+ SendKey(this: VirtualInput, isPressed: boolean, keyCode: CastsToEnum<Enum.KeyCode>, isRepeatedKey?: boolean): void;
49887
+ /**
49888
+ * Injects a mouse button press or release event at the specified screen position.
49889
+ *
49890
+ * - **ThreadSafety**: Unsafe
49891
+ *
49892
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/VirtualInput#SendMouseButton)
49893
+ * @param this Allows Studio plugins to simulate mouse, keyboard, and pointer input as if it were performed by a real player.
49894
+ * @param position The screen-space position in pixels at which to inject the event.
49895
+ * @param button The mouse button to use. Supported values are `UserInputType.MouseButton1`, `UserInputType.MouseButton2`, and `UserInputType.MouseButton3`.
49896
+ * @param isDown Whether to simulate a button press (`true`) or a button release (`false`).
49897
+ * @param repeatCount The consecutive-click count for multi-click detection, such as a double- or triple-click. Defaults to `0`.
49898
+ */
49899
+ SendMouseButton(this: VirtualInput, position: Vector2, button: CastsToEnum<Enum.UserInputType>, isDown: boolean, repeatCount?: number): void;
49900
+ /**
49901
+ * Injects a relative mouse movement event. Only works while the player's cursor is locked.
49902
+ *
49903
+ * - **ThreadSafety**: Unsafe
49904
+ *
49905
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/VirtualInput#SendMouseDelta)
49906
+ * @param this Allows Studio plugins to simulate mouse, keyboard, and pointer input as if it were performed by a real player.
49907
+ * @param positionDelta The relative mouse movement in pixels along each axis.
49908
+ */
49909
+ SendMouseDelta(this: VirtualInput, positionDelta: Vector2): void;
49910
+ /**
49911
+ * Moves the virtual mouse cursor to the specified absolute screen position.
49912
+ *
49913
+ * - **ThreadSafety**: Unsafe
49914
+ *
49915
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/VirtualInput#SendMousePosition)
49916
+ * @param this Allows Studio plugins to simulate mouse, keyboard, and pointer input as if it were performed by a real player.
49917
+ * @param position The target screen-space position in pixels.
49918
+ */
49919
+ SendMousePosition(this: VirtualInput, position: Vector2): void;
49920
+ /**
49921
+ * Injects a scroll wheel, trackpad pan, or pinch gesture event at the specified screen position.
49922
+ *
49923
+ * - **ThreadSafety**: Unsafe
49924
+ *
49925
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/VirtualInput#SendPointerAction)
49926
+ * @param this Allows Studio plugins to simulate mouse, keyboard, and pointer input as if it were performed by a real player.
49927
+ * @param position The screen-space position in pixels at which to inject the event.
49928
+ * @param pointerAction A dictionary describing the pointer action to inject. Accepted keys are `Wheel` (number), `Pan` (`Vector2`), and `Pinch` (number). At least one key must have a non-zero value.
49929
+ */
49930
+ SendPointerAction(this: VirtualInput, position: Vector2, pointerAction: object): void;
49931
+ /**
49932
+ * Injects a text input event as if the specified string was typed on a keyboard.
49933
+ *
49934
+ * - **ThreadSafety**: Unsafe
49935
+ *
49936
+ * [Creator Hub](https://create.roblox.com/docs/reference/engine/classes/VirtualInput#SendTextInput)
49937
+ * @param this Allows Studio plugins to simulate mouse, keyboard, and pointer input as if it were performed by a real player.
49938
+ * @param text The string to inject as text input.
49939
+ */
49940
+ SendTextInput(this: VirtualInput, text: string): void;
49783
49941
  }
49784
49942
  /**
49785
49943
  * - **Tags**: NotCreatable, NotReplicated