@aura3d/controls 1.0.6

package/dist/Picking.js

@@ -0,0 +1,149 @@
+import { ControlVector3, traverseControlObject } from "./NativeControlTypes.js";
+export class Picking {
+    pick(root, origin = new ControlVector3(), direction = new ControlVector3(0, 0, -1), options = {}) {
+        return this.report(root, origin, direction, options).hit;
+    }
+    pickAll(root, origin = new ControlVector3(), direction = new ControlVector3(0, 0, -1), options = {}) {
+        return this.report(root, origin, direction, options).hits;
+    }
+    report(root, origin = new ControlVector3(), direction = new ControlVector3(0, 0, -1), options = {}) {
+        const normalizedDirection = normalizedRayDirection(direction);
+        const near = finiteRange(options.near ?? 0, "near", 0);
+        const far = finiteRange(options.far ?? Number.POSITIVE_INFINITY, "far", near);
+        const tolerance = finiteRange(options.tolerance ?? 0, "tolerance", 0);
+        const hits = [];
+        const counters = {
+            testedObjects: 0,
+            candidateObjects: 0,
+            skippedInvisible: 0,
+            skippedNonPickable: 0,
+            skippedDisabled: 0,
+            skippedOutOfRange: 0,
+            skippedMissedRadius: 0
+        };
+        let nearestMissPerpendicularDistance = Number.POSITIVE_INFINITY;
+        traverseControlObject(root, (object) => {
+            counters.testedObjects += 1;
+            if (object.visible === false && options.includeInvisible !== true) {
+                counters.skippedInvisible += 1;
+                return;
+            }
+            const metadata = resolvePickMetadata(object, options);
+            if (metadata?.selectable === false) {
+                counters.skippedDisabled += 1;
+                return;
+            }
+            if (!isPickableObject(object, metadata, options)) {
+                counters.skippedNonPickable += 1;
+                return;
+            }
+            counters.candidateObjects += 1;
+            const toObject = new ControlVector3(object.position.x - origin.x, object.position.y - origin.y, object.position.z - origin.z);
+            const distanceAlongRay = dot(toObject, normalizedDirection);
+            if (distanceAlongRay < near || distanceAlongRay > far) {
+                counters.skippedOutOfRange += 1;
+                return;
+            }
+            const closestPoint = pointOnRay(origin, normalizedDirection, distanceAlongRay);
+            const perpendicularDistance = new ControlVector3(object.position.x - closestPoint.x, object.position.y - closestPoint.y, object.position.z - closestPoint.z).length();
+            const radius = resolvePickRadius(object, metadata) + tolerance;
+            if (perpendicularDistance > radius) {
+                counters.skippedMissedRadius += 1;
+                nearestMissPerpendicularDistance = Math.min(nearestMissPerpendicularDistance, perpendicularDistance);
+                return;
+            }
+            const rayEntryDistance = Math.max(near, distanceAlongRay - Math.sqrt(Math.max(0, radius * radius - perpendicularDistance * perpendicularDistance)));
+            hits.push({
+                object,
+                distance: rayEntryDistance,
+                distanceAlongRay,
+                perpendicularDistance,
+                point: pointOnRay(origin, normalizedDirection, rayEntryDistance),
+                radius,
+                metadata
+            });
+        });
+        hits.sort(compareHits);
+        const hit = hits[0] ?? null;
+        return {
+            hit,
+            hits,
+            diagnostics: {
+                ...counters,
+                hitCount: hits.length,
+                nearestMissPerpendicularDistance: Number.isFinite(nearestMissPerpendicularDistance) ? nearestMissPerpendicularDistance : null,
+                nearestHitLabel: hit ? pickLabel(hit.object, hit.metadata) : null
+            }
+        };
+    }
+}
+function normalizedRayDirection(direction) {
+    const normalized = new ControlVector3(direction.x, direction.y, direction.z);
+    const length = normalized.length();
+    if (!Number.isFinite(length) || length <= 1e-8) {
+        throw new RangeError("Picking ray direction must be finite and non-zero.");
+    }
+    return normalized.set(normalized.x / length, normalized.y / length, normalized.z / length);
+}
+function finiteRange(value, label, minimum) {
+    if (value === Number.POSITIVE_INFINITY && label === "far")
+        return value;
+    if (!Number.isFinite(value) || value < minimum) {
+        throw new RangeError(`Picking ${label} must be finite and >= ${minimum}.`);
+    }
+    return value;
+}
+function resolvePickMetadata(object, options) {
+    return options.metadata?.(object)
+        ?? object.picking
+        ?? readUserDataMetadata(object.userData);
+}
+function readUserDataMetadata(userData) {
+    const value = userData?.a3dPicking ?? userData?.picking;
+    if (!value || typeof value !== "object")
+        return undefined;
+    return value;
+}
+function isPickableObject(object, metadata, options) {
+    if (metadata && options.includeNonRenderableMetadata !== false)
+        return true;
+    return object.type === "Mesh" || object.type === "Sprite" || object.type === "Points" || object.type === "LineSegments";
+}
+function resolvePickRadius(object, metadata) {
+    const explicit = metadata?.pickRadius ?? object.pickRadius ?? readUserDataRadius(object.userData);
+    if (explicit !== undefined)
+        return positiveFinite(explicit, "pickRadius");
+    const scale = object.scale;
+    if (!scale)
+        return 0.5;
+    const radius = Math.max(Math.abs(scale.x), Math.abs(scale.y), Math.abs(scale.z)) * 0.5;
+    return Number.isFinite(radius) && radius > 0 ? radius : 0.5;
+}
+function readUserDataRadius(userData) {
+    const value = userData?.a3dPickRadius;
+    return typeof value === "number" ? value : undefined;
+}
+function positiveFinite(value, label) {
+    if (!Number.isFinite(value) || value <= 0)
+        throw new RangeError(`Picking ${label} must be finite and positive.`);
+    return value;
+}
+function dot(left, right) {
+    return left.x * right.x + left.y * right.y + left.z * right.z;
+}
+function pointOnRay(origin, direction, distance) {
+    return new ControlVector3(origin.x + direction.x * distance, origin.y + direction.y * distance, origin.z + direction.z * distance);
+}
+function compareHits(left, right) {
+    const distanceDelta = left.distance - right.distance;
+    if (Math.abs(distanceDelta) > 1e-8)
+        return distanceDelta;
+    return pickPriority(right) - pickPriority(left);
+}
+function pickPriority(hit) {
+    return hit.metadata?.priority ?? hit.object.pickPriority ?? 0;
+}
+function pickLabel(object, metadata) {
+    return metadata?.label ?? metadata?.id ?? object.name ?? null;
+}
+//# sourceMappingURL=Picking.js.map

package/dist/Picking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Picking.js","sourceRoot":"","sources":["../../../../packages/controls/src/Picking.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,qBAAqB,EAItB,MAAM,sBAAsB,CAAC;AAwC9B,MAAM,OAAO,OAAO;IAClB,IAAI,CACF,IAAyB,EACzB,SAAsB,IAAI,cAAc,EAAE,EAC1C,YAAyB,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EACrD,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC;IAC3D,CAAC;IAED,OAAO,CACL,IAAyB,EACzB,SAAsB,IAAI,cAAc,EAAE,EAC1C,YAAyB,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EACrD,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC;IAED,MAAM,CACJ,IAAyB,EACzB,SAAsB,IAAI,cAAc,EAAE,EAC1C,YAAyB,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EACrD,UAA0B,EAAE;QAE5B,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9E,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG;YACf,aAAa,EAAE,CAAC;YAChB,gBAAgB,EAAE,CAAC;YACnB,gBAAgB,EAAE,CAAC;YACnB,kBAAkB,EAAE,CAAC;YACrB,eAAe,EAAE,CAAC;YAClB,iBAAiB,EAAE,CAAC;YACpB,mBAAmB,EAAE,CAAC;SACvB,CAAC;QACF,IAAI,gCAAgC,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAEhE,qBAAqB,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;YACrC,QAAQ,CAAC,aAAa,IAAI,CAAC,CAAC;YAC5B,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;gBAClE,QAAQ,CAAC,gBAAgB,IAAI,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACtD,IAAI,QAAQ,EAAE,UAAU,KAAK,KAAK,EAAE,CAAC;gBACnC,QAAQ,CAAC,eAAe,IAAI,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;gBACjD,QAAQ,CAAC,kBAAkB,IAAI,CAAC,CAAC;gBACjC,OAAO;YACT,CAAC;YACD,QAAQ,CAAC,gBAAgB,IAAI,CAAC,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,cAAc,CACjC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAC7B,CAAC;YACF,MAAM,gBAAgB,GAAG,GAAG,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;YAC5D,IAAI,gBAAgB,GAAG,IAAI,IAAI,gBAAgB,GAAG,GAAG,EAAE,CAAC;gBACtD,QAAQ,CAAC,iBAAiB,IAAI,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YACD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,EAAE,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;YAC/E,MAAM,qBAAqB,GAAG,IAAI,cAAc,CAC9C,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAClC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAClC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CACnC,CAAC,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;YAC/D,IAAI,qBAAqB,GAAG,MAAM,EAAE,CAAC;gBACnC,QAAQ,CAAC,mBAAmB,IAAI,CAAC,CAAC;gBAClC,gCAAgC,GAAG,IAAI,CAAC,GAAG,CAAC,gCAAgC,EAAE,qBAAqB,CAAC,CAAC;gBACrG,OAAO;YACT,CAAC;YACD,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,qBAAqB,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACpJ,IAAI,CAAC,IAAI,CAAC;gBACR,MAAM;gBACN,QAAQ,EAAE,gBAAgB;gBAC1B,gBAAgB;gBAChB,qBAAqB;gBACrB,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,mBAAmB,EAAE,gBAAgB,CAAC;gBAChE,MAAM;gBACN,QAAQ;aACT,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5B,OAAO;YACL,GAAG;YACH,IAAI;YACJ,WAAW,EAAE;gBACX,GAAG,QAAQ;gBACX,QAAQ,EAAE,IAAI,CAAC,MAAM;gBACrB,gCAAgC,EAAE,MAAM,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,IAAI;gBAC7H,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;aAClE;SACF,CAAC;IACJ,CAAC;CACF;AAED,SAAS,sBAAsB,CAAC,SAAsB;IACpD,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QAC/C,MAAM,IAAI,UAAU,CAAC,oDAAoD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,KAAa,EAAE,OAAe;IAChE,IAAI,KAAK,KAAK,MAAM,CAAC,iBAAiB,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACxE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QAC/C,MAAM,IAAI,UAAU,CAAC,WAAW,KAAK,0BAA0B,OAAO,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,MAA2B,EAAE,OAAuB;IAC/E,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;WAC5B,MAAM,CAAC,OAAO;WACd,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,oBAAoB,CAAC,QAA6C;IACzE,MAAM,KAAK,GAAG,QAAQ,EAAE,UAAU,IAAI,QAAQ,EAAE,OAAO,CAAC;IACxD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,OAAO,KAA4B,CAAC;AACtC,CAAC;AAED,SAAS,gBAAgB,CACvB,MAA2B,EAC3B,QAAyC,EACzC,OAAuB;IAEvB,IAAI,QAAQ,IAAI,OAAO,CAAC,4BAA4B,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC;AAC1H,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA2B,EAAE,QAAyC;IAC/F,MAAM,QAAQ,GAAG,QAAQ,EAAE,UAAU,IAAI,MAAM,CAAC,UAAU,IAAI,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClG,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACvF,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9D,CAAC;AAED,SAAS,kBAAkB,CAAC,QAA6C;IACvE,MAAM,KAAK,GAAG,QAAQ,EAAE,aAAa,CAAC;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,WAAW,KAAK,+BAA+B,CAAC,CAAC;IACjH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,GAAG,CAAC,IAAiB,EAAE,KAAkB;IAChD,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,UAAU,CAAC,MAAmB,EAAE,SAAsB,EAAE,QAAgB;IAC/E,OAAO,IAAI,cAAc,CACvB,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,QAAQ,EACjC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,QAAQ,EACjC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,QAAQ,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAA2B,EAAE,KAA4B;IAC5E,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACrD,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,IAAI;QAAE,OAAO,aAAa,CAAC;IACzD,OAAO,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,YAAY,CAAC,GAA0B;IAC9C,OAAO,GAAG,CAAC,QAAQ,EAAE,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,SAAS,CAAC,MAA2B,EAAE,QAAyC;IACvF,OAAO,QAAQ,EAAE,KAAK,IAAI,QAAQ,EAAE,EAAE,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;AAChE,CAAC"}

package/dist/PickingAnnotations.d.ts

@@ -0,0 +1,134 @@
+import { type PickingOptions, type PickingReport, type ThreeCompatPickResult } from "./Picking";
+import { type ControlObject3DLike, type ControlPickMetadata, type Vector3Like } from "./NativeControlTypes";
+export type PickingAnnotationKind = "hotspot" | "label" | "district" | "building" | "robot" | "entity";
+export type PickingAnnotationSource = "imported-gltf" | "procedural" | "screen-space";
+export type PickingAnnotationHitPolicy = "nearest" | "priority";
+export interface PickingAnnotation<TPayload = unknown> {
+    readonly id: string;
+    readonly label: string;
+    readonly kind: PickingAnnotationKind;
+    readonly position: Vector3Like | readonly [number, number, number];
+    readonly radius: number;
+    readonly priority?: number;
+    readonly group?: string;
+    readonly routeId?: string;
+    readonly source?: PickingAnnotationSource;
+    readonly selectable?: boolean;
+    readonly highlightable?: boolean;
+    readonly targetId?: string;
+    readonly payload?: TPayload;
+}
+export interface PickingAnnotationRoot<TPayload = unknown> extends ControlObject3DLike {
+    readonly type: "PickingAnnotationRoot";
+    readonly name: string;
+    readonly children: readonly PickingAnnotationObject<TPayload>[];
+}
+export interface PickingAnnotationObject<TPayload = unknown> extends ControlObject3DLike {
+    readonly type: "PickingAnnotation";
+    readonly name: string;
+    readonly picking: ControlPickMetadata;
+    readonly userData: {
+        readonly a3dPicking: ControlPickMetadata;
+        readonly a3dPickingAnnotation: PickingAnnotation<TPayload>;
+    };
+}
+export interface PickingAnnotationReport<TPayload = unknown> extends PickingReport {
+    readonly annotation: PickingAnnotation<TPayload> | null;
+    readonly annotations: readonly PickingAnnotation<TPayload>[];
+}
+export interface PickingAnnotationOptions extends PickingOptions {
+    readonly hitPolicy?: PickingAnnotationHitPolicy;
+}
+export interface ImportedGlbHotspotDescriptor<TPayload = unknown> {
+    readonly id?: string;
+    readonly nodeName?: string;
+    readonly label?: string;
+    readonly focusId?: string;
+    readonly position: Vector3Like | readonly [number, number, number];
+    readonly radius?: number;
+    readonly priority?: number;
+    readonly selectable?: boolean;
+    readonly highlightable?: boolean;
+    readonly payload?: TPayload;
+}
+export interface DistrictPickingDescriptor<TPayload = unknown> {
+    readonly id: string;
+    readonly label?: string;
+    readonly center: Vector3Like | readonly [number, number, number];
+    readonly radius: number;
+    readonly priority?: number;
+    readonly routeId?: string;
+    readonly payload?: TPayload;
+    readonly buildings?: readonly BuildingPickingDescriptor<TPayload>[];
+}
+export interface BuildingPickingDescriptor<TPayload = unknown> {
+    readonly id: string;
+    readonly label?: string;
+    readonly position: Vector3Like | readonly [number, number, number];
+    readonly radius: number;
+    readonly priority?: number;
+    readonly payload?: TPayload;
+}
+export interface EntityPickingDescriptor<TPayload = unknown> {
+    readonly id: string;
+    readonly label?: string;
+    readonly kind?: "robot" | "entity";
+    readonly position: Vector3Like | readonly [number, number, number];
+    readonly radius: number;
+    readonly priority?: number;
+    readonly group?: string;
+    readonly routeId?: string;
+    readonly payload?: TPayload;
+}
+export interface ScreenPickingAnnotation<TPayload = unknown> {
+    readonly id: string;
+    readonly label: string;
+    readonly kind: PickingAnnotationKind;
+    readonly x: number;
+    readonly y: number;
+    readonly radius: number;
+    readonly priority?: number;
+    readonly group?: string;
+    readonly routeId?: string;
+    readonly source?: PickingAnnotationSource;
+    readonly selectable?: boolean;
+    readonly highlightable?: boolean;
+    readonly targetId?: string;
+    readonly payload?: TPayload;
+}
+export interface ScreenPickingHit<TPayload = unknown> {
+    readonly annotation: ScreenPickingAnnotation<TPayload>;
+    readonly distance: number;
+}
+export interface ScreenPickingReport<TPayload = unknown> {
+    readonly hit: ScreenPickingHit<TPayload> | null;
+    readonly hits: readonly ScreenPickingHit<TPayload>[];
+    readonly diagnostics: {
+        readonly testedAnnotations: number;
+        readonly candidateAnnotations: number;
+        readonly hitCount: number;
+        readonly skippedDisabled: number;
+        readonly skippedOutOfRadius: number;
+        readonly nearestHitLabel: string | null;
+    };
+}
+export interface ScreenPickingOptions {
+    readonly tolerance?: number;
+    readonly hitPolicy?: PickingAnnotationHitPolicy;
+}
+export declare function createPickingAnnotationRoot<TPayload = unknown>(name: string, annotations: readonly PickingAnnotation<TPayload>[]): PickingAnnotationRoot<TPayload>;
+export declare function createPickingAnnotationObject<TPayload = unknown>(annotation: PickingAnnotation<TPayload>): PickingAnnotationObject<TPayload>;
+export declare function pickAnnotation<TPayload = unknown>(root: ControlObject3DLike, origin?: Vector3Like, direction?: Vector3Like, options?: PickingAnnotationOptions): PickingAnnotationReport<TPayload>;
+export declare function annotationFromPickHit<TPayload = unknown>(hit: ThreeCompatPickResult | null | undefined): PickingAnnotation<TPayload> | null;
+export declare function createImportedGlbHotspotAnnotations<TPayload = unknown>(assetId: string, hotspots: readonly ImportedGlbHotspotDescriptor<TPayload>[], routeId?: string): readonly PickingAnnotation<TPayload>[];
+export declare function createDistrictPickingAnnotations<TPayload = unknown>(districts: readonly DistrictPickingDescriptor<TPayload>[]): readonly PickingAnnotation<TPayload>[];
+export declare function createRobotPickingAnnotations<TPayload = unknown>(robots: readonly EntityPickingDescriptor<TPayload>[]): readonly PickingAnnotation<TPayload>[];
+export declare function createEntityPickingAnnotations<TPayload = unknown>(entities: readonly EntityPickingDescriptor<TPayload>[], options?: {
+    readonly defaultGroup?: string;
+    readonly defaultPriority?: number;
+}): readonly PickingAnnotation<TPayload>[];
+export declare function pickScreenSpaceAnnotation<TPayload = unknown>(pointer: {
+    readonly x: number;
+    readonly y: number;
+}, annotations: readonly ScreenPickingAnnotation<TPayload>[], options?: ScreenPickingOptions): ScreenPickingReport<TPayload>;
+//# sourceMappingURL=PickingAnnotations.d.ts.map

package/dist/PickingAnnotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PickingAnnotations.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/PickingAnnotations.ts"],"names":[],"mappings":"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"}

package/dist/PickingAnnotations.js

@@ -0,0 +1,221 @@
+import { Picking } from "./Picking.js";
+import { ControlVector3 } from "./NativeControlTypes.js";
+export function createPickingAnnotationRoot(name, annotations) {
+    return {
+        type: "PickingAnnotationRoot",
+        name,
+        position: new ControlVector3(),
+        children: annotations.map(createPickingAnnotationObject)
+    };
+}
+export function createPickingAnnotationObject(annotation) {
+    const radius = positiveFinite(annotation.radius, "annotation radius");
+    const metadata = {
+        id: annotation.id,
+        label: annotation.label,
+        kind: annotation.kind,
+        group: annotation.group,
+        selectable: annotation.selectable,
+        highlightable: annotation.highlightable,
+        pickRadius: radius,
+        priority: annotation.priority,
+        routeId: annotation.routeId,
+        source: annotation.source,
+        targetId: annotation.targetId,
+        payload: annotation.payload
+    };
+    return {
+        type: "PickingAnnotation",
+        name: annotation.label,
+        position: toVector3(annotation.position),
+        scale: new ControlVector3(radius * 2, radius * 2, radius * 2),
+        visible: annotation.selectable === false ? false : true,
+        pickRadius: radius,
+        pickPriority: annotation.priority,
+        picking: metadata,
+        userData: {
+            a3dPicking: metadata,
+            a3dPickingAnnotation: annotation
+        }
+    };
+}
+export function pickAnnotation(root, origin = new ControlVector3(), direction = new ControlVector3(0, 0, -1), options = {}) {
+    const report = new Picking().report(root, origin, direction, options);
+    const hits = options.hitPolicy === "priority"
+        ? [...report.hits].sort(compareAnnotationHitsByPriority)
+        : report.hits;
+    const hit = hits[0] ?? null;
+    return {
+        ...report,
+        hit,
+        hits,
+        annotation: hit ? annotationFromPickHit(hit) : null,
+        annotations: hits.map((candidate) => annotationFromPickHit(candidate)).filter((annotation) => Boolean(annotation))
+    };
+}
+export function annotationFromPickHit(hit) {
+    const value = hit?.object.userData?.a3dPickingAnnotation;
+    return isPickingAnnotation(value) ? value : null;
+}
+export function createImportedGlbHotspotAnnotations(assetId, hotspots, routeId) {
+    return hotspots.map((hotspot, index) => {
+        const targetId = hotspot.focusId ?? hotspot.nodeName ?? hotspot.id ?? `hotspot-${index}`;
+        return {
+            id: hotspot.id ?? `${assetId}:${targetId}`,
+            label: hotspot.label ?? readableLabel(targetId),
+            kind: "hotspot",
+            position: hotspot.position,
+            radius: hotspot.radius ?? 0.18,
+            priority: hotspot.priority ?? 100,
+            group: assetId,
+            routeId,
+            source: "imported-gltf",
+            selectable: hotspot.selectable,
+            highlightable: hotspot.highlightable ?? true,
+            targetId,
+            payload: hotspot.payload
+        };
+    });
+}
+export function createDistrictPickingAnnotations(districts) {
+    const annotations = [];
+    for (const district of districts) {
+        annotations.push({
+            id: district.id,
+            label: district.label ?? readableLabel(district.id),
+            kind: "district",
+            position: district.center,
+            radius: district.radius,
+            priority: district.priority ?? 10,
+            group: "district",
+            routeId: district.routeId,
+            source: "procedural",
+            highlightable: true,
+            payload: district.payload
+        });
+        for (const building of district.buildings ?? []) {
+            annotations.push({
+                id: building.id,
+                label: building.label ?? readableLabel(building.id),
+                kind: "building",
+                position: building.position,
+                radius: building.radius,
+                priority: building.priority ?? 40,
+                group: district.id,
+                routeId: district.routeId,
+                source: "procedural",
+                highlightable: true,
+                payload: building.payload
+            });
+        }
+    }
+    return annotations;
+}
+export function createRobotPickingAnnotations(robots) {
+    return createEntityPickingAnnotations(robots.map((robot) => ({ ...robot, kind: "robot" })), {
+        defaultGroup: "robot",
+        defaultPriority: 70
+    });
+}
+export function createEntityPickingAnnotations(entities, options = {}) {
+    return entities.map((entity) => ({
+        id: entity.id,
+        label: entity.label ?? readableLabel(entity.id),
+        kind: entity.kind ?? "entity",
+        position: entity.position,
+        radius: entity.radius,
+        priority: entity.priority ?? options.defaultPriority ?? 50,
+        group: entity.group ?? options.defaultGroup,
+        routeId: entity.routeId,
+        source: "procedural",
+        highlightable: true,
+        targetId: entity.id,
+        payload: entity.payload
+    }));
+}
+export function pickScreenSpaceAnnotation(pointer, annotations, options = {}) {
+    validateScreenPoint(pointer, "pointer");
+    const tolerance = options.tolerance ?? 0;
+    if (!Number.isFinite(tolerance) || tolerance < 0)
+        throw new RangeError("Screen picking tolerance must be finite and non-negative.");
+    const hits = [];
+    let skippedDisabled = 0;
+    let skippedOutOfRadius = 0;
+    for (const annotation of annotations) {
+        if (annotation.selectable === false) {
+            skippedDisabled += 1;
+            continue;
+        }
+        validateScreenPoint(annotation, annotation.id);
+        const radius = positiveFinite(annotation.radius, `${annotation.id} screen radius`) + tolerance;
+        const distance = Math.hypot(pointer.x - annotation.x, pointer.y - annotation.y);
+        if (distance > radius) {
+            skippedOutOfRadius += 1;
+            continue;
+        }
+        hits.push({ annotation, distance });
+    }
+    hits.sort(options.hitPolicy === "priority" ? compareScreenHitsByPriority : compareScreenHitsByDistance);
+    const hit = hits[0] ?? null;
+    return {
+        hit,
+        hits,
+        diagnostics: {
+            testedAnnotations: annotations.length,
+            candidateAnnotations: annotations.length - skippedDisabled,
+            hitCount: hits.length,
+            skippedDisabled,
+            skippedOutOfRadius,
+            nearestHitLabel: hit?.annotation.label ?? null
+        }
+    };
+}
+function toVector3(value) {
+    const tuple = value;
+    const vector = value;
+    const x = Array.isArray(value) ? tuple[0] : vector.x;
+    const y = Array.isArray(value) ? tuple[1] : vector.y;
+    const z = Array.isArray(value) ? tuple[2] : vector.z;
+    if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z)) {
+        throw new RangeError("Picking annotation position must contain three finite values.");
+    }
+    return new ControlVector3(x, y, z);
+}
+function positiveFinite(value, label) {
+    if (!Number.isFinite(value) || value <= 0)
+        throw new RangeError(`Picking ${label} must be finite and positive.`);
+    return value;
+}
+function readableLabel(value) {
+    return value.replace(/[_:-]+/g, " ").replace(/\s+/g, " ").trim() || "Picking target";
+}
+function compareAnnotationHitsByPriority(left, right) {
+    const priorityDelta = (right.metadata?.priority ?? 0) - (left.metadata?.priority ?? 0);
+    if (Math.abs(priorityDelta) > 1e-8)
+        return priorityDelta;
+    return left.distance - right.distance;
+}
+function isPickingAnnotation(value) {
+    return Boolean(value)
+        && typeof value === "object"
+        && typeof value.id === "string"
+        && typeof value.label === "string";
+}
+function validateScreenPoint(point, label) {
+    if (!Number.isFinite(point.x) || !Number.isFinite(point.y)) {
+        throw new RangeError(`Screen picking ${label} must contain finite x/y values.`);
+    }
+}
+function compareScreenHitsByDistance(left, right) {
+    const distanceDelta = left.distance - right.distance;
+    if (Math.abs(distanceDelta) > 1e-8)
+        return distanceDelta;
+    return (right.annotation.priority ?? 0) - (left.annotation.priority ?? 0);
+}
+function compareScreenHitsByPriority(left, right) {
+    const priorityDelta = (right.annotation.priority ?? 0) - (left.annotation.priority ?? 0);
+    if (Math.abs(priorityDelta) > 1e-8)
+        return priorityDelta;
+    return left.distance - right.distance;
+}
+//# sourceMappingURL=PickingAnnotations.js.map

package/dist/PickingAnnotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PickingAnnotations.js","sourceRoot":"","sources":["../../../../packages/controls/src/PickingAnnotations.ts"],"names":[],"mappings":"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"}

package/dist/PointerLockControls.d.ts

@@ -0,0 +1,9 @@
+import { type ThreeCompatControlState } from "./ControlState";
+export declare class PointerLockControls {
+    readonly state: ThreeCompatControlState;
+    locked: boolean;
+    lock(): void;
+    unlock(): void;
+    look(deltaX: number, deltaY: number): void;
+}
+//# sourceMappingURL=PointerLockControls.d.ts.map

package/dist/PointerLockControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointerLockControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/PointerLockControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzF,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAA+B;IACtE,MAAM,UAAS;IAEf,IAAI,IAAI,IAAI;IACZ,MAAM,IAAI,IAAI;IAEd,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAK3C"}

package/dist/PointerLockControls.js

@@ -0,0 +1,14 @@
+import { createDefaultControlState } from "./ControlState.js";
+export class PointerLockControls {
+    state = createDefaultControlState();
+    locked = false;
+    lock() { this.locked = true; }
+    unlock() { this.locked = false; }
+    look(deltaX, deltaY) {
+        if (!this.locked)
+            return;
+        this.state.rotation.y += deltaX;
+        this.state.rotation.x += deltaY;
+    }
+}
+//# sourceMappingURL=PointerLockControls.js.map

package/dist/PointerLockControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointerLockControls.js","sourceRoot":"","sources":["../../../../packages/controls/src/PointerLockControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAgC,MAAM,gBAAgB,CAAC;AAEzF,MAAM,OAAO,mBAAmB;IACrB,KAAK,GAA4B,yBAAyB,EAAE,CAAC;IACtE,MAAM,GAAG,KAAK,CAAC;IAEf,IAAI,KAAW,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACpC,MAAM,KAAW,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;IAEvC,IAAI,CAAC,MAAc,EAAE,MAAc;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC;IAClC,CAAC;CACF"}

package/dist/SelectionManager.d.ts

@@ -0,0 +1,8 @@
+import type { ControlObject3DLike } from "./NativeControlTypes";
+export declare class SelectionManager {
+    readonly selected: Set<ControlObject3DLike>;
+    select(object: ControlObject3DLike, additive?: boolean): void;
+    deselect(object: ControlObject3DLike): void;
+    clear(): void;
+}
+//# sourceMappingURL=SelectionManager.d.ts.map

package/dist/SelectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionManager.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/SelectionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,QAAQ,2BAAkC;IAEnD,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,UAAQ,GAAG,IAAI;IAK3D,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAI3C,KAAK,IAAI,IAAI;CAGd"}

package/dist/SelectionManager.js

@@ -0,0 +1,15 @@
+export class SelectionManager {
+    selected = new Set();
+    select(object, additive = false) {
+        if (!additive)
+            this.clear();
+        this.selected.add(object);
+    }
+    deselect(object) {
+        this.selected.delete(object);
+    }
+    clear() {
+        this.selected.clear();
+    }
+}
+//# sourceMappingURL=SelectionManager.js.map

package/dist/SelectionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionManager.js","sourceRoot":"","sources":["../../../../packages/controls/src/SelectionManager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEnD,MAAM,CAAC,MAA2B,EAAE,QAAQ,GAAG,KAAK;QAClD,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ,CAAC,MAA2B;QAClC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/TrackballControls.d.ts

@@ -0,0 +1,18 @@
+import { OrbitControls } from "./OrbitControls";
+export type TrackballKey = "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "KeyQ" | "KeyE" | "NumpadAdd" | "NumpadSubtract" | "+" | "-" | "=" | "_";
+export declare class TrackballControls extends OrbitControls {
+    enableDamping: boolean;
+    dampingFactor: number;
+    keyPanSpeed: number;
+    keyRollSpeed: number;
+    private rotationVelocity;
+    private panVelocity;
+    private dollyVelocity;
+    roll(delta: number): void;
+    rotate(deltaX: number, deltaY: number): void;
+    pan(deltaX: number, deltaY: number): void;
+    dolly(scale: number): void;
+    handleKey(code: TrackballKey): void;
+    update(deltaSeconds?: number): boolean;
+}
+//# sourceMappingURL=TrackballControls.d.ts.map

package/dist/TrackballControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackballControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/TrackballControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,WAAW,GACX,WAAW,GACX,YAAY,GACZ,MAAM,GACN,MAAM,GACN,WAAW,GACX,gBAAgB,GAChB,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,CAAC;AAER,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,aAAa,UAAS;IACtB,aAAa,SAAQ;IACrB,WAAW,SAAQ;IACnB,YAAY,SAAQ;IAEpB,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,aAAa,CAAK;IAE1B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAO5C,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAOzC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMnC,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAiCnC,MAAM,CAAC,YAAY,SAAS,GAAG,OAAO;CA8BvC"}