@3driseai/3drise-core 1.0.21 → 1.0.23

package/dist/services/SceneActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SceneActions.d.ts","sourceRoot":"","sources":["../../src/services/SceneActions.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEpF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,MAAM,MAAM,iBAAiB;AACzB,oHAAoH;AAClH;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GACtG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE;AAChE,oDAAoD;GAClD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IAC/B,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAOD,cAAM,YAAY;IACd,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,MAAM,CAAgD;IAC9D,qFAAqF;IACrF,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,OAAO,CAAK;IAEpB,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,kBAAuB,GAAG,IAAI;IAc3E,gEAAgE;IAChE,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI;IASvD,iFAAiF;IACjF,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAS7C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI1C,mBAAmB,IAAI,MAAM,EAAE;IAI/B,8DAA8D;IAC9D,KAAK,IAAI,IAAI;IAQb,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,aAAa,GAAG,SAAS;IAKrE,iEAAiE;IACjE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAaxD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKjE,yFAAyF;IACzF,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,MAAM;CAgBjB;AAED,QAAA,MAAM,YAAY,cAAqB,CAAC;AACxC,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SceneActions.d.ts","sourceRoot":"","sources":["../../src/services/SceneActions.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEpF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,MAAM,MAAM,iBAAiB;AACzB,oHAAoH;AAClH;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GACtG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE;AAChE,oDAAoD;GAClD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IAC/B,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAOD,cAAM,YAAY;IACd,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,MAAM,CAAgD;IAC9D,qFAAqF;IACrF,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,OAAO,CAAK;IACpB,kGAAkG;IAClG,OAAO,CAAC,MAAM,CAA6B;IAE3C,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,kBAAuB,GAAG,IAAI;IAc3E,gEAAgE;IAChE,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI;IASvD,iFAAiF;IACjF,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAS7C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI1C,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI,GAAG,IAAI;IAgB9E,8DAA8D;IAC9D,KAAK,IAAI,IAAI;IASb,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,aAAa,GAAG,SAAS;IAKrE,iEAAiE;IACjE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAaxD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKjE,yFAAyF;IACzF,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,aAAa;IAYrB,+CAA+C;IAC/C,OAAO,CAAC,MAAM;CAiBjB;AAED,QAAA,MAAM,YAAY,cAAqB,CAAC;AACxC,eAAe,YAAY,CAAC"}

package/dist/services/SceneActions.js

@@ -7,6 +7,8 @@ class SceneActions {
     stateListeners = new Map();
     eventListeners = new Set();
     version = 0;
+    /** Layer id -> JSON of what it last set (setLayer is called every frame; only changes commit). */
+    layers = new Map();
     /** Apply an action. Re-applying moves its patches to the top of each stack. */
     applyAction(action, options = {}) {
         const reapplied = this.applied.has(action.id);
@@ -47,11 +49,36 @@ class SceneActions {
     getAppliedActionIds() {
         return Array.from(this.applied.keys());
     }
+    /**
+     * Set a layer's patches (state -> patch), replacing what it set before; null or {}
+     * removes it. A no-op when nothing changed, so it can be called every frame. A
+     * changed layer moves to the top of each stack it is on.
+     */
+    setLayer(layerId, patches) {
+        const entries = Object.entries(patches ?? {}).filter(([state, patch]) => state && patch && Object.keys(patch).length > 0);
+        const json = entries.length ? JSON.stringify(entries) : '';
+        if ((this.layers.get(layerId) ?? '') === json)
+            return;
+        const key = `layer:${layerId}`;
+        const touched = this.removeEntries(key);
+        for (const [state, patch] of entries) {
+            const stack = this.stacks.get(state) ?? [];
+            stack.push({ actionId: key, patch });
+            this.stacks.set(state, stack);
+            touched.add(state);
+        }
+        if (json)
+            this.layers.set(layerId, json);
+        else
+            this.layers.delete(layerId);
+        this.commit(touched);
+    }
     /** Drop every patch (project load, "reset" in the editor). */
     reset() {
         const touched = new Set(this.stacks.keys());
         const actions = Array.from(this.applied.values());
         this.stacks.clear();
+        this.layers.clear();
         this.applied.clear();
         this.commit(touched, { type: 'reset', actions });
     }
@@ -98,6 +125,7 @@ class SceneActions {
         }
         return touched;
     }
+    /** `event` absent: a layer change (silent). */
     commit(touched, event) {
         for (const state of touched) {
             const stack = this.stacks.get(state);
@@ -116,6 +144,8 @@ class SceneActions {
                 }
             });
         }
+        if (!event)
+            return;
         this.eventListeners.forEach(l => {
             try {
                 l(event);

package/dist/services/SkySystemManager.d.ts

@@ -16,7 +16,16 @@ export interface SkyTimeState {
      *  schedule expensive work off a sun change (a cube-camera capture) use this
      *  to stand down and let the environment probe's own timer do it once. */
     advancing: boolean;
+    /** Unit vector toward the moon (sunUtils convention). */
+    moonDirection: THREE.Vector3;
+    moonElevation: number;
+    /** 0..1, see TimeSettings.moonPhase. */
+    moonPhase: number;
+    /** Lit fraction of the disc, 0 at new moon, 1 at full. */
+    moonIllumination: number;
 }
+/** Lit fraction of the moon's disc for a phase in 0..1. */
+export declare const moonIlluminationForPhase: (phase: number) => number;
 export declare class SkySystemManager {
     private static instance;
     private timeInHours;
@@ -28,6 +37,9 @@ export declare class SkySystemManager {
     private sunElevation;
     private sunAzimuth;
     private sunDirection;
+    private moonPhase;
+    private moonElevation;
+    private moonDirection;
     private enabled;
     private timescale;
     private autoAnimate;
@@ -89,6 +101,13 @@ export declare class SkySystemManager {
     private publishTime;
     private syncToRealTime;
     private recalculateState;
+    /**
+     * The moon runs the sun's own daily arc, `moonPhase` of a day behind it:
+     * a new moon rides with the sun, a full moon is 12 h behind — rising at
+     * sunset, highest at midnight, setting at sunrise — which is where the real
+     * one is. Same curve, same convention, so the two can never cross wrongly.
+     */
+    private calculateMoon;
     /**
      * Sun elevation and azimuth for a given hour.
      *
@@ -114,6 +133,9 @@ export declare class SkySystemManager {
      *  JS's signed `%`, so the night arc's 360-540 degrees maps onto the same
      *  directions the day arc's 180-360 does instead of running off the end. */
     private transformAzimuth;
+    /** Same convention as the Preetham sky (sunUtils), so the direction this
+     *  publishes is exactly where SkyController draws the disc for the same
+     *  elevation/azimuth. */
     private updateSunDirection;
 }
 export declare const skySystemManager: SkySystemManager;

package/dist/services/SkySystemManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SkySystemManager.d.ts","sourceRoot":"","sources":["../../src/services/SkySystemManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,YAAY;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB;;8EAE0E;IAC1E,SAAS,EAAE,OAAO,CAAC;CACtB;AAaD,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAQ;IAC/B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,UAAU,CAAQ;IAC1B;;mEAE+D;IAC/D,OAAO,CAAC,oBAAoB,CAAuB;IACnD;8CAC0C;IAC1C,OAAO,CAAC,eAAe,CAAK;IAC5B;;2DAEuD;IACvD,OAAO,CAAC,MAAM,CAAuB;;IAIrC,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAMtC,MAAM,CAAC,aAAa,IAAI,IAAI;IAG5B;;iBAEa;IACb,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMnC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC,SAAS,IAAI,OAAO;IAGpB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IA6B7C,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAGnE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,GAAG,IAAI;IAQjD;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAczB,QAAQ,IAAI,YAAY;IAexB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAoB/C,OAAO,IAAI,IAAI;IAKf,YAAY,IAAI,cAAc;IAG9B,eAAe,IAAI,KAAK,CAAC,OAAO;IAGhC,cAAc,IAAI,MAAM;IAGxB,SAAS,IAAI,OAAO;IAGpB,eAAe,IAAI,OAAO;IAG1B,WAAW,IAAI,OAAO;IAGtB,OAAO,CAAC,WAAW;IAWnB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,gBAAgB;IASxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;gFAE4E;IAC5E,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,kBAAkB;CAQ7B;AACD,eAAO,MAAM,gBAAgB,EAAE,gBAAiD,CAAC;AACjF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"SkySystemManager.d.ts","sourceRoot":"","sources":["../../src/services/SkySystemManager.ts"],"names":[],"mappings":"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"}

package/dist/services/SkySystemManager.js

@@ -1,4 +1,6 @@
 import * as THREE from 'three';
+import { sunDirectionFromAngles } from '../utils/sunUtils.js';
+import { SKY_PHASE_ELEVATIONS } from '../utils/skyPhase.js';
 const SUNRISE = 6;
 const SUNSET = 21;
 const MAX_ELEVATION = 42;
@@ -9,6 +11,11 @@ const HORIZON_OFFSET = 5;
 const MAX_NIGHT_DEPTH = 21;
 /** Real seconds between playback write-backs to the host. */
 const SYNC_INTERVAL_SECONDS = 0.25;
+const DEFAULT_MOON_PHASE = 0.5;
+const wrap01 = (v) => ((v % 1) + 1) % 1;
+const wrap24 = (h) => ((h % 24) + 24) % 24;
+/** Lit fraction of the moon's disc for a phase in 0..1. */
+export const moonIlluminationForPhase = (phase) => (1 - Math.cos(2 * Math.PI * phase)) / 2;
 export class SkySystemManager {
     static instance = null;
     timeInHours = 12;
@@ -20,6 +27,9 @@ export class SkySystemManager {
     sunElevation = 37;
     sunAzimuth = 270;
     sunDirection = new THREE.Vector3(0, 1, 0);
+    moonPhase = DEFAULT_MOON_PHASE;
+    moonElevation = 0;
+    moonDirection = new THREE.Vector3(0, -1, 0);
     enabled = false;
     timescale = 60;
     autoAnimate = false;
@@ -38,7 +48,7 @@ export class SkySystemManager {
      *  otherwise double-tick it and stomp its settings. */
     driver = null;
     constructor() {
-        this.updateSunDirection();
+        this.recalculateState();
     }
     static getInstance() {
         if (!SkySystemManager.instance) {
@@ -67,6 +77,9 @@ export class SkySystemManager {
         return this.driver !== null;
     }
     setTimeSettings(settings) {
+        const moonPhase = wrap01(settings.moonPhase ?? DEFAULT_MOON_PHASE);
+        const phaseChanged = moonPhase !== this.moonPhase;
+        this.moonPhase = moonPhase;
         this.enabled = settings.enabled;
         this.timescale = settings.timescale;
         this.autoAnimate = settings.autoAnimate;
@@ -94,6 +107,9 @@ export class SkySystemManager {
             this.syncAccumulator = 0;
             this.recalculateState();
         }
+        else if (phaseChanged) {
+            this.recalculateState();
+        }
     }
     setOnTimeSync(callback) {
         this.onTimeSync = callback;
@@ -139,14 +155,16 @@ export class SkySystemManager {
             elapsedTime: this.elapsedTime,
             autoAnimate: this.autoAnimate,
             advancing: this.isAdvancing(),
+            moonDirection: this.moonDirection,
+            moonElevation: this.moonElevation,
+            moonPhase: this.moonPhase,
+            moonIllumination: moonIlluminationForPhase(this.moonPhase),
         };
     }
     getStateByTime(timeOfDay) {
         const state = this.calculateTimeState(timeOfDay);
-        const el = THREE.MathUtils.degToRad(state.sunElevation);
-        const az = THREE.MathUtils.degToRad(this.transformAzimuth(state.sunAzimuth));
-        const distance = 0.5;
-        const sunDirection = new THREE.Vector3(distance * Math.cos(el) * Math.sin(az), distance * Math.sin(el), distance * Math.cos(el) * Math.cos(az)).normalize();
+        const sunDirection = sunDirectionFromAngles(state.sunElevation, this.transformAzimuth(state.sunAzimuth), new THREE.Vector3());
+        const moon = this.calculateMoon(timeOfDay, new THREE.Vector3());
         return {
             timeInHours: timeOfDay,
             normalizedTime: state.normalizedTime,
@@ -159,6 +177,10 @@ export class SkySystemManager {
             elapsedTime: this.elapsedTime,
             autoAnimate: this.autoAnimate,
             advancing: this.isAdvancing(),
+            moonDirection: moon.direction,
+            moonElevation: moon.elevation,
+            moonPhase: this.moonPhase,
+            moonIllumination: moonIlluminationForPhase(this.moonPhase),
         };
     }
     getTime() {
@@ -240,6 +262,18 @@ export class SkySystemManager {
         this.sunElevation = state.sunElevation;
         this.sunAzimuth = state.sunAzimuth;
         this.updateSunDirection();
+        this.moonElevation = this.calculateMoon(this.timeInHours, this.moonDirection).elevation;
+    }
+    /**
+     * The moon runs the sun's own daily arc, `moonPhase` of a day behind it:
+     * a new moon rides with the sun, a full moon is 12 h behind — rising at
+     * sunset, highest at midnight, setting at sunrise — which is where the real
+     * one is. Same curve, same convention, so the two can never cross wrongly.
+     */
+    calculateMoon(timeInHours, out) {
+        const m = this.calculateTimeState(wrap24(timeInHours - this.moonPhase * 24));
+        sunDirectionFromAngles(m.sunElevation, this.transformAzimuth(m.sunAzimuth), out);
+        return { elevation: m.sunElevation, direction: out };
     }
     /**
      * Sun elevation and azimuth for a given hour.
@@ -277,14 +311,14 @@ export class SkySystemManager {
             sunElevation = -HORIZON_OFFSET - Math.cos(Math.PI * (normalizedTime - 0.5)) * MAX_NIGHT_DEPTH;
             sunAzimuth = 360 + 180 * normalizedTime;
         }
+        // Labels follow the sun's height (skyPhase), the same keys the atmosphere
+        // and the stars turn on, so the label never says Midday under a red sky.
         let timeOfDay = 'Nighttime';
-        if (isDaytime) {
-            if (normalizedTime <= 0.25)
-                timeOfDay = 'Sunrise';
-            else if (normalizedTime <= 0.75)
-                timeOfDay = 'Midday';
-            else
-                timeOfDay = 'Sunset';
+        if (sunElevation >= SKY_PHASE_ELEVATIONS.day)
+            timeOfDay = 'Midday';
+        else if (sunElevation > SKY_PHASE_ELEVATIONS.twilight) {
+            const morning = isDaytime ? normalizedTime < 0.5 : timeInHours < 12;
+            timeOfDay = morning ? 'Sunrise' : 'Sunset';
         }
         return { normalizedTime, isDaytime, timeOfDay, sunElevation, sunAzimuth };
     }
@@ -295,13 +329,11 @@ export class SkySystemManager {
         const wrapped = (((270 - rawAzimuth) % 360) + 360) % 360;
         return wrapped - 180;
     }
+    /** Same convention as the Preetham sky (sunUtils), so the direction this
+     *  publishes is exactly where SkyController draws the disc for the same
+     *  elevation/azimuth. */
     updateSunDirection() {
-        const el = THREE.MathUtils.degToRad(this.sunElevation);
-        const az = THREE.MathUtils.degToRad(this.transformAzimuth(this.sunAzimuth));
-        const distance = 0.5;
-        this.sunDirection
-            .set(distance * Math.cos(el) * Math.sin(az), distance * Math.sin(el), distance * Math.cos(el) * Math.cos(az))
-            .normalize();
+        sunDirectionFromAngles(this.sunElevation, this.transformAzimuth(this.sunAzimuth), this.sunDirection);
     }
 }
 export const skySystemManager = SkySystemManager.getInstance();

package/dist/services/TextureResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextureResolver.d.ts","sourceRoot":"","sources":["../../src/services/TextureResolver.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,cAAM,sBAAsB;IAExB,OAAO,CAAC,KAAK,CAAa;IAC1B;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe5C;;OAEG;IACH,YAAY,CAAC,IAAI,GAAE,MAAiB,GAAG,OAAO;IAG9C;;;;;;;;;;OAUG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAqCnG;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAG9B;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAG3C;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOxB;;OAEG;IACH,QAAQ,IAAI;QACA,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,EAAE,CAAC;KACxB;CAMZ;AAED,eAAO,MAAM,eAAe,EAAE,sBAAqD,CAAC;AAEpF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"TextureResolver.d.ts","sourceRoot":"","sources":["../../src/services/TextureResolver.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAKhD,cAAM,sBAAsB;IAExB,OAAO,CAAC,KAAK,CAAa;IAC1B;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe5C;;OAEG;IACH,YAAY,CAAC,IAAI,GAAE,MAAiB,GAAG,OAAO;IAG9C;;;;;;;;;;OAUG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAoDnG;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAG9B;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAG3C;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOxB;;OAEG;IACH,QAAQ,IAAI;QACA,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,EAAE,CAAC;KACxB;CAMZ;AAED,eAAO,MAAM,eAAe,EAAE,sBAAqD,CAAC;AAEpF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/services/TextureResolver.js

@@ -13,6 +13,9 @@
 import { loadTextureAsync } from '../utils/loadingManager.js';
 import { NoiseGenerator } from './NoiseGenerator.js';
 import MaterialRegistryAPI from '../services/MaterialRegistry.js';
+import { SRGBColorSpace } from "three";
+/** Texture slots that hold colour (sRGB) data; the rest (normal, roughness…) are linear. */
+const SRGB_TEXTURE_KEYS = new Set(['map', 'emissiveMap', 'specularColorMap', 'sheenColorMap']);
 class TextureResolverService {
     // Cache: URL string → loaded Texture
     cache = new Map();
@@ -87,6 +90,25 @@ class TextureResolverService {
         }
         // Wait for all texture loads to complete
         await Promise.all(texturePromises);
+        // Per-material texture state on a copy (the loaded texture is cached and shared):
+        // tiling from settings.textureRepeat ([x, y] or a number), and sRGB for colour maps.
+        const rep = settings.textureRepeat;
+        const repeat = Array.isArray(rep) && rep.length === 2 ? rep : typeof rep === 'number' ? [rep, rep] : null;
+        for (const key of textureKeys) {
+            const tex = resolved[key];
+            if (!tex || !tex.isTexture || typeof settings[key] !== 'string')
+                continue;
+            const srgb = SRGB_TEXTURE_KEYS.has(key);
+            if (!repeat && !srgb)
+                continue;
+            const copy = tex.clone();
+            if (srgb)
+                copy.colorSpace = SRGBColorSpace;
+            if (repeat)
+                copy.repeat.set(Number(repeat[0]) || 1, Number(repeat[1]) || 1);
+            copy.needsUpdate = true;
+            resolved[key] = copy;
+        }
         return resolved;
     }
     /**

package/dist/services/index.d.ts

@@ -12,7 +12,7 @@ export { PositionsCreator } from './PositionsCreator';
 export * from './NoiseGenerator';
 export { TextureResolverService, textureResolver } from './TextureResolver';
 export { UniformConverter, UniformProcessor, uniformConverter } from './UniformConverter';
-export { SkySystemManager, skySystemManager } from './SkySystemManager';
+export { SkySystemManager, skySystemManager, moonIlluminationForPhase } from './SkySystemManager';
 export { CubeCameraManager, cubeCameraManager } from './CubeCameraManager';
 export { default as SceneStore } from './SceneStore';
 export { default as SceneActions } from './SceneActions';

package/dist/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,GAAG,MAAM,oBAAoB,CAAC;AAE5H,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACtF,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,GAAG,MAAM,oBAAoB,CAAC;AAE5H,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACtF,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/services/index.js

@@ -9,7 +9,7 @@ export { PositionsCreator } from './PositionsCreator.js';
 export * from './NoiseGenerator.js';
 export { TextureResolverService, textureResolver } from './TextureResolver.js';
 export { UniformConverter, UniformProcessor, uniformConverter } from './UniformConverter.js';
-export { SkySystemManager, skySystemManager } from './SkySystemManager.js';
+export { SkySystemManager, skySystemManager, moonIlluminationForPhase } from './SkySystemManager.js';
 export { CubeCameraManager, cubeCameraManager } from './CubeCameraManager.js';
 export { default as SceneStore } from './SceneStore.js';
 export { default as SceneActions } from './SceneActions.js';

package/dist/shaders/SkyboxMaterial.js

@@ -34,13 +34,13 @@ const fragmentShader = /*glsl*/ `
     // Sky gradient from horizon to zenith
     vec3 skyColor = mix(uSkyColorLow, uSkyColorHigh, clamp(direction.y * 0.5 + 0.5, 0.0, 1.0));
 
-    // Calculate sun direction from azimuth and elevation
+    // Sun direction from azimuth and elevation, same convention as core sunUtils
     float azimuth = radians(uSunAzimuth);
     float elevation = radians(uSunElevation);
     vec3 sunDirection = normalize(vec3(
-      cos(elevation) * sin(azimuth),
+      cos(elevation) * cos(azimuth),
       sin(elevation),
-      cos(elevation) * cos(azimuth)
+      cos(elevation) * sin(azimuth)
     ));
 
     // Sun disc with intensity falloff

package/dist/shaders/StarsMaterial.d.ts

@@ -15,6 +15,10 @@ export interface StarsMaterialUniforms {
     colorMix: {
         value: number;
     };
+    /** Multiplier on every star's sprite size. */
+    sizeScale: {
+        value: number;
+    };
 }
 declare global {
     namespace JSX {
@@ -29,6 +33,7 @@ declare const StarsMaterial: import("@react-three/fiber").ConstructorRepresentat
     uColor: THREE.Color;
     targetColor: THREE.Color;
     colorMix: number;
+    sizeScale: number;
 }> & {
     key: string;
 };

package/dist/shaders/StarsMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StarsMaterial.d.ts","sourceRoot":"","sources":["../../src/shaders/StarsMaterial.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE;QACF,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;KACtB,CAAC;IACF,WAAW,EAAE;QACT,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;CACL;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,GAAG,CAAC;QACV,UAAU,iBAAiB;YACvB,aAAa,EAAE,GAAG,CAAC;SACtB;KACJ;CACJ;AA+DD,QAAA,MAAM,aAAa;;;;;;;;CAMa,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"StarsMaterial.d.ts","sourceRoot":"","sources":["../../src/shaders/StarsMaterial.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE;QACF,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;KACtB,CAAC;IACF,WAAW,EAAE;QACT,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,8CAA8C;IAC9C,SAAS,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;CACL;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,GAAG,CAAC;QACV,UAAU,iBAAiB;YACvB,aAAa,EAAE,GAAG,CAAC;SACtB;KACJ;CACJ;AAgED,QAAA,MAAM,aAAa;;;;;;;;;CAOa,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/shaders/StarsMaterial.js

@@ -2,64 +2,65 @@ import { extend } from "@react-three/fiber";
 import { shaderMaterial } from "@react-three/drei";
 import * as THREE from "three";
 // Vertex shader with twinkling effect
-const vertexShader = /*glsl*/ `
-  attribute float size;
-  attribute vec3 color;
-  attribute float phase;
-  attribute float freq;
-  
-  varying vec3 vColor;
-  varying float vDepth;
-  
-  uniform float time;
-
-  void main() {
-    vColor = color;
-    vec4 mvPosition = modelViewMatrix * vec4(position, 1.0);
-    vDepth = mvPosition.z;
-
-    // Twinkling effect based on time, frequency, and phase
-    float twinkle = sin(time * freq + phase) * 0.2 + 0.8;
-    gl_PointSize = size * twinkle;
-
-    // Position stars at far depth to appear behind everything
-    vec4 pos = projectionMatrix * mvPosition;
-    pos.z = pos.w * 0.999999;
-    gl_Position = pos;
-  }
+const vertexShader = /*glsl*/ `
+  attribute float size;
+  attribute vec3 color;
+  attribute float phase;
+  attribute float freq;
+  
+  varying vec3 vColor;
+  varying float vDepth;
+  
+  uniform float time;
+  uniform float sizeScale;
+
+  void main() {
+    vColor = color;
+    vec4 mvPosition = modelViewMatrix * vec4(position, 1.0);
+    vDepth = mvPosition.z;
+
+    // Twinkling effect based on time, frequency, and phase
+    float twinkle = sin(time * freq + phase) * 0.2 + 0.8;
+    gl_PointSize = size * twinkle * sizeScale;
+
+    // Position stars at far depth to appear behind everything
+    vec4 pos = projectionMatrix * mvPosition;
+    pos.z = pos.w * 0.999999;
+    gl_Position = pos;
+  }
 `;
 // Fragment shader with star glow effect and color transitions
-const fragmentShader = /*glsl*/ `
-  varying vec3 vColor;
-  varying float vDepth;
-  
-  uniform float opacity;
-  uniform vec3 uColor;
-  uniform vec3 targetColor;
-  uniform float colorMix;
-
-  void main() {
-    // Calculate distance from center of point
-    vec2 center = gl_PointCoord - vec2(0.5);
-    float dist = length(center) * 2.0;
-
-    // Core brightness with sharp center
-    float core = (1.0 - smoothstep(0.0, 0.2, dist)) * 0.8;
-    
-    // Soft glow around core
-    float glow = (1.0 - smoothstep(0.2, 0.5, dist)) * 0.1;
-
-    float brightness = core + glow;
-
-    // Interpolate between base color and target color
-    vec3 transitionColor = mix(uColor, targetColor, colorMix);
-    
-    // Mix white with interpolated color for realistic appearance
-    vec3 finalColor = mix(vec3(1.0), transitionColor * vColor, 0.8) * 0.6;
-
-    // Apply global opacity for fade in/out transitions
-    gl_FragColor = vec4(finalColor, brightness * opacity);
-  }
+const fragmentShader = /*glsl*/ `
+  varying vec3 vColor;
+  varying float vDepth;
+  
+  uniform float opacity;
+  uniform vec3 uColor;
+  uniform vec3 targetColor;
+  uniform float colorMix;
+
+  void main() {
+    // Calculate distance from center of point
+    vec2 center = gl_PointCoord - vec2(0.5);
+    float dist = length(center) * 2.0;
+
+    // Core brightness with sharp center
+    float core = (1.0 - smoothstep(0.0, 0.2, dist)) * 0.8;
+    
+    // Soft glow around core
+    float glow = (1.0 - smoothstep(0.2, 0.5, dist)) * 0.1;
+
+    float brightness = core + glow;
+
+    // Interpolate between base color and target color
+    vec3 transitionColor = mix(uColor, targetColor, colorMix);
+    
+    // Mix white with interpolated color for realistic appearance
+    vec3 finalColor = mix(vec3(1.0), transitionColor * vColor, 0.8) * 0.6;
+
+    // Apply global opacity for fade in/out transitions
+    gl_FragColor = vec4(finalColor, brightness * opacity);
+  }
 `;
 // Create the shader material with uniforms
 const StarsMaterial = shaderMaterial({
@@ -67,7 +68,8 @@ const StarsMaterial = shaderMaterial({
     opacity: 1.0,
     uColor: new THREE.Color(1.0, 1.0, 1.0),
     targetColor: new THREE.Color(1.0, 1.0, 1.0),
-    colorMix: 0.0
+    colorMix: 0.0,
+    sizeScale: 1.0
 }, vertexShader, fragmentShader);
 // Extend the material for use in React Three Fiber
 extend({ StarsMaterial });

package/dist/three/LetterV.d.ts

@@ -1,5 +1,10 @@
 import * as THREE from 'three';
-import type { TextConfig } from "../types/text";
+type TextConfig = {
+    text?: string;
+    font?: string;
+    renderMode?: 'text3d' | 'bitmap';
+    [k: string]: any;
+};
 export interface LetterVOptions {
     char: string;
     config: TextConfig;
@@ -21,4 +26,5 @@ export declare class LetterV {
     updateConfig(options: LetterVOptions): void;
     dispose(removeFromScene?: boolean): void;
 }
+export {};
 //# sourceMappingURL=LetterV.d.ts.map

package/dist/three/LetterV.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LetterV.d.ts","sourceRoot":"","sources":["../../src/three/LetterV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAGD,qBAAa,OAAO;IAChB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAoB;IACzC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAa;gBACzB,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc;IAS3D,OAAO,CAAC,KAAK;IA0Cb,OAAO,CAAC,UAAU;IAUlB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAK3C,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,IAAI;CAYjD"}
+{"version":3,"file":"LetterV.d.ts","sourceRoot":"","sources":["../../src/three/LetterV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,KAAK,UAAU,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC;AACvG,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAGD,qBAAa,OAAO;IAChB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAoB;IACzC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAa;gBACzB,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc;IAS3D,OAAO,CAAC,KAAK;IA0Cb,OAAO,CAAC,UAAU;IAUlB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAK3C,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,IAAI;CAYjD"}

package/dist/three/Text2DV.d.ts

@@ -1,5 +1,10 @@
 import * as THREE from 'three';
-import type { Text2DConfig } from "../types/text";
+type Text2DConfig = {
+    text?: string;
+    font?: string;
+    renderMode?: 'text3d' | 'bitmap';
+    [k: string]: any;
+};
 export interface Text2DVOptions {
     text: string;
     config?: Partial<Text2DConfig>;
@@ -22,4 +27,5 @@ export declare class Text2DV {
     updateConfig(options: Text2DVOptions): void;
     dispose(removeFromScene?: boolean): void;
 }
+export {};
 //# sourceMappingURL=Text2DV.d.ts.map

package/dist/three/Text2DV.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Text2DV.d.ts","sourceRoot":"","sources":["../../src/three/Text2DV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,qBAAa,OAAO;IAChB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAC;gBACJ,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc;IAW3D,OAAO,CAAC,KAAK;IA6Bb,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAC/C,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAK3C,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,IAAI;CAYjD"}
+{"version":3,"file":"Text2DV.d.ts","sourceRoot":"","sources":["../../src/three/Text2DV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,KAAK,YAAY,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC;AACzG,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,qBAAa,OAAO;IAChB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAC;gBACJ,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc;IAW3D,OAAO,CAAC,KAAK;IA6Bb,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAC/C,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAK3C,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,IAAI;CAYjD"}

package/dist/three/Text3DV.d.ts

@@ -1,5 +1,10 @@
 import * as THREE from 'three';
-import type { Text3DConfig } from "../types/text";
+type Text3DConfig = {
+    text?: string;
+    font?: string;
+    renderMode?: 'text3d' | 'bitmap';
+    [k: string]: any;
+};
 export interface Text3DVOptions {
     text: string;
     config: Text3DConfig;
@@ -19,4 +24,5 @@ export declare class Text3DV {
     updateConfig(options: Text3DVOptions): void;
     dispose(removeFromScene?: boolean): void;
 }
+export {};
 //# sourceMappingURL=Text3DV.d.ts.map

package/dist/three/Text3DV.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Text3DV.d.ts","sourceRoot":"","sources":["../../src/three/Text3DV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAGD,qBAAa,OAAO;IAChB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,OAAO,CAAC;gBACJ,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc;IAW3D,OAAO,CAAC,KAAK;IAWb,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAC/C,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAK3C,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,IAAI;CAOjD"}
+{"version":3,"file":"Text3DV.d.ts","sourceRoot":"","sources":["../../src/three/Text3DV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,KAAK,YAAY,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC;AACzG,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAGD,qBAAa,OAAO;IAChB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,KAAK,CAAC;IACd,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,OAAO,CAAC;gBACJ,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc;IAW3D,OAAO,CAAC,KAAK;IAWb,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAC/C,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAK3C,OAAO,CAAC,eAAe,GAAE,OAAc,GAAG,IAAI;CAOjD"}

package/dist/types/actions.d.ts

@@ -1,4 +1,4 @@
-import type { OperationEffect } from './objectSettings';
+import type { SceneCommand } from './commands';
 /**
  * Action Types
  * Defines the structure for UI actions that can trigger animations, toggle elements, or load projects
@@ -54,14 +54,14 @@ export interface ActionSequence {
      */
     key?: string;
     description?: string;
+    /** The changes (patches): what elements ARE while the action is applied. */
     targets: ActionTarget[];
     /**
-     * Operations run when the action is applied, undone when it is reverted
-     * (glow, fade, zoom to…). Patches change what elements ARE; effects are what
-     * HAPPENS to objects. Patches are applied first.
+     * What HAPPENS when it is applied, in order (triggers engine): effects, effect clips and
+     * other actions are switched on with it and off again on revert; animations run their
+     * command on apply and stop on revert. Patches are applied first.
      */
-    effects?: OperationEffect[];
-    assetId?: string | null;
+    commands: SceneCommand[];
     /** Runtime only */
     isDirty?: boolean;
 }