@aura3d/engine 4.0.2 → 4.0.4

package/dist/engine/agent-api/nodes/instances.js

@@ -12,6 +12,7 @@ import { primitive } from "../nodes/primitives.js";
 import { createInstancedModelNode } from "../../instances-model/InstancedModel.js";
 import { defineAuraCustomGeometry } from "../RootGeometry.js";
 import { material } from "./material.js";
+import { instancedMeshFactory } from "./batchedState.js";
 import { lazyNamespace } from "../lazyNamespace.js";
 export const instances = lazyNamespace(() => ({
     box: (options) => instancedPrimitive("box", options),
@@ -20,6 +21,26 @@ export const instances = lazyNamespace(() => ({
     cylinder: (options) => instancedPrimitive("cylinder", options),
     capsule: (options) => instancedPrimitive("capsule", options),
     torus: (options) => instancedPrimitive("torus", options),
+    // ── threejs-parity L2-01 (SG-03): instanced widened kinds share the params
+    // block with their `primitives.*` siblings.
+    cone: (options) => instancedPrimitive("cone", options),
+    circle: (options) => instancedPrimitive("circle", options),
+    ring: (options) => instancedPrimitive("ring", options),
+    tube: (options) => instancedPrimitive("tube", options),
+    lathe: (options) => instancedPrimitive("lathe", options),
+    extrude: (options) => instancedPrimitive("extrude", options),
+    shape: (options) => instancedPrimitive("shape", options),
+    torusKnot: (options) => instancedPrimitive("torusKnot", options),
+    polyhedron: (options) => instancedPrimitive("polyhedron", options),
+    roundedBox: (options) => instancedPrimitive("roundedBox", options),
+    /**
+     * SG-01 (parity-L5): `instances.mesh(geometry, material, count)` — three.js
+     * `InstancedMesh` parity on the dense instance store (per-instance
+     * transforms/colors via `setMatrixAt`/`setColorAt`, `count` draw bound,
+     * `computeBoundingSphere`). `geometry` accepts a @aura3d/rendering
+     * `Geometry`, a builtin primitive name, or an `AuraCustomGeometrySpec`.
+     */
+    mesh: (geometry, material, count) => instancedMeshFactory()(geometry, material, count),
     custom: (spec, options) => instancedPrimitive("custom", { ...options, geometry: defineAuraCustomGeometry(spec) }),
     /**
      * P2 instanced GLB models (muse3jsparity-PRD): one draw class for repeated

package/dist/engine/agent-api/nodes/instances.js.map

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

package/dist/engine/agent-api/nodes/lensFlare.d.ts

@@ -0,0 +1,126 @@
+/**
+ * threejs-parity AD-15 (P2): `lights.lensFlare` — three's `Lensflare` /
+ * `LensflareElement` (examples/jsm/objects/Lensflare.js).
+ *
+ * Emits an additive `"lensflare"` scene node. The production runtime
+ * (`compiler/lensFlare.ts`) projects the light through the frame's camera and
+ * submits one camera-facing additive sprite per element, placed with three's
+ * exact screen-space rule:
+ *
+ *   ndc(element) = ndc(light) + (-2 · ndc(light)) · element.distance
+ *   size(element) = element.size px            (square, device pixels)
+ *
+ * so `distance: 0` sits on the light and `distance: 1` is its mirror through
+ * the screen centre. Deviations from three (documented, not hidden):
+ * - three fades the flare with a GPU occlusion query against the depth buffer.
+ *   The production pass exposes no depth readback to the scene compiler, so
+ *   `occlusion: "frustum"` (default) hides the flare when the light is behind
+ *   the camera and fades it toward the screen edge instead; geometry that
+ *   occludes the light on screen does NOT dim the flare. `"none"` draws it
+ *   whenever the light is in front of the camera.
+ * - Elements draw through the sprite path (`A3D_PARITY_LINES`, default-on):
+ *   additive blend, no depth test, no depth write.
+ */
+import type { AuraColor, AuraSceneNode, AuraTextureRef, AuraTransformSpec, AuraVec3 } from "./types.js";
+import { AuraNodeBuilder } from "./builder.js";
+export interface AuraLensFlareElement {
+    /** Flare texture (a `texture.*` handle). Omitted → a generated soft radial glow. */
+    readonly texture?: AuraTextureRef;
+    /** Square size in device pixels (three's `LensflareElement.size`). */
+    readonly size: number;
+    /** 0 = on the light, 1 = mirrored through the screen centre (three's `distance`). */
+    readonly distance: number;
+    /** Tint multiplied over the texture (default white). */
+    readonly color?: AuraColor;
+}
+export type AuraLensFlareOcclusion = "frustum" | "none";
+export interface AuraLensFlareOptions {
+    readonly name?: string;
+    /** World position of the light source. Ignored when `light` resolves. */
+    readonly position?: AuraVec3;
+    /** Name of an authored `lights.*` node whose position is the source. */
+    readonly light?: string;
+    /** Defaults to three's webgl_lensflares example layout (one large glow + four small discs). */
+    readonly elements?: readonly AuraLensFlareElement[];
+    /** See module doc. Default `"frustum"`. */
+    readonly occlusion?: AuraLensFlareOcclusion;
+    /** Fraction of the half-screen over which the flare fades out toward the edge (0 = hard cut). Default 0.15. */
+    readonly edgeFade?: number;
+    /** Multiplies every element colour (default 1). */
+    readonly intensity?: number;
+    readonly runtime?: import("./types.js").AuraRuntimeNodeSpec;
+}
+export interface AuraLensFlareNode extends AuraTransformSpec {
+    readonly kind: "lensflare";
+    readonly name?: string;
+    readonly light?: string;
+    readonly elements: readonly AuraLensFlareElement[];
+    readonly occlusion: AuraLensFlareOcclusion;
+    readonly edgeFade: number;
+    readonly intensity: number;
+    readonly runtime?: import("./types.js").AuraRuntimeNodeSpec;
+}
+export declare function isAuraLensFlareNode(node: {
+    readonly kind: string;
+}): node is AuraLensFlareNode;
+/** three's webgl_lensflares layout, sizes in pixels. */
+export declare const DEFAULT_LENS_FLARE_ELEMENTS: readonly AuraLensFlareElement[];
+export declare function assertAuraLensFlareOptions(options: AuraLensFlareOptions): void;
+export declare function createLensFlareNode(options?: AuraLensFlareOptions): AuraNodeBuilder<AuraSceneNode>;
+export interface LensFlareCamera {
+    readonly mode?: string;
+    readonly fov?: number;
+    readonly orthographicSize?: number;
+}
+export interface LensFlareCameraFrame {
+    readonly eye: AuraVec3;
+    readonly target: AuraVec3;
+    readonly up?: AuraVec3;
+}
+export interface LensFlareBasis {
+    readonly forward: AuraVec3;
+    readonly right: AuraVec3;
+    readonly up: AuraVec3;
+}
+export declare function lensFlareCameraBasis(frame: LensFlareCameraFrame): LensFlareBasis;
+/**
+ * World position → NDC `[-1,1]²` and view depth (distance along the view
+ * direction). `null` when the point is not in front of the camera.
+ */
+export declare function projectLensFlareSource(world: AuraVec3, frame: LensFlareCameraFrame, camera: LensFlareCamera, aspect: number): {
+    readonly ndc: readonly [number, number];
+    readonly depth: number;
+} | null;
+export interface LensFlarePlacement {
+    readonly index: number;
+    /** Element centre in NDC (three's `screenPosition` uniform). */
+    readonly ndc: readonly [number, number];
+    /** Square size in device pixels. */
+    readonly sizePx: number;
+    /** three's `scale.y` uniform: `size / viewport.height` (half-height of the quad in NDC units × 1). */
+    readonly sizeNdc: number;
+    readonly distance: number;
+}
+/**
+ * three's `Lensflare.onBeforeRender` placement:
+ *   vecX = -positionScreen.x * 2; vecY = -positionScreen.y * 2
+ *   screenPosition.x = positionScreen.x + vecX * element.distance
+ *   scale.y = element.size / viewport.height
+ */
+export declare function placeLensFlareElements(lightNdc: readonly [number, number], elements: readonly {
+    readonly size: number;
+    readonly distance: number;
+}[], viewportHeightPx: number): LensFlarePlacement[];
+/** Flare opacity factor in [0,1]: 0 when the light is off-screen, ramping up over `edgeFade` of the half-screen. */
+export declare function lensFlareVisibility(lightNdc: readonly [number, number], occlusion: AuraLensFlareOcclusion, edgeFade: number): number;
+/**
+ * World-space centre and uniform scale for a camera-facing sprite that lands
+ * on `ndc` with a square size of `sizePx`, for the sprite shader's
+ * `sizeAttenuation: false` convention (perspective scale is multiplied by view
+ * depth; orthographic scale is in world units).
+ */
+export declare function lensFlareSpriteTransform(ndc: readonly [number, number], sizePx: number, frame: LensFlareCameraFrame, camera: LensFlareCamera, aspect: number, viewportHeightPx: number, planeDistance: number): {
+    readonly position: AuraVec3;
+    readonly scale: number;
+};
+//# sourceMappingURL=lensFlare.d.ts.map

package/dist/engine/agent-api/nodes/lensFlare.d.ts.map

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

package/dist/engine/agent-api/nodes/lensFlare.js

@@ -0,0 +1,184 @@
+/**
+ * threejs-parity AD-15 (P2): `lights.lensFlare` — three's `Lensflare` /
+ * `LensflareElement` (examples/jsm/objects/Lensflare.js).
+ *
+ * Emits an additive `"lensflare"` scene node. The production runtime
+ * (`compiler/lensFlare.ts`) projects the light through the frame's camera and
+ * submits one camera-facing additive sprite per element, placed with three's
+ * exact screen-space rule:
+ *
+ *   ndc(element) = ndc(light) + (-2 · ndc(light)) · element.distance
+ *   size(element) = element.size px            (square, device pixels)
+ *
+ * so `distance: 0` sits on the light and `distance: 1` is its mirror through
+ * the screen centre. Deviations from three (documented, not hidden):
+ * - three fades the flare with a GPU occlusion query against the depth buffer.
+ *   The production pass exposes no depth readback to the scene compiler, so
+ *   `occlusion: "frustum"` (default) hides the flare when the light is behind
+ *   the camera and fades it toward the screen edge instead; geometry that
+ *   occludes the light on screen does NOT dim the flare. `"none"` draws it
+ *   whenever the light is in front of the camera.
+ * - Elements draw through the sprite path (`A3D_PARITY_LINES`, default-on):
+ *   additive blend, no depth test, no depth write.
+ */
+import { AuraNodeBuilder } from "./builder.js";
+import { AuraRuntimeError } from "../compiler/errors.js";
+export function isAuraLensFlareNode(node) {
+    return node.kind === "lensflare";
+}
+/** three's webgl_lensflares layout, sizes in pixels. */
+export const DEFAULT_LENS_FLARE_ELEMENTS = [
+    { size: 700, distance: 0 },
+    { size: 60, distance: 0.6, color: "#ffd9b0" },
+    { size: 70, distance: 0.7, color: "#b0d0ff" },
+    { size: 120, distance: 0.9, color: "#ffe9c4" },
+    { size: 70, distance: 1, color: "#c4d8ff" }
+];
+function invalid(message) {
+    throw new AuraRuntimeError("invalid-lens-flare", `lights.lensFlare: ${message}`);
+}
+export function assertAuraLensFlareOptions(options) {
+    if (options.elements !== undefined) {
+        if (!Array.isArray(options.elements) || options.elements.length === 0)
+            invalid("`elements` must be a non-empty array");
+        options.elements.forEach((element, index) => {
+            if (element === null || typeof element !== "object")
+                invalid(`elements[${index}] must be an object`);
+            if (!Number.isFinite(element.size) || element.size <= 0)
+                invalid(`elements[${index}].size must be a positive finite number of pixels`);
+            if (!Number.isFinite(element.distance))
+                invalid(`elements[${index}].distance must be a finite number`);
+            if (element.texture !== undefined && element.texture.kind !== "aura-texture-ref")
+                invalid(`elements[${index}].texture must be a texture.* handle`);
+        });
+    }
+    if (options.occlusion !== undefined && options.occlusion !== "frustum" && options.occlusion !== "none") {
+        invalid(`occlusion must be "frustum" or "none", got ${String(options.occlusion)}`);
+    }
+    if (options.edgeFade !== undefined && (!Number.isFinite(options.edgeFade) || options.edgeFade < 0 || options.edgeFade > 1)) {
+        invalid("edgeFade must be a number in [0, 1]");
+    }
+    if (options.intensity !== undefined && (!Number.isFinite(options.intensity) || options.intensity < 0)) {
+        invalid("intensity must be a non-negative finite number");
+    }
+    if (options.light !== undefined && (typeof options.light !== "string" || options.light.length === 0)) {
+        invalid("`light` must be the name of an authored light node");
+    }
+}
+export function createLensFlareNode(options = {}) {
+    assertAuraLensFlareOptions(options);
+    return new AuraNodeBuilder({
+        kind: "lensflare",
+        name: options.name ?? "lens flare",
+        position: options.position ?? [0, 0, 0],
+        ...(options.light !== undefined ? { light: options.light } : {}),
+        elements: options.elements ?? DEFAULT_LENS_FLARE_ELEMENTS,
+        occlusion: options.occlusion ?? "frustum",
+        edgeFade: options.edgeFade ?? 0.15,
+        intensity: options.intensity ?? 1,
+        ...(options.runtime ? { runtime: options.runtime } : {})
+    });
+}
+const sub = (a, b) => [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+const dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+const cross = (a, b) => [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
+const normalize = (a) => {
+    const length = Math.hypot(a[0], a[1], a[2]) || 1;
+    return [a[0] / length, a[1] / length, a[2] / length];
+};
+export function lensFlareCameraBasis(frame) {
+    const forward = normalize(sub(frame.target, frame.eye));
+    const worldUp = frame.up ?? [0, 1, 0];
+    // Looking straight along the up axis degenerates the cross product; fall back to +Z.
+    let right = cross(forward, worldUp);
+    if (Math.hypot(right[0], right[1], right[2]) < 1e-6)
+        right = cross(forward, [0, 0, 1]);
+    right = normalize(right);
+    return { forward, right, up: cross(right, forward) };
+}
+const isOrthographic = (camera) => camera.mode === "orthographic" || camera.mode === "isometric";
+/**
+ * World position → NDC `[-1,1]²` and view depth (distance along the view
+ * direction). `null` when the point is not in front of the camera.
+ */
+export function projectLensFlareSource(world, frame, camera, aspect) {
+    const basis = lensFlareCameraBasis(frame);
+    const v = sub(world, frame.eye);
+    const depth = dot(v, basis.forward);
+    if (!(depth > 1e-6))
+        return null;
+    const x = dot(v, basis.right);
+    const y = dot(v, basis.up);
+    if (isOrthographic(camera)) {
+        const halfHeight = Math.max(1e-4, camera.orthographicSize ?? 1.4);
+        return { ndc: [x / (halfHeight * aspect), y / halfHeight], depth };
+    }
+    const tanHalf = Math.tan(((camera.fov ?? 45) * Math.PI) / 360);
+    return { ndc: [x / (depth * tanHalf * aspect), y / (depth * tanHalf)], depth };
+}
+/**
+ * three's `Lensflare.onBeforeRender` placement:
+ *   vecX = -positionScreen.x * 2; vecY = -positionScreen.y * 2
+ *   screenPosition.x = positionScreen.x + vecX * element.distance
+ *   scale.y = element.size / viewport.height
+ */
+export function placeLensFlareElements(lightNdc, elements, viewportHeightPx) {
+    const vecX = -lightNdc[0] * 2;
+    const vecY = -lightNdc[1] * 2;
+    const height = Math.max(1, viewportHeightPx);
+    return elements.map((element, index) => ({
+        index,
+        ndc: [lightNdc[0] + vecX * element.distance, lightNdc[1] + vecY * element.distance],
+        sizePx: element.size,
+        sizeNdc: element.size / height,
+        distance: element.distance
+    }));
+}
+/** Flare opacity factor in [0,1]: 0 when the light is off-screen, ramping up over `edgeFade` of the half-screen. */
+export function lensFlareVisibility(lightNdc, occlusion, edgeFade) {
+    if (occlusion === "none")
+        return 1;
+    const edge = Math.max(Math.abs(lightNdc[0]), Math.abs(lightNdc[1]));
+    if (edge >= 1)
+        return 0;
+    if (edgeFade <= 0)
+        return 1;
+    return Math.min(1, Math.max(0, (1 - edge) / edgeFade));
+}
+/**
+ * World-space centre and uniform scale for a camera-facing sprite that lands
+ * on `ndc` with a square size of `sizePx`, for the sprite shader's
+ * `sizeAttenuation: false` convention (perspective scale is multiplied by view
+ * depth; orthographic scale is in world units).
+ */
+export function lensFlareSpriteTransform(ndc, sizePx, frame, camera, aspect, viewportHeightPx, planeDistance) {
+    const basis = lensFlareCameraBasis(frame);
+    const fraction = sizePx / Math.max(1, viewportHeightPx);
+    if (isOrthographic(camera)) {
+        const halfHeight = Math.max(1e-4, camera.orthographicSize ?? 1.4);
+        const px = ndc[0] * halfHeight * aspect;
+        const py = ndc[1] * halfHeight;
+        return {
+            position: [
+                frame.eye[0] + basis.forward[0] * planeDistance + basis.right[0] * px + basis.up[0] * py,
+                frame.eye[1] + basis.forward[1] * planeDistance + basis.right[1] * px + basis.up[1] * py,
+                frame.eye[2] + basis.forward[2] * planeDistance + basis.right[2] * px + basis.up[2] * py
+            ],
+            scale: 2 * halfHeight * fraction
+        };
+    }
+    const tanHalf = Math.tan(((camera.fov ?? 45) * Math.PI) / 360);
+    const px = ndc[0] * tanHalf * aspect * planeDistance;
+    const py = ndc[1] * tanHalf * planeDistance;
+    return {
+        position: [
+            frame.eye[0] + basis.forward[0] * planeDistance + basis.right[0] * px + basis.up[0] * py,
+            frame.eye[1] + basis.forward[1] * planeDistance + basis.right[1] * px + basis.up[1] * py,
+            frame.eye[2] + basis.forward[2] * planeDistance + basis.right[2] * px + basis.up[2] * py
+        ],
+        // The sprite shader multiplies scale by view depth; a screen fraction f of the
+        // viewport height is 2·tan(fov/2)·f of the view-space height at unit depth.
+        scale: 2 * tanHalf * fraction
+    };
+}
+//# sourceMappingURL=lensFlare.js.map

package/dist/engine/agent-api/nodes/lensFlare.js.map

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

package/dist/engine/agent-api/nodes/lights.d.ts

@@ -1,7 +1,14 @@
 import type { AuraColor, AuraLightNode, AuraVec3 } from "./types.js";
 import type { AuraDirectionalShadowOptions, AuraLocalShadowOptions } from "../../contracts/lighting.js";
 import { AuraNodeBuilder } from "./builder.js";
+import { createLensFlareNode } from "./lensFlare.js";
 export declare const lights: {
+    /**
+     * threejs-parity AD-15 (P2): three's `Lensflare` — additive flare sprites
+     * placed along the line from `position`/`light` through the screen centre.
+     * See `nodes/lensFlare.ts` for placement rules and the occlusion caveat.
+     */
+    readonly lensFlare: typeof createLensFlareNode;
     readonly ambient: (options?: {
         readonly name?: string;
         readonly intensity?: number;
@@ -14,6 +21,19 @@ export declare const lights: {
         readonly intensity?: number;
         readonly position?: AuraVec3;
     }) => AuraNodeBuilder<AuraLightNode>;
+    /**
+     * threejs-parity AD-16: three's `LightProbe` — ambient irradiance authored
+     * as 27 SH9 coefficients (e.g. from `LightProbeGenerator`) or as plain
+     * sky/ground colours. Compiles to the hemisphere-irradiance channel.
+     */
+    readonly lightProbe: (options?: {
+        readonly name?: string;
+        readonly sh?: readonly number[];
+        readonly skyColor?: AuraColor;
+        readonly groundColor?: AuraColor;
+        readonly intensity?: number;
+        readonly position?: AuraVec3;
+    }) => AuraNodeBuilder<AuraLightNode>;
     readonly directional: (options?: {
         readonly name?: string;
         readonly position?: AuraVec3;
@@ -58,6 +78,20 @@ export declare const lights: {
         readonly height?: number;
         readonly twoSided?: boolean;
     }) => AuraNodeBuilder<AuraLightNode>;
+    /**
+     * threejs-parity L7/AD-16 (P2): three's `RectAreaLight` — an alias over the
+     * `rect` area light (width × height, position + target, twoSided).
+     */
+    readonly rectArea: (options?: {
+        readonly name?: string;
+        readonly position?: AuraVec3;
+        readonly target?: AuraVec3;
+        readonly intensity?: number;
+        readonly color?: AuraColor;
+        readonly width?: number;
+        readonly height?: number;
+        readonly twoSided?: boolean;
+    }) => AuraNodeBuilder<AuraLightNode>;
     readonly softbox: (options?: {
         readonly name?: string;
         readonly position?: AuraVec3;

package/dist/engine/agent-api/nodes/lights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lights.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/lights.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lights.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/lights.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,MAAM;IACjB;;;;OAIG;;iCAEgB;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE;oCAQhF;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE;IAW5K;;;;OAIG;oCACmB;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE;qCAWtL;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,4BAA4B,CAAA;KAAE;+BAW7M;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAA;KAAE;8BAapP;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAA;KAAE;gCAgBlU;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;8BASjC;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAc7O;;;OAGG;kCACiB;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;iCAE9N;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;uCAWvN;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;qCAWjC;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;CAW9C,CAAC"}

package/dist/engine/agent-api/nodes/lights.js

@@ -1,7 +1,14 @@
 // PR 0b-1 carve-out (CONTRACTS.md §3.2) — verbatim move from agent-api/index.ts; 0 changed logic lines.
 import { AuraNodeBuilder } from "./builder.js";
 import { distance } from "../SpatialAnchoring.js";
+import { createLensFlareNode } from "./lensFlare.js";
 export const lights = {
+    /**
+     * threejs-parity AD-15 (P2): three's `Lensflare` — additive flare sprites
+     * placed along the line from `position`/`light` through the screen centre.
+     * See `nodes/lensFlare.ts` for placement rules and the occlusion caveat.
+     */
+    lensFlare: createLensFlareNode,
     ambient: (options = {}) => new AuraNodeBuilder({
         kind: "light",
         light: "ambient",
@@ -19,6 +26,21 @@ export const lights = {
         // CCR-02-2 additive field: the C-36 handler reads groundColor.
         ...(options.groundColor !== undefined ? { groundColor: options.groundColor } : {})
     }),
+    /**
+     * threejs-parity AD-16: three's `LightProbe` — ambient irradiance authored
+     * as 27 SH9 coefficients (e.g. from `LightProbeGenerator`) or as plain
+     * sky/ground colours. Compiles to the hemisphere-irradiance channel.
+     */
+    lightProbe: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "probe",
+        name: options.name ?? "light probe",
+        position: options.position ?? [0, 1, 0],
+        intensity: options.intensity ?? 1,
+        color: options.skyColor ?? "#ffffff",
+        ...(options.groundColor !== undefined ? { groundColor: options.groundColor } : {}),
+        ...(options.sh !== undefined ? { sh: options.sh } : {})
+    }),
     directional: (options = {}) => new AuraNodeBuilder({
         kind: "light",
         light: "directional",
@@ -77,6 +99,11 @@ export const lights = {
         // CCR-02-2 additive field.
         ...(options.twoSided !== undefined ? { twoSided: options.twoSided } : {})
     }),
+    /**
+     * threejs-parity L7/AD-16 (P2): three's `RectAreaLight` — an alias over the
+     * `rect` area light (width × height, position + target, twoSided).
+     */
+    rectArea: (options = {}) => lights.rect(options),
     softbox: (options = {}) => new AuraNodeBuilder({
         kind: "light",
         light: "softbox",

package/dist/engine/agent-api/nodes/lights.js.map

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

package/dist/engine/agent-api/nodes/lines.d.ts

@@ -0,0 +1,69 @@
+import { AuraNodeBuilder } from "./builder.js";
+import type { AuraColor, AuraLineNode, AuraMaterialSpec, AuraRuntimeNodeSpec, AuraVec3 } from "./types.js";
+/** `positions`/`points` input: a flat tuple array, flat number array, or packed Float32Array. */
+export type AuraLinePositionsInput = readonly AuraVec3[] | readonly number[] | Float32Array;
+export interface AuraLineOptions {
+    /** Point list (three's `geometry.setFromPoints` input). */
+    readonly points?: AuraLinePositionsInput;
+    /** Alias for `points` (three's `position` attribute). `points` wins when both are set. */
+    readonly positions?: AuraLinePositionsInput;
+    /** Per-point colors — enables vertex coloring on thin lines (SG-06). */
+    readonly colors?: readonly AuraColor[];
+    readonly material?: AuraMaterialSpec;
+    readonly name?: string;
+    /** three's `LineDashedMaterial` — requires `gapSize > 0` (dashSize default 1). */
+    readonly dashed?: boolean;
+    readonly dashSize?: number;
+    readonly gapSize?: number;
+    readonly dashOffset?: number;
+    readonly visible?: boolean;
+    readonly runtime?: AuraRuntimeNodeSpec;
+    readonly position?: AuraVec3;
+    readonly rotation?: AuraVec3;
+    readonly scale?: number | AuraVec3;
+}
+export interface AuraFatLineOptions extends AuraLineOptions {
+    /** Stroke width — CSS pixels (`worldUnits:false`, default) or world units. */
+    readonly width?: number;
+    /**
+     * three's `Line2` world-units mode: width is a world-space extent drawn as
+     * camera-facing quads (`Geometry.wideLineSegments`). Unsupported together
+     * with `dashed` — world-space quads carry no `a_lineDistance` attribute.
+     */
+    readonly worldUnits?: boolean;
+}
+/** Normalize any accepted positions input into a validated `AuraVec3[]`. */
+export declare function normalizeLinePositions(input: AuraLinePositionsInput | undefined, minCount: number, label: string): AuraVec3[];
+/**
+ * three's `computeLineDistances` (SG-06/AD-08 — the dash `a_lineDistance`
+ * basis): cumulative Euclidean arc length.
+ *  - `"line"`/`"loop"`: `d[0] = 0`, `d[i] = d[i-1] + |pᵢ − pᵢ₋₁|` — for `"loop"`
+ *    a final element carries the closing-segment length so the wrap edge
+ *    dashes correctly (three's LINE_LOOP wrap edge inherits a 0 distance; the
+ *    extra entry here is strictly more correct and only consumed by the fat
+ *    path, which draws real segment pairs).
+ *  - `"segments"`: pairs accumulate continuously — `d[i] = d[i-1]` at each
+ *    segment start (matching three's LineSegments.computeLineDistances, where
+ *    a segment's start picks up the previous segment's end distance).
+ */
+export declare function computeLineDistances(positions: readonly AuraVec3[], mode: "line" | "loop" | "segments"): readonly number[];
+/** `lines.line({ points|positions, colors?, material? })` — an open polyline (three's `Line`). */
+export declare function line(options: AuraLineOptions): AuraNodeBuilder<AuraLineNode>;
+/** `lines.loop({...})` — a closed polyline; the last point reconnects to the first (three's `LineLoop`). */
+export declare function loop(options: AuraLineOptions): AuraNodeBuilder<AuraLineNode>;
+/** `lines.segments({...})` — independent segment pairs (three's `LineSegments`). */
+export declare function segments(options: AuraLineOptions): AuraNodeBuilder<AuraLineNode>;
+/**
+ * `lines.fat({ width, worldUnits, dashed, dashSize, gapSize, dashOffset })`
+ * (AD-08): pixel-width strokes via `ScreenSpaceLineMaterial`; `worldUnits`
+ * bakes world-space quad geometry instead.
+ */
+export declare function fat(options: AuraFatLineOptions): AuraNodeBuilder<AuraLineNode>;
+/** `lines.*` namespace (SG-06/AD-08). */
+export declare const lines: {
+    readonly line: typeof line;
+    readonly loop: typeof loop;
+    readonly segments: typeof segments;
+    readonly fat: typeof fat;
+};
+//# sourceMappingURL=lines.d.ts.map

package/dist/engine/agent-api/nodes/lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/lines.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3G,iGAAiG;AACjG,MAAM,MAAM,sBAAsB,GAAG,SAAS,QAAQ,EAAE,GAAG,SAAS,MAAM,EAAE,GAAG,YAAY,CAAC;AAE5F,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IACzC,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,CAAC;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CACpC;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAoB7H;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,MAAM,EAAE,CAmB1H;AA6CD,kGAAkG;AAClG,wBAAgB,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAC,YAAY,CAAC,CAE5E;AAED,4GAA4G;AAC5G,wBAAgB,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAC,YAAY,CAAC,CAE5E;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAC,YAAY,CAAC,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,eAAe,CAAC,YAAY,CAAC,CAO9E;AAED,yCAAyC;AACzC,eAAO,MAAM,KAAK;;;;;CAAyC,CAAC"}