minerender 2.1.0-alpha.114 → 2.1.0-alpha.115

package/dist/bundle.js

@@ -4768,7 +4768,7 @@ var MineRender = (() => {
     }
     throw new Error(`THREE.TextureUtils: Unknown texture type ${type}.`);
   }
-  var REVISION, MOUSE, TOUCH, CullFaceNone, CullFaceBack, CullFaceFront, PCFShadowMap, PCFSoftShadowMap, VSMShadowMap, FrontSide, BackSide, DoubleSide, NoBlending, NormalBlending, AdditiveBlending, SubtractiveBlending, MultiplyBlending, CustomBlending, AddEquation, SubtractEquation, ReverseSubtractEquation, MinEquation, MaxEquation, ZeroFactor, OneFactor, SrcColorFactor, OneMinusSrcColorFactor, SrcAlphaFactor, OneMinusSrcAlphaFactor, DstAlphaFactor, OneMinusDstAlphaFactor, DstColorFactor, OneMinusDstColorFactor, SrcAlphaSaturateFactor, ConstantColorFactor, OneMinusConstantColorFactor, ConstantAlphaFactor, OneMinusConstantAlphaFactor, NeverDepth, AlwaysDepth, LessDepth, LessEqualDepth, EqualDepth, GreaterEqualDepth, GreaterDepth, NotEqualDepth, MultiplyOperation, MixOperation, AddOperation, NoToneMapping, LinearToneMapping, ReinhardToneMapping, CineonToneMapping, ACESFilmicToneMapping, CustomToneMapping, AgXToneMapping, NeutralToneMapping, UVMapping, CubeReflectionMapping, CubeRefractionMapping, EquirectangularReflectionMapping, EquirectangularRefractionMapping, CubeUVReflectionMapping, RepeatWrapping, ClampToEdgeWrapping, MirroredRepeatWrapping, NearestFilter, NearestMipmapNearestFilter, NearestMipmapLinearFilter, LinearFilter, LinearMipmapNearestFilter, LinearMipmapLinearFilter, UnsignedByteType, ByteType, ShortType, UnsignedShortType, IntType, UnsignedIntType, FloatType, HalfFloatType, UnsignedShort4444Type, UnsignedShort5551Type, UnsignedInt248Type, UnsignedInt5999Type, UnsignedInt101111Type, AlphaFormat, RGBFormat, RGBAFormat, DepthFormat, DepthStencilFormat, RedFormat, RedIntegerFormat, RGFormat, RGIntegerFormat, RGBAIntegerFormat, RGB_S3TC_DXT1_Format, RGBA_S3TC_DXT1_Format, RGBA_S3TC_DXT3_Format, RGBA_S3TC_DXT5_Format, RGB_PVRTC_4BPPV1_Format, RGB_PVRTC_2BPPV1_Format, RGBA_PVRTC_4BPPV1_Format, RGBA_PVRTC_2BPPV1_Format, RGB_ETC1_Format, RGB_ETC2_Format, RGBA_ETC2_EAC_Format, R11_EAC_Format, SIGNED_R11_EAC_Format, RG11_EAC_Format, SIGNED_RG11_EAC_Format, RGBA_ASTC_4x4_Format, RGBA_ASTC_5x4_Format, RGBA_ASTC_5x5_Format, RGBA_ASTC_6x5_Format, RGBA_ASTC_6x6_Format, RGBA_ASTC_8x5_Format, RGBA_ASTC_8x6_Format, RGBA_ASTC_8x8_Format, RGBA_ASTC_10x5_Format, RGBA_ASTC_10x6_Format, RGBA_ASTC_10x8_Format, RGBA_ASTC_10x10_Format, RGBA_ASTC_12x10_Format, RGBA_ASTC_12x12_Format, RGBA_BPTC_Format, RGB_BPTC_SIGNED_Format, RGB_BPTC_UNSIGNED_Format, RED_RGTC1_Format, SIGNED_RED_RGTC1_Format, RED_GREEN_RGTC2_Format, SIGNED_RED_GREEN_RGTC2_Format, InterpolateDiscrete, InterpolateLinear, InterpolateSmooth, InterpolateBezier, ZeroCurvatureEnding, ZeroSlopeEnding, WrapAroundEnding, TrianglesDrawMode, TriangleStripDrawMode, TriangleFanDrawMode, BasicDepthPacking, TangentSpaceNormalMap, ObjectSpaceNormalMap, NoColorSpace, SRGBColorSpace, LinearSRGBColorSpace, LinearTransfer, SRGBTransfer, KeepStencilOp, AlwaysStencilFunc, NeverCompare, LessCompare, EqualCompare, LessEqualCompare, GreaterCompare, NotEqualCompare, GreaterEqualCompare, AlwaysCompare, StaticDrawUsage, GLSL3, WebGLCoordinateSystem, WebGPUCoordinateSystem, _cache, _setConsoleFunction, ReversedDepthFuncs, EventDispatcher, _lut, _seed, DEG2RAD, RAD2DEG, MathUtils, _Vector2, Vector2, Quaternion, _Vector3, Vector3, _vector$c, _quaternion$5, _Matrix3, Matrix3, _m3, LINEAR_REC709_TO_XYZ, XYZ_TO_LINEAR_REC709, ColorManagement, _canvas, ImageUtils, _sourceId, TextureSource, _textureId, _tempVec3, Texture, _Vector4, Vector4, RenderTarget, WebGLRenderTarget, DataArrayTexture, Data3DTexture, _Matrix4, Matrix4, _v1$7, _m1$2, _zero, _one, _x, _y, _z, _matrix$2, _quaternion$4, Euler, Layers, _object3DId, _v1$6, _q1, _m1$1, _target, _position$4, _scale$3, _quaternion$3, _xAxis, _yAxis, _zAxis, _addedEvent, _removedEvent, _childaddedEvent, _childremovedEvent, Object3D, Group, _moveEvent, WebXRController, _colorKeywords, _hslA, _hslB, Color, _color, Scene, _v0$2, _v1$5, _v2$4, _v3$2, _vab, _vac, _vbc, _vap, _vbp, _vcp, _v40, _v41, _v42, Triangle, Box3, _points, _vector$b, _box$4, _v0$1, _v1$4, _v2$3, _f0, _f1, _f2, _center, _extents, _triangleNormal, _testAxis, _vector$a, _vector2$1, _id$2, BufferAttribute, Uint16BufferAttribute, Uint32BufferAttribute, Float32BufferAttribute, _box$3, _v1$3, _v2$2, Sphere, _id$1, _m1, _obj, _offset, _box$2, _boxMorphTargets, _vector$9, BufferGeometry, InterleavedBuffer, _vector$8, InterleavedBufferAttribute, _vector1, _vector2, _normalMatrix, Plane, _materialId, Material, _vector$7, _segCenter, _segDir, _diff, Ray, MeshBasicMaterial, _inverseMatrix$3, _ray$3, _sphere$6, _sphereHitAt, _vA, _vB, _vC, _tempA, _morphA, _intersectionPoint, _intersectionPointWorld, Mesh, DataTexture, InstancedBufferAttribute, _instanceLocalMatrix, _instanceWorldMatrix, _instanceIntersects, _box3, _identity, _mesh$1, _sphere$4, InstancedMesh, _sphere$3, _defaultSpriteCenter, _vector$6, Frustum, LineBasicMaterial, _vStart, _vEnd, _inverseMatrix$1, _ray$1, _sphere$1, _intersectPointOnRay, _intersectPointOnSegment, Line, _start, _end, LineSegments, CompressedTexture, CubeTexture, CanvasTexture, DepthTexture, CubeDepthTexture, ExternalTexture, BoxGeometry, _v0, _v1$1, _normal, _triangle, EdgesGeometry, PlaneGeometry, UniformsUtils, default_vertex, default_fragment, ShaderMaterial, RawShaderMaterial, MeshStandardMaterial, MeshDepthMaterial, MeshDistanceMaterial, Interpolant, CubicInterpolant, LinearInterpolant, DiscreteInterpolant, BezierInterpolant, KeyframeTrack, BooleanKeyframeTrack, ColorKeyframeTrack, NumberKeyframeTrack, QuaternionLinearInterpolant, QuaternionKeyframeTrack, StringKeyframeTrack, VectorKeyframeTrack, LoadingManager, DefaultLoadingManager, Loader, _position$2, _quaternion$2, _scale$2, Camera, _v3$1, _minTarget, _maxTarget, PerspectiveCamera, OrthographicCamera, fov, aspect, CubeCamera, ArrayCamera, _RESERVED_CHARS_RE, _reservedRe, _wordChar, _wordCharOrDot, _directoryRe, _nodeRe, _objectRe, _propertyRe, _trackRe, _supportedObjectNames, Composite, PropertyBinding, _controlInterpolantsResultBuffer, Uniform, _matrix, Raycaster, Spherical, _Matrix2, Matrix2, _vector$4, Box2, GridHelper, AxesHelper;
+  var REVISION, MOUSE, TOUCH, CullFaceNone, CullFaceBack, CullFaceFront, PCFShadowMap, PCFSoftShadowMap, VSMShadowMap, FrontSide, BackSide, DoubleSide, NoBlending, NormalBlending, AdditiveBlending, SubtractiveBlending, MultiplyBlending, CustomBlending, AddEquation, SubtractEquation, ReverseSubtractEquation, MinEquation, MaxEquation, ZeroFactor, OneFactor, SrcColorFactor, OneMinusSrcColorFactor, SrcAlphaFactor, OneMinusSrcAlphaFactor, DstAlphaFactor, OneMinusDstAlphaFactor, DstColorFactor, OneMinusDstColorFactor, SrcAlphaSaturateFactor, ConstantColorFactor, OneMinusConstantColorFactor, ConstantAlphaFactor, OneMinusConstantAlphaFactor, NeverDepth, AlwaysDepth, LessDepth, LessEqualDepth, EqualDepth, GreaterEqualDepth, GreaterDepth, NotEqualDepth, MultiplyOperation, MixOperation, AddOperation, NoToneMapping, LinearToneMapping, ReinhardToneMapping, CineonToneMapping, ACESFilmicToneMapping, CustomToneMapping, AgXToneMapping, NeutralToneMapping, UVMapping, CubeReflectionMapping, CubeRefractionMapping, EquirectangularReflectionMapping, EquirectangularRefractionMapping, CubeUVReflectionMapping, RepeatWrapping, ClampToEdgeWrapping, MirroredRepeatWrapping, NearestFilter, NearestMipmapNearestFilter, NearestMipmapLinearFilter, LinearFilter, LinearMipmapNearestFilter, LinearMipmapLinearFilter, UnsignedByteType, ByteType, ShortType, UnsignedShortType, IntType, UnsignedIntType, FloatType, HalfFloatType, UnsignedShort4444Type, UnsignedShort5551Type, UnsignedInt248Type, UnsignedInt5999Type, UnsignedInt101111Type, AlphaFormat, RGBFormat, RGBAFormat, DepthFormat, DepthStencilFormat, RedFormat, RedIntegerFormat, RGFormat, RGIntegerFormat, RGBAIntegerFormat, RGB_S3TC_DXT1_Format, RGBA_S3TC_DXT1_Format, RGBA_S3TC_DXT3_Format, RGBA_S3TC_DXT5_Format, RGB_PVRTC_4BPPV1_Format, RGB_PVRTC_2BPPV1_Format, RGBA_PVRTC_4BPPV1_Format, RGBA_PVRTC_2BPPV1_Format, RGB_ETC1_Format, RGB_ETC2_Format, RGBA_ETC2_EAC_Format, R11_EAC_Format, SIGNED_R11_EAC_Format, RG11_EAC_Format, SIGNED_RG11_EAC_Format, RGBA_ASTC_4x4_Format, RGBA_ASTC_5x4_Format, RGBA_ASTC_5x5_Format, RGBA_ASTC_6x5_Format, RGBA_ASTC_6x6_Format, RGBA_ASTC_8x5_Format, RGBA_ASTC_8x6_Format, RGBA_ASTC_8x8_Format, RGBA_ASTC_10x5_Format, RGBA_ASTC_10x6_Format, RGBA_ASTC_10x8_Format, RGBA_ASTC_10x10_Format, RGBA_ASTC_12x10_Format, RGBA_ASTC_12x12_Format, RGBA_BPTC_Format, RGB_BPTC_SIGNED_Format, RGB_BPTC_UNSIGNED_Format, RED_RGTC1_Format, SIGNED_RED_RGTC1_Format, RED_GREEN_RGTC2_Format, SIGNED_RED_GREEN_RGTC2_Format, InterpolateDiscrete, InterpolateLinear, InterpolateSmooth, InterpolateBezier, ZeroCurvatureEnding, ZeroSlopeEnding, WrapAroundEnding, TrianglesDrawMode, TriangleStripDrawMode, TriangleFanDrawMode, BasicDepthPacking, TangentSpaceNormalMap, ObjectSpaceNormalMap, NoColorSpace, SRGBColorSpace, LinearSRGBColorSpace, LinearTransfer, SRGBTransfer, KeepStencilOp, AlwaysStencilFunc, NeverCompare, LessCompare, EqualCompare, LessEqualCompare, GreaterCompare, NotEqualCompare, GreaterEqualCompare, AlwaysCompare, StaticDrawUsage, GLSL3, WebGLCoordinateSystem, WebGPUCoordinateSystem, _cache, _setConsoleFunction, ReversedDepthFuncs, EventDispatcher, _lut, _seed, DEG2RAD, RAD2DEG, MathUtils, _Vector2, Vector2, Quaternion, _Vector3, Vector3, _vector$c, _quaternion$5, _Matrix3, Matrix3, _m3, LINEAR_REC709_TO_XYZ, XYZ_TO_LINEAR_REC709, ColorManagement, _canvas, ImageUtils, _sourceId, TextureSource, _textureId, _tempVec3, Texture, _Vector4, Vector4, RenderTarget, WebGLRenderTarget, DataArrayTexture, Data3DTexture, _Matrix4, Matrix4, _v1$7, _m1$2, _zero, _one, _x, _y, _z, _matrix$2, _quaternion$4, Euler, Layers, _object3DId, _v1$6, _q1, _m1$1, _target, _position$4, _scale$3, _quaternion$3, _xAxis, _yAxis, _zAxis, _addedEvent, _removedEvent, _childaddedEvent, _childremovedEvent, Object3D, Group, _moveEvent, WebXRController, _colorKeywords, _hslA, _hslB, Color, _color, Scene, _v0$2, _v1$5, _v2$4, _v3$2, _vab, _vac, _vbc, _vap, _vbp, _vcp, _v40, _v41, _v42, Triangle, Box3, _points, _vector$b, _box$4, _v0$1, _v1$4, _v2$3, _f0, _f1, _f2, _center, _extents, _triangleNormal, _testAxis, _vector$a, _vector2$1, _id$2, BufferAttribute, Uint16BufferAttribute, Uint32BufferAttribute, Float32BufferAttribute, _box$3, _v1$3, _v2$2, Sphere, _id$1, _m1, _obj, _offset, _box$2, _boxMorphTargets, _vector$9, BufferGeometry, InterleavedBuffer, _vector$8, InterleavedBufferAttribute, _vector1, _vector2, _normalMatrix, Plane, _materialId, Material, _vector$7, _segCenter, _segDir, _diff, Ray, MeshBasicMaterial, _inverseMatrix$3, _ray$3, _sphere$6, _sphereHitAt, _vA, _vB, _vC, _tempA, _morphA, _intersectionPoint, _intersectionPointWorld, Mesh, DataTexture, InstancedBufferAttribute, _instanceLocalMatrix, _instanceWorldMatrix, _instanceIntersects, _box3, _identity, _mesh$1, _sphere$4, InstancedMesh, _sphere$3, _defaultSpriteCenter, _vector$6, Frustum, LineBasicMaterial, _vStart, _vEnd, _inverseMatrix$1, _ray$1, _sphere$1, _intersectPointOnRay, _intersectPointOnSegment, Line, _start, _end, LineSegments, CompressedTexture, CubeTexture, CanvasTexture, DepthTexture, CubeDepthTexture, ExternalTexture, BoxGeometry, _v0, _v1$1, _normal, _triangle, EdgesGeometry, PlaneGeometry, UniformsUtils, default_vertex, default_fragment, ShaderMaterial, RawShaderMaterial, MeshStandardMaterial, MeshDepthMaterial, MeshDistanceMaterial, Interpolant, CubicInterpolant, LinearInterpolant, DiscreteInterpolant, BezierInterpolant, KeyframeTrack, BooleanKeyframeTrack, ColorKeyframeTrack, NumberKeyframeTrack, QuaternionLinearInterpolant, QuaternionKeyframeTrack, StringKeyframeTrack, VectorKeyframeTrack, LoadingManager, DefaultLoadingManager, Loader, _position$2, _quaternion$2, _scale$2, Camera, _v3$1, _minTarget, _maxTarget, PerspectiveCamera, OrthographicCamera, fov, aspect, CubeCamera, ArrayCamera, _RESERVED_CHARS_RE, _reservedRe, _wordChar, _wordCharOrDot, _directoryRe, _nodeRe, _objectRe, _propertyRe, _trackRe, _supportedObjectNames, Composite, PropertyBinding, _controlInterpolantsResultBuffer, Uniform, _matrix, Raycaster, Spherical, _Matrix2, Matrix2, _vector$4, Box2, GridHelper, AxesHelper, Controls;
   var init_three_core = __esm({
     "../../node_modules/three/build/three.core.js"() {
       init_dirname();
@@ -21500,6 +21500,53 @@ var MineRender = (() => {
           this.material.dispose();
         }
       };
+      Controls = class extends EventDispatcher {
+        /**
+         * Constructs a new controls instance.
+         *
+         * @param {Object3D} object - The object that is managed by the controls.
+         * @param {?HTMLElement} domElement - The HTML element used for event listeners.
+         */
+        constructor(object4, domElement = null) {
+          super();
+          this.object = object4;
+          this.domElement = domElement;
+          this.enabled = true;
+          this.state = -1;
+          this.keys = {};
+          this.mouseButtons = { LEFT: null, MIDDLE: null, RIGHT: null };
+          this.touches = { ONE: null, TWO: null };
+        }
+        /**
+         * Connects the controls to the DOM. This method has so called "side effects" since
+         * it adds the module's event listeners to the DOM.
+         *
+         * @param {HTMLElement} element - The DOM element to connect to.
+         */
+        connect(element) {
+          if (this.domElement !== null) this.disconnect();
+          this.domElement = element;
+        }
+        /**
+         * Disconnects the controls from the DOM.
+         */
+        disconnect() {
+        }
+        /**
+         * Call this method if you no longer want use to the controls. It frees all internal
+         * resources and removes all event listeners.
+         */
+        dispose() {
+        }
+        /**
+         * Controls should implement this method if they have to update their internal state
+         * per simulation step.
+         *
+         * @param {number} [delta] - The time delta in seconds.
+         */
+        update() {
+        }
+      };
       if (typeof __THREE_DEVTOOLS__ !== "undefined") {
         __THREE_DEVTOOLS__.dispatchEvent(new CustomEvent("register", { detail: {
           revision: REVISION
@@ -95365,6 +95412,7 @@ ${shader.fragmentShader}`.replace(
     EntityObject: () => EntityObject,
     Env: () => Env,
     FluidModelObject: () => FluidModelObject,
+    FlyControls: () => FlyControls,
     Fonts: () => Fonts,
     GUI_CONTAINER_LAYOUTS: () => GUI_CONTAINER_LAYOUTS,
     Geometries: () => Geometries,
@@ -95467,6 +95515,7 @@ ${shader.fragmentShader}`.replace(
     isDisposable: () => isDisposable,
     isDoubleArray: () => isDoubleArray,
     isEntityObject: () => isEntityObject,
+    isFlyControls: () => isFlyControls,
     isGuiObject: () => isGuiObject,
     isInstanceManager: () => isInstanceManager,
     isInstanceReference: () => isInstanceReference,
@@ -101366,6 +101415,324 @@ property list uchar int vertex_index
   init_buffer2();
   init_process2();
 
+  // src/renderer/FlyControls.ts
+  init_dirname();
+  init_buffer2();
+  init_process2();
+  init_three_module();
+  var VANILLA_FLY_SPEED = 10.89;
+  var PITCH_LIMIT = Math.PI / 2;
+  var MOVE_EPSILON = 1e-6;
+  var _euler = new Euler(0, 0, 0, "YXZ");
+  var _forward = new Vector3();
+  var _right = new Vector3();
+  var _targetVelocity = new Vector3();
+  var FlyControls = class extends Controls {
+    constructor(camera, domElement) {
+      super(camera, domElement ?? null);
+      this.isFlyControls = true;
+      /** Horizontal and vertical speed in scene units per second; vanilla creative flight by default. */
+      this.movementSpeed = 16 * VANILLA_FLY_SPEED;
+      /** Speed multiplier while the sprint key is held. */
+      this.sprintMultiplier = 2;
+      /** Radians per pixel of pointer movement. */
+      this.lookSpeed = 2e-3;
+      /** Smooth acceleration and deceleration, approximating vanilla flight momentum. */
+      this.enableDamping = true;
+      /** Portion of the remaining velocity change applied per 60 Hz frame (0–1) when damping is enabled. */
+      this.dampingFactor = 0.25;
+      /** Capture the pointer on click so the mouse turns the camera without dragging; dragging works regardless. */
+      this.pointerLock = true;
+      /** Scroll the wheel to change `movementSpeed` within `speedRange`. */
+      this.enableWheelSpeed = true;
+      /** Minimum and maximum `movementSpeed` reachable with the wheel. */
+      this.speedRange = [16, 16 * 500];
+      /** Touch joystick travel in CSS pixels for full speed. */
+      this.joystickRadius = 64;
+      /** Key bindings by `KeyboardEvent.code`. */
+      this.keys = {
+        forward: ["KeyW", "ArrowUp"],
+        back: ["KeyS", "ArrowDown"],
+        left: ["KeyA", "ArrowLeft"],
+        right: ["KeyD", "ArrowRight"],
+        up: ["Space"],
+        down: ["ShiftLeft", "ShiftRight"],
+        sprint: ["ControlLeft", "ControlRight"]
+      };
+      this._pressed = /* @__PURE__ */ new Set();
+      this._velocity = new Vector3();
+      this._lastPosition = new Vector3();
+      this._lastQuaternion = new Quaternion();
+      this._position0 = new Vector3();
+      this._quaternion0 = new Quaternion();
+      this._dragMoved = false;
+      this._locked = false;
+      this._onKeyDown = (event) => this.handleKey(event, true);
+      this._onKeyUp = (event) => this.handleKey(event, false);
+      this._onPointerDown = (event) => this.handlePointerDown(event);
+      this._onPointerMove = (event) => this.handlePointerMove(event);
+      this._onPointerUp = (event) => this.handlePointerUp(event);
+      this._onPointerLockChange = () => this.handlePointerLockChange();
+      this._onContextMenu = (event) => event.preventDefault();
+      this._onWheel = (event) => this.handleWheel(event);
+      this._onBlur = () => this.releaseKeys();
+      this._lastPosition.copy(camera.position);
+      this._lastQuaternion.copy(camera.quaternion);
+      this.saveState();
+      if (domElement) this.connect(domElement);
+    }
+    connect(element) {
+      super.connect(element);
+      const document2 = element.ownerDocument;
+      document2.addEventListener("keydown", this._onKeyDown);
+      document2.addEventListener("keyup", this._onKeyUp);
+      document2.addEventListener("pointerlockchange", this._onPointerLockChange);
+      document2.defaultView?.addEventListener("blur", this._onBlur);
+      element.addEventListener("pointerdown", this._onPointerDown);
+      element.addEventListener("pointermove", this._onPointerMove);
+      element.addEventListener("pointerup", this._onPointerUp);
+      element.addEventListener("pointercancel", this._onPointerUp);
+      element.addEventListener("contextmenu", this._onContextMenu);
+      element.addEventListener("wheel", this._onWheel, { passive: false });
+      element.addEventListener("blur", this._onBlur);
+      element.style.touchAction = "none";
+      if (element.tabIndex < 0) element.tabIndex = 0;
+    }
+    disconnect() {
+      const element = this.domElement;
+      if (!element) return;
+      const document2 = element.ownerDocument;
+      document2.removeEventListener("keydown", this._onKeyDown);
+      document2.removeEventListener("keyup", this._onKeyUp);
+      document2.removeEventListener("pointerlockchange", this._onPointerLockChange);
+      document2.defaultView?.removeEventListener("blur", this._onBlur);
+      element.removeEventListener("pointerdown", this._onPointerDown);
+      element.removeEventListener("pointermove", this._onPointerMove);
+      element.removeEventListener("pointerup", this._onPointerUp);
+      element.removeEventListener("pointercancel", this._onPointerUp);
+      element.removeEventListener("contextmenu", this._onContextMenu);
+      element.removeEventListener("wheel", this._onWheel);
+      element.removeEventListener("blur", this._onBlur);
+      element.style.touchAction = "auto";
+      this.unlock();
+      this._locked = false;
+      this.releaseKeys();
+      this._dragPointer = void 0;
+      this._joystick = void 0;
+    }
+    dispose() {
+      this.disconnect();
+    }
+    /** Whether mouse look currently owns the pointer. */
+    get locked() {
+      return this._locked;
+    }
+    /** Requests pointer capture; browsers only allow this from a user gesture. */
+    lock() {
+      const element = this.domElement;
+      if (!element || this._locked || typeof element.requestPointerLock !== "function") return;
+      try {
+        const result = element.requestPointerLock();
+        if (result instanceof Promise) result.catch(() => void 0);
+      } catch {
+      }
+    }
+    /** Releases a captured pointer. */
+    unlock() {
+      const document2 = this.domElement?.ownerDocument;
+      if (document2?.pointerLockElement && document2.pointerLockElement === this.domElement) {
+        document2.exitPointerLock();
+      }
+    }
+    /** Stores the camera pose that {@link reset} restores. */
+    saveState() {
+      this._position0.copy(this.object.position);
+      this._quaternion0.copy(this.object.quaternion);
+    }
+    /** Restores the saved camera pose and stops movement. */
+    reset() {
+      this.object.position.copy(this._position0);
+      this.object.quaternion.copy(this._quaternion0);
+      this._velocity.set(0, 0, 0);
+      this.notifyChange();
+    }
+    /** Horizontal yaw in radians, where zero looks toward -Z. */
+    get yaw() {
+      return _euler.setFromQuaternion(this.object.quaternion).y;
+    }
+    /** Vertical pitch in radians, positive looking up. */
+    get pitch() {
+      return _euler.setFromQuaternion(this.object.quaternion).x;
+    }
+    /** Turns the camera; pitch is clamped to straight up and down. */
+    setRotation(yaw, pitch) {
+      _euler.set(MathUtils.clamp(pitch, -PITCH_LIMIT, PITCH_LIMIT), yaw, 0);
+      this.object.quaternion.setFromEuler(_euler);
+      this.notifyChange();
+    }
+    /** Points the camera at a position without rolling it. */
+    lookAt(target) {
+      _forward.copy(target).sub(this.object.position);
+      if (_forward.lengthSq() < MOVE_EPSILON) return;
+      _forward.normalize();
+      this.setRotation(Math.atan2(-_forward.x, -_forward.z), Math.asin(MathUtils.clamp(_forward.y, -1, 1)));
+    }
+    /** Whether an action's key is held. */
+    isPressed(action) {
+      return this._pressed.has(action);
+    }
+    /**
+     * Advances movement by `delta` seconds (measured since the previous call when omitted)
+     * and dispatches `change` when the camera moved.
+     */
+    update(delta) {
+      if (delta === void 0) {
+        const now = typeof performance !== "undefined" ? performance.now() : Date.now();
+        delta = this._lastTime === void 0 ? 0 : (now - this._lastTime) / 1e3;
+        this._lastTime = now;
+      }
+      if (!this.enabled) {
+        this._velocity.set(0, 0, 0);
+        return;
+      }
+      if (delta > 0) this.move(delta);
+      this.notifyChange();
+    }
+    move(delta) {
+      const camera = this.object;
+      let forward = (this._pressed.has("forward") ? 1 : 0) - (this._pressed.has("back") ? 1 : 0);
+      let strafe = (this._pressed.has("right") ? 1 : 0) - (this._pressed.has("left") ? 1 : 0);
+      const climb = (this._pressed.has("up") ? 1 : 0) - (this._pressed.has("down") ? 1 : 0);
+      const joystick = this._joystick;
+      if (joystick) {
+        const radius = Math.max(this.joystickRadius, 1);
+        forward = MathUtils.clamp(forward + (joystick.originY - joystick.y) / radius, -1, 1);
+        strafe = MathUtils.clamp(strafe + (joystick.x - joystick.originX) / radius, -1, 1);
+      }
+      _euler.setFromQuaternion(camera.quaternion);
+      const yaw = _euler.y;
+      _forward.set(-Math.sin(yaw), 0, -Math.cos(yaw));
+      _right.set(Math.cos(yaw), 0, -Math.sin(yaw));
+      _targetVelocity.set(0, 0, 0);
+      if (forward || strafe || climb) {
+        _targetVelocity.addScaledVector(_forward, forward).addScaledVector(_right, strafe);
+        if (_targetVelocity.lengthSq() > 1) _targetVelocity.normalize();
+        _targetVelocity.y = climb;
+        const speed = this.movementSpeed * (this._pressed.has("sprint") ? this.sprintMultiplier : 1);
+        _targetVelocity.multiplyScalar(speed);
+      }
+      if (this.enableDamping) {
+        const blend = 1 - Math.pow(1 - MathUtils.clamp(this.dampingFactor, 0, 1), delta * 60);
+        this._velocity.lerp(_targetVelocity, blend);
+        if (_targetVelocity.lengthSq() === 0 && this._velocity.lengthSq() < MOVE_EPSILON) this._velocity.set(0, 0, 0);
+      } else {
+        this._velocity.copy(_targetVelocity);
+      }
+      camera.position.addScaledVector(this._velocity, delta);
+    }
+    notifyChange() {
+      const camera = this.object;
+      if (this._lastPosition.distanceToSquared(camera.position) > MOVE_EPSILON || 8 * (1 - this._lastQuaternion.dot(camera.quaternion)) > MOVE_EPSILON) {
+        this._lastPosition.copy(camera.position);
+        this._lastQuaternion.copy(camera.quaternion);
+        this.dispatchEvent({ type: "change" });
+      }
+    }
+    releaseKeys() {
+      this._pressed.clear();
+    }
+    handleKey(event, down) {
+      const action = this.actionFor(event.code);
+      if (!action) return;
+      const ownsInput = this.enabled && (this._locked || event.target === this.domElement);
+      if (down && !ownsInput) return;
+      const pressed = this._pressed.has(action);
+      if (down) this._pressed.add(action);
+      else this._pressed.delete(action);
+      if (ownsInput || this.enabled && pressed) event.preventDefault();
+    }
+    actionFor(code2) {
+      for (const action in this.keys) {
+        if (this.keys[action].includes(code2)) return action;
+      }
+      return void 0;
+    }
+    handlePointerDown(event) {
+      const element = this.domElement;
+      if (!this.enabled || !element) return;
+      element.focus?.({ preventScroll: true });
+      if (this._locked) return;
+      if (event.pointerType === "touch" && !this._joystick && this.onJoystickSide(event)) {
+        this._joystick = { id: event.pointerId, originX: event.clientX, originY: event.clientY, x: event.clientX, y: event.clientY };
+        element.setPointerCapture?.(event.pointerId);
+        return;
+      }
+      if (this._dragPointer !== void 0) return;
+      if (event.pointerType === "mouse" && event.button !== 0 && event.button !== 2) return;
+      this._dragPointer = event.pointerId;
+      this._dragMoved = false;
+      element.setPointerCapture?.(event.pointerId);
+    }
+    onJoystickSide(event) {
+      const rect = this.domElement?.getBoundingClientRect?.();
+      return !!rect && event.clientX < rect.left + rect.width / 2;
+    }
+    handlePointerMove(event) {
+      if (!this.enabled) return;
+      const joystick = this._joystick;
+      if (joystick && event.pointerId === joystick.id) {
+        joystick.x = event.clientX;
+        joystick.y = event.clientY;
+        return;
+      }
+      if (!this._locked && event.pointerId !== this._dragPointer) return;
+      const dx = event.movementX ?? 0;
+      const dy = event.movementY ?? 0;
+      if (!dx && !dy) return;
+      this._dragMoved = true;
+      this.turn(dx, dy);
+    }
+    handlePointerUp(event) {
+      if (this._joystick?.id === event.pointerId) {
+        this._joystick = void 0;
+        this.domElement?.releasePointerCapture?.(event.pointerId);
+        return;
+      }
+      if (event.pointerId !== this._dragPointer) return;
+      this._dragPointer = void 0;
+      this.domElement?.releasePointerCapture?.(event.pointerId);
+      if (this.enabled && this.pointerLock && !this._dragMoved && event.pointerType === "mouse" && event.button === 0) {
+        this.lock();
+      }
+    }
+    handleWheel(event) {
+      if (!this.enabled || !this.enableWheelSpeed) return;
+      event.preventDefault();
+      const steps = event.deltaMode === 0 ? event.deltaY / 100 : event.deltaY;
+      const [min, max2] = this.speedRange;
+      this.movementSpeed = MathUtils.clamp(this.movementSpeed * Math.pow(1.15, -steps), Math.min(min, max2), Math.max(min, max2));
+    }
+    handlePointerLockChange() {
+      const document2 = this.domElement?.ownerDocument;
+      const locked = !!document2 && document2.pointerLockElement === this.domElement;
+      if (locked === this._locked) return;
+      this._locked = locked;
+      if (!locked) this.releaseKeys();
+      this.dispatchEvent({ type: locked ? "lock" : "unlock" });
+    }
+    turn(dx, dy) {
+      _euler.setFromQuaternion(this.object.quaternion);
+      _euler.y -= dx * this.lookSpeed;
+      _euler.x = MathUtils.clamp(_euler.x - dy * this.lookSpeed, -PITCH_LIMIT, PITCH_LIMIT);
+      _euler.z = 0;
+      this.object.quaternion.setFromEuler(_euler);
+      this.notifyChange();
+    }
+  };
+  function isFlyControls(obj) {
+    return obj?.isFlyControls === true;
+  }
+
   // src/renderer/MineRenderScene.ts
   init_dirname();
   init_buffer2();
@@ -105204,20 +105571,77 @@ gl_FragDepth=readDepth(vUv);
     }
     createControls() {
       if (!this.options.controls?.enabled) return void 0;
-      const position = this.camera.position.clone();
-      const controls = new OrbitControls(this.camera, this.renderer.domElement);
-      this.camera.position.copy(position);
+      return this.createControlsFor(this.options.controls.mode ?? "orbit", this.initialTarget());
+    }
+    initialTarget() {
       const target = this.options.camera.lookingAt;
-      if (isVector3(target)) {
+      if (isVector3(target)) return target.clone();
+      if (isTripleArray(target)) return new Vector3(target[0], target[1], target[2]);
+      return new Vector3();
+    }
+    createControlsFor(mode2, target) {
+      let controls;
+      if (mode2 === "fly") {
+        controls = new FlyControls(this.camera, this.renderer.domElement);
+        controls.lookAt(target);
+        controls.saveState();
+      } else {
+        const position = this.camera.position.clone();
+        controls = new OrbitControls(this.camera, this.renderer.domElement);
+        this.camera.position.copy(position);
         controls.target.copy(target);
-      } else if (isTripleArray(target)) {
-        controls.target.set(target[0], target[1], target[2]);
+        controls.update();
+        controls.saveState();
       }
-      controls.update();
-      controls.saveState();
+      this._controlsTime = void 0;
       this.registerEventDispatcher(controls);
       return controls;
     }
+    /**
+     * Replaces renderer-owned controls with the selected mode, keeping the camera where it is.
+     * Switching to orbit controls targets the point the camera looks at, at the previous orbit distance.
+     * Returns the new controls, or undefined when controls were disabled at construction or after disposal.
+     */
+    setControlsMode(mode2) {
+      const current = this._controls;
+      if (this._disposed || !current) return void 0;
+      if (this.controlsMode === mode2) return current;
+      let target;
+      if (isFlyControls(current)) {
+        const distance = this._orbitDistance ?? (this.camera.position.distanceTo(this.initialTarget()) || 1);
+        target = new Vector3(0, 0, -distance).applyQuaternion(this.camera.quaternion).add(this.camera.position);
+      } else {
+        target = current.target.clone();
+        this._orbitDistance = this.camera.position.distanceTo(target);
+      }
+      const enabled = current.enabled;
+      this.disposeControls(current);
+      this._controls = this.createControlsFor(mode2, target);
+      this._controls.enabled = enabled;
+      this.dirty = true;
+      return this._controls;
+    }
+    disposeControls(controls) {
+      this._controls = void 0;
+      this.unregisterEventDispatcher(controls);
+      controls.enabled = false;
+      controls.dispose();
+    }
+    /** Advances owned controls; without a frame time, flight movement does not progress. */
+    updateControls(time) {
+      const controls = this._controls;
+      if (!controls?.enabled) {
+        this._controlsTime = void 0;
+        return;
+      }
+      if (!isFlyControls(controls)) {
+        controls.update();
+        return;
+      }
+      const previous = this._controlsTime;
+      if (time !== void 0) this._controlsTime = time;
+      controls.update(time === void 0 || previous === void 0 ? 0 : (time - previous) / 1e3);
+    }
     //</editor-fold>
     init() {
       if (this._disposed) return;
@@ -105294,6 +105718,12 @@ gl_FragDepth=readDepth(vUv);
       events.add(changeEvent2);
       dispatcher.addEventListener(changeEvent2, this._changeListener);
     }
+    unregisterEventDispatcher(dispatcher) {
+      const events = this._eventDispatchers.get(dispatcher);
+      if (!events) return;
+      for (const event of events) dispatcher.removeEventListener(event, this._changeListener);
+      this._eventDispatchers.delete(dispatcher);
+    }
     /** Updates the camera and canvas size. Width and height are in CSS pixels. */
     resize(width, height) {
       if (this._disposed) return;
@@ -105370,6 +105800,7 @@ gl_FragDepth=readDepth(vUv);
         this.renderer.setAnimationLoop(null);
       }
       this._nextFrameTime = void 0;
+      this._controlsTime = void 0;
       for (const subscription of this._frameCallbacks.values()) subscription.previous = void 0;
     }
     /**
@@ -105399,10 +105830,7 @@ gl_FragDepth=readDepth(vUv);
       }
       this._element = void 0;
       if (this._controls) {
-        const controls = this._controls;
-        this._controls = void 0;
-        controls.enabled = false;
-        controls.dispose();
+        this.disposeControls(this._controls);
       }
       this.scene.clear();
       for (const helper of this._debugHelpers) {
@@ -105419,9 +105847,7 @@ gl_FragDepth=readDepth(vUv);
     }
     animate(t5 = performance.now()) {
       if (!this._running) return;
-      if (this._controls?.enabled) {
-        this._controls.update();
-      }
+      this.updateControls(t5);
       if (!this._running) return;
       if (!this.dirty && !this.options.render.renderAlways && !this._frameCallbacks.size && !this._videoExporter) return;
       const interval = this._frameInterval;
@@ -105458,7 +105884,7 @@ gl_FragDepth=readDepth(vUv);
     /** Draws a fresh frame without starting the animation loop or invoking frame callbacks. */
     renderOnce() {
       if (this._disposed) throw new Error("Cannot render a disposed renderer");
-      if (this._controls?.enabled) this._controls.update();
+      this.updateControls();
       this.drawFrame();
     }
     /**
@@ -105488,7 +105914,7 @@ gl_FragDepth=readDepth(vUv);
         try {
           if (!wasRunning) this.start();
           this._videoExporter = exporter;
-          if (this._controls?.enabled) this._controls.update();
+          this.updateControls();
           this.drawFrame();
         } catch (error2) {
           exporter.cancel(error2);
@@ -105539,6 +105965,19 @@ gl_FragDepth=readDepth(vUv);
     get controls() {
       return this._controls;
     }
+    /** Renderer-owned OrbitControls, or undefined in fly mode or without controls. */
+    get orbitControls() {
+      return this._controls && !isFlyControls(this._controls) ? this._controls : void 0;
+    }
+    /** Renderer-owned {@link FlyControls}, or undefined in orbit mode or without controls. */
+    get flyControls() {
+      return isFlyControls(this._controls) ? this._controls : void 0;
+    }
+    /** The active renderer-owned controls mode, or undefined without controls. */
+    get controlsMode() {
+      if (!this._controls) return void 0;
+      return isFlyControls(this._controls) ? "fly" : "orbit";
+    }
     ///
   };
   _Renderer.DEFAULT_OPTIONS = (0, import_ts_deepmerge9.default)({}, {
@@ -105572,7 +106011,8 @@ gl_FragDepth=readDepth(vUv);
       enabled: true
     },
     controls: {
-      enabled: false
+      enabled: false,
+      mode: "orbit"
     },
     debug: {
       grid: false,