@iwsdk/core 0.4.1 → 0.5.0

package/dist/level/level-entity-creator.js

@@ -1,111 +0,0 @@
-import { ComponentRegistry, Types } from 'elics';
-import '@preact/signals-core';
-import '../ecs/world.js';
-import '../ecs/entity.js';
-import '../ecs/component-registry.js';
-import '@pmndrs/uikit';
-import 'three';
-import { PanelUI } from '../ui/ui.js';
-import '../ui/follow.js';
-import '../ui/screenspace.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.
- */
-/** Component id prefix expected in GLXF extras. */
-const PACKAGE_PREFIX = 'com.iwsdk.components.';
-/**
- * Creates ECS entities from Three.js Object3D graphs and applies IWSDK components
- * found in GLXF `meta_spatial.components` extras.
- *
- * @remarks
- * - Only nodes present in the GLXF `nodes` array are converted to entities.
- * - Component ids are matched against the registry by `com.iwsdk.components.<id>`.
- * - Panel UI extras are mapped to {@link PanelUI} with JSON config paths.
- *
- * @category Scene
- */
-class EntityCreator {
-    static createEntitiesFromObject3D(object, nodes, parentEntity, world) {
-        var _a, _b, _c, _d;
-        const inNodes = nodes.includes(object);
-        if (!inNodes) {
-            return;
-        }
-        const isLevelMetaEntity = typeof object.name === 'string' && object.name.toLowerCase() === 'level';
-        // Special case: a GLXF node named "level" acts as a container for level-root components.
-        // Do not create a new ECS entity for it; attach its components to the existing parentEntity (level root),
-        // and continue processing its children under the same parentEntity.
-        if (isLevelMetaEntity && ((_b = (_a = object.userData) === null || _a === void 0 ? void 0 : _a.meta_spatial) === null || _b === void 0 ? void 0 : _b.components)) {
-            this.applyComponents(parentEntity, object.userData.meta_spatial.components, world);
-            // Remove the carrier node from the scene graph; it's metadata-only
-            object.removeFromParent();
-            return;
-        }
-        const entity = world.createTransformEntity(object, parentEntity);
-        if ((_d = (_c = object.userData) === null || _c === void 0 ? void 0 : _c.meta_spatial) === null || _d === void 0 ? void 0 : _d.components) {
-            this.applyComponents(entity, object.userData.meta_spatial.components, world);
-        }
-        object.children.forEach((child) => {
-            this.createEntitiesFromObject3D(child, nodes, entity, world);
-        });
-    }
-    static applyComponents(entity, glxfComponents, world) {
-        const allComponents = ComponentRegistry.getAllComponents();
-        this.handleMetaSpatialPanelComponents(entity, glxfComponents, world);
-        Object.entries(glxfComponents).forEach(([componentName, componentData]) => {
-            if (componentName === 'com.iwsdk.components.PanelUI') {
-                return;
-            }
-            if (!componentName.startsWith(PACKAGE_PREFIX)) {
-                return;
-            }
-            const targetId = componentName.slice(PACKAGE_PREFIX.length);
-            const component = allComponents.find((comp) => comp.id === targetId);
-            if (component) {
-                const componentProps = this.mapGLXFDataToProps(component, componentData);
-                if (!component.bitmask) {
-                    world.registerComponent(component);
-                }
-                entity.addComponent(component, componentProps);
-            }
-            else {
-                console.warn(`Component "${componentName}" not found in registry. Available components:`, allComponents.map((comp) => comp.id));
-            }
-        });
-    }
-    static mapGLXFDataToProps(component, glxfData) {
-        const props = {};
-        Object.entries(glxfData).forEach(([key, fieldData]) => {
-            if (fieldData && typeof fieldData === 'object' && component.schema[key]) {
-                if (component.schema[key].type === Types.Enum && 'alias' in fieldData) {
-                    props[key] = fieldData.alias;
-                }
-                else if ('value' in fieldData) {
-                    props[key] = fieldData.value;
-                }
-            }
-        });
-        return props;
-    }
-    static handleMetaSpatialPanelComponents(entity, glxfComponents, world) {
-        var _a, _b, _c, _d, _e;
-        const panelComponent = glxfComponents['com.iwsdk.components.PanelUI'];
-        if (!panelComponent || !((_a = panelComponent.config) === null || _a === void 0 ? void 0 : _a.value)) {
-            return;
-        }
-        const config = panelComponent.config.value.replace('.uikitml', '.json');
-        const maxWidth = ((_c = (_b = panelComponent.maxWidth) === null || _b === void 0 ? void 0 : _b.value) !== null && _c !== void 0 ? _c : 1);
-        const maxHeight = ((_e = (_d = panelComponent.maxHeight) === null || _d === void 0 ? void 0 : _d.value) !== null && _e !== void 0 ? _e : 1);
-        if (!PanelUI.bitmask) {
-            world.registerComponent(PanelUI);
-        }
-        entity.addComponent(PanelUI, { config, maxWidth, maxHeight });
-    }
-}
-
-export { EntityCreator };
-//# sourceMappingURL=level-entity-creator.js.map

package/dist/level/level-entity-creator.js.map

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

package/dist/level/level-glxf-importer.d.ts

@@ -1,22 +0,0 @@
-/**
- * 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, World } from '../ecs/index.js';
-/**
- * Loads a GLXF composition, attaches the scene graph, and creates ECS entities/components
- * based on `meta_spatial.components` extras.
- *
- * @remarks
- * - Uses the {@link AssetManager} GLTF loader so previously cached assets are reused.
- * - Each top‑level child of the GLXF active scene is attached to the current level root.
- * - Component names are resolved against the registry as `com.iwsdk.components.<id>`.
- *
- * @category Scene
- */
-export declare class GLXFImporter {
-    static load(world: World, url: string, parentEntity: Entity): Promise<void>;
-}
-//# sourceMappingURL=level-glxf-importer.d.ts.map

package/dist/level/level-glxf-importer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"level-glxf-importer.d.ts","sourceRoot":"","sources":["../../src/level/level-glxf-importer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAGrD;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;WACV,IAAI,CACf,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;CAqBjB"}

package/dist/level/level-glxf-importer.js

@@ -1,40 +0,0 @@
-import { GLXFLoader } from '@iwsdk/glxf';
-import { AssetManager } from '../asset/asset-manager.js';
-import '../asset/cache-manager.js';
-import { EntityCreator } from './level-entity-creator.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 a GLXF composition, attaches the scene graph, and creates ECS entities/components
- * based on `meta_spatial.components` extras.
- *
- * @remarks
- * - Uses the {@link AssetManager} GLTF loader so previously cached assets are reused.
- * - Each top‑level child of the GLXF active scene is attached to the current level root.
- * - Component names are resolved against the registry as `com.iwsdk.components.<id>`.
- *
- * @category Scene
- */
-class GLXFImporter {
-    static async load(world, url, parentEntity) {
-        var _a, _b;
-        const loader = new GLXFLoader(AssetManager.loadingManager).setGLTFLoader({
-            loadAsync: (u) => AssetManager.loadGLTF(u),
-        });
-        const glxf = await loader.loadAsync(url);
-        const levelRoot = (_a = parentEntity.object3D) !== null && _a !== void 0 ? _a : world.getActiveRoot();
-        const levelParentEntity = (_b = parentEntity !== null && parentEntity !== void 0 ? parentEntity : world.activeLevel.value) !== null && _b !== void 0 ? _b : world.sceneEntity;
-        [...glxf.scene.children].forEach((child) => {
-            levelRoot.attach(child);
-            EntityCreator.createEntitiesFromObject3D(child, glxf.nodes, levelParentEntity, world);
-        });
-    }
-}
-
-export { GLXFImporter };
-//# sourceMappingURL=level-glxf-importer.js.map

package/dist/level/level-glxf-importer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"level-glxf-importer.js","sources":["../../src/level/level-glxf-importer.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAAA;;;;;AAKG;AAOH;;;;;;;;;;AAUG;MACU,YAAY,CAAA;IACvB,aAAa,IAAI,CACf,KAAY,EACZ,GAAW,EACX,YAAoB,EAAA;;QAEpB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,aAAa,CAAC;YACvE,SAAS,EAAE,CAAC,CAAS,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AACnD,SAAA,CAAC;QAEF,MAAM,IAAI,GAAS,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;QAE9C,MAAM,SAAS,GAAG,CAAA,EAAA,GAAA,YAAY,CAAC,QAAQ,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,KAAK,CAAC,aAAa,EAAE;AAChE,QAAA,MAAM,iBAAiB,GACrB,CAAA,EAAA,GAAA,YAAY,KAAA,IAAA,IAAZ,YAAY,cAAZ,YAAY,GAAI,KAAK,CAAC,WAAW,CAAC,KAAK,mCAAI,KAAK,CAAC,WAAW;AAE9D,QAAA,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,KAAI;AACzC,YAAA,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;AACvB,YAAA,aAAa,CAAC,0BAA0B,CACtC,KAAK,EACL,IAAI,CAAC,KAAK,EACV,iBAAiB,EACjB,KAAK,CACN;AACH,QAAA,CAAC,CAAC;IACJ;AACD;;;;"}