@iwsdk/core 0.4.2 → 0.5.0

package/dist/ui/ui.d.ts

@@ -5,79 +5,18 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { Types } from '../ecs/component.js';
-/**
- * Color scheme options for UI theming.
- * @category UI
- */
-export declare const ColorSchemeType: {
-    /** Follow system/browser color scheme preference */
-    readonly System: "system";
-    /** Force light mode */
-    readonly Light: "light";
-    /** Force dark mode */
-    readonly Dark: "dark";
-};
-/**
- * Type representing available color scheme options.
- * @category UI
- */
-export type ColorScheme = (typeof ColorSchemeType)[keyof typeof ColorSchemeType];
-/**
- * Props accepted by the {@link PanelUI} component.
- * @category UI
- */
-export interface PanelUIProps {
-    /** Path to compiled UIKitML JSON. @example "/ui/settings.json" */
-    config: string;
-    /** Max panel width in meters. @defaultValue 1 */
-    maxWidth?: number;
-    /** Max panel height in meters. @defaultValue 1 */
-    maxHeight?: number;
-}
-/**
- * Component for 3D panel UI elements with file‑based configuration.
- *
- * @remarks
- * - Compile `.uikitml` → JSON using the UIKitML Vite plugin, then set {@link PanelUIProps.config}.
- * - When parented to world space (default), {@link PanelUISystem} drives target dimensions from
- *   {@link PanelUIProps.maxWidth} / {@link PanelUIProps.maxHeight} and accounts for world scale.
- * - Pointer events are forwarded by the input layer when canvas pointer events are enabled.
- * @category UI
- * @see /getting-started/06-spatial-ui
- */
-export declare const PanelUI: import("elics").Component<{
-    /** Path to .json file */
-    config: {
+export { ColorSchemeType, PanelDocument, PanelUI } from './panel-components.js';
+export type { ColorScheme, PanelUIProps } from './panel-components.js';
+declare const PanelUISystem_base: import("elics").SystemConstructor<{
+    /** Built-in UIKitML component collection. */
+    kit: {
         type: Types.String;
-        default: string;
-    };
-    /** Max width constraint */
-    maxWidth: {
-        type: Types.Float32;
-        default: number;
+        default: import("@drawcall/uikitml").KitName;
     };
-    /** Max height constraint */
-    maxHeight: {
-        type: Types.Float32;
-        default: number;
-    };
-}>;
-/**
- * Internal component containing the loaded UI document (a UIKitDocument `Group`).
- * @category UI
- * @hideineditor
- */
-export declare const PanelDocument: import("elics").Component<{
-    document: {
+    /** Additional application-defined UIKitML components. */
+    componentSets: {
         type: Types.Object;
-        default: undefined;
-    };
-}>;
-declare const PanelUISystem_base: import("elics").SystemConstructor<{
-    /** Additional pre-built UI component libraries */
-    kits: {
-        type: Types.Object;
-        default: {};
+        default: never[];
     };
     /** Color scheme preference for UI theming */
     preferredColorScheme: {
@@ -87,21 +26,10 @@ declare const PanelUISystem_base: import("elics").SystemConstructor<{
 }, {
     unconfiguredPanels: {
         required: import("elics").Component<{
-            /** Path to .json file */
             config: {
                 type: Types.String;
                 default: string;
             };
-            /** Max width constraint */
-            maxWidth: {
-                type: Types.Float32;
-                default: number;
-            };
-            /** Max height constraint */
-            maxHeight: {
-                type: Types.Float32;
-                default: number;
-            };
         }>[];
         excluded: import("elics").Component<{
             document: {
@@ -112,21 +40,10 @@ declare const PanelUISystem_base: import("elics").SystemConstructor<{
     };
     configuredPanels: {
         required: (import("elics").Component<{
-            /** Path to .json file */
             config: {
                 type: Types.String;
                 default: string;
             };
-            /** Max width constraint */
-            maxWidth: {
-                type: Types.Float32;
-                default: number;
-            };
-            /** Max height constraint */
-            maxHeight: {
-                type: Types.Float32;
-                default: number;
-            };
         }> | import("elics").Component<{
             document: {
                 type: Types.Object;
@@ -135,10 +52,15 @@ declare const PanelUISystem_base: import("elics").SystemConstructor<{
         }>)[];
     };
 }, import("../index.js").World, import("../ecs/system.js").System<{
-    /** Additional pre-built UI component libraries */
-    kits: {
+    /** Built-in UIKitML component collection. */
+    kit: {
+        type: Types.String;
+        default: import("@drawcall/uikitml").KitName;
+    };
+    /** Additional application-defined UIKitML components. */
+    componentSets: {
         type: Types.Object;
-        default: {};
+        default: never[];
     };
     /** Color scheme preference for UI theming */
     preferredColorScheme: {
@@ -148,21 +70,10 @@ declare const PanelUISystem_base: import("elics").SystemConstructor<{
 }, {
     unconfiguredPanels: {
         required: import("elics").Component<{
-            /** Path to .json file */
             config: {
                 type: Types.String;
                 default: string;
             };
-            /** Max width constraint */
-            maxWidth: {
-                type: Types.Float32;
-                default: number;
-            };
-            /** Max height constraint */
-            maxHeight: {
-                type: Types.Float32;
-                default: number;
-            };
         }>[];
         excluded: import("elics").Component<{
             document: {
@@ -173,21 +84,10 @@ declare const PanelUISystem_base: import("elics").SystemConstructor<{
     };
     configuredPanels: {
         required: (import("elics").Component<{
-            /** Path to .json file */
             config: {
                 type: Types.String;
                 default: string;
             };
-            /** Max width constraint */
-            maxWidth: {
-                type: Types.Float32;
-                default: number;
-            };
-            /** Max height constraint */
-            maxHeight: {
-                type: Types.Float32;
-                default: number;
-            };
         }> | import("elics").Component<{
             document: {
                 type: Types.Object;
@@ -202,22 +102,20 @@ declare const PanelUISystem_base: import("elics").SystemConstructor<{
  * @remarks
  * - Sets Three.js transparent sort to a stable painter order for UI readability.
  * - DOM pointer forwarding is owned by `CanvasPointerSystem` in the input layer.
- * - Continuously updates document target dimensions in world space.
+ * - World-space size is controlled exclusively by the entity transform.
  * @category UI
  */
 export declare class PanelUISystem extends PanelUISystem_base {
-    private vec3;
     /** Configure transparent sort, color scheme, and reactive queries. */
     init(): void;
-    /** Tick loaded UIKit documents each frame. */
+    /** Tick every UIKit document in the scene, including manifest-backed assets. */
     update(_delta: number): void;
     /**
-     * Load and interpret the `PanelUI.config` JSON file, create a {@link UIKitDocument},
+     * Load and parse the `PanelUI.config` UIKitML file, create a {@link UIKitDocument},
      * attach it to the entity, and tag the entity with {@link PanelDocument}.
      */
     private loadPanel;
     /** Remove, dispose, and detach the loaded {@link UIKitDocument} from the entity. */
     private cleanupPanel;
 }
-export {};
 //# sourceMappingURL=ui.d.ts.map

package/dist/ui/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/ui/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAM7D;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B,oDAAoD;;IAEpD,uBAAuB;;IAEvB,sBAAsB;;CAEd,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,WAAW,GACrB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO;IAGhB,yBAAyB;;;;;IAEzB,2BAA2B;;;;;IAE3B,4BAA4B;;;;;EAI/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;EAMzB,CAAC;;IAiBE,kDAAkD;;;;;IAElD,6CAA6C;;;;;;;;YAxC7C,yBAAyB;;;;;YAEzB,2BAA2B;;;;;YAE3B,4BAA4B;;;;;;;;;;;;;;;YAJ5B,yBAAyB;;;;;YAEzB,2BAA2B;;;;;YAE3B,4BAA4B;;;;;;;;;;;;;IAkC5B,kDAAkD;;;;;IAElD,6CAA6C;;;;;;;;YAxC7C,yBAAyB;;;;;YAEzB,2BAA2B;;;;;YAE3B,4BAA4B;;;;;;;;;;;;;;;YAJ5B,yBAAyB;;;;;YAEzB,2BAA2B;;;;;YAE3B,4BAA4B;;;;;;;;;;;;;AAmBhC;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,kBAWlC;IACC,OAAO,CAAC,IAAI,CAAiB;IAE7B,sEAAsE;IACtE,IAAI,IAAI,IAAI;IA6BZ,8CAA8C;IAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA8B5B;;;OAGG;YACW,SAAS;IA8CvB,oFAAoF;IACpF,OAAO,CAAC,YAAY;CAgBrB"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/ui/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAkB5C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;;IAiBnE,6CAA6C;;;;;IAE7C,yDAAyD;;;;;IAEzD,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAJ7C,6CAA6C;;;;;IAE7C,yDAAyD;;;;;IAEzD,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAnBjD;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,kBAalC;IACC,sEAAsE;IACtE,IAAI,IAAI,IAAI;IA+BZ,gFAAgF;IAChF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAc5B;;;OAGG;YACW,SAAS;IAqBvB,oFAAoF;IACpF,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/ui/ui.js

@@ -1,10 +1,10 @@
-import { reversePainterSortStable, setPreferredColorScheme } from '@pmndrs/uikit';
-import { interpret } from '@pmndrs/uikitml';
-import { createComponent, Types } from 'elics';
+import { setPreferredColorScheme } from '@pmndrs/uikit';
+import { Types } from 'elics';
 import { createSystem } from '../ecs/system.js';
-import '../runtime/three.js';
 import { UIKitDocument } from './document.js';
-import { Vector3 } from 'three';
+import { PanelUI, PanelDocument } from './panel-components.js';
+export { ColorSchemeType } from './panel-components.js';
+import { configureUIKitRenderer, loadUIKitMLComponent, DEFAULT_UIKITML_KIT } from './uikitml.js';
 
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
@@ -12,75 +12,34 @@ import { Vector3 } from 'three';
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/**
- * Color scheme options for UI theming.
- * @category UI
- */
-const ColorSchemeType = {
-    /** Follow system/browser color scheme preference */
-    System: 'system',
-    /** Force light mode */
-    Light: 'light',
-    /** Force dark mode */
-    Dark: 'dark',
-};
-/**
- * Component for 3D panel UI elements with file‑based configuration.
- *
- * @remarks
- * - Compile `.uikitml` → JSON using the UIKitML Vite plugin, then set {@link PanelUIProps.config}.
- * - When parented to world space (default), {@link PanelUISystem} drives target dimensions from
- *   {@link PanelUIProps.maxWidth} / {@link PanelUIProps.maxHeight} and accounts for world scale.
- * - Pointer events are forwarded by the input layer when canvas pointer events are enabled.
- * @category UI
- * @see /getting-started/06-spatial-ui
- */
-const PanelUI = createComponent('PanelUI', {
-    /** Path to .json file */
-    config: { type: Types.String, default: '' },
-    /** Max width constraint */
-    maxWidth: { type: Types.Float32, default: 1 },
-    /** Max height constraint */
-    maxHeight: { type: Types.Float32, default: 1 },
-}, 'Component for 3D panel UI elements with file-based configuration');
-/**
- * Internal component containing the loaded UI document (a UIKitDocument `Group`).
- * @category UI
- * @hideineditor
- */
-const PanelDocument = createComponent('PanelDocument', {
-    document: { type: Types.Object, default: undefined }, // UIKitDocument (extends Group)
-}, 'Internal component containing loaded UI document');
 /**
  * Renders and updates spatial UI panels.
  *
  * @remarks
  * - Sets Three.js transparent sort to a stable painter order for UI readability.
  * - DOM pointer forwarding is owned by `CanvasPointerSystem` in the input layer.
- * - Continuously updates document target dimensions in world space.
+ * - World-space size is controlled exclusively by the entity transform.
  * @category UI
  */
 class PanelUISystem extends createSystem({
     unconfiguredPanels: { required: [PanelUI], excluded: [PanelDocument] },
     configuredPanels: { required: [PanelUI, PanelDocument] },
 }, {
-    /** Additional pre-built UI component libraries */
-    kits: { type: Types.Object, default: {} },
+    /** Built-in UIKitML component collection. */
+    kit: { type: Types.String, default: DEFAULT_UIKITML_KIT },
+    /** Additional application-defined UIKitML components. */
+    componentSets: { type: Types.Object, default: [] },
     /** Color scheme preference for UI theming */
     preferredColorScheme: { type: Types.String, default: 'system' },
 }) {
-    constructor() {
-        super(...arguments);
-        this.vec3 = new Vector3();
-    }
     /** Configure transparent sort, color scheme, and reactive queries. */
     init() {
-        this.renderer.setTransparentSort(reversePainterSortStable);
-        this.renderer.localClippingEnabled = true;
-        // Apply color scheme preference
-        this.config.preferredColorScheme.subscribe((scheme) => {
+        configureUIKitRenderer(this.renderer);
+        // Apply color scheme preference. Register the unsubscribe / query handles
+        // on cleanupFuncs so they are released on system teardown.
+        this.cleanupFuncs.push(this.config.preferredColorScheme.subscribe((scheme) => {
             setPreferredColorScheme(scheme);
-        });
+        }), 
         // Set up reactive UI loading when panels need configuration
         this.queries.unconfiguredPanels.subscribe('qualify', (entity) => {
             this.loadPanel(entity)
@@ -90,69 +49,47 @@ class PanelUISystem extends createSystem({
                 .catch((error) => {
                 console.error(`[PanelUISystem] Failed to load panel for entity ${entity.index}:`, error);
             });
-        });
+        }), 
         // Set up cleanup when panels are unconfigured
         this.queries.configuredPanels.subscribe('disqualify', (entity) => {
             this.cleanupPanel(entity);
-        });
+        }));
     }
-    /** Tick loaded UIKit documents each frame. */
+    /** Tick every UIKit document in the scene, including manifest-backed assets. */
     update(_delta) {
-        // Update loaded panels - need to call update on root component for animations/frame updates
-        this.queries.configuredPanels.entities.forEach((entity) => {
-            const document = PanelDocument.data.document[entity.index];
-            if ((document === null || document === void 0 ? void 0 : document.rootElement) &&
-                typeof document.rootElement.update === 'function') {
-                document.rootElement.update(_delta * 1000); // UIKit expects milliseconds
-            }
-            // Continuously set target dimensions when UIKitDocument is in world space (parented to entity)
-            // This ensures PanelUISystem controls dimensions when not in screen space
-            // Note: Signals automatically handle duplicate value detection, so no need to check for changes
-            if (document && document.parent === entity.object3D) {
-                const maxWidth = PanelUI.data.maxWidth[entity.index];
-                const maxHeight = PanelUI.data.maxHeight[entity.index];
-                // Account for entity's world scale to get accurate target dimensions
-                const worldScale = entity.object3D.getWorldScale(this.vec3);
-                const adjustedMaxWidth = maxWidth / worldScale.x;
-                const adjustedMaxHeight = maxHeight / worldScale.y;
-                document.setTargetDimensions(adjustedMaxWidth, adjustedMaxHeight);
+        var _a, _b;
+        const documents = new Set();
+        const collect = (object) => {
+            if (object instanceof UIKitDocument && !object.disposed) {
+                documents.add(object);
             }
-        });
+        };
+        this.scene.traverse(collect);
+        this.camera.traverse(collect);
+        for (const document of documents) {
+            (_b = (_a = document.rootElement).update) === null || _b === void 0 ? void 0 : _b.call(_a, _delta * 1000);
+        }
     }
     /**
-     * Load and interpret the `PanelUI.config` JSON file, create a {@link UIKitDocument},
+     * Load and parse the `PanelUI.config` UIKitML file, create a {@link UIKitDocument},
      * attach it to the entity, and tag the entity with {@link PanelDocument}.
      */
     async loadPanel(entity) {
-        try {
-            const config = PanelUI.data.config[entity.index];
-            // Load and parse JSON file
-            const response = await fetch(config);
-            if (!response.ok) {
-                throw new Error(`Failed to load UI config: ${config} (${response.status} ${response.statusText})`);
-            }
-            const parseResult = await response.json();
-            const rootElement = interpret(parseResult, this.config.kits.value);
-            if (!rootElement) {
-                throw new Error(`Failed to interpret UI config: ${config}`);
-            }
-            // Create UIKitDocument
-            const document = new UIKitDocument(rootElement);
-            // Add the UIKitDocument (Group) to the entity's object3D
-            if (entity.object3D) {
-                entity.object3D.add(document);
-            }
-            else {
-                console.warn(`[PanelUISystem] Entity ${entity.index} has no object3D! Cannot add UI to scene.`);
-            }
-            // Add PanelDocument component to entity - this triggers reactive system
-            entity.addComponent(PanelDocument, {
-                document: document,
-            });
+        const config = PanelUI.data.config[entity.index];
+        const rootElement = await loadUIKitMLComponent(config, {
+            kit: this.config.kit.value,
+            componentSets: this.config.componentSets.value,
+            preferredColorScheme: this.config.preferredColorScheme
+                .value,
+        });
+        const document = new UIKitDocument(rootElement);
+        if (entity.object3D) {
+            entity.object3D.add(document);
         }
-        catch (error) {
-            console.error(`[PanelUISystem] Error loading panel for entity ${entity.index}:`, error);
+        else {
+            console.warn(`[PanelUISystem] Entity ${entity.index} has no object3D! Cannot add UI to scene.`);
         }
+        entity.addComponent(PanelDocument, { document });
     }
     /** Remove, dispose, and detach the loaded {@link UIKitDocument} from the entity. */
     cleanupPanel(entity) {
@@ -171,5 +108,5 @@ class PanelUISystem extends createSystem({
     }
 }
 
-export { ColorSchemeType, PanelDocument, PanelUI, PanelUISystem };
+export { PanelDocument, PanelUI, PanelUISystem };
 //# sourceMappingURL=ui.js.map

package/dist/ui/ui.js.map

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

package/dist/ui/uikitml-asset.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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 '@pmndrs/uikit';
+import { Group, type Object3D } from '../runtime/index.js';
+import { UIKitDocument } from './document.js';
+/** Object hierarchy produced when a UIKitML manifest asset is instantiated. */
+export declare class UIKitMLAsset extends Group {
+    readonly assetId: string;
+    readonly document: UIKitDocument;
+    readonly isUIKitMLAsset = true;
+    constructor(assetId: string, document: UIKitDocument);
+    /** Find a UIKit element without first dereferencing {@link document}. */
+    getElementById<T extends Component<any> = Component<any>>(id: string): T | null;
+    /** Return a typed UIKit element or throw when the id is absent. */
+    requireElementById<T extends Component<any> = Component<any>>(id: string): T;
+    /** Release the document even when ScreenSpace has temporarily reparented it. */
+    dispose(): void;
+}
+/** Find a UIKit document in either a manifest asset or a legacy panel hierarchy. */
+export declare function findUIKitDocument(object: Object3D | null | undefined): UIKitDocument | null;
+//# sourceMappingURL=uikitml-asset.d.ts.map

package/dist/ui/uikitml-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uikitml-asset.d.ts","sourceRoot":"","sources":["../../src/ui/uikitml-asset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,+EAA+E;AAC/E,qBAAa,YAAa,SAAQ,KAAK;IAInC,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa;IAJlC,QAAQ,CAAC,cAAc,QAAQ;gBAGpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa;IAOlC,yEAAyE;IACzE,cAAc,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,EACtD,EAAE,EAAE,MAAM,GACT,CAAC,GAAG,IAAI;IAIX,mEAAmE;IACnE,kBAAkB,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC;IAI5E,gFAAgF;IAChF,OAAO,IAAI,IAAI;CAIhB;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAClC,aAAa,GAAG,IAAI,CAiBtB"}

package/dist/ui/uikitml-asset.js

@@ -0,0 +1,56 @@
+import '../runtime/three.js';
+import { UIKitDocument } from './document.js';
+import { Group } 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.
+ */
+/** Object hierarchy produced when a UIKitML manifest asset is instantiated. */
+class UIKitMLAsset extends Group {
+    constructor(assetId, document) {
+        super();
+        this.assetId = assetId;
+        this.document = document;
+        this.isUIKitMLAsset = true;
+        this.name = assetId;
+        this.add(document);
+    }
+    /** Find a UIKit element without first dereferencing {@link document}. */
+    getElementById(id) {
+        return this.document.getElementById(id);
+    }
+    /** Return a typed UIKit element or throw when the id is absent. */
+    requireElementById(id) {
+        return this.document.requireElementById(id);
+    }
+    /** Release the document even when ScreenSpace has temporarily reparented it. */
+    dispose() {
+        this.document.removeFromParent();
+        this.document.dispose();
+    }
+}
+/** Find a UIKit document in either a manifest asset or a legacy panel hierarchy. */
+function findUIKitDocument(object) {
+    if (!object) {
+        return null;
+    }
+    if (object instanceof UIKitDocument) {
+        return object.disposed ? null : object;
+    }
+    if (object instanceof UIKitMLAsset) {
+        return object.document.disposed ? null : object.document;
+    }
+    let result = null;
+    object.traverse((child) => {
+        if (!result && child instanceof UIKitDocument && !child.disposed) {
+            result = child;
+        }
+    });
+    return result;
+}
+
+export { UIKitMLAsset, findUIKitDocument };
+//# sourceMappingURL=uikitml-asset.js.map

package/dist/ui/uikitml-asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uikitml-asset.js","sources":["../../src/ui/uikitml-asset.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAAA;;;;;AAKG;AAMH;AACM,MAAO,YAAa,SAAQ,KAAK,CAAA;IAGrC,WAAA,CACW,OAAe,EACf,QAAuB,EAAA;AAEhC,QAAA,KAAK,EAAE;QAHE,IAAA,CAAA,OAAO,GAAP,OAAO;QACP,IAAA,CAAA,QAAQ,GAAR,QAAQ;QAJV,IAAA,CAAA,cAAc,GAAG,IAAI;AAO5B,QAAA,IAAI,CAAC,IAAI,GAAG,OAAO;AACnB,QAAA,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;IACpB;;AAGA,IAAA,cAAc,CACZ,EAAU,EAAA;QAEV,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAI,EAAE,CAAC;IAC5C;;AAGA,IAAA,kBAAkB,CAA4C,EAAU,EAAA;QACtE,OAAO,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAI,EAAE,CAAC;IAChD;;IAGA,OAAO,GAAA;AACL,QAAA,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE;AAChC,QAAA,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;IACzB;AACD;AAED;AACM,SAAU,iBAAiB,CAC/B,MAAmC,EAAA;IAEnC,IAAI,CAAC,MAAM,EAAE;AACX,QAAA,OAAO,IAAI;IACb;AACA,IAAA,IAAI,MAAM,YAAY,aAAa,EAAE;QACnC,OAAO,MAAM,CAAC,QAAQ,GAAG,IAAI,GAAG,MAAM;IACxC;AACA,IAAA,IAAI,MAAM,YAAY,YAAY,EAAE;AAClC,QAAA,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC,QAAQ;IAC1D;IACA,IAAI,MAAM,GAAyB,IAAI;AACvC,IAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAI;AACxB,QAAA,IAAI,CAAC,MAAM,IAAI,KAAK,YAAY,aAAa,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;YAChE,MAAM,GAAG,KAAK;QAChB;AACF,IAAA,CAAC,CAAC;AACF,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/ui/uikitml.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 ComponentSet, type KitName, type UIKitMLAst } from '@drawcall/uikitml';
+import { type Component, type PreferredColorScheme } from '@pmndrs/uikit';
+import type { WebGLRenderer } from '../runtime/index.js';
+import { UIKitMLAsset } from './uikitml-asset.js';
+/** Built-in UIKitML component collection used by a panel. */
+export type UIKitMLKit = KitName;
+/** Additional component definitions accepted by the UIKitML parser. */
+export type UIKitMLComponentSet = ComponentSet;
+export interface UIKitMLLoadOptions {
+    /** Built-in component collection. @defaultValue `'horizon'` */
+    kit?: UIKitMLKit;
+    /** Additional application-defined UIKitML components. */
+    componentSets?: UIKitMLComponentSet[];
+    /** Color scheme supplied to the instantiated UIKit tree. */
+    preferredColorScheme?: PreferredColorScheme;
+    /** Bypass the cached source text, primarily for editor preview refreshes. */
+    forceReload?: boolean;
+}
+/** Default component collection for IWSDK panels. */
+export declare const DEFAULT_UIKITML_KIT: UIKitMLKit;
+/** Configure a renderer for UIKit clipping and transparent painter order. */
+export declare function configureUIKitRenderer(renderer: WebGLRenderer): void;
+/**
+ * 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.
+ */
+export declare function parseUIKitMLSource(source: string, sourceURL?: string, options?: UIKitMLLoadOptions): UIKitMLAst;
+/** Fetch, parse, and instantiate a UIKitML document. */
+export declare function loadUIKitMLComponent(configURL: string, options?: UIKitMLLoadOptions): Promise<Component>;
+/** Fetch, parse, and instantiate a UIKitML file as a placeable scene asset. */
+export declare function loadUIKitMLAsset(assetIdOrURL: string, options?: UIKitMLLoadOptions): Promise<UIKitMLAsset>;
+//# sourceMappingURL=uikitml.d.ts.map

package/dist/ui/uikitml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uikitml.d.ts","sourceRoot":"","sources":["../../src/ui/uikitml.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,6DAA6D;AAC7D,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC,uEAAuE;AACvE,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,yDAAyD;IACzD,aAAa,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACtC,4DAA4D;IAC5D,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,EAAE,UAAsB,CAAC;AAEzD,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAGpE;AAgED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,UAAU,CAUZ;AAED,wDAAwD;AACxD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,SAAS,CAAC,CAgCpB;AAED,+EAA+E;AAC/E,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAGvB"}