roavatar-renderer 1.5.17 → 1.5.19

package/dist/index.d.ts

@@ -88,6 +88,8 @@ export declare const AllAnimations: AnimationProp[];
 
 export declare const AllAnimationSorts: ItemSort[];
 
+export declare const AllAvatarModelOutfitUpdateTypes: AvatarModelUpdateType[];
+
 export declare const AllBodyParts: number[];
 
 export declare const AllBodyPartsSorts: ItemSort[];
@@ -313,11 +315,28 @@ export declare const API: {
         WearOutfit: (auth: Authentication, outfit: Outfit, onlyItems: boolean) => Promise<[boolean, boolean]>;
         SaveOutfitNoRetry: (auth: Authentication, outfit: Outfit) => Promise<Response>;
         GetAvatarDetails: (userId: number) => Promise<Response | Outfit>;
+        GetAvatarModel: () => Promise<Response | OutfitModel>;
+        UpdateAvatarModel: (auth: Authentication, model: OutfitModel, updateTypes?: AvatarModelUpdateType[]) => Promise<Response>;
+        GetOutfitModel: (id: number | string, creatorId: number) => Promise<Response | OutfitModel>;
+        CreateOutfitModel: (auth: Authentication, model: OutfitModel) => Promise<Response>;
+        UpdateOutfitModel: (auth: Authentication, model: OutfitModel, id: number, updateTypes?: AvatarModelUpdateType[]) => Promise<Response>;
         GetHeadShapes: (pageToken: string | null | undefined) => Promise<AvatarInventory_Result | Response>;
         GetAvatarInventory: (sortOption: string, pageToken: string | null | undefined, itemInfos?: ItemSort[]) => Promise<AvatarInventory_Result | Response>;
+        /**
+         * @deprecated Use GetOutfitModel instead
+         */
         GetOutfitDetails: (outfitId: number | string, userId: number) => Promise<Response | Outfit>;
+        /**
+         * @deprecated Use CreateOutfitModel instead
+         */
         SaveOutfit: (auth: Authentication, outfit: Outfit) => Promise<Response>;
+        /**
+         * @deprecated Use UpdateOutfitModel instead
+         */
         UpdateOutfit: (auth: Authentication, outfitId: number | string, newOutfit: Outfit) => Promise<Response>;
+        /**
+         * @deprecated Use UpdateOutfitModel instead
+         */
         PatchOutfit: (auth: Authentication, outfitId: number | string, patchData: any) => Promise<Response>;
         DeleteOutfit: (auth: Authentication, outfitId: number | string) => Promise<Response>;
         GetUserOutfits: (userId: number) => Promise<Response | GetUserOutfits_Result>;
@@ -345,16 +364,16 @@ export declare const API: {
         IsLayered: (id: number) => Promise<boolean | Response>;
     };
     Catalog: {
-        GetNavigationMenuItems: () => Promise<NavigationMenuItems | Response>;
-        GetTopics: (auth: Authentication, body: GetTopics_Payload) => Promise<GetTopics_Result | Response>;
-        Search: ({ taxonomy, salesTypeFilter, sortType, categoryFilter, keyword, topics, creatorName, minPrice, maxPrice, includeNotForSale, limit }: Search_Payload, cursor?: string) => Promise<Search_Result | Response>;
-        GetBundleDetails: (bundleId: number | string) => Promise<BundleDetails_Result | Response>;
+        GetNavigationMenuItems: () => Promise<Response | NavigationMenuItems>;
+        GetTopics: (auth: Authentication, body: GetTopics_Payload) => Promise<Response | GetTopics_Result>;
+        Search: ({ taxonomy, salesTypeFilter, sortType, categoryFilter, keyword, topics, creatorName, minPrice, maxPrice, includeNotForSale, limit }: Search_Payload, cursor?: string) => Promise<Response | Search_Result>;
+        GetBundleDetails: (bundleId: number | string) => Promise<Response | BundleDetails_Result>;
         GetItemDetails: (auth: Authentication, items: {
             itemType: "Asset" | "Bundle";
             id: number;
-        }[]) => Promise<ItemDetails_Result | Response>;
-        GetMarketplaceWidgetsSearch: (query: string) => Promise<MarketplaceWidgets_Result | Response>;
-        GetMarketplaceWidgets: (context?: string) => Promise<MarketplaceWidgets_Result | Response>;
+        }[]) => Promise<Response | ItemDetails_Result>;
+        GetMarketplaceWidgetsSearch: (query: string) => Promise<Response | MarketplaceWidgets_Result>;
+        GetMarketplaceWidgets: (context?: string) => Promise<Response | MarketplaceWidgets_Result>;
     };
     Develop: {
         GetLatestVersions: (auth: Authentication, assetIds: number[]) => Promise<Response | LatestVersions_Result>;
@@ -366,7 +385,7 @@ export declare const API: {
     Users: {
         GetUserInfo: () => Promise<UserInfo | undefined>;
         GetIdsFromUsernames: (usernames: string[]) => Promise<any>;
-        GetInfoForId: (userId: number) => Promise<GetInfoForId_Result | Response>;
+        GetInfoForId: (userId: number) => Promise<Response | GetInfoForId_Result>;
         UserOmniSearch: (query: string, cursor?: string) => Promise<Response | UserOmniSearch_Result>;
     };
     Thumbnails: {
@@ -576,6 +595,19 @@ export declare class Authentication {
     getSessionUUID(): string;
 }
 
+declare interface AvatarConfigurations {
+    emotes?: {
+        assetId: number;
+        assetName: string;
+        position: number;
+    }[];
+    background?: {
+        backgroundAsset: AssetJson;
+    };
+    thumbnailCustomizations?: ThumbnailsCustomization_Payload[];
+    profileFrame: null;
+}
+
 /**@category API */
 export declare interface AvatarInventory_Result {
     avatarInventoryItems: {
@@ -616,6 +648,13 @@ export declare interface AvatarInventory_Result {
     nextPageToken: string | null;
 }
 
+export declare interface AvatarModel_Result {
+    avatarModel: OutfitJson;
+    avatarConfigurations: AvatarConfigurations | null;
+}
+
+export declare type AvatarModelUpdateType = "UpdateName" | "UpdateBodyColors" | "UpdateAssets" | "UpdateScales" | "UpdateBackground" | "UpdateAvatarType";
+
 /** @category Outfit */
 export declare type AvatarType = "R6" | "R15";
 
@@ -719,6 +758,12 @@ export declare type BodyColor3sJson = {
     leftArmColor3?: string;
     rightLegColor3?: string;
     leftLegColor3?: string;
+    headColor?: string;
+    torsoColor?: string;
+    rightArmColor?: string;
+    leftArmColor?: string;
+    rightLegColor?: string;
+    leftLegColor?: string;
 };
 
 /**@category Outfit */
@@ -929,6 +974,7 @@ export declare class CFrame {
     fromMatrix(m: Mat4x4): this;
     fromRotationMatrix(r00: number, r01: number, r02: number, r10: number, r11: number, r12: number, r20: number, r21: number, r22: number, order?: string): void;
     lookVector(): Vec3;
+    upVector(): Vec3;
     static lookAt(eye: Vec3, target: Vec3, up?: Vec3): CFrame;
     static fromEulerAngles(rx: number, ry: number, rz: number, order?: THREE.EulerOrder): CFrame;
     inverse(): CFrame;
@@ -1447,9 +1493,15 @@ export declare const FLAGS: {
     ALWAYS_SHOW_ATTACHMENTS: boolean;
     /**Multiplier for delta time used by renderer things (does not affect datamodel side of things but particles and such instead) */
     RENDERER_DELTA_TIME_MULTIPLIER: number;
-    /**How many seconds particles will presimulate (mainly so they arent incomplete in thumbnail generations) */
+    /**
+     * How many seconds particles will presimulate (mainly so they arent incomplete in thumbnail generations)
+     * @deprecated This can now be set per-scene
+     * */
     PARTICLES_START_FULL: number;
-    /**Framerate of presimulation particles */
+    /**
+     * Framerate of presimulation particles
+     * @deprecated This can now be set per-scene
+     * */
     PARTICLES_START_FULL_FRAMERATE: number;
     /**shows ThreeJS SkeletonHelper */
     SHOW_SKELETON_HELPER: boolean;
@@ -1527,6 +1579,7 @@ export declare function gaussian_rbf(v0: Vec3, v1: Vec3, sigma?: number): number
  * @param gltfAutoDownload Automatically download gltf file
  * @returns ThumbnailResult, always a string for 2d thumbnails, 3d can be ArrayBuffer (glb, binary) or {[key: string]: unknown} (gltf, json)
  *
+ * @deprecated Use new Thumbnails category instead
  * @category ThumbnailGenerator
  *
  * @example
@@ -1555,6 +1608,8 @@ export declare function gaussian_rbf(v0: Vec3, v1: Vec3, sigma?: number): number
  */
 export declare function generateModelThumbnail(auth: Authentication, renderScene: RBXRendererScene, model: Instance, size?: Vec2, type?: ThumbnailType, quality?: number, gltfAutoDownload?: boolean, includeAnimations?: boolean): Promise<ThumbnailResult>;
 
+export declare function generateOutfitModelThumbnail(auth: Authentication, outfitModel: OutfitModel, options: Partial<OutfitModelThumbnailOptions>): Promise<ThumbnailResult>;
+
 /**
  * Generates a 2d or 3d thumbnail of an outfit
  * @param auth Authentication
@@ -1565,22 +1620,20 @@ export declare function generateModelThumbnail(auth: Authentication, renderScene
  * @param gltfAutoDownload Automatically download gltf file
  * @returns ThumbnailResult, always a string for 2d thumbnails, 3d can be ArrayBuffer (glb, binary) or {[key: string]: unknown} (gltf, json)
  *
+ * @deprecated Use new Thumbnails category instead
  * @category ThumbnailGenerator
  *
  * @example
  * **Example on generating 1000x1000 webp thumbnail for blank outfit**
  * ```ts
  * const outfit = new Outfit()
- * FLAGS.THUMBNAIL_TIMEOUT = 1 //makes thumbnail generation faster
- * FLAGS.PARTICLES_START_FULL = 10 //makes emitters appear as if theyve been there for some time (10 seconds)
  * FLAGS.RENDERTARGET_TO_CANVASTEXTURE = true //required for gltf export
  * const result = await generateOutfitThumbnail(new Authentication(), outfit, [1000,1000], "webp", 0.99)
  * FLAGS.RENDERTARGET_TO_CANVASTEXTURE = false
- * FLAGS.PARTICLES_START_FULL = 0
  * console.log(result)
  * ```
  */
-export declare function generateOutfitThumbnail(auth: Authentication, outfit: Outfit, size?: Vec2, type?: ThumbnailType, quality?: number, gltfAutoDownload?: boolean, includeAnimations?: boolean): Promise<ThumbnailResult>;
+export declare function generateOutfitThumbnail(auth: Authentication, outfit: Outfit, size?: Vec2, type?: ThumbnailType, quality?: number, gltfAutoDownload?: boolean, includeAnimations?: boolean, renderSceneParam?: RBXRendererScene): Promise<ThumbnailResult>;
 
 export declare function generateUUIDv4(): string;
 
@@ -1600,6 +1653,7 @@ export declare function getCameraCFrameForAvatarNonCustomized(rig: Instance): CF
  * @param yRot Customized yRot
  * @param distance Customized distanceScale
  * @returns Thumbnail camera cframe
+ * @deprecated Use new Thumbnails category instead
  * @category ThumbnailGenerator
  */
 export declare function getCameraCFrameForHeadshotCustomized(rig: Instance, fov: number, yRot: number, distance: number): CFrame | undefined;
@@ -1609,18 +1663,21 @@ export declare function getCameraCFrameForHeadshotCustomized(rig: Instance, fov:
  */
 export declare function getDistIndexArray(ref: FileMesh, dist: FileMesh): (number | undefined)[];
 
-/**@category ThumbnailGenerator */
+/**
+ * @category ThumbnailGenerator */
 export declare function getExtents(cframe: CFrame, parts: Instance[]): [Vector3, Vector3];
 
-/**@category ThumbnailGenerator */
+/**
+ * @category ThumbnailGenerator */
 export declare function getExtentsCenter(extents: [Vector3, Vector3]): Vector3;
 
 /**
- * @deprecated this is SO broken
  * @category ThumbnailGenerator
  * */
 export declare function getExtentsForParts(parts: Instance[], includeTransform?: boolean): [Vector3, Vector3];
 
+export declare function getExtentsWorld(rig: Instance): [Vector3, Vector3];
+
 export declare function getHeadExtents(rig: Instance): [Vector3, Vector3] | undefined;
 
 /**@category API */
@@ -1652,8 +1709,6 @@ export declare function getPartsInAssembly_Generate(part: Instance): Instance[];
 
 export declare function getRandomBetweenInclusive(min: number, max: number, randomVal?: number): number;
 
-export declare function getRigExtentsWorld(rig: Instance): [Vector3, Vector3];
-
 export declare function getRootAssemblyPart_Generate(part: Instance): Instance;
 
 /**@category API */
@@ -1678,7 +1733,7 @@ export declare interface GetSubscription_Result {
  * @returns Thumbnail camera cframe
  * @category ThumbnailGenerator
  */
-export declare function getThumbnailCameraCFrame(model: Instance): CFrame | undefined;
+export declare function getThumbnailCameraCFrame(model: Instance, fov: number, forceAngle?: Vec3): CFrame | undefined;
 
 /**@category API */
 export declare interface GetTopics_Payload {
@@ -1865,6 +1920,31 @@ export declare const HumanoidRigType: {
     R15: number;
 };
 
+/**
+ * Renders a scene to an image and returns a data url
+ * @param renderScene Scene that will be rendered
+ * @param width Width in pixels
+ * @param height Height in pixels
+ * @param format Type of image
+ * @param options
+ * @returns data url
+ *
+ * @category ThumbnailGenerator
+ */
+export declare function imageThumbnailClick(renderScene: RBXRendererScene, width: number, height: number, format: ImageThumbnailFormat, options?: Partial<ImageThumbnailOptions>): Promise<string | undefined>;
+
+/**
+ * @category ThumbnailGenerator
+ */
+export declare type ImageThumbnailFormat = "png" | "webp" | "jpeg";
+
+/**
+ * @category ThumbnailGenerator
+ */
+export declare interface ImageThumbnailOptions {
+    quality: number;
+}
+
 export declare function imageUrlToDataUrl(imageUrl: string): Promise<string>;
 
 /**
@@ -2158,11 +2238,16 @@ export declare class LocalOutfit {
     date: number;
     image?: string;
     buffer: string;
+    bg: number;
     constructor(outfit: Outfit);
     toJson(): LocalOutfitJson;
     fromJson(data: LocalOutfitJson): this;
     update(outfit: Outfit): void;
+    /**
+     * @deprecated Use toOutfitModel() instead
+     */
     toOutfit(auth: Authentication): Promise<Outfit>;
+    toOutfitModel(auth: Authentication): Promise<OutfitModel>;
 }
 
 export declare interface LocalOutfitJson {
@@ -2172,6 +2257,7 @@ export declare interface LocalOutfitJson {
     date: number;
     image: string | undefined;
     buffer: string;
+    bg?: number;
 }
 
 /**
@@ -2414,6 +2500,31 @@ export declare const minimumDeltaEBodyColorDifference = 11.4;
  */
 export declare function minus(v0: Vec3, v1: Vec3): Vec3;
 
+/**
+ * Generates a 3D model from the scene
+ * @param renderScene Scene that will be rendered
+ * @param format Format of resulting model
+ * @param options
+ * @returns ArrayBuffer for glb or Object for gltf
+ *
+ * @category ThumbnailGenerator
+ */
+export declare function modelThumbnailClick(renderScene: RBXRendererScene, format: ModelThumbnailFormat, options?: Partial<ModelThumbnailOptions>): Promise<ArrayBuffer | {
+    [key: string]: unknown;
+}>;
+
+/**
+ * @category ThumbnailGenerator
+ */
+export declare type ModelThumbnailFormat = "gltf" | "glb";
+
+/**
+ * @category ThumbnailGenerator
+ */
+export declare interface ModelThumbnailOptions {
+    includeAnimations: boolean;
+}
+
 /**
  * @category InstanceWrapper
  */
@@ -2660,6 +2771,7 @@ export declare class Outfit {
     clone(): Outfit;
     toJson(removeNotOwnedAssets?: boolean): OutfitJson;
     toCleanJson(removeNotOwnedAssets?: boolean): OutfitJson;
+    toCleanJsonV4(removeNotOwnedAssets?: boolean): OutfitJson;
     fromJson(outfitJson: OutfitJson): void;
     /**
      * @deprecated Incorrect, use getValidationIssues() instead
@@ -2715,6 +2827,29 @@ export declare type OutfitJson = {
     scales?: ScaleJson;
 };
 
+export declare class OutfitModel {
+    outfit: Outfit;
+    emotes: Map<number, Asset>;
+    background?: Asset;
+    thumbnailCustomizations?: ThumbnailCustomization[];
+    profileFrame: undefined;
+    fromJson(outfitModel: AvatarModel_Result | OutfitModel_Result): OutfitModel;
+    clone(): OutfitModel;
+}
+
+export declare interface OutfitModel_Result {
+    outfitModel: OutfitJson;
+    outfitConfigurations: AvatarConfigurations | null;
+}
+
+export declare type OutfitModelThumbnailOptions = {
+    size: Vec2;
+    type: ThumbnailType;
+    quality: number;
+    gltfAutoDownload: boolean;
+    includeAnimations: boolean;
+};
+
 /** @category Outfit */
 export declare type OutfitOrigin = "WebAvatar" | "WebOutfit" | "Other" | "Look";
 
@@ -2725,6 +2860,37 @@ export declare const OutfitOrigin: {
 
 /**
  * @category Renderer
+ * @example
+ * **Example on usage**
+ * ```ts
+ * const auth = new Authentication()
+ * const outfit = new Outfit()
+ * const renderScene = RBXRenderer.addScene()
+ *
+ * const outfitRenderer = new OutfitRenderer(auth, outfit, renderScene)
+ * outfitRenderer.startAnimating()
+ * outfitRenderer.setMainAnimation("anim.1234") //animation with id 1234, check documentation for other possible values
+ *
+ * outfitRenderer.onRenderSuccess.Connect(() => {
+ *     //handle Instance tree + renderDesc being successfuly
+ * })
+ * outfitRenderer.onError.Connect(() => {
+ *     //handle Instance tree error
+ * })
+ * outfitRenderer.onRenderError.Connect(() => {
+ *     //handle renderDesc error
+ * })
+ *
+ * //onRenderSuccess is fired once after some time
+ *
+ * outfitRenderer.setOutfit(new Outfit())
+ *
+ * //onRenderSuccess is fired again once after some time
+ *
+ * //when we're done rendering
+ * outfitRenderer.destroy()
+ * renderScene.destroy()
+ * ```
  */
 export declare class OutfitRenderer {
     auth: Authentication;
@@ -2734,6 +2900,7 @@ export declare class OutfitRenderer {
     doCameraUpdateOnLoad: boolean; /**Makes camera update when new avatar has loaded */
     doCameraUpdate: boolean; /**Does camera update every frame */
     doAddInstance: boolean; /**If outfitRenderer should call RBXRenderer.addInstance() */
+    forceAnimationLoop: boolean; /**If future loaded animations should be set to loop */
     currentlyChangingRig: boolean;
     currentlyUpdating: boolean;
     hasNewUpdate: boolean;
@@ -2743,14 +2910,34 @@ export declare class OutfitRenderer {
     animationFPS: number;
     deltaTimeMultiplier: number;
     renderScene: RBXRendererScene;
-    /**Event is fired if a new outfit failed to load
+    private _renderSceneCompiledConnection?;
+    private _renderSceneFailedConnection?;
+    /**Event is fired if a new outfit failed to load (specifically the Instance tree, not the rendering part)
+     *
+     * Simple: Fired when, Instance tree = fail
      * @returns OutfitRendererErrorType
      */
     onError: Event_2;
-    /**Event is fired if a new outfit successfully loaded
+    /**Event is fired if a new outfit successfully loaded (specifically the Instance tree, not the rendering part)
+     *
+     * Simple: Fired when, Instance tree = done
      * @returns void
      */
     onSuccess: Event_2;
+    /**Event is fired when all the renderDescs have been compiled, if any renderDescs fail to render this wil never be fired (can only be fired after Instance tree is done)
+     *
+     * Simple: Fired when, Instance tree = done & Rendering = done (AKA everything)
+     *
+     * NOTE: If FLAGS.LAYERED_CLOTHING_COOLDOWN > 0 (non-default), this may be fired too early and later fire again
+     * @returns void
+     */
+    onRenderSuccess: Event_2;
+    /**Event is fired if a renderDesc fails to compile, it can be fired multiple times
+     *
+     * Simple: Fired when, Rendering = fail
+     * @returns void
+     */
+    onRenderError: Event_2;
     /**
      * Creates a new OutfitRenderer which makes it easy to render outfits
      * @param auth The authentication object, you should have one you use for everything
@@ -2761,7 +2948,7 @@ export declare class OutfitRenderer {
     /**
      * Updates the current rig, called internally by _updateOutfit()
      */
-    _setRigTo(newRigType: AvatarType): Promise<Response | Instance>;
+    _setRigTo(newRigType: AvatarType): Promise<Instance | Response>;
     /**
      * Rerenders the current outfit, called internally by setOutfit() and constructor
      */
@@ -2788,11 +2975,22 @@ export declare class OutfitRenderer {
     stopAnimating(): void;
     /**
      * Sets the current animation being played
-     * @param name The name of the animation, for example "idle", "run" or "emote.1234"
+     * @param name The name of the animation, for example "idle", "run", "emote.1234" or "anim.1234"
      * @returns If the animation started playing, it may start playing later if it has been queued despite returning false
      */
     setMainAnimation(name: string): Promise<boolean>;
-    /**Calls destroy on the rig and stops animating, the OutfitRenderer should not be interacted with after this */
+    fireFullyRenderedIfNeeded(): void;
+    /**
+     * Prepares the OutfitRenderer to be used for a thumbnail, call IMMEDIATELY after creating the OutfitRenderer
+     * @returns true on success
+     */
+    prepareForThumbnail(): Promise<boolean>;
+    private _prepareForThumbnail;
+    /**
+     * Updates rendered particles so they face the camera without simulating them (usually used when generating thumbnails)
+     */
+    updateParticleMatrix(): void;
+    /**Calls destroy on the rig, stops animating and disconnects connections. The OutfitRenderer should not be interacted with after this */
     destroy(): void;
 }
 
@@ -3175,9 +3373,15 @@ export declare class RBXRendererScene {
     effectComposer: EffectComposer | undefined;
     scissor?: [number, number, number, number];
     viewport?: [number, number, number, number];
+    addedInstances: Instance[];
     isRenderingMesh: Map<Instance, boolean>;
     renderDescs: Map<Instance, RenderDesc>;
     destroyConnections: Map<Instance, Connection>;
+    compiledRenderDesc: Event_2;
+    failedRenderDesc: Event_2;
+    forceAccurateNeedsRegeneration: boolean;
+    particlesStartFull?: number;
+    particlesStartFullFramerate: number;
     lookAwayVector: Vec3;
     lookAwayDistance: number;
     shadowEnabled: boolean;
@@ -3196,6 +3400,16 @@ export declare class RBXRendererScene {
     noRect(): void;
     /** Destroys all renderDescs but does not call Destroy on instances */
     destroy(): void;
+    /**
+     * Checks that renderDescs for provided instances are compiled, ignores instances that shouldn't be compiled or haven't been added
+     * @returns true if all provided instances's renderDescs have been compiled
+     */
+    areInstancesCompiled(instances: Instance[]): boolean;
+    /**
+     * Checks that all renderDescs are compiled
+     * @return true if all have been compiled
+     */
+    isFullyCompiled(): boolean;
     /**
      * Exports scene as a GLTF or GLB
      * @param name Name of the resulting file if autoDownload is true
@@ -3255,6 +3469,8 @@ declare class RenderDesc extends DisposableDesc {
     renderScene: RBXRendererScene;
     results?: THREE.Object3D[];
     instance?: Instance;
+    compiled: boolean;
+    failed: boolean;
     constructor(renderScene: RBXRendererScene);
     isSame(_other: RenderDesc): boolean;
     needsRegeneration(_other: RenderDesc): boolean;
@@ -3564,6 +3780,18 @@ export declare const StringBufferProperties: string[];
 
 declare type ThreePoseCorrective = Vec3;
 
+export declare class ThumbnailCustomization {
+    thumbnailType: number;
+    emoteAssetId: number;
+    fieldOfViewDeg: number;
+    yRotDeg: number;
+    distanceScale: number;
+    constructor(thumbnailType: number);
+    fromJson(json: ThumbnailsCustomization_Payload): this;
+    toJson(): ThumbnailsCustomization_Payload;
+    clone(): ThumbnailCustomization;
+}
+
 /**@category API */
 export declare interface ThumbnailCustomizations_Result {
     "avatarThumbnailCustomizations": {
@@ -3577,7 +3805,9 @@ export declare interface ThumbnailCustomizations_Result {
     }[];
 }
 
-/**@category ThumbnailGenerator */
+/**
+ * @deprecated Use new Thumbnails category instead
+ * @category ThumbnailGenerator */
 export declare type ThumbnailResult = ArrayBuffer | {
     [key: string]: unknown;
 } | string | undefined;
@@ -3593,7 +3823,9 @@ export declare interface ThumbnailsCustomization_Payload {
     };
 }
 
-/**@category ThumbnailGenerator */
+/**
+ * @deprecated Use new Thumbnails category instead
+ * @category ThumbnailGenerator */
 export declare type ThumbnailType = "png" | "webp" | "gltf" | "glb";
 
 /**
@@ -3822,8 +4054,6 @@ export declare const WrapLayerAutoSkin: {
 
 export declare const xmlMagic = "<roblox ";
 
-export declare function zoomExtents(cameraCFrame: CFrame, modelCFrame: CFrame, modelSize: Vector3, targetFOV: number, distanceScale: number, sizeType?: ZoomExtentsSizeType): void;
-
 /**
  * Makes model fit inside camera
  * @param cameraCFrame Original camera cframe
@@ -3833,6 +4063,8 @@ export declare function zoomExtents(cameraCFrame: CFrame, modelCFrame: CFrame, m
  * @param distanceScale Distance is multiplied by this
  * @category ThumbnailGenerator
  */
+export declare function zoomExtents(cameraCFrame: CFrame, modelCFrame: CFrame, modelSize: Vector3, targetFOV: number, distanceScale: number, sizeType?: ZoomExtentsSizeType): void;
+
 export declare type ZoomExtentsSizeType = "largestAxis" | "calculate";
 
 /**