entangled-worlds-orbiters-shared 2.1.0 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "entangled-worlds-orbiters-shared",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Shared library for entangled worlds orbiters - contains core world rendering, moons system, and UI components",
   "type": "module",
   "main": "src/index.js",

package/src/world/cloudShell.js

@@ -7,6 +7,7 @@ async function makeTextureMaterial({
   opacity = 0.6,
   textureUrl,
   speed = 0.015,
+  renderer = null,
 } = {}) {
   const mat = new THREE.MeshStandardMaterial({
     color,
@@ -21,7 +22,9 @@ async function makeTextureMaterial({
   });
 
   if (textureUrl) {
-    const tex = await loadTexture(textureUrl);
+    // Thread the owning view's renderer: KTX2 cloud textures must transcode against the caller's
+    // context, not the global fallback (which shared-renderer pages don't publish at all).
+    const tex = await loadTexture(textureUrl, { renderer });
     tex.wrapS = THREE.RepeatWrapping;
     tex.wrapT = THREE.RepeatWrapping;
     // Use linear space for alpha masks if available
@@ -60,6 +63,7 @@ export async function createCloudShell({
   color = 0xffffff,
   opacity = 0.6,
   speed = 0.015,
+  renderer = null,
 } = {}) {
   const geom = baseGeometry
     ? baseGeometry.clone()
@@ -70,6 +74,7 @@ export async function createCloudShell({
     opacity,
     textureUrl,
     speed,
+    renderer,
   });
 
   const mesh = new THREE.Mesh(geom, material);

package/src/world/worldManager.js

@@ -4,12 +4,17 @@ import { makeSphere } from './worldTexture.js';
 import { makeNormalSphere } from './worldNormal.js';
 
 export class WorldManager {
-  constructor(scene, { onLoadStart, onLoadEnd, renderer } = {}) {
+  constructor(scene, { onLoadStart, onLoadEnd, renderer, externalTick = false } = {}) {
     this.scene = scene;
     // The renderer this world belongs to — threaded to the texture loaders so each view's textures
     // bind to its OWN WebGL context (multi-view: N orbiters / N planets in one page). Falls back to
     // window.__EW_RENDERER for callers that don't pass one, keeping single-renderer apps unchanged.
     this.renderer = renderer ?? null;
+    // Shared-renderer hosts drive world animation from THEIR loop: with `externalTick` this manager
+    // starts no internal rAF for `userData.update` worlds — the host calls `tick(timeSec)` per
+    // rendered frame instead. Otherwise N animated worlds on one page would each run their own loop,
+    // defeating the one-loop compositor.
+    this.externalTick = Boolean(externalTick);
     this.current = null;
     this.flags = {};
     this.onLoadStart = onLoadStart;
@@ -19,6 +24,20 @@ export class WorldManager {
     this.customCreators = new Map();
   }
 
+  /** Run the current world's per-frame updater once (externalTick hosts only; no-op otherwise). */
+  tick(timeSec) {
+    if (!this.externalTick || !this.current) return;
+    const updater = this.current.userData?.update;
+    if (typeof updater !== 'function') return;
+    const renderer = this.renderer ?? (typeof window !== 'undefined' ? window.__EW_RENDERER : null);
+    if (!renderer) return;
+    try {
+      updater(renderer, timeSec);
+    } catch (e) {
+      console.warn('[WorldManager] update tick error:', e);
+    }
+  }
+
   setFlags(flags) {
     this.flags = { ...this.flags, ...flags };
   }
@@ -66,8 +85,9 @@ export class WorldManager {
       this.scene.add(obj);
       this.current = obj;
 
-      // If the object exposes a frame updater, run a render-time loop
-      if (obj && obj.userData && typeof obj.userData.update === 'function' && renderer) {
+      // If the object exposes a frame updater, run a render-time loop — unless an external host
+      // drives it via tick() (shared-renderer compositor: one loop for all worlds).
+      if (!this.externalTick && obj && obj.userData && typeof obj.userData.update === 'function' && renderer) {
         const updater = obj.userData.update;
         const tick = () => {
           if (this.current === obj) {

package/src/world/worldTexture.js

@@ -309,6 +309,7 @@ export async function makeSphere({
       color: cloudsColor,
       opacity: cloudsOpacity,
       speed: cloudsSpeed,
+      renderer,
     });
     mesh.add(cloudMesh);
   }