entangled-worlds-orbiters-shared 1.0.8 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Plantasia Space
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -16,15 +16,20 @@ A shared library containing core components for 3D world rendering, moons system
 ```bash
 npm install entangled-worlds-orbiters-shared
 ```
-## Test locally 
+## Test locally
 
-In /entangled-worlds-orbiters-shared:
-npm install 
+In `entangled-worlds-orbiters-shared/`:
+
+```bash
+npm install
 npm link
+```
 
-In /entangled-worlds-preview or /orbiters:
+In the consuming app (`entangled-worlds/` or `orbiters/`):
 
+```bash
 npm link entangled-worlds-orbiters-shared
+```
 
 
 ## Usage
@@ -124,4 +129,6 @@ npm install three three-stdlib
 
 ## License
 
-MIT
+[MIT](LICENSE) © Plantasia Space.
+
+`src/arrow-ui/` is derived from [lil-gui](https://github.com/georgealways/lil-gui) (MIT) — see [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,5 @@
+# Third-party notices
+
+## Arrow UI (`src/arrow-ui/`)
+
+Derived from [lil-gui](https://github.com/georgealways/lil-gui) by George Michael Brower, licensed under the [MIT License](https://github.com/georgealways/lil-gui/blob/master/LICENSE). The controllers and GUI core have been adapted for the Entangled Worlds / Orbiters apps (external stylesheet loading, custom controllers and behavior); the original license applies to the derived portions alongside this project's MIT license.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "entangled-worlds-orbiters-shared",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "description": "Shared library for entangled worlds orbiters - contains core world rendering, moons system, and UI components",
   "type": "module",
   "main": "src/index.js",
@@ -8,7 +8,6 @@
     ".": "./src/index.js",
     "./world": "./src/world/index.js",
     "./moons": "./src/moons/index.js",
-    "./arrow-ui": "./src/arrow-ui/index.js",
     "./loaders": "./src/loaders/index.js",
     "./core": "./src/core/index.js",
     "./config": "./src/config/index.js",
@@ -17,7 +16,9 @@
   "files": [
     "src/**/*",
     "public/**/*",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.md"
   ],
   "keywords": [
     "three.js",
@@ -43,7 +44,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/plantasia-space-org/entangled-worlds-orbiters-shared.git"
+    "url": "git+https://github.com/plantasia-space-org/entangled-worlds-orbiters-shared.git"
   },
   "bugs": {
     "url": "https://github.com/plantasia-space-org/entangled-worlds-orbiters-shared/issues"

package/src/index.js

@@ -1,7 +1,6 @@
 // Main exports for entangled-worlds-orbiters-shared library
 export * from './world/index.js';
 export * from './moons/index.js';
-export * from './arrow-ui/index.js';
 export * from './loaders/index.js';
 export * from './core/index.js';
 export * from './config/index.js';

package/src/utils/dispose.js

@@ -1,9 +1,25 @@
+// Three.js GPU resources are not garbage-collected — geometries, materials, and
+// the textures hanging off materials must be disposed explicitly on teardown, or
+// the consuming app leaks VRAM on every world swap / moon rebuild.
+
 export function disposeMaterial(material) {
   if (!material) return;
-  for (const key in material) {
-    const val = material[key];
-    if (val && typeof val.dispose === 'function') {
-      try { val.dispose(); } catch {}
+  // A mesh can carry a single material or an array (multi-material meshes, some GLB).
+  const materials = Array.isArray(material) ? material : [material];
+  for (const mat of materials) {
+    if (!mat) continue;
+    // Free the textures (and any other disposable values) hanging off the material…
+    for (const key in mat) {
+      const val = mat[key];
+      if (val && typeof val.dispose === 'function') {
+        try { val.dispose(); } catch {}
+      }
+    }
+    // …then free the material's own GPU program. Without this the shader program
+    // leaks even though its textures were released. `dispose` is a prototype method,
+    // so the loop above never reaches it — no double-dispose.
+    if (typeof mat.dispose === 'function') {
+      try { mat.dispose(); } catch {}
     }
   }
 }

package/src/arrow-ui/BooleanController.js

@@ -1,31 +0,0 @@
-import Controller from './Controller';
-
-export default class BooleanController extends Controller {
-
-	constructor( parent, object, property ) {
-
-		super( parent, object, property, 'boolean', 'label' );
-
-		this.$input = document.createElement( 'input' );
-		this.$input.setAttribute( 'type', 'checkbox' );
-		this.$input.setAttribute( 'aria-labelledby', this.$name.id );
-
-		this.$widget.appendChild( this.$input );
-
-		this.$input.addEventListener( 'change', () => {
-			this.setValue( this.$input.checked );
-			this._callOnFinishChange();
-		} );
-
-		this.$disable = this.$input;
-
-		this.updateDisplay();
-
-	}
-
-	updateDisplay() {
-		this.$input.checked = this.getValue();
-		return this;
-	}
-
-}

package/src/arrow-ui/ColorController.js

@@ -1,108 +0,0 @@
-import Controller from './Controller';
-
-import getColorFormat from './utils/getColorFormat';
-import normalizeColorString from './utils/normalizeColorString';
-
-export default class ColorController extends Controller {
-
-	constructor( parent, object, property, rgbScale ) {
-
-		super( parent, object, property, 'color' );
-
-		this.$input = document.createElement( 'input' );
-		this.$input.setAttribute( 'type', 'color' );
-		this.$input.setAttribute( 'tabindex', -1 );
-		this.$input.setAttribute( 'aria-labelledby', this.$name.id );
-
-		this.$text = document.createElement( 'input' );
-		this.$text.setAttribute( 'type', 'text' );
-		this.$text.setAttribute( 'spellcheck', 'false' );
-		this.$text.setAttribute( 'aria-labelledby', this.$name.id );
-
-		this.$display = document.createElement( 'div' );
-		this.$display.classList.add( 'display' );
-
-		this.$display.appendChild( this.$input );
-		this.$widget.appendChild( this.$display );
-		this.$widget.appendChild( this.$text );
-
-		this._format = getColorFormat( this.initialValue );
-		this._rgbScale = rgbScale;
-
-		this._initialValueHexString = this.save();
-		this._textFocused = false;
-
-		this.$input.addEventListener( 'input', () => {
-			this._setValueFromHexString( this.$input.value );
-		} );
-
-		this.$input.addEventListener( 'blur', () => {
-			this._callOnFinishChange();
-		} );
-
-		this.$text.addEventListener( 'input', () => {
-			const tryParse = normalizeColorString( this.$text.value );
-			if ( tryParse ) {
-				this._setValueFromHexString( tryParse );
-			}
-		} );
-
-		this.$text.addEventListener( 'focus', () => {
-			this._textFocused = true;
-			this.$text.select();
-		} );
-
-		this.$text.addEventListener( 'blur', () => {
-			this._textFocused = false;
-			this.updateDisplay();
-			this._callOnFinishChange();
-		} );
-
-		this.$disable = this.$text;
-
-		this.updateDisplay();
-
-	}
-
-	reset() {
-		this._setValueFromHexString( this._initialValueHexString );
-		return this;
-	}
-
-	_setValueFromHexString( value ) {
-
-		if ( this._format.isPrimitive ) {
-
-			const newValue = this._format.fromHexString( value );
-			this.setValue( newValue );
-
-		} else {
-
-			this._format.fromHexString( value, this.getValue(), this._rgbScale );
-			this._callOnChange();
-			this.updateDisplay();
-
-		}
-
-	}
-
-	save() {
-		return this._format.toHexString( this.getValue(), this._rgbScale );
-	}
-
-	load( value ) {
-		this._setValueFromHexString( value );
-		this._callOnFinishChange();
-		return this;
-	}
-
-	updateDisplay() {
-		this.$input.value = this._format.toHexString( this.getValue(), this._rgbScale );
-		if ( !this._textFocused ) {
-			this.$text.value = this.$input.value.substring( 1 );
-		}
-		this.$display.style.backgroundColor = this.$input.value;
-		return this;
-	}
-
-}