minerender 2.1.0-alpha.131 → 2.1.0-alpha.132

package/dist/browser/esm/entity/scene/EntityAnimationPlayer.mjs

@@ -1,16 +1,24 @@
 // src/entity/scene/EntityAnimationPlayer.ts
 import { Euler, Vector3 } from "three";
-import { sampleEntityAnimation } from "../EntityAnimation.mjs";
+import { ENTITY_ANIMATION_CHANNELS, sampleEntityAnimation } from "../EntityAnimation.mjs";
 var ZERO = [0, 0, 0];
 var EntityAnimationPlayer = class {
   constructor() {
     this.parts = [];
+    this._animations = [];
+    this._weights = [];
+    this.loops = [];
     this._time = 0;
-    this.loop = false;
     this.speed = 1;
   }
   get animation() {
-    return this._animation;
+    return this._animations[0];
+  }
+  get animations() {
+    return this._animations.slice();
+  }
+  get weights() {
+    return this._weights.slice();
   }
   get time() {
     return this._time;
@@ -20,10 +28,20 @@ var EntityAnimationPlayer = class {
    * without them, the current pose is used. Stopping restores the pose from before playback.
    */
   play(layers, animation, options = {}, poses) {
+    this.playAnimations(layers, [animation], options, poses);
+  }
+  /**
+   * Starts clips on matching parts with a shared clock. Weighted offsets add to the supplied baked poses
+   * or, without poses, to each animated part's pose when playback starts.
+   */
+  playAnimations(layers, animations, options = {}, poses) {
+    const weights = validateAnimationWeights(options.weights ?? animations.map(() => 1), animations.length);
     this.stop();
-    this._animation = animation;
+    this._animations = animations.slice();
+    this._weights = weights;
+    if (!animations.length) return;
     this._time = options.time ?? 0;
-    this.loop = options.loop ?? animation.loop;
+    this.loops = animations.map((animation) => options.loop ?? animation.loop);
     this.speed = options.speed ?? 1;
     for (const layer of layers) {
       const objects = [];
@@ -32,7 +50,8 @@ var EntityAnimationPlayer = class {
           if (poses.has(object)) objects.push(object);
         });
       } else {
-        for (const bone of Object.keys(animation.bones)) {
+        const bones = new Set(animations.flatMap((animation) => Object.keys(animation.bones)));
+        for (const bone of bones) {
           const object = layer.getObjectByName(`group:${bone}`);
           if (object) objects.push(object);
         }
@@ -56,7 +75,7 @@ var EntityAnimationPlayer = class {
   }
   /** Restores the poses from before playback. Returns whether an animation was active. */
   stop() {
-    if (!this._animation) return false;
+    if (!this._animations.length) return false;
     for (const part of this.parts) {
       part.object.position.copy(part.position);
       part.object.rotation.copy(part.rotation);
@@ -68,12 +87,14 @@ var EntityAnimationPlayer = class {
   /** Forgets the animation without touching the parts, for parts that no longer exist. */
   clear() {
     this.parts = [];
-    this._animation = void 0;
+    this._animations = [];
+    this._weights = [];
+    this.loops = [];
     this._time = 0;
   }
   /** Applies the pose at an absolute playback time. Returns `false` when no clip is active. */
   setTime(seconds) {
-    if (!this._animation) return false;
+    if (!this._animations.length) return false;
     this._time = seconds;
     this.apply();
     return true;
@@ -82,8 +103,30 @@ var EntityAnimationPlayer = class {
   advance(deltaSeconds) {
     return this.setTime(this._time + deltaSeconds * this.speed);
   }
+  /** Changes weights in clip order and reapplies the current time without restarting playback. */
+  setWeights(weights) {
+    if (!this._animations.length) return false;
+    const validated = validateAnimationWeights(weights, this._animations.length);
+    this._weights = validated;
+    this.apply();
+    return true;
+  }
   apply() {
-    const pose = sampleEntityAnimation(this._animation, this._time, this.loop);
+    const pose = /* @__PURE__ */ Object.create(null);
+    for (let i = 0; i < this._animations.length; i++) {
+      const weight = this._weights[i];
+      if (weight === 0) continue;
+      const sampled = sampleEntityAnimation(this._animations[i], this._time, this.loops[i]);
+      for (const [bone, channels] of Object.entries(sampled)) {
+        const blended = pose[bone] ?? (pose[bone] = {});
+        for (const channel of ENTITY_ANIMATION_CHANNELS) {
+          const value = channels[channel];
+          if (!value) continue;
+          const target = blended[channel] ?? (blended[channel] = [0, 0, 0]);
+          for (let axis = 0; axis < 3; axis++) target[axis] += value[axis] * weight;
+        }
+      }
+    }
     for (const part of this.parts) {
       const { position = ZERO, rotation = ZERO, scale = ZERO } = pose[part.bone] ?? {};
       part.object.position.set(part.basePosition.x + position[0], part.basePosition.y + position[1], part.basePosition.z + position[2]);
@@ -92,7 +135,15 @@ var EntityAnimationPlayer = class {
     }
   }
 };
+function validateAnimationWeights(weights, count) {
+  const values = Array.from(weights);
+  if (values.length !== count || values.some((weight) => !Number.isFinite(weight) || weight < 0)) {
+    throw new Error("Animation weights must match the clip count and contain only finite nonnegative numbers");
+  }
+  return values;
+}
 export {
-  EntityAnimationPlayer
+  EntityAnimationPlayer,
+  validateAnimationWeights
 };
 //# sourceMappingURL=EntityAnimationPlayer.mjs.map

package/dist/browser/esm/entity/scene/EntityAnimationPlayer.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/entity/scene/EntityAnimationPlayer.ts"],"sourcesContent":["import { Euler, Vector3 } from \"three\";\nimport type { Object3D } from \"three\";\nimport { EntityAnimation, sampleEntityAnimation } from \"../EntityAnimation\";\nimport type { EntityModelPart } from \"../EntityModel\";\n\n/** Playback settings passed to {@link EntityObject.playAnimation}, {@link EntityObject.playAnimations}, or {@link EntityAnimationPlayer.play}. */\nexport interface EntityAnimationOptions {\n    /** Overrides the animation's own `loop` flag. */\n    loop?: boolean;\n    /** Playback rate applied to advanced time; defaults to 1. */\n    speed?: number;\n    /** Start time in seconds; defaults to 0. */\n    time?: number;\n}\n\nconst ZERO: readonly number[] = [0, 0, 0];\n\ninterface AnimatedPart {\n    bone: string;\n    object: Object3D;\n    position: Vector3;\n    rotation: Euler;\n    scale: Vector3;\n    basePosition: Vector3;\n    baseRotation: Euler;\n    baseScale: Vector3;\n}\n\n/**\n * Poses part groups from a keyframe animation the way vanilla does: every update restores the\n * default pose of each animated part, then adds the sampled offsets to its position, Euler angles and scale.\n * It owns no timer; the owner advances it.\n */\nexport class EntityAnimationPlayer {\n\n    private parts: AnimatedPart[] = [];\n    private _animation?: EntityAnimation;\n    private _time = 0;\n    private loop = false;\n    private speed = 1;\n\n    get animation(): EntityAnimation | undefined {\n        return this._animation;\n    }\n\n    get time(): number {\n        return this._time;\n    }\n\n    /**\n     * Starts an animation on matching named parts. Supplied baked poses are the baseline for offsets;\n     * without them, the current pose is used. Stopping restores the pose from before playback.\n     */\n    play(layers: Object3D[], animation: EntityAnimation, options: EntityAnimationOptions = {},\n         poses?: ReadonlyMap<Object3D, EntityModelPart[\"pose\"]>): void {\n        this.stop();\n        this._animation = animation;\n        this._time = options.time ?? 0;\n        this.loop = options.loop ?? animation.loop;\n        this.speed = options.speed ?? 1;\n        for (const layer of layers) {\n            const objects: Object3D[] = [];\n            if (poses) {\n                layer.traverse(object => { if (poses.has(object)) objects.push(object); });\n            } else {\n                for (const bone of Object.keys(animation.bones)) {\n                    const object = layer.getObjectByName(`group:${bone}`);\n                    if (object) objects.push(object);\n                }\n            }\n            for (const object of objects) {\n                const bone = object.name.slice(\"group:\".length);\n                const pose = poses?.get(object);\n                this.parts.push({\n                    bone, object, position: object.position.clone(), rotation: object.rotation.clone(), scale: object.scale.clone(),\n                    basePosition: pose ? new Vector3(...pose.offset) : object.position.clone(),\n                    baseRotation: pose ? new Euler(...pose.rotation, \"ZYX\") : object.rotation.clone(),\n                    baseScale: pose ? new Vector3(...(pose.scale ?? [1, 1, 1])) : object.scale.clone()\n                });\n            }\n        }\n        this.apply();\n    }\n\n    /** Restores the poses from before playback. Returns whether an animation was active. */\n    stop(): boolean {\n        if (!this._animation) return false;\n        for (const part of this.parts) {\n            part.object.position.copy(part.position);\n            part.object.rotation.copy(part.rotation);\n            part.object.scale.copy(part.scale);\n        }\n        this.clear();\n        return true;\n    }\n\n    /** Forgets the animation without touching the parts, for parts that no longer exist. */\n    clear(): void {\n        this.parts = [];\n        this._animation = undefined;\n        this._time = 0;\n    }\n\n    /** Applies the pose at an absolute playback time. Returns `false` when no clip is active. */\n    setTime(seconds: number): boolean {\n        if (!this._animation) return false;\n        this._time = seconds;\n        this.apply();\n        return true;\n    }\n\n    /** Advances playback by elapsed seconds multiplied by the speed passed to {@link play}. */\n    advance(deltaSeconds: number): boolean {\n        return this.setTime(this._time + deltaSeconds * this.speed);\n    }\n\n    private apply(): void {\n        const pose = sampleEntityAnimation(this._animation!, this._time, this.loop);\n        for (const part of this.parts) {\n            const { position = ZERO, rotation = ZERO, scale = ZERO } = pose[part.bone] ?? {};\n            part.object.position.set(part.basePosition.x + position[0], part.basePosition.y + position[1], part.basePosition.z + position[2]);\n            // Vanilla adds to the Euler angles themselves, so the part keeps its rotation order.\n            part.object.rotation.set(part.baseRotation.x + rotation[0], part.baseRotation.y + rotation[1], part.baseRotation.z + rotation[2], part.baseRotation.order);\n            part.object.scale.set(part.baseScale.x + scale[0], part.baseScale.y + scale[1], part.baseScale.z + scale[2]);\n        }\n    }\n\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/entity/scene/EntityAnimationPlayer.ts"],"sourcesContent":["import { Euler, Vector3 } from \"three\";\nimport type { Object3D } from \"three\";\nimport { ENTITY_ANIMATION_CHANNELS, EntityAnimation, sampleEntityAnimation } from \"../EntityAnimation\";\nimport type { EntityAnimationPose } from \"../EntityAnimation\";\nimport type { EntityModelPart } from \"../EntityModel\";\n\n/** Playback settings passed to {@link EntityObject.playAnimation}, {@link EntityObject.playAnimations}, or {@link EntityAnimationPlayer.play}. */\nexport interface EntityAnimationOptions {\n    /** Overrides the animation's own `loop` flag. */\n    loop?: boolean;\n    /** Playback rate applied to advanced time; defaults to 1. */\n    speed?: number;\n    /** Start time in seconds; defaults to 0. */\n    time?: number;\n    /** Nonnegative finite weights in clip order; defaults to 1 per clip. Offsets add without normalizing weights. */\n    weights?: readonly number[];\n}\n\nconst ZERO: readonly number[] = [0, 0, 0];\n\ninterface AnimatedPart {\n    bone: string;\n    object: Object3D;\n    position: Vector3;\n    rotation: Euler;\n    scale: Vector3;\n    basePosition: Vector3;\n    baseRotation: Euler;\n    baseScale: Vector3;\n}\n\n/**\n * Poses part groups from keyframe animations: every update restores the default pose of each\n * animated part, then adds weighted sampled offsets to its position, Euler angles and scale.\n * It owns no timer; the owner advances it.\n */\nexport class EntityAnimationPlayer {\n\n    private parts: AnimatedPart[] = [];\n    private _animations: EntityAnimation[] = [];\n    private _weights: number[] = [];\n    private loops: boolean[] = [];\n    private _time = 0;\n    private speed = 1;\n\n    get animation(): EntityAnimation | undefined {\n        return this._animations[0];\n    }\n\n    get animations(): readonly EntityAnimation[] {\n        return this._animations.slice();\n    }\n\n    get weights(): readonly number[] {\n        return this._weights.slice();\n    }\n\n    get time(): number {\n        return this._time;\n    }\n\n    /**\n     * Starts an animation on matching named parts. Supplied baked poses are the baseline for offsets;\n     * without them, the current pose is used. Stopping restores the pose from before playback.\n     */\n    play(layers: Object3D[], animation: EntityAnimation, options: EntityAnimationOptions = {},\n         poses?: ReadonlyMap<Object3D, EntityModelPart[\"pose\"]>): void {\n        this.playAnimations(layers, [animation], options, poses);\n    }\n\n    /**\n     * Starts clips on matching parts with a shared clock. Weighted offsets add to the supplied baked poses\n     * or, without poses, to each animated part's pose when playback starts.\n     */\n    playAnimations(layers: Object3D[], animations: readonly EntityAnimation[], options: EntityAnimationOptions = {},\n                   poses?: ReadonlyMap<Object3D, EntityModelPart[\"pose\"]>): void {\n        const weights = validateAnimationWeights(options.weights ?? animations.map(() => 1), animations.length);\n        this.stop();\n        this._animations = animations.slice();\n        this._weights = weights;\n        if (!animations.length) return;\n        this._time = options.time ?? 0;\n        this.loops = animations.map(animation => options.loop ?? animation.loop);\n        this.speed = options.speed ?? 1;\n        for (const layer of layers) {\n            const objects: Object3D[] = [];\n            if (poses) {\n                layer.traverse(object => { if (poses.has(object)) objects.push(object); });\n            } else {\n                const bones = new Set(animations.flatMap(animation => Object.keys(animation.bones)));\n                for (const bone of bones) {\n                    const object = layer.getObjectByName(`group:${bone}`);\n                    if (object) objects.push(object);\n                }\n            }\n            for (const object of objects) {\n                const bone = object.name.slice(\"group:\".length);\n                const pose = poses?.get(object);\n                this.parts.push({\n                    bone, object, position: object.position.clone(), rotation: object.rotation.clone(), scale: object.scale.clone(),\n                    basePosition: pose ? new Vector3(...pose.offset) : object.position.clone(),\n                    baseRotation: pose ? new Euler(...pose.rotation, \"ZYX\") : object.rotation.clone(),\n                    baseScale: pose ? new Vector3(...(pose.scale ?? [1, 1, 1])) : object.scale.clone()\n                });\n            }\n        }\n        this.apply();\n    }\n\n    /** Restores the poses from before playback. Returns whether an animation was active. */\n    stop(): boolean {\n        if (!this._animations.length) return false;\n        for (const part of this.parts) {\n            part.object.position.copy(part.position);\n            part.object.rotation.copy(part.rotation);\n            part.object.scale.copy(part.scale);\n        }\n        this.clear();\n        return true;\n    }\n\n    /** Forgets the animation without touching the parts, for parts that no longer exist. */\n    clear(): void {\n        this.parts = [];\n        this._animations = [];\n        this._weights = [];\n        this.loops = [];\n        this._time = 0;\n    }\n\n    /** Applies the pose at an absolute playback time. Returns `false` when no clip is active. */\n    setTime(seconds: number): boolean {\n        if (!this._animations.length) return false;\n        this._time = seconds;\n        this.apply();\n        return true;\n    }\n\n    /** Advances playback by elapsed seconds multiplied by the speed passed to {@link play}. */\n    advance(deltaSeconds: number): boolean {\n        return this.setTime(this._time + deltaSeconds * this.speed);\n    }\n\n    /** Changes weights in clip order and reapplies the current time without restarting playback. */\n    setWeights(weights: readonly number[]): boolean {\n        if (!this._animations.length) return false;\n        const validated = validateAnimationWeights(weights, this._animations.length);\n        this._weights = validated;\n        this.apply();\n        return true;\n    }\n\n    private apply(): void {\n        const pose: EntityAnimationPose = Object.create(null);\n        for (let i = 0; i < this._animations.length; i++) {\n            const weight = this._weights[i];\n            if (weight === 0) continue;\n            const sampled = sampleEntityAnimation(this._animations[i], this._time, this.loops[i]);\n            for (const [bone, channels] of Object.entries(sampled)) {\n                const blended = pose[bone] ??= {};\n                for (const channel of ENTITY_ANIMATION_CHANNELS) {\n                    const value = channels[channel];\n                    if (!value) continue;\n                    const target = blended[channel] ??= [0, 0, 0];\n                    for (let axis = 0; axis < 3; axis++) target[axis] += value[axis] * weight;\n                }\n            }\n        }\n        for (const part of this.parts) {\n            const { position = ZERO, rotation = ZERO, scale = ZERO } = pose[part.bone] ?? {};\n            part.object.position.set(part.basePosition.x + position[0], part.basePosition.y + position[1], part.basePosition.z + position[2]);\n            // Vanilla adds to the Euler angles themselves, so the part keeps its rotation order.\n            part.object.rotation.set(part.baseRotation.x + rotation[0], part.baseRotation.y + rotation[1], part.baseRotation.z + rotation[2], part.baseRotation.order);\n            part.object.scale.set(part.baseScale.x + scale[0], part.baseScale.y + scale[1], part.baseScale.z + scale[2]);\n        }\n    }\n\n}\n\n/** @internal */\nexport function validateAnimationWeights(weights: readonly number[], count: number): number[] {\n    const values = Array.from(weights);\n    if (values.length !== count || values.some(weight => !Number.isFinite(weight) || weight < 0)) {\n        throw new Error(\"Animation weights must match the clip count and contain only finite nonnegative numbers\");\n    }\n    return values;\n}\n"],"mappings":"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","names":[]}

package/dist/browser/esm/entity/scene/EntityObject.mjs

@@ -11,7 +11,7 @@ import { Materials } from "../../Materials.mjs";
 import { MinecraftCubeTexture } from "../../MinecraftCubeTexture.mjs";
 import { CUBE_FACES } from "../../CubeFace.mjs";
 import { isMesh } from "../../util/three.mjs";
-import { EntityAnimationPlayer } from "./EntityAnimationPlayer.mjs";
+import { EntityAnimationPlayer, validateAnimationWeights } from "./EntityAnimationPlayer.mjs";
 var _EntityObject = class _EntityObject extends SceneObject {
   constructor(entity, options) {
     super();
@@ -49,7 +49,7 @@ var _EntityObject = class _EntityObject extends SceneObject {
     for (const geometry of this.geometries) geometry.dispose();
     this.geometries.clear();
     for (const dispose of this.disposeWireframes.splice(0)) dispose();
-    for (const player of this.animationPlayers.splice(0)) player.clear();
+    for (const { player } of this.animationPlayers.splice(0)) player.clear();
     this.partPoses.clear();
     super.disposeAndRemoveAllChildren();
   }
@@ -84,15 +84,31 @@ var _EntityObject = class _EntityObject extends SceneObject {
   //<editor-fold desc="ANIMATION">
   /** The first active clip, until playback is stopped or the object is disposed. */
   get animation() {
-    return this.animationPlayers[0]?.animation;
+    return this.animationPlayers[0]?.player.animation;
   }
-  /** Clips playing together, each targeting a separate geometry layer. */
+  /** Clips playing together, in the order passed to {@link playAnimations}. */
   get activeAnimations() {
-    return this.animationPlayers.map((player) => player.animation);
+    const animations = [];
+    for (const { player, indices } of this.animationPlayers) {
+      player.animations.forEach((animation, i) => {
+        animations[indices[i]] = animation;
+      });
+    }
+    return animations;
+  }
+  /** Weights of the active clips, in the same order as {@link activeAnimations}. */
+  get animationWeights() {
+    const weights = [];
+    for (const { player, indices } of this.animationPlayers) {
+      player.weights.forEach((weight, i) => {
+        weights[indices[i]] = weight;
+      });
+    }
+    return weights;
   }
   /** Seconds since the animation started, before looping. */
   get animationTime() {
-    return this.animationPlayers[0]?.time ?? 0;
+    return this.animationPlayers[0]?.player.time ?? 0;
   }
   /**
    * Plays a clip from {@link Entities.getAnimations}, replacing all active clips.
@@ -103,42 +119,59 @@ var _EntityObject = class _EntityObject extends SceneObject {
   playAnimation(animation, options) {
     this.playAnimations([animation], options);
   }
-  /** Plays clips with a shared clock and no blending. Selected layers without their own clip follow `main`. */
+  /**
+   * Plays clips with a shared clock, adding their weighted offsets within each geometry layer.
+   * Weights default to 1 and are not normalized. Selected layers without their own clip follow `main`.
+   */
   playAnimations(animations, options) {
-    const targets = /* @__PURE__ */ new Set();
-    const selections = animations.map((animation) => {
+    const weights = validateAnimationWeights(options?.weights ?? animations.map(() => 1), animations.length);
+    const selections = /* @__PURE__ */ new Map();
+    animations.forEach((animation, index) => {
       const layer = animation.layer ?? "main";
-      if (targets.has(layer)) throw new Error(`Multiple animations target layer "${layer}"`);
-      targets.add(layer);
       const names = Object.keys(this.entityLayers).filter((name) => name.split("#")[0] === layer);
       if (!names.length) throw new Error(`Entity ${this.entity.id} has no selected animation layer "${layer}"`);
-      return { animation, names };
+      let selection = selections.get(layer);
+      if (!selection) selections.set(layer, selection = { animations: [], names, indices: [] });
+      selection.animations.push(animation);
+      selection.indices.push(index);
     });
-    const main = selections.find(({ animation }) => (animation.layer ?? "main") === "main");
-    if (main) main.names.push(...Object.keys(this.entityLayers).filter((name) => !targets.has(name.split("#")[0])));
+    const main = selections.get("main");
+    if (main) main.names.push(...Object.keys(this.entityLayers).filter((name) => !selections.has(name.split("#")[0])));
     this.createMeshes();
     this.stopAnimation();
-    for (const { animation, names } of selections) {
+    for (const { animations: clips, names, indices } of selections.values()) {
       const player = new EntityAnimationPlayer();
-      player.play(names.map((name) => this.getLayerGroup(name)), animation, options, this.partPoses);
-      this.animationPlayers.push(player);
+      player.playAnimations(
+        names.map((name) => this.getLayerGroup(name)),
+        clips,
+        { ...options, weights: indices.map((index) => weights[index]) },
+        this.partPoses
+      );
+      this.animationPlayers.push({ player, indices });
     }
     this.notifyDirty();
   }
+  /** Changes weights in active clip order, notifying the scene without restarting the shared clock. Has no effect without an animation. */
+  setAnimationWeights(weights) {
+    if (!this.animationPlayers.length) return;
+    const values = validateAnimationWeights(weights, this.activeAnimations.length);
+    for (const { player, indices } of this.animationPlayers) player.setWeights(indices.map((index) => values[index]));
+    this.notifyDirty();
+  }
   /** Stops all clips and restores the poses from before playback. */
   stopAnimation() {
     const players = this.animationPlayers.splice(0);
-    for (const player of players) player.stop();
+    for (const { player } of players) player.stop();
     if (players.length) this.notifyDirty();
   }
   /** Poses the object at an explicit time in seconds. Has no effect without an animation. */
   setAnimationTime(seconds) {
-    for (const player of this.animationPlayers) player.setTime(seconds);
+    for (const { player } of this.animationPlayers) player.setTime(seconds);
     if (this.animationPlayers.length) this.notifyDirty();
   }
   /** Advances the animation by a frame delta in seconds, scaled by its speed. Has no effect without an animation. */
   advanceAnimation(deltaSeconds) {
-    for (const player of this.animationPlayers) player.advance(deltaSeconds);
+    for (const { player } of this.animationPlayers) player.advance(deltaSeconds);
     if (this.animationPlayers.length) this.notifyDirty();
   }
   //</editor-fold>

package/dist/browser/esm/entity/scene/EntityObject.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/entity/scene/EntityObject.ts"],"sourcesContent":["import { SceneObject } from \"../../renderer/SceneObject\";\nimport { SceneObjectOptions } from \"../../renderer/SceneObjectOptions\";\nimport { Caching } from \"../../cache/Caching\";\nimport { merge } from \"../../util/_internal/merge\";\nimport { Color, Object3D } from \"three\";\nimport type { BufferGeometry, ColorRepresentation, Material, Mesh, MeshBasicMaterial } from \"three\";\nimport { Ticker } from \"../../Ticker\";\nimport { addWireframeToMesh } from \"../../util/model\";\nimport { ModelTextures } from \"../../assets/ModelTextures\";\nimport { AssetKey, isAssetKey } from \"../../assets/AssetKey\";\nimport { ExtractableImageData } from \"../../ExtractableImageData\";\nimport { Materials } from \"../../Materials\";\nimport { MinecraftCubeTexture } from \"../../MinecraftCubeTexture\";\nimport { CUBE_FACES, CubeFace } from \"../../CubeFace\";\nimport { EntityLayer, EntityModel, EntityModelPart } from \"../EntityModel\";\nimport type { DoubleArray } from \"../../model/Model\";\nimport type { Maybe } from \"../../util/util\";\nimport { isMesh } from \"../../util/three\";\nimport type { EntityAnimation } from \"../EntityAnimation\";\nimport { EntityAnimationOptions, EntityAnimationPlayer } from \"./EntityAnimationPlayer\";\n\n/** Renders selected entity layers as named part groups. Create it through {@link MineRenderScene.addEntity}. */\nexport class EntityObject extends SceneObject {\n\n    public readonly isEntityObject: true = true;\n\n    public static readonly DEFAULT_OPTIONS: EntityObjectOptions = merge({}, SceneObject.DEFAULT_OPTIONS);\n    public readonly options: EntityObjectOptions;\n\n    private meshesCreated: boolean = false;\n    private readonly geometries = new Set<BufferGeometry>();\n    private readonly disposeWireframes: (() => void)[] = [];\n    /** Scrolling materials are owned: their texture offset follows this entity's age. */\n    private readonly scrollMaterials: { material: Material, offset: { set(x: number, y: number): unknown }, speed: [number, number] }[] = [];\n    private scrollTicker: Maybe<number>;\n    /** Entity age in ticks, as vanilla's `ageInTicks`; drives the scrolling render modes. */\n    public age: number = 0;\n    private readonly animationPlayers: EntityAnimationPlayer[] = [];\n    private readonly partPoses = new Map<Object3D, EntityModelPart[\"pose\"]>();\n\n    constructor(readonly entity: EntityModel, options?: Partial<EntityObjectOptions>) {\n        super();\n        this.options = merge({}, EntityObject.DEFAULT_OPTIONS, options ?? {});\n        this.addEventListener(\"added\", () => this.updateScrollSubscription());\n        this.addEventListener(\"removed\", () => this.updateScrollSubscription());\n    }\n\n    /** An optional shared material replaces texture loading for every selected draw; its owner retains disposal. */\n    async init(material?: Material): Promise<void> {\n        this.createMeshes();\n        if (material) {\n            this.clearScrollMaterials();\n            this.iterateAllMeshes(mesh => { mesh.material = material; });\n            this.notifyDirty();\n        } else await this.applyTextures();\n    }\n\n    dispose() {\n        super.dispose();\n    }\n\n    public disposeAndRemoveAllChildren() {\n        this.clearScrollMaterials();\n        for (const geometry of this.geometries) geometry.dispose();\n        this.geometries.clear();\n        for (const dispose of this.disposeWireframes.splice(0)) dispose();\n        // The animated part groups are removed with the children.\n        for (const player of this.animationPlayers.splice(0)) player.clear();\n        this.partPoses.clear();\n        super.disposeAndRemoveAllChildren();\n    }\n\n    private clearScrollMaterials() {\n        Ticker.remove(this.scrollTicker);\n        this.scrollTicker = undefined;\n        for (const { material } of this.scrollMaterials.splice(0)) {\n            (material as { map?: { dispose(): void } }).map?.dispose();\n            material.dispose();\n        }\n    }\n\n    private updateScrollSubscription() {\n        if (this.parent && this.scrollMaterials.length) {\n            if (this.scrollTicker === undefined) {\n                this.scrollTicker = Ticker.add(() => {\n                    this.age++;\n                    this.updateScroll();\n                });\n            }\n        } else {\n            Ticker.remove(this.scrollTicker);\n            this.scrollTicker = undefined;\n        }\n    }\n\n    /** Applies the entity age to the scrolling materials; the ticker calls this 20 times per second. */\n    private updateScroll() {\n        for (const { offset, speed } of this.scrollMaterials) {\n            // Texture V points up here and down in vanilla.\n            offset.set((this.age * speed[0]) % 1, 0 - (this.age * speed[1]) % 1);\n        }\n        this.notifyDirty();\n    }\n\n    //<editor-fold desc=\"ANIMATION\">\n\n    /** The first active clip, until playback is stopped or the object is disposed. */\n    public get animation(): Maybe<EntityAnimation> {\n        return this.animationPlayers[0]?.animation;\n    }\n\n    /** Clips playing together, each targeting a separate geometry layer. */\n    public get activeAnimations(): readonly EntityAnimation[] {\n        return this.animationPlayers.map(player => player.animation!);\n    }\n\n    /** Seconds since the animation started, before looping. */\n    public get animationTime(): number {\n        return this.animationPlayers[0]?.time ?? 0;\n    }\n\n    /**\n     * Plays a clip from {@link Entities.getAnimations}, replacing all active clips.\n     * Offsets apply to the baked pose in the clip's layer (`main` by default) and its repeated draws.\n     * A `main` clip also poses every selected layer without a clip of its own.\n     * The object owns no clock: call {@link advanceAnimation} per frame, or {@link setAnimationTime}.\n     */\n    public playAnimation(animation: EntityAnimation, options?: EntityAnimationOptions): void {\n        this.playAnimations([animation], options);\n    }\n\n    /** Plays clips with a shared clock and no blending. Selected layers without their own clip follow `main`. */\n    public playAnimations(animations: readonly EntityAnimation[], options?: EntityAnimationOptions): void {\n        const targets = new Set<string>();\n        const selections = animations.map(animation => {\n            const layer = animation.layer ?? \"main\";\n            if (targets.has(layer)) throw new Error(`Multiple animations target layer \"${layer}\"`);\n            targets.add(layer);\n            const names = Object.keys(this.entityLayers).filter(name => name.split(\"#\")[0] === layer);\n            if (!names.length) throw new Error(`Entity ${this.entity.id} has no selected animation layer \"${layer}\"`);\n            return { animation, names };\n        });\n        const main = selections.find(({ animation }) => (animation.layer ?? \"main\") === \"main\");\n        if (main) main.names.push(...Object.keys(this.entityLayers).filter(name => !targets.has(name.split(\"#\")[0])));\n        this.createMeshes();\n        this.stopAnimation();\n        for (const { animation, names } of selections) {\n            const player = new EntityAnimationPlayer();\n            player.play(names.map(name => this.getLayerGroup(name)!), animation, options, this.partPoses);\n            this.animationPlayers.push(player);\n        }\n        this.notifyDirty();\n    }\n\n    /** Stops all clips and restores the poses from before playback. */\n    public stopAnimation(): void {\n        const players = this.animationPlayers.splice(0);\n        for (const player of players) player.stop();\n        if (players.length) this.notifyDirty();\n    }\n\n    /** Poses the object at an explicit time in seconds. Has no effect without an animation. */\n    public setAnimationTime(seconds: number): void {\n        for (const player of this.animationPlayers) player.setTime(seconds);\n        if (this.animationPlayers.length) this.notifyDirty();\n    }\n\n    /** Advances the animation by a frame delta in seconds, scaled by its speed. Has no effect without an animation. */\n    public advanceAnimation(deltaSeconds: number): void {\n        for (const player of this.animationPlayers) player.advance(deltaSeconds);\n        if (this.animationPlayers.length) this.notifyDirty();\n    }\n\n    //</editor-fold>\n\n    /** Finds a selected draw by its layer key, such as `main` or `main#2`, or returns `undefined`. */\n    public getLayerGroup(name: string): Maybe<Object3D> {\n        return super.getGroupByName(`layer:${name}`);\n    }\n\n    /** Finds a part name without `group:`. Supply `layerName` to restrict the search to one draw. */\n    public getGroupByName(name: string, layerName?: string): Maybe<Object3D> {\n        return layerName === undefined ? super.getGroupByName(name)\n            : this.getLayerGroup(layerName)?.getObjectByName(`group:${name}`);\n    }\n\n    /** Finds a mesh name without `mesh:`. Supply `layerName` to restrict the search to one draw. */\n    public getMeshByName(name: string, layerName?: string): Maybe<Mesh> {\n        return layerName === undefined ? super.getMeshByName(name)\n            : this.getLayerGroup(layerName)?.getObjectByName(`mesh:${name}`) as Maybe<Mesh>;\n    }\n\n    private get entityLayers(): Record<string, EntityLayer> {\n        return this.entity.layers ?? { main: this.entity };\n    }\n\n    private getTextureKey(layer: EntityLayer): AssetKey {\n        if (layer.texture) return layer.texture;\n        const key = layer.key;\n        return new AssetKey(\n            key.namespace,\n            isAssetKey(key) ? key.getFullPath() : key.path,\n            \"textures\",\n            \"entity\",\n            \"assets\",\n            \".png\"\n        );\n    }\n\n    protected async loadTextures(layer: EntityLayer = this.entity): Promise<Maybe<ExtractableImageData>> {\n        return ModelTextures.get(this.getTextureKey(layer));\n    }\n\n    protected createMeshes(force: boolean = false) {\n        if (this.meshesCreated && !force) return;\n\n        const modelRoot = new Object3D();\n        let transformNode = modelRoot;\n        // Keep Minecraft's model coordinates separate from caller placement and scale.\n        const transform = this.options.flip === undefined ? this.entity.transform : undefined;\n        if (transform) {\n            // One position, rotation and scale cannot express nonuniform scale followed by rotation.\n            // Nested nodes preserve each operation and avoid manual matrices, which leave bounds stale.\n            for (const [index, op] of transform.entries()) {\n                if (index > 0) {\n                    const child = new Object3D();\n                    transformNode.add(child);\n                    transformNode = child;\n                }\n                if (\"scale\" in op) transformNode.scale.set(...op.scale);\n                else if (\"translate\" in op) transformNode.position.set(...op.translate);\n                else transformNode.rotation.set(...op.rotate, \"ZYX\");\n            }\n        } else if (this.options.flip ?? true) {\n            modelRoot.scale.set(-1, -1, 1);\n        }\n        this.add(modelRoot);\n        Object.entries(this.entityLayers).forEach(([name, layer], index) => {\n            const group = this.createGroup(`layer:${name}`);\n            transformNode.add(group);\n            const inward = !Materials.entityModeCulls(layer.render ?? layer.layer.render);\n            this.createPart(\"root\", layer.layer.root, group, layer.layer.texture, Materials.MISSING_TEXTURE, index, inward, this.options.faces?.[name]);\n        });\n        this.meshesCreated = true;\n    }\n\n    private createPart(name: string, part: EntityModelPart, parent: Object3D, textureSize: DoubleArray, material: Material, renderOrder: number, inward: boolean = true, faces?: CubeFace[]) {\n        const anchor = this.createGroup(name);\n        anchor.position.fromArray(part.pose.offset);\n        anchor.rotation.set(...part.pose.rotation, \"ZYX\");\n        anchor.scale.fromArray(part.pose.scale ?? [1, 1, 1]);\n        this.partPoses.set(anchor, part.pose);\n        parent.add(anchor);\n        const size = part.texture ?? textureSize;\n\n        for (const cube of part.cubes) {\n            const [width, height, depth] = cube.size;\n            const [growX, growY, growZ] = cube.grow ?? [0, 0, 0];\n            const texture = new MinecraftCubeTexture(...cube.uv, ...size);\n            const uv = size[0] === 0 || size[1] === 0 ? new Array<number>(48).fill(0) : texture.toUvArray(width, height, depth, cube.mirror);\n            const geometry = this._getBoxGeometryForDimensionsAndUv(\n                width + growX * 2, height + growY * 2, depth + growZ * 2, uv\n            ).clone();\n            this.geometries.add(geometry);\n            geometry.translate(cube.origin[0] + width / 2, cube.origin[1] + height / 2, cube.origin[2] + depth / 2);\n            if (faces) {\n                geometry.setIndex(Array.from(geometry.getIndex()!.array).filter((_, index) => faces.includes(CUBE_FACES[Math.floor(index / 6)])));\n                geometry.clearGroups();\n            }\n            // Vanilla draws most entity render types without backface culling, e.g. chicken legs are only painted on faces seen from inside.\n            // Zero-thickness cubes keep one face per side, as their coplanar faces would z-fight.\n            if (inward && Math.min(width + growX * 2, height + growY * 2, depth + growZ * 2) > 0) {\n                const index = Array.from(geometry.getIndex()!.array);\n                geometry.setIndex(index.concat(index.slice().reverse()));\n            }\n            const mesh = this.createMesh(name, geometry, material);\n            mesh.renderOrder = renderOrder;\n            anchor.add(mesh);\n            if (this.options.wireframe) this.disposeWireframes.push(addWireframeToMesh(geometry, mesh));\n        }\n        for (const [childName, child] of Object.entries(part.children)) {\n            this.createPart(childName, child, anchor, size, material, renderOrder, inward, faces);\n        }\n    }\n\n    protected async applyTextures() {\n        this.clearScrollMaterials();\n        const results = await Promise.allSettled(Object.entries(this.entityLayers).map(async ([name, layer]) => {\n            const mode = layer.render ?? layer.layer.render ?? \"cutout\";\n            const tint = layer.tint === undefined ? undefined : this.options.tints?.[layer.tint];\n            const scroll = Materials.entityModeScroll(mode);\n            const assetKeyStr = this.getTextureKey(layer).serialize();\n            const keyStr = `entity:${ mode }:${ tint === undefined ? \"\" : new Color(tint).getHexString() }:${ assetKeyStr }`;\n            let mat = scroll ? undefined : Caching.materialCache.getIfPresent(keyStr);\n            if (!mat) {\n                const cachedAsset = Caching.textureAssetCache.getIfPresent(assetKeyStr);\n                const imageData = await this.loadTextures(layer);\n                if (!imageData) return;\n                const canvas = (imageData.data as CanvasRenderingContext2D).canvas;\n                const createMaterial = () => Materials.createEntityCanvasMaterial(canvas, mode, tint);\n                // A cache clear during decoding must not restore an older source's material.\n                // Scrolling materials stay out of the cache, as their texture offset belongs to this entity.\n                mat = !scroll && cachedAsset && Caching.textureAssetCache.getIfPresent(assetKeyStr) === cachedAsset\n                    ? Caching.materialCache.get(keyStr, createMaterial)\n                    : createMaterial();\n                if (scroll) {\n                    this.scrollMaterials.push({ material: mat!, offset: (mat as MeshBasicMaterial).map!.offset, speed: scroll });\n                }\n            }\n            this.getLayerGroup(name)?.traverse(object => {\n                if (isMesh(object)) object.material = mat!;\n            });\n        }));\n        if (!this.children.length) {\n            // Disposed while the textures were loading: nothing is left to scroll.\n            this.clearScrollMaterials();\n        } else if (this.scrollMaterials.length) {\n            this.updateScroll();\n        }\n        this.updateScrollSubscription();\n        this.notifyDirty();\n        const failure = results.find(result => result.status === \"rejected\");\n        if (failure?.status === \"rejected\") throw failure.reason;\n    }\n\n\n}\n\n/** Render settings passed to `scene.addEntity(entity, options)` or the EntityObject constructor. */\nexport interface EntityObjectOptions extends SceneObjectOptions {\n    /**\n     * `true` applies only vanilla's entity flip, scale (-1, -1, 1); `false` keeps raw model space.\n     * By default the model's dataset transform is used, or the flip for models without one.\n     */\n    flip?: boolean;\n    /** Colours for the dataset's tint labels, e.g. `{ wool_color: 0xf9801d }`; a pass whose label is absent stays untinted. */\n    tints?: Record<string, ColorRepresentation>;\n    /** Cube faces by layer key; omitted layers draw all six faces. */\n    faces?: Record<string, CubeFace[]>;\n}\n\nexport function isEntityObject(obj: any): obj is EntityObject {\n    return (<EntityObject>obj).isEntityObject;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/entity/scene/EntityObject.ts"],"sourcesContent":["import { SceneObject } from \"../../renderer/SceneObject\";\nimport { SceneObjectOptions } from \"../../renderer/SceneObjectOptions\";\nimport { Caching } from \"../../cache/Caching\";\nimport { merge } from \"../../util/_internal/merge\";\nimport { Color, Object3D } from \"three\";\nimport type { BufferGeometry, ColorRepresentation, Material, Mesh, MeshBasicMaterial } from \"three\";\nimport { Ticker } from \"../../Ticker\";\nimport { addWireframeToMesh } from \"../../util/model\";\nimport { ModelTextures } from \"../../assets/ModelTextures\";\nimport { AssetKey, isAssetKey } from \"../../assets/AssetKey\";\nimport { ExtractableImageData } from \"../../ExtractableImageData\";\nimport { Materials } from \"../../Materials\";\nimport { MinecraftCubeTexture } from \"../../MinecraftCubeTexture\";\nimport { CUBE_FACES, CubeFace } from \"../../CubeFace\";\nimport { EntityLayer, EntityModel, EntityModelPart } from \"../EntityModel\";\nimport type { DoubleArray } from \"../../model/Model\";\nimport type { Maybe } from \"../../util/util\";\nimport { isMesh } from \"../../util/three\";\nimport type { EntityAnimation } from \"../EntityAnimation\";\nimport { EntityAnimationOptions, EntityAnimationPlayer, validateAnimationWeights } from \"./EntityAnimationPlayer\";\n\n/** Renders selected entity layers as named part groups. Create it through {@link MineRenderScene.addEntity}. */\nexport class EntityObject extends SceneObject {\n\n    public readonly isEntityObject: true = true;\n\n    public static readonly DEFAULT_OPTIONS: EntityObjectOptions = merge({}, SceneObject.DEFAULT_OPTIONS);\n    public readonly options: EntityObjectOptions;\n\n    private meshesCreated: boolean = false;\n    private readonly geometries = new Set<BufferGeometry>();\n    private readonly disposeWireframes: (() => void)[] = [];\n    /** Scrolling materials are owned: their texture offset follows this entity's age. */\n    private readonly scrollMaterials: { material: Material, offset: { set(x: number, y: number): unknown }, speed: [number, number] }[] = [];\n    private scrollTicker: Maybe<number>;\n    /** Entity age in ticks, as vanilla's `ageInTicks`; drives the scrolling render modes. */\n    public age: number = 0;\n    private readonly animationPlayers: { player: EntityAnimationPlayer, indices: number[] }[] = [];\n    private readonly partPoses = new Map<Object3D, EntityModelPart[\"pose\"]>();\n\n    constructor(readonly entity: EntityModel, options?: Partial<EntityObjectOptions>) {\n        super();\n        this.options = merge({}, EntityObject.DEFAULT_OPTIONS, options ?? {});\n        this.addEventListener(\"added\", () => this.updateScrollSubscription());\n        this.addEventListener(\"removed\", () => this.updateScrollSubscription());\n    }\n\n    /** An optional shared material replaces texture loading for every selected draw; its owner retains disposal. */\n    async init(material?: Material): Promise<void> {\n        this.createMeshes();\n        if (material) {\n            this.clearScrollMaterials();\n            this.iterateAllMeshes(mesh => { mesh.material = material; });\n            this.notifyDirty();\n        } else await this.applyTextures();\n    }\n\n    dispose() {\n        super.dispose();\n    }\n\n    public disposeAndRemoveAllChildren() {\n        this.clearScrollMaterials();\n        for (const geometry of this.geometries) geometry.dispose();\n        this.geometries.clear();\n        for (const dispose of this.disposeWireframes.splice(0)) dispose();\n        // The animated part groups are removed with the children.\n        for (const { player } of this.animationPlayers.splice(0)) player.clear();\n        this.partPoses.clear();\n        super.disposeAndRemoveAllChildren();\n    }\n\n    private clearScrollMaterials() {\n        Ticker.remove(this.scrollTicker);\n        this.scrollTicker = undefined;\n        for (const { material } of this.scrollMaterials.splice(0)) {\n            (material as { map?: { dispose(): void } }).map?.dispose();\n            material.dispose();\n        }\n    }\n\n    private updateScrollSubscription() {\n        if (this.parent && this.scrollMaterials.length) {\n            if (this.scrollTicker === undefined) {\n                this.scrollTicker = Ticker.add(() => {\n                    this.age++;\n                    this.updateScroll();\n                });\n            }\n        } else {\n            Ticker.remove(this.scrollTicker);\n            this.scrollTicker = undefined;\n        }\n    }\n\n    /** Applies the entity age to the scrolling materials; the ticker calls this 20 times per second. */\n    private updateScroll() {\n        for (const { offset, speed } of this.scrollMaterials) {\n            // Texture V points up here and down in vanilla.\n            offset.set((this.age * speed[0]) % 1, 0 - (this.age * speed[1]) % 1);\n        }\n        this.notifyDirty();\n    }\n\n    //<editor-fold desc=\"ANIMATION\">\n\n    /** The first active clip, until playback is stopped or the object is disposed. */\n    public get animation(): Maybe<EntityAnimation> {\n        return this.animationPlayers[0]?.player.animation;\n    }\n\n    /** Clips playing together, in the order passed to {@link playAnimations}. */\n    public get activeAnimations(): readonly EntityAnimation[] {\n        const animations: EntityAnimation[] = [];\n        for (const { player, indices } of this.animationPlayers) {\n            player.animations.forEach((animation, i) => { animations[indices[i]] = animation; });\n        }\n        return animations;\n    }\n\n    /** Weights of the active clips, in the same order as {@link activeAnimations}. */\n    public get animationWeights(): readonly number[] {\n        const weights: number[] = [];\n        for (const { player, indices } of this.animationPlayers) {\n            player.weights.forEach((weight, i) => { weights[indices[i]] = weight; });\n        }\n        return weights;\n    }\n\n    /** Seconds since the animation started, before looping. */\n    public get animationTime(): number {\n        return this.animationPlayers[0]?.player.time ?? 0;\n    }\n\n    /**\n     * Plays a clip from {@link Entities.getAnimations}, replacing all active clips.\n     * Offsets apply to the baked pose in the clip's layer (`main` by default) and its repeated draws.\n     * A `main` clip also poses every selected layer without a clip of its own.\n     * The object owns no clock: call {@link advanceAnimation} per frame, or {@link setAnimationTime}.\n     */\n    public playAnimation(animation: EntityAnimation, options?: EntityAnimationOptions): void {\n        this.playAnimations([animation], options);\n    }\n\n    /**\n     * Plays clips with a shared clock, adding their weighted offsets within each geometry layer.\n     * Weights default to 1 and are not normalized. Selected layers without their own clip follow `main`.\n     */\n    public playAnimations(animations: readonly EntityAnimation[], options?: EntityAnimationOptions): void {\n        const weights = validateAnimationWeights(options?.weights ?? animations.map(() => 1), animations.length);\n        const selections = new Map<string, { animations: EntityAnimation[], names: string[], indices: number[] }>();\n        animations.forEach((animation, index) => {\n            const layer = animation.layer ?? \"main\";\n            const names = Object.keys(this.entityLayers).filter(name => name.split(\"#\")[0] === layer);\n            if (!names.length) throw new Error(`Entity ${this.entity.id} has no selected animation layer \"${layer}\"`);\n            let selection = selections.get(layer);\n            if (!selection) selections.set(layer, selection = { animations: [], names, indices: [] });\n            selection.animations.push(animation);\n            selection.indices.push(index);\n        });\n        const main = selections.get(\"main\");\n        if (main) main.names.push(...Object.keys(this.entityLayers).filter(name => !selections.has(name.split(\"#\")[0])));\n        this.createMeshes();\n        this.stopAnimation();\n        for (const { animations: clips, names, indices } of selections.values()) {\n            const player = new EntityAnimationPlayer();\n            player.playAnimations(names.map(name => this.getLayerGroup(name)!), clips,\n                { ...options, weights: indices.map(index => weights[index]) }, this.partPoses);\n            this.animationPlayers.push({ player, indices });\n        }\n        this.notifyDirty();\n    }\n\n    /** Changes weights in active clip order, notifying the scene without restarting the shared clock. Has no effect without an animation. */\n    public setAnimationWeights(weights: readonly number[]): void {\n        if (!this.animationPlayers.length) return;\n        const values = validateAnimationWeights(weights, this.activeAnimations.length);\n        for (const { player, indices } of this.animationPlayers) player.setWeights(indices.map(index => values[index]));\n        this.notifyDirty();\n    }\n\n    /** Stops all clips and restores the poses from before playback. */\n    public stopAnimation(): void {\n        const players = this.animationPlayers.splice(0);\n        for (const { player } of players) player.stop();\n        if (players.length) this.notifyDirty();\n    }\n\n    /** Poses the object at an explicit time in seconds. Has no effect without an animation. */\n    public setAnimationTime(seconds: number): void {\n        for (const { player } of this.animationPlayers) player.setTime(seconds);\n        if (this.animationPlayers.length) this.notifyDirty();\n    }\n\n    /** Advances the animation by a frame delta in seconds, scaled by its speed. Has no effect without an animation. */\n    public advanceAnimation(deltaSeconds: number): void {\n        for (const { player } of this.animationPlayers) player.advance(deltaSeconds);\n        if (this.animationPlayers.length) this.notifyDirty();\n    }\n\n    //</editor-fold>\n\n    /** Finds a selected draw by its layer key, such as `main` or `main#2`, or returns `undefined`. */\n    public getLayerGroup(name: string): Maybe<Object3D> {\n        return super.getGroupByName(`layer:${name}`);\n    }\n\n    /** Finds a part name without `group:`. Supply `layerName` to restrict the search to one draw. */\n    public getGroupByName(name: string, layerName?: string): Maybe<Object3D> {\n        return layerName === undefined ? super.getGroupByName(name)\n            : this.getLayerGroup(layerName)?.getObjectByName(`group:${name}`);\n    }\n\n    /** Finds a mesh name without `mesh:`. Supply `layerName` to restrict the search to one draw. */\n    public getMeshByName(name: string, layerName?: string): Maybe<Mesh> {\n        return layerName === undefined ? super.getMeshByName(name)\n            : this.getLayerGroup(layerName)?.getObjectByName(`mesh:${name}`) as Maybe<Mesh>;\n    }\n\n    private get entityLayers(): Record<string, EntityLayer> {\n        return this.entity.layers ?? { main: this.entity };\n    }\n\n    private getTextureKey(layer: EntityLayer): AssetKey {\n        if (layer.texture) return layer.texture;\n        const key = layer.key;\n        return new AssetKey(\n            key.namespace,\n            isAssetKey(key) ? key.getFullPath() : key.path,\n            \"textures\",\n            \"entity\",\n            \"assets\",\n            \".png\"\n        );\n    }\n\n    protected async loadTextures(layer: EntityLayer = this.entity): Promise<Maybe<ExtractableImageData>> {\n        return ModelTextures.get(this.getTextureKey(layer));\n    }\n\n    protected createMeshes(force: boolean = false) {\n        if (this.meshesCreated && !force) return;\n\n        const modelRoot = new Object3D();\n        let transformNode = modelRoot;\n        // Keep Minecraft's model coordinates separate from caller placement and scale.\n        const transform = this.options.flip === undefined ? this.entity.transform : undefined;\n        if (transform) {\n            // One position, rotation and scale cannot express nonuniform scale followed by rotation.\n            // Nested nodes preserve each operation and avoid manual matrices, which leave bounds stale.\n            for (const [index, op] of transform.entries()) {\n                if (index > 0) {\n                    const child = new Object3D();\n                    transformNode.add(child);\n                    transformNode = child;\n                }\n                if (\"scale\" in op) transformNode.scale.set(...op.scale);\n                else if (\"translate\" in op) transformNode.position.set(...op.translate);\n                else transformNode.rotation.set(...op.rotate, \"ZYX\");\n            }\n        } else if (this.options.flip ?? true) {\n            modelRoot.scale.set(-1, -1, 1);\n        }\n        this.add(modelRoot);\n        Object.entries(this.entityLayers).forEach(([name, layer], index) => {\n            const group = this.createGroup(`layer:${name}`);\n            transformNode.add(group);\n            const inward = !Materials.entityModeCulls(layer.render ?? layer.layer.render);\n            this.createPart(\"root\", layer.layer.root, group, layer.layer.texture, Materials.MISSING_TEXTURE, index, inward, this.options.faces?.[name]);\n        });\n        this.meshesCreated = true;\n    }\n\n    private createPart(name: string, part: EntityModelPart, parent: Object3D, textureSize: DoubleArray, material: Material, renderOrder: number, inward: boolean = true, faces?: CubeFace[]) {\n        const anchor = this.createGroup(name);\n        anchor.position.fromArray(part.pose.offset);\n        anchor.rotation.set(...part.pose.rotation, \"ZYX\");\n        anchor.scale.fromArray(part.pose.scale ?? [1, 1, 1]);\n        this.partPoses.set(anchor, part.pose);\n        parent.add(anchor);\n        const size = part.texture ?? textureSize;\n\n        for (const cube of part.cubes) {\n            const [width, height, depth] = cube.size;\n            const [growX, growY, growZ] = cube.grow ?? [0, 0, 0];\n            const texture = new MinecraftCubeTexture(...cube.uv, ...size);\n            const uv = size[0] === 0 || size[1] === 0 ? new Array<number>(48).fill(0) : texture.toUvArray(width, height, depth, cube.mirror);\n            const geometry = this._getBoxGeometryForDimensionsAndUv(\n                width + growX * 2, height + growY * 2, depth + growZ * 2, uv\n            ).clone();\n            this.geometries.add(geometry);\n            geometry.translate(cube.origin[0] + width / 2, cube.origin[1] + height / 2, cube.origin[2] + depth / 2);\n            if (faces) {\n                geometry.setIndex(Array.from(geometry.getIndex()!.array).filter((_, index) => faces.includes(CUBE_FACES[Math.floor(index / 6)])));\n                geometry.clearGroups();\n            }\n            // Vanilla draws most entity render types without backface culling, e.g. chicken legs are only painted on faces seen from inside.\n            // Zero-thickness cubes keep one face per side, as their coplanar faces would z-fight.\n            if (inward && Math.min(width + growX * 2, height + growY * 2, depth + growZ * 2) > 0) {\n                const index = Array.from(geometry.getIndex()!.array);\n                geometry.setIndex(index.concat(index.slice().reverse()));\n            }\n            const mesh = this.createMesh(name, geometry, material);\n            mesh.renderOrder = renderOrder;\n            anchor.add(mesh);\n            if (this.options.wireframe) this.disposeWireframes.push(addWireframeToMesh(geometry, mesh));\n        }\n        for (const [childName, child] of Object.entries(part.children)) {\n            this.createPart(childName, child, anchor, size, material, renderOrder, inward, faces);\n        }\n    }\n\n    protected async applyTextures() {\n        this.clearScrollMaterials();\n        const results = await Promise.allSettled(Object.entries(this.entityLayers).map(async ([name, layer]) => {\n            const mode = layer.render ?? layer.layer.render ?? \"cutout\";\n            const tint = layer.tint === undefined ? undefined : this.options.tints?.[layer.tint];\n            const scroll = Materials.entityModeScroll(mode);\n            const assetKeyStr = this.getTextureKey(layer).serialize();\n            const keyStr = `entity:${ mode }:${ tint === undefined ? \"\" : new Color(tint).getHexString() }:${ assetKeyStr }`;\n            let mat = scroll ? undefined : Caching.materialCache.getIfPresent(keyStr);\n            if (!mat) {\n                const cachedAsset = Caching.textureAssetCache.getIfPresent(assetKeyStr);\n                const imageData = await this.loadTextures(layer);\n                if (!imageData) return;\n                const canvas = (imageData.data as CanvasRenderingContext2D).canvas;\n                const createMaterial = () => Materials.createEntityCanvasMaterial(canvas, mode, tint);\n                // A cache clear during decoding must not restore an older source's material.\n                // Scrolling materials stay out of the cache, as their texture offset belongs to this entity.\n                mat = !scroll && cachedAsset && Caching.textureAssetCache.getIfPresent(assetKeyStr) === cachedAsset\n                    ? Caching.materialCache.get(keyStr, createMaterial)\n                    : createMaterial();\n                if (scroll) {\n                    this.scrollMaterials.push({ material: mat!, offset: (mat as MeshBasicMaterial).map!.offset, speed: scroll });\n                }\n            }\n            this.getLayerGroup(name)?.traverse(object => {\n                if (isMesh(object)) object.material = mat!;\n            });\n        }));\n        if (!this.children.length) {\n            // Disposed while the textures were loading: nothing is left to scroll.\n            this.clearScrollMaterials();\n        } else if (this.scrollMaterials.length) {\n            this.updateScroll();\n        }\n        this.updateScrollSubscription();\n        this.notifyDirty();\n        const failure = results.find(result => result.status === \"rejected\");\n        if (failure?.status === \"rejected\") throw failure.reason;\n    }\n\n\n}\n\n/** Render settings passed to `scene.addEntity(entity, options)` or the EntityObject constructor. */\nexport interface EntityObjectOptions extends SceneObjectOptions {\n    /**\n     * `true` applies only vanilla's entity flip, scale (-1, -1, 1); `false` keeps raw model space.\n     * By default the model's dataset transform is used, or the flip for models without one.\n     */\n    flip?: boolean;\n    /** Colours for the dataset's tint labels, e.g. `{ wool_color: 0xf9801d }`; a pass whose label is absent stays untinted. */\n    tints?: Record<string, ColorRepresentation>;\n    /** Cube faces by layer key; omitted layers draw all six faces. */\n    faces?: Record<string, CubeFace[]>;\n}\n\nexport function isEntityObject(obj: any): obj is EntityObject {\n    return (<EntityObject>obj).isEntityObject;\n}\n"],"mappings":"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","names":[]}

package/dist/browser/esm/index.browser.d.mts

@@ -1576,25 +1576,35 @@ interface EntityAnimationOptions {
     speed?: number;
     /** Start time in seconds; defaults to 0. */
     time?: number;
+    /** Nonnegative finite weights in clip order; defaults to 1 per clip. Offsets add without normalizing weights. */
+    weights?: readonly number[];
 }
 /**
- * Poses part groups from a keyframe animation the way vanilla does: every update restores the
- * default pose of each animated part, then adds the sampled offsets to its position, Euler angles and scale.
+ * Poses part groups from keyframe animations: every update restores the default pose of each
+ * animated part, then adds weighted sampled offsets to its position, Euler angles and scale.
  * It owns no timer; the owner advances it.
  */
 declare class EntityAnimationPlayer {
     private parts;
-    private _animation?;
+    private _animations;
+    private _weights;
+    private loops;
     private _time;
-    private loop;
     private speed;
     get animation(): EntityAnimation | undefined;
+    get animations(): readonly EntityAnimation[];
+    get weights(): readonly number[];
     get time(): number;
     /**
      * Starts an animation on matching named parts. Supplied baked poses are the baseline for offsets;
      * without them, the current pose is used. Stopping restores the pose from before playback.
      */
     play(layers: Object3D[], animation: EntityAnimation, options?: EntityAnimationOptions, poses?: ReadonlyMap<Object3D, EntityModelPart["pose"]>): void;
+    /**
+     * Starts clips on matching parts with a shared clock. Weighted offsets add to the supplied baked poses
+     * or, without poses, to each animated part's pose when playback starts.
+     */
+    playAnimations(layers: Object3D[], animations: readonly EntityAnimation[], options?: EntityAnimationOptions, poses?: ReadonlyMap<Object3D, EntityModelPart["pose"]>): void;
     /** Restores the poses from before playback. Returns whether an animation was active. */
     stop(): boolean;
     /** Forgets the animation without touching the parts, for parts that no longer exist. */
@@ -1603,8 +1613,12 @@ declare class EntityAnimationPlayer {
     setTime(seconds: number): boolean;
     /** Advances playback by elapsed seconds multiplied by the speed passed to {@link play}. */
     advance(deltaSeconds: number): boolean;
+    /** Changes weights in clip order and reapplies the current time without restarting playback. */
+    setWeights(weights: readonly number[]): boolean;
     private apply;
 }
+/** @internal */
+declare function validateAnimationWeights(weights: readonly number[], count: number): number[];
 
 /** Renders selected entity layers as named part groups. Create it through {@link MineRenderScene.addEntity}. */
 declare class EntityObject extends SceneObject {
@@ -1633,8 +1647,10 @@ declare class EntityObject extends SceneObject {
     private updateScroll;
     /** The first active clip, until playback is stopped or the object is disposed. */
     get animation(): Maybe<EntityAnimation>;
-    /** Clips playing together, each targeting a separate geometry layer. */
+    /** Clips playing together, in the order passed to {@link playAnimations}. */
     get activeAnimations(): readonly EntityAnimation[];
+    /** Weights of the active clips, in the same order as {@link activeAnimations}. */
+    get animationWeights(): readonly number[];
     /** Seconds since the animation started, before looping. */
     get animationTime(): number;
     /**
@@ -1644,8 +1660,13 @@ declare class EntityObject extends SceneObject {
      * The object owns no clock: call {@link advanceAnimation} per frame, or {@link setAnimationTime}.
      */
     playAnimation(animation: EntityAnimation, options?: EntityAnimationOptions): void;
-    /** Plays clips with a shared clock and no blending. Selected layers without their own clip follow `main`. */
+    /**
+     * Plays clips with a shared clock, adding their weighted offsets within each geometry layer.
+     * Weights default to 1 and are not normalized. Selected layers without their own clip follow `main`.
+     */
     playAnimations(animations: readonly EntityAnimation[], options?: EntityAnimationOptions): void;
+    /** Changes weights in active clip order, notifying the scene without restarting the shared clock. Has no effect without an animation. */
+    setAnimationWeights(weights: readonly number[]): void;
     /** Stops all clips and restores the poses from before playback. */
     stopAnimation(): void;
     /** Poses the object at an explicit time in seconds. Has no effect without an animation. */
@@ -4344,4 +4365,4 @@ declare class BrowserCache extends PersistentCache<LocalForage> {
  */
 declare function probeImageSize(data: Uint8Array): ImageSizeInfo;
 
-export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, type AnvilEntityChunk, type AnvilExternalChunkReader, type AnvilParseOptions, AnvilParser, type AnvilRegion, type AnvilRegionReader, AnvilWorldSource, type AnvilWorldSourceOptions, ArchiveAssetSource, type ArchiveAssetSourceOptions, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, type BannerPattern, type BannerPatternDraw, BannerPatterns, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type Biome, type BiomeColorKind, Biomes, type BitmapFont, type BitmapGlyph, type Block, BlockEntities, type BlockEntityEntry, type BlockEntityIndex, type BlockEntityPart, type BlockEntityRotation, type BlockFluidState, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, BlockStateResolver, type BlockStateVariant, type BlockStateVariants, BlockStates, BlockTints, type BoxGeometryKey, BrowserArchiveProxy, BrowserCache, BrowserEnv, CUBE_FACES, CUBE_FACE_OFFSETS, type CacheKey, Caching, type CameraOptions, CanvasImage, type CapeLayout, Chunk, ChunkData, Colormaps, type CompatCanvas, type CompatImage, type ComposerOptions, type ControlsMode, type ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, DYE_COLORS, type DebugOptions, type DecoratedPotSide, DecoratedPots, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, type DyeColor, ENTITY_ANIMATION_CHANNELS, type ElementFace, type ElementRotation, Entities, type EntityAnimation, type EntityAnimationBone, type EntityAnimationChannel, type EntityAnimationFile, type EntityAnimationKeyframe, type EntityAnimationOptions, EntityAnimationPlayer, type EntityAnimationPose, type EntityLayer, type EntityModel, type EntityModelCube, type EntityModelFile, type EntityModelLayer, type EntityModelOptions, type EntityModelPart, type EntityModelPass, EntityObject, type EntityObjectOptions, type EntityRenderMode, type EntityTransformOp, Env, type EnvProvider, type ExtractableImageData, type FluidKind, FluidModelObject, type FluidQuads, type FluidRules, type FluidSample, type FluidSampler, type FlyAction, FlyControls, type FlyControlsEventMap, Fonts, type FrameCallback, type FromTo, GUI_CONTAINER_LAYOUTS, Geometries, type GuiBookButtonState, type GuiBookOptions, type GuiBossBarColor, type GuiBossBarOptions, type GuiContainerType, GuiHelper, type GuiItemLayer, type GuiLayer, GuiLight, GuiObject, type GuiObjectOptions, type GuiRecipe, type GuiRecipeIngredient, type GuiRecipeOptions, type GuiSpriteScaling, type GuiText, type GuiTextLayer, type GuiTextLayout, type GuiTextOptions, type GuiTextRun, type GuiTextStyle, type GuiTextureLayer, type GuiTooltipOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, ItemDefaults, ItemGlint, type ItemModel, type ItemModelContext, type ItemModelTextures, type ItemTintColor, type ItemTintSource, ItemTints, type ListAsset, LitematicaParser, type LitematicaRegion, type LitematicaStructure, type LoadedSceneDocument, type LoadedSceneObject, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderData, type MineRenderDataManifest, type MineRenderDatasets, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MineRenderWorldOptions, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, ModelCulling, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, ModelTextures, Models, type MultiBlockBlock, type MultiBlockEntity, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, OrbitControls, type PackFormat, PackFormats, PackMetadata, PersistentCache, PlayerHeadTextures, type PositionedGuiGlyph, type QuadArray, type RawImageKey, type RenameKind, Renames, type RenderOptions, Renderer, type RendererControls, type RendererFrame, type RendererOptions, type RendererSurface, type RequestConfig, RequestError, type RequestResponse, Requests, type ResolvedBlockEntity, type ResolvedMineRenderData, type ResponseParser, SCENE_DOCUMENT_MAX_BYTES, SKIN_PARTS, type SavedLightSample, type SceneBlockDefinition, type SceneDocument, SceneDocumentLoader, type SceneEntityDefinition, SceneExporter, type SceneGLTFExportOptions, type SceneGuiDefinition, type SceneGuiLayer, SceneInspector, type SceneItemContext, type SceneModelDefinition, SceneObject, type SceneObjectDefinition, type SceneObjectDefinitionBase, type SceneObjectOptions, type SceneSkinDefinition, type SceneSkinPosePart, SceneStats, SceneStatsDisplay, SchematicParser, type SchematicParserOptions, type SectionAtlasSize, type SectionFluidInput, type SectionFluidKind, type SectionFluids, type SectionGeometryInput, type SectionGeometryPage, type SectionLightData, SectionMesh, type SectionMeshEntry, type SectionMeshTemplate, SectionModels, type SectionTemplateData, SectionWorker, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type SpecialItemPart, type SpecialItemRenderer, SpecialItems, SpongeSchematicParser, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, type VideoExportOptions, VideoExporter, type WorldBlockIntersection, type WorldChunkSource, type WorldEntityIntersection, WorldStreamer, type WorldStreamerOptions, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, buildFluidQuads, buildSectionGeometry, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, copySectionLight, createCanvas, createFluidGeometry, createGuiTextGeometry, createGuiTextureGeometry, createImage, decodeSceneDocument, encodeSceneDocument, entityAnimationTime, estimateBytesUsed, fluidKindOf, getBlockFluidState, getFluidKind, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isFlyControls, isGuiObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isResourceLocation, isSceneObject, isTransformable, isTripleArray, isVector3, layoutGuiText, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, parseSceneDocument, prefix, probeImageSize, registerBrowserEnv, resolveBlockFluidState, resolveLegacyBlock, resolveLegacyBlockState, sampleEntityAnimation, sampleEntityKeyframes, sampleFluid, sampleSectionLight, sectionGeometryTransferables, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode, trimCanvas, yieldToEventLoop };
+export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, type AnvilEntityChunk, type AnvilExternalChunkReader, type AnvilParseOptions, AnvilParser, type AnvilRegion, type AnvilRegionReader, AnvilWorldSource, type AnvilWorldSourceOptions, ArchiveAssetSource, type ArchiveAssetSourceOptions, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, type BannerPattern, type BannerPatternDraw, BannerPatterns, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type Biome, type BiomeColorKind, Biomes, type BitmapFont, type BitmapGlyph, type Block, BlockEntities, type BlockEntityEntry, type BlockEntityIndex, type BlockEntityPart, type BlockEntityRotation, type BlockFluidState, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, BlockStateResolver, type BlockStateVariant, type BlockStateVariants, BlockStates, BlockTints, type BoxGeometryKey, BrowserArchiveProxy, BrowserCache, BrowserEnv, CUBE_FACES, CUBE_FACE_OFFSETS, type CacheKey, Caching, type CameraOptions, CanvasImage, type CapeLayout, Chunk, ChunkData, Colormaps, type CompatCanvas, type CompatImage, type ComposerOptions, type ControlsMode, type ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, DYE_COLORS, type DebugOptions, type DecoratedPotSide, DecoratedPots, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, type DyeColor, ENTITY_ANIMATION_CHANNELS, type ElementFace, type ElementRotation, Entities, type EntityAnimation, type EntityAnimationBone, type EntityAnimationChannel, type EntityAnimationFile, type EntityAnimationKeyframe, type EntityAnimationOptions, EntityAnimationPlayer, type EntityAnimationPose, type EntityLayer, type EntityModel, type EntityModelCube, type EntityModelFile, type EntityModelLayer, type EntityModelOptions, type EntityModelPart, type EntityModelPass, EntityObject, type EntityObjectOptions, type EntityRenderMode, type EntityTransformOp, Env, type EnvProvider, type ExtractableImageData, type FluidKind, FluidModelObject, type FluidQuads, type FluidRules, type FluidSample, type FluidSampler, type FlyAction, FlyControls, type FlyControlsEventMap, Fonts, type FrameCallback, type FromTo, GUI_CONTAINER_LAYOUTS, Geometries, type GuiBookButtonState, type GuiBookOptions, type GuiBossBarColor, type GuiBossBarOptions, type GuiContainerType, GuiHelper, type GuiItemLayer, type GuiLayer, GuiLight, GuiObject, type GuiObjectOptions, type GuiRecipe, type GuiRecipeIngredient, type GuiRecipeOptions, type GuiSpriteScaling, type GuiText, type GuiTextLayer, type GuiTextLayout, type GuiTextOptions, type GuiTextRun, type GuiTextStyle, type GuiTextureLayer, type GuiTooltipOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, ItemDefaults, ItemGlint, type ItemModel, type ItemModelContext, type ItemModelTextures, type ItemTintColor, type ItemTintSource, ItemTints, type ListAsset, LitematicaParser, type LitematicaRegion, type LitematicaStructure, type LoadedSceneDocument, type LoadedSceneObject, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderData, type MineRenderDataManifest, type MineRenderDatasets, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MineRenderWorldOptions, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, ModelCulling, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, ModelTextures, Models, type MultiBlockBlock, type MultiBlockEntity, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, OrbitControls, type PackFormat, PackFormats, PackMetadata, PersistentCache, PlayerHeadTextures, type PositionedGuiGlyph, type QuadArray, type RawImageKey, type RenameKind, Renames, type RenderOptions, Renderer, type RendererControls, type RendererFrame, type RendererOptions, type RendererSurface, type RequestConfig, RequestError, type RequestResponse, Requests, type ResolvedBlockEntity, type ResolvedMineRenderData, type ResponseParser, SCENE_DOCUMENT_MAX_BYTES, SKIN_PARTS, type SavedLightSample, type SceneBlockDefinition, type SceneDocument, SceneDocumentLoader, type SceneEntityDefinition, SceneExporter, type SceneGLTFExportOptions, type SceneGuiDefinition, type SceneGuiLayer, SceneInspector, type SceneItemContext, type SceneModelDefinition, SceneObject, type SceneObjectDefinition, type SceneObjectDefinitionBase, type SceneObjectOptions, type SceneSkinDefinition, type SceneSkinPosePart, SceneStats, SceneStatsDisplay, SchematicParser, type SchematicParserOptions, type SectionAtlasSize, type SectionFluidInput, type SectionFluidKind, type SectionFluids, type SectionGeometryInput, type SectionGeometryPage, type SectionLightData, SectionMesh, type SectionMeshEntry, type SectionMeshTemplate, SectionModels, type SectionTemplateData, SectionWorker, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type SpecialItemPart, type SpecialItemRenderer, SpecialItems, SpongeSchematicParser, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, type VideoExportOptions, VideoExporter, type WorldBlockIntersection, type WorldChunkSource, type WorldEntityIntersection, WorldStreamer, type WorldStreamerOptions, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, buildFluidQuads, buildSectionGeometry, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, copySectionLight, createCanvas, createFluidGeometry, createGuiTextGeometry, createGuiTextureGeometry, createImage, decodeSceneDocument, encodeSceneDocument, entityAnimationTime, estimateBytesUsed, fluidKindOf, getBlockFluidState, getFluidKind, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isFlyControls, isGuiObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isResourceLocation, isSceneObject, isTransformable, isTripleArray, isVector3, layoutGuiText, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, parseSceneDocument, prefix, probeImageSize, registerBrowserEnv, resolveBlockFluidState, resolveLegacyBlock, resolveLegacyBlockState, sampleEntityAnimation, sampleEntityKeyframes, sampleFluid, sampleSectionLight, sectionGeometryTransferables, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode, trimCanvas, validateAnimationWeights, yieldToEventLoop };