@iwsdk/core 0.4.2 → 0.5.0

package/dist/ui/follow.d.ts

@@ -4,94 +4,30 @@
  * 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';
-/** Behavior modes for {@link Follower}. @category UI */
-export declare const FollowBehavior: {
-    FaceTarget: string;
-    PivotY: string;
-    NoRotation: string;
-};
+export { FollowBehavior, Follower } from './follow-component.js';
 /**
- * Makes an entity follow a target `Object3D` with optional rotation behavior.
- *
- * @remarks
- * - `PivotY` keeps the follower level while rotating around the Y axis to face the target.
- * - `FaceTarget` fully rotates to look at the target.
- * - `NoRotation` only moves position.
- *
- * @example Attach to an entity to follow the HMD at shoulder‑height
- * ```ts
- * entity.addComponent(Follower, {
- *   target: xrRig.head,
- *   offsetPosition: [0.25, -0.2, -0.35],
- *   behavior: FollowBehavior.PivotY,
- *   speed: 5,
- *   tolerance: 0.3,
- * })
- * ```
- * @category UI
+ * Angle in degrees from the dot product of two unit vectors, robust to
+ * floating-point error. A normalized dot product can land slightly outside
+ * [-1, 1] (e.g. 1.0000001), which makes `Math.acos` return `NaN`; that `NaN`
+ * would then poison the follow re-target comparison. Clamp before `acos`.
  */
-export declare const Follower: import("elics").Component<{
-    /** Object to follow (e.g., `world.player.head`). */
-    target: {
-        type: Types.Object;
-        default: undefined;
-    };
-    /** Offset from the target in the target's local space. */
-    offsetPosition: {
-        type: Types.Vec3;
-        default: [number, number, number];
-    };
-    behavior: {
-        type: Types.Enum;
-        enum: {
-            FaceTarget: string;
-            PivotY: string;
-            NoRotation: string;
-        };
-        default: string;
-    };
-    /** Degrees of allowable angular deviation before target snaps forward. */
-    maxAngle: {
-        type: Types.Float32;
-        default: number;
-    };
-    /** Meters of allowable positional slack before catching up. */
-    tolerance: {
-        type: Types.Float32;
-        default: number;
-    };
-    /** Lerp speed towards the target position. */
-    speed: {
-        type: Types.Float32;
-        default: number;
-    };
-    /** Internal: one‑time sync to jump to the target position. */
-    needsPositionSync: {
-        type: Types.Boolean;
-        default: true;
-    };
-    /** Internal: smoothed follow target in world space. */
-    _followTarget: {
-        type: Types.Vec3;
-        default: [number, number, number];
-    };
-}>;
+export declare function clampedAcosDeg(dot: number): number;
 declare const FollowSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
     follower: {
         required: import("elics").Component<{
-            /** Object to follow (e.g., `world.player.head`). */
             target: {
-                type: Types.Object;
+                type: import("elics").Types.Object;
                 default: undefined;
+                widget: string;
+                required: boolean;
+                help: string;
             };
-            /** Offset from the target in the target's local space. */
             offsetPosition: {
-                type: Types.Vec3;
+                type: import("elics").Types.Vec3;
                 default: [number, number, number];
             };
             behavior: {
-                type: Types.Enum;
+                type: import("elics").Types.Enum;
                 enum: {
                     FaceTarget: string;
                     PivotY: string;
@@ -99,29 +35,24 @@ declare const FollowSystem_base: import("elics").SystemConstructor<import("elics
                 };
                 default: string;
             };
-            /** Degrees of allowable angular deviation before target snaps forward. */
             maxAngle: {
-                type: Types.Float32;
+                type: import("elics").Types.Float32;
                 default: number;
             };
-            /** Meters of allowable positional slack before catching up. */
             tolerance: {
-                type: Types.Float32;
+                type: import("elics").Types.Float32;
                 default: number;
             };
-            /** Lerp speed towards the target position. */
             speed: {
-                type: Types.Float32;
+                type: import("elics").Types.Float32;
                 default: number;
             };
-            /** Internal: one‑time sync to jump to the target position. */
             needsPositionSync: {
-                type: Types.Boolean;
+                type: import("elics").Types.Boolean;
                 default: true;
             };
-            /** Internal: smoothed follow target in world space. */
             _followTarget: {
-                type: Types.Vec3;
+                type: import("elics").Types.Vec3;
                 default: [number, number, number];
             };
         }>[];
@@ -129,18 +60,19 @@ declare const FollowSystem_base: import("elics").SystemConstructor<import("elics
 }, import("../index.js").World, import("../ecs/system.js").System<import("elics").SystemSchema, {
     follower: {
         required: import("elics").Component<{
-            /** Object to follow (e.g., `world.player.head`). */
             target: {
-                type: Types.Object;
+                type: import("elics").Types.Object;
                 default: undefined;
+                widget: string;
+                required: boolean;
+                help: string;
             };
-            /** Offset from the target in the target's local space. */
             offsetPosition: {
-                type: Types.Vec3;
+                type: import("elics").Types.Vec3;
                 default: [number, number, number];
             };
             behavior: {
-                type: Types.Enum;
+                type: import("elics").Types.Enum;
                 enum: {
                     FaceTarget: string;
                     PivotY: string;
@@ -148,29 +80,24 @@ declare const FollowSystem_base: import("elics").SystemConstructor<import("elics
                 };
                 default: string;
             };
-            /** Degrees of allowable angular deviation before target snaps forward. */
             maxAngle: {
-                type: Types.Float32;
+                type: import("elics").Types.Float32;
                 default: number;
             };
-            /** Meters of allowable positional slack before catching up. */
             tolerance: {
-                type: Types.Float32;
+                type: import("elics").Types.Float32;
                 default: number;
             };
-            /** Lerp speed towards the target position. */
             speed: {
-                type: Types.Float32;
+                type: import("elics").Types.Float32;
                 default: number;
             };
-            /** Internal: one‑time sync to jump to the target position. */
             needsPositionSync: {
-                type: Types.Boolean;
+                type: import("elics").Types.Boolean;
                 default: true;
             };
-            /** Internal: smoothed follow target in world space. */
             _followTarget: {
-                type: Types.Vec3;
+                type: import("elics").Types.Vec3;
                 default: [number, number, number];
             };
         }>[];
@@ -193,5 +120,4 @@ export declare class FollowSystem extends FollowSystem_base {
     private euler;
     update(delta: number): void;
 }
-export {};
 //# sourceMappingURL=follow.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"follow.d.ts","sourceRoot":"","sources":["../../src/ui/follow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAU7D,wDAAwD;AACxD,eAAO,MAAM,cAAc;;;;CAI1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,QAAQ;IAGjB,oDAAoD;;;;;IAEpD,0DAA0D;;;;;;;;;;;;;;IAO1D,0EAA0E;;;;;IAE1E,+DAA+D;;;;;IAE/D,8CAA8C;;;;;IAE9C,8DAA8D;;;;;IAE9D,uDAAuD;;;;;EAI1D,CAAC;;;;YArBE,oDAAoD;;;;;YAEpD,0DAA0D;;;;;;;;;;;;;;YAO1D,0EAA0E;;;;;YAE1E,+DAA+D;;;;;YAE/D,8CAA8C;;;;;YAE9C,8DAA8D;;;;;YAE9D,uDAAuD;;;;;;;;;;YAjBvD,oDAAoD;;;;;YAEpD,0DAA0D;;;;;;;;;;;;;;YAO1D,0EAA0E;;;;;YAE1E,+DAA+D;;;;;YAE/D,8CAA8C;;;;;YAE9C,8DAA8D;;;;;YAE9D,uDAAuD;;;;;;;;AAM3D;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,iBAEhC;IACA,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,kBAAkB,CAAiB;IAC3C,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,gBAAgB,CAAiB;IACzC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,KAAK,CAAe;IAE5B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAuE5B"}
+{"version":3,"file":"follow.d.ts","sourceRoot":"","sources":["../../src/ui/follow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,iBAEhC;IACA,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,kBAAkB,CAAiB;IAC3C,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,gBAAgB,CAAiB;IACzC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,KAAK,CAAe;IAE5B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAqE5B"}

package/dist/ui/follow.js

@@ -1,6 +1,6 @@
-import { createComponent, Types } from 'elics';
 import { createSystem } from '../ecs/system.js';
 import '../runtime/three.js';
+import { Follower, FollowBehavior } from './follow-component.js';
 import { Vector3, Quaternion, Euler, MathUtils } from 'three';
 
 /**
@@ -9,53 +9,15 @@ import { Vector3, Quaternion, Euler, MathUtils } from 'three';
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/** Behavior modes for {@link Follower}. @category UI */
-const FollowBehavior = {
-    FaceTarget: 'face-target',
-    PivotY: 'pivot-y',
-    NoRotation: 'no-rotation',
-};
 /**
- * Makes an entity follow a target `Object3D` with optional rotation behavior.
- *
- * @remarks
- * - `PivotY` keeps the follower level while rotating around the Y axis to face the target.
- * - `FaceTarget` fully rotates to look at the target.
- * - `NoRotation` only moves position.
- *
- * @example Attach to an entity to follow the HMD at shoulder‑height
- * ```ts
- * entity.addComponent(Follower, {
- *   target: xrRig.head,
- *   offsetPosition: [0.25, -0.2, -0.35],
- *   behavior: FollowBehavior.PivotY,
- *   speed: 5,
- *   tolerance: 0.3,
- * })
- * ```
- * @category UI
+ * Angle in degrees from the dot product of two unit vectors, robust to
+ * floating-point error. A normalized dot product can land slightly outside
+ * [-1, 1] (e.g. 1.0000001), which makes `Math.acos` return `NaN`; that `NaN`
+ * would then poison the follow re-target comparison. Clamp before `acos`.
  */
-const Follower = createComponent('Follower', {
-    /** Object to follow (e.g., `world.player.head`). */
-    target: { type: Types.Object, default: undefined },
-    /** Offset from the target in the target's local space. */
-    offsetPosition: { type: Types.Vec3, default: [0, 0, 0] },
-    behavior: {
-        type: Types.Enum,
-        enum: FollowBehavior,
-        default: FollowBehavior.PivotY,
-    },
-    /** Degrees of allowable angular deviation before target snaps forward. */
-    maxAngle: { type: Types.Float32, default: 30 },
-    /** Meters of allowable positional slack before catching up. */
-    tolerance: { type: Types.Float32, default: 0.4 },
-    /** Lerp speed towards the target position. */
-    speed: { type: Types.Float32, default: 1 },
-    /** Internal: one‑time sync to jump to the target position. */
-    needsPositionSync: { type: Types.Boolean, default: true },
-    /** Internal: smoothed follow target in world space. */
-    _followTarget: { type: Types.Vec3, default: [0, 0, 0] },
-}, 'Component for following another object');
+function clampedAcosDeg(dot) {
+    return MathUtils.radToDeg(Math.acos(MathUtils.clamp(dot, -1, 1)));
+}
 /**
  * Updates entities with {@link Follower} to chase a target using smoothed motion,
  * with constraints on angle and distance.
@@ -116,7 +78,7 @@ class FollowSystem extends createSystem({
                 const distance = object.parent
                     .worldToLocal(this.strictFollowTarget)
                     .distanceTo(this.followTarget);
-                const deltaAngle = MathUtils.radToDeg(Math.acos(this.targetForward.normalize().dot(this.deltaVec3.normalize())));
+                const deltaAngle = clampedAcosDeg(this.targetForward.normalize().dot(this.deltaVec3.normalize()));
                 if (distance > entity.getValue(Follower, 'tolerance') ||
                     deltaAngle > entity.getValue(Follower, 'maxAngle')) {
                     this.followTarget
@@ -137,5 +99,5 @@ class FollowSystem extends createSystem({
     }
 }
 
-export { FollowBehavior, FollowSystem, Follower };
+export { FollowBehavior, FollowSystem, Follower, clampedAcosDeg };
 //# sourceMappingURL=follow.js.map

package/dist/ui/follow.js.map

@@ -1 +1 @@
-{"version":3,"file":"follow.js","sources":["../../src/ui/follow.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"follow.js","sources":["../../src/ui/follow.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAAA;;;;;AAKG;AAcH;;;;;AAKG;AACG,SAAU,cAAc,CAAC,GAAW,EAAA;IACxC,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACnE;AAEA;;;;;AAKG;AACG,MAAO,YAAa,SAAQ,YAAY,CAAC;AAC7C,IAAA,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;CACnC,CAAC,CAAA;AAFF,IAAA,WAAA,GAAA;;AAGU,QAAA,IAAA,CAAA,YAAY,GAAG,IAAI,OAAO,EAAE;AAC5B,QAAA,IAAA,CAAA,kBAAkB,GAAG,IAAI,OAAO,EAAE;AAClC,QAAA,IAAA,CAAA,SAAS,GAAG,IAAI,OAAO,EAAE;AACzB,QAAA,IAAA,CAAA,cAAc,GAAG,IAAI,OAAO,EAAE;AAC9B,QAAA,IAAA,CAAA,gBAAgB,GAAG,IAAI,OAAO,EAAE;AAChC,QAAA,IAAA,CAAA,aAAa,GAAG,IAAI,OAAO,EAAE;AAC7B,QAAA,IAAA,CAAA,IAAI,GAAG,IAAI,UAAU,EAAE;AACvB,QAAA,IAAA,CAAA,KAAK,GAAG,IAAI,KAAK,EAAE;IAuE7B;AArEE,IAAA,MAAM,CAAC,KAAa,EAAA;AAClB,QAAA,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,KAAI;AAChD,YAAA,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ;YAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAa;YAC9D,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;gBACxC;YACF;YACA,MAAM,mBAAmB,GAAG,MAAM,CAAC,aAAa,CAC9C,QAAQ,EACR,eAAe,CAChB;AACD,YAAA,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,mBAAmB,CAAC;YAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;YACtD,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC;AACvE,YAAA,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;AACpC,YAAA,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC;AAC5C,YAAA,IAAI,QAAQ,KAAK,cAAc,CAAC,MAAM,EAAE;gBACtC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;AAC9C,gBAAA,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;AAChB,gBAAA,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;gBAChB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;YACpC;AACA,YAAA,IAAI,CAAC;iBACF,SAAS,CAAC,cAAc;AACxB,iBAAA,eAAe,CAAC,IAAI,CAAC,IAAI;AACzB,iBAAA,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC;AAC3B,YAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;AAC3D,YAAA,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC;AAChE,YAAA,IAAI,QAAQ,KAAK,cAAc,CAAC,MAAM,EAAE;AACtC,gBAAA,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC;AACxB,gBAAA,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC;gBACpB,IAAI,CAAC,kBAAkB,CAAC,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YACnD;YACA,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC,EAAE;AAClD,gBAAA,MAAM,CAAC;AACJ,qBAAA,IAAI,CAAC,IAAI,CAAC,kBAAkB;qBAC5B,OAAO,CAAC,mBAAmB,CAAC;gBAC/B,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,EAAE,KAAK,CAAC;YACvD;iBAAO;AACL,gBAAA,MAAM,QAAQ,GAAG,MAAM,CAAC;AACrB,qBAAA,YAAY,CAAC,IAAI,CAAC,kBAAkB;AACpC,qBAAA,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC;gBAChC,MAAM,UAAU,GAAG,cAAc,CAC/B,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAC/D;gBACD,IACE,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAE;oBAClD,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAE,EACnD;AACA,oBAAA,IAAI,CAAC;AACF,yBAAA,IAAI,CAAC,IAAI,CAAC,kBAAkB;yBAC5B,OAAO,CAAC,mBAAmB,CAAC;gBACjC;gBACA,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;AAChD,gBAAA,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,KAAM,CAAC;YACzD;AACA,YAAA,IACE,QAAQ,KAAK,cAAc,CAAC,UAAU;AACtC,gBAAA,QAAQ,KAAK,cAAc,CAAC,MAAM,EAClC;AACA,gBAAA,IAAI,QAAQ,KAAK,cAAc,CAAC,MAAM,EAAE;AACtC,oBAAA,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAC7C,IAAI,CAAC,gBAAgB,CACtB,CAAC,CAAC;gBACL;AACA,gBAAA,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;YACpC;AACF,QAAA,CAAC,CAAC;IACJ;AACD;;;;"}

package/dist/ui/index.d.ts

@@ -11,8 +11,11 @@
  * @category UI
  */
 export { UIKitDocument } from './document.js';
+export { UIKitMLAsset, findUIKitDocument } from './uikitml-asset.js';
 export { PanelUI, PanelDocument, PanelUISystem, ColorSchemeType, } from './ui.js';
 export type { PanelUIProps, ColorScheme } from './ui.js';
+export type { UIKitMLComponentSet, UIKitMLKit, UIKitMLLoadOptions, } from './uikitml.js';
+export { DEFAULT_UIKITML_KIT, configureUIKitRenderer, loadUIKitMLAsset, loadUIKitMLComponent, parseUIKitMLSource, } from './uikitml.js';
 export * from './follow.js';
 export * from './screenspace.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EACL,OAAO,EACP,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGzD,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGrE,OAAO,EACL,OAAO,EACP,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACzD,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/dist/ui/panel-components.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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 ColorSchemeType: {
+    readonly System: "system";
+    readonly Light: "light";
+    readonly Dark: "dark";
+};
+export type ColorScheme = (typeof ColorSchemeType)[keyof typeof ColorSchemeType];
+export interface PanelUIProps {
+    config: string;
+}
+export declare const PanelUI: import("elics").Component<{
+    config: {
+        type: Types.String;
+        default: string;
+    };
+}>;
+export declare const PanelDocument: import("elics").Component<{
+    document: {
+        type: Types.Object;
+        default: undefined;
+    };
+}>;
+//# sourceMappingURL=panel-components.d.ts.map

package/dist/ui/panel-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-components.d.ts","sourceRoot":"","sources":["../../src/ui/panel-components.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAE7D,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,MAAM,MAAM,WAAW,GACrB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,OAAO;;;;;EAMnB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;EAMzB,CAAC"}

package/dist/ui/panel-components.js

@@ -0,0 +1,22 @@
+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 ColorSchemeType = {
+    System: 'system',
+    Light: 'light',
+    Dark: 'dark',
+};
+const PanelUI = createComponent('PanelUI', {
+    config: { type: Types.String, default: '' },
+}, 'Component for 3D panel UI elements backed by a UIKitML file');
+const PanelDocument = createComponent('PanelDocument', {
+    document: { type: Types.Object, default: undefined },
+}, 'Internal component containing loaded UI document');
+
+export { ColorSchemeType, PanelDocument, PanelUI };
+//# sourceMappingURL=panel-components.js.map

package/dist/ui/panel-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-components.js","sources":["../../src/ui/panel-components.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AAII,MAAM,eAAe,GAAG;AAC7B,IAAA,MAAM,EAAE,QAAQ;AAChB,IAAA,KAAK,EAAE,OAAO;AACd,IAAA,IAAI,EAAE,MAAM;;AAUP,MAAM,OAAO,GAAG,eAAe,CACpC,SAAS,EACT;IACE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;CAC5C,EACD,6DAA6D;AAGxD,MAAM,aAAa,GAAG,eAAe,CAC1C,eAAe,EACf;IACE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;CACrD,EACD,kDAAkD;;;;"}

package/dist/ui/screenspace-component.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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';
+/** CSS-like screen-space layout for a PanelUI. */
+export declare const ScreenSpace: import("elics").Component<{
+    height: {
+        type: Types.String;
+        default: string;
+    };
+    width: {
+        type: Types.String;
+        default: string;
+    };
+    top: {
+        type: Types.String;
+        default: string;
+    };
+    bottom: {
+        type: Types.String;
+        default: string;
+    };
+    left: {
+        type: Types.String;
+        default: string;
+    };
+    right: {
+        type: Types.String;
+        default: string;
+    };
+    zOffset: {
+        type: Types.Float32;
+        default: number;
+    };
+}>;
+//# sourceMappingURL=screenspace-component.d.ts.map

package/dist/ui/screenspace-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenspace-component.d.ts","sourceRoot":"","sources":["../../src/ui/screenspace-component.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,qBAAqB,CAAC;AAE7D,kDAAkD;AAClD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYvB,CAAC"}

package/dist/ui/screenspace-component.js

@@ -0,0 +1,21 @@
+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.
+ */
+/** CSS-like screen-space layout for a PanelUI. */
+const ScreenSpace = createComponent('ScreenSpace', {
+    height: { type: Types.String, default: '25vh' },
+    width: { type: Types.String, default: '25vw' },
+    top: { type: Types.String, default: 'auto' },
+    bottom: { type: Types.String, default: 'auto' },
+    left: { type: Types.String, default: 'auto' },
+    right: { type: Types.String, default: 'auto' },
+    zOffset: { type: Types.Float32, default: 0.2 },
+}, 'Component for screen-space UI positioning');
+
+export { ScreenSpace };
+//# sourceMappingURL=screenspace-component.js.map

package/dist/ui/screenspace-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenspace-component.js","sources":["../../src/ui/screenspace-component.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AAIH;AACO,MAAM,WAAW,GAAG,eAAe,CACxC,aAAa,EACb;IACE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC/C,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC9C,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC/C,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC7C,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC9C,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;CAC/C,EACD,2CAA2C;;;;"}