@iwsdk/core 0.2.2 → 0.3.1

package/dist/environment-raycast/environment-raycast.js

@@ -0,0 +1,333 @@
+import { createSystem } from '../ecs/system.js';
+import '../ecs/world.js';
+import 'elics';
+import '../ecs/entity.js';
+import '../ecs/component-registry.js';
+import '../runtime/three.js';
+import '../transform/transform.js';
+import { setWorldPosition, setWorldQuaternion } from '../transform/transform-utils.js';
+import { EnvironmentRaycastTarget, RaycastSpace } from './raycast-target.js';
+import { Matrix4, Vector3, Quaternion } 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.
+ */
+// Reusable math objects to avoid allocations
+const tempMatrix = new Matrix4();
+const tempPosition = new Vector3();
+const tempQuaternion = new Quaternion();
+const tempWorldQuaternion = new Quaternion();
+const tempScale = new Vector3();
+const tempNormal = new Vector3();
+const tempRayOrigin = new Vector3();
+const tempDirection = new Vector3();
+const upVector = new Vector3(0, 1, 0);
+const defaultDirection = new Vector3(0, 0, -1);
+/**
+ * System that manages environment raycasting.
+ * @category Environment Raycast
+ */
+class EnvironmentRaycastSystem extends createSystem({
+    targets: { required: [EnvironmentRaycastTarget] },
+}) {
+    constructor() {
+        super(...arguments);
+        this.pendingControllerSources = new Map();
+    }
+    init() {
+        this.xrManager.addEventListener('sessionstart', () => {
+            this.updateEnabledFeatures(this.xrManager.getSession());
+        });
+        this.xrManager.addEventListener('sessionend', () => {
+            this.queries.targets.entities.forEach((entity) => {
+                this.cleanupRaycastSource(entity);
+            });
+            this.hitTestFeatureEnabled = undefined;
+            this.pendingControllerSources.clear();
+        });
+        // Automatic cleanup when component is removed
+        this.queries.targets.subscribe('disqualify', (entity) => {
+            this.cleanupRaycastSource(entity);
+        });
+    }
+    update(_delta, _time) {
+        const frame = this.xrFrame;
+        const session = this.xrManager.getSession();
+        const referenceSpace = this.xrManager.getReferenceSpace();
+        if (!this.hitTestFeatureEnabled || !frame || !session || !referenceSpace) {
+            return;
+        }
+        this.checkPendingControllerSources(session, referenceSpace);
+        this.queries.targets.entities.forEach((entity) => {
+            const space = entity.getValue(EnvironmentRaycastTarget, 'space');
+            if (space === RaycastSpace.Screen) {
+                this.handleTransientInput(entity, session, frame, referenceSpace);
+            }
+            else {
+                this.handleStandardRaycast(entity, session, frame, referenceSpace);
+            }
+        });
+    }
+    handleStandardRaycast(entity, session, frame, referenceSpace) {
+        const source = entity.getValue(EnvironmentRaycastTarget, '_source');
+        const sourceRequested = entity.getValue(EnvironmentRaycastTarget, '_sourceRequested');
+        if (!source && !sourceRequested) {
+            this.requestRaycastSource(entity, session, referenceSpace);
+            return;
+        }
+        if (source) {
+            this.updateRaycastResults(entity, frame, referenceSpace);
+        }
+    }
+    handleTransientInput(entity, session, frame, referenceSpace) {
+        const transientSource = entity.getValue(EnvironmentRaycastTarget, '_transientSource');
+        const sourceRequested = entity.getValue(EnvironmentRaycastTarget, '_sourceRequested');
+        if (!transientSource && !sourceRequested) {
+            this.requestTransientRaycastSource(entity, session);
+            return;
+        }
+        if (transientSource) {
+            this.updateTransientRaycastResults(entity, frame, referenceSpace, transientSource);
+        }
+    }
+    checkPendingControllerSources(session, referenceSpace) {
+        if (this.pendingControllerSources.size === 0) {
+            return;
+        }
+        for (const [entity, handedness] of this.pendingControllerSources) {
+            const inputSource = this.input.getPrimaryInputSource(handedness);
+            if (inputSource) {
+                this.pendingControllerSources.delete(entity);
+                entity.setValue(EnvironmentRaycastTarget, '_sourceRequested', false);
+                this.requestRaycastSource(entity, session, referenceSpace);
+            }
+        }
+    }
+    updateEnabledFeatures(xrSession) {
+        var _a;
+        if (!xrSession) {
+            return;
+        }
+        this.hitTestFeatureEnabled =
+            (_a = xrSession.enabledFeatures) === null || _a === void 0 ? void 0 : _a.includes('hit-test');
+        if (!this.hitTestFeatureEnabled) {
+            console.warn('[EnvironmentRaycastSystem] hit-test feature not enabled.');
+        }
+    }
+    async requestRaycastSource(entity, session, _referenceSpace) {
+        if (!session.requestHitTestSource) {
+            return;
+        }
+        entity.setValue(EnvironmentRaycastTarget, '_sourceRequested', true);
+        try {
+            const space = entity.getValue(EnvironmentRaycastTarget, 'space');
+            const xrSpace = await this.resolveXRSpace(entity, space, session);
+            if (!xrSpace) {
+                return;
+            }
+            // Build offsetRay from component properties
+            const offsetRay = this.buildOffsetRay(entity);
+            const source = await session.requestHitTestSource({
+                space: xrSpace,
+                offsetRay,
+            });
+            entity.setValue(EnvironmentRaycastTarget, '_source', source);
+            entity.setValue(EnvironmentRaycastTarget, '_raySpace', xrSpace);
+            entity.setValue(EnvironmentRaycastTarget, '_sourceRequested', false);
+        }
+        catch (error) {
+            console.error('[EnvironmentRaycastSystem] Failed to create source:', error);
+            entity.setValue(EnvironmentRaycastTarget, '_sourceRequested', false);
+        }
+    }
+    buildOffsetRay(entity) {
+        const offsetPosition = entity.getValue(EnvironmentRaycastTarget, 'offsetPosition');
+        const offsetQuaternion = entity.getValue(EnvironmentRaycastTarget, 'offsetQuaternion');
+        // Calculate direction from quaternion (apply to default -Z direction)
+        if (offsetQuaternion) {
+            tempDirection.copy(defaultDirection).applyQuaternion(offsetQuaternion);
+        }
+        else {
+            tempDirection.copy(defaultDirection);
+        }
+        const origin = offsetPosition
+            ? new DOMPointReadOnly(offsetPosition.x, offsetPosition.y, offsetPosition.z, 1)
+            : new DOMPointReadOnly(0, 0, 0, 1);
+        const direction = new DOMPointReadOnly(tempDirection.x, tempDirection.y, tempDirection.z, 0);
+        return new XRRay(origin, direction);
+    }
+    async requestTransientRaycastSource(entity, session) {
+        if (!session.requestHitTestSourceForTransientInput) {
+            return;
+        }
+        entity.setValue(EnvironmentRaycastTarget, '_sourceRequested', true);
+        try {
+            const source = await session.requestHitTestSourceForTransientInput({
+                profile: 'generic-touchscreen',
+            });
+            entity.setValue(EnvironmentRaycastTarget, '_transientSource', source);
+            entity.setValue(EnvironmentRaycastTarget, '_sourceRequested', false);
+        }
+        catch (error) {
+            console.error('[EnvironmentRaycastSystem] Failed to create transient source:', error);
+            entity.setValue(EnvironmentRaycastTarget, '_sourceRequested', false);
+        }
+    }
+    async resolveXRSpace(entity, space, session) {
+        switch (space) {
+            case RaycastSpace.Viewer:
+                return await session.requestReferenceSpace('viewer');
+            case RaycastSpace.Left:
+            case RaycastSpace.Right: {
+                const inputSource = this.input.getPrimaryInputSource(space);
+                if (inputSource) {
+                    return inputSource.targetRaySpace;
+                }
+                this.pendingControllerSources.set(entity, space);
+                return null;
+            }
+            default:
+                return await session.requestReferenceSpace('viewer');
+        }
+    }
+    updateRaycastResults(entity, frame, referenceSpace) {
+        const source = entity.getValue(EnvironmentRaycastTarget, '_source');
+        if (!source) {
+            return;
+        }
+        const raySpace = entity.getValue(EnvironmentRaycastTarget, '_raySpace');
+        const object3D = entity.object3D;
+        const maxDistance = entity.getValue(EnvironmentRaycastTarget, 'maxDistance');
+        try {
+            const results = frame.getHitTestResults(source);
+            if (results.length === 0) {
+                this.clearHitResult(entity, object3D);
+                return;
+            }
+            // Get ray origin for distance calculation
+            const rayOrigin = this.getRayOrigin(frame, referenceSpace, raySpace);
+            // Find first valid result within maxDistance
+            const validResult = this.findValidHitResult(results, referenceSpace, maxDistance, rayOrigin);
+            if (!validResult) {
+                this.clearHitResult(entity, object3D);
+                return;
+            }
+            this.applyHitResult(entity, object3D, validResult, referenceSpace, undefined);
+        }
+        catch (_a) {
+            this.cleanupRaycastSource(entity);
+        }
+    }
+    updateTransientRaycastResults(entity, frame, referenceSpace, transientSource) {
+        const object3D = entity.object3D;
+        const maxDistance = entity.getValue(EnvironmentRaycastTarget, 'maxDistance');
+        try {
+            const transientResults = frame.getHitTestResultsForTransientInput(transientSource);
+            for (const transientResult of transientResults) {
+                const inputSource = transientResult.inputSource;
+                const rayOrigin = this.getRayOrigin(frame, referenceSpace, inputSource === null || inputSource === void 0 ? void 0 : inputSource.targetRaySpace);
+                const validResult = this.findValidHitResult(transientResult.results, referenceSpace, maxDistance, rayOrigin);
+                if (validResult) {
+                    this.applyHitResult(entity, object3D, validResult, referenceSpace, inputSource);
+                    return;
+                }
+            }
+            // No valid hit found in any transient result
+            this.clearHitResult(entity, object3D);
+        }
+        catch (_a) {
+            this.cleanupRaycastSource(entity);
+        }
+    }
+    getRayOrigin(frame, referenceSpace, raySpace) {
+        if (!raySpace) {
+            return null;
+        }
+        const rayPose = frame.getPose(raySpace, referenceSpace);
+        if (!rayPose) {
+            return null;
+        }
+        tempRayOrigin.set(rayPose.transform.position.x, rayPose.transform.position.y, rayPose.transform.position.z);
+        return tempRayOrigin;
+    }
+    findValidHitResult(results, referenceSpace, maxDistance, rayOrigin) {
+        for (const result of results) {
+            const pose = result.getPose(referenceSpace);
+            if (!pose) {
+                continue;
+            }
+            tempMatrix.fromArray(pose.transform.matrix);
+            tempMatrix.decompose(tempPosition, tempQuaternion, tempScale);
+            // Only apply distance filter if we have a valid ray origin
+            if (rayOrigin) {
+                const distance = tempPosition.distanceTo(rayOrigin);
+                if (distance > maxDistance) {
+                    continue;
+                }
+            }
+            return result;
+        }
+        return null;
+    }
+    applyHitResult(entity, object3D, result, referenceSpace, inputSource) {
+        const pose = result.getPose(referenceSpace);
+        if (!pose) {
+            this.clearHitResult(entity, object3D);
+            return;
+        }
+        tempMatrix.fromArray(pose.transform.matrix);
+        tempMatrix.decompose(tempPosition, tempQuaternion, tempScale);
+        tempNormal.set(0, 1, 0).applyQuaternion(tempQuaternion);
+        if (object3D) {
+            setWorldPosition(object3D, tempPosition);
+            tempWorldQuaternion.setFromUnitVectors(upVector, tempNormal);
+            setWorldQuaternion(object3D, tempWorldQuaternion);
+            object3D.visible = true;
+        }
+        entity.setValue(EnvironmentRaycastTarget, 'xrHitTestResult', result);
+        entity.setValue(EnvironmentRaycastTarget, 'inputSource', inputSource);
+    }
+    clearHitResult(entity, object3D) {
+        entity.setValue(EnvironmentRaycastTarget, 'xrHitTestResult', undefined);
+        entity.setValue(EnvironmentRaycastTarget, 'inputSource', undefined);
+        if (object3D) {
+            object3D.visible = false;
+        }
+    }
+    cleanupRaycastSource(entity) {
+        const source = entity.getValue(EnvironmentRaycastTarget, '_source');
+        if (source) {
+            try {
+                source.cancel();
+            }
+            catch (_a) {
+                /* ignore */
+            }
+        }
+        const transientSource = entity.getValue(EnvironmentRaycastTarget, '_transientSource');
+        if (transientSource) {
+            try {
+                transientSource.cancel();
+            }
+            catch (_b) {
+                /* ignore */
+            }
+        }
+        entity.setValue(EnvironmentRaycastTarget, '_source', undefined);
+        entity.setValue(EnvironmentRaycastTarget, '_raySpace', undefined);
+        entity.setValue(EnvironmentRaycastTarget, '_transientSource', undefined);
+        entity.setValue(EnvironmentRaycastTarget, '_sourceRequested', false);
+        entity.setValue(EnvironmentRaycastTarget, 'xrHitTestResult', undefined);
+        entity.setValue(EnvironmentRaycastTarget, 'inputSource', undefined);
+        this.pendingControllerSources.delete(entity);
+        if (entity.object3D) {
+            entity.object3D.visible = false;
+        }
+    }
+}
+
+export { EnvironmentRaycastSystem };
+//# sourceMappingURL=environment-raycast.js.map

package/dist/environment-raycast/environment-raycast.js.map

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

package/dist/environment-raycast/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ */
+export * from './environment-raycast.js';
+export * from './raycast-target.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/environment-raycast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/environment-raycast/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/dist/environment-raycast/raycast-target.d.ts

@@ -0,0 +1,114 @@
+/**
+ * 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';
+/**
+ * Ray source options for environment raycasting.
+ * @category Environment Raycast
+ */
+export declare const RaycastSpace: {
+    /** Use left controller's target ray */
+    readonly Left: "left";
+    /** Use right controller's target ray */
+    readonly Right: "right";
+    /** Use viewer/head position and gaze direction */
+    readonly Viewer: "viewer";
+    /** For phone AR - tracks screen touch for tap-to-place */
+    readonly Screen: "screen";
+};
+export type RaycastSpace = (typeof RaycastSpace)[keyof typeof RaycastSpace];
+/**
+ * Component that makes an entity follow environment raycast hit points.
+ *
+ * @remarks
+ * The entity's Object3D is automatically positioned at the raycast hit point
+ * and oriented to match the surface normal. When there's no hit, the Object3D
+ * is hidden.
+ *
+ * Use `offsetPosition` and `offsetQuaternion` to offset the ray from the
+ * space origin. This is useful for one-shot raycasts where you want to
+ * cast from a specific position/orientation relative to the controller.
+ *
+ * @example Teleport reticle that follows controller ray
+ * ```ts
+ * const reticle = world.createTransformEntity(reticleMesh);
+ * reticle.addComponent(EnvironmentRaycastTarget, { space: RaycastSpace.Right });
+ * // Reticle automatically moves to where controller points
+ * ```
+ *
+ * @example Place object on trigger press
+ * ```ts
+ * const xrResult = entity.getValue(EnvironmentRaycastTarget, 'xrHitTestResult');
+ * if (xrResult && gamepad.getSelectStart()) {
+ *   spawnObject(entity.object3D.position.clone());
+ * }
+ * ```
+ *
+ * @category Environment Raycast
+ */
+export declare const EnvironmentRaycastTarget: import("elics").Component<{
+    /** Ray source: 'left', 'right', 'viewer', or 'screen'. @default 'right' */
+    space: {
+        type: Types.Enum;
+        enum: {
+            /** Use left controller's target ray */
+            readonly Left: "left";
+            /** Use right controller's target ray */
+            readonly Right: "right";
+            /** Use viewer/head position and gaze direction */
+            readonly Viewer: "viewer";
+            /** For phone AR - tracks screen touch for tap-to-place */
+            readonly Screen: "screen";
+        };
+        default: "right";
+    };
+    /** Maximum raycast distance in meters. @default 100 */
+    maxDistance: {
+        type: Types.Float32;
+        default: number;
+    };
+    /** Offset position from the space origin. @default (0, 0, 0) */
+    offsetPosition: {
+        type: Types.Object;
+        default: undefined;
+    };
+    /** Offset quaternion to rotate the ray direction. @default identity */
+    offsetQuaternion: {
+        type: Types.Object;
+        default: undefined;
+    };
+    /** The XRHitTestResult when there's a hit, undefined otherwise. @readonly */
+    xrHitTestResult: {
+        type: Types.Object;
+        default: undefined;
+    };
+    /** For Screen mode: the input source that triggered the hit. @readonly */
+    inputSource: {
+        type: Types.Object;
+        default: undefined;
+    };
+    /** @internal */
+    _source: {
+        type: Types.Object;
+        default: undefined;
+    };
+    /** @internal */
+    _raySpace: {
+        type: Types.Object;
+        default: undefined;
+    };
+    /** @internal */
+    _transientSource: {
+        type: Types.Object;
+        default: undefined;
+    };
+    /** @internal */
+    _sourceRequested: {
+        type: Types.Boolean;
+        default: false;
+    };
+}>;
+//# sourceMappingURL=raycast-target.d.ts.map

package/dist/environment-raycast/raycast-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raycast-target.d.ts","sourceRoot":"","sources":["../../src/environment-raycast/raycast-target.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,uCAAuC;;IAEvC,wCAAwC;;IAExC,kDAAkD;;IAElD,0DAA0D;;CAElD,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,wBAAwB;IAGjC,2EAA2E;;;;YA5C7E,uCAAuC;;YAEvC,wCAAwC;;YAExC,kDAAkD;;YAElD,0DAA0D;;;;;IA4CxD,uDAAuD;;;;;IAGvD,gEAAgE;;;;;IAEhE,uEAAuE;;;;;IAGvE,6EAA6E;;;;;IAE7E,0EAA0E;;;;;IAG1E,gBAAgB;;;;;IAEhB,gBAAgB;;;;;IAEhB,gBAAgB;;;;;IAEhB,gBAAgB;;;;;EAInB,CAAC"}

package/dist/environment-raycast/raycast-target.js

@@ -0,0 +1,84 @@
+import '@preact/signals-core';
+import '../ecs/world.js';
+import { createComponent, Types } from 'elics';
+import '../ecs/entity.js';
+import '../ecs/component-registry.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.
+ */
+/**
+ * Ray source options for environment raycasting.
+ * @category Environment Raycast
+ */
+const RaycastSpace = {
+    /** Use left controller's target ray */
+    Left: 'left',
+    /** Use right controller's target ray */
+    Right: 'right',
+    /** Use viewer/head position and gaze direction */
+    Viewer: 'viewer',
+    /** For phone AR - tracks screen touch for tap-to-place */
+    Screen: 'screen',
+};
+/**
+ * Component that makes an entity follow environment raycast hit points.
+ *
+ * @remarks
+ * The entity's Object3D is automatically positioned at the raycast hit point
+ * and oriented to match the surface normal. When there's no hit, the Object3D
+ * is hidden.
+ *
+ * Use `offsetPosition` and `offsetQuaternion` to offset the ray from the
+ * space origin. This is useful for one-shot raycasts where you want to
+ * cast from a specific position/orientation relative to the controller.
+ *
+ * @example Teleport reticle that follows controller ray
+ * ```ts
+ * const reticle = world.createTransformEntity(reticleMesh);
+ * reticle.addComponent(EnvironmentRaycastTarget, { space: RaycastSpace.Right });
+ * // Reticle automatically moves to where controller points
+ * ```
+ *
+ * @example Place object on trigger press
+ * ```ts
+ * const xrResult = entity.getValue(EnvironmentRaycastTarget, 'xrHitTestResult');
+ * if (xrResult && gamepad.getSelectStart()) {
+ *   spawnObject(entity.object3D.position.clone());
+ * }
+ * ```
+ *
+ * @category Environment Raycast
+ */
+const EnvironmentRaycastTarget = createComponent('EnvironmentRaycastTarget', {
+    /** Ray source: 'left', 'right', 'viewer', or 'screen'. @default 'right' */
+    space: {
+        type: Types.Enum,
+        enum: RaycastSpace,
+        default: RaycastSpace.Right,
+    },
+    /** Maximum raycast distance in meters. @default 100 */
+    maxDistance: { type: Types.Float32, default: 100 },
+    /** Offset position from the space origin. @default (0, 0, 0) */
+    offsetPosition: { type: Types.Object, default: undefined },
+    /** Offset quaternion to rotate the ray direction. @default identity */
+    offsetQuaternion: { type: Types.Object, default: undefined },
+    /** The XRHitTestResult when there's a hit, undefined otherwise. @readonly */
+    xrHitTestResult: { type: Types.Object, default: undefined },
+    /** For Screen mode: the input source that triggered the hit. @readonly */
+    inputSource: { type: Types.Object, default: undefined },
+    /** @internal */
+    _source: { type: Types.Object, default: undefined },
+    /** @internal */
+    _raySpace: { type: Types.Object, default: undefined },
+    /** @internal */
+    _transientSource: { type: Types.Object, default: undefined },
+    /** @internal */
+    _sourceRequested: { type: Types.Boolean, default: false },
+}, 'Entity follows environment raycast hit points');
+
+export { EnvironmentRaycastTarget, RaycastSpace };
+//# sourceMappingURL=raycast-target.js.map

package/dist/environment-raycast/raycast-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raycast-target.js","sources":["../../src/environment-raycast/raycast-target.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAAA;;;;;AAKG;AAIH;;;AAGG;AACI,MAAM,YAAY,GAAG;;AAE1B,IAAA,IAAI,EAAE,MAAM;;AAEZ,IAAA,KAAK,EAAE,OAAO;;AAEd,IAAA,MAAM,EAAE,QAAQ;;AAEhB,IAAA,MAAM,EAAE,QAAQ;;AAKlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BG;AACI,MAAM,wBAAwB,GAAG,eAAe,CACrD,0BAA0B,EAC1B;;AAEE,IAAA,KAAK,EAAE;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,YAAY,CAAC,KAAK;AAC5B,KAAA;;IAED,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;;IAGlD,cAAc,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;;IAE1D,gBAAgB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;;IAG5D,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;;IAE3D,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;;IAGvD,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;;IAEnD,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;;IAErD,gBAAgB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;;IAE5D,gBAAgB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;CAC1D,EACD,+CAA+C;;;;"}

package/dist/grab/distance-grabbable.d.ts

@@ -16,6 +16,7 @@ import { Types } from '../ecs/index.js';
  * - **RotateAtSource**: Object rotates in place without translation or scaling.
  * - Optional `returnToOrigin` makes objects snap back to their original position when released.
  * - Supports rotation, translation, and scaling with per‑axis constraints.
+ * - Configure target position and rotation offsets relative to the input source for MoveTowardsTarget mode.
  * - Works with the {@link GrabSystem} to create specialized distance grab handles.
  * - Perfect for telekinetic‑style interactions and remote object manipulation.
  *
@@ -44,6 +45,15 @@ import { Types } from '../ecs/index.js';
  * })
  * ```
  *
+ * @example Distance grabbable with offset (object stays 0.3m in front of controller)
+ * ```ts
+ * entity.addComponent(DistanceGrabbable, {
+ *   movementMode: MovementMode.MoveTowardsTarget,
+ *   targetPositionOffset: [0, 0, -0.3], // 0.3m forward in controller space
+ *   targetQuaternionOffset: [0, 0, 0, 1], // no rotation offset
+ * })
+ * ```
+ *
  * @category Grab
  * @see {@link GrabSystem}
  * @see {@link OneHandGrabbable}
@@ -112,10 +122,25 @@ export declare const DistanceGrabbable: import("elics").Component<{
         type: Types.Boolean;
         default: false;
     };
-    /** Object movement speed for the MoveTowardsTarget movement mode. */
-    moveSpeed: {
+    /** A boolean value to set whether the object will be detached from its parent and attach to the scene/Level root when grabbed. */
+    detachOnGrab: {
+        type: Types.Boolean;
+        default: false;
+    };
+    /** Object movement and rotation speed factor for the MoveTowardsTarget movement mode with a scale from 0 to 1. */
+    moveSpeedFactor: {
         type: Types.Float32;
         default: number;
     };
+    /** Target position offset relative to the input source for MoveTowardsTarget mode in [x, y, z]. */
+    targetPositionOffset: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    /** Target rotation offset as a quaternion relative to the input source for MoveTowardsTarget mode in [x, y, z, w]. */
+    targetQuaternionOffset: {
+        type: Types.Vec4;
+        default: [number, number, number, number];
+    };
 }>;
 //# sourceMappingURL=distance-grabbable.d.ts.map

package/dist/grab/distance-grabbable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distance-grabbable.d.ts","sourceRoot":"","sources":["../../src/grab/distance-grabbable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,iBAAiB;IAG1B,qEAAqE;;;;;IAErE,gGAAgG;;;;;IAKhG,gGAAgG;;;;;IAKhG,8EAA8E;;;;;IAE9E,mFAAmF;;;;;IAKnF,mFAAmF;;;;;IAKnF,gFAAgF;;;;;IAEhF,kFAAkF;;;;;IAKlF,kFAAkF;;;;;IAKlF,gFAAgF;;;;;;;;;;;IAMhF,iGAAiG;;;;;IAEjG,qEAAqE;;;;;EAIxE,CAAC"}
+{"version":3,"file":"distance-grabbable.d.ts","sourceRoot":"","sources":["../../src/grab/distance-grabbable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,iBAAiB;IAG1B,qEAAqE;;;;;IAErE,gGAAgG;;;;;IAKhG,gGAAgG;;;;;IAKhG,8EAA8E;;;;;IAE9E,mFAAmF;;;;;IAKnF,mFAAmF;;;;;IAKnF,gFAAgF;;;;;IAEhF,kFAAkF;;;;;IAKlF,kFAAkF;;;;;IAKlF,gFAAgF;;;;;;;;;;;IAMhF,iGAAiG;;;;;IAEjG,kIAAkI;;;;;IAElI,kHAAkH;;;;;IAElH,mGAAmG;;;;;IAKnG,sHAAsH;;;;;EAOzH,CAAC"}