entangled-worlds-orbiters-shared 6.0.1 → 6.0.2

package/dist/world/cloudShell.d.ts

@@ -1,4 +1,12 @@
 import * as THREE from 'three';
+/**
+ * The cloud texture could not be loaded (offline, gone from the CDN, or not decodable). Its own type
+ * so the world builders can drop just the clouds on THIS failure and still let any other error out.
+ * `cause` is what the loader threw.
+ */
+export declare class CloudTextureError extends Error {
+    constructor(url: string, cause: unknown);
+}
 /**
  * `baseGeometry` is cloned for the shell; when absent a sphere is built from `baseRadius` (0.5) and
  * the segment counts (64 × 64). Defaults: `color` 0xffffff, `opacity` 0.6, `speed` 0.015.

package/dist/world/cloudShell.js

@@ -1,5 +1,16 @@
 import * as THREE from 'three';
 import { loadTexture } from '../loaders/bodyTextureLoader.js';
+/**
+ * The cloud texture could not be loaded (offline, gone from the CDN, or not decodable). Its own type
+ * so the world builders can drop just the clouds on THIS failure and still let any other error out.
+ * `cause` is what the loader threw.
+ */
+export class CloudTextureError extends Error {
+    constructor(url, cause) {
+        super(`Cloud texture could not be loaded: ${url}`, { cause });
+        this.name = 'CloudTextureError';
+    }
+}
 // Texture-only clouds material (alpha mask + tint), UV-scrolled
 async function makeTextureMaterial({ color = 0xffffff, opacity = 0.6, textureUrl, speed = 0.015, renderer = null, } = {}) {
     // Diffuse-only (Lambert): the star's key light costs no specular pass.
@@ -15,7 +26,14 @@ async function makeTextureMaterial({ color = 0xffffff, opacity = 0.6, textureUrl
     if (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 });
+        let tex;
+        try {
+            tex = await loadTexture(textureUrl, { renderer });
+        }
+        catch (cause) {
+            mat.dispose();
+            throw new CloudTextureError(textureUrl, cause);
+        }
         tex.wrapS = THREE.RepeatWrapping;
         tex.wrapT = THREE.RepeatWrapping;
         // Use linear space for alpha masks if available
@@ -48,9 +66,7 @@ async function makeTextureMaterial({ color = 0xffffff, opacity = 0.6, textureUrl
  * the segment counts (64 × 64). Defaults: `color` 0xffffff, `opacity` 0.6, `speed` 0.015.
  */
 export async function createCloudShell({ baseGeometry, baseRadius = 0.5, widthSegments = 64, heightSegments = 64, textureUrl = '/assets/texture/2k_earth_clouds.jpg', color = 0xffffff, opacity = 0.6, speed = 0.015, renderer = null, } = {}) {
-    const geom = baseGeometry
-        ? baseGeometry.clone()
-        : new THREE.SphereGeometry(baseRadius, widthSegments, heightSegments);
+    // The texture first: when it cannot be loaded this throws before any geometry exists to leak.
     const material = await makeTextureMaterial({
         color,
         opacity,
@@ -58,6 +74,9 @@ export async function createCloudShell({ baseGeometry, baseRadius = 0.5, widthSe
         speed,
         renderer,
     });
+    const geom = baseGeometry
+        ? baseGeometry.clone()
+        : new THREE.SphereGeometry(baseRadius, widthSegments, heightSegments);
     const mesh = new THREE.Mesh(geom, material);
     const s = 1.001; // fixed scale
     mesh.scale.set(s, s, s);

package/dist/world/worldNormal.js

@@ -3,7 +3,7 @@ import * as THREE from 'three';
 import { EARTH_RADIUS_UNITS } from './worldTexture.js';
 import { applyFlagsToMaterial } from '../utils/materials.js';
 import { getLightFresnel } from '../core/lightFresnel.js';
-import { createCloudShell } from './cloudShell.js';
+import { CloudTextureError, createCloudShell } from './cloudShell.js';
 import { resolvePublicUrl } from '../config/env.js';
 /**
  * Create a simple sphere using THREE.MeshNormalMaterial.
@@ -51,8 +51,17 @@ glowScale = 1.18, glowRimHex = 0x66ccff, glowFacingHex = 0x000000, glowBias = 0.
             opacity: cloudsOpacity,
             speed: cloudsSpeed,
             renderer,
+        }).catch((e) => {
+            // Clouds are an optional layer: a texture that cannot be loaded (offline, or gone from the
+            // CDN) costs the clouds, never the planet — the same way a failed surface texture does. Only
+            // that: any other error building the shell is a bug and still fails the build.
+            if (!(e instanceof CloudTextureError))
+                throw e;
+            console.warn('[worldNormal] Failed to load clouds, drawing the world without them:', e.cause);
+            return null;
         });
-        mesh.add(cloudMesh);
+        if (cloudMesh)
+            mesh.add(cloudMesh);
     }
     return mesh;
 }

package/dist/world/worldTexture.js

@@ -2,7 +2,7 @@ import * as THREE from 'three';
 import { loadTexture } from '../loaders/bodyTextureLoader.js';
 import { applyFlagsToMaterial } from '../utils/materials.js';
 import { getLightFresnel } from '../core/lightFresnel.js';
-import { createCloudShell } from './cloudShell.js';
+import { CloudTextureError, createCloudShell } from './cloudShell.js';
 import { resolvePublicUrl } from '../config/env.js';
 // Debug tag so you can verify the loaded file version in console
 export const WORLD_TEXTURE_DEBUG_TAG = 'WT:vFlipGeom-r3@2025-10-28T17:22:00Z';
@@ -287,8 +287,17 @@ cloudsEnabled = false, cloudsTextureUrl = '/assets/texture/2k_earth_clouds.jpg',
             opacity: cloudsOpacity,
             speed: cloudsSpeed,
             renderer,
+        }).catch((e) => {
+            // Clouds are an optional layer: a texture that cannot be loaded (offline, or gone from the
+            // CDN) costs the clouds, never the planet — the same way a failed surface texture does. Only
+            // that: any other error building the shell is a bug and still fails the build.
+            if (!(e instanceof CloudTextureError))
+                throw e;
+            console.warn('[worldTexture] Failed to load clouds, drawing the world without them:', e.cause);
+            return null;
         });
-        mesh.add(cloudMesh);
+        if (cloudMesh)
+            mesh.add(cloudMesh);
     }
     // Optionally add glow as a child of the mesh so it follows transforms
     if (glow) {

package/package.json

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

package/src/world/cloudShell.ts

@@ -1,6 +1,18 @@
 import * as THREE from 'three';
 import { loadTexture } from '../loaders/bodyTextureLoader.js';
 
+/**
+ * The cloud texture could not be loaded (offline, gone from the CDN, or not decodable). Its own type
+ * so the world builders can drop just the clouds on THIS failure and still let any other error out.
+ * `cause` is what the loader threw.
+ */
+export class CloudTextureError extends Error {
+  constructor(url: string, cause: unknown) {
+    super(`Cloud texture could not be loaded: ${url}`, { cause });
+    this.name = 'CloudTextureError';
+  }
+}
+
 // Texture-only clouds material (alpha mask + tint), UV-scrolled
 async function makeTextureMaterial({
   color = 0xffffff,
@@ -29,7 +41,13 @@ async function makeTextureMaterial({
   if (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 });
+    let tex: THREE.Texture;
+    try {
+      tex = await loadTexture(textureUrl, { renderer });
+    } catch (cause) {
+      mat.dispose();
+      throw new CloudTextureError(textureUrl, cause);
+    }
     tex.wrapS = THREE.RepeatWrapping;
     tex.wrapT = THREE.RepeatWrapping;
     // Use linear space for alpha masks if available
@@ -84,10 +102,7 @@ export async function createCloudShell({
   speed?: number | undefined;
   renderer?: THREE.WebGLRenderer | null | undefined;
 } = {}) {
-  const geom = baseGeometry
-    ? baseGeometry.clone()
-    : new THREE.SphereGeometry(baseRadius, widthSegments, heightSegments);
-
+  // The texture first: when it cannot be loaded this throws before any geometry exists to leak.
   const material = await makeTextureMaterial({
     color,
     opacity,
@@ -95,6 +110,9 @@ export async function createCloudShell({
     speed,
     renderer,
   });
+  const geom = baseGeometry
+    ? baseGeometry.clone()
+    : new THREE.SphereGeometry(baseRadius, widthSegments, heightSegments);
 
   const mesh = new THREE.Mesh(geom, material);
   const s = 1.001; // fixed scale

package/src/world/worldNormal.ts

@@ -3,7 +3,7 @@ import * as THREE from 'three';
 import { EARTH_RADIUS_UNITS } from './worldTexture.js';
 import { applyFlagsToMaterial } from '../utils/materials.js';
 import { getLightFresnel } from '../core/lightFresnel.js';
-import { createCloudShell } from './cloudShell.js';
+import { CloudTextureError, createCloudShell } from './cloudShell.js';
 import { resolvePublicUrl } from '../config/env.js';
 
 /**
@@ -89,8 +89,15 @@ export async function makeNormalSphere({
       opacity: cloudsOpacity,
       speed: cloudsSpeed,
       renderer,
+    }).catch((e: unknown) => {
+      // Clouds are an optional layer: a texture that cannot be loaded (offline, or gone from the
+      // CDN) costs the clouds, never the planet — the same way a failed surface texture does. Only
+      // that: any other error building the shell is a bug and still fails the build.
+      if (!(e instanceof CloudTextureError)) throw e;
+      console.warn('[worldNormal] Failed to load clouds, drawing the world without them:', e.cause);
+      return null;
     });
-    mesh.add(cloudMesh);
+    if (cloudMesh) mesh.add(cloudMesh);
   }
 
   return mesh;

package/src/world/worldTexture.ts

@@ -2,7 +2,7 @@ import * as THREE from 'three';
 import { loadTexture } from '../loaders/bodyTextureLoader.js';
 import { applyFlagsToMaterial } from '../utils/materials.js';
 import { getLightFresnel } from '../core/lightFresnel.js';
-import { createCloudShell } from './cloudShell.js';
+import { CloudTextureError, createCloudShell } from './cloudShell.js';
 import { resolvePublicUrl } from '../config/env.js';
 
 // Debug tag so you can verify the loaded file version in console
@@ -374,8 +374,15 @@ export async function makeSphere({
       opacity: cloudsOpacity,
       speed: cloudsSpeed,
       renderer,
+    }).catch((e: unknown) => {
+      // Clouds are an optional layer: a texture that cannot be loaded (offline, or gone from the
+      // CDN) costs the clouds, never the planet — the same way a failed surface texture does. Only
+      // that: any other error building the shell is a bug and still fails the build.
+      if (!(e instanceof CloudTextureError)) throw e;
+      console.warn('[worldTexture] Failed to load clouds, drawing the world without them:', e.cause);
+      return null;
     });
-    mesh.add(cloudMesh);
+    if (cloudMesh) mesh.add(cloudMesh);
   }
 
   // Optionally add glow as a child of the mesh so it follows transforms