entangled-worlds-orbiters-shared 1.0.0

package/README.md

@@ -0,0 +1,75 @@
+# Entangled Worlds Orbiters Shared Library
+
+A shared library containing core components for 3D world rendering, moons system, and UI components used across Entangled Worlds applications.
+
+## Features
+
+- **World System**: Core world rendering with textured spheres, normal materials, GLB models, and cloud shells
+- **Moons System**: Orbital moon generation and management
+- **Arrow UI**: Reusable UI component system based on lil-gui
+- **Loaders**: Texture, GLB, and cubemap loading utilities
+- **Core Rendering**: Lighting, Fresnel effects, and material utilities
+- **Configuration**: Texture and configuration management system
+
+## Installation
+
+```bash
+npm install entangled-worlds-orbiters-shared
+```
+
+## Usage
+
+```javascript
+// Import specific modules
+import { WorldManager } from 'entangled-worlds-orbiters-shared/world';
+import { MoonsManager } from 'entangled-worlds-orbiters-shared/moons';
+import { GUI } from 'entangled-worlds-orbiters-shared/arrow-ui';
+
+// Or import everything
+import * as EntangledWorlds from 'entangled-worlds-orbiters-shared';
+```
+
+## Modules
+
+### World System
+- `WorldManager` - Main world orchestration
+- `worldTexture` - Textured sphere generation  
+- `worldNormal` - Normal material spheres
+- `worldGLB` - GLB model loading
+- `cloudShell` - Cloud rendering system
+
+### Moons System
+- `MoonsManager` - Moons orchestration
+- `moonsGeneration` - Moon generation logic
+
+### Arrow UI
+- Complete UI component system based on lil-gui
+- Controllers for boolean, color, function, number, option, and string inputs
+
+### Loaders
+- `cubeMapLoader` - Skybox loading
+- `glbLoader` - GLB loading utilities
+- `bodyTextureLoader` - Texture loading
+
+### Core
+- `lights` - Lighting setup
+- `lightFresnel` - Fresnel glow effects
+
+### Utils
+- `materials` - Material utilities
+- `dispose` - Memory management
+
+### Configuration
+- `textureConfig` - Texture configuration system
+
+## Peer Dependencies
+
+This library requires Three.js and three-stdlib as peer dependencies:
+
+```bash
+npm install three three-stdlib
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "entangled-worlds-orbiters-shared",
+  "version": "1.0.0",
+  "description": "Shared library for entangled worlds orbiters - contains core world rendering, moons system, and UI components",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./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",
+    "./utils": "./src/utils/index.js"
+  },
+  "files": [
+    "src/**/*",
+    "public/**/*",
+    "README.md"
+  ],
+  "keywords": [
+    "three.js",
+    "3d",
+    "orbiter",
+    "world",
+    "planets",
+    "moons",
+    "rendering"
+  ],
+  "author": "Plantasia Space",
+  "license": "MIT",
+  "peerDependencies": {
+    "three": "^0.166.1",
+    "three-stdlib": "^2.34.0"
+  },
+  "devDependencies": {
+    "three": "^0.166.1",
+    "three-stdlib": "^2.34.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:plantasia-space-org/entangled-worlds-orbiters-shared.git"
+  },
+  "bugs": {
+    "url": "https://github.com/plantasia-space-org/entangled-worlds-orbiters-shared/issues"
+  },
+  "homepage": "https://github.com/plantasia-space-org/entangled-worlds-orbiters-shared#readme"
+}

package/public/config/textures.json

@@ -0,0 +1,332 @@
+{
+  "version": "1.0",
+  "lastUpdated": "2024-01-01T00:00:00Z",
+  "baseUrl": "/default",
+  "textures": {
+    "clouds": {
+      "category": "atmospheric",
+      "basePath": "/clouds",
+      "defaultTexture": "04-clouds.ktx2",
+      "items": [
+        {
+          "id": "water-drops",
+          "filename": "18-water-drops.ktx2",
+          "label": "Water Drops",
+          "description": "Atmospheric water droplets",
+          "tags": ["atmospheric", "water", "natural"]
+        },
+        {
+          "id": "scream-1",
+          "filename": "17-scream.ktx2",
+          "label": "Scream",
+          "description": "Abstract screaming patterns",
+          "tags": ["abstract", "artistic"]
+        },
+        {
+          "id": "scream-2",
+          "filename": "16-scream.ktx2",
+          "label": "Scream Alt",
+          "description": "Alternative screaming patterns",
+          "tags": ["abstract", "artistic"]
+        },
+        {
+          "id": "neon-lights-1",
+          "filename": "15-neon-lights.ktx2",
+          "label": "Neon Lights",
+          "description": "Electric neon lighting effects",
+          "tags": ["electric", "urban", "artificial"]
+        },
+        {
+          "id": "neon-lights-2",
+          "filename": "14-neon-lights.ktx2",
+          "label": "Neon Lights Alt",
+          "description": "Alternative neon lighting",
+          "tags": ["electric", "urban", "artificial"]
+        },
+        {
+          "id": "neon-lights-3",
+          "filename": "13-neon-lights.ktx2",
+          "label": "Neon Lights Pro",
+          "description": "Professional neon effects",
+          "tags": ["electric", "urban", "artificial"]
+        },
+        {
+          "id": "marble-1",
+          "filename": "12-marble.ktx2",
+          "label": "Marble",
+          "description": "Natural marble patterns",
+          "tags": ["stone", "natural", "elegant"]
+        },
+        {
+          "id": "marble-2",
+          "filename": "11-marble.ktx2",
+          "label": "Marble Alt",
+          "description": "Alternative marble texture",
+          "tags": ["stone", "natural", "elegant"]
+        },
+        {
+          "id": "isolines-1",
+          "filename": "10-isolines.ktx2",
+          "label": "Isolines",
+          "description": "Topographic isolines",
+          "tags": ["geometric", "lines", "technical"]
+        },
+        {
+          "id": "isolines-2",
+          "filename": "09-isolines.ktx2",
+          "label": "Isolines Alt",
+          "description": "Alternative isolines pattern",
+          "tags": ["geometric", "lines", "technical"]
+        },
+        {
+          "id": "fordite-1",
+          "filename": "08-fordite.ktx2",
+          "label": "Fordite",
+          "description": "Industrial fordite patterns",
+          "tags": ["industrial", "layered", "colorful"]
+        },
+        {
+          "id": "fordite-2",
+          "filename": "07-fordite.ktx2",
+          "label": "Fordite Alt",
+          "description": "Alternative fordite texture",
+          "tags": ["industrial", "layered", "colorful"]
+        },
+        {
+          "id": "entangled-1",
+          "filename": "06-entangled.ktx2",
+          "label": "Entangled",
+          "description": "Quantum entangled patterns",
+          "tags": ["quantum", "abstract", "complex"]
+        },
+        {
+          "id": "entangled-2",
+          "filename": "05-entangled.ktx2",
+          "label": "Entangled Alt",
+          "description": "Alternative entangled patterns",
+          "tags": ["quantum", "abstract", "complex"]
+        },
+        {
+          "id": "clouds-1",
+          "filename": "04-clouds.ktx2",
+          "label": "Clouds",
+          "description": "Natural cloud formations",
+          "tags": ["natural", "atmospheric", "default"]
+        },
+        {
+          "id": "clouds-2",
+          "filename": "03-clouds.ktx2",
+          "label": "Clouds Alt",
+          "description": "Alternative cloud patterns",
+          "tags": ["natural", "atmospheric"]
+        },
+        {
+          "id": "cave-art-1",
+          "filename": "02-cave-art.ktx2",
+          "label": "Cave Art",
+          "description": "Ancient cave paintings",
+          "tags": ["ancient", "artistic", "historic"]
+        },
+        {
+          "id": "cave-art-2",
+          "filename": "01-cave-art.ktx2",
+          "label": "Cave Art Alt",
+          "description": "Alternative cave art patterns",
+          "tags": ["ancient", "artistic", "historic"]
+        }
+      ]
+    },
+    "moons": {
+      "category": "celestial",
+      "basePath": "/textures/moons",
+      "defaultTexture": "moon-equirectangular.ktx2",
+      "items": [
+        {
+          "id": "electric-moon",
+          "filename": "moon-equirectangular.ktx2",
+          "label": "Electric Moon",
+          "description": "Standard lunar surface texture",
+          "tags": ["lunar", "realistic", "default"],
+          "fallback": "moon-equirectangular.jpg"
+        },
+        {
+          "id": "earth-moon",
+          "filename": "2k_moon.ktx2",
+          "label": "Earth Moon",
+          "description": "Realistic Earth satellite texture",
+          "tags": ["lunar", "earth", "satellite"],
+          "fallback": "2k_moon.jpg"
+        },
+        {
+          "id": "crater-lines",
+          "filename": "crater-lines.ktx2",
+          "label": "Crater Lines",
+          "description": "Linear crater formations across the lunar surface",
+          "tags": ["craters", "lunar", "pattern"],
+          "fallback": "crater-lines.jpg"
+        },
+        {
+          "id": "moon-dust",
+          "filename": "moon-dust.ktx2",
+          "label": "Moon Dust",
+          "description": "Fine dust texture inspired by lunar regolith",
+          "tags": ["dust", "surface", "regolith"],
+          "fallback": "moon-dust.jpg"
+        },
+        {
+          "id": "lunar-scepter",
+          "filename": "lunar-scepter.ktx2",
+          "label": "Lunar Scepter",
+          "description": "Sharp, vertical ridge texture reminiscent of lunar highlands",
+          "tags": ["ridges", "highlands", "lunar"],
+          "fallback": "lunar-scepter.jpg"
+        },
+        {
+          "id": "satin-moon",
+          "filename": "satin-moon.ktx2",
+          "label": "Satin Moon",
+          "description": "Smooth satin-like lunar surface",
+          "tags": ["smooth", "lunar", "texture"],
+          "fallback": "satin-moon.jpg"
+        },
+        {
+          "id": "impact-craters",
+          "filename": "impact-craters.ktx2",
+          "label": "Impact Craters",
+          "description": "Dense field of lunar craters",
+          "tags": ["craters", "impact", "texture"],
+          "fallback": "impact-craters.jpg"
+        },
+        {
+          "id": "eclipse-dots",
+          "filename": "eclipse-dots.ktx2",
+          "label": "Eclipse Dots",
+          "description": "Pattern of scattered dots inspired by lunar eclipses",
+          "tags": ["dots", "eclipse", "pattern"],
+          "fallback": "eclipse-dots.jpg"
+        },
+        {
+          "id": "shadow-dots",
+          "filename": "shadow-dots.ktx2",
+          "label": "Shadow Dots",
+          "description": "Dot textures evoking shadows over the lunar surface",
+          "tags": ["dots", "shadows", "surface"],
+          "fallback": "shadow-dots.jpg"
+        },
+        {
+          "id": "moonrise",
+          "filename": "moonrise.ktx2",
+          "label": "Moonrise",
+          "description": "Atmospheric gradient evoking moonrise",
+          "tags": ["moonrise", "gradient", "lunar"],
+          "fallback": "moonrise.jpg"
+        },
+        {
+          "id": "midnight-moon",
+          "filename": "midnight-moon.ktx2",
+          "label": "Midnight Moon",
+          "description": "Dark-toned lunar surface texture",
+          "tags": ["midnight", "dark", "lunar"],
+          "fallback": "midnight-moon.jpg"
+        },
+        {
+          "id": "pale-orbit",
+          "filename": "pale-orbit.ktx2",
+          "label": "Pale Orbit",
+          "description": "Light lunar surface with subtle orbital tones",
+          "tags": ["orbit", "pale", "surface"],
+          "fallback": "pale-orbit.jpg"
+        },
+        {
+          "id": "tidal-glow",
+          "filename": "tidal-glow.ktx2",
+          "label": "Tidal Glow",
+          "description": "Soft glowing lunar texture reflecting tidal pull",
+          "tags": ["glow", "tidal", "lunar"],
+          "fallback": "tidal-glow.jpg"
+        },
+        {
+          "id": "silver-glow",
+          "filename": "silver-glow.ktx2",
+          "label": "Silver Glow",
+          "description": "Bright silver surface with reflective highlights",
+          "tags": ["silver", "glow", "lunar"],
+          "fallback": "silver-glow.jpg"
+        }
+      ]
+    },
+    "skyboxes": {
+      "category": "environment",
+      "basePath": "/skybox",
+      "defaultSkybox": "001",
+      "items": [
+        {
+          "id": "001",
+          "label": "Deep Space",
+          "description": "Deep space with distant stars",
+          "tags": ["space", "dark", "minimal"]
+        },
+        {
+          "id": "002",
+          "label": "Nebula Field",
+          "description": "Colorful nebula formations",
+          "tags": ["nebula", "colorful", "cosmic"]
+        },
+        {
+          "id": "003",
+          "label": "Galaxy Center",
+          "description": "Dense galactic core region",
+          "tags": ["galaxy", "dense", "bright"]
+        },
+        {
+          "id": "004",
+          "label": "Binary System",
+          "description": "Binary star system environment",
+          "tags": ["binary", "stars", "orange"]
+        },
+        {
+          "id": "005",
+          "label": "Cosmic Web",
+          "description": "Large-scale cosmic structure",
+          "tags": ["cosmic", "web", "structure"]
+        },
+        {
+          "id": "006",
+          "label": "Stellar Nursery",
+          "description": "Star formation region",
+          "tags": ["formation", "young", "bright"]
+        },
+        {
+          "id": "007",
+          "label": "Dark Matter",
+          "description": "Dark matter visualization",
+          "tags": ["dark", "matter", "theoretical"]
+        },
+        {
+          "id": "008",
+          "label": "Quantum Foam",
+          "description": "Quantum scale space-time",
+          "tags": ["quantum", "foam", "microscopic"]
+        },
+        {
+          "id": "009",
+          "label": "Event Horizon",
+          "description": "Black hole event horizon",
+          "tags": ["black hole", "horizon", "gravity"]
+        },
+        {
+          "id": "010",
+          "label": "Multiverse",
+          "description": "Multiple universe visualization",
+          "tags": ["multiverse", "infinite", "parallel"]
+        },
+        {
+          "id": "011",
+          "label": "Void Space",
+          "description": "Empty cosmic void region",
+          "tags": ["void", "empty", "minimal"]
+        }
+      ]
+    }
+  }
+}

package/src/arrow-ui/BooleanController.js

@@ -0,0 +1,31 @@
+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

@@ -0,0 +1,108 @@
+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;
+	}
+
+}