@thatopen/components 2.0.0-alpha.15 → 2.0.0-alpha.17

package/dist/index.mjs

@@ -3060,11 +3060,14 @@ class ia extends ar {
     I(this, "_parameters");
     I(this, "_resizeObserver", null);
     I(this, "onContainerUpdated", new U());
+    I(this, "_resizing", !1);
     /** {@link Resizeable.resize} */
     I(this, "resize", (t) => {
-      this.onContainerUpdated.trigger();
+      if (this._resizing)
+        return;
+      this._resizing = !0, this.onContainerUpdated.trigger();
       const e = t ? t.x : this.container.clientWidth, i = t ? t.y : this.container.clientHeight;
-      this.three.setSize(e, i), this.onResize.trigger(new g.Vector2(e, i));
+      this.three.setSize(e, i), this.onResize.trigger(new g.Vector2(e, i)), this._resizing = !1;
     });
     I(this, "resizeEvent", () => {
       this.resize();
@@ -3111,7 +3114,7 @@ class ia extends ar {
     const e = this.three.domElement.parentElement;
     if (!e)
       throw new Error("This renderer needs to have an HTML container!");
-    this._resizeObserver && (this._resizeObserver.disconnect(), this._resizeObserver = null), window.removeEventListener("resize", this.resizeEvent), t && (this._resizeObserver = new ResizeObserver(this.resizeEvent), this._resizeObserver.observe(e), this._resizeObserver.observe(document.body), window.addEventListener("resize", this.resizeEvent));
+    this._resizeObserver && (this._resizeObserver.disconnect(), this._resizeObserver = null), window.removeEventListener("resize", this.resizeEvent), t && (this._resizeObserver = new ResizeObserver(this.resizeEvent), this._resizeObserver.observe(e), window.addEventListener("resize", this.resizeEvent));
   }
   setupRenderer() {
     this.three.localClippingEnabled = !0, this.container && this.container.appendChild(this.three.domElement), this.onContainerUpdated.trigger();
@@ -4509,9 +4512,15 @@ class ke extends rr {
      */
     I(this, "updateAspect", () => {
       var t;
-      if (!(!this.currentWorld || !this.currentWorld.renderer) && !(this.three instanceof g.OrthographicCamera) && (t = this.currentWorld.renderer) != null && t.isResizeable()) {
-        const e = this.currentWorld.renderer.getSize();
-        this.three.aspect = e.width / e.height, this.three.updateProjectionMatrix(), this.onAspectUpdated.trigger();
+      if (!(!this.currentWorld || !this.currentWorld.renderer)) {
+        if (this.three instanceof g.OrthographicCamera) {
+          this.onAspectUpdated.trigger();
+          return;
+        }
+        if ((t = this.currentWorld.renderer) != null && t.isResizeable()) {
+          const e = this.currentWorld.renderer.getSize();
+          this.three.aspect = e.width / e.height, this.three.updateProjectionMatrix(), this.onAspectUpdated.trigger();
+        }
       }
     });
     this.three = this.setupCamera(), this.setupEvents(!0), this.onWorldChanged.add(({ action: e, world: i }) => {
@@ -4592,13 +4601,44 @@ class ke extends rr {
 const gs = class gs extends J {
   constructor(t) {
     super(t);
+    /**
+     * Event triggered after the update process of all worlds.
+     * Subscribers can listen to this event to perform actions post-update.
+     */
     I(this, "onAfterUpdate", new U());
+    /**
+     * Event triggered before the update process of all worlds.
+     * Subscribers can listen to this event to perform actions pre-update.
+     */
     I(this, "onBeforeUpdate", new U());
+    /**
+     * Event triggered when the Worlds component is disposed.
+     * Subscribers can listen to this event to perform cleanup actions.
+     */
     I(this, "onDisposed", new U());
+    /**
+     * A collection of worlds managed by this component.
+     * The key is the unique identifier (UUID) of the world, and the value is the World instance.
+     */
     I(this, "list", /* @__PURE__ */ new Map());
+    /**
+     * A flag indicating whether the Worlds component is enabled.
+     * If false, the update process will be skipped.
+     */
     I(this, "enabled", !0);
     t.add(gs.uuid, this);
   }
+  /**
+  * Creates a new instance of a SimpleWorld and adds it to the list of worlds.
+  * 
+  * @template T - The type of the scene, extending from BaseScene. Defaults to BaseScene.
+  * @template U - The type of the camera, extending from BaseCamera. Defaults to BaseCamera.
+  * @template S - The type of the renderer, extending from BaseRenderer. Defaults to BaseRenderer.
+  * 
+  * @returns {SimpleWorld<T, U, S>} - The newly created SimpleWorld instance.
+  * 
+  * @throws {Error} - Throws an error if a world with the same UUID already exists in the list.
+  */
   create() {
     const t = new Ar(this.components), e = t.uuid;
     if (this.list.has(e))
@@ -4620,6 +4660,10 @@ const gs = class gs extends J {
         i.update(t);
   }
 };
+/**
+ * A unique identifier for the component.
+ * This UUID is used to register the component within the Components system.
+ */
 I(gs, "uuid", "fdb61dc4-2ec1-4966-b83d-54ea795fad4a");
 let pi = gs;
 class _r {
@@ -5853,21 +5897,48 @@ class Vr extends Yr {
 const Ye = class Ye extends J {
   constructor(t) {
     super(t);
+    /**
+     * Indicates whether the Cullers component is enabled.
+     */
     I(this, "_enabled", !0);
+    /**
+     * A map of MeshCullerRenderer instances, keyed by their world UUIDs.
+     */
     I(this, "list", /* @__PURE__ */ new Map());
-    /** {@link Disposable.onDisposed} */
+    /**
+     * An event that is triggered when the Cullers component is disposed.
+     */
     I(this, "onDisposed", new U());
     t.add(Ye.uuid, this);
   }
-  /** {@link Component.enabled} */
+  /**
+   * Gets the enabled state of the Cullers component.
+   *
+   * @returns The current enabled state.
+   */
   get enabled() {
     return this._enabled;
   }
+  /**
+   * Sets the enabled state of the Cullers component.
+   * Also sets the enabled state of all MeshCullerRenderer instances.
+   *
+   * @param value - The new enabled state.
+   */
   set enabled(t) {
     this._enabled = t;
     for (const [e, i] of this.list)
       i.enabled = t;
   }
+  /**
+  * Creates a new MeshCullerRenderer for the given world.
+  * If a MeshCullerRenderer already exists for the world, it will return the existing one.
+  *
+  * @param world - The world for which to create the MeshCullerRenderer.
+  * @param config - Optional configuration settings for the MeshCullerRenderer.
+  *
+  * @returns The newly created or existing MeshCullerRenderer for the given world.
+  */
   create(t, e) {
     if (this.list.has(t.uuid))
       return this.list.get(t.uuid);
@@ -5886,6 +5957,9 @@ const Ye = class Ye extends J {
     this.list.clear();
   }
 };
+/**
+ * A unique identifier for the Cullers component.
+ */
 I(Ye, "uuid", "69f2a50d-c266-44fc-b1bd-fa4d34be89e6");
 let Ci = Ye;
 class Gr {
@@ -6163,7 +6237,7 @@ class na extends ke {
     I(this, "_frustumSize", 50);
     I(this, "_navigationModes", /* @__PURE__ */ new Map());
     this.threePersp = this.three, this.threeOrtho = this.newOrthoCamera(), this.projection = new Wr(this), this.onAspectUpdated.add(() => {
-      this.setOrthoCameraAspect();
+      this.setOrthoPerspCameraAspect();
     }), this.projection.onChanged.add(
       (e) => {
         this.three = e;
@@ -6240,11 +6314,17 @@ class na extends ke {
       1e3
     );
   }
-  setOrthoCameraAspect() {
+  setOrthoPerspCameraAspect() {
     if (!this.currentWorld || !this.currentWorld.renderer)
       return;
-    const t = this.currentWorld.renderer.getSize(), e = t.x / t.y;
-    this.threeOrtho.left = -this._frustumSize * e / 2, this.threeOrtho.right = this._frustumSize * e / 2, this.threeOrtho.top = this._frustumSize / 2, this.threeOrtho.bottom = -this._frustumSize / 2, this.threeOrtho.updateProjectionMatrix();
+    const t = this.currentWorld.renderer.getSize();
+    this.threePersp.aspect = t.width / t.height, this.threePersp.updateProjectionMatrix();
+    const e = new g.Vector3();
+    this.threePersp.getWorldDirection(e);
+    const i = new g.Vector3();
+    this.controls.getTarget(i);
+    const n = i.clone().sub(this.threePersp.position).dot(e), r = this.currentWorld.renderer.getSize(), a = r.x / r.y, l = this.threePersp, E = n * 2 * Math.atan(l.fov * (Math.PI / 180) / 2), d = E * a;
+    this.threeOrtho.zoom = 1, this.threeOrtho.left = d / -2, this.threeOrtho.right = d / 2, this.threeOrtho.top = E / 2, this.threeOrtho.bottom = E / -2, this.threeOrtho.updateProjectionMatrix();
   }
 }
 const At = class At extends J {