@iwsdk/core 0.4.2 → 0.5.0

package/dist/level/level-scene-json-importer.js

@@ -0,0 +1,256 @@
+import { assertValidSceneDocument, hashRuntimeSceneDocument } from '@iwsdk/scene-composition';
+import { LevelComponentApplier, LEVEL_COMPONENT_PREFIX } from './level-component-applier.js';
+import { getScenePlayerTargetEntity } from './level-player-rig.js';
+import { resolveSceneDocumentForLowering, lowerSceneDocumentObjects, disposeLoweredSceneNodes } from './level-scene-object.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.
+ */
+/**
+ * Loads native IWSDK scene JSON documents into a level root.
+ *
+ * @category Scene
+ */
+class SceneJSONImporter {
+    static canLoadUrl(url) {
+        const pathname = parsePathname(url);
+        return (pathname.endsWith('.iwsdk.scene.json') || pathname.endsWith('.scene.json'));
+    }
+    static async load(world, url, parentEntity, _options = {}) {
+        if (!this.canLoadUrl(url)) {
+            throw new Error(`Unsupported level URL "${url}". Expected a native .iwsdk.scene.json or .scene.json document.`);
+        }
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to load IWSDK scene "${url}": ${response.status} ${response.statusText}`);
+        }
+        return this.loadDocument(world, await response.json(), parentEntity, response.url || url, _options);
+    }
+    static async loadDocument(world, document, parentEntity, documentUrl, _options = {}) {
+        var _a, _b, _c, _d, _e, _f;
+        const sourceDocument = structuredClone(document);
+        const authoringAssets = (_b = (_a = world.assets) === null || _a === void 0 ? void 0 : _a.catalog) === null || _b === void 0 ? void 0 : _b.call(_a);
+        const validationOptions = {
+            componentCatalog: world.componentCatalog,
+            ...(authoringAssets == null
+                ? {}
+                : { knownAssetIds: authoringAssets.map((asset) => asset.id) }),
+            // Authoring review completeness is not part of the runtime projection.
+            // Draft scenes that the editor can render must remain runtime-loadable.
+            validateAuthoringWorkflow: false,
+            validateComponentLinks: false,
+        };
+        assertValidSceneDocument(sourceDocument, validationOptions);
+        if (((_d = (_c = sourceDocument.imports) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) > 0) {
+            throw new Error('Scene imports are supported only by IWSDK authoring tools. Flatten this document before loading it at runtime with "iwsdk scene flatten --input-json \'{\"path\":\"public/scenes/source.iwsdk.scene.json\"}\'".');
+        }
+        const runtimeHash = hashRuntimeSceneDocument(sourceDocument);
+        const resolvedDocument = resolveSceneDocumentForLowering(sourceDocument);
+        assertValidSceneDocument(resolvedDocument, validationOptions);
+        const result = {
+            dependencies: [],
+            document: resolvedDocument,
+            nodes: new Map(),
+            playerAttachments: [],
+            rootEntities: [],
+            runtimeHash,
+        };
+        let roots = [];
+        const createdEntities = [];
+        const pendingComponents = [];
+        try {
+            roots = await lowerSceneDocumentObjects(resolvedDocument, {
+                loadAsset: (assetId) => world.assets.instantiate(assetId),
+                resolveAssetBounds: (assetId) => world.assets.bounds(assetId),
+                runtimeHash,
+            });
+            for (const root of roots) {
+                const playerTarget = (_e = root.node.parent) === null || _e === void 0 ? void 0 : _e.target;
+                const rootParent = playerTarget == null
+                    ? parentEntity
+                    : getScenePlayerTargetEntity(world, playerTarget);
+                if (playerTarget != null) {
+                    root.object.userData.iwsdkSceneAuthoredVisible = root.object.visible;
+                    root.object.visible = false;
+                }
+                const entity = this.createEntityForLoweredNode(world, root, rootParent, documentUrl, result, createdEntities, pendingComponents);
+                result.rootEntities.push(entity);
+                if (playerTarget != null) {
+                    result.playerAttachments.push(entity);
+                }
+            }
+            const resolveEntityReference = createSceneEntityReferenceResolver(world, parentEntity, result.nodes);
+            if (resolvedDocument.components != null) {
+                LevelComponentApplier.applyComponents(parentEntity, resolvedDocument.components, world, {
+                    nodeId: '$root',
+                    resolveEntityReference,
+                    strict: true,
+                });
+            }
+            for (const pending of pendingComponents) {
+                LevelComponentApplier.applyComponents(pending.entity, pending.components, world, {
+                    nodeId: pending.nodeId,
+                    resolveEntityReference,
+                    strict: true,
+                });
+            }
+            const parentObject = (_f = parentEntity.object3D) !== null && _f !== void 0 ? _f : world.getActiveRoot();
+            parentObject.userData.iwsdkSceneRuntimeHash = runtimeHash;
+            parentObject.userData.iwsdkSceneDocumentMetadata = cloneJson(resolvedDocument.metadata);
+            parentObject.userData.iwsdkSceneRootComponents = cloneJson(resolvedDocument.components);
+            parentObject.userData.iwsdkSceneEnvironment = cloneJson(resolvedDocument.environment);
+        }
+        catch (error) {
+            for (const entity of createdEntities.reverse()) {
+                entity.destroy();
+            }
+            for (const root of roots) {
+                root.object.removeFromParent();
+            }
+            disposeLoweredSceneNodes(...roots);
+            throw error;
+        }
+        return result;
+    }
+    static createEntityForLoweredNode(world, lowered, parentEntity, documentUrl, result, createdEntities, pendingComponents) {
+        var _a;
+        const parentObject = (_a = parentEntity.object3D) !== null && _a !== void 0 ? _a : world.getActiveRoot();
+        if (lowered.object.parent !== parentObject) {
+            parentObject.add(lowered.object);
+        }
+        lowered.object.traverse((object) => {
+            object.userData.iwsdkSceneDocumentUrl = documentUrl;
+            object.userData.iwsdkSceneRuntimeHash = result.runtimeHash;
+            object.userData.iwsdkSceneLevelId = world.activeLevelId;
+        });
+        const entity = world.createTransformEntity(lowered.object, parentEntity);
+        createdEntities.push(entity);
+        const components = withoutIntrinsicVisibility(lowered.node.components);
+        if (components != null) {
+            pendingComponents.push({
+                components,
+                entity,
+                nodeId: lowered.id,
+            });
+        }
+        addImportedNode(result, lowered, entity);
+        for (const virtual of lowered.virtualNodes) {
+            addVirtualImportedNode(result, virtual, entity);
+        }
+        for (const child of lowered.children) {
+            this.createEntityForLoweredNode(world, child, entity, documentUrl, result, createdEntities, pendingComponents);
+        }
+        return entity;
+    }
+}
+function withoutIntrinsicVisibility(components) {
+    if (components == null) {
+        return undefined;
+    }
+    const result = Object.fromEntries(Object.entries(components).filter(([name]) => name !== 'Visibility' && name !== `${LEVEL_COMPONENT_PREFIX}Visibility`));
+    return Object.keys(result).length === 0 ? undefined : result;
+}
+/** Resolve stable scene JSON entity references after all scene entities exist. */
+function createSceneEntityReferenceResolver(world, levelRoot, nodes) {
+    return (reference) => {
+        var _a;
+        if (!isSceneEntityReference(reference)) {
+            return undefined;
+        }
+        if (reference.type === 'node') {
+            return (_a = nodes.get(reference.id)) === null || _a === void 0 ? void 0 : _a.entity;
+        }
+        if (reference.type === 'player-space') {
+            return getScenePlayerTargetEntity(world, reference.target);
+        }
+        return levelRoot;
+    };
+}
+function isSceneEntityReference(value) {
+    if (value == null || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    const reference = value;
+    return ((reference.type === 'node' && typeof reference.id === 'string') ||
+        (reference.type === 'player-space' &&
+            typeof reference.target === 'string') ||
+        reference.type === 'level-root');
+}
+/** Reveal player-space attachments after their replacement level commits. */
+function activateScenePlayerAttachments(result) {
+    var _a;
+    for (const entity of (_a = result === null || result === void 0 ? void 0 : result.playerAttachments) !== null && _a !== void 0 ? _a : []) {
+        const object = entity.object3D;
+        if (object == null) {
+            continue;
+        }
+        object.visible = object.userData.iwsdkSceneAuthoredVisible !== false;
+        delete object.userData.iwsdkSceneAuthoredVisible;
+    }
+}
+function addImportedNode(result, lowered, entity) {
+    var _a;
+    assertUniqueRuntimeNodeId(result, lowered.id);
+    const content = lowered.node.content;
+    result.nodes.set(lowered.id, {
+        assetId: (content === null || content === void 0 ? void 0 : content.type) === 'asset' ? content.asset : undefined,
+        componentTypes: Object.keys((_a = lowered.node.components) !== null && _a !== void 0 ? _a : {}),
+        contentType: content === null || content === void 0 ? void 0 : content.type,
+        entity,
+        framingRole: lowered.object.userData.iwsdkSceneFramingRole === 'support'
+            ? 'support'
+            : 'content',
+        metadata: cloneJson(lowered.node.metadata),
+        node: lowered.node,
+        nodeId: lowered.id,
+        object: lowered.object,
+        parentNodeId: lowered.parentNodeId,
+        runtimeHash: result.runtimeHash,
+        sourceNodeId: lowered.sourceNodeId,
+    });
+}
+function addVirtualImportedNode(result, lowered, entity) {
+    assertUniqueRuntimeNodeId(result, lowered.id);
+    const content = lowered.node.content;
+    result.nodes.set(lowered.id, {
+        componentTypes: [],
+        contentType: content === null || content === void 0 ? void 0 : content.type,
+        entity,
+        framingRole: lowered.object.userData.iwsdkSceneFramingRole === 'support'
+            ? 'support'
+            : 'content',
+        instanceIndex: lowered.instanceIndex,
+        metadata: cloneJson(lowered.node.metadata),
+        node: lowered.node,
+        nodeId: lowered.id,
+        object: lowered.object,
+        parentNodeId: lowered.parentNodeId,
+        runtimeHash: result.runtimeHash,
+        sourceNodeId: lowered.sourceNodeId,
+    });
+}
+function assertUniqueRuntimeNodeId(result, nodeId) {
+    if (result.nodes.has(nodeId)) {
+        throw new Error(`Duplicate lowered scene node id "${nodeId}"`);
+    }
+}
+function parsePathname(url) {
+    try {
+        return new URL(url, 'https://iwsdk.local').pathname.toLowerCase();
+    }
+    catch (_a) {
+        return url.split(/[?#]/, 1)[0].toLowerCase();
+    }
+}
+function cloneJson(value) {
+    if (value === undefined) {
+        return value;
+    }
+    return JSON.parse(JSON.stringify(value));
+}
+
+export { SceneJSONImporter, activateScenePlayerAttachments, createSceneEntityReferenceResolver };
+//# sourceMappingURL=level-scene-json-importer.js.map

package/dist/level/level-scene-json-importer.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * 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 SceneMaterial } from '@iwsdk/scene-composition';
+import { Material } from '../runtime/index.js';
+/** One immutable Three.js material instance per declared resource ID. */
+export declare class SceneMaterialPool {
+    private readonly materials;
+    private readonly roots;
+    private disposed;
+    get(spec: SceneMaterial): Material;
+    retain(root: object): void;
+    release(root: object): void;
+    dispose(): void;
+}
+/** Build a Three.js built-in material from a closed scene material resource. */
+export declare function createSceneMaterial(spec: SceneMaterial): Material;
+export declare function disposeStandaloneSceneMaterial(material: Material): void;
+//# sourceMappingURL=level-scene-material.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"level-scene-material.d.ts","sourceRoot":"","sources":["../../src/level/level-scene-material.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,aAAa,EAInB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAQL,QAAQ,EAYT,MAAM,qBAAqB,CAAC;AAa7B,yEAAyE;AACzE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAS;IAEzB,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ;IAgBlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO3B,OAAO,IAAI,IAAI;CAgBhB;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,CAyEjE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAUvE"}

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

@@ -0,0 +1,231 @@
+import { generateSceneProceduralTexture } from '@iwsdk/scene-composition';
+import '../runtime/three.js';
+import { Texture, MeshBasicMaterial, Vector2, MeshPhysicalMaterial, MeshStandardMaterial, FrontSide, DoubleSide, BackSide, DataTexture, RGBAFormat, UnsignedByteType, SRGBColorSpace, NoColorSpace, LinearFilter, LinearMipmapLinearFilter, RepeatWrapping, MirroredRepeatWrapping, ClampToEdgeWrapping } 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 MATERIAL_TEXTURE_PROPERTIES = [
+    'map',
+    'emissiveMap',
+    'roughnessMap',
+    'metalnessMap',
+    'aoMap',
+    'alphaMap',
+    'normalMap',
+    'bumpMap',
+];
+/** One immutable Three.js material instance per declared resource ID. */
+class SceneMaterialPool {
+    constructor() {
+        this.materials = new Map();
+        this.roots = new Set();
+        this.disposed = false;
+    }
+    get(spec) {
+        if (this.disposed) {
+            throw new Error('Cannot resolve a material from a disposed scene material pool');
+        }
+        const existing = this.materials.get(spec.id);
+        if (existing != null) {
+            return existing;
+        }
+        const material = createSceneMaterial(spec);
+        material.userData.iwsdkSceneMaterialPooled = true;
+        this.materials.set(spec.id, material);
+        return material;
+    }
+    retain(root) {
+        if (!this.disposed) {
+            this.roots.add(root);
+        }
+    }
+    release(root) {
+        this.roots.delete(root);
+        if (this.roots.size === 0) {
+            this.dispose();
+        }
+    }
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        const textures = new Set();
+        for (const material of this.materials.values()) {
+            collectSceneMaterialTextures(material, textures);
+            material.dispose();
+        }
+        for (const texture of textures) {
+            texture.dispose();
+        }
+        this.materials.clear();
+        this.roots.clear();
+    }
+}
+/** Build a Three.js built-in material from a closed scene material resource. */
+function createSceneMaterial(spec) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1;
+    const opacity = (_a = spec.opacity) !== null && _a !== void 0 ? _a : 1;
+    const textures = 'textures' in spec ? spec.textures : undefined;
+    const generated = createMaterialTextures(spec.id, textures);
+    const common = {
+        ...(generated.alpha == null ? {} : { alphaMap: generated.alpha }),
+        color: (_b = spec.baseColor) !== null && _b !== void 0 ? _b : (generated.albedo == null ? '#8aa0ad' : '#ffffff'),
+        ...(generated.albedo == null ? {} : { map: generated.albedo }),
+        opacity,
+        side: resolveMaterialSide(spec.side),
+        transparent: opacity < 1 || generated.alpha != null,
+    };
+    let material;
+    if (spec.model === 'basic') {
+        material = new MeshBasicMaterial(common);
+    }
+    else {
+        const pbr = {
+            ...common,
+            ...(generated.ambientOcclusion == null
+                ? {}
+                : { aoMap: generated.ambientOcclusion }),
+            ...(generated.bump == null
+                ? {}
+                : { bumpMap: generated.bump, bumpScale: (_d = (_c = textures === null || textures === void 0 ? void 0 : textures.bump) === null || _c === void 0 ? void 0 : _c.scale) !== null && _d !== void 0 ? _d : 1 }),
+            emissive: (_e = spec.emissive) !== null && _e !== void 0 ? _e : (generated.emissive == null ? '#000000' : '#ffffff'),
+            emissiveIntensity: (_f = spec.emissiveIntensity) !== null && _f !== void 0 ? _f : 1,
+            ...(generated.emissive == null
+                ? {}
+                : { emissiveMap: generated.emissive }),
+            flatShading: (_g = spec.flatShading) !== null && _g !== void 0 ? _g : false,
+            metalness: (_h = spec.metalness) !== null && _h !== void 0 ? _h : (generated.metalness == null ? 0 : 1),
+            ...(generated.metalness == null
+                ? {}
+                : { metalnessMap: generated.metalness }),
+            ...(generated.normal == null
+                ? {}
+                : {
+                    normalMap: generated.normal,
+                    normalScale: new Vector2(...((_k = (_j = textures === null || textures === void 0 ? void 0 : textures.normal) === null || _j === void 0 ? void 0 : _j.scale) !== null && _k !== void 0 ? _k : [1, 1])),
+                }),
+            roughness: (_l = spec.roughness) !== null && _l !== void 0 ? _l : (generated.roughness == null ? 0.7 : 1),
+            ...(generated.roughness == null
+                ? {}
+                : { roughnessMap: generated.roughness }),
+        };
+        material =
+            spec.model === 'physical'
+                ? new MeshPhysicalMaterial({
+                    ...pbr,
+                    anisotropy: (_m = spec.anisotropy) !== null && _m !== void 0 ? _m : 0,
+                    anisotropyRotation: (((_o = spec.anisotropyRotationDeg) !== null && _o !== void 0 ? _o : 0) * Math.PI) / 180,
+                    attenuationColor: (_p = spec.attenuationColor) !== null && _p !== void 0 ? _p : '#ffffff',
+                    attenuationDistance: (_q = spec.attenuationDistance) !== null && _q !== void 0 ? _q : Infinity,
+                    clearcoat: (_r = spec.clearcoat) !== null && _r !== void 0 ? _r : 0,
+                    clearcoatRoughness: (_s = spec.clearcoatRoughness) !== null && _s !== void 0 ? _s : 0,
+                    envMapIntensity: (_t = spec.envMapIntensity) !== null && _t !== void 0 ? _t : 1,
+                    ior: (_u = spec.ior) !== null && _u !== void 0 ? _u : 1.5,
+                    sheen: (_v = spec.sheen) !== null && _v !== void 0 ? _v : 0,
+                    sheenColor: (_w = spec.sheenColor) !== null && _w !== void 0 ? _w : '#000000',
+                    sheenRoughness: (_x = spec.sheenRoughness) !== null && _x !== void 0 ? _x : 1,
+                    specularColor: (_y = spec.specularColor) !== null && _y !== void 0 ? _y : '#ffffff',
+                    specularIntensity: (_z = spec.specularIntensity) !== null && _z !== void 0 ? _z : 1,
+                    thickness: (_0 = spec.thickness) !== null && _0 !== void 0 ? _0 : 0,
+                    transmission: (_1 = spec.transmission) !== null && _1 !== void 0 ? _1 : 0,
+                })
+                : new MeshStandardMaterial(pbr);
+    }
+    material.name = spec.id;
+    material.userData.iwsdkSceneMaterialId = spec.id;
+    material.userData.iwsdkSceneMaterialModel = spec.model;
+    return material;
+}
+function disposeStandaloneSceneMaterial(material) {
+    if (material.userData.iwsdkSceneMaterialPooled === true) {
+        return;
+    }
+    const textures = new Set();
+    collectSceneMaterialTextures(material, textures);
+    material.dispose();
+    for (const texture of textures) {
+        texture.dispose();
+    }
+}
+function createMaterialTextures(materialId, textures) {
+    const result = {};
+    if (textures == null) {
+        return result;
+    }
+    for (const [channel, descriptor] of Object.entries(textures)) {
+        if (descriptor == null) {
+            continue;
+        }
+        result[channel] = createProceduralDataTexture(materialId, channel, descriptor);
+    }
+    return result;
+}
+function createProceduralDataTexture(materialId, channel, descriptor) {
+    var _a, _b, _c, _d;
+    const generated = generateSceneProceduralTexture(channel, descriptor);
+    const texture = new DataTexture(generated.data, generated.width, generated.height, RGBAFormat, UnsignedByteType);
+    texture.name = `${materialId}:${channel}`;
+    texture.colorSpace =
+        channel === 'albedo' || channel === 'emissive'
+            ? SRGBColorSpace
+            : NoColorSpace;
+    texture.flipY = false;
+    texture.generateMipmaps = true;
+    texture.magFilter = LinearFilter;
+    texture.minFilter = LinearMipmapLinearFilter;
+    const sampler = descriptor.sampler;
+    texture.wrapS = resolveTextureWrap(sampler === null || sampler === void 0 ? void 0 : sampler.wrapU);
+    texture.wrapT = resolveTextureWrap(sampler === null || sampler === void 0 ? void 0 : sampler.wrapV);
+    texture.repeat.set(...((_a = sampler === null || sampler === void 0 ? void 0 : sampler.repeat) !== null && _a !== void 0 ? _a : [1, 1]));
+    texture.offset.set(...((_b = sampler === null || sampler === void 0 ? void 0 : sampler.offset) !== null && _b !== void 0 ? _b : [0, 0]));
+    texture.center.set(0.5, 0.5);
+    texture.rotation = (((_c = sampler === null || sampler === void 0 ? void 0 : sampler.rotationDeg) !== null && _c !== void 0 ? _c : 0) * Math.PI) / 180;
+    texture.anisotropy = (_d = sampler === null || sampler === void 0 ? void 0 : sampler.anisotropy) !== null && _d !== void 0 ? _d : 1;
+    texture.userData.iwsdkSceneProceduralTexture = {
+        algorithm: descriptor.algorithm,
+        channel,
+        dataHash: generated.dataHash,
+        height: generated.height,
+        recipeHash: generated.recipeHash,
+        width: generated.width,
+    };
+    texture.needsUpdate = true;
+    return texture;
+}
+function collectSceneMaterialTextures(material, textures) {
+    const candidate = material;
+    for (const property of MATERIAL_TEXTURE_PROPERTIES) {
+        const texture = candidate[property];
+        if (texture instanceof Texture) {
+            textures.add(texture);
+        }
+    }
+}
+function resolveTextureWrap(wrap) {
+    switch (wrap) {
+        case 'clamp':
+            return ClampToEdgeWrapping;
+        case 'mirror':
+            return MirroredRepeatWrapping;
+        default:
+            return RepeatWrapping;
+    }
+}
+function resolveMaterialSide(side) {
+    switch (side) {
+        case 'back':
+            return BackSide;
+        case 'double':
+            return DoubleSide;
+        default:
+            return FrontSide;
+    }
+}
+
+export { SceneMaterialPool, createSceneMaterial, disposeStandaloneSceneMaterial };
+//# sourceMappingURL=level-scene-material.js.map

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * 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 { SceneAssetBoundsResolver, type SceneDocument, SceneNode, SceneTransform, Sha256 } from '@iwsdk/scene-composition';
+import { InstancedMesh, Object3D } from '../runtime/index.js';
+export { deriveSceneInstanceNodeId, deriveScenePatternNodeId, generateScenePatternTransforms, MAX_SCENE_PATTERN_INSTANCES, } from '@iwsdk/scene-composition';
+export type SceneAssetLoader = (assetId: string) => Promise<Object3D>;
+export interface SceneObjectLoweringOptions {
+    loadAsset?: SceneAssetLoader;
+    resolveAssetBounds?: SceneAssetBoundsResolver;
+    maxPatternInstances?: number;
+    runtimeHash?: Sha256;
+    useInstancing?: boolean;
+}
+export interface SceneLoweredVirtualNode {
+    id: string;
+    instanceIndex: number;
+    node: SceneNode;
+    object: InstancedMesh;
+    parentNodeId: string;
+    sourceNodeId: string;
+}
+export interface SceneLoweredNode {
+    children: SceneLoweredNode[];
+    id: string;
+    node: SceneNode;
+    object: Object3D;
+    parentNodeId?: string;
+    sourceNodeId: string;
+    virtualNodes: SceneLoweredVirtualNode[];
+}
+/** Lower one authored node, including prefab and pattern content, to Object3D. */
+export declare function lowerSceneNodeObject(document: SceneDocument, node: SceneNode, options?: SceneObjectLoweringOptions): Promise<SceneLoweredNode>;
+/** Lower all top-level nodes while sharing one deterministic expansion budget. */
+export declare function lowerSceneDocumentObjects(document: SceneDocument, options?: SceneObjectLoweringOptions): Promise<SceneLoweredNode[]>;
+/** Resolve document-scoped constraints exactly as the shared object lowerer does. */
+export declare function resolveSceneDocumentForLowering(document: SceneDocument): SceneDocument;
+/** Create only a node's direct render content, without its transform or children. */
+export declare function createSceneContentObject(document: SceneDocument, node: SceneNode, options?: SceneObjectLoweringOptions): Promise<Object3D>;
+/** Apply a scene transform to an Object3D using Three.js' XYZ Euler convention. */
+export declare function applySceneTransform(object: Object3D, transform: SceneTransform | undefined): void;
+/** Release lowering-owned instance state without disposing shared asset resources. */
+export declare function disposeSceneObjectResources(...roots: Object3D[]): void;
+/** Dispose all resources owned by one or more returned lowering trees. */
+export declare function disposeLoweredSceneNodes(...nodes: SceneLoweredNode[]): void;
+//# sourceMappingURL=level-scene-object.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"level-scene-object.d.ts","sourceRoot":"","sources":["../../src/level/level-scene-object.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EASL,wBAAwB,EAExB,KAAK,aAAa,EAClB,SAAS,EAIT,cAAc,EACd,MAAM,EAEP,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,aAAa,EAGb,QAAQ,EAGT,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEtE,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,QAAQ,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,uBAAuB,EAAE,CAAC;CACzC;AAwBD,kFAAkF;AAClF,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,gBAAgB,CAAC,CAgB3B;AAED,kFAAkF;AAClF,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAe7B;AAED,qFAAqF;AACrF,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,aAAa,GACtB,aAAa,CAEf;AAED,qFAAqF;AACrF,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,QAAQ,CAAC,CAQnB;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,QAAQ,EAChB,SAAS,EAAE,cAAc,GAAG,SAAS,GACpC,IAAI,CAgBN;AAED,sFAAsF;AACtF,wBAAgB,2BAA2B,CAAC,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CActE;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAE3E"}