minerender 2.1.0-alpha.2 → 2.1.0-alpha.21

package/dist/browser/index.d.ts

@@ -1,14 +1,11 @@
 import * as three from 'three';
-import { Vector3, PixelFormat, BoxGeometry, Material, Mesh, Euler, Vector2, BufferAttribute, Float32BufferAttribute, Object3D, Box3, InstancedMesh, PerspectiveCamera, OrthographicCamera, Matrix4, Scene, Texture, Camera, WebGLRenderer, EventDispatcher, Raycaster, Intersection, CanvasTexture, BufferGeometry as BufferGeometry$1, InterleavedBufferAttribute, TrianglesDrawModes, Line, Points, MOUSE, TOUCH } from 'three';
+import { Vector3, PixelFormat, BoxGeometry, Material, Mesh, Euler, Vector2, BufferAttribute, Float32BufferAttribute, BufferGeometry, Object3D, Box3, InstancedMesh, PerspectiveCamera, OrthographicCamera, Matrix4, Scene, Object3DEventMap, Texture, Camera, MOUSE, TOUCH, WebGLRenderer, EventDispatcher, Raycaster, Intersection, CanvasTexture, InterleavedBufferAttribute, TrianglesDrawModes, Line, Points } from 'three';
 import * as nodeCanvas from 'canvas';
 import { ImageData as ImageData$1, CanvasRenderingContext2D } from 'canvas';
-import { AxiosResponse, AxiosRequestConfig } from 'axios';
 import { Buffer as Buffer$1 } from 'buffer';
 import { NBT } from 'prismarine-nbt';
 import { ZipReader } from '@zip.js/zip.js';
 import { AsyncLoadingCache, SimpleCache } from '@inventivetalent/loading-cache';
-import { BufferGeometry } from 'three/src/core/BufferGeometry';
-import { Material as Material$1 } from 'three/src/materials/Material';
 import Stats from 'stats.js';
 import { EffectComposer } from 'postprocessing';
 
@@ -17,7 +14,7 @@ interface AnimatorFunction {
 }
 
 declare enum Axis {
-    X = "X",
+    X = "x",
     Y = "y",
     Z = "z"
 }
@@ -62,10 +59,11 @@ declare function createCanvas(width: number, height: number): CompatCanvas;
 declare abstract class PersistentCache<B = unknown> {
     readonly backing: B;
     /** Bump to invalidate every persisted entry. */
-    static readonly VERSION = 1;
+    static readonly VERSION = 2;
     static open(name: string): PersistentCache;
     protected constructor(backing: B);
     abstract get<T>(key: string): Promise<T>;
+    /** Loads a missing entry and stores only non-nullish results. */
     getOrLoad<T>(key: string, loader: (key: string) => Promise<T>): Promise<T>;
     abstract put<T>(key: string, value: T): Promise<T>;
     abstract delete<T>(key: string): Promise<void>;
@@ -175,6 +173,7 @@ declare class AssetKey extends BasicAssetKey {
     rootType: "assets" | "data" | string;
     extension: ".json" | ".png" | string;
     root?: string | undefined;
+    readonly isAssetKey: true;
     constructor(namespace: string, path: string, assetType?: AssetType | undefined, type?: string | undefined, rootType?: "assets" | "data" | string, extension?: ".json" | ".png" | string, root?: string | undefined);
     static parse(assetType: AssetType, str: string, origin?: AssetKey): AssetKey;
     toString(): string;
@@ -256,6 +255,46 @@ declare enum GuiLight {
     SIDE = "side"
 }
 
+interface RequestConfig extends RequestInit {
+    url: string;
+    /** Prepended to relative URLs, preserving any path in the base URL. */
+    baseURL?: string;
+    /** Timeout per attempt in milliseconds, including body reading. Defaults to 5000; 0 disables it. */
+    timeout?: number;
+    responseType?: "json" | "arraybuffer";
+}
+interface RequestResponse<T = any> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+    /** Final URL after redirects. */
+    url: string;
+}
+declare class RequestError extends Error {
+    readonly response?: RequestResponse<undefined> | undefined;
+    readonly cause?: unknown;
+    constructor(message: string, response?: RequestResponse<undefined> | undefined, cause?: unknown);
+}
+declare class Requests {
+    private static genericQueue;
+    private static mcAssetRequestQueue;
+    static genericRequest(request: RequestConfig): Promise<RequestResponse>;
+    static mcAssetRequest(request: RequestConfig): Promise<RequestResponse>;
+    static setMcAssetRoot(root: string): void;
+    /** Counts unsettled calls, including retry delays and requests still running after shutdown. */
+    static get queueSizes(): {
+        generic: number;
+        mcAsset: number;
+    };
+    /**
+     * Permanently stops both queues and rejects waiting, retrying, and future requests.
+     * Requests already running can finish. Idle queues hold no timer, so Node can exit without
+     * this cleanup. See {@link shutdown}.
+     */
+    static end(): void;
+}
+
 declare class WrappedImage {
     readonly dta: ExtractableImageData;
     constructor(dta: ExtractableImageData);
@@ -291,7 +330,7 @@ declare class ImageLoader {
     static infoToData(info: ImageInfo): Promise<ImageData>;
     static getData(src: string): Promise<ImageData>;
     static getCanvasData(src: string): Promise<ExtractableImageData>;
-    static processResponse(response: Partial<AxiosResponse>): Promise<ImageInfo>;
+    static processResponse(response: Pick<RequestResponse<ArrayBuffer>, "data" | "url">): Promise<ImageInfo>;
     static loadInfo(src: string): Promise<ImageInfo>;
     static getInfo(src: string): Promise<ImageInfo>;
     static loadWrapped(src: string): Promise<WrappedImage>;
@@ -431,7 +470,7 @@ interface Transformable {
 declare function isTransformable(obj: any): obj is Transformable;
 
 declare const changeEvent: {
-    type: string;
+    type: "change";
 };
 type Maybe<T> = T | undefined;
 declare function md5(str: string): string;
@@ -515,6 +554,7 @@ declare class UVMapper {
     static setCubeUvs(geometry: BoxGeometry, originalTextureSize: DoubleArray, actualTextureSize: DoubleArray, faces: ModelFaces): void;
     static facesToUvArray(faces: ModelFaces, originalTextureSize: DoubleArray, actualTextureSize: DoubleArray): number[];
     static facesToUv(faces: ModelFaces, originalTextureSize: DoubleArray, actualTextureSize: DoubleArray): Float32BufferAttribute;
+    static lockUvs(geometry: BoxGeometry, faces: ModelFaces, atlas: TextureAtlas, rotation: Euler): void;
     static getAtlas(model: Model): Promise<Maybe<TextureAtlas>>;
     static fillMissingTextureKeys<T>(textures: ModelTextures, target: {
         [k: string]: T;
@@ -536,14 +576,13 @@ declare class MinecraftFaceUV {
 }
 
 /**
- * Releases every long-lived timer MineRender holds, so a Node process can exit.
+ * Stops the shared Ticker and request queues, and clears the in-memory caches.
  *
- * Both `@inventivetalent/loading-cache` (cache expiry) and `jobqu` (request queue draining) use
- * self-rescheduling timers that are not unref'd, which keeps the event loop alive for as long as
- * the library is loaded. Browsers don't care, but anything headless - a render server, a CLI, a
- * test run - has to call this when it's done.
+ * Idle Node processes can exit without calling this: cache and Ticker timers are unref'd,
+ * and idle request queues hold no timer. Pending requests keep their normal timer references.
  *
- * The library stays usable afterwards; the caches and queues simply start over.
+ * Call this only when finished with MineRender. Queued, retrying, and future requests reject;
+ * HTTP requests already running can finish. Queue shutdown is permanent, and cache expiry timers do not restart.
  */
 declare function shutdown(): void;
 
@@ -616,6 +655,14 @@ declare abstract class AssetSource {
     protected constructor();
     abstract get<T extends MinecraftAsset>(key: AssetKey, parser: AssetParser | string): Promise<Maybe<T>>;
 }
+/** A source failed to load or parse an asset; cause retains the original failure. */
+declare class AssetLoadError extends Error {
+    readonly source: AssetSource;
+    readonly key: AssetKey;
+    readonly path: string;
+    readonly cause: unknown;
+    constructor(source: AssetSource, key: AssetKey, path: string, cause: unknown);
+}
 
 declare class AssetLoader {
     static ROOT: string;
@@ -623,7 +670,13 @@ declare class AssetLoader {
     static addSource(key: string, source: AssetSource, override?: boolean): void;
     static removeSource(key: string): Maybe<AssetSource>;
     static getAll<T extends MinecraftAsset>(key: AssetKey, parser: AssetParser | string): Promise<T[]>;
+    /** Returns the first defined result in source-priority order, without merging assets. */
     static get<T extends MinecraftAsset>(key: AssetKey, parser: AssetParser | string): Promise<Maybe<T>>;
+    /** Tries each path within a source before considering lower-priority sources. */
+    static getFirst<T extends MinecraftAsset>(keys: readonly AssetKey[], parser: AssetParser | string): Promise<Maybe<{
+        key: AssetKey;
+        asset: T;
+    }>>;
 }
 
 interface BlockState extends MinecraftAsset {
@@ -638,18 +691,19 @@ interface BlockStateVariant {
     y?: number;
     x?: number;
     uvlock?: boolean;
+    weight?: number;
 }
 interface BlockStateMultipart {
-    when?: MultipartCondition | {
-        OR: MultipartCondition[];
-    };
-    apply?: BlockStateVariant;
-}
-interface MultipartCondition {
-    [key: string]: string;
+    when?: MultipartCondition;
+    apply?: BlockStateVariant | BlockStateVariant[];
 }
+type MultipartCondition = Record<string, string> | {
+    OR: MultipartCondition[];
+} | {
+    AND: MultipartCondition[];
+};
 
-declare const DEFAULT_ROOT = "https://assets.mcasset.cloud/1.17.1";
+declare const DEFAULT_ROOT = "https://assets.mcasset.cloud/1.21.11";
 declare const DEFAULT_NAMESPACE = "minecraft";
 declare class Assets {
     /**
@@ -714,6 +768,8 @@ declare class Models {
     private static get PERSISTENT_CACHE();
     static getItemList(): Promise<string[]>;
     static loadAndMerge(key: AssetKey): Promise<Maybe<Model>>;
+    private static getItemModel;
+    private static defaultItemModel;
     static getRaw(key: AssetKey): Promise<Maybe<Model>>;
     static getMerged(key: AssetKey): Promise<Maybe<Model>>;
     static get(key: AssetKey): Promise<Maybe<Model>>;
@@ -736,6 +792,12 @@ interface Block {
     nbt?: any;
 }
 
+declare class BlockTints {
+    /** Resolves block preview colors without biome context; explicit tints take precedence. */
+    static get(key: AssetKey | undefined, state: BlockStateProperties, model: Model, tints?: Record<number, number>): Promise<Record<number, number> | undefined>;
+    private static grassColor;
+}
+
 interface Instanceable {
     nextInstance(): InstanceReference<SceneObject>;
     getMatrixAt(index: number, matrix?: Matrix4): Matrix4;
@@ -792,6 +854,10 @@ declare class ModelObject extends SceneObject {
     protected applyTextures(): void;
 }
 interface ModelObjectOptions extends SceneObjectOptions {
+    /** Quarter-turn block rotation in radians to compensate when locking UVs. */
+    uvLockRotation?: TripleArray;
+    /** sRGB 0xRRGGBB colors by face tint index; omitted indices stay white. */
+    tints?: Record<number, number>;
 }
 declare function isModelObject(obj: any): obj is ModelObject;
 
@@ -854,6 +920,7 @@ declare class EntityObject extends SceneObject {
     constructor(entity: EntityModel, options?: Partial<EntityObjectOptions>);
     init(): Promise<void>;
     dispose(): void;
+    private get textureKey();
     protected loadTextures(): Promise<void>;
     protected createMeshes(force?: boolean): void;
     protected applyTextures(): Promise<void>;
@@ -886,7 +953,9 @@ interface MineRenderSceneOptions {
 }
 declare function isMineRenderScene(obj: any): obj is MineRenderScene;
 
-declare class SceneObject extends Object3D implements Disposable, Instanceable, Transformable {
+declare class SceneObject extends Object3D<Object3DEventMap & {
+    change: {};
+}> implements Disposable, Instanceable, Transformable {
     readonly isSceneObject: true;
     static readonly DEFAULT_OPTIONS: SceneObjectOptions;
     readonly options: SceneObjectOptions;
@@ -912,9 +981,9 @@ declare class SceneObject extends Object3D implements Disposable, Instanceable,
      */
     toggleGroupVisibility(name: string, visible?: boolean): boolean;
     protected addOrReplaceMesh(mesh: Mesh, parent: Object3D, name?: string): void;
-    protected createAndAddMesh(name?: string, group?: Object3D, geometry?: BufferGeometry, material?: Material$1 | Material$1[], offsetAxis?: Axis, offset?: number): Mesh;
-    protected createMesh(name?: string, geometry?: BufferGeometry, material?: Material$1 | Material$1[], offsetAxis?: Axis, offset?: number): Mesh;
-    protected createInstancedMesh(name: Maybe<string>, geometry: BufferGeometry, material: Material$1 | Material$1[], count: number): InstancedMesh;
+    protected createAndAddMesh(name?: string, group?: Object3D, geometry?: BufferGeometry, material?: Material | Material[], offsetAxis?: Axis, offset?: number): Mesh;
+    protected createMesh(name?: string, geometry?: BufferGeometry, material?: Material | Material[], offsetAxis?: Axis, offset?: number): Mesh;
+    protected createInstancedMesh(name: Maybe<string>, geometry: BufferGeometry, material: Material | Material[], count: number): InstancedMesh;
     /**
      * Get a mesh by its name
      */
@@ -1083,8 +1152,8 @@ interface NBTAsset extends MinecraftAsset, NBT {
 }
 
 interface ResponseParser<T extends MinecraftAsset> {
-    config(request: AxiosRequestConfig): any;
-    parse(response: AxiosResponse): Maybe<T> | Promise<Maybe<T>>;
+    config(request: RequestConfig): any;
+    parse(response: RequestResponse): Maybe<T> | Promise<Maybe<T>>;
 }
 
 declare class HostedAssetSource extends AssetSource {
@@ -1212,14 +1281,19 @@ declare class Caching {
     static readonly mergedModelCache: AsyncLoadingCache<CacheKey, Model>;
     static readonly modelTextureAtlasCache: AsyncLoadingCache<CacheKey, TextureAtlas>;
     static readonly blockStateCache: AsyncLoadingCache<CacheKey, BlockState>;
+    static readonly listAssetCache: AsyncLoadingCache<CacheKey, ListAsset>;
+    static readonly defaultBlockStatesCache: AsyncLoadingCache<CacheKey, DefaultBlockStates>;
+    static readonly blockTintCache: AsyncLoadingCache<CacheKey, number>;
+    static readonly entityModelsCache: AsyncLoadingCache<CacheKey, EntityModels>;
+    private static createAssetCache;
     /** Every cache above, so clear()/end() can never fall out of sync with the field list again. */
     private static get all();
     static clear(): void;
     /**
      * Clears every cache and stops its expiry timer.
      *
-     * loading-cache reschedules that timer indefinitely, so a Node process will not exit until
-     * this is called - see {@link shutdown}.
+     * Expiry timers are unref'd in Node, so idle processes can exit without this cleanup.
+     * Use {@link shutdown} to also stop requests and the shared Ticker.
      */
     static end(): void;
     static get cacheSizes(): {};
@@ -1235,6 +1309,83 @@ declare class GuiObject extends SceneObject {
 interface GuiObjectOptions extends SceneObjectOptions {
 }
 
+declare class OrbitControls {
+    constructor(object: Camera, domElement?: HTMLElement);
+
+    object: Camera;
+    domElement: HTMLElement | HTMLDocument;
+
+    // API
+    enabled: boolean;
+    target: Vector3;
+
+    // deprecated
+    center: Vector3;
+
+    minDistance: number;
+    maxDistance: number;
+
+    minZoom: number;
+    maxZoom: number;
+
+    minPolarAngle: number;
+    maxPolarAngle: number;
+
+    minAzimuthAngle: number;
+    maxAzimuthAngle: number;
+
+    enableDamping: boolean;
+    dampingFactor: number;
+
+    enableZoom: boolean;
+    zoomSpeed: number;
+
+    enableRotate: boolean;
+    rotateSpeed: number;
+
+    enablePan: boolean;
+    panSpeed: number;
+    screenSpacePanning: boolean;
+    keyPanSpeed: number;
+
+    autoRotate: boolean;
+    autoRotateSpeed: number;
+
+    enableKeys: boolean;
+    keys: { LEFT: string; UP: string; RIGHT: string; BOTTOM: string };
+    mouseButtons: { LEFT: MOUSE; MIDDLE: MOUSE; RIGHT: MOUSE };
+    touches: { ONE: TOUCH; TWO: TOUCH };
+
+    update(): boolean;
+
+    listenToKeyEvents(domElement: HTMLElement): void;
+
+    saveState(): void;
+
+    reset(): void;
+
+    dispose(): void;
+
+    getPolarAngle(): number;
+
+    getAzimuthalAngle(): number;
+
+    getDistance(): number;
+
+    // EventDispatcher mixins
+    addEventListener(type: string, listener: (event: any) => void): void;
+
+    hasEventListener(type: string, listener: (event: any) => void): boolean;
+
+    removeEventListener(type: string, listener: (event: any) => void): void;
+
+    dispatchEvent(event: { type: string; target: any }): void;
+}
+
+declare class MapControls extends OrbitControls {
+    constructor(object: Camera, domElement?: HTMLElement);
+}
+
 declare class Renderer implements Disposable {
     static readonly DEFAULT_OPTIONS: RendererOptions;
     readonly options: RendererOptions;
@@ -1242,14 +1393,14 @@ declare class Renderer implements Disposable {
     protected _scene: MineRenderScene;
     protected _camera: Camera;
     protected _renderer: WebGLRenderer;
-    protected _composer: EffectComposer;
+    protected _composer?: EffectComposer;
+    protected _controls?: OrbitControls;
     protected _stats?: Stats;
     protected _dirty: boolean;
     protected _animationLoop: any;
-    protected _fpsTimer: any;
-    protected _animationTimer?: NodeJS.Timeout;
-    protected _animationFrame?: number;
+    protected _frameInterval?: number;
     protected _resizeListener?: () => void;
+    private _nextFrameTime?;
     private _disposed;
     private readonly _debugHelpers;
     private readonly _eventDispatchers;
@@ -1258,7 +1409,8 @@ declare class Renderer implements Disposable {
     protected createScene(): MineRenderScene;
     protected createCamera(): Camera;
     protected createRenderer(): WebGLRenderer;
-    protected createComposer(): EffectComposer;
+    protected createComposer(): Maybe<EffectComposer>;
+    protected createControls(): Maybe<OrbitControls>;
     init(): void;
     get element(): Maybe<HTMLElement>;
     appendTo(element: HTMLElement): void;
@@ -1266,7 +1418,7 @@ declare class Renderer implements Disposable {
      * Redraws when the dispatcher emits the selected event. Registering the same pair twice has no effect.
      * The renderer removes its listener on disposal; the caller retains ownership of the dispatcher.
      */
-    registerEventDispatcher(dispatcher: EventDispatcher, changeEvent?: string): void;
+    registerEventDispatcher(dispatcher: EventDispatcher<any>, changeEvent?: string): void;
     resize(width: number, height: number): void;
     get dirty(): boolean;
     set dirty(dirty: boolean);
@@ -1286,12 +1438,15 @@ declare class Renderer implements Disposable {
     get scene(): MineRenderScene;
     get camera(): Camera;
     get renderer(): WebGLRenderer;
-    get composer(): EffectComposer;
+    get composer(): Maybe<EffectComposer>;
+    /** Renderer-owned controls, or undefined when disabled at construction or after disposal. */
+    get controls(): Maybe<OrbitControls>;
 }
 interface RendererOptions {
     camera: CameraOptions;
     render: RenderOptions;
     composer: ComposerOptions;
+    controls?: ControlsOptions;
     debug: DebugOptions;
 }
 interface CameraOptions {
@@ -1312,6 +1467,7 @@ interface CameraOptions {
     lookingAt: Vector3 | TripleArray;
 }
 interface RenderOptions {
+    /** Maximum draw rate (60 by default); zero or a negative value disables the limit. */
     fpsLimit: number;
     stats: boolean;
     antialias: boolean;
@@ -1322,6 +1478,9 @@ interface RenderOptions {
 interface ComposerOptions {
     enabled: boolean;
 }
+interface ControlsOptions {
+    enabled: boolean;
+}
 interface DebugOptions {
     grid: boolean;
     axes: boolean;
@@ -1336,7 +1495,7 @@ declare class SceneInspector {
     private selectedObject?;
     constructor(renderer: Renderer);
     protected init(): void;
-    findMeshChildren(from: Object3D, out?: Mesh[]): Mesh<three.BufferGeometry, three.Material | three.Material[]>[];
+    findMeshChildren(from: Object3D, out?: Mesh[]): Mesh<three.BufferGeometry<three.NormalBufferAttributes>, three.Material | three.Material[], three.Object3DEventMap>[];
     onClick(event: any): void;
     appendTo(el: HTMLElement): void;
     protected handleRaycasterObjects(intersections: Intersection[]): void;
@@ -1373,26 +1532,6 @@ declare class StatLine {
     update(): void;
 }
 
-declare class Requests {
-    private static axiosInstance;
-    private static mcAssetInstance;
-    private static genericQueue;
-    private static mcAssetRequestQueue;
-    static genericRequest(request: AxiosRequestConfig): Promise<AxiosResponse>;
-    static mcAssetRequest(request: AxiosRequestConfig): Promise<AxiosResponse>;
-    private static shouldRetry;
-    static setMcAssetRoot(root: string): void;
-    static get queueSizes(): {
-        generic: number;
-        mcAsset: number;
-    };
-    /**
-     * Stops both queue timers. jobqu reschedules itself indefinitely, so a Node process will not
-     * exit until this is called - see {@link shutdown}.
-     */
-    static end(): void;
-}
-
 type SkinGeometries = Record<SkinPart, TripleArray>;
 declare const classicSkinGeometries: SkinGeometries;
 declare const slimSkinGeometries: SkinGeometries;
@@ -1411,6 +1550,8 @@ declare class Skins {
     static capeFromUsername(username: string): Promise<Maybe<string>>;
     static capeFromCapesDev(uuid: string, capeType?: string): Promise<Maybe<string>>;
     private static usernameToUuid;
+    private static usernameToUuidMcProxy;
+    /** @deprecated **/
     private static usernameToUuidSkinProxy;
     private static usernameToUuidMineTools;
     private static getProfileFromMinetools;
@@ -1420,11 +1561,18 @@ declare class Skins {
     private static getCrafatarCapeUrl;
     private static getMcHeadsSkinUrl;
     private static getMineSkinPlayerSkinUrl;
+    /** @deprecated **/
     private static getSkinProxySkinUrl;
+    /** @deprecated **/
     private static getSkinProxyCapeUrl;
+    private static getMcProxySkinUrl;
+    private static getMcProxyCapeUrl;
 }
 
 declare class TextureLoader {
+    private static readonly failedTextures;
+    /** Reports whether image loading failed, so cached textures can be retried. */
+    static hasFailed(texture: Texture): boolean;
     protected static createTexture(): Texture;
     static loadInBackground(src: string, format?: PixelFormat, rotation?: number): Texture;
     static load(src: string, format?: PixelFormat, rotation?: number): Texture;
@@ -1438,91 +1586,14 @@ declare class Textures {
     static getImage(key: TextureKey): Texture;
 }
 
-declare function mergeBufferGeometries(geometries: BufferGeometry$1[], useGroups?: boolean): BufferGeometry$1;
+declare function mergeBufferGeometries(geometries: BufferGeometry[], useGroups?: boolean): BufferGeometry;
 declare function mergeBufferAttributes(attributes: BufferAttribute[]): BufferAttribute;
 declare function interleaveAttributes(attributes: BufferAttribute[]): InterleavedBufferAttribute;
-declare function estimateBytesUsed(geometry: BufferGeometry$1): number;
-declare function mergeVertices(geometry: BufferGeometry$1, tolerance?: number): BufferGeometry$1;
-declare function toTrianglesDrawMode(geometry: BufferGeometry$1, drawMode: TrianglesDrawModes): BufferGeometry$1;
+declare function estimateBytesUsed(geometry: BufferGeometry): number;
+declare function mergeVertices(geometry: BufferGeometry, tolerance?: number): BufferGeometry;
+declare function toTrianglesDrawMode(geometry: BufferGeometry, drawMode: TrianglesDrawModes): BufferGeometry;
 declare function computeMorphedAttributes(object: Mesh | Line | Points): object;
 
-declare class OrbitControls {
-    constructor(object: Camera, domElement?: HTMLElement);
-
-    object: Camera;
-    domElement: HTMLElement | HTMLDocument;
-
-    // API
-    enabled: boolean;
-    target: Vector3;
-
-    // deprecated
-    center: Vector3;
-
-    minDistance: number;
-    maxDistance: number;
-
-    minZoom: number;
-    maxZoom: number;
-
-    minPolarAngle: number;
-    maxPolarAngle: number;
-
-    minAzimuthAngle: number;
-    maxAzimuthAngle: number;
-
-    enableDamping: boolean;
-    dampingFactor: number;
-
-    enableZoom: boolean;
-    zoomSpeed: number;
-
-    enableRotate: boolean;
-    rotateSpeed: number;
-
-    enablePan: boolean;
-    panSpeed: number;
-    screenSpacePanning: boolean;
-    keyPanSpeed: number;
-
-    autoRotate: boolean;
-    autoRotateSpeed: number;
-
-    enableKeys: boolean;
-    keys: { LEFT: string; UP: string; RIGHT: string; BOTTOM: string };
-    mouseButtons: { LEFT: MOUSE; MIDDLE: MOUSE; RIGHT: MOUSE };
-    touches: { ONE: TOUCH; TWO: TOUCH };
-
-    update(): boolean;
-
-    listenToKeyEvents(domElement: HTMLElement): void;
-
-    saveState(): void;
-
-    reset(): void;
-
-    dispose(): void;
-
-    getPolarAngle(): number;
-
-    getAzimuthalAngle(): number;
-
-    getDistance(): number;
-
-    // EventDispatcher mixins
-    addEventListener(type: string, listener: (event: any) => void): void;
-
-    hasEventListener(type: string, listener: (event: any) => void): boolean;
-
-    removeEventListener(type: string, listener: (event: any) => void): void;
-
-    dispatchEvent(event: { type: string; target: any }): void;
-}
-
-declare class MapControls extends OrbitControls {
-    constructor(object: Camera, domElement?: HTMLElement);
-}
-
 interface BlockInfo {
     block: Block;
     object: BlockObject;
@@ -1611,8 +1682,8 @@ declare class BrowserCache extends PersistentCache<LocalForage> {
  *
  * `image-size` pulls in `fs`/`path` at module scope, so it can only live in the Node build.
  * Everything MineRender loads is a PNG in practice; GIF and JPEG are handled as a courtesy and
- * anything else falls through to an empty result (callers treat that as 0x0).
+ * anything else falls through to an empty result, which ImageLoader rejects.
  */
 declare function probeImageSize(data: Uint8Array): ImageSizeInfo;
 
-export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type Block, BlockEntityModels, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, type BlockStateVariant, type BlockStateVariants, BlockStates, type BoxGeometryKey, BrowserArchiveProxy, BrowserCache, BrowserEnv, CUBE_FACES, type CacheKey, Caching, type CameraOptions, CanvasImage, Chunk, type CompatCanvas, type CompatImage, type ComposerOptions, type Cube, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, type Disposable, type DoubleArray, type ElementFace, type ElementRotation, Entities, type EntityModel, EntityModels, EntityObject, type EntityObjectOptions, Env, type EnvProvider, type ExtractableImageData, type FromTo, Geometries, GuiLight, GuiObject, type GuiObjectOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, type ItemModel, type ItemModelTextures, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, type ModelPart, ModelTextures, Models, type MultiBlockBlock, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, OrbitControls, PersistentCache, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererOptions, Requests, type ResponseParser, SKIN_PARTS, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, type Serializable, type SkinGeometries, SkinObject, type SkinObjectOptions, SkinPart, type SkinTextureCoordinates, Skins, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, applyModelPartRotation, axisToVec3, base64decode, base64encode, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createImage, estimateBytesUsed, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, probeImageSize, registerBrowserEnv, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode };
+export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type Block, BlockEntityModels, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, type BlockStateVariant, type BlockStateVariants, BlockStates, BlockTints, type BoxGeometryKey, BrowserArchiveProxy, BrowserCache, BrowserEnv, CUBE_FACES, type CacheKey, Caching, type CameraOptions, CanvasImage, Chunk, type CompatCanvas, type CompatImage, type ComposerOptions, type ControlsOptions, type Cube, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, type Disposable, type DoubleArray, type ElementFace, type ElementRotation, Entities, type EntityModel, EntityModels, EntityObject, type EntityObjectOptions, Env, type EnvProvider, type ExtractableImageData, type FromTo, Geometries, GuiLight, GuiObject, type GuiObjectOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, type ItemModel, type ItemModelTextures, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, type ModelPart, ModelTextures, Models, type MultiBlockBlock, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, OrbitControls, PersistentCache, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererOptions, type RequestConfig, RequestError, type RequestResponse, Requests, type ResponseParser, SKIN_PARTS, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, type Serializable, type SkinGeometries, SkinObject, type SkinObjectOptions, SkinPart, type SkinTextureCoordinates, Skins, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, applyModelPartRotation, axisToVec3, base64decode, base64encode, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createImage, estimateBytesUsed, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, probeImageSize, registerBrowserEnv, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode };