roavatar-renderer 1.5.17 → 1.5.18

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";
+
 /** @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;
@@ -1527,6 +1573,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 +1602,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,6 +1614,7 @@ 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
@@ -1580,7 +1630,7 @@ export declare function generateModelThumbnail(auth: Authentication, renderScene
  * 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 +1650,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,14 +1660,18 @@ export declare function getCameraCFrameForHeadshotCustomized(rig: Instance, fov:
  */
 export declare function getDistIndexArray(ref: FileMesh, dist: FileMesh): (number | undefined)[];
 
-/**@category ThumbnailGenerator */
+/**
+ * @deprecated Use new Thumbnails category instead
+ * @category ThumbnailGenerator */
 export declare function getExtents(cframe: CFrame, parts: Instance[]): [Vector3, Vector3];
 
-/**@category ThumbnailGenerator */
+/**
+ * @deprecated Use new Thumbnails category instead
+ * @category ThumbnailGenerator */
 export declare function getExtentsCenter(extents: [Vector3, Vector3]): Vector3;
 
 /**
- * @deprecated this is SO broken
+ * @deprecated Use new Thumbnails category instead
  * @category ThumbnailGenerator
  * */
 export declare function getExtentsForParts(parts: Instance[], includeTransform?: boolean): [Vector3, Vector3];
@@ -1676,9 +1731,10 @@ export declare interface GetSubscription_Result {
  * Calculates the CFrame the camera should be at when generating a thumbnail
  * @param model The model-like instance to get thumbnail camera for
  * @returns Thumbnail camera cframe
+ * @deprecated Use new Thumbnails category instead
  * @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 {
@@ -2158,11 +2214,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 +2233,7 @@ export declare interface LocalOutfitJson {
     date: number;
     image: string | undefined;
     buffer: string;
+    bg?: number;
 }
 
 /**
@@ -2660,6 +2722,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 +2778,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";
 
@@ -2761,7 +2847,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
      */
@@ -3458,6 +3544,7 @@ export declare interface Search_Result {
  * Gives a scene the default appearance for thumbnails
  * @param renderScene RBXRenderScene to setup
  *
+ * @deprecated Use new Thumbnails category instead
  * @category ThumbnailGenerator
  */
 export declare function setupThumbnailScene(renderScene: RBXRendererScene): void;
@@ -3564,6 +3651,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 +3676,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 +3694,9 @@ export declare interface ThumbnailsCustomization_Payload {
     };
 }
 
-/**@category ThumbnailGenerator */
+/**
+ * @deprecated Use new Thumbnails category instead
+ * @category ThumbnailGenerator */
 export declare type ThumbnailType = "png" | "webp" | "gltf" | "glb";
 
 /**

package/dist/index.js

@@ -1,3 +1,26 @@
+function cloneSearch_Payload(data) {
+  const newData = {
+    taxonomy: data.taxonomy,
+    salesTypeFilter: data.salesTypeFilter,
+    categoryFilter: data.categoryFilter,
+    sortType: data.sortType,
+    keyword: data.keyword,
+    topics: void 0,
+    creatorName: data.creatorName,
+    minPrice: data.minPrice,
+    maxPrice: data.maxPrice,
+    includeNotForSale: data.includeNotForSale,
+    limit: data.limit
+  };
+  if (data.topics) {
+    newData.topics = [];
+    for (const topic of data.topics) {
+      newData.topics.push(topic);
+    }
+  }
+  return newData;
+}
+const AllAvatarModelOutfitUpdateTypes = ["UpdateBodyColors", "UpdateAssets", "UpdateScales", "UpdateBackground"];
 const BrickColors = {
   1: "#F2F3F3",
   2: "#A1A5A2",
@@ -31497,6 +31520,16 @@ class CFrame {
     lookVector.applyQuaternion(quat);
     return lookVector.toArray();
   }
+  upVector() {
+    const matrix = this.getTHREEMatrix();
+    const pos = new Vector3$1();
+    const quat = new Quaternion();
+    const scale = new Vector3$1();
+    matrix.decompose(pos, quat, scale);
+    const upVector = new Vector3$1(0, 1, 0);
+    upVector.applyQuaternion(quat);
+    return upVector.toArray();
+  }
   static lookAt(eye, target, up = [0, 1, 0]) {
     const matrix = new Matrix4().lookAt(new Vector3$1(...eye), new Vector3$1(...target), new Vector3$1(...up));
     const newCFrame = new CFrame();
@@ -31750,6 +31783,9 @@ class Instance {
           if (value && value.toLowerCase().includes(FLAGS.SEARCH_FOR_STRING)) {
             log(true, this.GetFullName());
             log(true, value);
+            if (value.length > 1e4) {
+              download(this.GetFullName(), value);
+            }
           }
         }
       }
@@ -33441,7 +33477,8 @@ const AssetTypes = [
   "LipMakeup",
   "EyeMakeup",
   "VoxelFragment",
-  "AvatarBackground"
+  "AvatarBackground",
+  "TextDocument"
 ];
 const WearableAssetTypes = [
   "TShirt",
@@ -33934,6 +33971,18 @@ class BodyColor3s {
       this.rightLegColor3 = bodyColorsJson.rightLegColor3;
     if (bodyColorsJson.leftLegColor3)
       this.leftLegColor3 = bodyColorsJson.leftLegColor3;
+    if (bodyColorsJson.headColor)
+      this.headColor3 = bodyColorsJson.headColor;
+    if (bodyColorsJson.torsoColor)
+      this.torsoColor3 = bodyColorsJson.torsoColor;
+    if (bodyColorsJson.rightArmColor)
+      this.rightArmColor3 = bodyColorsJson.rightArmColor;
+    if (bodyColorsJson.leftArmColor)
+      this.leftArmColor3 = bodyColorsJson.leftArmColor;
+    if (bodyColorsJson.rightLegColor)
+      this.rightLegColor3 = bodyColorsJson.rightLegColor;
+    if (bodyColorsJson.leftLegColor)
+      this.leftLegColor3 = bodyColorsJson.leftLegColor;
   }
 }
 class BodyColors {
@@ -34109,6 +34158,15 @@ class Outfit {
     ogJson.collections = void 0;
     return ogJson;
   }
+  toCleanJsonV4(removeNotOwnedAssets = false) {
+    const ogJson = this.toJson(removeNotOwnedAssets);
+    ogJson.creatorId = void 0;
+    ogJson.outfitType = void 0;
+    ogJson.collections = void 0;
+    ogJson.bodyColor3s = void 0;
+    ogJson.bodyColors = this.bodyColors.toHexJson();
+    return ogJson;
+  }
   fromJson(outfitJson) {
     this.scale = new Scale();
     if (outfitJson.scale) {
@@ -34117,7 +34175,7 @@ class Outfit {
       this.scale.fromJson(outfitJson.scales);
     }
     const bodyColorsJson = outfitJson.bodyColors;
-    if (bodyColorsJson && !("headColor3" in bodyColorsJson)) {
+    if (bodyColorsJson && !("headColor3" in bodyColorsJson) && !("headColor" in bodyColorsJson)) {
       const oldBodyColors = new BodyColors();
       oldBodyColors.fromJson(bodyColorsJson);
       if (FLAGS.BODYCOLOR3) {
@@ -35071,6 +35129,92 @@ class Outfit {
     return view.buffer;
   }
 }
+class ThumbnailCustomization {
+  thumbnailType;
+  emoteAssetId = 0;
+  fieldOfViewDeg = 28.751935958862305;
+  yRotDeg = 0;
+  distanceScale = 1;
+  constructor(thumbnailType) {
+    this.thumbnailType = thumbnailType;
+  }
+  fromJson(json) {
+    this.emoteAssetId = json.emoteAssetId;
+    this.fieldOfViewDeg = json.camera.fieldOfViewDeg;
+    this.yRotDeg = json.camera.yRotDeg;
+    this.distanceScale = json.camera.distanceScale;
+    return this;
+  }
+  toJson() {
+    return {
+      thumbnailType: this.thumbnailType,
+      emoteAssetId: this.emoteAssetId,
+      camera: {
+        fieldOfViewDeg: this.fieldOfViewDeg,
+        yRotDeg: this.yRotDeg,
+        distanceScale: this.distanceScale
+      }
+    };
+  }
+  clone() {
+    const copy = new ThumbnailCustomization(this.thumbnailType);
+    copy.emoteAssetId = this.emoteAssetId;
+    copy.fieldOfViewDeg = this.fieldOfViewDeg;
+    copy.yRotDeg = this.yRotDeg;
+    copy.distanceScale = this.distanceScale;
+    return copy;
+  }
+}
+class OutfitModel {
+  outfit = new Outfit();
+  emotes = /* @__PURE__ */ new Map();
+  background;
+  thumbnailCustomizations;
+  profileFrame;
+  fromJson(outfitModel) {
+    const config = "avatarConfigurations" in outfitModel ? outfitModel.avatarConfigurations : outfitModel.outfitConfigurations;
+    this.outfit.fromJson("avatarModel" in outfitModel ? outfitModel.avatarModel : outfitModel.outfitModel);
+    if (config) {
+      if (config.emotes) {
+        for (const emote of config.emotes) {
+          const asset = new Asset();
+          asset.id = emote.assetId;
+          asset.name = emote.assetName;
+          this.emotes.set(emote.position, asset);
+        }
+      }
+      if (config.background) {
+        const asset = new Asset();
+        asset.fromJson(config.background.backgroundAsset);
+        this.background = asset;
+      }
+      if (config.thumbnailCustomizations) {
+        this.thumbnailCustomizations = [];
+        for (const json of config.thumbnailCustomizations) {
+          this.thumbnailCustomizations.push(new ThumbnailCustomization(json.thumbnailType).fromJson(json));
+        }
+      }
+    }
+    return this;
+  }
+  clone() {
+    const copy = new OutfitModel();
+    copy.outfit = this.outfit.clone();
+    copy.emotes = /* @__PURE__ */ new Map();
+    for (const key of this.emotes.keys()) {
+      copy.emotes.set(key, this.emotes.get(key));
+    }
+    copy.background = this.background?.clone();
+    if (this.thumbnailCustomizations) {
+      copy.thumbnailCustomizations = [];
+      for (const customization of this.thumbnailCustomizations) {
+        copy.thumbnailCustomizations.push(customization.clone());
+      }
+    }
+    copy.profileFrame = this.profileFrame;
+    return copy;
+  }
+}
 class LocalOutfit {
   name;
   id;
@@ -35078,6 +35222,7 @@ class LocalOutfit {
   date;
   image;
   buffer;
+  bg = 0;
   constructor(outfit) {
     this.name = outfit.name;
     this.id = outfit.id;
@@ -35092,7 +35237,8 @@ class LocalOutfit {
       creator: this.creator,
       date: this.date,
       image: this.image,
-      buffer: this.buffer
+      buffer: this.buffer,
+      bg: this.bg
     };
   }
   fromJson(data) {
@@ -35101,12 +35247,16 @@ class LocalOutfit {
     this.creator = data.creator;
     this.image = data.image;
     this.buffer = data.buffer;
+    this.bg = data.bg || 0;
     return this;
   }
   update(outfit) {
     this.buffer = arrayBufferToBase64(outfit.toBuffer());
     this.image = void 0;
   }
+  /**
+   * @deprecated Use toOutfitModel() instead
+   */
   async toOutfit(auth) {
     const outfit = new Outfit();
     outfit.name = this.name;
@@ -35115,6 +35265,26 @@ class LocalOutfit {
     await outfit.fromBuffer(base64ToArrayBuffer(this.buffer), auth);
     return outfit;
   }
+  async toOutfitModel(auth) {
+    const outfitModel = new OutfitModel();
+    const outfit = outfitModel.outfit;
+    outfit.name = this.name;
+    outfit.id = this.id;
+    outfit.creatorId = this.creator;
+    await outfit.fromBuffer(base64ToArrayBuffer(this.buffer), auth);
+    if (this.bg) {
+      await outfit.addAssetId(this.bg, auth);
+      const assetIndex = outfit.assets.findIndex((v) => {
+        return v.id === this.bg;
+      });
+      if (assetIndex >= 0) {
+        const asset = outfit.assets[assetIndex];
+        outfitModel.background = asset;
+        outfit.removeAsset(this.bg);
+      }
+    }
+    return outfitModel;
+  }
 }
 class ItemSort {
   subType;
@@ -35274,6 +35444,9 @@ const CategoryDictionary = {
       "Swim": new SortInfo([new ItemSort(54)]),
       "Climb": new SortInfo([new ItemSort(48)]),
       "Mood": new SortInfo([new ItemSort(AssetTypeNameToId.get("MoodAnimation") || 0)], "inventory")
+    },
+    "Profile": {
+      "Backgrounds": new SortInfo([new ItemSort(AssetTypeNameToId.get("AvatarBackground") || 0)])
     }
   }
 };
@@ -37025,6 +37198,7 @@ function createContentMap() {
   }
   ContentMap.set("roavatar://AvatarEditorScene.rbxm", "74148511291027");
   ContentMap.set("roavatar://AvatarSceneNew.rbxm", "130507237273896");
+  ContentMap.set("roavatar://AvatarCyclorama.rbxm", "79116945688799");
 }
 let CachedRoAvatarData = void 0;
 let ThumbnailsToBatch = [];
@@ -37281,6 +37455,64 @@ const API = {
         return response;
       }
     },
+    GetAvatarModel: async function() {
+      const response = await RBLXGet("https://avatar.roblox.com/v4/avatar?selectionTypes=0&selectionTypes=1&selectionTypes=2&selectionTypes=3&selectionTypes=4&selectionTypes=5");
+      if (response.status !== 200) return response;
+      const body = await response.json();
+      const outfitModel = new OutfitModel().fromJson(body);
+      return outfitModel;
+    },
+    UpdateAvatarModel: async function(auth, model, updateTypes = AllAvatarModelOutfitUpdateTypes) {
+      const response = await RBLXPatch("https://avatar.roblox.com/v4/avatar", auth, {
+        updateTypes,
+        avatarDefinition: {
+          updateAvatarConfig: {
+            backgroundRequestModel: {
+              id: model.background?.id || 0
+            }
+          },
+          updateAvatarModel: model.outfit.toCleanJson()
+        }
+      });
+      return response;
+    },
+    GetOutfitModel: async function(id, creatorId) {
+      const response = await RBLXGet(`https://avatar.roblox.com/v4/outfits/${id}/details`);
+      if (response.status !== 200) return response;
+      const body = await response.json();
+      const outfitModel = new OutfitModel().fromJson(body);
+      outfitModel.outfit.origin = OutfitOrigin.WebOutfit;
+      outfitModel.outfit.id = Number(id);
+      outfitModel.outfit.creatorId = creatorId;
+      return outfitModel;
+    },
+    CreateOutfitModel: async function(auth, model) {
+      const response = await RBLXPost("https://avatar.roblox.com/v4/outfits/create", auth, {
+        outfitDefinition: {
+          updateOutfitConfig: {
+            backgroundRequestModel: {
+              id: model.background?.id || 0
+            }
+          },
+          updateOutfitModel: model.outfit.toCleanJsonV4()
+        }
+      });
+      return response;
+    },
+    UpdateOutfitModel: async function(auth, model, id, updateTypes = AllAvatarModelOutfitUpdateTypes) {
+      const response = await RBLXPatch(`https://avatar.roblox.com/v4/outfits/${id}`, auth, {
+        updateTypes,
+        outfitDefinition: {
+          updateOutfitConfig: {
+            backgroundRequestModel: {
+              id: model.background?.id || 0
+            }
+          },
+          updateOutfitModel: model.outfit.toCleanJsonV4()
+        }
+      });
+      return response;
+    },
     GetHeadShapes: async function(pageToken) {
       const itemSort = new ItemSort(1, "headshape");
       return API.Avatar.GetAvatarInventory("1", pageToken, [itemSort]);
@@ -37318,6 +37550,9 @@ const API = {
         return result;
       }
     },
+    /**
+     * @deprecated Use GetOutfitModel instead
+     */
     GetOutfitDetails: async function(outfitId, userId) {
       let requestUrl = "https://avatar.roblox.com/v1/outfits/";
       if (FLAGS.BODYCOLOR3) {
@@ -37335,6 +37570,9 @@ const API = {
         return response;
       }
     },
+    /**
+     * @deprecated Use CreateOutfitModel instead
+     */
     SaveOutfit: async function(auth, outfit) {
       const requestUrl = `https://avatar.roblox.com/${FLAGS.BODYCOLOR3 ? "v3" : "v2"}/outfits/create`;
       const response = await RBLXPost(requestUrl, auth, outfit.toCleanJson());
@@ -37348,6 +37586,9 @@ const API = {
         return response2;
       }
     },
+    /**
+     * @deprecated Use UpdateOutfitModel instead
+     */
     UpdateOutfit: async function(auth, outfitId, newOutfit) {
       let requestUrl = "https://avatar.roblox.com/v1/outfits/";
       if (FLAGS.BODYCOLOR3) {
@@ -37357,6 +37598,9 @@ const API = {
       const response = RBLXPatch(requestUrl, auth, JSON.stringify(newOutfit.toCleanJson()));
       return response;
     },
+    /**
+     * @deprecated Use UpdateOutfitModel instead
+     */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     PatchOutfit: async function(auth, outfitId, patchData) {
       let requestUrl = "https://avatar.roblox.com/v1/outfits/";
@@ -37722,7 +37966,8 @@ const API = {
         type,
         id,
         size,
-        headShape
+        headShape,
+        includeBackground: type === "Outfit"
       };
       const cachedThumbnail = CACHE.Thumbnails.get(requestIdFromThumbnailInfo(thisThumbnailInfo));
       if (CACHE.Thumbnails.has(requestIdFromThumbnailInfo(thisThumbnailInfo))) {
@@ -37746,7 +37991,8 @@ const API = {
           resolves: [resolve],
           attempt: 0,
           lastTryTimestamp: 0,
-          headShape
+          headShape,
+          includeBackground: type === "Outfit"
         });
       });
     },
@@ -37755,7 +38001,8 @@ const API = {
         type,
         id,
         size,
-        headShape
+        headShape,
+        includeBackground: type === "Outfit"
       };
       CACHE.Thumbnails.delete(requestIdFromThumbnailInfo(thisThumbnailInfo));
     },
@@ -37887,6 +38134,9 @@ function requestIdFromThumbnailInfo(thumbnailInfo) {
   if (thumbnailInfo.headShape) {
     requestId += `:${thumbnailInfo.headShape}`;
   }
+  if (thumbnailInfo.includeBackground) {
+    requestId += `:${thumbnailInfo.includeBackground}`;
+  }
   return requestId;
 }
 function PurgeFailedThumbnails() {
@@ -37917,7 +38167,8 @@ function BatchThumbnails() {
       "size": thumbnailInfo.size,
       "targetId": thumbnailInfo.id,
       "type": thumbnailInfo.type,
-      "headShape": thumbnailInfo.headShape
+      "headShape": thumbnailInfo.headShape,
+      "includeBackground": thumbnailInfo.includeBackground
     });
     auth = thumbnailInfo.auth;
     thumbnailInfo.lastTryTimestamp = Date.now() / 1e3;
@@ -37965,28 +38216,6 @@ function startBatchThumbnails() {
     }
   }, 10);
 }
-function cloneSearch_Payload(data) {
-  const newData = {
-    taxonomy: data.taxonomy,
-    salesTypeFilter: data.salesTypeFilter,
-    categoryFilter: data.categoryFilter,
-    sortType: data.sortType,
-    keyword: data.keyword,
-    topics: void 0,
-    creatorName: data.creatorName,
-    minPrice: data.minPrice,
-    maxPrice: data.maxPrice,
-    includeNotForSale: data.includeNotForSale,
-    limit: data.limit
-  };
-  if (data.topics) {
-    newData.topics = [];
-    for (const topic of data.topics) {
-      newData.topics.push(topic);
-    }
-  }
-  return newData;
-}
 function browserSendMessage(data) {
   return (chrome || browser).runtime.sendMessage(data);
 }
@@ -45581,6 +45810,8 @@ class MaterialDesc {
   dirty = false;
   //result
   createdTextures = [];
+  noTextureTransparency = false;
+  result;
   isSame(other) {
     if (this.dirty || other.dirty) return false;
     const propertiesSame = this.isDecal === other.isDecal && this.transparent === other.transparent && Math.round(this.transparency * 100) === Math.round(other.transparency * 100) && this.doubleSided === other.doubleSided && this.visible === other.visible && this.canHaveMipmaps === other.canHaveMipmaps;
@@ -45596,6 +45827,21 @@ class MaterialDesc {
     }
     return propertiesSame && layersSame;
   }
+  needsRegeneration(other) {
+    if (this.dirty || other.dirty) return true;
+    const propertiesSame = this.isDecal === other.isDecal && this.doubleSided === other.doubleSided && this.visible === other.visible && this.canHaveMipmaps === other.canHaveMipmaps;
+    let layersSame = true;
+    if (this.layers.length !== other.layers.length) {
+      layersSame = false;
+    } else {
+      for (let i = 0; i < this.layers.length; i++) {
+        const thisLayer = this.layers[i];
+        const otherLayer = other.layers[i];
+        layersSame = layersSame && thisLayer.isSame(otherLayer);
+      }
+    }
+    return !propertiesSame || !layersSame;
+  }
   getTexturesOfType(textureType) {
     const urls = [];
     for (const layer of this.layers) {
@@ -46037,6 +46283,16 @@ class MaterialDesc {
         return this.compileTexture_DirectCompose(textureType);
     }
   }
+  hasTransparency() {
+    let hasTransparency = this.transparent;
+    if (this.noTextureTransparency) {
+      hasTransparency = false;
+    }
+    if (this.transparency > 0.01) {
+      hasTransparency = true;
+    }
+    return hasTransparency;
+  }
   async compileMaterial(meshDesc) {
     const colorTexturePromise = this.compileTexture("color", meshDesc);
     const normalTexturePromise = this.compileTexture("normal", meshDesc);
@@ -46050,11 +46306,10 @@ class MaterialDesc {
     let metalnessTexture = void 0;
     let emissiveTexture = void 0;
     let hasEmissive = false;
-    let hasTransparency = this.transparent;
     if (colorTextureInfo) {
       colorTexture = colorTextureInfo[0];
       if (!colorTextureInfo[1]) {
-        hasTransparency = false;
+        this.noTextureTransparency = true;
       }
     }
     if (normalTextureInfo) {
@@ -46072,9 +46327,7 @@ class MaterialDesc {
         hasEmissive = true;
       }
     }
-    if (this.transparency > 0.01) {
-      hasTransparency = true;
-    }
+    const hasTransparency = this.hasTransparency();
     let material = void 0;
     const textureTemplate = {};
     if (colorTexture) textureTemplate.map = colorTexture;
@@ -46115,8 +46368,27 @@ class MaterialDesc {
         depthWrite: this.transparency > 0 ? false : true
       });
     }
+    this.result = material;
     return material;
   }
+  fromMaterialDesc(other) {
+    this.transparency = other.transparency;
+    this.transparent = other.transparent;
+  }
+  updateTransparency() {
+    if (this.result) {
+      const ogHasTransparency = this.result.transparent;
+      this.result.transparent = this.hasTransparency();
+      this.result.opacity = 1 - this.transparency;
+      this.result.depthWrite = this.transparency > 0 ? false : true;
+      if (ogHasTransparency !== this.result.transparent) {
+        this.result.needsUpdate = true;
+      }
+    }
+  }
+  updateResult() {
+    this.updateTransparency();
+  }
   addClothingLayers(parent) {
     const pants = parent.FindFirstChildOfClass("Pants");
     if (pants) {
@@ -46823,12 +47095,13 @@ class ObjectDesc extends RenderDesc {
     if (this.meshDesc.layerDesc && Date.now() / 1e3 - this.meshDesc.compilationTimestamp < FLAGS.LAYERED_CLOTHING_COOLDOWN) {
       return false;
     }
-    return !this.meshDesc.isSame(other.meshDesc) || !this.materialDesc.isSame(other.materialDesc);
+    return !this.meshDesc.isSame(other.meshDesc) || this.materialDesc.needsRegeneration(other.materialDesc);
   }
   virtualFromRenderDesc(other) {
     this.cframe = other.cframe;
     this.size = other.size;
     this.isBodyPart = other.isBodyPart;
+    this.materialDesc.fromMaterialDesc(other.materialDesc);
   }
   fromInstance(child) {
     this.instance = child;
@@ -47008,6 +47281,9 @@ class ObjectDesc extends RenderDesc {
         }
       }
     }
+    if (this.materialDesc.result) {
+      this.materialDesc.updateResult();
+    }
   }
   static shouldRenderInstance(instance) {
     const isDecal = instance.className === "Decal";
@@ -51253,6 +51529,9 @@ class SoundWrapper extends InstanceWrapper {
       this.data.gainNode = void 0;
       this.data.buffer = void 0;
     });
+    this.instance.Changed.Connect(() => {
+      this._updateVolume();
+    });
   }
   _updateVolume() {
     if (this.data.gainNode) {
@@ -52892,7 +53171,7 @@ function zoomExtents(cameraCFrame, modelCFrame, modelSize, targetFOV, distanceSc
   if (sizeType === "calculate") {
     largestSize = modelSize.magnitude() / 2 / Math.sin(rad(targetFOV / 2));
   }
-  const fovMultiplier = 70 / targetFOV;
+  const fovMultiplier = sizeType === "largestAxis" ? 70 / targetFOV : 1;
   const lookDir = multiply(normalize(minus(cameraCFrame.Position, modelCFrame.Position)), [distanceScale, distanceScale, distanceScale]);
   cameraCFrame.Position = add(modelCFrame.Position, multiply(multiply(lookDir, [largestSize, largestSize, largestSize]), [fovMultiplier, fovMultiplier, fovMultiplier]));
 }
@@ -52991,7 +53270,7 @@ function getCameraCFrameForAvatarNonCustomized(rig) {
   zoomExtents(cameraCF, rootPartCF, extentsSize, 70, 1);
   return cameraCF;
 }
-function getThumbnailCameraCFrame(model) {
+function getThumbnailCameraCFrame(model, fov2, forceAngle) {
   const thumbnailCamera = model.FindFirstChildOfClass("Camera");
   if (thumbnailCamera) return thumbnailCamera.PropOrDefault("CFrame", new CFrame());
   let rootPart = model.PropOrDefault("PrimaryPart", void 0);
@@ -53011,14 +53290,18 @@ function getThumbnailCameraCFrame(model) {
     lookVector = normalize(lookVector);
   }
   let lookCF = CFrame.lookAt([0, 0, 0], lookVector);
-  lookCF = lookCF.multiply(CFrame.fromEulerAngles(0, 0, rad(45)));
-  lookCF = lookCF.multiply(CFrame.fromEulerAngles(rad(35), 0, 0));
-  lookCF = lookCF.multiply(CFrame.fromEulerAngles(0, 0, 0));
+  if (!forceAngle) {
+    lookCF = lookCF.multiply(CFrame.fromEulerAngles(0, 0, rad(45)));
+    lookCF = lookCF.multiply(CFrame.fromEulerAngles(rad(35), 0, 0));
+    lookCF = lookCF.multiply(CFrame.fromEulerAngles(0, 0, 0));
+  } else {
+    lookCF = lookCF.multiply(CFrame.fromEulerAngles(rad(forceAngle[0]), rad(forceAngle[1]), rad(forceAngle[2])));
+  }
   lookVector = lookCF.lookVector();
   lookCF.Position = add(rootPartCF.Position, multiply([10, 10, 10], lookVector));
   lookCF = CFrame.lookAt(lookCF.Position, rootPartCF.Position);
   const cameraCF = lookCF.clone();
-  zoomExtents(cameraCF, rootPartCF, extentsSize, 70, 1);
+  zoomExtents(cameraCF, rootPartCF, extentsSize, fov2, 1);
   return cameraCF;
 }
 class OutfitRenderer {
@@ -53281,7 +53564,7 @@ async function renderTargetToCanvas(renderTarget) {
 }
 async function generateModelThumbnail(auth, renderScene, model, size = [150, 150], type = "png", quality = 1, gltfAutoDownload = false, includeAnimations = false) {
   return new Promise((resolve) => {
-    const cameraCFrame = getThumbnailCameraCFrame(model);
+    const cameraCFrame = getThumbnailCameraCFrame(model, renderScene.camera.fov);
     if (cameraCFrame) {
       RBXRenderer.setCameraCFrame(cameraCFrame, renderScene);
     }
@@ -53319,11 +53602,54 @@ async function generateModelThumbnail(auth, renderScene, model, size = [150, 150
     }
   });
 }
-async function generateOutfitThumbnail(auth, outfit, size = [150, 150], type = "png", quality = 1, gltfAutoDownload = false, includeAnimations = false) {
+async function generateOutfitModelThumbnail(auth, outfitModel, options) {
+  const defaultOptions = {
+    size: [150, 150],
+    type: "png",
+    quality: 1,
+    gltfAutoDownload: false,
+    includeAnimations: false
+  };
+  Object.assign(defaultOptions, options);
+  const renderScene = RBXRenderer.addScene();
+  setupThumbnailScene(renderScene);
+  if (outfitModel.background?.id) {
+    const avatarCycloramaRBX = await API.Asset.GetRBX("roavatar://AvatarCyclorama.rbxm");
+    if (avatarCycloramaRBX instanceof Response) return void 0;
+    const avatarCycloramaRoot = avatarCycloramaRBX.generateTree();
+    const avatarCyclorama = avatarCycloramaRoot.GetChildren()[0];
+    if (avatarCyclorama) {
+      const backgroundDataRBX = await API.Asset.GetRBX("rbxassetid://" + outfitModel.background.id);
+      if (backgroundDataRBX instanceof Response) return void 0;
+      const backgroundDataRoot = backgroundDataRBX.generateTree();
+      const backgroundData = backgroundDataRoot.GetChildren()[0];
+      if (backgroundData) {
+        if (backgroundData) {
+          const colorValue = backgroundData.Child("Color");
+          const imageIdValue = backgroundData.Child("ImageId");
+          if (colorValue && imageIdValue) {
+            const color = colorValue.Prop("Value");
+            const imageId = imageIdValue.Prop("Value");
+            avatarCyclorama.Child("color_mesh").setProperty("Color", color.toColor3uint8());
+            avatarCyclorama.Child("texture_mesh").setProperty("TextureID", `rbxassetid://${imageId}`);
+            avatarCyclorama.preRender();
+            RBXRenderer.addInstance(avatarCyclorama, auth, renderScene);
+            renderScene.camera.fov = 30;
+            renderScene.camera.updateProjectionMatrix();
+          }
+        }
+      }
+    }
+  }
+  return generateOutfitThumbnail(auth, outfitModel.outfit, defaultOptions.size, defaultOptions.type, defaultOptions.quality, defaultOptions.gltfAutoDownload, defaultOptions.includeAnimations, renderScene);
+}
+async function generateOutfitThumbnail(auth, outfit, size = [150, 150], type = "png", quality = 1, gltfAutoDownload = false, includeAnimations = false, renderSceneParam) {
   return new Promise((resolve) => {
     const startTime = performance.now();
-    const renderScene = RBXRenderer.addScene();
-    setupThumbnailScene(renderScene);
+    const renderScene = renderSceneParam || RBXRenderer.addScene();
+    if (renderScene !== renderSceneParam) {
+      setupThumbnailScene(renderScene);
+    }
     const outfitRenderer = new OutfitRenderer(auth, outfit, renderScene);
     outfitRenderer.doAddInstance = false;
     if (outfit.playerAvatarType === AvatarType.R6) outfitRenderer.deltaTimeMultiplier = 0;
@@ -53406,6 +53732,7 @@ export {
   AllAccessorySorts,
   AllAnimationSorts,
   AllAnimations,
+  AllAvatarModelOutfitUpdateTypes,
   AllBodyParts,
   AllBodyPartsSorts,
   AllCharacterSorts,
@@ -53502,6 +53829,7 @@ export {
   NumberSequence,
   NumberSequenceKeypoint,
   Outfit,
+  OutfitModel,
   OutfitOrigin,
   OutfitRenderer,
   PartType,
@@ -53536,6 +53864,7 @@ export {
   SpecialInfo,
   SpecialLayeredAssetTypes,
   StringBufferProperties,
+  ThumbnailCustomization,
   ToRemoveBeforeBundleType,
   ToolWrapper,
   UDim,
@@ -53593,6 +53922,7 @@ export {
   floor,
   gaussian_rbf,
   generateModelThumbnail,
+  generateOutfitModelThumbnail,
   generateOutfitThumbnail,
   generateUUIDv4,
   getCameraCFrameForAvatarNonCustomized,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roavatar-renderer",
-  "version": "1.5.17",
+  "version": "1.5.18",
   "description": "A renderer for Roblox avatars, used by the RoAvatar extension.",
   "author": "steinan",
   "type": "module",