minerender 2.1.0-alpha.117 → 2.1.0-alpha.119

package/dist/browser/index.mjs

@@ -86,6 +86,19 @@ var init_PersistentCache = __esm({
   }
 });
 
+// src/util/log.ts
+function prefix(prefix2) {
+  return `${FgGreen}MR${BgBlack}${prefix2 ?? ""}${Reset}`;
+}
+var Reset, FgGreen, BgBlack;
+var init_log = __esm({
+  "src/util/log.ts"() {
+    Reset = "\x1B[0m";
+    FgGreen = "\x1B[32m";
+    BgBlack = "\x1B[40m";
+  }
+});
+
 // src/Axis.ts
 import { Vector3 } from "three";
 function axisToVec3(axis) {
@@ -376,19 +389,6 @@ var init_CanvasCompat = __esm({
   }
 });
 
-// src/util/log.ts
-function prefix(prefix2) {
-  return `${FgGreen}MR${BgBlack}${prefix2 ?? ""}${Reset}`;
-}
-var Reset, FgGreen, BgBlack;
-var init_log = __esm({
-  "src/util/log.ts"() {
-    Reset = "\x1B[0m";
-    FgGreen = "\x1B[32m";
-    BgBlack = "\x1B[40m";
-  }
-});
-
 // src/request/Requests.ts
 import { JobCancelledError, JobQueue } from "jobqu";
 async function fetchRequest(config, defaultBaseURL) {
@@ -443,11 +443,11 @@ async function abortable(promise, signal) {
     signal.removeEventListener("abort", abort);
   }
 }
-var p, RequestError, RequestQueue, Requests;
+var p2, RequestError, RequestQueue, Requests;
 var init_Requests = __esm({
   "src/request/Requests.ts"() {
     init_log();
-    p = prefix("Requests");
+    p2 = prefix("Requests");
     RequestError = class extends Error {
       constructor(message, response, cause) {
         super(message);
@@ -474,7 +474,7 @@ var init_Requests = __esm({
             try {
               return await abortable(this.queue.add(request), signal);
             } catch (error) {
-              console.debug(p, "Request failed", error);
+              console.debug(p2, "Request failed", error);
               const delay = this.retryDelay(error, request, retries);
               if (delay === void 0) {
                 throw error;
@@ -639,7 +639,7 @@ var init_WrappedImage = __esm({
 
 // src/image/ImageLoader.ts
 import { Buffer as Buffer2 } from "buffer";
-var p2, ImageLoader;
+var p3, ImageLoader;
 var init_ImageLoader = __esm({
   "src/image/ImageLoader.ts"() {
     init_CanvasCompat();
@@ -649,7 +649,7 @@ var init_ImageLoader = __esm({
     init_Requests();
     init_WrappedImage();
     init_log();
-    p2 = prefix("ImageLoader");
+    p3 = prefix("ImageLoader");
     ImageLoader = class _ImageLoader {
       static _createImage() {
         return createImage();
@@ -674,7 +674,7 @@ var init_ImageLoader = __esm({
         return image;
       }
       static async loadData(src) {
-        console.debug(p2, "loadData", src);
+        console.debug(p3, "loadData", src);
         const image = await this.loadCanvasData(src);
         return image.data.getImageData(0, 0, image.width, image.height);
       }
@@ -1236,8 +1236,8 @@ var require_dist = __commonJS({
       __assign = Object.assign || function(t) {
         for (var s, i = 1, n = arguments.length; i < n; i++) {
           s = arguments[i];
-          for (var p10 in s) if (Object.prototype.hasOwnProperty.call(s, p10))
-            t[p10] = s[p10];
+          for (var p11 in s) if (Object.prototype.hasOwnProperty.call(s, p11))
+            t[p11] = s[p11];
         }
         return t;
       };
@@ -1418,12 +1418,12 @@ var init_AssetKey = __esm({
       }
       /** Joins the type subdirectory and path without adding a namespace or file extension. */
       getFullPath() {
-        let p10 = [];
+        let p11 = [];
         if (this.type) {
-          p10.push(this.type);
+          p11.push(this.type);
         }
-        p10.push(this.path);
-        return p10.join("/");
+        p11.push(this.path);
+        return p11.join("/");
       }
       toNamespacedString() {
         return this.namespace + ":" + this.getFullPath();
@@ -1529,7 +1529,7 @@ var init_ModelMerger = __esm({
             merged.display = { ...inheritedDisplay, ...DisplayTransforms.withHandFallbacks(source.display) };
           }
         }
-        merged.hierarchy = models.map((m) => m.parent).filter((p10) => `${p10}`);
+        merged.hierarchy = models.map((m) => m.parent).filter((p11) => `${p11}`);
         merged.hierarchy.push(`${merged.parent}`);
         if (model.components) merged.components = model.components;
         return merged;
@@ -2721,7 +2721,7 @@ var init_parser = __esm({
 });
 
 // src/assets/source/HostedAssetSource.ts
-var import_ts_deepmerge2, p3, DEFAULT_OPTIONS, _HostedAssetSource, HostedAssetSource;
+var import_ts_deepmerge2, p4, DEFAULT_OPTIONS, _HostedAssetSource, HostedAssetSource;
 var init_HostedAssetSource = __esm({
   "src/assets/source/HostedAssetSource.ts"() {
     init_AssetSource();
@@ -2734,7 +2734,7 @@ var init_HostedAssetSource = __esm({
     init_AssetLoader();
     init_parser();
     import_ts_deepmerge2 = __toESM(require_dist());
-    p3 = prefix("HostedAssetSource");
+    p4 = prefix("HostedAssetSource");
     DEFAULT_OPTIONS = {
       retryDefaults: true
     };
@@ -2746,14 +2746,14 @@ var init_HostedAssetSource = __esm({
           return direct;
         }
         if (key.namespace !== DEFAULT_NAMESPACE) {
-          console.info(p3, "Retrying", key, "with default namespace");
+          console.info(p4, "Retrying", key, "with default namespace");
           const namespaceKey = new AssetKey(DEFAULT_NAMESPACE, key.path, key.assetType, key.type, key.rootType, key.extension, key.root);
           const namespaced = await this.load(namespaceKey, parser);
           if (typeof namespaced !== "undefined") {
             return namespaced;
           }
           if (typeof key.root !== "undefined" && key.root !== AssetLoader.ROOT || typeof this.root !== "undefined" && this.root !== AssetLoader.ROOT) {
-            console.info(p3, "Retrying", key, "with default root+namespace");
+            console.info(p4, "Retrying", key, "with default root+namespace");
             const namespacedRootedKey = new AssetKey(DEFAULT_NAMESPACE, key.path, key.assetType, key.type, key.rootType, key.extension, AssetLoader.ROOT);
             const namespacedRooted = await this.load(namespacedRootedKey, parser);
             if (typeof namespacedRooted !== "undefined") {
@@ -2761,7 +2761,7 @@ var init_HostedAssetSource = __esm({
             }
           }
         } else if (typeof key.root !== "undefined" && key.root !== AssetLoader.ROOT || typeof this.root !== "undefined" && this.root !== AssetLoader.ROOT) {
-          console.info(p3, "Retrying", key, "with default root");
+          console.info(p4, "Retrying", key, "with default root");
           const rootKey = new AssetKey(key.namespace, key.path, key.assetType, key.type, key.rootType, key.extension, AssetLoader.ROOT);
           const rooted = await this.load(rootKey, parser);
           if (typeof rooted !== "undefined") {
@@ -2771,9 +2771,9 @@ var init_HostedAssetSource = __esm({
         return void 0;
       }
       async load(key, parser) {
-        console.info(p3, "Loading", key);
+        console.info(p4, "Loading", key);
         const url = `${this.assetBasePath(key)}${key.type !== void 0 ? key.type + "/" : ""}${key.path}${key.extension}`;
-        console.debug(p3, url);
+        console.debug(p4, url);
         const request = { url };
         try {
           parser.config(request);
@@ -3216,7 +3216,7 @@ var init_source = __esm({
 });
 
 // src/assets/AssetLoader.ts
-var p4, _AssetLoader, AssetLoader;
+var p5, _AssetLoader, AssetLoader;
 var init_AssetLoader = __esm({
   "src/assets/AssetLoader.ts"() {
     init_Assets();
@@ -3224,7 +3224,7 @@ var init_AssetLoader = __esm({
     init_log();
     init_source();
     init_Caching();
-    p4 = prefix("AssetLoader");
+    p5 = prefix("AssetLoader");
     _AssetLoader = class _AssetLoader {
       static get version() {
         return this.ROOT.substring(this.ROOT.lastIndexOf("/") + 1);
@@ -3273,11 +3273,11 @@ ${key}` : key;
         if (override) {
           const existing = this.removeSource(key);
           if (existing) {
-            console.log(p4, "Removed existing AssetSource", key);
+            console.log(p5, "Removed existing AssetSource", key);
           }
         }
         this._SOURCES.unshift({ key, source });
-        console.log(p4, "Added AssetSource", key);
+        console.log(p5, "Added AssetSource", key);
       }
       /** Removes and returns the first source with this name. Call {@link Caching.clear} to reload assets. */
       static removeSource(key) {
@@ -3669,7 +3669,7 @@ var init_ModelGenerator = __esm({
 
 // src/UVMapper.ts
 import { Float32BufferAttribute as Float32BufferAttribute2, Vector2, Vector3 as Vector34 } from "three";
-var p5, DEFAULT_UV, X, Y, Z, FACE_UV_AXES, UVMapper, MinecraftFaceUV;
+var p6, DEFAULT_UV, X, Y, Z, FACE_UV_AXES, UVMapper, MinecraftFaceUV;
 var init_UVMapper = __esm({
   "src/UVMapper.ts"() {
     init_CubeFace();
@@ -3682,7 +3682,7 @@ var init_UVMapper = __esm({
     init_AssetKey();
     init_ModelGenerator();
     init_log();
-    p5 = prefix("UVMapper");
+    p6 = prefix("UVMapper");
     DEFAULT_UV = [0, 0, 16, 16];
     X = 0;
     Y = 1;
@@ -3943,7 +3943,7 @@ var init_UVMapper = __esm({
           model.elements = originalModel.elements.map((element) => ({ ...element }));
         }
         const isItemModel = !("elements" in model);
-        console.debug(p5, "Creating Atlas for", model.key);
+        console.debug(p6, "Creating Atlas for", model.key);
         if (model.textures) {
           const promises = [];
           const uniqueTextureNames = [];
@@ -3957,7 +3957,7 @@ var init_UVMapper = __esm({
               const assetKey = AssetKey.parse("textures", textureValue, model.key);
               promises.push(ModelTextures.get(assetKey).then((asset2) => {
                 if (!asset2) {
-                  console.warn(p5, "Missing texture", assetKey);
+                  console.warn(p6, "Missing texture", assetKey);
                   return;
                 }
                 textureMap[textureKey] = new WrappedImage(asset2);
@@ -3969,7 +3969,7 @@ var init_UVMapper = __esm({
           }
           await Promise.all(promises);
           const textureCount = uniqueTextureNames.length;
-          console.debug(p5, "Creating Atlas for", textureCount, "textures");
+          console.debug(p6, "Creating Atlas for", textureCount, "textures");
           this.fillMissingTextureKeys(model.textures, textureMap);
           this.fillMissingTextureKeys(model.textures, metaMap);
           const sizes = {};
@@ -4000,7 +4000,7 @@ var init_UVMapper = __esm({
           this.fillMissingTextureKeys(model.textures, sizes);
           const s = Math.ceil(Math.sqrt(textureCount + 1));
           const size = Math.ceil(s * maxWidth);
-          console.debug(p5, "Atlas size:", size);
+          console.debug(p6, "Atlas size:", size);
           const squaredSize = size * size;
           const image = new CanvasImage(size, size);
           const missing = Textures.getMissing().image;
@@ -4079,7 +4079,7 @@ var init_UVMapper = __esm({
           }
           this.fillMissingTextureKeys(model.textures, positions);
           if (isItemModel) {
-            console.debug(p5, "Generating item model for", model);
+            console.debug(p6, "Generating item model for", model);
             model.elements = [];
             for (let layerName of ModelGenerator.ITEM_LAYERS) {
               const textureImage = textureMap[layerName];
@@ -4095,7 +4095,7 @@ var init_UVMapper = __esm({
                 ), layerName));
               }
             }
-            console.debug(p5, "Item model elements", model.elements);
+            console.debug(p6, "Item model elements", model.elements);
           }
           if (!model.elements) {
           }
@@ -4152,7 +4152,7 @@ var init_UVMapper = __esm({
             hasTranslucency
           );
         } else {
-          console.warn(p5, "Model does not have any textures", model);
+          console.warn(p6, "Model does not have any textures", model);
         }
         return void 0;
       }
@@ -4672,7 +4672,7 @@ import { Color as Color2, Euler as Euler4, InstancedBufferAttribute, InstancedMe
 function isSceneObject(obj) {
   return obj.isSceneObject;
 }
-var import_ts_deepmerge3, p6, _SceneObject, SceneObject;
+var import_ts_deepmerge3, p7, _SceneObject, SceneObject;
 var init_SceneObject = __esm({
   "src/renderer/SceneObject.ts"() {
     init_Geometries();
@@ -4685,7 +4685,7 @@ var init_SceneObject = __esm({
     init_Disposable();
     import_ts_deepmerge3 = __toESM(require_dist());
     init_log();
-    p6 = prefix("SceneObject");
+    p7 = prefix("SceneObject");
     _SceneObject = class _SceneObject extends Object3D2 {
       constructor(options) {
         super();
@@ -6942,7 +6942,7 @@ import { BoxGeometry as BoxGeometry5, BufferAttribute as BufferAttribute5, Color
 function isModelObject(obj) {
   return obj.isModelObject;
 }
-var import_ts_deepmerge5, p7, _ModelObject, ModelObject;
+var import_ts_deepmerge5, p8, _ModelObject, ModelObject;
 var init_ModelObject = __esm({
   "src/model/scene/ModelObject.ts"() {
     init_SceneObject();
@@ -6961,7 +6961,7 @@ var init_ModelObject = __esm({
     init_GuiLight();
     init_ItemTints();
     init_ItemGlint();
-    p7 = prefix("ModelObject");
+    p8 = prefix("ModelObject");
     _ModelObject = class _ModelObject extends SceneObject {
       constructor(originalModel, options) {
         super(options);
@@ -7134,10 +7134,10 @@ var init_ModelObject = __esm({
               }
             });
           } else {
-            console.debug(p7, this.atlas.model, "has no elements");
+            console.debug(p8, this.atlas.model, "has no elements");
           }
         } else {
-          console.debug(p7, "Missing atlas for", this);
+          console.debug(p8, "Missing atlas for", this);
         }
         if (this.options.mergeMeshes) {
           let combinedGeo;
@@ -7490,32 +7490,53 @@ import localforage from "localforage";
 
 // src/env/browser/BrowserCache.ts
 init_PersistentCache();
+init_log();
+var p = prefix("BrowserCache");
 var BrowserCache = class extends PersistentCache {
   constructor(backing) {
     super(backing);
   }
+  async initialize() {
+    try {
+      await this.backing.ready();
+      return true;
+    } catch (error) {
+      this.memory = /* @__PURE__ */ new Map();
+      console.warn(p, "Could not open browser storage; using an in-memory store", error);
+      return false;
+    }
+  }
+  async run(operation, fallback) {
+    if (await (this.initialized ?? (this.initialized = this.initialize()))) return operation();
+    return fallback(this.memory);
+  }
   get(key) {
-    return this.backing.getItem(key);
+    return this.run(() => this.backing.getItem(key), (memory) => memory.get(key));
   }
   put(key, value) {
-    return this.backing.setItem(key, value);
+    return this.run(() => this.backing.setItem(key, value), (memory) => {
+      memory.set(key, value);
+      return value;
+    });
   }
   delete(key) {
-    return this.backing.removeItem(key);
+    return this.run(() => this.backing.removeItem(key), (memory) => {
+      memory.delete(key);
+    });
   }
   clear() {
-    return this.backing.clear();
+    return this.run(() => this.backing.clear(), (memory) => memory.clear());
   }
   length() {
-    return this.backing.length();
+    return this.run(() => this.backing.length(), (memory) => memory.size);
   }
   keys() {
-    return this.backing.keys();
+    return this.run(() => this.backing.keys(), (memory) => [...memory.keys()]);
   }
   forEach(callback) {
-    return this.backing.iterate((v, k) => {
-      callback(v, k);
-    });
+    return this.run(() => this.backing.iterate((value, key) => {
+      callback(value, key);
+    }), (memory) => memory.forEach((value, key) => callback(value, key)));
   }
 };
 
@@ -7722,7 +7743,7 @@ function createPermutation() {
   return values;
 }
 function swampGrassColor(x, z) {
-  const p10 = permutation ?? (permutation = createPermutation());
+  const p11 = permutation ?? (permutation = createPermutation());
   x *= 0.0225;
   z *= 0.0225;
   const s = (x + z) * skew;
@@ -7733,7 +7754,7 @@ function swampGrassColor(x, z) {
   const corner = (gx, gz, a, b) => {
     let falloff = 0.5 - a * a - b * b;
     if (falloff < 0) return 0;
-    const gradient = gradients[p10[gx + p10[gz & 255] & 255] % 12];
+    const gradient = gradients[p11[gx + p11[gz & 255] & 255] % 12];
     falloff *= falloff;
     return falloff * falloff * (gradient[0] * a + gradient[1] * b);
   };
@@ -11737,7 +11758,7 @@ init_util();
 import { Raycaster, Vector2 as Vector25 } from "three";
 init_log();
 init_three();
-var p8 = prefix("SceneInspector");
+var p9 = prefix("SceneInspector");
 var help = "<span>Ctrl/Cmd+Click to Select<br/></span><br/>";
 var SceneInspector = class {
   constructor(renderer) {
@@ -11831,7 +11852,7 @@ var SceneInspector = class {
   }
   selectObject(targetObject, targetIntersection, instance = this.getIntersectionInstance(targetIntersection)) {
     this.selectedObject = targetObject;
-    console.log(p8, "selected", targetObject);
+    console.log(p9, "selected", targetObject);
     this.redraw(targetObject, targetIntersection, instance);
   }
   redraw(targetObject, targetIntersection, instance) {
@@ -12091,7 +12112,7 @@ var SceneStatsDisplay = class {
 
 // src/instance/InstanceManager.ts
 init_log();
-var p9 = prefix("InstanceManager");
+var p10 = prefix("InstanceManager");
 var InstanceManager = class {
   constructor() {
     this.isInstanceManager = true;
@@ -12100,7 +12121,7 @@ var InstanceManager = class {
   /** Allocates a new placement of a cached model, or returns `undefined` if the key is unknown. */
   async get(key) {
     if (key in this.instanceCache) {
-      console.debug(p9, "key in cache", key);
+      console.debug(p10, "key in cache", key);
       return (await this.instanceCache[key]).nextInstance();
     }
     return void 0;
@@ -12110,7 +12131,7 @@ var InstanceManager = class {
     if (key in this.instanceCache) {
       return await this.get(key);
     }
-    console.debug(p9, "key not in cache", key);
+    console.debug(p10, "key not in cache", key);
     const pending = Promise.resolve().then(supplier).then((obj) => obj.nextInstance());
     this.instanceCache[key] = pending;
     try {
@@ -13221,6 +13242,8 @@ import { Controls, Euler as Euler11, MathUtils as MathUtils2, Quaternion as Quat
 var VANILLA_FLY_SPEED = 10.89;
 var PITCH_LIMIT = Math.PI / 2;
 var MOVE_EPSILON = 1e-6;
+var MAX_STEP_SECONDS = 0.1;
+var CLICK_SLOP_PIXELS = 4;
 var _euler = new Euler11(0, 0, 0, "YXZ");
 var _forward = new Vector313();
 var _right = new Vector313();
@@ -13255,7 +13278,8 @@ var FlyControls = class extends Controls {
       right: ["KeyD", "ArrowRight"],
       up: ["Space"],
       down: ["ShiftLeft", "ShiftRight"],
-      sprint: ["ControlLeft", "ControlRight"]
+      // Not Control: Ctrl+W closes the browser tab on Windows and Linux, and a page cannot block it.
+      sprint: ["KeyR"]
     };
     this._pressed = /* @__PURE__ */ new Set();
     this._velocity = new Vector313();
@@ -13263,8 +13287,12 @@ var FlyControls = class extends Controls {
     this._lastQuaternion = new Quaternion6();
     this._position0 = new Vector313();
     this._quaternion0 = new Quaternion6();
+    this._dragX = 0;
+    this._dragY = 0;
     this._dragMoved = false;
+    this._dragTravel = 0;
     this._locked = false;
+    this._madeFocusable = false;
     this._onKeyDown = (event) => this.handleKey(event, true);
     this._onKeyUp = (event) => this.handleKey(event, false);
     this._onPointerDown = (event) => this.handlePointerDown(event);
@@ -13294,7 +13322,10 @@ var FlyControls = class extends Controls {
     element.addEventListener("wheel", this._onWheel, { passive: false });
     element.addEventListener("blur", this._onBlur);
     element.style.touchAction = "none";
-    if (element.tabIndex < 0) element.tabIndex = 0;
+    if (element.tabIndex < 0) {
+      element.tabIndex = 0;
+      this._madeFocusable = true;
+    }
   }
   disconnect() {
     const element = this.domElement;
@@ -13312,6 +13343,10 @@ var FlyControls = class extends Controls {
     element.removeEventListener("wheel", this._onWheel);
     element.removeEventListener("blur", this._onBlur);
     element.style.touchAction = "auto";
+    if (this._madeFocusable) {
+      element.removeAttribute("tabindex");
+      this._madeFocusable = false;
+    }
     this.unlock();
     this._locked = false;
     this.releaseKeys();
@@ -13382,6 +13417,7 @@ var FlyControls = class extends Controls {
   /**
    * Advances movement by `delta` seconds (measured since the previous call when omitted)
    * and dispatches `change` when the camera moved.
+   * A step longer than 0.1 s is applied as 0.1 s.
    */
   update(delta) {
     if (delta === void 0) {
@@ -13393,7 +13429,7 @@ var FlyControls = class extends Controls {
       this._velocity.set(0, 0, 0);
       return;
     }
-    if (delta > 0) this.move(delta);
+    if (delta > 0) this.move(Math.min(delta, MAX_STEP_SECONDS));
     this.notifyChange();
   }
   move(delta) {
@@ -13440,15 +13476,21 @@ var FlyControls = class extends Controls {
     this._pressed.clear();
   }
   handleKey(event, down) {
+    if (event.code === "MetaLeft" || event.code === "MetaRight") this.releaseKeys();
     const action = this.actionFor(event.code);
     if (!action) return;
     const ownsInput = this.enabled && (this._locked || event.target === this.domElement);
-    if (down && !ownsInput) return;
+    if (down && (!ownsInput || this.isBrowserShortcut(event))) 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();
   }
+  /** A key pressed with Control, Alt, or Command stays a browser shortcut unless that modifier is bound to an action. */
+  isBrowserShortcut(event) {
+    const bound = (modifier) => Object.values(this.keys).some((codes) => codes.some((code) => code.startsWith(modifier)));
+    return event.ctrlKey && !bound("Control") || event.altKey && !bound("Alt") || event.metaKey && !bound("Meta");
+  }
   actionFor(code) {
     for (const action in this.keys) {
       if (this.keys[action].includes(code)) return action;
@@ -13468,7 +13510,10 @@ var FlyControls = class extends Controls {
     if (this._dragPointer !== void 0) return;
     if (event.pointerType === "mouse" && event.button !== 0 && event.button !== 2) return;
     this._dragPointer = event.pointerId;
+    this._dragX = event.clientX;
+    this._dragY = event.clientY;
     this._dragMoved = false;
+    this._dragTravel = 0;
     element.setPointerCapture?.(event.pointerId);
   }
   onJoystickSide(event) {
@@ -13484,8 +13529,20 @@ var FlyControls = class extends Controls {
       return;
     }
     if (!this._locked && event.pointerId !== this._dragPointer) return;
-    const dx = event.movementX ?? 0;
-    const dy = event.movementY ?? 0;
+    let dx, dy;
+    if (this._locked) {
+      dx = event.movementX ?? 0;
+      dy = event.movementY ?? 0;
+    } else {
+      dx = event.clientX - this._dragX;
+      dy = event.clientY - this._dragY;
+      this._dragX = event.clientX;
+      this._dragY = event.clientY;
+      if (!this._dragMoved) {
+        this._dragTravel += Math.hypot(dx, dy);
+        if (this._dragTravel <= CLICK_SLOP_PIXELS) return;
+      }
+    }
     if (!dx && !dy) return;
     this._dragMoved = true;
     this.turn(dx, dy);
@@ -15403,6 +15460,7 @@ var _Renderer = class _Renderer {
   /**
    * 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.
+   * The previous controls object is disposed, so its listeners and settings do not carry over.
    * Returns the new controls, or undefined when controls were disabled at construction or after disposal.
    */
   setControlsMode(mode) {
@@ -16068,6 +16126,79 @@ function parseSceneDocument(value) {
   return JSON.parse(JSON.stringify(input));
 }
 
+// src/scene/SceneDocumentCodec.ts
+var SCENE_DOCUMENT_MAX_BYTES = 1024 * 1024;
+async function readBounded(stream, label) {
+  const reader = stream.getReader();
+  const chunks = [];
+  let size = 0;
+  try {
+    while (true) {
+      const { value, done } = await reader.read();
+      if (done) break;
+      size += value.byteLength;
+      if (size > SCENE_DOCUMENT_MAX_BYTES) throw new RangeError(`${label} exceeds ${SCENE_DOCUMENT_MAX_BYTES} bytes`);
+      chunks.push(value);
+    }
+  } catch (error) {
+    await reader.cancel().catch(() => {
+    });
+    throw error;
+  } finally {
+    reader.releaseLock();
+  }
+  const bytes = new Uint8Array(size);
+  let offset = 0;
+  for (const chunk of chunks) {
+    bytes.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return bytes;
+}
+function encodeBase64(bytes) {
+  let binary = "";
+  for (let offset = 0; offset < bytes.length; offset += 32768) {
+    binary += String.fromCharCode(...bytes.subarray(offset, offset + 32768));
+  }
+  return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+async function encodeSceneDocument(value) {
+  const scene = parseSceneDocument(value);
+  const bytes = new TextEncoder().encode(JSON.stringify(scene));
+  if (bytes.byteLength > SCENE_DOCUMENT_MAX_BYTES) {
+    throw new RangeError(`Scene document exceeds ${SCENE_DOCUMENT_MAX_BYTES} bytes`);
+  }
+  const compressed = await readBounded(new Blob([bytes]).stream().pipeThrough(new CompressionStream("deflate")), "Encoded scene");
+  return `v1.${encodeBase64(compressed)}`;
+}
+async function decodeSceneDocument(value) {
+  if (!value.startsWith("v1.")) throw new Error("Unsupported scene encoding version; expected v1");
+  const encoded = value.slice(3);
+  if (encoded.length > Math.ceil(SCENE_DOCUMENT_MAX_BYTES * 4 / 3)) {
+    throw new RangeError(`Encoded scene exceeds ${SCENE_DOCUMENT_MAX_BYTES} bytes`);
+  }
+  if (!/^[A-Za-z0-9_-]+$/.test(encoded) || encoded.length % 4 === 1) {
+    throw new Error("Invalid scene base64url encoding");
+  }
+  const binary = atob(encoded.replace(/-/g, "+").replace(/_/g, "/"));
+  const compressed = Uint8Array.from(binary, (character) => character.charCodeAt(0));
+  if (encodeBase64(compressed) !== encoded) throw new Error("Invalid scene base64url encoding");
+  let bytes;
+  try {
+    bytes = await readBounded(new Blob([compressed]).stream().pipeThrough(new DecompressionStream("deflate")), "Scene document");
+  } catch (error) {
+    if (error instanceof RangeError) throw error;
+    throw new Error("Invalid compressed scene document");
+  }
+  let json;
+  try {
+    json = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+  } catch {
+    throw new Error("Invalid UTF-8 scene document");
+  }
+  return parseSceneDocument(json);
+}
+
 // src/scene/SceneDocumentLoader.ts
 init_AssetKey();
 init_AssetLoader();
@@ -18989,6 +19120,7 @@ export {
   Renderer,
   RequestError,
   Requests,
+  SCENE_DOCUMENT_MAX_BYTES,
   SKIN_PARTS,
   SceneDocumentLoader,
   SceneExporter,
@@ -19040,6 +19172,8 @@ export {
   createGuiTextGeometry,
   createGuiTextureGeometry,
   createImage,
+  decodeSceneDocument,
+  encodeSceneDocument,
   entityAnimationTime,
   estimateBytesUsed,
   fluidKindOf,