@iwsdk/core 0.4.2 → 0.5.0

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

@@ -4,51 +4,45 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { Types } from '../ecs/component.js';
-declare const LevelSystem_base: import("elics").SystemConstructor<{
-    /** Attach a default gradient dome on level roots when none provided. */
-    defaultLighting: {
-        type: Types.Boolean;
-        default: true;
-    };
-}, {
+import type { SceneDocument } from '@iwsdk/scene-composition';
+import type { World } from '../ecs/world.js';
+declare const LevelSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
     levelEntities: {
         required: import("elics").Component<{
             id: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
         }>[];
     };
-}, import("../index.js").World, import("../ecs/system.js").System<{
-    /** Attach a default gradient dome on level roots when none provided. */
-    defaultLighting: {
-        type: Types.Boolean;
-        default: true;
-    };
-}, {
+}, World, import("../ecs/system.js").System<import("elics").SystemSchema, {
     levelEntities: {
         required: import("elics").Component<{
             id: {
-                type: Types.String;
+                type: import("elics").Types.String;
                 default: string;
             };
         }>[];
     };
 }>>;
 /**
- * Manages the active level root, enforces identity transforms, and loads new levels on request.
+ * Manages the active level root, enforces identity transforms, and atomically loads levels.
  *
  * @remarks
- * - Destroys all {@link LevelTag}-tagged entities on level change.
- * - Loads GLXF via {@link GLXFImporter} when a URL is requested through {@link World.loadLevel}.
+ * - Stages replacement content invisibly and destroys the prior level only after a successful load.
+ * - Rejects failed loads while keeping the prior level active.
+ * - Loads native scene JSON documents or native scene JSON URLs.
  * @category Scene
  */
 export declare class LevelSystem extends LevelSystem_base {
     private loading;
+    /** Renderer state that predates the currently committed level. */
+    private activeEnvironmentBase;
     init(): void;
     update(): void;
     private startLevelChange;
 }
+/** Apply a composed scene's authored hero view to the non-immersive camera. */
+export declare function applySceneHeroCamera(world: World, document: SceneDocument): boolean;
 export {};
 //# sourceMappingURL=level-system.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"level-system.d.ts","sourceRoot":"","sources":["../../src/level/level-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;;IA2BxC,wEAAwE;;;;;;;;;;;;;;;IAAxE,wEAAwE;;;;;;;;;;;;;;;AAd5E;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,gBAShC;IACC,OAAO,CAAC,OAAO,CAAS;IAExB,IAAI,IAAI,IAAI;IAiBZ,MAAM,IAAI,IAAI;IAgCd,OAAO,CAAC,gBAAgB;CAiDzB"}
+{"version":3,"file":"level-system.d.ts","sourceRoot":"","sources":["../../src/level/level-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,0BAA0B,CAAC;AAIlC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;;;;;;;;;;;;;;;;;;;;AAmB7C;;;;;;;;GAQG;AACH,qBAAa,WAAY,SAAQ,gBAG/B;IACA,OAAO,CAAC,OAAO,CAAS;IACxB,kEAAkE;IAClE,OAAO,CAAC,qBAAqB,CAAoC;IAEjE,IAAI,IAAI,IAAI;IAiBZ,MAAM,IAAI,IAAI;IAiCd,OAAO,CAAC,gBAAgB;CAoGzB;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,aAAa,GACtB,OAAO,CA0BT"}

package/dist/level/level-system.js

@@ -1,14 +1,13 @@
 import { signal } from '@preact/signals-core';
-import { Types } from 'elics';
 import { createSystem } from '../ecs/system.js';
-import { DomeTexture } from '../environment/dome-texture.js';
-import { DomeGradient } from '../environment/dome-gradient.js';
-import { IBLTexture } from '../environment/ibl-texture.js';
-import { IBLGradient } from '../environment/ibl-gradient.js';
-import '../environment/environment-system.js';
-import { GLXFImporter } from './level-glxf-importer.js';
+import '../runtime/three.js';
+import { applyScenePlayerRig } from './level-player-rig.js';
 import { LevelRoot } from './level-root.js';
+import { captureSceneEnvironment, applySceneEnvironment, restoreSceneEnvironment } from './level-scene-environment.js';
+import { SceneJSONImporter, createSceneEntityReferenceResolver, activateScenePlayerAttachments } from './level-scene-json-importer.js';
+import { disposeSceneObjectResources } from './level-scene-object.js';
 import { LevelTag } from './level-tag.js';
+import { Vector3 } from 'three';
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -17,19 +16,17 @@ import { LevelTag } from './level-tag.js';
  * LICENSE file in the root directory of this source tree.
  */
 /**
- * Manages the active level root, enforces identity transforms, and loads new levels on request.
+ * Manages the active level root, enforces identity transforms, and atomically loads levels.
  *
  * @remarks
- * - Destroys all {@link LevelTag}-tagged entities on level change.
- * - Loads GLXF via {@link GLXFImporter} when a URL is requested through {@link World.loadLevel}.
+ * - Stages replacement content invisibly and destroys the prior level only after a successful load.
+ * - Rejects failed loads while keeping the prior level active.
+ * - Loads native scene JSON documents or native scene JSON URLs.
  * @category Scene
  */
 class LevelSystem extends createSystem({
     // All entities that belong to a level (will be destroyed on level change)
     levelEntities: { required: [LevelTag] },
-}, {
-    /** Attach a default gradient dome on level roots when none provided. */
-    defaultLighting: { type: Types.Boolean, default: true },
 }) {
     constructor() {
         super(...arguments);
@@ -74,59 +71,127 @@ class LevelSystem extends createSystem({
         if (this.loading) {
             return;
         }
-        const pending = this.world.requestedLevelUrl;
-        if (pending === undefined) {
+        const pendingUrl = this.world.requestedLevelUrl;
+        const pendingDocument = this.world.requestedLevelDocument;
+        if (pendingUrl === undefined && pendingDocument === undefined) {
             return;
         }
-        this.startLevelChange(pending);
+        this.startLevelChange(pendingUrl !== null && pendingUrl !== void 0 ? pendingUrl : '', pendingDocument);
     }
-    startLevelChange(url) {
+    startLevelChange(url, document = this.world.requestedLevelDocument) {
         this.loading = true;
+        const resolveLoad = this.world._resolveLevelLoad;
+        const rejectLoad = this.world._rejectLevelLoad;
+        this.world._resolveLevelLoad = undefined;
+        this.world._rejectLevelLoad = undefined;
         // Unset request now to avoid re-entry during async flow
         this.world.requestedLevelUrl = undefined;
-        // Destroy all level-tagged entities (current level content)
-        for (const ent of this.queries.levelEntities.entities) {
-            try {
-                ent.destroy();
-            }
-            catch (_a) { }
-        }
-        // Create a fresh level root and make it active
+        this.world.requestedLevelDocument = undefined;
+        const previousRoot = this.world.activeLevel.value;
+        const previousLevelId = this.world.activeLevelId;
+        const previousEntities = new Set(this.queries.levelEntities.entities);
+        const nextLevelId = url || 'level:default';
+        const environmentAtLoadStart = captureSceneEnvironment(this.world.scene, this.world.renderer);
+        // Stage the replacement under the scene root without exposing it as active.
+        this.world.activeLevelId = nextLevelId;
         const newRoot = this.world.createTransformEntity(undefined, {
             parent: this.world.sceneEntity,
         });
         newRoot.object3D.name = 'LevelRoot';
+        newRoot.object3D.visible = false;
         newRoot.addComponent(LevelRoot);
-        this.world.activeLevel.value = newRoot;
-        const doLoad = url
-            ? GLXFImporter.load(this.world, url, newRoot)
-            : Promise.resolve();
+        const doLoad = document != null
+            ? SceneJSONImporter.loadDocument(this.world, document, newRoot)
+            : url
+                ? SceneJSONImporter.load(this.world, url, newRoot)
+                : Promise.resolve();
         void doLoad
-            .catch((err) => console.error('[LevelSystem] Failed to load level', err))
-            .finally(() => {
-            this.loading = false;
-            // Attach default lighting if requested and the level root has no dome/IBL
-            try {
-                if (this.config.defaultLighting.value) {
-                    const hasDome = newRoot.hasComponent(DomeTexture) ||
-                        newRoot.hasComponent(DomeGradient);
-                    const hasIBL = newRoot.hasComponent(IBLTexture) ||
-                        newRoot.hasComponent(IBLGradient);
-                    if (!hasDome && !hasIBL) {
-                        newRoot.addComponent(DomeGradient).addComponent(IBLGradient);
-                    }
-                }
+            .then((loadResult) => {
+            var _a;
+            const nativeResult = asNativeSceneLoadResult(loadResult);
+            // Prepare the next authored environment against the stable pre-level
+            // baseline. The apply is transactional and retires the active level's
+            // generated resources only after the replacement is ready.
+            const nextEnvironmentBase = (_a = this.activeEnvironmentBase) !== null && _a !== void 0 ? _a : environmentAtLoadStart;
+            applySceneEnvironment(this.world.scene, this.world.renderer, nativeResult === null || nativeResult === void 0 ? void 0 : nativeResult.document.environment, nextEnvironmentBase);
+            if (nativeResult != null) {
+                newRoot.object3D.userData.iwsdkSceneResources = cloneJson(nativeResult.document.resources);
             }
-            catch (e) {
-                console.warn('[LevelSystem] defaultLighting setup failed:', e);
+            applyScenePlayerRig(this.world, nativeResult === null || nativeResult === void 0 ? void 0 : nativeResult.document.player, {
+                resolveEntityReference: nativeResult == null
+                    ? undefined
+                    : createSceneEntityReferenceResolver(this.world, newRoot, nativeResult.nodes),
+            });
+            disposeLevelEntities(previousEntities);
+            activateScenePlayerAttachments(nativeResult);
+            newRoot.object3D.visible = true;
+            this.world.activeLevelId = nextLevelId;
+            this.world.activeLevel.value = newRoot;
+            if (nativeResult != null) {
+                applySceneHeroCamera(this.world, nativeResult.document);
             }
-            if (this.world._resolveLevelLoad) {
-                this.world._resolveLevelLoad();
-                this.world._resolveLevelLoad = undefined;
+            this.activeEnvironmentBase = nextEnvironmentBase;
+            this.loading = false;
+            resolveLoad === null || resolveLoad === void 0 ? void 0 : resolveLoad();
+        })
+            .catch((error) => {
+            const stagedEntities = new Set([newRoot]);
+            for (const entity of this.queries.levelEntities.entities) {
+                if (!previousEntities.has(entity)) {
+                    stagedEntities.add(entity);
+                }
             }
+            disposeLevelEntities(stagedEntities);
+            restoreSceneEnvironment(this.world.scene, this.world.renderer, environmentAtLoadStart);
+            this.world.activeLevelId = previousLevelId;
+            this.world.activeLevel.value = previousRoot;
+            console.error('[LevelSystem] Failed to load level', error);
+            this.loading = false;
+            rejectLoad === null || rejectLoad === void 0 ? void 0 : rejectLoad(error);
         });
     }
 }
+/** Apply a composed scene's authored hero view to the non-immersive camera. */
+function applySceneHeroCamera(world, document) {
+    var _a, _b, _c, _d, _e;
+    if (((_a = world.renderer.xr) === null || _a === void 0 ? void 0 : _a.isPresenting) === true) {
+        return false;
+    }
+    const heroViewId = (_c = (_b = document.authoring) === null || _b === void 0 ? void 0 : _b.composition) === null || _c === void 0 ? void 0 : _c.review.heroView;
+    const view = (_e = (_d = document.authoring) === null || _d === void 0 ? void 0 : _d.views) === null || _e === void 0 ? void 0 : _e.find((candidate) => candidate.id === heroViewId && candidate.projection === 'perspective');
+    if (view == null) {
+        return false;
+    }
+    const cameraPosition = new Vector3(...view.position);
+    if (world.camera.parent != null) {
+        world.camera.parent.updateWorldMatrix(true, false);
+        world.camera.parent.worldToLocal(cameraPosition);
+    }
+    world.camera.position.copy(cameraPosition);
+    world.camera.lookAt(...view.target);
+    if ('fov' in world.camera) {
+        world.camera.fov = view.fov;
+    }
+    world.camera.updateProjectionMatrix();
+    world.camera.userData.iwsdkSceneHeroView = cloneJson(view);
+    return true;
+}
+function disposeLevelEntities(entities) {
+    const uniqueEntities = [...new Set(entities)];
+    disposeSceneObjectResources(...uniqueEntities.flatMap((entity) => entity.object3D == null ? [] : [entity.object3D]));
+    for (const entity of uniqueEntities) {
+        try {
+            entity.destroy();
+        }
+        catch (_a) { }
+    }
+}
+function asNativeSceneLoadResult(value) {
+    return value != null && 'document' in value ? value : undefined;
+}
+function cloneJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
 
-export { LevelSystem };
+export { LevelSystem, applySceneHeroCamera };
 //# sourceMappingURL=level-system.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"level-system.js","sources":["../../src/level/level-system.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"level-system.js","sources":["../../src/level/level-system.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/lighting/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+export * from './light-binding.js';
+export * from './light-components.js';
+export * from './light-system.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lighting/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/lighting/index.js

@@ -0,0 +1,4 @@
+export { LightBinding } from './light-binding.js';
+export { AmbientLightComponent, DirectionalLightComponent, HemisphereLightComponent, IWSDK_LIGHT_COMPONENTS, LightShadowMapSize, PointLightComponent, RectAreaLightComponent, SpotLightComponent } from './light-components.js';
+export { LightSystem, lightSpecFromComponentValue, readLightSpec } from './light-system.js';
+//# sourceMappingURL=index.js.map

package/dist/lighting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/lighting/light-binding.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 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 { Light, Object3D } from '../runtime/index.js';
+export type LightColor = readonly [number, number, number, number];
+export interface LightShadowSpec {
+    castShadow: boolean;
+    shadowBias: number;
+    shadowCameraFar: number;
+    shadowCameraNear: number;
+    shadowMapSize: number;
+    shadowNormalBias: number;
+    shadowRadius: number;
+}
+export type LightSpec = {
+    kind: 'ambient';
+    color: LightColor;
+    intensity: number;
+} | {
+    kind: 'hemisphere';
+    groundColor: LightColor;
+    intensity: number;
+    skyColor: LightColor;
+} | ({
+    kind: 'directional';
+    color: LightColor;
+    intensity: number;
+    shadowCameraSize: number;
+} & LightShadowSpec) | ({
+    kind: 'point';
+    color: LightColor;
+    decay: number;
+    distance: number;
+    intensity: number;
+} & LightShadowSpec) | ({
+    kind: 'spot';
+    angleDeg: number;
+    color: LightColor;
+    decay: number;
+    distance: number;
+    intensity: number;
+    penumbra: number;
+} & LightShadowSpec) | {
+    kind: 'rect-area';
+    color: LightColor;
+    height: number;
+    intensity: number;
+    width: number;
+};
+/**
+ * Owns one Three.js light and keeps runtime and managed-editor materialization identical.
+ */
+export declare class LightBinding {
+    readonly parent: Object3D;
+    readonly targetRoot: Object3D;
+    readonly light: Light;
+    readonly target: Object3D | undefined;
+    private readonly desiredWorldMatrix;
+    private readonly inverseParentMatrix;
+    private readonly localMatrix;
+    private readonly worldPosition;
+    private readonly worldQuaternion;
+    private readonly worldDirection;
+    private disposed;
+    private specSignature;
+    constructor(parent: Object3D, targetRoot: Object3D, spec: LightSpec);
+    update(spec: LightSpec): void;
+    /** Synchronize position and rotation while deliberately removing inherited scale. */
+    syncTransform(): void;
+    dispose(): void;
+    private assertActive;
+}
+//# sourceMappingURL=light-binding.d.ts.map

package/dist/lighting/light-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"light-binding.d.ts","sourceRoot":"","sources":["../../src/lighting/light-binding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAKL,KAAK,EAEL,QAAQ,EAOT,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,UAAU,CAAC;CACtB,GACD,CAAC;IACC,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,eAAe,CAAC,GACpB,CAAC;IACC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,eAAe,CAAC,GACpB,CAAC;IACC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,eAAe,CAAC,GACpB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAqEN;;GAEG;AACH,qBAAa,YAAY;IAcrB,QAAQ,CAAC,MAAM,EAAE,QAAQ;IACzB,QAAQ,CAAC,UAAU,EAAE,QAAQ;IAd/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAEtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;IACpD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAiB;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAM;gBAGhB,MAAM,EAAE,QAAQ,EAChB,UAAU,EAAE,QAAQ,EAC7B,IAAI,EAAE,SAAS;IAwBjB,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAoE7B,qFAAqF;IACrF,aAAa,IAAI,IAAI;IAmCrB,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,YAAY;CAKrB"}

package/dist/lighting/light-binding.js

@@ -0,0 +1,229 @@
+import { RectAreaLightUniformsLib } from 'three/examples/jsm/lights/RectAreaLightUniformsLib.js';
+import '../runtime/three.js';
+import { Vector3, Matrix4, Quaternion, Object3D, RectAreaLight, SpotLight, PointLight, DirectionalLight, HemisphereLight, AmbientLight, SRGBColorSpace } 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.
+ */
+const LOCAL_FORWARD = new Vector3(0, 0, -1);
+const WORLD_UP = new Vector3(0, 1, 0);
+const UNIT_SCALE = new Vector3(1, 1, 1);
+let rectAreaUniformsInitialized = false;
+function initializeRectAreaUniforms() {
+    if (rectAreaUniformsInitialized) {
+        return;
+    }
+    RectAreaLightUniformsLib.init();
+    rectAreaUniformsInitialized = true;
+}
+function applyColor(target, value) {
+    target.setRGB(value[0], value[1], value[2], SRGBColorSpace);
+}
+function degreesToRadians(value) {
+    return (value * Math.PI) / 180;
+}
+function createLight(spec) {
+    switch (spec.kind) {
+        case 'ambient':
+            return new AmbientLight();
+        case 'hemisphere':
+            return new HemisphereLight();
+        case 'directional':
+            return new DirectionalLight();
+        case 'point':
+            return new PointLight();
+        case 'spot':
+            return new SpotLight();
+        case 'rect-area':
+            initializeRectAreaUniforms();
+            return new RectAreaLight();
+    }
+}
+function applyShadow(light, spec) {
+    const shadow = light.shadow;
+    const mapSizeChanged = shadow.mapSize.width !== spec.shadowMapSize ||
+        shadow.mapSize.height !== spec.shadowMapSize;
+    if (mapSizeChanged && (shadow.map != null || shadow.mapPass != null)) {
+        shadow.dispose();
+        shadow.map = null;
+        shadow.mapPass = null;
+    }
+    if (light.castShadow && !spec.castShadow) {
+        shadow.dispose();
+        shadow.map = null;
+        shadow.mapPass = null;
+    }
+    light.castShadow = spec.castShadow;
+    shadow.mapSize.set(spec.shadowMapSize, spec.shadowMapSize);
+    shadow.bias = spec.shadowBias;
+    shadow.normalBias = spec.shadowNormalBias;
+    shadow.radius = spec.shadowRadius;
+    shadow.camera.near = spec.shadowCameraNear;
+    shadow.camera.far = spec.shadowCameraFar;
+    shadow.camera.updateProjectionMatrix();
+    shadow.needsUpdate = true;
+}
+/**
+ * Owns one Three.js light and keeps runtime and managed-editor materialization identical.
+ */
+class LightBinding {
+    constructor(parent, targetRoot, spec) {
+        this.parent = parent;
+        this.targetRoot = targetRoot;
+        this.desiredWorldMatrix = new Matrix4();
+        this.inverseParentMatrix = new Matrix4();
+        this.localMatrix = new Matrix4();
+        this.worldPosition = new Vector3();
+        this.worldQuaternion = new Quaternion();
+        this.worldDirection = new Vector3();
+        this.disposed = false;
+        this.specSignature = '';
+        this.light = createLight(spec);
+        this.light.name = `${spec.kind}-light`;
+        this.light.matrixAutoUpdate = false;
+        this.light.userData.iwsdkLightComponent = spec.kind;
+        copySceneIdentity(parent, this.light);
+        parent.add(this.light);
+        if (spec.kind === 'directional' || spec.kind === 'spot') {
+            const target = new Object3D();
+            target.name = `${spec.kind}-light-target`;
+            target.userData.iwsdkLightTarget = true;
+            target.userData.iwsdkRuntimeOnly = true;
+            copySceneIdentity(parent, target);
+            targetRoot.add(target);
+            this.target = target;
+            this.light.target = target;
+        }
+        this.update(spec);
+        this.syncTransform();
+    }
+    update(spec) {
+        this.assertActive();
+        if (this.light.userData.iwsdkLightComponent !== spec.kind) {
+            throw new Error('A LightBinding cannot change light kind');
+        }
+        const signature = JSON.stringify(spec);
+        if (signature === this.specSignature) {
+            return;
+        }
+        this.specSignature = signature;
+        switch (spec.kind) {
+            case 'ambient': {
+                const light = this.light;
+                applyColor(light.color, spec.color);
+                light.intensity = spec.intensity;
+                break;
+            }
+            case 'hemisphere': {
+                const light = this.light;
+                applyColor(light.color, spec.skyColor);
+                applyColor(light.groundColor, spec.groundColor);
+                light.intensity = spec.intensity;
+                break;
+            }
+            case 'directional': {
+                const light = this.light;
+                applyColor(light.color, spec.color);
+                light.intensity = spec.intensity;
+                applyShadow(light, spec);
+                const halfSize = spec.shadowCameraSize / 2;
+                light.shadow.camera.left = -halfSize;
+                light.shadow.camera.right = halfSize;
+                light.shadow.camera.top = halfSize;
+                light.shadow.camera.bottom = -halfSize;
+                light.shadow.camera.updateProjectionMatrix();
+                break;
+            }
+            case 'point': {
+                const light = this.light;
+                applyColor(light.color, spec.color);
+                light.decay = spec.decay;
+                light.distance = spec.distance;
+                light.intensity = spec.intensity;
+                applyShadow(light, spec);
+                break;
+            }
+            case 'spot': {
+                const light = this.light;
+                light.angle = degreesToRadians(spec.angleDeg);
+                applyColor(light.color, spec.color);
+                light.decay = spec.decay;
+                light.distance = spec.distance;
+                light.intensity = spec.intensity;
+                light.penumbra = spec.penumbra;
+                applyShadow(light, spec);
+                break;
+            }
+            case 'rect-area': {
+                const light = this.light;
+                applyColor(light.color, spec.color);
+                light.height = spec.height;
+                light.intensity = spec.intensity;
+                light.width = spec.width;
+                break;
+            }
+        }
+    }
+    /** Synchronize position and rotation while deliberately removing inherited scale. */
+    syncTransform() {
+        this.assertActive();
+        this.parent.updateWorldMatrix(true, false);
+        if (this.light.userData.iwsdkLightComponent === 'hemisphere') {
+            this.worldPosition.copy(WORLD_UP);
+            this.worldQuaternion.identity();
+        }
+        else {
+            this.parent.getWorldPosition(this.worldPosition);
+            this.parent.getWorldQuaternion(this.worldQuaternion);
+        }
+        this.desiredWorldMatrix.compose(this.worldPosition, this.worldQuaternion, UNIT_SCALE);
+        this.inverseParentMatrix.copy(this.parent.matrixWorld).invert();
+        this.localMatrix.multiplyMatrices(this.inverseParentMatrix, this.desiredWorldMatrix);
+        this.light.matrix.copy(this.localMatrix);
+        this.light.matrixWorld.copy(this.desiredWorldMatrix);
+        if (this.target != null) {
+            this.worldDirection
+                .copy(LOCAL_FORWARD)
+                .applyQuaternion(this.worldQuaternion);
+            this.target.position.copy(this.worldPosition).add(this.worldDirection);
+            if (this.target.parent !== this.targetRoot) {
+                this.targetRoot.add(this.target);
+            }
+            this.target.updateMatrixWorld(true);
+        }
+    }
+    dispose() {
+        var _a;
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.light.removeFromParent();
+        (_a = this.target) === null || _a === void 0 ? void 0 : _a.removeFromParent();
+        this.light.dispose();
+    }
+    assertActive() {
+        if (this.disposed) {
+            throw new Error('Cannot update a disposed LightBinding');
+        }
+    }
+}
+function copySceneIdentity(source, target) {
+    for (const key of [
+        'iwsdkSceneDocumentUrl',
+        'iwsdkSceneFramingRole',
+        'iwsdkSceneNodeId',
+        'iwsdkSceneRuntimeHash',
+        'iwsdkSceneSourceNodeId',
+    ]) {
+        if (source.userData[key] !== undefined) {
+            target.userData[key] = source.userData[key];
+        }
+    }
+}
+
+export { LightBinding };
+//# sourceMappingURL=light-binding.js.map