minerender 2.1.0-alpha.0 → 2.1.0-alpha.3

package/README.md

@@ -22,5 +22,3 @@ renderer.start();
 The package provides ESM and CommonJS entries for browsers and Node.js, plus
 `dist/bundle.js` for the `MineRender` browser global. Node imports require the optional
 native `canvas` dependency; headless rendering is still in development.
-
-For development, use Node.js 22+ and Yarn 4.5.3 through Corepack. Run `yarn install --immutable`, `yarn build`, `yarn typecheck`, and `yarn test`. See [AGENTS.md](./AGENTS.md) for contributor guidance.

package/dist/browser/index.d.mts

@@ -1,5 +1,5 @@
 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, Object3D, Box3, InstancedMesh, PerspectiveCamera, OrthographicCamera, Matrix4, Scene, Texture, Camera, MOUSE, TOUCH, WebGLRenderer, EventDispatcher, Raycaster, Intersection, CanvasTexture, BufferGeometry as BufferGeometry$1, InterleavedBufferAttribute, TrianglesDrawModes, Line, Points } from 'three';
 import * as nodeCanvas from 'canvas';
 import { ImageData as ImageData$1, CanvasRenderingContext2D } from 'canvas';
 import { AxiosResponse, AxiosRequestConfig } from 'axios';
@@ -649,7 +649,7 @@ interface MultipartCondition {
     [key: string]: string;
 }
 
-declare const DEFAULT_ROOT = "https://cdn.mcasset.cloud/file/minecraft-assets/1.17.1";
+declare const DEFAULT_ROOT = "https://assets.mcasset.cloud/1.17.1";
 declare const DEFAULT_NAMESPACE = "minecraft";
 declare class Assets {
     /**
@@ -869,9 +869,12 @@ declare class MineRenderScene extends Scene {
     readonly stats: SceneStats;
     protected readonly instanceManager: InstanceManager;
     dirty: boolean;
+    private readonly observedObjects;
+    private readonly onObjectChange;
     constructor(options?: DeepPartial<MineRenderSceneOptions>);
-    add(...object: any[]): this;
-    remove(...object: any[]): this;
+    add(...objects: Object3D[]): this;
+    remove(...objects: Object3D[]): this;
+    private updateObjectRegistration;
     initAndAdd(...object: SceneObject[]): Promise<this>;
     addSceneObject<A extends BasicMinecraftAsset, T extends SceneObject, O extends SceneObjectOptions>(asset: A, objectSupplier: () => T | Promise<T>, _options?: Partial<O>, parent?: Object3D): Promise<T | InstanceReference<T>>;
     addModel(model: Model, options?: Partial<ModelObjectOptions>, parent?: Object3D): Promise<ModelObject | InstanceReference<ModelObject>>;
@@ -1232,7 +1235,84 @@ declare class GuiObject extends SceneObject {
 interface GuiObjectOptions extends SceneObjectOptions {
 }
 
-declare class Renderer {
+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;
     protected _element?: HTMLElement;
@@ -1240,6 +1320,7 @@ declare class Renderer {
     protected _camera: Camera;
     protected _renderer: WebGLRenderer;
     protected _composer: EffectComposer;
+    protected _controls?: OrbitControls;
     protected _stats?: Stats;
     protected _dirty: boolean;
     protected _animationLoop: any;
@@ -1247,16 +1328,22 @@ declare class Renderer {
     protected _animationTimer?: NodeJS.Timeout;
     protected _animationFrame?: number;
     protected _resizeListener?: () => void;
+    private _disposed;
+    private readonly _debugHelpers;
+    private readonly _eventDispatchers;
+    private readonly _changeListener;
     constructor(options?: DeepPartial<RendererOptions>);
     protected createScene(): MineRenderScene;
     protected createCamera(): Camera;
     protected createRenderer(): WebGLRenderer;
     protected createComposer(): EffectComposer;
+    protected createControls(): Maybe<OrbitControls>;
     init(): void;
     get element(): Maybe<HTMLElement>;
     appendTo(element: HTMLElement): void;
     /**
-     * Register an EventDispatcher which may update the scene or renderer in order to redraw the scene
+     * 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;
     resize(width: number, height: number): void;
@@ -1264,6 +1351,12 @@ declare class Renderer {
     set dirty(dirty: boolean);
     start(): void;
     stop(): void;
+    /**
+     * Stops rendering and releases owned resources. Repeated calls have no effect, and a disposed
+     * renderer cannot be restarted. Scene objects are detached; shared assets and caller-owned
+     * controls must be managed by their owners.
+     */
+    dispose(): void;
     private animate;
     toImage(): string;
     protected get attachedToBody(): boolean;
@@ -1273,11 +1366,14 @@ declare class Renderer {
     get camera(): Camera;
     get renderer(): WebGLRenderer;
     get composer(): 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 {
@@ -1308,6 +1404,9 @@ interface RenderOptions {
 interface ComposerOptions {
     enabled: boolean;
 }
+interface ControlsOptions {
+    enabled: boolean;
+}
 interface DebugOptions {
     grid: boolean;
     axes: boolean;
@@ -1432,83 +1531,6 @@ declare function mergeVertices(geometry: BufferGeometry$1, tolerance?: number):
 declare function toTrianglesDrawMode(geometry: BufferGeometry$1, drawMode: TrianglesDrawModes): BufferGeometry$1;
 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;
@@ -1601,4 +1623,4 @@ declare class BrowserCache extends PersistentCache<LocalForage> {
  */
 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, 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 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, 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 };

package/dist/browser/index.d.ts

@@ -1,5 +1,5 @@
 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, Object3D, Box3, InstancedMesh, PerspectiveCamera, OrthographicCamera, Matrix4, Scene, Texture, Camera, MOUSE, TOUCH, WebGLRenderer, EventDispatcher, Raycaster, Intersection, CanvasTexture, BufferGeometry as BufferGeometry$1, InterleavedBufferAttribute, TrianglesDrawModes, Line, Points } from 'three';
 import * as nodeCanvas from 'canvas';
 import { ImageData as ImageData$1, CanvasRenderingContext2D } from 'canvas';
 import { AxiosResponse, AxiosRequestConfig } from 'axios';
@@ -649,7 +649,7 @@ interface MultipartCondition {
     [key: string]: string;
 }
 
-declare const DEFAULT_ROOT = "https://cdn.mcasset.cloud/file/minecraft-assets/1.17.1";
+declare const DEFAULT_ROOT = "https://assets.mcasset.cloud/1.17.1";
 declare const DEFAULT_NAMESPACE = "minecraft";
 declare class Assets {
     /**
@@ -869,9 +869,12 @@ declare class MineRenderScene extends Scene {
     readonly stats: SceneStats;
     protected readonly instanceManager: InstanceManager;
     dirty: boolean;
+    private readonly observedObjects;
+    private readonly onObjectChange;
     constructor(options?: DeepPartial<MineRenderSceneOptions>);
-    add(...object: any[]): this;
-    remove(...object: any[]): this;
+    add(...objects: Object3D[]): this;
+    remove(...objects: Object3D[]): this;
+    private updateObjectRegistration;
     initAndAdd(...object: SceneObject[]): Promise<this>;
     addSceneObject<A extends BasicMinecraftAsset, T extends SceneObject, O extends SceneObjectOptions>(asset: A, objectSupplier: () => T | Promise<T>, _options?: Partial<O>, parent?: Object3D): Promise<T | InstanceReference<T>>;
     addModel(model: Model, options?: Partial<ModelObjectOptions>, parent?: Object3D): Promise<ModelObject | InstanceReference<ModelObject>>;
@@ -1232,7 +1235,84 @@ declare class GuiObject extends SceneObject {
 interface GuiObjectOptions extends SceneObjectOptions {
 }
 
-declare class Renderer {
+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;
     protected _element?: HTMLElement;
@@ -1240,6 +1320,7 @@ declare class Renderer {
     protected _camera: Camera;
     protected _renderer: WebGLRenderer;
     protected _composer: EffectComposer;
+    protected _controls?: OrbitControls;
     protected _stats?: Stats;
     protected _dirty: boolean;
     protected _animationLoop: any;
@@ -1247,16 +1328,22 @@ declare class Renderer {
     protected _animationTimer?: NodeJS.Timeout;
     protected _animationFrame?: number;
     protected _resizeListener?: () => void;
+    private _disposed;
+    private readonly _debugHelpers;
+    private readonly _eventDispatchers;
+    private readonly _changeListener;
     constructor(options?: DeepPartial<RendererOptions>);
     protected createScene(): MineRenderScene;
     protected createCamera(): Camera;
     protected createRenderer(): WebGLRenderer;
     protected createComposer(): EffectComposer;
+    protected createControls(): Maybe<OrbitControls>;
     init(): void;
     get element(): Maybe<HTMLElement>;
     appendTo(element: HTMLElement): void;
     /**
-     * Register an EventDispatcher which may update the scene or renderer in order to redraw the scene
+     * 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;
     resize(width: number, height: number): void;
@@ -1264,6 +1351,12 @@ declare class Renderer {
     set dirty(dirty: boolean);
     start(): void;
     stop(): void;
+    /**
+     * Stops rendering and releases owned resources. Repeated calls have no effect, and a disposed
+     * renderer cannot be restarted. Scene objects are detached; shared assets and caller-owned
+     * controls must be managed by their owners.
+     */
+    dispose(): void;
     private animate;
     toImage(): string;
     protected get attachedToBody(): boolean;
@@ -1273,11 +1366,14 @@ declare class Renderer {
     get camera(): Camera;
     get renderer(): WebGLRenderer;
     get composer(): 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 {
@@ -1308,6 +1404,9 @@ interface RenderOptions {
 interface ComposerOptions {
     enabled: boolean;
 }
+interface ControlsOptions {
+    enabled: boolean;
+}
 interface DebugOptions {
     grid: boolean;
     axes: boolean;
@@ -1432,83 +1531,6 @@ declare function mergeVertices(geometry: BufferGeometry$1, tolerance?: number):
 declare function toTrianglesDrawMode(geometry: BufferGeometry$1, drawMode: TrianglesDrawModes): BufferGeometry$1;
 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;
@@ -1601,4 +1623,4 @@ declare class BrowserCache extends PersistentCache<LocalForage> {
  */
 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, 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 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, 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 };