@iwsdk/core 0.1.0

package/dist/environment/environment-system.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+declare const EnvironmentSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
+    domeTextures: {
+        required: import("elics").Component<{}>[];
+    };
+    domeGradients: {
+        required: import("elics").Component<{}>[];
+    };
+    iblTextures: {
+        required: import("elics").Component<{}>[];
+    };
+    iblGradients: {
+        required: import("elics").Component<{}>[];
+    };
+}, import("../ecs/world.js").World, import("../ecs/system.js").System<import("elics").SystemSchema, {
+    domeTextures: {
+        required: import("elics").Component<{}>[];
+    };
+    domeGradients: {
+        required: import("elics").Component<{}>[];
+    };
+    iblTextures: {
+        required: import("elics").Component<{}>[];
+    };
+    iblGradients: {
+        required: import("elics").Component<{}>[];
+    };
+}>>;
+/**
+ * Unified background and image‑based lighting system.
+ *
+ * @remarks
+ * - Background is driven by {@link DomeTexture} (HDR/LDR equirect) or {@link DomeGradient} (procedural sphere) and writes to `scene.background`.
+ * - IBL is driven by {@link IBLTexture} ("room" or HDR/LDR equirect via PMREM) or {@link IBLGradient} (PMREM of a gradient scene) and writes to `scene.environment`.
+ * - Rotation and intensity hooks forward to `scene.backgroundRotation`, `scene.backgroundIntensity`, and `scene.environmentRotation`, `scene.environmentIntensity`.
+ * - In immersive AR, background visuals are hidden while environment lighting remains active.
+ * - PMREM targets are regenerated only when sources change; the dome mesh and geometry are reused.
+ *
+ * @category Environment & Lighting
+ * @example
+ * ```ts
+ * // Background: HDR skybox; IBL: Room environment
+ * const root = world.activeLevel!.value;
+ * root.addComponent(DomeTexture, { src: '/envs/sky.hdr', intensity: 0.9 });
+ * root.addComponent(IBLTexture, { src: 'room', intensity: 1.2 });
+ *
+ * // Rotate background 45° around Y; rotate IBL 90°
+ * root.setValue(DomeTexture, 'rotation', [0, Math.PI / 4, 0]);
+ * root.setValue(IBLTexture, 'rotation', [0, Math.PI / 2, 0]);
+ * root.setValue(DomeTexture, '_needsUpdate', true);
+ * root.setValue(IBLTexture, '_needsUpdate', true);
+ * ```
+ */
+export declare class EnvironmentSystem extends EnvironmentSystem_base {
+    private state;
+    private pmrem;
+    private gradientGeometry?;
+    private tmpColor;
+    init(): void;
+    update(): void;
+    private processBackground;
+    private hasDomeTextureBackgroundChanged;
+    private updateDomeTextureBackground;
+    private updateBackgroundProps;
+    private updateDomeGradient;
+    private processIBL;
+    private hasIBLTextureChanged;
+    private updateIBLTexture;
+    private updateIBLProps;
+    private updateIBLGradient;
+    private setEnvironment;
+    private updateBackgroundForXRMode;
+    private ensureGradientDome;
+    private clearGradientDome;
+}
+export {};
+//# sourceMappingURL=environment-system.d.ts.map

package/dist/environment/environment-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-system.d.ts","sourceRoot":"","sources":["../../src/environment/environment-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAkB,SAAQ,sBAKrC;IACA,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,gBAAgB,CAAC,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAsB;IAEtC,IAAI,IAAI,IAAI;IAiBZ,MAAM,IAAI,IAAI;YA4CA,iBAAiB;IAwB/B,OAAO,CAAC,+BAA+B;YASzB,2BAA2B;IAoBzC,OAAO,CAAC,qBAAqB;YAWf,kBAAkB;YA4BlB,UAAU;IAwBxB,OAAO,CAAC,oBAAoB;YASd,gBAAgB;IAwB9B,OAAO,CAAC,cAAc;YAaR,iBAAiB;IA+C/B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,yBAAyB;IAoCjC,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/environment/environment-system.js

@@ -0,0 +1,389 @@
+import { RoomEnvironment } from 'three/examples/jsm/environments/RoomEnvironment.js';
+import { AssetManager } from '../asset/asset-manager.js';
+import { CacheManager } from '../asset/cache-manager.js';
+import { createSystem } from '../ecs/system.js';
+import '../ecs/world.js';
+import 'elics';
+import '../ecs/component-registry.js';
+import '../level/level-system.js';
+import '../level/level-tag.js';
+import '@iwsdk/glxf';
+import '@pmndrs/uikit';
+import '@preact/signals-core';
+import { Color, PMREMGenerator, EquirectangularReflectionMapping, Mesh, SphereGeometry, BackSide } from 'three';
+import '../ui/ui.js';
+import '../ui/follow.js';
+import '../ui/screenspace.js';
+import { LevelRoot } from '../level/level-root.js';
+import '../runtime/three.js';
+import { DomeGradient } from './dome-gradient.js';
+import { DomeTexture } from './dome-texture.js';
+import { GradientEnvironment, createGradientMaterial } from './gradient-environment.js';
+import { IBLGradient } from './ibl-gradient.js';
+import { IBLTexture } from './ibl-texture.js';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Unified background and image‑based lighting system.
+ *
+ * @remarks
+ * - Background is driven by {@link DomeTexture} (HDR/LDR equirect) or {@link DomeGradient} (procedural sphere) and writes to `scene.background`.
+ * - IBL is driven by {@link IBLTexture} ("room" or HDR/LDR equirect via PMREM) or {@link IBLGradient} (PMREM of a gradient scene) and writes to `scene.environment`.
+ * - Rotation and intensity hooks forward to `scene.backgroundRotation`, `scene.backgroundIntensity`, and `scene.environmentRotation`, `scene.environmentIntensity`.
+ * - In immersive AR, background visuals are hidden while environment lighting remains active.
+ * - PMREM targets are regenerated only when sources change; the dome mesh and geometry are reused.
+ *
+ * @category Environment & Lighting
+ * @example
+ * ```ts
+ * // Background: HDR skybox; IBL: Room environment
+ * const root = world.activeLevel!.value;
+ * root.addComponent(DomeTexture, { src: '/envs/sky.hdr', intensity: 0.9 });
+ * root.addComponent(IBLTexture, { src: 'room', intensity: 1.2 });
+ *
+ * // Rotate background 45° around Y; rotate IBL 90°
+ * root.setValue(DomeTexture, 'rotation', [0, Math.PI / 4, 0]);
+ * root.setValue(IBLTexture, 'rotation', [0, Math.PI / 2, 0]);
+ * root.setValue(DomeTexture, '_needsUpdate', true);
+ * root.setValue(IBLTexture, '_needsUpdate', true);
+ * ```
+ */
+class EnvironmentSystem extends createSystem({
+    domeTextures: { required: [DomeTexture, LevelRoot] },
+    domeGradients: { required: [DomeGradient, LevelRoot] },
+    iblTextures: { required: [IBLTexture, LevelRoot] },
+    iblGradients: { required: [IBLGradient, LevelRoot] },
+}) {
+    constructor() {
+        super(...arguments);
+        this.state = {};
+        this.tmpColor = new Color();
+    }
+    init() {
+        this.pmrem = new PMREMGenerator(this.renderer);
+        this.cleanupFuncs.push(() => {
+            var _a, _b;
+            this.pmrem.dispose();
+            (_a = this.state.environmentTarget) === null || _a === void 0 ? void 0 : _a.dispose();
+            this.state.environmentTarget = undefined;
+            this.clearGradientDome();
+            (_b = this.gradientGeometry) === null || _b === void 0 ? void 0 : _b.dispose();
+            this.gradientGeometry = undefined;
+        });
+        // XR background toggle
+        this.cleanupFuncs.push(this.visibilityState.subscribe(() => this.updateBackgroundForXRMode()));
+    }
+    update() {
+        var _a;
+        // Choose background source: DomeTexture > DomeGradient
+        let backgroundEntity;
+        for (const e of this.queries.domeTextures.entities) {
+            backgroundEntity = e;
+            break;
+        }
+        if (!backgroundEntity) {
+            for (const e of this.queries.domeGradients.entities) {
+                backgroundEntity = e;
+                break;
+            }
+        }
+        if (backgroundEntity) {
+            this.processBackground(backgroundEntity);
+        }
+        // Choose IBL source: IBLTexture > IBLGradient
+        let iblEntity;
+        for (const e of this.queries.iblTextures.entities) {
+            iblEntity = e;
+            break;
+        }
+        if (!iblEntity) {
+            for (const e of this.queries.iblGradients.entities) {
+                iblEntity = e;
+                break;
+            }
+        }
+        if (iblEntity) {
+            this.processIBL(iblEntity);
+        }
+        // Keep gradient dome centered and sized
+        if (this.state.gradientDome) {
+            this.state.gradientDome.position.copy(this.camera.position);
+            const r = Math.max(1e-3, (((_a = this.camera) === null || _a === void 0 ? void 0 : _a.far) || 1000) * 0.95);
+            this.state.gradientDome.scale.setScalar(r);
+        }
+    }
+    // Background handling
+    async processBackground(entity) {
+        try {
+            if (entity.hasComponent(DomeTexture)) {
+                const needs = entity.getValue(DomeTexture, '_needsUpdate');
+                if (needs) {
+                    const changed = this.hasDomeTextureBackgroundChanged(entity);
+                    if (changed) {
+                        await this.updateDomeTextureBackground(entity);
+                    }
+                    this.updateBackgroundProps(entity);
+                    entity.setValue(DomeTexture, '_needsUpdate', false);
+                }
+            }
+            else if (entity.hasComponent(DomeGradient)) {
+                const needs = entity.getValue(DomeGradient, '_needsUpdate');
+                if (needs) {
+                    await this.updateDomeGradient(entity, /*forIBL*/ false);
+                    entity.setValue(DomeGradient, '_needsUpdate', false);
+                }
+            }
+        }
+        catch (e) {
+            console.error('[EnvironmentSystem] Failed background update:', e);
+        }
+    }
+    hasDomeTextureBackgroundChanged(entity) {
+        const src = entity.getValue(DomeTexture, 'src') || '';
+        const changed = src !== this.state.backgroundSource;
+        if (changed) {
+            this.state.backgroundSource = src;
+        }
+        return changed;
+    }
+    async updateDomeTextureBackground(entity) {
+        const src = entity.getValue(DomeTexture, 'src') || '';
+        if (!src) {
+            this.scene.background = null;
+            return;
+        }
+        const lower = src.toLowerCase();
+        const isHDR = lower.endsWith('.hdr') || lower.endsWith('.exr');
+        const url = CacheManager.resolveUrl(src);
+        const texture = isHDR
+            ? await AssetManager.loadHDRTexture(url)
+            : await AssetManager.loadTexture(url);
+        this.state.backgroundTexture = texture;
+        // For LDR equirect backgrounds, ensure world-locked mapping; HDR/EXR already mapped by loader
+        if (!isHDR) {
+            texture.mapping = EquirectangularReflectionMapping;
+        }
+        this.scene.background = texture;
+    }
+    updateBackgroundProps(entity) {
+        var _a, _b, _c;
+        const blurriness = (_a = entity.getValue(DomeTexture, 'blurriness')) !== null && _a !== void 0 ? _a : 0;
+        const intensity = (_b = entity.getValue(DomeTexture, 'intensity')) !== null && _b !== void 0 ? _b : 1;
+        const rot = entity.getVectorView(DomeTexture, 'rotation');
+        this.scene.backgroundBlurriness = blurriness;
+        this.scene.backgroundIntensity = intensity;
+        if (rot) {
+            (_c = this.scene.backgroundRotation) === null || _c === void 0 ? void 0 : _c.set(rot[0] || 0, rot[1] || 0, rot[2] || 0);
+        }
+    }
+    async updateDomeGradient(entity, forIBL) {
+        const skyV = entity.getVectorView(DomeGradient, 'sky');
+        const equatorV = entity.getVectorView(DomeGradient, 'equator');
+        const groundV = entity.getVectorView(DomeGradient, 'ground');
+        const intensity = entity.getValue(DomeGradient, 'intensity') || 1.0;
+        const skyHex = this.tmpColor.setRGB(skyV[0], skyV[1], skyV[2]).getHex();
+        const equatorHex = this.tmpColor
+            .setRGB(equatorV[0], equatorV[1], equatorV[2])
+            .getHex();
+        const groundHex = this.tmpColor
+            .setRGB(groundV[0], groundV[1], groundV[2])
+            .getHex();
+        if (!forIBL) {
+            // Background gradient dome mesh
+            this.ensureGradientDome(skyHex, equatorHex, groundHex, intensity);
+            // Ensure correct visibility for AR sessions (hide in AR)
+            if (this.state.gradientDome) {
+                this.state.gradientDome.visible = !this.state.isAR;
+            }
+        }
+    }
+    // IBL handling
+    async processIBL(entity) {
+        try {
+            if (entity.hasComponent(IBLTexture)) {
+                const needs = entity.getValue(IBLTexture, '_needsUpdate');
+                if (needs) {
+                    const changed = this.hasIBLTextureChanged(entity);
+                    if (changed) {
+                        await this.updateIBLTexture(entity);
+                    }
+                    this.updateIBLProps(entity);
+                    entity.setValue(IBLTexture, '_needsUpdate', false);
+                }
+            }
+            else if (entity.hasComponent(IBLGradient)) {
+                const needs = entity.getValue(IBLGradient, '_needsUpdate');
+                if (needs) {
+                    await this.updateIBLGradient(entity);
+                    entity.setValue(IBLGradient, '_needsUpdate', false);
+                }
+            }
+        }
+        catch (e) {
+            console.error('[EnvironmentSystem] Failed IBL update:', e);
+        }
+    }
+    hasIBLTextureChanged(entity) {
+        const src = entity.getValue(IBLTexture, 'src') || '';
+        const changed = src !== this.state.environmentSource;
+        if (changed) {
+            this.state.environmentSource = src;
+        }
+        return changed;
+    }
+    async updateIBLTexture(entity) {
+        var _a;
+        const src = (entity.getValue(IBLTexture, 'src') || '').trim();
+        if (!src) {
+            this.setEnvironment(null);
+            return;
+        }
+        if (src === 'room') {
+            // Build RoomEnvironment scene and PMREM it
+            const room = new RoomEnvironment();
+            const target = this.pmrem.fromScene(room);
+            (_a = room.dispose) === null || _a === void 0 ? void 0 : _a.call(room);
+            this.setEnvironment(target);
+            return;
+        }
+        const lower2 = src.toLowerCase();
+        const isHDR = lower2.endsWith('.hdr') || lower2.endsWith('.exr');
+        const url = CacheManager.resolveUrl(src);
+        const tex = isHDR
+            ? await AssetManager.loadHDRTexture(url)
+            : await AssetManager.loadTexture(url);
+        const target = this.pmrem.fromEquirectangular(tex);
+        this.setEnvironment(target);
+    }
+    updateIBLProps(entity) {
+        var _a, _b;
+        const intensity = (_a = entity.getValue(IBLTexture, 'intensity')) !== null && _a !== void 0 ? _a : 1;
+        const rot = entity.getVectorView(IBLTexture, 'rotation');
+        this.scene.environmentIntensity = intensity;
+        if (rot) {
+            (_b = this.scene.environmentRotation) === null || _b === void 0 ? void 0 : _b.set(rot[0] || 0, rot[1] || 0, rot[2] || 0);
+        }
+    }
+    async updateIBLGradient(entity) {
+        var _a;
+        const skyV = entity.getVectorView(IBLGradient, 'sky');
+        const equatorV = entity.getVectorView(IBLGradient, 'equator');
+        const groundV = entity.getVectorView(IBLGradient, 'ground');
+        const intensity = entity.getValue(IBLGradient, 'intensity') || 1.0;
+        const skyHex = new Color().setRGB(skyV[0], skyV[1], skyV[2]).getHex();
+        const equatorHex = new Color(equatorV[0], equatorV[1], equatorV[2]).getHex();
+        const groundHex = new Color(groundV[0], groundV[1], groundV[2]).getHex();
+        let gradientScene = this.state.gradientEnvironmentScene;
+        if (!gradientScene) {
+            gradientScene = new GradientEnvironment(skyHex, equatorHex, groundHex, intensity);
+            this.state.gradientEnvironmentScene = gradientScene;
+            // Cache mesh for uniform updates
+            this.state.gradientEnvironmentMesh = gradientScene.children.find((o) => o instanceof Mesh);
+        }
+        else {
+            const mat = (_a = this.state.gradientEnvironmentMesh) === null || _a === void 0 ? void 0 : _a.material;
+            if (mat) {
+                mat.uniforms.skyColor.value.setHex(skyHex).multiplyScalar(intensity);
+                mat.uniforms.equatorColor.value
+                    .setHex(equatorHex)
+                    .multiplyScalar(intensity);
+                mat.uniforms.groundColor.value
+                    .setHex(groundHex)
+                    .multiplyScalar(intensity);
+            }
+        }
+        const target = this.pmrem.fromScene(gradientScene);
+        this.setEnvironment(target);
+        // Apply IBL intensity for gradient as well
+        this.scene.environmentIntensity = intensity;
+    }
+    setEnvironment(target) {
+        var _a;
+        (_a = this.state.environmentTarget) === null || _a === void 0 ? void 0 : _a.dispose();
+        this.state.environmentTarget = undefined;
+        if (target) {
+            this.state.environmentTarget = target;
+            this.scene.environment = target.texture;
+        }
+        else {
+            this.scene.environment = null;
+        }
+    }
+    // XR background handling
+    updateBackgroundForXRMode() {
+        var _a, _b, _c;
+        const session = (_c = (_b = (_a = this.xrManager).getSession) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : this.world.session;
+        const blend = session === null || session === void 0 ? void 0 : session.environmentBlendMode;
+        const isAR = blend === 'alpha-blend' ||
+            blend === 'additive' ||
+            blend === 'subtractive';
+        if (isAR === this.state.isAR) {
+            return;
+        }
+        this.state.isAR = isAR;
+        if (isAR) {
+            if (this.scene.background !== null &&
+                this.state.savedBackground === undefined) {
+                this.state.savedBackground = this.scene.background;
+                this.scene.background = null;
+            }
+            // Hide procedural gradient dome in AR as well
+            if (this.state.gradientDome) {
+                this.state.gradientDome.visible = false;
+            }
+        }
+        else if (this.state.savedBackground !== undefined) {
+            this.scene.background = this.state.savedBackground;
+            this.state.savedBackground = undefined;
+            // Restore gradient dome visibility when exiting AR
+            if (this.state.gradientDome) {
+                this.state.gradientDome.visible = true;
+            }
+        }
+    }
+    // Gradient dome mesh utilities (background)
+    ensureGradientDome(skyHex, equatorHex, groundHex, intensity) {
+        var _a;
+        if (!this.gradientGeometry) {
+            this.gradientGeometry = new SphereGeometry(1, 32, 15);
+        }
+        if (!this.state.gradientDome) {
+            const material = createGradientMaterial(skyHex, equatorHex, groundHex, intensity, BackSide);
+            const dome = new Mesh(this.gradientGeometry, material);
+            dome.scale.setScalar(Math.max(1e-3, (((_a = this.camera) === null || _a === void 0 ? void 0 : _a.far) || 1000) * 0.95));
+            dome.renderOrder = -1e9;
+            dome.frustumCulled = false;
+            this.scene.add(dome);
+            this.state.gradientDome = dome;
+        }
+        else {
+            const mat = this.state.gradientDome.material;
+            mat.uniforms.skyColor.value.setHex(skyHex).multiplyScalar(intensity);
+            mat.uniforms.equatorColor.value
+                .setHex(equatorHex)
+                .multiplyScalar(intensity);
+            mat.uniforms.groundColor.value
+                .setHex(groundHex)
+                .multiplyScalar(intensity);
+        }
+    }
+    clearGradientDome() {
+        if (this.state.gradientDome) {
+            this.state.gradientDome.removeFromParent();
+            this.state.gradientDome.material.dispose();
+            this.state.gradientDome = undefined;
+        }
+        if (this.state.gradientEnvironmentScene) {
+            this.state.gradientEnvironmentScene.dispose();
+            this.state.gradientEnvironmentScene = undefined;
+        }
+    }
+}
+
+export { EnvironmentSystem };
+//# sourceMappingURL=environment-system.js.map

package/dist/environment/environment-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-system.js","sources":["../../src/environment/environment-system.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAKG;AAuCH;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;AACG,MAAO,iBAAkB,SAAQ,YAAY,CAAC;IAClD,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE;IACpD,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE;IACtD,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE;IAClD,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE;CACrD,CAAC,CAAA;AALF,IAAA,WAAA,GAAA;;QAMU,IAAA,CAAA,KAAK,GAAa,EAAE;AAGpB,QAAA,IAAA,CAAA,QAAQ,GAAU,IAAI,KAAK,EAAE;IA8WvC;IA5WE,IAAI,GAAA;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC9C,QAAA,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAK;;AAC1B,YAAA,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;YACpB,CAAA,EAAA,GAAA,IAAI,CAAC,KAAK,CAAC,iBAAiB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,OAAO,EAAE;AACvC,YAAA,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,SAAS;YACxC,IAAI,CAAC,iBAAiB,EAAE;AACxB,YAAA,CAAA,EAAA,GAAA,IAAI,CAAC,gBAAgB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,OAAO,EAAE;AAChC,YAAA,IAAI,CAAC,gBAAgB,GAAG,SAAS;AACnC,QAAA,CAAC,CAAC;;QAGF,IAAI,CAAC,YAAY,CAAC,IAAI,CACpB,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,yBAAyB,EAAE,CAAC,CACvE;IACH;IAEA,MAAM,GAAA;;;AAEJ,QAAA,IAAI,gBAAoC;QACxC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE;YAClD,gBAAgB,GAAG,CAAC;YACpB;QACF;QACA,IAAI,CAAC,gBAAgB,EAAE;YACrB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE;gBACnD,gBAAgB,GAAG,CAAC;gBACpB;YACF;QACF;QAEA,IAAI,gBAAgB,EAAE;AACpB,YAAA,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC;QAC1C;;AAGA,QAAA,IAAI,SAA6B;QACjC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE;YACjD,SAAS,GAAG,CAAC;YACb;QACF;QACA,IAAI,CAAC,SAAS,EAAE;YACd,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE;gBAClD,SAAS,GAAG,CAAC;gBACb;YACF;QACF;QAEA,IAAI,SAAS,EAAE;AACb,YAAA,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAC5B;;AAGA,QAAA,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;AAC3B,YAAA,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC3D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA,CAAA,EAAA,GAAA,IAAI,CAAC,MAAM,0CAAE,GAAG,KAAI,IAAI,IAAI,IAAI,CAAC;YAC3D,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5C;IACF;;IAGQ,MAAM,iBAAiB,CAAC,MAAc,EAAA;AAC5C,QAAA,IAAI;AACF,YAAA,IAAI,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE;gBACpC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;gBAC1D,IAAI,KAAK,EAAE;oBACT,MAAM,OAAO,GAAG,IAAI,CAAC,+BAA+B,CAAC,MAAM,CAAC;oBAC5D,IAAI,OAAO,EAAE;AACX,wBAAA,MAAM,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC;oBAChD;AACA,oBAAA,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC;oBAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,CAAC;gBACrD;YACF;AAAO,iBAAA,IAAI,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE;gBAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;gBAC3D,IAAI,KAAK,EAAE;oBACT,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,aAAa,KAAK,CAAC;oBACvD,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,CAAC;gBACtD;YACF;QACF;QAAE,OAAO,CAAC,EAAE;AACV,YAAA,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,CAAC,CAAC;QACnE;IACF;AAEQ,IAAA,+BAA+B,CAAC,MAAc,EAAA;AACpD,QAAA,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE;QACrD,MAAM,OAAO,GAAG,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,gBAAgB;QACnD,IAAI,OAAO,EAAE;AACX,YAAA,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,GAAG;QACnC;AACA,QAAA,OAAO,OAAO;IAChB;IAEQ,MAAM,2BAA2B,CAAC,MAAc,EAAA;AACtD,QAAA,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE;QACrD,IAAI,CAAC,GAAG,EAAE;AACR,YAAA,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI;YAC5B;QACF;AACA,QAAA,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE;AAC/B,QAAA,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC9D,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;QACxC,MAAM,OAAO,GAAG;AACd,cAAE,MAAM,YAAY,CAAC,cAAc,CAAC,GAAG;cACrC,MAAM,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC;AACvC,QAAA,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,OAAO;;QAEtC,IAAI,CAAC,KAAK,EAAE;AACV,YAAA,OAAO,CAAC,OAAO,GAAG,gCAAgC;QACpD;AACA,QAAA,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO;IACjC;AAEQ,IAAA,qBAAqB,CAAC,MAAc,EAAA;;AAC1C,QAAA,MAAM,UAAU,GAAG,CAAA,EAAA,GAAA,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,CAAC;AAClE,QAAA,MAAM,SAAS,GAAG,CAAA,EAAA,GAAA,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,UAAU,CAAC;AACzD,QAAA,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,UAAU;AAC5C,QAAA,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,SAAS;QAC1C,IAAI,GAAG,EAAE;AACP,YAAA,CAAA,EAAA,GAAA,IAAI,CAAC,KAAK,CAAC,kBAAkB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3E;IACF;AAEQ,IAAA,MAAM,kBAAkB,CAC9B,MAAc,EACd,MAAe,EAAA;QAEf,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,SAAS,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC;AAC5D,QAAA,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,GAAG;QAEnE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;AACvE,QAAA,MAAM,UAAU,GAAG,IAAI,CAAC;AACrB,aAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC5C,aAAA,MAAM,EAAE;AACX,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC;AACpB,aAAA,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACzC,aAAA,MAAM,EAAE;QAEX,IAAI,CAAC,MAAM,EAAE;;YAEX,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC;;AAEjE,YAAA,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;AAC3B,gBAAA,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI;YACpD;QACF;IACF;;IAGQ,MAAM,UAAU,CAAC,MAAc,EAAA;AACrC,QAAA,IAAI;AACF,YAAA,IAAI,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE;gBACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;gBACzD,IAAI,KAAK,EAAE;oBACT,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC;oBACjD,IAAI,OAAO,EAAE;AACX,wBAAA,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;oBACrC;AACA,oBAAA,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;oBAC3B,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,CAAC;gBACpD;YACF;AAAO,iBAAA,IAAI,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE;gBAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;gBAC1D,IAAI,KAAK,EAAE;AACT,oBAAA,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;oBACpC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,CAAC;gBACrD;YACF;QACF;QAAE,OAAO,CAAC,EAAE;AACV,YAAA,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,CAAC,CAAC;QAC5D;IACF;AAEQ,IAAA,oBAAoB,CAAC,MAAc,EAAA;AACzC,QAAA,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE;QACpD,MAAM,OAAO,GAAG,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,iBAAiB;QACpD,IAAI,OAAO,EAAE;AACX,YAAA,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,GAAG;QACpC;AACA,QAAA,OAAO,OAAO;IAChB;IAEQ,MAAM,gBAAgB,CAAC,MAAc,EAAA;;AAC3C,QAAA,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE;QAC7D,IAAI,CAAC,GAAG,EAAE;AACR,YAAA,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;YACzB;QACF;AACA,QAAA,IAAI,GAAG,KAAK,MAAM,EAAE;;AAElB,YAAA,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;AACzC,YAAA,CAAA,EAAA,GAAA,IAAI,CAAC,OAAO,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAA,IAAA,CAAI;AAChB,YAAA,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YAC3B;QACF;AACA,QAAA,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE;AAChC,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChE,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;QACxC,MAAM,GAAG,GAAG;AACV,cAAE,MAAM,YAAY,CAAC,cAAc,CAAC,GAAG;cACrC,MAAM,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC;AAClD,QAAA,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;IAC7B;AAEQ,IAAA,cAAc,CAAC,MAAc,EAAA;;AACnC,QAAA,MAAM,SAAS,GAAG,CAAA,EAAA,GAAA,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,CAAC;QAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC;AACxD,QAAA,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,SAAS;QAC3C,IAAI,GAAG,EAAE;AACP,YAAA,CAAA,EAAA,GAAA,IAAI,CAAC,KAAK,CAAC,mBAAmB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,GAAG,CACjC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EACX,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EACX,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CACZ;QACH;IACF;IAEQ,MAAM,iBAAiB,CAAC,MAAc,EAAA;;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC;QACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC;AAC3D,QAAA,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,GAAG;QAClE,MAAM,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;QACrE,MAAM,UAAU,GAAG,IAAI,KAAK,CAC1B,QAAQ,CAAC,CAAC,CAAC,EACX,QAAQ,CAAC,CAAC,CAAC,EACX,QAAQ,CAAC,CAAC,CAAC,CACZ,CAAC,MAAM,EAAE;QACV,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;AAExE,QAAA,IAAI,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB;QACvD,IAAI,CAAC,aAAa,EAAE;AAClB,YAAA,aAAa,GAAG,IAAI,mBAAmB,CACrC,MAAM,EACN,UAAU,EACV,SAAS,EACT,SAAS,CACV;AACD,YAAA,IAAI,CAAC,KAAK,CAAC,wBAAwB,GAAG,aAAa;;YAEnD,IAAI,CAAC,KAAK,CAAC,uBAAuB,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAC9D,CAAC,CAAC,KAAgB,CAAC,YAAY,IAAI,CACpC;QACH;aAAO;YACL,MAAM,GAAG,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,KAAK,CAAC,uBAAuB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,QAEnC;YACb,IAAI,GAAG,EAAE;AACP,gBAAA,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC;AACpE,gBAAA,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;qBACvB,MAAM,CAAC,UAAU;qBACjB,cAAc,CAAC,SAAS,CAAC;AAC5B,gBAAA,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;qBACtB,MAAM,CAAC,SAAS;qBAChB,cAAc,CAAC,SAAS,CAAC;YAC9B;QACF;QAEA,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC;AAClD,QAAA,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;;AAE3B,QAAA,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,SAAS;IAC7C;AAEQ,IAAA,cAAc,CAAC,MAAgC,EAAA;;QACrD,CAAA,EAAA,GAAA,IAAI,CAAC,KAAK,CAAC,iBAAiB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,OAAO,EAAE;AACvC,QAAA,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,SAAS;QACxC,IAAI,MAAM,EAAE;AACV,YAAA,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,MAAM;YACrC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,OAAO;QACzC;aAAO;AACL,YAAA,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI;QAC/B;IACF;;IAGQ,yBAAyB,GAAA;;AAC/B,QAAA,MAAM,OAAO,GAAG,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAAI,CAAC,SAAS,EAAC,UAAU,kDAAI,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI,CAAC,KAAK,CAAC,OAAO;QACnE,MAAM,KAAK,GAAuB,OAAO,KAAA,IAAA,IAAP,OAAO,KAAA,MAAA,GAAA,MAAA,GAAP,OAAO,CAAE,oBAAoB;AAC/D,QAAA,MAAM,IAAI,GACR,KAAK,KAAK,aAAa;AACvB,YAAA,KAAK,KAAK,UAAU;YACpB,KAAK,KAAK,aAAa;QAEzB,IAAI,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAC5B;QACF;AACA,QAAA,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI;QAEtB,IAAI,IAAI,EAAE;AACR,YAAA,IACE,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI;AAC9B,gBAAA,IAAI,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,EACxC;gBACA,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU;AAClD,gBAAA,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI;YAC9B;;AAEA,YAAA,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;gBAC3B,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,GAAG,KAAK;YACzC;QACF;aAAO,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE;YACnD,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe;AAClD,YAAA,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,SAAS;;AAEtC,YAAA,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;gBAC3B,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,GAAG,IAAI;YACxC;QACF;IACF;;AAGQ,IAAA,kBAAkB,CACxB,MAAc,EACd,UAAkB,EAClB,SAAiB,EACjB,SAAiB,EAAA;;AAEjB,QAAA,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;AAC1B,YAAA,IAAI,CAAC,gBAAgB,GAAG,IAAI,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;QACvD;AACA,QAAA,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;AAC5B,YAAA,MAAM,QAAQ,GAAG,sBAAsB,CACrC,MAAM,EACN,UAAU,EACV,SAAS,EACT,SAAS,EACT,QAAQ,CACT;YACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC;YACtD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA,MAAA,IAAI,CAAC,MAAM,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,GAAG,KAAI,IAAI,IAAI,IAAI,CAAC,CAAC;AACvE,YAAA,IAAI,CAAC,WAAW,GAAG,IAAI;AACvB,YAAA,IAAI,CAAC,aAAa,GAAG,KAAK;AAC1B,YAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AACpB,YAAA,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI;QAChC;aAAO;YACL,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAA0B;AAC9D,YAAA,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC;AACpE,YAAA,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;iBACvB,MAAM,CAAC,UAAU;iBACjB,cAAc,CAAC,SAAS,CAAC;AAC5B,YAAA,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;iBACtB,MAAM,CAAC,SAAS;iBAChB,cAAc,CAAC,SAAS,CAAC;QAC9B;IACF;IAEQ,iBAAiB,GAAA;AACvB,QAAA,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;AAC3B,YAAA,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE;YACzC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAA2B,CAAC,OAAO,EAAE;AAC9D,YAAA,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,SAAS;QACrC;AACA,QAAA,IAAI,IAAI,CAAC,KAAK,CAAC,wBAAwB,EAAE;AACvC,YAAA,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,EAAE;AAC7C,YAAA,IAAI,CAAC,KAAK,CAAC,wBAAwB,GAAG,SAAS;QACjD;IACF;AACD;;;;"}

package/dist/environment/gradient-environment.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { BackSide, FrontSide, Scene, ShaderMaterial } from '../runtime/index.js';
+/**
+ * Gradient shader uniforms and code used for background domes and environments.
+ * @category Environment & Lighting
+ */
+export declare const GRADIENT_SHADER: {
+    vertexShader: string;
+    fragmentShader: string;
+};
+/**
+ * Create a gradient material with Unity‑style sky/equator/ground colors.
+ * @param skyHex Sky color as hex.
+ * @param equatorHex Equator color as hex.
+ * @param groundHex Ground color as hex.
+ * @param intensity Intensity multiplier applied to all colors.
+ * @param side Material side (BackSide for background dome; FrontSide for env scene).
+ * @category Environment & Lighting
+ */
+export declare function createGradientMaterial(skyHex: number, equatorHex: number, groundHex: number, intensity: number, side?: typeof BackSide | typeof FrontSide): ShaderMaterial;
+/**
+ * A Scene containing a gradient sphere for PMREM processing.
+ *
+ * @remarks
+ * Uses the same shader as the background dome to ensure coherent lighting.
+ * @category Environment & Lighting
+ */
+export declare class GradientEnvironment extends Scene {
+    constructor(skyHex?: number, equatorHex?: number, groundHex?: number, intensity?: number);
+    dispose(): void;
+}
+//# sourceMappingURL=gradient-environment.d.ts.map

package/dist/environment/gradient-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient-environment.d.ts","sourceRoot":"","sources":["../../src/environment/gradient-environment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EAER,SAAS,EAET,KAAK,EACL,cAAc,EAEf,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,eAAe;;;CA8B3B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,OAAO,QAAQ,GAAG,OAAO,SAAqB,GACnD,cAAc,CAahB;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAE1C,MAAM,GAAE,MAAiB,EACzB,UAAU,GAAE,MAAiB,EAC7B,SAAS,GAAE,MAAiB,EAC5B,SAAS,GAAE,MAAY;IAkBzB,OAAO,IAAI,IAAI;CAchB"}

package/dist/environment/gradient-environment.js

@@ -0,0 +1,99 @@
+import '../runtime/three.js';
+import { FrontSide, Scene, SphereGeometry, Mesh, ShaderMaterial, Color, BackSide } from 'three';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Gradient shader uniforms and code used for background domes and environments.
+ * @category Environment & Lighting
+ */
+const GRADIENT_SHADER = {
+    vertexShader: /* glsl */ `
+    varying vec3 vWorldPosition;
+    void main() {
+      vec4 worldPosition = modelMatrix * vec4(position, 1.0);
+      vWorldPosition = worldPosition.xyz;
+      gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+    }
+  `,
+    fragmentShader: /* glsl */ `
+    uniform vec3 skyColor;
+    uniform vec3 equatorColor;
+    uniform vec3 groundColor;
+    varying vec3 vWorldPosition;
+    
+    void main() {
+      float h = normalize(vWorldPosition).y;
+      vec3 color;
+      
+      if (h > 0.0) {
+        // Sky to equator interpolation
+        color = mix(equatorColor, skyColor, h);
+      } else {
+        // Equator to ground interpolation
+        color = mix(equatorColor, groundColor, -h);
+      }
+      
+      gl_FragColor = vec4(color, 1.0);
+    }
+  `,
+};
+/**
+ * Create a gradient material with Unity‑style sky/equator/ground colors.
+ * @param skyHex Sky color as hex.
+ * @param equatorHex Equator color as hex.
+ * @param groundHex Ground color as hex.
+ * @param intensity Intensity multiplier applied to all colors.
+ * @param side Material side (BackSide for background dome; FrontSide for env scene).
+ * @category Environment & Lighting
+ */
+function createGradientMaterial(skyHex, equatorHex, groundHex, intensity, side = FrontSide) {
+    return new ShaderMaterial({
+        uniforms: {
+            skyColor: { value: new Color(skyHex).multiplyScalar(intensity) },
+            equatorColor: { value: new Color(equatorHex).multiplyScalar(intensity) },
+            groundColor: { value: new Color(groundHex).multiplyScalar(intensity) },
+        },
+        vertexShader: GRADIENT_SHADER.vertexShader,
+        fragmentShader: GRADIENT_SHADER.fragmentShader,
+        side,
+        depthWrite: side === BackSide ? false : true,
+        depthTest: side === BackSide ? false : true,
+    });
+}
+/**
+ * A Scene containing a gradient sphere for PMREM processing.
+ *
+ * @remarks
+ * Uses the same shader as the background dome to ensure coherent lighting.
+ * @category Environment & Lighting
+ */
+class GradientEnvironment extends Scene {
+    constructor(skyHex = 0x87ceeb, equatorHex = 0xffa500, groundHex = 0x228b22, intensity = 1.0) {
+        super();
+        // Create gradient sphere using shared gradient material
+        const geometry = new SphereGeometry(100, 32, 15);
+        const material = createGradientMaterial(skyHex, equatorHex, groundHex, intensity, BackSide);
+        const gradientSphere = new Mesh(geometry, material);
+        this.add(gradientSphere);
+    }
+    dispose() {
+        const resources = new Set();
+        this.traverse((object) => {
+            if (object.isMesh) {
+                resources.add(object.geometry);
+                resources.add(object.material);
+            }
+        });
+        for (const resource of resources) {
+            resource.dispose();
+        }
+    }
+}
+
+export { GRADIENT_SHADER, GradientEnvironment, createGradientMaterial };
+//# sourceMappingURL=gradient-environment.js.map

package/dist/environment/gradient-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient-environment.js","sources":["../../src/environment/gradient-environment.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;AAKG;AAYH;;;AAGG;AACI,MAAM,eAAe,GAAG;IAC7B,YAAY,aAAa;;;;;;;AAOxB,EAAA,CAAA;IACD,cAAc,aAAa;;;;;;;;;;;;;;;;;;;;AAoB1B,EAAA,CAAA;;AAGH;;;;;;;;AAQG;AACG,SAAU,sBAAsB,CACpC,MAAc,EACd,UAAkB,EAClB,SAAiB,EACjB,SAAiB,EACjB,IAAA,GAA2C,SAAS,EAAA;IAEpD,OAAO,IAAI,cAAc,CAAC;AACxB,QAAA,QAAQ,EAAE;AACR,YAAA,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE;AAChE,YAAA,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE;AACxE,YAAA,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE;AACvE,SAAA;QACD,YAAY,EAAE,eAAe,CAAC,YAAY;QAC1C,cAAc,EAAE,eAAe,CAAC,cAAc;QAC9C,IAAI;QACJ,UAAU,EAAE,IAAI,KAAK,QAAQ,GAAG,KAAK,GAAG,IAAI;QAC5C,SAAS,EAAE,IAAI,KAAK,QAAQ,GAAG,KAAK,GAAG,IAAI;AAC5C,KAAA,CAAC;AACJ;AAEA;;;;;;AAMG;AACG,MAAO,mBAAoB,SAAQ,KAAK,CAAA;IAC5C,WAAA,CACE,MAAA,GAAiB,QAAQ,EACzB,UAAA,GAAqB,QAAQ,EAC7B,SAAA,GAAoB,QAAQ,EAC5B,SAAA,GAAoB,GAAG,EAAA;AAEvB,QAAA,KAAK,EAAE;;QAGP,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC;AAChD,QAAA,MAAM,QAAQ,GAAG,sBAAsB,CACrC,MAAM,EACN,UAAU,EACV,SAAS,EACT,SAAS,EACT,QAAQ,CACT;QAED,MAAM,cAAc,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;AACnD,QAAA,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;IAC1B;IAEA,OAAO,GAAA;AACL,QAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAO;AAEhC,QAAA,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAW,KAAI;AAC5B,YAAA,IAAI,MAAM,CAAC,MAAM,EAAE;AACjB,gBAAA,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;AAC9B,gBAAA,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YAChC;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;YAChC,QAAQ,CAAC,OAAO,EAAE;QACpB;IACF;AACD;;;;"}