@aura3d/engine 1.5.0 → 1.5.1

package/dist/engine/agent-api/FocusSelection.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Reusable object focus and selection feedback.
+ *
+ * ## The defect this replaces
+ *
+ * The product configurator built its focus indicator by hand:
+ *
+ * ```ts
+ * primitives.torus({ ... }).position(...p).rotate(1.5708, 0, 0).scale([1.22, 0.08, 0.78])
+ * ```
+ *
+ * Aura3D's torus primitive is generated in local XY -- the ring lies in the XY
+ * plane with its tube thin on **Z** (`createTorusGeometry` sweeps `cos u, sin u`
+ * into X/Y and puts the tube's `sin v` on Z). Scaling `[1.22, 0.08, 0.78]`
+ * therefore squashes the ring's own **Y radius** to 8%, turning the circle into a
+ * flat horizontal sliver. The subsequent `rotate(pi/2, 0, 0)` tips that sliver
+ * into the ground plane, and it renders as the "random yellow/white bar" the
+ * user reported. A working ring in the same codebase uses `[0.72, 0.72, 0.028]`
+ * -- equal X/Y radii, thin on Z -- which is why the two looked unrelated.
+ *
+ * Changing those three constants would have fixed one route and left the trap in
+ * place for every other. The real defects are: primitive local axes were not
+ * documented, and no reusable focus feedback existed, so every route invented
+ * its own indicator geometry.
+ *
+ * This module removes the need to know the torus axis convention at all. A route
+ * states intent -- focus this target, with a ring and a callout -- and gets
+ * correct indicator geometry for any target size, orientation, or nonuniform
+ * scale.
+ *
+ * Pure and dependency-free: it returns scene-node JSON and camera intent, so it
+ * is unit-testable without a renderer and reusable by any route or kit.
+ */
+import type { AuraColor, AuraSceneNode, AuraVec3 } from "./index.js";
+import { type PlacedBounds, type SemanticRegion } from "./SpatialAnchoring.js";
+/**
+ * Local-axis conventions for Aura3D primitives.
+ *
+ * Published so a route that must build custom geometry can do so correctly, and
+ * so the reason for the configurator defect is discoverable rather than folklore.
+ */
+export declare const AURA_PRIMITIVE_AXES: {
+    /**
+     * A torus is a ring in the local XY plane. Its major radius spans X and Y
+     * equally; its tube thickness lies on Z. To thin a ring, scale **Z**. Scaling
+     * Y collapses the ring into a bar.
+     */
+    readonly torus: {
+        readonly ringPlane: "xy";
+        readonly tubeAxis: "z";
+        readonly thinAxis: "z";
+    };
+    /** A cylinder's height runs along Y; its circular cross-section spans X and Z. */
+    readonly cylinder: {
+        readonly heightAxis: "y";
+        readonly crossSection: "xz";
+        readonly thinAxis: "y";
+    };
+    /** A plane lies in XZ with its normal on Y. */
+    readonly plane: {
+        readonly plane: "xz";
+        readonly normalAxis: "y";
+        readonly thinAxis: "y";
+    };
+    /** Boxes, spheres and capsules are axis-symmetric about their own extents. */
+    readonly box: {
+        readonly thinAxis: undefined;
+    };
+    readonly sphere: {
+        readonly thinAxis: undefined;
+    };
+    readonly capsule: {
+        readonly heightAxis: "y";
+        readonly thinAxis: undefined;
+    };
+};
+/** Visual treatments a focus indicator can apply. */
+export type FocusIndicator = "ring" | "halo" | "bounding-box" | "outline" | "emissive-highlight";
+export interface FocusTargetBounds {
+    /** World position of the target's centre. */
+    readonly center: AuraVec3;
+    /** World-space extents of the target. */
+    readonly size: AuraVec3;
+    /**
+     * Euler rotation of the target, radians. Indicator geometry inherits it so a
+     * rotated part gets a rotated indicator rather than an axis-aligned one.
+     */
+    readonly rotation?: AuraVec3 | undefined;
+}
+export interface FocusTarget extends FocusTargetBounds {
+    readonly id: string;
+    /** Human-readable name used for the callout and accessibility text. */
+    readonly label?: string | undefined;
+}
+export interface FocusOptions {
+    /** Indicators to draw. Defaults to a ring plus a callout label. */
+    readonly indicators?: readonly FocusIndicator[] | undefined;
+    readonly color?: AuraColor | undefined;
+    /** Draw a callout label anchored to the target. Defaults to true. */
+    readonly callout?: boolean | undefined;
+    /** Text for the callout. Defaults to the target's label. */
+    readonly calloutText?: string | undefined;
+    /** Draw a leader line from the callout to the target. Defaults to true. */
+    readonly leaderLine?: boolean | undefined;
+    /** Dim non-focused geometry. Reported as intent; the route applies it. */
+    readonly dimOthers?: boolean | undefined;
+    /** Move the camera to frame the target. Defaults to true. */
+    readonly cameraFocus?: boolean | undefined;
+    /**
+     * Extra clearance between the indicator and the target surface, as a fraction
+     * of the target's largest extent. Defaults to 0.12 so a ring reads as
+     * surrounding the part rather than intersecting it.
+     */
+    readonly clearance?: number | undefined;
+    /** Node-name prefix, so indicator nodes are identifiable in evidence. */
+    readonly namePrefix?: string | undefined;
+    /**
+     * Viewport aspect ratio, used only to size camera framing distance. Defaults
+     * to 16/9.
+     */
+    readonly aspect?: number | undefined;
+    /** Mobile viewports need a wider frame; defaults to false. */
+    readonly compactViewport?: boolean | undefined;
+}
+export interface FocusCameraIntent {
+    readonly position: AuraVec3;
+    readonly target: AuraVec3;
+    readonly fov: number;
+    /** True when the target's bounds fit inside the frustum at this distance. */
+    readonly containsTarget: boolean;
+}
+export interface FocusResult {
+    readonly kind: "aura-focus-result";
+    readonly targetId: string;
+    /** Indicator geometry and labels to add to the scene. */
+    readonly nodes: readonly AuraSceneNode[];
+    readonly camera: FocusCameraIntent | undefined;
+    /** Set when `dimOthers` was requested, so the route can lower other materials. */
+    readonly dimOthers: boolean;
+    /** Machine-checkable statement that indicators surround their target. */
+    readonly invariants: FocusInvariantReport;
+    /** Screen-reader text describing the current selection. */
+    readonly accessibilityLabel: string;
+}
+export interface FocusInvariantReport {
+    readonly schema: "aura3d-focus-invariants/1.0";
+    readonly checks: readonly {
+        readonly id: string;
+        readonly description: string;
+        readonly passes: boolean;
+        readonly detail: string;
+    }[];
+    readonly passes: boolean;
+}
+/**
+ * Build focus feedback for a target.
+ *
+ * The ring is sized from the target's own extents and thinned on **Z**, the
+ * torus tube axis, then rotated to lie in the horizontal plane. Because the
+ * radius is uniform in the ring's own plane it stays a ring for any target
+ * aspect ratio -- which is what the flattened-bar defect got wrong.
+ */
+export declare function focusObject(target: FocusTarget, options?: FocusOptions): FocusResult;
+/**
+ * Focus a named region of a subject rather than a standalone object.
+ *
+ * This is how a configurator focuses "the earcups" without knowing where the
+ * earcups are in world space: the region is normalized to the subject's bounds,
+ * so it follows the asset.
+ */
+export declare function focusSemanticRegion(subject: PlacedBounds, region: SemanticRegion, options?: FocusOptions): FocusResult;
+/** Empty focus state: no indicators, no camera change, reset accessibility text. */
+export declare function clearFocus(): FocusResult;
+/**
+ * Camera pose that frames a target's bounds.
+ *
+ * Distance is derived from the vertical and horizontal half-angles so the whole
+ * target fits regardless of viewport aspect. A compact (mobile) viewport pulls
+ * back further because UI chrome takes vertical space.
+ */
+export declare function focusCameraIntent(center: AuraVec3, size: AuraVec3, options?: {
+    readonly aspect?: number | undefined;
+    readonly compactViewport?: boolean | undefined;
+    readonly fov?: number | undefined;
+}): FocusCameraIntent;
+//# sourceMappingURL=FocusSelection.d.ts.map

package/dist/engine/agent-api/FocusSelection.d.ts.map

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

package/dist/engine/agent-api/FocusSelection.js

@@ -0,0 +1,436 @@
+/**
+ * Reusable object focus and selection feedback.
+ *
+ * ## The defect this replaces
+ *
+ * The product configurator built its focus indicator by hand:
+ *
+ * ```ts
+ * primitives.torus({ ... }).position(...p).rotate(1.5708, 0, 0).scale([1.22, 0.08, 0.78])
+ * ```
+ *
+ * Aura3D's torus primitive is generated in local XY -- the ring lies in the XY
+ * plane with its tube thin on **Z** (`createTorusGeometry` sweeps `cos u, sin u`
+ * into X/Y and puts the tube's `sin v` on Z). Scaling `[1.22, 0.08, 0.78]`
+ * therefore squashes the ring's own **Y radius** to 8%, turning the circle into a
+ * flat horizontal sliver. The subsequent `rotate(pi/2, 0, 0)` tips that sliver
+ * into the ground plane, and it renders as the "random yellow/white bar" the
+ * user reported. A working ring in the same codebase uses `[0.72, 0.72, 0.028]`
+ * -- equal X/Y radii, thin on Z -- which is why the two looked unrelated.
+ *
+ * Changing those three constants would have fixed one route and left the trap in
+ * place for every other. The real defects are: primitive local axes were not
+ * documented, and no reusable focus feedback existed, so every route invented
+ * its own indicator geometry.
+ *
+ * This module removes the need to know the torus axis convention at all. A route
+ * states intent -- focus this target, with a ring and a callout -- and gets
+ * correct indicator geometry for any target size, orientation, or nonuniform
+ * scale.
+ *
+ * Pure and dependency-free: it returns scene-node JSON and camera intent, so it
+ * is unit-testable without a renderer and reusable by any route or kit.
+ */
+import { containsPoint, distanceOutsideBounds, placedBounds, resolveSemanticRegion } from "./SpatialAnchoring.js";
+/**
+ * Local-axis conventions for Aura3D primitives.
+ *
+ * Published so a route that must build custom geometry can do so correctly, and
+ * so the reason for the configurator defect is discoverable rather than folklore.
+ */
+export const AURA_PRIMITIVE_AXES = {
+    /**
+     * A torus is a ring in the local XY plane. Its major radius spans X and Y
+     * equally; its tube thickness lies on Z. To thin a ring, scale **Z**. Scaling
+     * Y collapses the ring into a bar.
+     */
+    torus: { ringPlane: "xy", tubeAxis: "z", thinAxis: "z" },
+    /** A cylinder's height runs along Y; its circular cross-section spans X and Z. */
+    cylinder: { heightAxis: "y", crossSection: "xz", thinAxis: "y" },
+    /** A plane lies in XZ with its normal on Y. */
+    plane: { plane: "xz", normalAxis: "y", thinAxis: "y" },
+    /** Boxes, spheres and capsules are axis-symmetric about their own extents. */
+    box: { thinAxis: undefined },
+    sphere: { thinAxis: undefined },
+    capsule: { heightAxis: "y", thinAxis: undefined }
+};
+const DEFAULT_INDICATORS = ["ring"];
+/**
+ * Build focus feedback for a target.
+ *
+ * The ring is sized from the target's own extents and thinned on **Z**, the
+ * torus tube axis, then rotated to lie in the horizontal plane. Because the
+ * radius is uniform in the ring's own plane it stays a ring for any target
+ * aspect ratio -- which is what the flattened-bar defect got wrong.
+ */
+export function focusObject(target, options = {}) {
+    const indicators = options.indicators ?? DEFAULT_INDICATORS;
+    const color = options.color ?? "#fde68a";
+    const prefix = options.namePrefix ?? `focus ${target.id}`;
+    const size = normalizeSize(target.size);
+    const maxExtent = Math.max(size[0], size[1], size[2]);
+    const clearance = Math.max(0, options.clearance ?? 0.12);
+    const rotation = target.rotation ?? [0, 0, 0];
+    const nodes = [];
+    // Horizontal radius that encloses the target's footprint, plus clearance.
+    const footprintRadius = Math.sqrt(size[0] * size[0] + size[2] * size[2]) / 2;
+    const ringRadius = footprintRadius * (1 + clearance);
+    if (indicators.includes("ring")) {
+        nodes.push(focusRingNode({
+            name: `${prefix} selection ring`,
+            center: target.center,
+            radius: ringRadius,
+            // The ring sits at the target's vertical centre so it reads as encircling
+            // the part rather than sitting under it.
+            color,
+            rotation,
+            // Tube thickness is a fraction of the ring's own radius, not of the
+            // target's largest extent. Using the largest extent made the tube thicker
+            // than the radius for tall thin targets (an antenna produced a disc).
+            tubeScale: ringTubeScale(ringRadius)
+        }));
+    }
+    if (indicators.includes("halo")) {
+        // A halo is a larger, softer ring in the same plane, offset above the target.
+        nodes.push(focusRingNode({
+            name: `${prefix} selection halo`,
+            center: [target.center[0], target.center[1] + size[1] / 2 + maxExtent * 0.06, target.center[2]],
+            radius: ringRadius * 1.22,
+            color,
+            rotation,
+            tubeScale: ringTubeScale(ringRadius * 1.22) * 0.6,
+            opacity: 0.42
+        }));
+    }
+    if (indicators.includes("bounding-box")) {
+        nodes.push(...focusBoundingBoxNodes(prefix, target.center, size, rotation, color, clearance));
+    }
+    if (indicators.includes("outline")) {
+        // An outline is a thin shell slightly larger than the target, drawn as an
+        // additive box so it reads as an edge highlight without hiding the part.
+        nodes.push({
+            kind: "primitive",
+            primitive: "box",
+            name: `${prefix} selection outline shell`,
+            material: { color, emissive: color, emissiveIntensity: 0.5, opacity: 0.18 },
+            position: target.center,
+            rotation,
+            scale: [size[0] * (1 + clearance * 0.5), size[1] * (1 + clearance * 0.5), size[2] * (1 + clearance * 0.5)]
+        });
+    }
+    if (indicators.includes("emissive-highlight")) {
+        nodes.push({
+            kind: "primitive",
+            primitive: "sphere",
+            name: `${prefix} selection emissive highlight`,
+            material: { color, emissive: color, emissiveIntensity: 1.1, opacity: 0.22 },
+            position: target.center,
+            scale: [size[0] * 0.5, size[1] * 0.5, size[2] * 0.5]
+        });
+    }
+    // Callout label, anchored outside the target so it never sits inside geometry.
+    const wantsCallout = options.callout ?? true;
+    const calloutText = options.calloutText ?? target.label ?? target.id;
+    let calloutPosition;
+    if (wantsCallout) {
+        calloutPosition = [
+            target.center[0] + ringRadius + maxExtent * 0.18,
+            target.center[1] + size[1] * 0.5 + maxExtent * 0.14,
+            target.center[2]
+        ];
+        nodes.push({
+            kind: "label",
+            label: "callout",
+            name: `${prefix} callout`,
+            text: calloutText,
+            target: target.label ?? target.id,
+            position: calloutPosition,
+            color: "#f8fafc",
+            background: "#111827",
+            size: Math.max(0.12, maxExtent * 0.22),
+            leader: options.leaderLine ?? true,
+            // The label is anchored to a world point and projected each frame by the
+            // label renderer, so it stays attached while the camera moves.
+            anchorWorldPosition: target.center,
+            collisionAvoidance: true,
+            occlusionAware: true
+        });
+    }
+    const camera = (options.cameraFocus ?? true)
+        ? focusCameraIntent(target.center, size, {
+            aspect: options.aspect ?? 16 / 9,
+            compactViewport: options.compactViewport ?? false
+        })
+        : undefined;
+    const invariants = checkFocusInvariants({
+        target,
+        size,
+        ringRadius,
+        nodes,
+        calloutPosition,
+        camera
+    });
+    return {
+        kind: "aura-focus-result",
+        targetId: target.id,
+        nodes,
+        camera,
+        dimOthers: options.dimOthers ?? false,
+        invariants,
+        accessibilityLabel: `${calloutText} selected${camera ? ", camera focused" : ""}`
+    };
+}
+/**
+ * Focus a named region of a subject rather than a standalone object.
+ *
+ * This is how a configurator focuses "the earcups" without knowing where the
+ * earcups are in world space: the region is normalized to the subject's bounds,
+ * so it follows the asset.
+ */
+export function focusSemanticRegion(subject, region, options = {}) {
+    const resolved = resolveSemanticRegion(subject, region);
+    return focusObject({
+        id: resolved.id,
+        label: resolved.label ?? resolved.id,
+        center: resolved.center,
+        // A point region would produce a zero-radius ring. Fall back to a readable
+        // fraction of the subject so `extent`-less regions still get usable feedback.
+        size: [
+            resolved.size[0] > 0 ? resolved.size[0] : subject.size[0] * 0.3,
+            resolved.size[1] > 0 ? resolved.size[1] : subject.size[1] * 0.3,
+            resolved.size[2] > 0 ? resolved.size[2] : subject.size[2] * 0.3
+        ]
+    }, options);
+}
+/** Empty focus state: no indicators, no camera change, reset accessibility text. */
+export function clearFocus() {
+    return {
+        kind: "aura-focus-result",
+        targetId: "",
+        nodes: [],
+        camera: undefined,
+        dimOthers: false,
+        invariants: { schema: "aura3d-focus-invariants/1.0", checks: [], passes: true },
+        accessibilityLabel: "no selection"
+    };
+}
+/**
+ * Camera pose that frames a target's bounds.
+ *
+ * Distance is derived from the vertical and horizontal half-angles so the whole
+ * target fits regardless of viewport aspect. A compact (mobile) viewport pulls
+ * back further because UI chrome takes vertical space.
+ */
+export function focusCameraIntent(center, size, options = {}) {
+    const fov = options.fov ?? 38;
+    const aspect = Math.max(0.2, options.aspect ?? 16 / 9);
+    const normalized = normalizeSize(size);
+    const halfHeight = normalized[1] / 2;
+    const halfWidth = Math.max(normalized[0], normalized[2]) / 2;
+    const vFov = (fov * Math.PI) / 180;
+    const hFov = 2 * Math.atan(Math.tan(vFov / 2) * aspect);
+    const distanceForHeight = halfHeight / Math.tan(vFov / 2);
+    const distanceForWidth = halfWidth / Math.tan(hFov / 2);
+    // Distance must also clear the target's bounding sphere against the narrower
+    // frustum half-angle. Sizing only from the axis-aligned half-extents framed a
+    // cube's faces but clipped its corners, so `containsTarget` was false for
+    // ordinary targets and the invariant reported a failure with no visible cause.
+    const boundingRadius = Math.sqrt(normalized[0] ** 2 + normalized[1] ** 2 + normalized[2] ** 2) / 2;
+    const narrowHalfAngle = Math.min(vFov, hFov) / 2;
+    const distanceForSphere = boundingRadius / Math.max(1e-6, Math.sin(narrowHalfAngle));
+    const margin = options.compactViewport === true ? 2.1 : 1.6;
+    const distance = Math.max(distanceForHeight, distanceForWidth, distanceForSphere) * margin;
+    // Approach from the front and slightly above: a three-quarter view reads the
+    // target's form without looking straight down on it.
+    const position = [
+        center[0] + distance * 0.42,
+        center[1] + distance * 0.34,
+        center[2] + distance * 0.84
+    ];
+    const eyeDistance = Math.sqrt((position[0] - center[0]) ** 2 + (position[1] - center[1]) ** 2 + (position[2] - center[2]) ** 2);
+    // The target fits when its bounding sphere is inside both frustum half-angles.
+    const containsTarget = eyeDistance * Math.sin(narrowHalfAngle) >= boundingRadius;
+    return { position, target: center, fov, containsTarget };
+}
+/**
+ * Ring geometry that is correct for any target proportions.
+ *
+ * Radius is applied uniformly in the torus's own ring plane (X and Y) and the
+ * tube is thinned on Z, its documented thin axis. The node is then rotated so
+ * the ring lies horizontally around the target. Compare with the defect, which
+ * thinned Y -- inside the ring plane -- and produced a bar.
+ */
+function focusRingNode(options) {
+    const radius = Math.max(1e-4, options.radius);
+    return {
+        kind: "primitive",
+        primitive: "torus",
+        name: options.name,
+        material: {
+            color: options.color,
+            emissive: options.color,
+            emissiveIntensity: 0.72,
+            opacity: options.opacity ?? 0.72
+        },
+        position: options.center,
+        // Tip the ring plane (local XY) into the world XZ plane, then apply the
+        // target's own yaw so a rotated part gets an aligned ring.
+        rotation: [Math.PI / 2 + options.rotation[0], options.rotation[1], options.rotation[2]],
+        // X and Y carry the ring radius; Z carries tube thickness.
+        scale: [radius, radius, Math.max(1e-4, options.tubeScale)]
+    };
+}
+/** Twelve thin bars forming a wireframe box around the target. */
+function focusBoundingBoxNodes(prefix, center, size, rotation, color, clearance) {
+    const half = [
+        (size[0] * (1 + clearance)) / 2,
+        (size[1] * (1 + clearance)) / 2,
+        (size[2] * (1 + clearance)) / 2
+    ];
+    const thickness = Math.max(0.004, Math.max(size[0], size[1], size[2]) * 0.012);
+    const material = { color, emissive: color, emissiveIntensity: 0.8, opacity: 0.85 };
+    const bars = [];
+    const signs = [-1, 1];
+    // Edges along X.
+    for (const y of signs) {
+        for (const z of signs) {
+            bars.push({
+                kind: "primitive",
+                primitive: "box",
+                name: `${prefix} bounds edge x ${y > 0 ? "top" : "bottom"} ${z > 0 ? "front" : "rear"}`,
+                material,
+                position: [center[0], center[1] + half[1] * y, center[2] + half[2] * z],
+                rotation,
+                scale: [half[0] * 2, thickness, thickness]
+            });
+        }
+    }
+    // Edges along Y.
+    for (const x of signs) {
+        for (const z of signs) {
+            bars.push({
+                kind: "primitive",
+                primitive: "box",
+                name: `${prefix} bounds edge y ${x > 0 ? "right" : "left"} ${z > 0 ? "front" : "rear"}`,
+                material,
+                position: [center[0] + half[0] * x, center[1], center[2] + half[2] * z],
+                rotation,
+                scale: [thickness, half[1] * 2, thickness]
+            });
+        }
+    }
+    // Edges along Z.
+    for (const x of signs) {
+        for (const y of signs) {
+            bars.push({
+                kind: "primitive",
+                primitive: "box",
+                name: `${prefix} bounds edge z ${x > 0 ? "right" : "left"} ${y > 0 ? "top" : "bottom"}`,
+                material,
+                position: [center[0] + half[0] * x, center[1] + half[1] * y, center[2]],
+                rotation,
+                scale: [thickness, thickness, half[2] * 2]
+            });
+        }
+    }
+    return bars;
+}
+/**
+ * Assert that focus feedback is actually correct.
+ *
+ * These are the checks a pixel metric cannot make: that the indicator encloses
+ * the target rather than intersecting or missing it, that it is not degenerate
+ * in any axis (the bar defect), that the callout sits outside the target, and
+ * that the camera frames the selection.
+ */
+function checkFocusInvariants(input) {
+    const checks = [];
+    const footprintRadius = Math.sqrt(input.size[0] ** 2 + input.size[2] ** 2) / 2;
+    const ring = input.nodes.find((node) => node.kind === "primitive" && node.primitive === "torus" && (node.name ?? "").includes("selection ring"));
+    if (ring) {
+        const scale = toVec3Scale(ring.scale);
+        // The two ring-plane axes must be equal, or the ring is an ellipse/bar.
+        const ratio = scale[0] > 0 && scale[1] > 0 ? Math.min(scale[0], scale[1]) / Math.max(scale[0], scale[1]) : 0;
+        checks.push({
+            id: "ring-not-flattened",
+            description: "selection ring radius is uniform in the torus ring plane (local X and Y), so it cannot collapse into a bar",
+            passes: ratio > 0.999,
+            detail: `ring-plane scale ratio ${round(ratio)} for scale [${scale.map(round).join(", ")}]`
+        });
+        checks.push({
+            id: "ring-thin-axis-is-tube-axis",
+            description: "selection ring is thinned on Z, the torus tube axis",
+            passes: scale[2] < scale[0] && scale[2] < scale[1],
+            detail: `z scale ${round(scale[2])} vs ring radius ${round(scale[0])}`
+        });
+        checks.push({
+            id: "ring-surrounds-target",
+            description: "selection ring radius exceeds the target footprint radius",
+            passes: input.ringRadius >= footprintRadius,
+            detail: `ring radius ${round(input.ringRadius)} vs target footprint radius ${round(footprintRadius)}`
+        });
+        const degenerate = scale.some((value) => !(value > 0) || !Number.isFinite(value));
+        checks.push({
+            id: "no-degenerate-indicator-scale",
+            description: "no indicator axis is zero, negative or non-finite",
+            passes: !degenerate,
+            detail: degenerate ? `degenerate scale [${scale.join(", ")}]` : "all axes positive and finite"
+        });
+    }
+    if (input.calloutPosition) {
+        const bounds = placedBounds({
+            position: [input.target.center[0], input.target.center[1] - input.size[1] / 2, input.target.center[2]],
+            size: input.size,
+            floorY: input.target.center[1] - input.size[1] / 2
+        });
+        const outside = !containsPoint(bounds, input.calloutPosition);
+        checks.push({
+            id: "callout-outside-target",
+            description: "callout label is anchored outside the target bounds so it is not hidden inside geometry",
+            passes: outside,
+            detail: outside
+                ? `callout ${round(distanceOutsideBounds(bounds, input.calloutPosition))} units outside bounds`
+                : "callout sits inside the target bounds"
+        });
+    }
+    if (input.camera) {
+        checks.push({
+            id: "camera-contains-target",
+            description: "focus camera frames the whole target",
+            passes: input.camera.containsTarget,
+            detail: input.camera.containsTarget ? "target bounding sphere inside frustum" : "target does not fit at the computed distance"
+        });
+    }
+    return {
+        schema: "aura3d-focus-invariants/1.0",
+        checks,
+        passes: checks.every((check) => check.passes)
+    };
+}
+/**
+ * Tube thickness for a focus ring of a given radius.
+ *
+ * Proportional to the radius so the ring reads as a ring at any scale, with a
+ * floor so a ring around a tiny part is still visible on screen.
+ */
+function ringTubeScale(radius) {
+    return Math.max(0.004, radius * 0.09);
+}
+function normalizeSize(size) {
+    return [
+        Math.max(1e-6, Math.abs(size[0])),
+        Math.max(1e-6, Math.abs(size[1])),
+        Math.max(1e-6, Math.abs(size[2]))
+    ];
+}
+function toVec3Scale(scale) {
+    if (scale === undefined)
+        return [1, 1, 1];
+    if (typeof scale === "number")
+        return [scale, scale, scale];
+    return [scale[0], scale[1], scale[2]];
+}
+function round(value) {
+    return Math.round(value * 1e6) / 1e6;
+}
+//# sourceMappingURL=FocusSelection.js.map

package/dist/engine/agent-api/FocusSelection.js.map

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