@iwsdk/core 0.4.2 → 0.5.0

package/dist/level/level-component-applier.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 type { Entity } from '../ecs/entity.js';
+import type { World } from '../ecs/world.js';
+/** Canonical component id prefix used by native scene JSON. */
+export declare const LEVEL_COMPONENT_PREFIX = "com.iwsdk.components.";
+export interface LevelComponentApplyOptions {
+    allowUnprefixedComponents?: boolean;
+    nodeId?: string;
+    resolveEntityReference?: (reference: unknown) => Entity | undefined;
+    strict?: boolean;
+}
+export declare class LevelComponentApplier {
+    static applyComponents(entity: Entity, components: Record<string, unknown>, world: World, options?: LevelComponentApplyOptions): void;
+    static removeComponents(entity: Entity, components: Record<string, unknown> | undefined): void;
+    private static updateComponent;
+    private static mapComponentDataToProps;
+    private static handlePanelComponents;
+}
+//# sourceMappingURL=level-component-applier.d.ts.map

package/dist/level/level-component-applier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-component-applier.d.ts","sourceRoot":"","sources":["../../src/level/level-component-applier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAM9D,MAAM,WAAW,0BAA0B;IACzC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,qBAAqB;IAChC,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,0BAA+B,GACvC,IAAI;IAuDP,MAAM,CAAC,gBAAgB,CACrB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,IAAI;IAsBP,OAAO,CAAC,MAAM,CAAC,eAAe;IAyB9B,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAmDtC,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAoCrC"}

package/dist/level/level-component-applier.js

@@ -0,0 +1,199 @@
+import { getComponentEditorMetadata } from '../ecs/component-editor-metadata.js';
+import { ComponentRegistry, Types } from 'elics';
+import '@pmndrs/uikit';
+import '@preact/signals-core';
+import 'three';
+import '../runtime/three.js';
+import '../ui/ui.js';
+import '@drawcall/uikitml';
+import '../asset/asset-manager.js';
+import '../asset/cache-manager.js';
+import '../ui/follow.js';
+import '../ui/screenspace.js';
+import { PanelUI } from '../ui/panel-components.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.
+ */
+/** Canonical component id prefix used by native scene JSON. */
+const LEVEL_COMPONENT_PREFIX = 'com.iwsdk.components.';
+const LEVEL_COMPONENT_ALIASES = {
+    Interactable: 'RayInteractable',
+};
+class LevelComponentApplier {
+    static applyComponents(entity, components, world, options = {}) {
+        const allComponents = ComponentRegistry.getAllComponents();
+        this.handlePanelComponents(entity, components, world, options);
+        Object.entries(components).forEach(([componentName, componentData]) => {
+            var _a;
+            const hasPackagePrefix = componentName.startsWith(LEVEL_COMPONENT_PREFIX);
+            const allowUnprefixed = options.allowUnprefixedComponents === true || options.strict === true;
+            if (!hasPackagePrefix && !allowUnprefixed) {
+                return;
+            }
+            const componentKey = stripComponentPrefix(componentName);
+            const targetId = normalizeComponentId(componentKey);
+            if (targetId === 'PanelUI') {
+                return;
+            }
+            const component = allComponents.find((comp) => comp.id === targetId);
+            if (component) {
+                const componentProps = this.mapComponentDataToProps(component, componentData, options);
+                if (!component.bitmask) {
+                    world.registerComponent(component);
+                }
+                if (entity.hasComponent(component) &&
+                    ((_a = getComponentEditorMetadata(component)) === null || _a === void 0 ? void 0 : _a.intrinsic) === true) {
+                    this.updateComponent(entity, component, componentProps);
+                }
+                else {
+                    entity.addComponent(component, componentProps);
+                }
+            }
+            else if (options.strict) {
+                throw new Error(withSceneComponentContext(`Unknown component "${componentName}". Available components: ${allComponents
+                    .map((comp) => comp.id)
+                    .join(', ')}`, options.nodeId, componentName));
+            }
+            else if (componentName.startsWith(LEVEL_COMPONENT_PREFIX)) {
+                console.warn(`Component "${componentName}" not found in registry. Available components:`, allComponents.map((comp) => comp.id));
+            }
+        });
+    }
+    static removeComponents(entity, components) {
+        var _a;
+        if (components == null) {
+            return;
+        }
+        const allComponents = ComponentRegistry.getAllComponents();
+        for (const componentName of Object.keys(components)) {
+            const targetId = normalizeComponentId(stripComponentPrefix(componentName));
+            const component = allComponents.find((entry) => entry.id === targetId);
+            if (component && entity.hasComponent(component)) {
+                if (((_a = getComponentEditorMetadata(component)) === null || _a === void 0 ? void 0 : _a.intrinsic) === true) {
+                    if (component.id === 'Visibility') {
+                        entity.setValue(component, 'isVisible', true);
+                    }
+                }
+                else {
+                    entity.removeComponent(component);
+                }
+            }
+        }
+    }
+    static updateComponent(entity, component, props) {
+        for (const [key, value] of Object.entries(props)) {
+            const field = component.schema[key];
+            if (field == null) {
+                continue;
+            }
+            if (field.type === Types.Vec2 ||
+                field.type === Types.Vec3 ||
+                field.type === Types.Vec4 ||
+                field.type === Types.Color) {
+                if (Array.isArray(value)) {
+                    entity.getVectorView(component, key).set(value);
+                }
+                continue;
+            }
+            entity.setValue(component, key, value);
+        }
+    }
+    static mapComponentDataToProps(component, componentData, options) {
+        if (!isRecord(componentData)) {
+            return {};
+        }
+        const props = {};
+        Object.entries(componentData).forEach(([key, fieldData]) => {
+            var _a;
+            const field = component.schema[key];
+            if (!field) {
+                return;
+            }
+            if (isRecord(fieldData)) {
+                if ((field.type === Types.Entity || field.widget === 'entity') &&
+                    isSceneEntityReference(fieldData)) {
+                    const referencedEntity = (_a = options.resolveEntityReference) === null || _a === void 0 ? void 0 : _a.call(options, fieldData);
+                    if (referencedEntity == null) {
+                        if (options.strict) {
+                            throw new Error(`Unable to resolve entity reference ${JSON.stringify(fieldData)}`);
+                        }
+                        props[key] = fieldData;
+                    }
+                    else {
+                        props[key] =
+                            field.type === Types.Entity
+                                ? referencedEntity
+                                : referencedEntity.object3D;
+                    }
+                }
+                else if (field.type === Types.Enum && 'alias' in fieldData) {
+                    props[key] = fieldData.alias;
+                }
+                else if ('value' in fieldData) {
+                    props[key] = fieldData.value;
+                }
+                else {
+                    props[key] = fieldData;
+                }
+            }
+            else {
+                props[key] = fieldData;
+            }
+        });
+        return props;
+    }
+    static handlePanelComponents(entity, components, world, options) {
+        const panelComponentName = canUseUnprefixedComponents(options) && components.PanelUI != null
+            ? 'PanelUI'
+            : `${LEVEL_COMPONENT_PREFIX}PanelUI`;
+        const panelComponent = panelComponentName === 'PanelUI'
+            ? components.PanelUI
+            : components[`${LEVEL_COMPONENT_PREFIX}PanelUI`];
+        const resolvedPanelComponent = panelComponent;
+        if (!isRecord(resolvedPanelComponent)) {
+            return;
+        }
+        const props = this.mapComponentDataToProps(PanelUI, resolvedPanelComponent, options);
+        if (typeof props.config !== 'string' || props.config.length === 0) {
+            return;
+        }
+        if (!PanelUI.bitmask) {
+            world.registerComponent(PanelUI);
+        }
+        entity.addComponent(PanelUI, {
+            config: props.config,
+        });
+    }
+}
+function isSceneEntityReference(value) {
+    return ((value.type === 'node' && typeof value.id === 'string') ||
+        (value.type === 'player-space' && typeof value.target === 'string') ||
+        value.type === 'level-root');
+}
+function canUseUnprefixedComponents(options) {
+    return options.allowUnprefixedComponents === true || options.strict === true;
+}
+function stripComponentPrefix(componentName) {
+    return componentName.startsWith(LEVEL_COMPONENT_PREFIX)
+        ? componentName.slice(LEVEL_COMPONENT_PREFIX.length)
+        : componentName;
+}
+function normalizeComponentId(componentId) {
+    var _a;
+    return (_a = LEVEL_COMPONENT_ALIASES[componentId]) !== null && _a !== void 0 ? _a : componentId;
+}
+function withSceneComponentContext(message, nodeId, componentName) {
+    return nodeId == null
+        ? `Component "${componentName}": ${message}`
+        : `Scene node "${nodeId}" component "${componentName}": ${message}`;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+export { LEVEL_COMPONENT_PREFIX, LevelComponentApplier };
+//# sourceMappingURL=level-component-applier.js.map

package/dist/level/level-component-applier.js.map

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

package/dist/level/level-player-rig.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 type { ScenePlayerRig, ScenePlayerTarget } from '@iwsdk/scene-composition';
+import type { Entity } from '../ecs/entity.js';
+import type { World } from '../ecs/world.js';
+export interface ApplyScenePlayerRigOptions {
+    resolveEntityReference?: (reference: unknown) => Entity | undefined;
+}
+/** Reconcile scene-authored components on persistent player-rig entities. */
+export declare function applyScenePlayerRig(world: World, nextRig: ScenePlayerRig | undefined, options?: ApplyScenePlayerRigOptions): void;
+/** Resolve one persistent runtime player-space entity. */
+export declare function getScenePlayerTargetEntity(world: World, target: ScenePlayerTarget): Entity;
+//# sourceMappingURL=level-player-rig.d.ts.map

package/dist/level/level-player-rig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-player-rig.d.ts","sourceRoot":"","sources":["../../src/level/level-player-rig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,cAAc,EACd,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAW7C,MAAM,WAAW,0BAA0B;IACzC,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CACrE;AAID,6EAA6E;AAC7E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAkBN;AAqGD,0DAA0D;AAC1D,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,iBAAiB,GACxB,MAAM,CAQR"}

package/dist/level/level-player-rig.js

@@ -0,0 +1,113 @@
+import '../runtime/three.js';
+import { LevelComponentApplier } from './level-component-applier.js';
+import { applySceneTransform } from './level-scene-object.js';
+import { MathUtils } 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 appliedPlayerRigs = new WeakMap();
+/** Reconcile scene-authored components on persistent player-rig entities. */
+function applyScenePlayerRig(world, nextRig, options = {}) {
+    var _a;
+    const state = (_a = appliedPlayerRigs.get(world)) !== null && _a !== void 0 ? _a : createPlayerRigState(world);
+    const previousRig = state.rig;
+    removePlayerRigComponents(world, previousRig);
+    restorePlayerTransform(world, state.baseline);
+    try {
+        applyPlayerRig(world, nextRig, options.resolveEntityReference);
+        syncLocomotionPlayerPosition(world);
+        state.rig = nextRig == null ? undefined : structuredClone(nextRig);
+        state.resolveEntityReference = options.resolveEntityReference;
+        appliedPlayerRigs.set(world, state);
+    }
+    catch (error) {
+        removePlayerRigComponents(world, nextRig);
+        restorePlayerTransform(world, state.baseline);
+        applyPlayerRig(world, previousRig, state.resolveEntityReference);
+        syncLocomotionPlayerPosition(world);
+        throw error;
+    }
+}
+function applyPlayerRig(world, rig, resolveEntityReference) {
+    var _a;
+    if (((_a = world.playerEntity) === null || _a === void 0 ? void 0 : _a.object3D) != null) {
+        applySceneTransform(world.playerEntity.object3D, rig === null || rig === void 0 ? void 0 : rig.transform);
+    }
+    for (const [label, entity, descriptor] of playerRigTargets(world, rig)) {
+        if ((descriptor === null || descriptor === void 0 ? void 0 : descriptor.components) == null) {
+            continue;
+        }
+        LevelComponentApplier.applyComponents(entity, descriptor.components, world, {
+            nodeId: `$player/${label}`,
+            resolveEntityReference,
+            strict: true,
+        });
+    }
+}
+function createPlayerRigState(world) {
+    var _a;
+    return {
+        baseline: ((_a = world.playerEntity) === null || _a === void 0 ? void 0 : _a.object3D) == null
+            ? undefined
+            : captureTransform(world.playerEntity),
+    };
+}
+function captureTransform(entity) {
+    const object = entity.object3D;
+    return {
+        position: object.position.toArray(),
+        rotationDeg: [
+            MathUtils.radToDeg(object.rotation.x),
+            MathUtils.radToDeg(object.rotation.y),
+            MathUtils.radToDeg(object.rotation.z),
+        ],
+        scale: object.scale.toArray(),
+    };
+}
+function restorePlayerTransform(world, baseline) {
+    var _a;
+    if (((_a = world.playerEntity) === null || _a === void 0 ? void 0 : _a.object3D) != null && baseline != null) {
+        applySceneTransform(world.playerEntity.object3D, baseline);
+    }
+}
+function syncLocomotionPlayerPosition(world) {
+    var _a;
+    const player = (_a = world.playerEntity) === null || _a === void 0 ? void 0 : _a.object3D;
+    if (player == null) {
+        return;
+    }
+    world.setAuthoredPlayerPosition(player.position);
+}
+function removePlayerRigComponents(world, rig) {
+    for (const [, entity, descriptor] of playerRigTargets(world, rig)) {
+        LevelComponentApplier.removeComponents(entity, descriptor === null || descriptor === void 0 ? void 0 : descriptor.components);
+    }
+}
+function playerRigTargets(world, rig) {
+    const spaces = world.playerSpaceEntities;
+    const targets = [
+        ['player', world.playerEntity, rig],
+        ['camera', world.cameraEntity, rig === null || rig === void 0 ? void 0 : rig.camera],
+        ['head', world.playerHeadEntity, rig === null || rig === void 0 ? void 0 : rig.head],
+        ['left-target-ray', spaces === null || spaces === void 0 ? void 0 : spaces.raySpaces.left, rig === null || rig === void 0 ? void 0 : rig.leftTargetRay],
+        ['right-target-ray', spaces === null || spaces === void 0 ? void 0 : spaces.raySpaces.right, rig === null || rig === void 0 ? void 0 : rig.rightTargetRay],
+        ['left-grip', spaces === null || spaces === void 0 ? void 0 : spaces.gripSpaces.left, rig === null || rig === void 0 ? void 0 : rig.leftGrip],
+        ['right-grip', spaces === null || spaces === void 0 ? void 0 : spaces.gripSpaces.right, rig === null || rig === void 0 ? void 0 : rig.rightGrip],
+    ];
+    return targets.filter((entry) => { var _a; return ((_a = entry[1]) === null || _a === void 0 ? void 0 : _a.object3D) != null; });
+}
+/** Resolve one persistent runtime player-space entity. */
+function getScenePlayerTargetEntity(world, target) {
+    const match = playerRigTargets(world, undefined).find(([candidate]) => candidate === target);
+    if (match == null) {
+        throw new Error(`Player-space target "${target}" is unavailable`);
+    }
+    return match[1];
+}
+
+export { applyScenePlayerRig, getScenePlayerTargetEntity };
+//# sourceMappingURL=level-player-rig.js.map

package/dist/level/level-player-rig.js.map

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

package/dist/level/level-scene-environment.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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 type { SceneEnvironment } from '@iwsdk/scene-composition';
+import { Scene, WebGLRenderer } from '../runtime/index.js';
+export interface SceneEnvironmentState {
+    fog: Scene['fog'];
+    shadows: boolean;
+    shadowMapType: WebGLRenderer['shadowMap']['type'];
+    toneMapping: WebGLRenderer['toneMapping'];
+    toneMappingExposure: number;
+    userDataEnvironment: unknown;
+}
+/** Capture every renderer-global value changed by applySceneEnvironment. */
+export declare function captureSceneEnvironment(scene: Scene, renderer: WebGLRenderer): SceneEnvironmentState;
+/**
+ * Atomically apply scene environment fields and return the exact prior state.
+ *
+ * A supplied base state supplies values for omitted fields, allowing a level swap
+ * to replace the active authored environment without first detaching it.
+ */
+export declare function applySceneEnvironment(scene: Scene, renderer: WebGLRenderer, environment: SceneEnvironment | undefined, baseState?: SceneEnvironmentState): SceneEnvironmentState;
+/** Restore a state captured before a staged or committed scene was applied. */
+export declare function restoreSceneEnvironment(scene: Scene, renderer: WebGLRenderer, state: SceneEnvironmentState): void;
+//# sourceMappingURL=level-scene-environment.d.ts.map

package/dist/level/level-scene-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-scene-environment.d.ts","sourceRoot":"","sources":["../../src/level/level-scene-environment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAWL,KAAK,EACL,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;IAClD,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,aAAa,GACtB,qBAAqB,CASvB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,gBAAgB,GAAG,SAAS,EACzC,SAAS,CAAC,EAAE,qBAAqB,GAChC,qBAAqB,CAavB;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,qBAAqB,GAC3B,IAAI,CAQN"}

package/dist/level/level-scene-environment.js

@@ -0,0 +1,121 @@
+import '../runtime/three.js';
+import { Fog, FogExp2, ACESFilmicToneMapping, CineonToneMapping, ReinhardToneMapping, LinearToneMapping, NoToneMapping, PCFSoftShadowMap, PCFShadowMap, BasicShadowMap } 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.
+ */
+/** Capture every renderer-global value changed by applySceneEnvironment. */
+function captureSceneEnvironment(scene, renderer) {
+    return {
+        fog: scene.fog,
+        shadows: renderer.shadowMap.enabled,
+        shadowMapType: renderer.shadowMap.type,
+        toneMapping: renderer.toneMapping,
+        toneMappingExposure: renderer.toneMappingExposure,
+        userDataEnvironment: scene.userData.iwsdkSceneEnvironment,
+    };
+}
+/**
+ * Atomically apply scene environment fields and return the exact prior state.
+ *
+ * A supplied base state supplies values for omitted fields, allowing a level swap
+ * to replace the active authored environment without first detaching it.
+ */
+function applySceneEnvironment(scene, renderer, environment, baseState) {
+    const previous = captureSceneEnvironment(scene, renderer);
+    if (environment == null && baseState == null) {
+        return previous;
+    }
+    const prepared = prepareSceneEnvironment(environment, baseState !== null && baseState !== void 0 ? baseState : previous);
+    try {
+        installSceneEnvironmentState(scene, renderer, prepared);
+    }
+    catch (error) {
+        installSceneEnvironmentState(scene, renderer, previous);
+        throw error;
+    }
+    return previous;
+}
+/** Restore a state captured before a staged or committed scene was applied. */
+function restoreSceneEnvironment(scene, renderer, state) {
+    const current = captureSceneEnvironment(scene, renderer);
+    try {
+        installSceneEnvironmentState(scene, renderer, state);
+    }
+    catch (error) {
+        installSceneEnvironmentState(scene, renderer, current);
+        throw error;
+    }
+}
+function prepareSceneEnvironment(environment, base) {
+    var _a, _b, _c, _d;
+    const state = {
+        ...base,
+        userDataEnvironment: environment == null ? base.userDataEnvironment : cloneJson(environment),
+    };
+    if (((_a = environment === null || environment === void 0 ? void 0 : environment.fog) === null || _a === void 0 ? void 0 : _a.type) === 'linear') {
+        state.fog = new Fog((_b = environment.fog.color) !== null && _b !== void 0 ? _b : '#000000', environment.fog.near, environment.fog.far);
+    }
+    else if (((_c = environment === null || environment === void 0 ? void 0 : environment.fog) === null || _c === void 0 ? void 0 : _c.type) === 'exponential') {
+        state.fog = new FogExp2((_d = environment.fog.color) !== null && _d !== void 0 ? _d : '#000000', environment.fog.density);
+    }
+    if ((environment === null || environment === void 0 ? void 0 : environment.toneMapping) != null) {
+        state.toneMapping = resolveToneMapping(environment.toneMapping);
+    }
+    if ((environment === null || environment === void 0 ? void 0 : environment.exposure) != null) {
+        state.toneMappingExposure = environment.exposure;
+    }
+    if ((environment === null || environment === void 0 ? void 0 : environment.shadows) != null) {
+        state.shadows = environment.shadows;
+    }
+    if ((environment === null || environment === void 0 ? void 0 : environment.shadowMapType) != null) {
+        state.shadowMapType = resolveShadowMapType(environment.shadowMapType);
+    }
+    return state;
+}
+function installSceneEnvironmentState(scene, renderer, state) {
+    scene.fog = state.fog;
+    renderer.shadowMap.enabled = state.shadows;
+    renderer.shadowMap.type = state.shadowMapType;
+    renderer.toneMapping = state.toneMapping;
+    renderer.toneMappingExposure = state.toneMappingExposure;
+    if (state.userDataEnvironment === undefined) {
+        delete scene.userData.iwsdkSceneEnvironment;
+    }
+    else {
+        scene.userData.iwsdkSceneEnvironment = state.userDataEnvironment;
+    }
+}
+function resolveShadowMapType(type) {
+    switch (type) {
+        case 'basic':
+            return BasicShadowMap;
+        case 'pcf':
+            return PCFShadowMap;
+        case 'pcf-soft':
+            return PCFSoftShadowMap;
+    }
+}
+function resolveToneMapping(mode) {
+    switch (mode) {
+        case 'none':
+            return NoToneMapping;
+        case 'linear':
+            return LinearToneMapping;
+        case 'reinhard':
+            return ReinhardToneMapping;
+        case 'cineon':
+            return CineonToneMapping;
+        case 'aces':
+            return ACESFilmicToneMapping;
+    }
+}
+function cloneJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+
+export { applySceneEnvironment, captureSceneEnvironment, restoreSceneEnvironment };
+//# sourceMappingURL=level-scene-environment.js.map

package/dist/level/level-scene-environment.js.map

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

package/dist/level/level-scene-json-importer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 { type JsonObject, type SceneDocument, type SceneCompositionDependency, type SceneNode, type SceneNodeContent, type SceneNodeFramingRole, type Sha256 } from '@iwsdk/scene-composition';
+import type { Entity } from '../ecs/entity.js';
+import type { World } from '../ecs/world.js';
+import { Object3D } from '../runtime/index.js';
+export interface SceneJSONImportedNode {
+    assetId?: string;
+    componentTypes: string[];
+    contentType?: SceneNodeContent['type'];
+    entity: Entity;
+    framingRole: SceneNodeFramingRole;
+    instanceIndex?: number;
+    metadata?: JsonObject;
+    node: SceneNode;
+    nodeId: string;
+    object: Object3D;
+    parentNodeId?: string;
+    runtimeHash: Sha256;
+    sourceNodeId: string;
+}
+export interface SceneJSONLoadResult {
+    dependencies: SceneCompositionDependency[];
+    document: SceneDocument;
+    nodes: Map<string, SceneJSONImportedNode>;
+    playerAttachments: Entity[];
+    rootEntities: Entity[];
+    runtimeHash: Sha256;
+}
+export interface SceneJSONImportOptions {
+}
+/**
+ * Loads native IWSDK scene JSON documents into a level root.
+ *
+ * @category Scene
+ */
+export declare class SceneJSONImporter {
+    static canLoadUrl(url: string): boolean;
+    static load(world: World, url: string, parentEntity: Entity, _options?: SceneJSONImportOptions): Promise<SceneJSONLoadResult>;
+    static loadDocument(world: World, document: SceneDocument, parentEntity: Entity, documentUrl?: string, _options?: SceneJSONImportOptions): Promise<SceneJSONLoadResult>;
+    private static createEntityForLoweredNode;
+}
+/** Resolve stable scene JSON entity references after all scene entities exist. */
+export declare function createSceneEntityReferenceResolver(world: World, levelRoot: Entity, nodes: ReadonlyMap<string, {
+    entity: Entity;
+}>): (reference: unknown) => Entity | undefined;
+/** Reveal player-space attachments after their replacement level commits. */
+export declare function activateScenePlayerAttachments(result: SceneJSONLoadResult | undefined): void;
+//# sourceMappingURL=level-scene-json-importer.d.ts.map

package/dist/level/level-scene-json-importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-scene-json-importer.d.ts","sourceRoot":"","sources":["../../src/level/level-scene-json-importer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAE/B,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,MAAM,EACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAc/C,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,oBAAoB,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,0BAA0B,EAAE,CAAC;IAC3C,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC1C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;CAAG;AAQ1C;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;WAO1B,IAAI,CACf,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,sBAA2B,GACpC,OAAO,CAAC,mBAAmB,CAAC;WAsBlB,YAAY,CACvB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,GAAE,sBAA2B,GACpC,OAAO,CAAC,mBAAmB,CAAC;IAqH/B,OAAO,CAAC,MAAM,CAAC,0BAA0B;CA8C1C;AAiBD,kFAAkF;AAClF,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,CAAC,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAa5C;AAeD,6EAA6E;AAC7E,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,mBAAmB,GAAG,SAAS,GACtC,IAAI,CASN"}