@rbxts/types 1.0.937 → 1.0.939

package/include/generated/enums.d.ts

@@ -26844,6 +26844,42 @@ declare namespace Enum {
         export function FromValue(this: globalThis.Enum, value: number): globalThis.Enum.PredictionStatus | undefined;
     }
     export type PredictionStatus = PredictionStatus.Authoritative | PredictionStatus.Predicted | PredictionStatus.None;
+    /**
+     * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PredictiveStreamingMode)
+     */
+    export namespace PredictiveStreamingMode {
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PredictiveStreamingMode#Default)
+         */
+        export interface Default extends globalThis.EnumItem {
+            Name: "Default";
+            Value: 0;
+            EnumType: typeof globalThis.Enum.PredictiveStreamingMode;
+        }
+        export const Default: Default;
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PredictiveStreamingMode#Enabled)
+         */
+        export interface Enabled extends globalThis.EnumItem {
+            Name: "Enabled";
+            Value: 1;
+            EnumType: typeof globalThis.Enum.PredictiveStreamingMode;
+        }
+        export const Enabled: Enabled;
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PredictiveStreamingMode#Disabled)
+         */
+        export interface Disabled extends globalThis.EnumItem {
+            Name: "Disabled";
+            Value: 2;
+            EnumType: typeof globalThis.Enum.PredictiveStreamingMode;
+        }
+        export const Disabled: Disabled;
+        export function GetEnumItems(this: globalThis.Enum): Array<globalThis.Enum.PredictiveStreamingMode>;
+        export function FromName(this: globalThis.Enum, name: string): globalThis.Enum.PredictiveStreamingMode | undefined;
+        export function FromValue(this: globalThis.Enum, value: number): globalThis.Enum.PredictiveStreamingMode | undefined;
+    }
+    export type PredictiveStreamingMode = PredictiveStreamingMode.Default | PredictiveStreamingMode.Enabled | PredictiveStreamingMode.Disabled;
     /**
      * This enum is used with `UserInputService.PreferredInput` to indicate the primary input type a player is likely using.
      *
@@ -27499,6 +27535,78 @@ declare namespace Enum {
         export function FromValue(this: globalThis.Enum, value: number): globalThis.Enum.PromptCreateAvatarResult | undefined;
     }
     export type PromptCreateAvatarResult = PromptCreateAvatarResult.Success | PromptCreateAvatarResult.PermissionDenied | PromptCreateAvatarResult.Timeout | PromptCreateAvatarResult.UploadFailed | PromptCreateAvatarResult.NoUserInput | PromptCreateAvatarResult.InvalidHumanoidDescription | PromptCreateAvatarResult.UGCValidationFailed | PromptCreateAvatarResult.ModeratedName | PromptCreateAvatarResult.MaxOutfits | PromptCreateAvatarResult.PurchaseFailure | PromptCreateAvatarResult.UnknownFailure | PromptCreateAvatarResult.TokenInvalid;
+    /**
+     * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PromptCreateOutfitResult)
+     */
+    export namespace PromptCreateOutfitResult {
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PromptCreateOutfitResult#Success)
+         */
+        export interface Success extends globalThis.EnumItem {
+            Name: "Success";
+            Value: 1;
+            EnumType: typeof globalThis.Enum.PromptCreateOutfitResult;
+        }
+        export const Success: Success;
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PromptCreateOutfitResult#PartialSuccess)
+         */
+        export interface PartialSuccess extends globalThis.EnumItem {
+            Name: "PartialSuccess";
+            Value: 2;
+            EnumType: typeof globalThis.Enum.PromptCreateOutfitResult;
+        }
+        export const PartialSuccess: PartialSuccess;
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PromptCreateOutfitResult#CreationFailure)
+         */
+        export interface CreationFailure extends globalThis.EnumItem {
+            Name: "CreationFailure";
+            Value: 3;
+            EnumType: typeof globalThis.Enum.PromptCreateOutfitResult;
+        }
+        export const CreationFailure: CreationFailure;
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PromptCreateOutfitResult#PermissionDenied)
+         */
+        export interface PermissionDenied extends globalThis.EnumItem {
+            Name: "PermissionDenied";
+            Value: 4;
+            EnumType: typeof globalThis.Enum.PromptCreateOutfitResult;
+        }
+        export const PermissionDenied: PermissionDenied;
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PromptCreateOutfitResult#Timeout)
+         */
+        export interface Timeout extends globalThis.EnumItem {
+            Name: "Timeout";
+            Value: 5;
+            EnumType: typeof globalThis.Enum.PromptCreateOutfitResult;
+        }
+        export const Timeout: Timeout;
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PromptCreateOutfitResult#NoUserInput)
+         */
+        export interface NoUserInput extends globalThis.EnumItem {
+            Name: "NoUserInput";
+            Value: 6;
+            EnumType: typeof globalThis.Enum.PromptCreateOutfitResult;
+        }
+        export const NoUserInput: NoUserInput;
+        /**
+         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PromptCreateOutfitResult#UnknownFailure)
+         */
+        export interface UnknownFailure extends globalThis.EnumItem {
+            Name: "UnknownFailure";
+            Value: 7;
+            EnumType: typeof globalThis.Enum.PromptCreateOutfitResult;
+        }
+        export const UnknownFailure: UnknownFailure;
+        export function GetEnumItems(this: globalThis.Enum): Array<globalThis.Enum.PromptCreateOutfitResult>;
+        export function FromName(this: globalThis.Enum, name: string): globalThis.Enum.PromptCreateOutfitResult | undefined;
+        export function FromValue(this: globalThis.Enum, value: number): globalThis.Enum.PromptCreateOutfitResult | undefined;
+    }
+    export type PromptCreateOutfitResult = PromptCreateOutfitResult.Success | PromptCreateOutfitResult.PartialSuccess | PromptCreateOutfitResult.CreationFailure | PromptCreateOutfitResult.PermissionDenied | PromptCreateOutfitResult.Timeout | PromptCreateOutfitResult.NoUserInput | PromptCreateOutfitResult.UnknownFailure;
     /**
      * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PromptExperienceDetailsResult)
      */
@@ -27771,10 +27879,14 @@ declare namespace Enum {
     }
     export type ProximityPromptStyle = ProximityPromptStyle.Default | ProximityPromptStyle.Custom;
     /**
+     * Specifies the type of purchase option in a bulk purchase prompt.
+     *
      * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PurchaseOption)
      */
     export namespace PurchaseOption {
         /**
+         * A timed ownership option. The `Value` field specifies the duration in seconds.
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PurchaseOption#TimedOption)
          */
         export interface TimedOption extends globalThis.EnumItem {
@@ -27784,6 +27896,8 @@ declare namespace Enum {
         }
         export const TimedOption: TimedOption;
         /**
+         * A permanent ownership purchase option.
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/PurchaseOption#Permanent)
          */
         export interface Permanent extends globalThis.EnumItem {
@@ -30338,10 +30452,14 @@ declare namespace Enum {
     }
     export type SafeAreaCompatibility = SafeAreaCompatibility.None | SafeAreaCompatibility.FullscreenExtension;
     /**
+     * Filters catalog search results by sales type.
+     *
      * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/SalesTypeFilter)
      */
     export namespace SalesTypeFilter {
         /**
+         * Returns all items regardless of sales type.
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/SalesTypeFilter#All)
          */
         export interface All extends globalThis.EnumItem {
@@ -30351,6 +30469,8 @@ declare namespace Enum {
         }
         export const All: All;
         /**
+         * Returns only collectible items (Limited and Limited Unique).
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/SalesTypeFilter#Collectibles)
          */
         export interface Collectibles extends globalThis.EnumItem {
@@ -30360,6 +30480,8 @@ declare namespace Enum {
         }
         export const Collectibles: Collectibles;
         /**
+         * Returns only items with Premium pricing.
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/SalesTypeFilter#Premium)
          */
         export interface Premium extends globalThis.EnumItem {
@@ -30369,6 +30491,8 @@ declare namespace Enum {
         }
         export const Premium: Premium;
         /**
+         * Returns only items that have timed options available.
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/SalesTypeFilter#TimedOptions)
          */
         export interface TimedOptions extends globalThis.EnumItem {
@@ -30901,10 +31025,14 @@ declare namespace Enum {
     }
     export type ScreenOrientation = ScreenOrientation.LandscapeLeft | ScreenOrientation.LandscapeRight | ScreenOrientation.LandscapeSensor | ScreenOrientation.Portrait | ScreenOrientation.Sensor;
     /**
+     * Describes the result of a screenshot capture initiated by `CaptureService:TakeScreenshotCaptureAsync()`.
+     *
      * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/ScreenshotCaptureResult)
      */
     export namespace ScreenshotCaptureResult {
         /**
+         * The screenshot capture completed successfully.
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/ScreenshotCaptureResult#Success)
          */
         export interface Success extends globalThis.EnumItem {
@@ -30914,6 +31042,8 @@ declare namespace Enum {
         }
         export const Success: Success;
         /**
+         * The screenshot capture failed due to an unspecified error.
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/ScreenshotCaptureResult#OtherError)
          */
         export interface OtherError extends globalThis.EnumItem {
@@ -30923,6 +31053,8 @@ declare namespace Enum {
         }
         export const OtherError: OtherError;
         /**
+         * The device does not support screenshot captures.
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/ScreenshotCaptureResult#NoDeviceSupport)
          */
         export interface NoDeviceSupport extends globalThis.EnumItem {
@@ -30932,6 +31064,8 @@ declare namespace Enum {
         }
         export const NoDeviceSupport: NoDeviceSupport;
         /**
+         * The device does not have enough storage space to save the screenshot capture.
+         *
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/ScreenshotCaptureResult#NoSpaceOnDevice)
          */
         export interface NoSpaceOnDevice extends globalThis.EnumItem {
@@ -32196,24 +32330,6 @@ declare namespace Enum {
             EnumType: typeof globalThis.Enum.SlimTintMode;
         }
         export const Meshes: Meshes;
-        /**
-         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/SlimTintMode#MeshResourcePtr)
-         */
-        export interface MeshResourcePtr extends globalThis.EnumItem {
-            Name: "MeshResourcePtr";
-            Value: 3;
-            EnumType: typeof globalThis.Enum.SlimTintMode;
-        }
-        export const MeshResourcePtr: MeshResourcePtr;
-        /**
-         * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/SlimTintMode#ContentId)
-         */
-        export interface ContentId extends globalThis.EnumItem {
-            Name: "ContentId";
-            Value: 4;
-            EnumType: typeof globalThis.Enum.SlimTintMode;
-        }
-        export const ContentId: ContentId;
         /**
          * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/SlimTintMode#Zone)
          */
@@ -32227,7 +32343,7 @@ declare namespace Enum {
         export function FromName(this: globalThis.Enum, name: string): globalThis.Enum.SlimTintMode | undefined;
         export function FromValue(this: globalThis.Enum, value: number): globalThis.Enum.SlimTintMode | undefined;
     }
-    export type SlimTintMode = SlimTintMode.None | SlimTintMode.LOD | SlimTintMode.Meshes | SlimTintMode.MeshResourcePtr | SlimTintMode.ContentId | SlimTintMode.Zone;
+    export type SlimTintMode = SlimTintMode.None | SlimTintMode.LOD | SlimTintMode.Meshes | SlimTintMode.Zone;
     /**
      * [Creator Hub](https://create.roblox.com/docs/reference/engine/enums/SolidPrimitiveType)
      */

package/include/roblox.d.ts

@@ -1,6 +1,7 @@
 /// <reference no-default-lib="true"/>
 /// <reference path="lua.d.ts" />
 /// <reference path="macro_math.d.ts" />
+/// <reference path="selector.d.ts" />
 /// <reference path="generated/enums.d.ts" />
 /// <reference path="generated/None.d.ts" />
 /// <reference types="@rbxts/compiler-types" />

package/include/selector.d.ts

@@ -0,0 +1,152 @@
+/// <reference no-default-lib="true"/>
+
+/**
+ * Resolves the selector strings accepted by `Instance:QueryDescendants()` to the type of the
+ * instances they match, so string-literal selectors get a precise return type. The grammar is
+ * documented at https://create.roblox.com/docs/reference/engine/classes/Instance#QueryDescendants
+ *
+ * Only the class named in the last combinator segment affects the result, unioned across
+ * comma-separated selectors. `.Tag` and `#Name` carry no class information and resolve to
+ * `Instance`; attribute filters and pseudo-classes never change the class. Note that
+ * whitespace is not a combinator in this grammar (descendant matching is `>>`), so spaces
+ * are ignored rather than treated as separators.
+ */
+declare namespace Selector {
+	type Trim<T extends string> = T extends `${infer S} ` ? Trim<S> : T extends ` ${infer S}` ? Trim<S> : T;
+
+	type SolveHead<Head extends string | undefined> = Head extends string
+		? Trim<Head> extends infer C extends keyof Instances
+			? Instances[C]
+			: Instance
+		: Instance;
+
+	type AddSolvedHead<Result, Head extends string | undefined> = [Result] extends [never]
+		? SolveHead<Head>
+		: Result | SolveHead<Head>;
+
+	type HeadBreak = ":" | "." | "#" | "[" | " ";
+
+	type ReadHead<
+		Head extends string | undefined = undefined,
+		Done extends boolean = false,
+		C extends string = "",
+	> = Done extends true
+		? [Head, Done]
+		: Head extends undefined
+			? Trim<C> extends ""
+				? [undefined, false]
+				: C extends HeadBreak
+					? ["", true]
+					: [C, false]
+			: C extends HeadBreak
+				? [Head, true]
+				: [`${Head}${C}`, false];
+
+	type SolveChars<
+		S extends string,
+		Head extends string | undefined = undefined,
+		Done extends boolean = false,
+		Result = never,
+		Depth extends Array<any> = [],
+	> = S extends `${infer C}${infer Rest}`
+		? Depth extends []
+			? C extends "("
+				? SolveChars<Rest, Head, Done, Result, [any]>
+				: C extends ","
+					? SolveChars<Rest, undefined, false, AddSolvedHead<Result, Head>, Depth>
+					: C extends ">"
+						? SolveChars<Rest, undefined, false, Result, Depth>
+						: ReadHead<Head, Done, C> extends [
+									infer NextHead extends string | undefined,
+									infer NextDone extends boolean,
+							  ]
+							? SolveChars<Rest, NextHead, NextDone, Result, Depth>
+							: never
+			: C extends "("
+				? SolveChars<Rest, Head, Done, Result, [...Depth, any]>
+				: C extends ")"
+					? SolveChars<Rest, Head, Done, Result, Depth extends [any, ...infer D] ? D : []>
+					: SolveChars<Rest, Head, Done, Result, Depth>
+		: AddSolvedHead<Result, Head>;
+
+	// Nested pseudo-classes can contain selector lists, so this path tracks only top-level
+	// separators while keeping the subject class from the current segment.
+	type SlowSolve<T extends string> = SolveChars<T>;
+
+	// Only the final combinator segment can determine the subject type.
+	type LastSegment<S extends string> = S extends `${string}>${infer R}` ? LastSegment<R> : S;
+
+	type CutAt<S extends string, D extends string> = S extends `${infer Prefix}${D}${string}` ? Prefix : S;
+
+	type LeadingClass<S extends string> = CutAt<CutAt<CutAt<CutAt<Trim<S>, ":">, ".">, "#">, " ">;
+
+	// Filters do not affect the subject class, but their values can contain selector separators.
+	type StripFiltersAndParens<S extends string> = S extends `${infer A}[${string}]${infer B}`
+		? StripFiltersAndParens<`${A}${B}`>
+		: S extends `${infer A}(${string})${infer B}`
+			? StripFiltersAndParens<`${A}${B}`>
+			: S;
+
+	type FastClause<S extends string> =
+		LeadingClass<LastSegment<S>> extends infer C extends keyof Instances ? Instances[C] : Instance;
+
+	type FastSolve<S extends string> = S extends `${infer A},${infer B}` ? FastClause<A> | FastSolve<B> : FastClause<S>;
+
+	type SolveUnquoted<S extends string> = S extends `${string}(${string}(${string})${string})${string}`
+		? SlowSolve<S>
+		: FastSolve<StripFiltersAndParens<S>>;
+
+	type StripQuotes<S extends string> = S extends `${infer A}'${string}'${infer B}` ? StripQuotes<`${A}${B}`> : S;
+
+	// Attribute values are not selector syntax, even when they contain ":" or ",".
+	type StripValidationGroups<S extends string> = S extends `${infer A}'${string}'${infer B}`
+		? StripValidationGroups<`${A}${B}`>
+		: S extends `${infer A}[${string}]${infer B}`
+			? StripValidationGroups<`${A}${B}`>
+			: S;
+
+	type SupportedPseudo = "not" | "has";
+
+	type CheckPseudos<S extends string> = S extends `${string}:${infer R}`
+		? R extends `${infer Name}(${infer Rest}`
+			? Name extends SupportedPseudo
+				? CheckPseudos<Rest>
+				: Name
+			: R // ':' not followed by 'name(' -> pseudo-classes require arguments
+		: never;
+
+	// The whole-empty selector "" is intentionally allowed.
+	type HasEmptyListItem<S extends string> = S extends `${string},${string}` ? CheckListItems<S> : false;
+	type CheckListItems<S extends string> = S extends `${infer A},${infer B}`
+		? Trim<A> extends ""
+			? true
+			: CheckListItems<B>
+		: Trim<S> extends ""
+			? true
+			: false;
+
+	type ValidateUnquoted<S extends string, Q extends string> = Q extends `${string}:${string}`
+		? CheckPseudos<Q> extends infer Bad
+			? [Bad] extends [never]
+				? HasEmptyListItem<Q> extends true
+					? `Invalid selector: empty selector in list (check for a stray or trailing comma)`
+					: S
+				: `Invalid selector: ':${Bad & string}' is not a supported pseudo-class (only ':not()' and ':has()' are allowed)`
+			: never
+		: Q extends `${string},${string}`
+			? HasEmptyListItem<Q> extends true
+				? `Invalid selector: empty selector in list (check for a stray or trailing comma)`
+				: S
+			: S;
+
+	export type ValidateSelector<S extends string> = string extends S
+		? S
+		: StripValidationGroups<S> extends infer Q extends string
+			? ValidateUnquoted<S, Q>
+			: never;
+
+	// Quoted values are stripped before solving so most selectors can stay on the cheaper path.
+	export type Solve<S extends string> = S extends `${string}'${string}`
+		? SolveUnquoted<StripQuotes<S>>
+		: SolveUnquoted<S>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rbxts/types",
-	"version": "1.0.937",
+	"version": "1.0.939",
 	"publishConfig": {
 		"access": "public"
 	},