@iwsdk/core 0.4.2 → 0.5.0

package/dist/ui/uikitml.js

@@ -0,0 +1,119 @@
+import { instantiate, resolveKitComponentSets, parse } from '@drawcall/uikitml';
+import { reversePainterSortStable, StyleSheet } from '@pmndrs/uikit';
+import { AssetManager } from '../asset/asset-manager.js';
+import { CacheManager } from '../asset/cache-manager.js';
+import { UIKitDocument } from './document.js';
+import { UIKitMLAsset } from './uikitml-asset.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.
+ */
+/** Default component collection for IWSDK panels. */
+const DEFAULT_UIKITML_KIT = 'horizon';
+/** Configure a renderer for UIKit clipping and transparent painter order. */
+function configureUIKitRenderer(renderer) {
+    renderer.setTransparentSort(reversePainterSortStable);
+    renderer.localClippingEnabled = true;
+}
+function formatParseError(error) {
+    var _a;
+    const position = (_a = error.range) === null || _a === void 0 ? void 0 : _a.start;
+    const location = position ? ` at ${position.line}:${position.column}` : '';
+    return `${error.message}${location}`;
+}
+function resolveFontFaceURLs(ast, sourceURL) {
+    if (!sourceURL || !ast.fontFaces) {
+        return;
+    }
+    for (const fontFace of ast.fontFaces) {
+        try {
+            fontFace.src = new URL(fontFace.src, sourceURL).href;
+        }
+        catch (_a) {
+            // Preserve values such as application-owned URL schemes that the
+            // platform loader may still understand.
+        }
+    }
+}
+function getComponentSets(options) {
+    var _a, _b;
+    return [
+        ...resolveKitComponentSets((_a = options.kit) !== null && _a !== void 0 ? _a : DEFAULT_UIKITML_KIT),
+        ...((_b = options.componentSets) !== null && _b !== void 0 ? _b : []),
+    ];
+}
+async function preloadTTFFonts(root, ast) {
+    var _a, _b;
+    // UIKit does not expose its resolved font loaders until the component is
+    // attached, but UIKitML installs them on the root's constructor input.
+    const fontFamilies = (_a = root.inputProperties) === null || _a === void 0 ? void 0 : _a.fontFamilies;
+    if (!fontFamilies ||
+        typeof fontFamilies !== 'object' ||
+        Array.isArray(fontFamilies)) {
+        return;
+    }
+    // UIKitML's font loaders share their generated atlas cache. Resolve the
+    // declared faces serially before the first render so text cannot disappear
+    // from an initial runtime frame or editor preview capture.
+    for (const fontFace of (_b = ast.fontFaces) !== null && _b !== void 0 ? _b : []) {
+        const family = fontFamilies[fontFace.fontFamily];
+        if (!family || typeof family !== 'object' || Array.isArray(family)) {
+            continue;
+        }
+        const load = family[fontFace.fontWeight];
+        if (typeof load === 'function') {
+            await load();
+        }
+    }
+}
+/**
+ * Parse UIKitML source and resolve its relative TTF declarations.
+ *
+ * @param source UIKitML markup.
+ * @param sourceURL URL of the UIKitML document, used as the base for font URLs.
+ * @param options Parser and component-set options.
+ */
+function parseUIKitMLSource(source, sourceURL, options = {}) {
+    const componentSets = getComponentSets(options);
+    const result = parse(source, { componentSets });
+    if (!result.success) {
+        throw new Error(result.errors.map(formatParseError).join('\n'));
+    }
+    resolveFontFaceURLs(result.ast, sourceURL);
+    return result.ast;
+}
+/** Fetch, parse, and instantiate a UIKitML document. */
+async function loadUIKitMLComponent(configURL, options = {}) {
+    const source = await AssetManager.loadUIKitML(configURL, undefined, options.forceReload);
+    const resolvedURL = CacheManager.resolveUrl(configURL);
+    const sourceURL = typeof document === 'undefined'
+        ? resolvedURL
+        : new URL(resolvedURL, document.baseURI).href;
+    const componentSets = getComponentSets(options);
+    let ast;
+    try {
+        ast = parseUIKitMLSource(source, sourceURL, options);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse UIKitML ${configURL}:\n${error instanceof Error ? error.message : String(error)}`);
+    }
+    // UIKit resolves class names through its shared stylesheet registry.
+    Object.assign(StyleSheet, ast.stylesheet);
+    const root = instantiate(ast, {
+        componentSets,
+        preferredColorScheme: options.preferredColorScheme,
+    });
+    await preloadTTFFonts(root, ast);
+    return root;
+}
+/** Fetch, parse, and instantiate a UIKitML file as a placeable scene asset. */
+async function loadUIKitMLAsset(assetIdOrURL, options = {}) {
+    const root = await loadUIKitMLComponent(assetIdOrURL, options);
+    return new UIKitMLAsset(assetIdOrURL, new UIKitDocument(root));
+}
+
+export { DEFAULT_UIKITML_KIT, configureUIKitRenderer, loadUIKitMLAsset, loadUIKitMLComponent, parseUIKitMLSource };
+//# sourceMappingURL=uikitml.js.map

package/dist/ui/uikitml.js.map

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

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.4.2";
+export declare const VERSION = "0.5.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,4 +1,4 @@
-const VERSION = "0.4.2";
+const VERSION = "0.5.0";
 
 export { VERSION };
 //# sourceMappingURL=version.js.map

package/dist/visibility/visibility-component.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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 { Types } from '../ecs/component.js';
+export declare const Visibility: import("elics").Component<{
+    isVisible: {
+        type: Types.Boolean;
+        default: true;
+    };
+}>;
+//# sourceMappingURL=visibility-component.d.ts.map

package/dist/visibility/visibility-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility-component.d.ts","sourceRoot":"","sources":["../../src/visibility/visibility-component.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAE7D,eAAO,MAAM,UAAU;;;;;EAStB,CAAC"}

package/dist/visibility/visibility-component.js

@@ -0,0 +1,15 @@
+import { setComponentEditorMetadata } from '../ecs/component-editor-metadata.js';
+import { createComponent, Types } from 'elics';
+
+/**
+ * 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 Visibility = setComponentEditorMetadata(createComponent('Visibility', {
+    isVisible: { type: Types.Boolean, default: true },
+}, 'Component to control if an entity object is visible'), { hidden: true, intrinsic: true });
+
+export { Visibility };
+//# sourceMappingURL=visibility-component.js.map

package/dist/visibility/visibility-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility-component.js","sources":["../../src/visibility/visibility-component.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;AAKG;MAKU,UAAU,GAAG,0BAA0B,CAClD,eAAe,CACb,YAAY,EACZ;IACE,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;AAClD,CAAA,EACD,qDAAqD,CACtD,EACD,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;;;;"}

package/dist/visibility/visibility.d.ts

@@ -4,18 +4,12 @@
  * 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';
-export declare const Visibility: import("elics").Component<{
-    isVisible: {
-        type: Types.Boolean;
-        default: true;
-    };
-}>;
+export { Visibility } from './visibility-component.js';
 declare const VisibilitySystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
     visibility: {
         required: import("elics").Component<{
             isVisible: {
-                type: Types.Boolean;
+                type: import("elics").Types.Boolean;
                 default: true;
             };
         }>[];
@@ -24,7 +18,7 @@ declare const VisibilitySystem_base: import("elics").SystemConstructor<import("e
     visibility: {
         required: import("elics").Component<{
             isVisible: {
-                type: Types.Boolean;
+                type: import("elics").Types.Boolean;
                 default: true;
             };
         }>[];
@@ -33,5 +27,4 @@ declare const VisibilitySystem_base: import("elics").SystemConstructor<import("e
 export declare class VisibilitySystem extends VisibilitySystem_base {
     init(): void;
 }
-export {};
 //# sourceMappingURL=visibility.d.ts.map

package/dist/visibility/visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/visibility/visibility.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAG7D,eAAO,MAAM,UAAU;;;;;EAQtB,CAAC;;;;;;;;;;;;;;;;;;;;AAiCF,qBAAa,gBAAiB,SAAQ,qBAEpC;IACA,IAAI,IAAI,IAAI;CAIb"}
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/visibility/visibility.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;;;;;;;;;;;;;;;;;;;;AAmCvD,qBAAa,gBAAiB,SAAQ,qBAEpC;IACA,IAAI,IAAI,IAAI;CAIb"}

package/dist/visibility/visibility.js

@@ -1,5 +1,5 @@
-import { createComponent, Types } from 'elics';
 import { createSystem } from '../ecs/system.js';
+import { Visibility } from './visibility-component.js';
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -7,20 +7,14 @@ import { createSystem } from '../ecs/system.js';
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-const Visibility = createComponent('Visibility', {
-    isVisible: { type: Types.Boolean, default: true },
-}, 'Component to control if an entity object is visible', 
-// @ts-ignore - 4th argument is parsed by vite-plugin-metaspatial for XML generation
-{ hideInEditor: true });
 function attachToEntity(entity) {
     const object3D = entity.object3D;
-    if (!object3D) {
+    if (!object3D || object3D.__visibilityAttached) {
         return;
     }
+    object3D.__visibilityAttached = true;
     Object.defineProperty(object3D, 'visible', {
-        get: () => {
-            return entity.getValue(Visibility, 'isVisible');
-        },
+        get: () => Boolean(Visibility.data.isVisible[entity.index]),
         set: (value) => {
             entity.setValue(Visibility, 'isVisible', value);
         },
@@ -30,14 +24,17 @@ function attachToEntity(entity) {
 }
 function detachFromEntity(entity) {
     const object3D = entity.object3D;
-    if (!object3D) {
+    if (!object3D || !object3D.__visibilityAttached) {
         return;
     }
+    const visible = Boolean(Visibility.data.isVisible[entity.index]);
     Object.defineProperty(object3D, 'visible', {
-        value: object3D.visible,
+        value: visible,
+        writable: true,
         enumerable: true,
         configurable: true,
     });
+    delete object3D.__visibilityAttached;
 }
 class VisibilitySystem extends createSystem({
     visibility: { required: [Visibility] },

package/dist/visibility/visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"visibility.js","sources":["../../src/visibility/visibility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;AAKG;AAKI,MAAM,UAAU,GAAG,eAAe,CACvC,YAAY,EACZ;IACE,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;AAClD,CAAA,EACD,qDAAqD;AACrD;AACA,EAAE,YAAY,EAAE,IAAI,EAAE;AAGxB,SAAS,cAAc,CAAC,MAAc,EAAA;AACpC,IAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;IAChC,IAAI,CAAC,QAAQ,EAAE;QACb;IACF;AAEA,IAAA,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE;QACzC,GAAG,EAAE,MAAK;YACR,OAAO,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;QACjD,CAAC;AACD,QAAA,GAAG,EAAE,CAAC,KAAc,KAAI;YACtB,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC;QACjD,CAAC;AACD,QAAA,UAAU,EAAE,IAAI;AAChB,QAAA,YAAY,EAAE,IAAI;AACnB,KAAA,CAAC;AACJ;AAEA,SAAS,gBAAgB,CAAC,MAAc,EAAA;AACtC,IAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;IAChC,IAAI,CAAC,QAAQ,EAAE;QACb;IACF;AAEA,IAAA,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE;QACzC,KAAK,EAAE,QAAQ,CAAC,OAAO;AACvB,QAAA,UAAU,EAAE,IAAI;AAChB,QAAA,YAAY,EAAE,IAAI;AACnB,KAAA,CAAC;AACJ;AAEM,MAAO,gBAAiB,SAAQ,YAAY,CAAC;AACjD,IAAA,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;CACvC,CAAC,CAAA;IACA,IAAI,GAAA;QACF,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACnE;AACD;;;;"}
+{"version":3,"file":"visibility.js","sources":["../../src/visibility/visibility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;AAKG;AAQH,SAAS,cAAc,CAAC,MAAc,EAAA;AACpC,IAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;AAChC,IAAA,IAAI,CAAC,QAAQ,IAAK,QAAgB,CAAC,oBAAoB,EAAE;QACvD;IACF;AACC,IAAA,QAAgB,CAAC,oBAAoB,GAAG,IAAI;AAE7C,IAAA,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE;AACzC,QAAA,GAAG,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3D,QAAA,GAAG,EAAE,CAAC,KAAc,KAAI;YACtB,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC;QACjD,CAAC;AACD,QAAA,UAAU,EAAE,IAAI;AAChB,QAAA,YAAY,EAAE,IAAI;AACnB,KAAA,CAAC;AACJ;AAEA,SAAS,gBAAgB,CAAC,MAAc,EAAA;AACtC,IAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;IAChC,IAAI,CAAC,QAAQ,IAAI,CAAE,QAAgB,CAAC,oBAAoB,EAAE;QACxD;IACF;AACA,IAAA,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEhE,IAAA,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE;AACzC,QAAA,KAAK,EAAE,OAAO;AACd,QAAA,QAAQ,EAAE,IAAI;AACd,QAAA,UAAU,EAAE,IAAI;AAChB,QAAA,YAAY,EAAE,IAAI;AACnB,KAAA,CAAC;IACF,OAAQ,QAAgB,CAAC,oBAAoB;AAC/C;AAEM,MAAO,gBAAiB,SAAQ,YAAY,CAAC;AACjD,IAAA,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;CACvC,CAAC,CAAA;IACA,IAAI,GAAA;QACF,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACnE;AACD;;;;"}

package/package.json

@@ -1,10 +1,35 @@
 {
   "name": "@iwsdk/core",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Javascript WebXR Runtime for Emulation",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "lighting": [
+        "dist/lighting/index.d.ts"
+      ],
+      "project": [
+        "dist/project/index.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./lighting": {
+      "types": "./dist/lighting/index.d.ts",
+      "import": "./dist/lighting/index.js"
+    },
+    "./project": {
+      "types": "./dist/project/index.d.ts",
+      "import": "./dist/project/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "dist"
   ],
@@ -21,6 +46,7 @@
     "dist/init/**",
     "dist/input/**",
     "dist/layers/**",
+    "dist/lighting/**",
     "dist/level/**",
     "dist/locomotion/**",
     "dist/mcp/**",
@@ -31,6 +57,16 @@
     "dist/vendor/**",
     "dist/visibility/**"
   ],
+  "scripts": {
+    "prebuild": "node -p \"'export const VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
+    "build": "rollup -c",
+    "doc": "typedoc",
+    "format": "prettier --write ./src/**/*",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/facebook/immersive-web-sdk.git"
@@ -45,32 +81,25 @@
   "homepage": "https://github.com/facebook/immersive-web-sdk#readme",
   "dependencies": {
     "@babylonjs/havok": "^1.3.10",
+    "@drawcall/uikitml": "0.1.8",
+    "@iwsdk/locomotor": "workspace:*",
+    "@iwsdk/scene-composition": "workspace:*",
+    "@iwsdk/xr-input": "workspace:*",
     "@pmndrs/handle": "^6.6.16",
     "@pmndrs/pointer-events": "^6.6.22",
-    "@pmndrs/uikit": "^1.0.62",
-    "@pmndrs/uikitml": "^0.1.12",
+    "@pmndrs/uikit": "^1.0.74",
     "@preact/signals-core": "^1.11.0",
+    "@types/three": "^0.181.0",
+    "@types/webxr": "^0.5.0",
     "elics": "^3.4.1",
     "three": "*",
-    "three-mesh-bvh": "^0.9.1",
-    "@iwsdk/xr-input": "0.4.2",
-    "@iwsdk/glxf": "0.4.2",
-    "@iwsdk/locomotor": "0.4.2"
+    "three-mesh-bvh": "^0.9.1"
   },
   "engines": {
     "node": ">=20.19.0 <21.0.0-0 || >=22.12.0 <23.0.0-0 || >=24.0.0"
   },
   "devDependencies": {
-    "vitest": "^4.0.0",
-    "@vitest/coverage-v8": "^4.0.0"
-  },
-  "scripts": {
-    "prebuild": "node -p \"'export const VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
-    "build": "rollup -c",
-    "doc": "typedoc",
-    "format": "prettier --write ./src/**/*",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "vitest": "^4.1.10",
+    "@vitest/coverage-v8": "^4.1.10"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) Meta Platforms, Inc. and affiliates.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/ecs/component-registry.d.ts

@@ -1,54 +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 { Component } from 'elics';
-import type { Entity } from './entity.js';
-import { World } from './world.js';
-/** Field shape for GLXF component metadata. @category ECS */
-export interface GLXFComponentData {
-    [key: string]: {
-        keyString: string;
-        type: string;
-        value: any;
-        alias?: string;
-    };
-}
-/** Mapping entry from GLXF name → component class and optional mapper. @category ECS */
-export interface ComponentRegistryEntry {
-    componentClass: Component<any>;
-    description?: string;
-    mapper?: (glxfData: GLXFComponentData) => Record<string, any>;
-}
-/**
- * Registry that maps GLXF component names to ECS component classes.
- *
- * @remarks
- * - Separate from `elics`' built-in registry to avoid naming conflicts.
- * - Supports custom field mappers to translate GLXF metadata to component props.
- *
- * @category ECS
- */
-export declare class GLXFComponentRegistry {
-    private static registry;
-    private static componentToName;
-    /** Register an ECS component class under a GLXF component name. */
-    static register(glxfComponentName: string, componentClass: Component<any>, description?: string, mapper?: (glxfData: GLXFComponentData) => Record<string, any>): void;
-    /** Return the GLXF name for a given component class. */
-    static getComponentName(component: Component<any>): string | undefined;
-    /** Lookup a registered mapping entry by GLXF name. */
-    static getComponent(glxfComponentName: string): ComponentRegistryEntry | undefined;
-    /** Apply mapped components from GLXF metadata to an entity. */
-    static applyComponents(entity: Entity, world: World, glxfComponents: Record<string, GLXFComponentData>): void;
-    /** Default mapper converting GLXF `{ key: { value } }` shape to props. */
-    private static defaultMapper;
-    /** List all registered GLXF component names. */
-    static getRegisteredComponents(): string[];
-    /** Clear the registry (useful for tests). */
-    static clear(): void;
-    /** Placeholder to wire built‑in mappings from generated metadata. */
-    static setupBuiltinComponents(): void;
-}
-//# sourceMappingURL=component-registry.d.ts.map

package/dist/ecs/component-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../src/ecs/component-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAGD,wFAAwF;AACxF,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/D;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6C;IACpE,OAAO,CAAC,MAAM,CAAC,eAAe,CAAqC;IAEnE,mEAAmE;IACnE,MAAM,CAAC,QAAQ,CACb,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,SAAS,CAAC,GAAG,CAAC,EAC9B,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5D,IAAI;IASP,wDAAwD;IACxD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS;IAItE,sDAAsD;IACtD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EAAE,MAAM,GACxB,sBAAsB,GAAG,SAAS;IAIrC,+DAA+D;IAC/D,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAChD,IAAI;IA2BP,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAC,aAAa;IAc5B,gDAAgD;IAChD,MAAM,CAAC,uBAAuB,IAAI,MAAM,EAAE;IAI1C,6CAA6C;IAC7C,MAAM,CAAC,KAAK,IAAI,IAAI;IAKpB,qEAAqE;IACrE,MAAM,CAAC,sBAAsB,IAAI,IAAI;CAOtC"}

package/dist/ecs/component-registry.js

@@ -1,86 +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.
- */
-/**
- * Registry that maps GLXF component names to ECS component classes.
- *
- * @remarks
- * - Separate from `elics`' built-in registry to avoid naming conflicts.
- * - Supports custom field mappers to translate GLXF metadata to component props.
- *
- * @category ECS
- */
-class GLXFComponentRegistry {
-    /** Register an ECS component class under a GLXF component name. */
-    static register(glxfComponentName, componentClass, description, mapper) {
-        this.registry.set(glxfComponentName, {
-            componentClass,
-            description,
-            mapper,
-        });
-        this.componentToName.set(componentClass, glxfComponentName);
-    }
-    /** Return the GLXF name for a given component class. */
-    static getComponentName(component) {
-        return this.componentToName.get(component);
-    }
-    /** Lookup a registered mapping entry by GLXF name. */
-    static getComponent(glxfComponentName) {
-        return this.registry.get(glxfComponentName);
-    }
-    /** Apply mapped components from GLXF metadata to an entity. */
-    static applyComponents(entity, world, glxfComponents) {
-        Object.entries(glxfComponents).forEach(([componentName, componentData]) => {
-            const entry = this.getComponent(componentName);
-            if (entry) {
-                // Use custom mapper if provided, otherwise use default mapping
-                const componentProps = entry.mapper
-                    ? entry.mapper(componentData)
-                    : this.defaultMapper(componentData);
-                console.log(`Applying component "${componentName}" to entity with props:`, componentProps);
-                if (!entry.componentClass.bitmask) {
-                    world.registerComponent(entry.componentClass);
-                }
-                entity.addComponent(entry.componentClass, componentProps);
-            }
-            else {
-                console.warn(`Component "${componentName}" not found in registry. Available components:`, Array.from(this.registry.keys()));
-            }
-        });
-    }
-    /** Default mapper converting GLXF `{ key: { value } }` shape to props. */
-    static defaultMapper(glxfData) {
-        const props = {};
-        Object.entries(glxfData).forEach(([key, fieldData]) => {
-            if (fieldData && typeof fieldData === 'object' && 'value' in fieldData) {
-                props[key] = fieldData.value;
-            }
-        });
-        return props;
-    }
-    /** List all registered GLXF component names. */
-    static getRegisteredComponents() {
-        return Array.from(this.registry.keys());
-    }
-    /** Clear the registry (useful for tests). */
-    static clear() {
-        this.registry.clear();
-        this.componentToName.clear();
-    }
-    /** Placeholder to wire built‑in mappings from generated metadata. */
-    static setupBuiltinComponents() {
-        // This will be populated with the actual component imports
-        // For now, we'll register the components we know about
-        // Note: This is a temporary solution. In a real implementation,
-        // we would need to import the actual component objects and register them
-        // with their correct names from the components.json
-    }
-}
-GLXFComponentRegistry.registry = new Map();
-GLXFComponentRegistry.componentToName = new Map();
-
-export { GLXFComponentRegistry };
-//# sourceMappingURL=component-registry.js.map

package/dist/ecs/component-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"component-registry.js","sources":["../../src/ecs/component-registry.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;AAKG;AAyBH;;;;;;;;AAQG;MACU,qBAAqB,CAAA;;IAKhC,OAAO,QAAQ,CACb,iBAAyB,EACzB,cAA8B,EAC9B,WAAoB,EACpB,MAA6D,EAAA;AAE7D,QAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,EAAE;YACnC,cAAc;YACd,WAAW;YACX,MAAM;AACP,SAAA,CAAC;QACF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC7D;;IAGA,OAAO,gBAAgB,CAAC,SAAyB,EAAA;QAC/C,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC;IAC5C;;IAGA,OAAO,YAAY,CACjB,iBAAyB,EAAA;QAEzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C;;AAGA,IAAA,OAAO,eAAe,CACpB,MAAc,EACd,KAAY,EACZ,cAAiD,EAAA;AAEjD,QAAA,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,aAAa,CAAC,KAAI;YACxE,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC;YAC9C,IAAI,KAAK,EAAE;;AAET,gBAAA,MAAM,cAAc,GAAG,KAAK,CAAC;AAC3B,sBAAE,KAAK,CAAC,MAAM,CAAC,aAAa;AAC5B,sBAAE,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC;gBAErC,OAAO,CAAC,GAAG,CACT,CAAA,oBAAA,EAAuB,aAAa,CAAA,uBAAA,CAAyB,EAC7D,cAAc,CACf;AAED,gBAAA,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE;AACjC,oBAAA,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,cAAc,CAAC;gBAC/C;gBACA,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,cAAc,EAAE,cAAc,CAAC;YAC3D;iBAAO;AACL,gBAAA,OAAO,CAAC,IAAI,CACV,cAAc,aAAa,CAAA,8CAAA,CAAgD,EAC3E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CACjC;YACH;AACF,QAAA,CAAC,CAAC;IACJ;;IAGQ,OAAO,aAAa,CAC1B,QAA2B,EAAA;QAE3B,MAAM,KAAK,GAAwB,EAAE;AAErC,QAAA,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,KAAI;YACpD,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,IAAI,SAAS,EAAE;AACtE,gBAAA,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK;YAC9B;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,OAAO,uBAAuB,GAAA;QAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzC;;AAGA,IAAA,OAAO,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;AACrB,QAAA,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE;IAC9B;;AAGA,IAAA,OAAO,sBAAsB,GAAA;;;;;;IAM7B;;AA/Fe,qBAAA,CAAA,QAAQ,GAAG,IAAI,GAAG,EAAkC;AACpD,qBAAA,CAAA,eAAe,GAAG,IAAI,GAAG,EAA0B;;;;"}

package/dist/level/level-entity-creator.d.ts

@@ -1,27 +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 { Entity } from '../ecs/entity.js';
-import type { World } from '../ecs/world.js';
-import { Object3D } from '../runtime/index.js';
-/**
- * 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
- */
-export declare class EntityCreator {
-    static createEntitiesFromObject3D(object: Object3D, nodes: Object3D[], parentEntity: Entity, world: World): void;
-    private static applyComponents;
-    private static mapGLXFDataToProps;
-    private static handleMetaSpatialPanelComponents;
-}
-//# sourceMappingURL=level-entity-creator.d.ts.map

package/dist/level/level-entity-creator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"level-entity-creator.d.ts","sourceRoot":"","sources":["../../src/level/level-entity-creator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAM/C;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACxB,MAAM,CAAC,0BAA0B,CAC/B,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,KAAK,GACX,IAAI;IAsCP,OAAO,CAAC,MAAM,CAAC,eAAe;IAoC9B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAiBjC,OAAO,CAAC,MAAM,CAAC,gCAAgC;CAuBhD"}