@iwsdk/core 0.1.0

package/dist/ui/document.js

@@ -0,0 +1,298 @@
+import { Component } from '@pmndrs/uikit';
+import { signal } from '@preact/signals-core';
+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.
+ */
+/**
+ * Lightweight DOM-like wrapper around a UIKit root `Component` that lives in the 3D scene.
+ *
+ * @remarks
+ * - Provides query helpers (`getElementById`, `getElementsByClassName`, `querySelector(All)`).
+ * - Maintains reactive target dimensions via {@link targetWidth}/{@link targetHeight} and
+ *   scales the group to fit while preserving aspect ratio.
+ * - Intended to be attached to an entity's `object3D` in world space or to the `camera` for
+ *   screen‑space UI. Use together with {@link PanelUISystem} and {@link ScreenSpaceUISystem}.
+ *
+ * @category UI
+ */
+class UIKitDocument extends Group {
+    /**
+     * Create a document backed by a UIKit root component.
+     * @param rootComponent The root `Component` produced by `@pmndrs/uikitml` `interpret()`.
+     */
+    constructor(rootComponent) {
+        super();
+        this.elementMap = new Map();
+        this.classMap = new Map();
+        this._abortController = new AbortController();
+        /** Reactive target width in meters. Set via {@link setTargetDimensions}. */
+        this.targetWidth = signal(0);
+        /** Reactive target height in meters. Set via {@link setTargetDimensions}. */
+        this.targetHeight = signal(0);
+        this._rootElement = rootComponent;
+        this.add(this._rootElement);
+        this.indexElements(rootComponent);
+        this.setupReactiveResizing();
+    }
+    /**
+     * Return the first element with a matching `id` (UIKit property).
+     * @param id The element identifier without the `#` prefix.
+     */
+    getElementById(id) {
+        return this.elementMap.get(id) || null;
+    }
+    /**
+     * Return all elements that include `className` in their class list.
+     * @param className The class without the preceding dot.
+     */
+    getElementsByClassName(className) {
+        return this.classMap.get(className) || [];
+    }
+    /**
+     * Return the first element matching a simple CSS‑like selector.
+     *
+     * @remarks
+     * Supported selectors:
+     * - `#id`
+     * - `.class`
+     * - Descendant combinations, e.g. `#parent .child`
+     */
+    querySelector(selector) {
+        const results = this.querySelectorAll(selector);
+        return results.length > 0 ? results[0] : null;
+    }
+    /**
+     * Return all elements matching a simple CSS‑like selector. See {@link querySelector}.
+     */
+    querySelectorAll(selector) {
+        // Handle descendant selectors (e.g., "#parent .child")
+        if (selector.includes(' ')) {
+            return this.parseDescendantSelector(selector);
+        }
+        // Handle simple selectors
+        if (selector.startsWith('#')) {
+            const element = this.getElementById(selector.substring(1));
+            return element ? [element] : [];
+        }
+        if (selector.startsWith('.')) {
+            return this.getElementsByClassName(selector.substring(1));
+        }
+        return [];
+    }
+    /** Parse descendant selectors like `#parent .child`. */
+    parseDescendantSelector(selector) {
+        const parts = selector.trim().split(/\s+/);
+        if (parts.length < 2) {
+            return [];
+        }
+        // Start with elements matching the first selector
+        let currentElements = this.querySelectorAll(parts[0]);
+        // For each subsequent selector part, find descendants
+        for (let i = 1; i < parts.length; i++) {
+            const nextSelector = parts[i];
+            const descendants = [];
+            for (const parent of currentElements) {
+                const childMatches = this.findDescendants(parent, nextSelector);
+                descendants.push(...childMatches);
+            }
+            currentElements = descendants;
+            if (currentElements.length === 0) {
+                break;
+            }
+        }
+        return currentElements;
+    }
+    /** Find all descendants of a parent that match a selector. */
+    findDescendants(parent, selector) {
+        const results = [];
+        this.searchDescendants(parent, selector, results);
+        return results;
+    }
+    /** Recursively search for descendants matching a selector. */
+    searchDescendants(parent, selector, results) {
+        for (const child of parent.children) {
+            if (child instanceof Component) {
+                if (this.matchesSelector(child, selector)) {
+                    results.push(child);
+                }
+            }
+            // Continue searching in children regardless of whether current child matched
+            this.searchDescendants(child, selector, results);
+        }
+    }
+    /** Check if a component matches a simple selector (`#id` or `.class`). */
+    matchesSelector(component, selector) {
+        var _a, _b, _c, _d;
+        if (selector.startsWith('#')) {
+            const id = (_c = (_b = (_a = component.properties) === null || _a === void 0 ? void 0 : _a.signal) === null || _b === void 0 ? void 0 : _b.id) === null || _c === void 0 ? void 0 : _c.value;
+            return id === selector.substring(1);
+        }
+        if (selector.startsWith('.')) {
+            const className = selector.substring(1);
+            const classList = component.classList
+                ? ((_d = component.classList.list) === null || _d === void 0 ? void 0 : _d.filter((c) => typeof c === 'string')) || []
+                : [];
+            return classList.includes(className);
+        }
+        return false;
+    }
+    /**
+     * Check if `element` is a descendant of `ancestor`.
+     * @returns `true` if `ancestor` appears in the parent chain of `element`.
+     */
+    isDescendantOf(element, ancestor) {
+        let current = element.parent;
+        while (current) {
+            if (current === ancestor) {
+                return true;
+            }
+            current = current.parent;
+        }
+        return false;
+    }
+    /** Convenience for `querySelectorAll("${parent} ${child}")`. */
+    querySelectorAllWithin(parentSelector, childSelector) {
+        return this.querySelectorAll(`${parentSelector} ${childSelector}`);
+    }
+    /** Convenience for the first match of `querySelectorAllWithin`. */
+    querySelectorWithin(parentSelector, childSelector) {
+        return this.querySelector(`${parentSelector} ${childSelector}`);
+    }
+    /** Set up reactivity that rescales the group when size or target changes. */
+    setupReactiveResizing() {
+        var _a;
+        const abortSignal = this._abortController.signal;
+        // React to changes in target dimensions or root component size to apply scaling
+        const targetWidthUnsubscribe = this.targetWidth.subscribe(() => this.updateScaling());
+        const targetHeightUnsubscribe = this.targetHeight.subscribe(() => this.updateScaling());
+        const sizeUnsubscribe = (_a = this._rootElement.size) === null || _a === void 0 ? void 0 : _a.subscribe(() => this.updateScaling());
+        abortSignal.addEventListener('abort', () => {
+            targetWidthUnsubscribe();
+            targetHeightUnsubscribe();
+            sizeUnsubscribe === null || sizeUnsubscribe === void 0 ? void 0 : sizeUnsubscribe();
+        });
+    }
+    /** Compute uniform scale to fit the target width/height while preserving aspect ratio. */
+    updateScaling() {
+        var _a;
+        const targetWorldWidth = this.targetWidth.value;
+        const targetWorldHeight = this.targetHeight.value;
+        const uiNaturalSize = (_a = this._rootElement.size) === null || _a === void 0 ? void 0 : _a.value;
+        if (targetWorldWidth > 0 &&
+            targetWorldHeight > 0 &&
+            uiNaturalSize &&
+            Array.isArray(uiNaturalSize) &&
+            uiNaturalSize.length >= 2) {
+            const [uiWidth, uiHeight] = uiNaturalSize;
+            if (typeof uiWidth === 'number' &&
+                typeof uiHeight === 'number' &&
+                uiWidth > 0 &&
+                uiHeight > 0) {
+                // Convert UIKit dimensions to world space units (UIKit uses cm units)
+                const uiWidthInWorldUnits = uiWidth / 100;
+                const uiHeightInWorldUnits = uiHeight / 100;
+                const scaleX = targetWorldWidth / uiWidthInWorldUnits;
+                const scaleY = targetWorldHeight / uiHeightInWorldUnits;
+                const optimalScale = Math.min(scaleX, scaleY);
+                // Apply scale to the Group (this), not the root element
+                this.scale.setScalar(optimalScale);
+            }
+        }
+    }
+    /**
+     * Set desired dimensions for the UI in meters. The document computes a uniform scale
+     * that fits these constraints while preserving aspect ratio.
+     * @param width Target width in meters.
+     * @param height Target height in meters.
+     */
+    setTargetDimensions(width, height) {
+        this.targetWidth.value = width;
+        this.targetHeight.value = height;
+    }
+    /**
+     * Current intrinsic size of the UIKit root component (in UIKit units, centimeters),
+     * if available from the underlying component's `size` signal.
+     */
+    get computedSize() {
+        var _a;
+        const sizeValue = (_a = this._rootElement.size) === null || _a === void 0 ? void 0 : _a.value;
+        if (sizeValue && Array.isArray(sizeValue) && sizeValue.length >= 2) {
+            const [width, height] = sizeValue;
+            if (typeof width === 'number' && typeof height === 'number') {
+                return { width, height };
+            }
+        }
+        return null;
+    }
+    /** Return the most recently requested target size in meters. */
+    get targetSize() {
+        return {
+            width: this.targetWidth.value,
+            height: this.targetHeight.value,
+        };
+    }
+    /** The root UIKit component for this document. */
+    get rootElement() {
+        return this._rootElement;
+    }
+    /**
+     * Dispose of internal resources and detach children. Safe to call multiple times.
+     */
+    dispose() {
+        // Abort all effects to clean up signal subscriptions
+        this._abortController.abort();
+        // Dispose of the root UIKit Component which will clean up all resources
+        if (this._rootElement && typeof this._rootElement.dispose === 'function') {
+            this._rootElement.dispose();
+        }
+        // Remove root element from this Group
+        this.remove(this._rootElement);
+        // Clear internal maps
+        this.elementMap.clear();
+        this.classMap.clear();
+    }
+    /** String summary useful for debugging. */
+    toString() {
+        const elementCount = this.elementMap.size;
+        const classCount = this.classMap.size;
+        const computed = this.computedSize;
+        const target = this.targetSize;
+        return `UIKitDocument { elements: ${elementCount}, classes: ${classCount}, computed: ${computed ? `${computed.width}x${computed.height}` : 'none'}, target: ${target.width}x${target.height} }`;
+    }
+    /** Index IDs and classes for DOM‑like queries. */
+    indexElements(object) {
+        var _a, _b, _c, _d;
+        // Only index UIKit Components, not all Object3Ds
+        if (object instanceof Component) {
+            // Access id from UIKit's properties system
+            const id = (_c = (_b = (_a = object.properties) === null || _a === void 0 ? void 0 : _a.signal) === null || _b === void 0 ? void 0 : _b.id) === null || _c === void 0 ? void 0 : _c.value;
+            // Access classes from UIKit's ClassList - work around iterator bug by accessing private list
+            const classList = object.classList
+                ? ((_d = object.classList.list) === null || _d === void 0 ? void 0 : _d.filter((c) => typeof c === 'string')) || []
+                : [];
+            // Index by ID
+            if (id) {
+                this.elementMap.set(id, object);
+            }
+            // Index by class names
+            for (const className of classList) {
+                if (!this.classMap.has(className)) {
+                    this.classMap.set(className, []);
+                }
+                this.classMap.get(className).push(object);
+            }
+        }
+        // Recursively index children
+        for (const child of object.children) {
+            this.indexElements(child);
+        }
+    }
+}
+
+export { UIKitDocument };
+//# sourceMappingURL=document.js.map

package/dist/ui/document.js.map

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

package/dist/ui/follow.d.ts

@@ -0,0 +1,197 @@
+/**
+ * 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/index.js';
+/** Behavior modes for {@link Follower}. @category UI */
+export declare const FollowBehavior: {
+    FaceTarget: string;
+    PivotY: string;
+    NoRotation: string;
+};
+/**
+ * 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
+ */
+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];
+    };
+}>;
+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;
+                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];
+            };
+        }>[];
+    };
+}, import("../ecs/world.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;
+                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];
+            };
+        }>[];
+    };
+}>>;
+/**
+ * Updates entities with {@link Follower} to chase a target using smoothed motion,
+ * with constraints on angle and distance.
+ *
+ * @category UI
+ */
+export declare class FollowSystem extends FollowSystem_base {
+    private followTarget;
+    private strictFollowTarget;
+    private deltaVec3;
+    private targetPosition;
+    private followerPosition;
+    private targetForward;
+    private quat;
+    private euler;
+    update(delta: number): void;
+}
+export {};
+//# sourceMappingURL=follow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"follow.d.ts","sourceRoot":"","sources":["../../src/ui/follow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAiC,MAAM,iBAAiB,CAAC;AASvE,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"}

package/dist/ui/follow.js

@@ -0,0 +1,143 @@
+import { createSystem } from '../ecs/system.js';
+import '../ecs/world.js';
+import { createComponent, Types } from 'elics';
+import '../ecs/component-registry.js';
+import '../runtime/three.js';
+import { Vector3, Quaternion, Euler, MathUtils } 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.
+ */
+/** 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
+ */
+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');
+/**
+ * Updates entities with {@link Follower} to chase a target using smoothed motion,
+ * with constraints on angle and distance.
+ *
+ * @category UI
+ */
+class FollowSystem extends createSystem({
+    follower: { required: [Follower] },
+}) {
+    constructor() {
+        super(...arguments);
+        this.followTarget = new Vector3();
+        this.strictFollowTarget = new Vector3();
+        this.deltaVec3 = new Vector3();
+        this.targetPosition = new Vector3();
+        this.followerPosition = new Vector3();
+        this.targetForward = new Vector3();
+        this.quat = new Quaternion();
+        this.euler = new Euler();
+    }
+    update(delta) {
+        this.queries.follower.entities.forEach((entity) => {
+            const object = entity.object3D;
+            const target = entity.getValue(Follower, 'target');
+            if (!object || !target || !object.parent) {
+                return;
+            }
+            const followTargetVecView = entity.getVectorView(Follower, '_followTarget');
+            this.followTarget.fromArray(followTargetVecView);
+            const behavior = entity.getValue(Follower, 'behavior');
+            const offsetPosition = entity.getVectorView(Follower, 'offsetPosition');
+            target.getWorldQuaternion(this.quat);
+            target.getWorldPosition(this.targetPosition);
+            if (behavior === FollowBehavior.PivotY) {
+                this.euler.setFromQuaternion(this.quat, 'YXZ');
+                this.euler.x = 0;
+                this.euler.z = 0;
+                this.quat.setFromEuler(this.euler);
+            }
+            this.strictFollowTarget
+                .fromArray(offsetPosition)
+                .applyQuaternion(this.quat)
+                .add(this.targetPosition);
+            this.targetForward.set(0, 0, -1).applyQuaternion(this.quat);
+            object.getWorldPosition(this.deltaVec3).sub(this.targetPosition);
+            if (behavior === FollowBehavior.PivotY) {
+                this.targetForward.y = 0;
+                this.deltaVec3.y = 0;
+                this.strictFollowTarget.y = this.targetPosition.y;
+            }
+            if (entity.getValue(Follower, 'needsPositionSync')) {
+                object.position
+                    .copy(this.strictFollowTarget)
+                    .toArray(followTargetVecView);
+                entity.setValue(Follower, 'needsPositionSync', false);
+            }
+            else {
+                const distance = object.parent
+                    .worldToLocal(this.strictFollowTarget)
+                    .distanceTo(this.followTarget);
+                const deltaAngle = MathUtils.radToDeg(Math.acos(this.targetForward.normalize().dot(this.deltaVec3.normalize())));
+                if (distance > entity.getValue(Follower, 'tolerance') ||
+                    deltaAngle > entity.getValue(Follower, 'maxAngle')) {
+                    this.followTarget
+                        .copy(this.strictFollowTarget)
+                        .toArray(followTargetVecView);
+                }
+                const speed = entity.getValue(Follower, 'speed');
+                object.position.lerp(this.followTarget, delta * speed);
+            }
+            if (behavior === FollowBehavior.FaceTarget ||
+                behavior === FollowBehavior.PivotY) {
+                if (behavior === FollowBehavior.PivotY) {
+                    this.targetPosition.y = object.getWorldPosition(this.followerPosition).y;
+                }
+                object.lookAt(this.targetPosition);
+            }
+        });
+    }
+}
+
+export { FollowBehavior, FollowSystem, Follower };
+//# sourceMappingURL=follow.js.map

package/dist/ui/follow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow.js","sources":["../../src/ui/follow.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAAA;;;;;AAKG;AAWH;AACO,MAAM,cAAc,GAAG;AAC5B,IAAA,UAAU,EAAE,aAAa;AACzB,IAAA,MAAM,EAAE,SAAS;AACjB,IAAA,UAAU,EAAE,aAAa;;AAG3B;;;;;;;;;;;;;;;;;;;AAmBG;AACI,MAAM,QAAQ,GAAG,eAAe,CACrC,UAAU,EACV;;IAEE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;;AAElD,IAAA,cAAc,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;AACxD,IAAA,QAAQ,EAAE;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,cAAc,CAAC,MAAM;AAC/B,KAAA;;IAED,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;;IAE9C,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;;IAEhD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE;;IAE1C,iBAAiB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;;AAEzD,IAAA,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;CACxD,EACD,wCAAwC;AAG1C;;;;;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;IAyE7B;AAvEE,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;AAChC,gBAAA,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CACnC,IAAI,CAAC,IAAI,CACP,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAC/D,CACF;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;;;;"}