@aura3d/engine 3.0.0 → 4.0.0

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

@@ -0,0 +1,126 @@
+// PR 0b-1 carve-out (CONTRACTS.md §3.2) — verbatim move from agent-api/index.ts; 0 changed logic lines.
+// PRD-10 T3.8: `instances.model` gains the §4.1 world options (`static`,
+// `chunkSize`, `shadowLod`, `wind`, `impostor`). When any is set, the emitted
+// node carries the §7.1.5 `placements` block so the C-36 handler promotes it
+// to a `scatter` node under `A3D_QR_WORLD`; flag off consumes the model node
+// exactly as before.
+import { AuraNodeBuilder } from "../nodes/builder.js";
+import { colorToRgba } from "../colorUtils.js";
+import { geometry } from "../nodes/geometry.js";
+import { model } from "../nodes/model.js";
+import { primitive } from "../nodes/primitives.js";
+import { createInstancedModelNode } from "../../instances-model/InstancedModel.js";
+import { defineAuraCustomGeometry } from "../RootGeometry.js";
+import { material } from "./material.js";
+import { lazyNamespace } from "../lazyNamespace.js";
+export const instances = lazyNamespace(() => ({
+    box: (options) => instancedPrimitive("box", options),
+    sphere: (options) => instancedPrimitive("sphere", options),
+    plane: (options) => instancedPrimitive("plane", options),
+    cylinder: (options) => instancedPrimitive("cylinder", options),
+    capsule: (options) => instancedPrimitive("capsule", options),
+    torus: (options) => instancedPrimitive("torus", options),
+    custom: (spec, options) => instancedPrimitive("custom", { ...options, geometry: defineAuraCustomGeometry(spec) }),
+    /**
+     * P2 instanced GLB models (muse3jsparity-PRD): one draw class for repeated
+     * static models. Skinned actors fall back with a D1 warning at mount (E1
+     * owns rigs); explicitly unaware materials warn at build.
+     */
+    model: (asset, options) => {
+        const built = createInstancedModelNode({
+            asset,
+            ...(options.name !== undefined ? { name: options.name } : {}),
+            transforms: options.transforms.map((transform) => ({
+                ...(transform.position !== undefined ? { position: [...transform.position] } : {}),
+                ...(transform.rotation !== undefined ? { rotation: [...transform.rotation] } : {}),
+                ...(transform.scale !== undefined
+                    ? { scale: typeof transform.scale === "number" ? transform.scale : [...transform.scale] }
+                    : {})
+            })),
+            ...(options.colors ? { colors: [...options.colors] } : {}),
+            ...(options.lod ? { lod: options.lod } : {}),
+            materialInstancingAware: options.instancingAware ?? true,
+            ...(options.maxInstancesPerDraw !== undefined ? { maxInstancesPerDraw: options.maxInstancesPerDraw } : {}),
+            ...(options.material?.name !== undefined ? { materialName: options.material.name } : {})
+        });
+        const base = model(asset, options).toJSON();
+        // PRD-10 T3.8: world options present ⇒ stamp the §7.1.5 placements block
+        // (structural extension of the model node; promoted to `kind:"scatter"` by
+        // the C-36 world handler under A3D_QR_WORLD — see compiler/world.ts).
+        const worldOpted = options.static !== undefined || options.chunkSize !== undefined || options.shadowLod !== undefined || options.wind !== undefined || options.impostor !== undefined;
+        const placements = worldOpted ? packScatterPlacements(asset, options.transforms, options.colors, options) : undefined;
+        const node = {
+            ...base,
+            ...(placements ? { placements } : {}),
+            instances: built.node.instances.map((transform) => ({
+                ...(transform.position ? { position: [...transform.position] } : {}),
+                ...(transform.rotation ? { rotation: [...transform.rotation] } : {}),
+                ...(transform.scale !== undefined ? { scale: transform.scale } : {})
+            })),
+            // Safe: the builder only accepts AuraColor strings above, so no RGB tuples reach the node.
+            ...(built.node.instanceColors ? { instanceColors: [...built.node.instanceColors] } : {}),
+            ...(built.node.instanceLod ? { instanceLod: built.node.instanceLod } : {}),
+            instanceCulling: {
+                instanceCount: built.node.instanceCulling.instanceCount,
+                centroid: [...built.node.instanceCulling.centroid],
+                boundingRadius: built.node.instanceCulling.boundingRadius,
+                cullable: true
+            },
+            ...(built.diagnostics.fallbackWarning ? { instancedModelWarning: built.diagnostics.fallbackWarning.diagnostic } : {})
+        };
+        return new AuraNodeBuilder(node);
+    }
+}));
+/** Compose `transforms` into packed row-major mat3x4 matrices (12 f32 each). */
+function packScatterPlacements(asset, transforms, colors, options) {
+    const matrices = new Float32Array(transforms.length * 12);
+    transforms.forEach((t, i) => {
+        const p = t.position ?? [0, 0, 0];
+        const r = t.rotation ?? [0, 0, 0];
+        const sc = t.scale === undefined ? [1, 1, 1] : typeof t.scale === "number" ? [t.scale, t.scale, t.scale] : t.scale;
+        // Euler XYZ → R = Rx*Ry*Rz applied column-major; emit row-major mat3x4.
+        const cx = Math.cos(r[0]), sx = Math.sin(r[0]);
+        const cy = Math.cos(r[1]), sy = Math.sin(r[1]);
+        const cz = Math.cos(r[2]), sz = Math.sin(r[2]);
+        // R = Rz*Ry*Rx (three.js default order ZYX applied R*v)
+        const m00 = cy * cz, m01 = -cy * sz, m02 = sy;
+        const m10 = cz * sx * sy + cx * sz, m11 = cx * cz - sx * sy * sz, m12 = -cy * sx;
+        const m20 = sx * sz - cx * cz * sy, m21 = cx * sy * sz + cz * sx, m22 = cx * cy;
+        // §9.3 row-major mat3x4: 3 rows × [basis row, translation component];
+        // scale multiplies the basis columns (sc[j] on column j).
+        const o = i * 12;
+        matrices[o + 0] = m00 * sc[0];
+        matrices[o + 1] = m01 * sc[1];
+        matrices[o + 2] = m02 * sc[2];
+        matrices[o + 3] = p[0];
+        matrices[o + 4] = m10 * sc[0];
+        matrices[o + 5] = m11 * sc[1];
+        matrices[o + 6] = m12 * sc[2];
+        matrices[o + 7] = p[1];
+        matrices[o + 8] = m20 * sc[0];
+        matrices[o + 9] = m21 * sc[1];
+        matrices[o + 10] = m22 * sc[2];
+        matrices[o + 11] = p[2];
+    });
+    const packedColors = colors && colors.length > 0
+        ? Float32Array.from(colors.flatMap((c) => colorToRgba(c)))
+        : undefined;
+    return {
+        asset,
+        matrices,
+        ...(packedColors ? { colors: packedColors } : {}),
+        ...(options.wind !== undefined ? { wind: options.wind } : {}),
+        ...(options.impostor !== undefined ? { impostor: options.impostor } : {}),
+        ...(options.shadowLod !== undefined ? { shadowLod: options.shadowLod } : {}),
+        // §11 surface table: chunkSize defaults to 32 when the call has > 256 instances.
+        ...(options.chunkSize !== undefined || transforms.length > 256 ? { chunkSize: options.chunkSize ?? 32 } : {})
+    };
+}
+export function instancedPrimitive(primitiveName, options) {
+    if (options.transforms.length === 0)
+        throw new Error("Aura3D instancing requires at least one transform.");
+    if (options.colors && options.colors.length !== options.transforms.length)
+        throw new Error("Aura3D instance color count must match transform count.");
+    return primitive(primitiveName, { ...options, instances: options.transforms, instanceColors: options.colors });
+}
+//# sourceMappingURL=instances.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instances.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/instances.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,yEAAyE;AACzE,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,qBAAqB;AAGrB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAA2B,MAAM,yCAAyC,CAAC;AAC5G,OAAO,EAAE,wBAAwB,EAA+B,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5C,GAAG,EAAE,CAAC,OAA6H,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC;IAC1K,MAAM,EAAE,CAAC,OAA6H,EAAE,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC;IAChL,KAAK,EAAE,CAAC,OAA6H,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC;IAC9K,QAAQ,EAAE,CAAC,OAA6H,EAAE,EAAE,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC;IACpL,OAAO,EAAE,CAAC,OAA6H,EAAE,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC;IAClL,KAAK,EAAE,CAAC,OAA6H,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC;IAC9K,MAAM,EAAE,CACN,IAA4B,EAC5B,OAGC,EACD,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3F;;;;OAIG;IACH,KAAK,EAAE,CACL,KAAa,EACb,OAYC,EAC+B,EAAE;QAClC,MAAM,KAAK,GAAG,wBAAwB,CAAC;YACrC,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACjD,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAuB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxG,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAuB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxG,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS;oBAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAuB,EAAE;oBAC/G,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;YACH,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,uBAAuB,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;YACxD,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1G,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzF,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5C,yEAAyE;QACzE,2EAA2E;QAC3E,sEAAsE;QACtE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;QACtL,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtH,MAAM,IAAI,GAAmE;YAC3E,GAAG,IAAI;YACP,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBAClD,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChF,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChF,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrE,CAAC,CAAC;YACH,2FAA2F;YAC3F,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,eAAe,EAAE;gBACf,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa;gBACvD,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAa;gBAC9D,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc;gBACzD,QAAQ,EAAE,IAAa;aACxB;YACD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtH,CAAC;QACF,OAAO,IAAI,eAAe,CAAgB,IAAI,CAAC,CAAC;IAClD,CAAC;CACQ,CAAA,CAAC,CAAC;AAcb,gFAAgF;AAChF,SAAS,qBAAqB,CAC5B,KAA4B,EAC5B,UAAwC,EACxC,MAAwC,EACxC,OAA0K;IAE1K,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC1D,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnH,wEAAwE;QACxE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,wDAAwD;QACxD,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;QACjF,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC;QAChF,sEAAsE;QACtE,0DAA0D;QAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACjB,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpH,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpH,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxH,CAAC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAC9C,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IACd,OAAO;QACL,KAAK;QACL,QAAQ;QACR,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,iFAAiF;QACjF,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9G,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,aAA6C,EAAE,OAA6H;IAC7M,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC3G,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACtJ,OAAO,SAAS,CAAC,aAAa,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACjH,CAAC"}

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

@@ -0,0 +1,35 @@
+import type { AuraVec3, AuraInteractionNode } from "./types.js";
+import { AuraNodeBuilder } from "./builder.js";
+export declare const interactions: {
+    readonly orbit: (options?: {
+        readonly target?: string;
+    }) => AuraNodeBuilder<AuraInteractionNode>;
+    readonly pointer: (options?: {
+        readonly target?: string;
+    }) => AuraNodeBuilder<AuraInteractionNode>;
+    readonly keyboard: (options?: {
+        readonly target?: string;
+    }) => AuraNodeBuilder<AuraInteractionNode>;
+    readonly hover: (options?: {
+        readonly target?: string;
+        readonly selected?: string;
+    }) => AuraNodeBuilder<AuraInteractionNode>;
+    readonly raycastHover: (options?: {
+        readonly target?: string;
+        readonly selected?: string;
+    }) => AuraNodeBuilder<AuraInteractionNode>;
+    readonly highlight: (options?: {
+        readonly target?: string;
+        readonly selected?: string;
+    }) => AuraNodeBuilder<AuraInteractionNode>;
+    readonly dragVector: (options?: {
+        readonly target?: string;
+        readonly vector?: AuraVec3;
+    }) => AuraNodeBuilder<AuraInteractionNode>;
+    readonly clickImpulse: (options?: {
+        readonly target?: string;
+        readonly impulse?: number;
+        readonly vector?: AuraVec3;
+    }) => AuraNodeBuilder<AuraInteractionNode>;
+};
+//# sourceMappingURL=interactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/interactions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,eAAO,MAAM,YAAY;+BACN;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAQ,eAAe,CAAC,mBAAmB,CAAC;iCAMtE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAQ,eAAe,CAAC,mBAAmB,CAAC;kCAMvE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAQ,eAAe,CAAC,mBAAmB,CAAC;+BAM3E;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAQ,eAAe,CAAC,mBAAmB,CAAC;sCAO7F;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAQ,eAAe,CAAC,mBAAmB,CAAC;mCAEvG;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAQ,eAAe,CAAC,mBAAmB,CAAC;oCAEnG;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;KAAE,KAAQ,eAAe,CAAC,mBAAmB,CAAC;sCAOlG;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;KAAE,KAAQ,eAAe,CAAC,mBAAmB,CAAC;CAQ/I,CAAC"}

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

@@ -0,0 +1,41 @@
+// PRD-15 Phase 3 carve-out (CONTRACTS.md §3.2) — verbatim move from agent-api/index.ts; 0 changed logic lines.
+import { AuraNodeBuilder } from "./builder.js";
+export const interactions = {
+    orbit: (options = {}) => new AuraNodeBuilder({
+        kind: "interaction",
+        mode: "orbit",
+        target: options.target
+    }),
+    pointer: (options = {}) => new AuraNodeBuilder({
+        kind: "interaction",
+        mode: "pointer",
+        target: options.target
+    }),
+    keyboard: (options = {}) => new AuraNodeBuilder({
+        kind: "interaction",
+        mode: "keyboard",
+        target: options.target
+    }),
+    hover: (options = {}) => new AuraNodeBuilder({
+        kind: "interaction",
+        mode: "hover",
+        target: options.target,
+        selected: options.selected
+    }),
+    raycastHover: (options = {}) => interactions.hover(options),
+    highlight: (options = {}) => interactions.hover({ target: options.target, selected: options.selected ?? options.target }),
+    dragVector: (options = {}) => new AuraNodeBuilder({
+        kind: "interaction",
+        mode: "drag-vector",
+        target: options.target,
+        vector: options.vector ?? [1, 0, 0]
+    }),
+    clickImpulse: (options = {}) => new AuraNodeBuilder({
+        kind: "interaction",
+        mode: "click-impulse",
+        target: options.target,
+        impulse: options.impulse ?? 1,
+        vector: options.vector ?? [1, 0, 0]
+    })
+};
+//# sourceMappingURL=interactions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/interactions.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAG/G,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,CAAC,UAAwC,EAAE,EAAwC,EAAE,CAC1F,IAAI,eAAe,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;IACJ,OAAO,EAAE,CAAC,UAAwC,EAAE,EAAwC,EAAE,CAC5F,IAAI,eAAe,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;IACJ,QAAQ,EAAE,CAAC,UAAwC,EAAE,EAAwC,EAAE,CAC7F,IAAI,eAAe,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;IACJ,KAAK,EAAE,CAAC,UAAoE,EAAE,EAAwC,EAAE,CACtH,IAAI,eAAe,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;IACJ,YAAY,EAAE,CAAC,UAAoE,EAAE,EAAwC,EAAE,CAC7H,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;IAC7B,SAAS,EAAE,CAAC,UAAoE,EAAE,EAAwC,EAAE,CAC1H,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAC9F,UAAU,EAAE,CAAC,UAAoE,EAAE,EAAwC,EAAE,CAC3H,IAAI,eAAe,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KACpC,CAAC;IACJ,YAAY,EAAE,CAAC,UAA+F,EAAE,EAAwC,EAAE,CACxJ,IAAI,eAAe,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;QAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KACpC,CAAC;CACI,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { AuraLabelNode } from "./types.js";
+import { AuraNodeBuilder } from "./builder.js";
+type AuraLabelOptions = Partial<Omit<AuraLabelNode, "kind" | "label" | "text">>;
+type AuraAnchorLabelOptions = Partial<Omit<AuraLabelNode, "kind" | "label" | "text" | "target">>;
+export declare const labels: {
+    readonly billboard: (text: string, options?: AuraLabelOptions) => AuraNodeBuilder<AuraLabelNode>;
+    readonly anchor: (text: string, target: string, options?: AuraAnchorLabelOptions) => AuraNodeBuilder<AuraLabelNode>;
+    readonly axisTick: (text: string, options?: AuraLabelOptions) => AuraNodeBuilder<AuraLabelNode>;
+    readonly callout: (text: string, target: string, options?: AuraAnchorLabelOptions) => AuraNodeBuilder<AuraLabelNode>;
+    readonly hud: (text: string, options?: AuraLabelOptions) => AuraNodeBuilder<AuraLabelNode>;
+};
+export {};
+//# sourceMappingURL=labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/labels.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,KAAK,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;AAEhF,KAAK,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;AAEjG,eAAO,MAAM,MAAM;+BACC,MAAM,YAAW,gBAAgB,KAAQ,eAAe,CAAC,aAAa,CAAC;4BAW1E,MAAM,UAAU,MAAM,YAAW,sBAAsB,KAAQ,eAAe,CAAC,aAAa,CAAC;8BAY3F,MAAM,YAAW,gBAAgB,KAAQ,eAAe,CAAC,aAAa,CAAC;6BAWxE,MAAM,UAAU,MAAM,YAAW,sBAAsB,KAAQ,eAAe,CAAC,aAAa,CAAC;yBAYjG,MAAM,YAAW,gBAAgB,KAAQ,eAAe,CAAC,aAAa,CAAC;CAU3E,CAAC"}

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

@@ -0,0 +1,61 @@
+// PRD-15 Phase 3 carve-out (CONTRACTS.md §3.2) — verbatim move from agent-api/index.ts; 0 changed logic lines.
+import { AuraNodeBuilder } from "./builder.js";
+export const labels = {
+    billboard: (text, options = {}) => new AuraNodeBuilder({
+        kind: "label",
+        label: "billboard",
+        text,
+        color: options.color ?? "#e0f2fe",
+        background: options.background ?? "#020617",
+        size: options.size ?? 0.42,
+        collisionAvoidance: options.collisionAvoidance ?? true,
+        occlusionAware: options.occlusionAware ?? true,
+        ...options
+    }),
+    anchor: (text, target, options = {}) => new AuraNodeBuilder({
+        kind: "label",
+        label: "anchor",
+        text,
+        target,
+        color: options.color ?? "#e0f2fe",
+        background: options.background ?? "#020617",
+        size: options.size ?? 0.38,
+        collisionAvoidance: options.collisionAvoidance ?? true,
+        occlusionAware: options.occlusionAware ?? true,
+        ...options
+    }),
+    axisTick: (text, options = {}) => new AuraNodeBuilder({
+        kind: "label",
+        label: "axis-tick",
+        text,
+        color: options.color ?? "#bfdbfe",
+        background: options.background ?? "#0f172a",
+        size: options.size ?? 0.26,
+        collisionAvoidance: options.collisionAvoidance ?? true,
+        occlusionAware: options.occlusionAware ?? true,
+        ...options
+    }),
+    callout: (text, target, options = {}) => new AuraNodeBuilder({
+        kind: "label",
+        label: "callout",
+        text,
+        target,
+        leader: options.leader ?? true,
+        color: options.color ?? "#fde68a",
+        background: options.background ?? "#111827",
+        size: options.size ?? 0.34,
+        collisionAvoidance: options.collisionAvoidance ?? true,
+        ...options
+    }),
+    hud: (text, options = {}) => new AuraNodeBuilder({
+        kind: "label",
+        label: "hud",
+        text,
+        color: options.color ?? "#f8fafc",
+        background: options.background ?? "#020617",
+        size: options.size ?? 0.32,
+        screenAnchor: options.screenAnchor ?? "top-left",
+        ...options
+    })
+};
+//# sourceMappingURL=labels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/labels.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAG/G,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAM/C,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,SAAS,EAAE,CAAC,IAAY,EAAE,UAA4B,EAAE,EAAkC,EAAE,CAAC,IAAI,eAAe,CAAC;QAC/G,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,WAAW;QAClB,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;QAC3C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;QACtD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;QAC9C,GAAG,OAAO;KACX,CAAC;IACF,MAAM,EAAE,CAAC,IAAY,EAAE,MAAc,EAAE,UAAkC,EAAE,EAAkC,EAAE,CAAC,IAAI,eAAe,CAAC;QAClI,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,QAAQ;QACf,IAAI;QACJ,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;QAC3C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;QACtD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;QAC9C,GAAG,OAAO;KACX,CAAC;IACF,QAAQ,EAAE,CAAC,IAAY,EAAE,UAA4B,EAAE,EAAkC,EAAE,CAAC,IAAI,eAAe,CAAC;QAC9G,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,WAAW;QAClB,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;QAC3C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;QACtD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;QAC9C,GAAG,OAAO;KACX,CAAC;IACF,OAAO,EAAE,CAAC,IAAY,EAAE,MAAc,EAAE,UAAkC,EAAE,EAAkC,EAAE,CAAC,IAAI,eAAe,CAAC;QACnI,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,SAAS;QAChB,IAAI;QACJ,MAAM;QACN,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;QAC3C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;QACtD,GAAG,OAAO;KACX,CAAC;IACF,GAAG,EAAE,CAAC,IAAY,EAAE,UAA4B,EAAE,EAAkC,EAAE,CAAC,IAAI,eAAe,CAAC;QACzG,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,KAAK;QACZ,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;QAC3C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,UAAU;QAChD,GAAG,OAAO;KACX,CAAC;CACM,CAAC"}

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

@@ -0,0 +1,78 @@
+import type { AuraColor, AuraLightNode, AuraVec3 } from "./types.js";
+import type { AuraDirectionalShadowOptions, AuraLocalShadowOptions } from "../../contracts/lighting.js";
+import { AuraNodeBuilder } from "./builder.js";
+export declare const lights: {
+    readonly ambient: (options?: {
+        readonly name?: string;
+        readonly intensity?: number;
+        readonly color?: AuraColor;
+    }) => AuraNodeBuilder<AuraLightNode>;
+    readonly hemisphere: (options?: {
+        readonly name?: string;
+        readonly skyColor?: AuraColor;
+        readonly groundColor?: AuraColor;
+        readonly intensity?: number;
+        readonly position?: AuraVec3;
+    }) => AuraNodeBuilder<AuraLightNode>;
+    readonly directional: (options?: {
+        readonly name?: string;
+        readonly position?: AuraVec3;
+        readonly target?: AuraVec3;
+        readonly intensity?: number;
+        readonly color?: AuraColor;
+        readonly shadow?: boolean | AuraDirectionalShadowOptions;
+    }) => AuraNodeBuilder<AuraLightNode>;
+    readonly point: (options?: {
+        readonly name?: string;
+        readonly position?: AuraVec3;
+        readonly intensity?: number;
+        readonly power?: number;
+        readonly distance?: number;
+        readonly decay?: number;
+        readonly color?: AuraColor;
+        readonly shadow?: boolean | AuraLocalShadowOptions;
+    }) => AuraNodeBuilder<AuraLightNode>;
+    readonly spot: (options?: {
+        readonly name?: string;
+        readonly position?: AuraVec3;
+        readonly target?: AuraVec3;
+        readonly angle?: number;
+        readonly penumbra?: number;
+        readonly distance?: number;
+        readonly decay?: number;
+        readonly intensity?: number;
+        readonly power?: number;
+        readonly color?: AuraColor;
+        readonly shadow?: boolean | AuraLocalShadowOptions;
+    }) => AuraNodeBuilder<AuraLightNode>;
+    readonly studio: (options?: {
+        readonly intensity?: number;
+    }) => AuraNodeBuilder<AuraLightNode>;
+    readonly rect: (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;
+        readonly target?: AuraVec3;
+        readonly intensity?: number;
+        readonly color?: AuraColor;
+        readonly width?: number;
+        readonly height?: number;
+        readonly twoSided?: boolean;
+    }) => AuraNodeBuilder<AuraLightNode>;
+    readonly productStudio: (options?: {
+        readonly intensity?: number;
+    }) => AuraNodeBuilder<AuraLightNode>;
+    readonly materialLab: (options?: {
+        readonly intensity?: number;
+    }) => AuraNodeBuilder<AuraLightNode>;
+};
+//# sourceMappingURL=lights.d.ts.map

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

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

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

@@ -0,0 +1,111 @@
+// 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";
+export const lights = {
+    ambient: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "ambient",
+        name: options.name,
+        intensity: options.intensity ?? 0.28,
+        color: options.color ?? "#ffffff"
+    }),
+    hemisphere: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "hemisphere",
+        name: options.name ?? "hemisphere light",
+        position: options.position ?? [0, 1, 0],
+        intensity: options.intensity ?? 1,
+        color: options.skyColor ?? "#bcd7ff",
+        // CCR-02-2 additive field: the C-36 handler reads groundColor.
+        ...(options.groundColor !== undefined ? { groundColor: options.groundColor } : {})
+    }),
+    directional: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "directional",
+        name: options.name,
+        position: options.position ?? [3, 4, 3],
+        ...(options.target !== undefined ? { target: options.target } : {}),
+        intensity: options.intensity ?? 1.5,
+        color: options.color ?? "#ffffff",
+        shadow: options.shadow
+    }),
+    point: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "point",
+        name: options.name,
+        position: options.position ?? [2, 2.5, 1.5],
+        intensity: options.intensity ?? 8,
+        ...(options.power !== undefined ? { power: options.power } : {}),
+        ...(options.distance !== undefined ? { distance: options.distance } : {}),
+        ...(options.decay !== undefined ? { decay: options.decay } : {}),
+        ...(options.shadow !== undefined ? { shadow: options.shadow } : {}),
+        color: options.color ?? "#ffffff"
+    }),
+    spot: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "spot",
+        name: options.name ?? "spot light",
+        position: options.position ?? [0, 4, 0],
+        target: options.target,
+        angle: options.angle ?? Math.PI / 6,
+        penumbra: options.penumbra ?? 0.4,
+        distance: options.distance ?? 12,
+        decay: options.decay,
+        intensity: options.intensity ?? 30,
+        ...(options.power !== undefined ? { power: options.power } : {}),
+        color: options.color ?? "#ffffff",
+        shadow: options.shadow
+    }),
+    studio: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "studio",
+        name: "studio-key-fill-rim",
+        intensity: options.intensity ?? 1,
+        color: "#ffffff",
+        position: [0, 3, 4]
+    }),
+    rect: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "rect",
+        name: options.name ?? "rect area light",
+        position: options.position ?? [0, 2.6, 1.8],
+        ...(options.target !== undefined ? { target: options.target } : {}),
+        intensity: options.intensity ?? 1.4,
+        color: options.color ?? "#ffffff",
+        width: options.width ?? 2.2,
+        height: options.height ?? 1.2,
+        // CCR-02-2 additive field.
+        ...(options.twoSided !== undefined ? { twoSided: options.twoSided } : {})
+    }),
+    softbox: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "softbox",
+        name: options.name ?? "large softbox light",
+        position: options.position ?? [-2.2, 2.4, 2.2],
+        intensity: options.intensity ?? 1.75,
+        color: options.color ?? "#f7fbff",
+        width: options.width ?? 2.4,
+        height: options.height ?? 1.6
+    }),
+    productStudio: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "softbox",
+        name: "product-studio-softbox-rig",
+        position: [-2.25, 2.45, 2.35],
+        intensity: options.intensity ?? 1.7,
+        color: "#f7fbff",
+        width: 2.5,
+        height: 1.6
+    }),
+    materialLab: (options = {}) => new AuraNodeBuilder({
+        kind: "light",
+        light: "softbox",
+        name: "material-lab-rect-softbox-rig",
+        position: [0, 2.55, 1.8],
+        intensity: options.intensity ?? 1.9,
+        color: "#ffffff",
+        width: 3.2,
+        height: 1.2
+    })
+};
+//# sourceMappingURL=lights.js.map

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

@@ -0,0 +1 @@
+{"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/material.d.ts

@@ -0,0 +1,84 @@
+import type { AuraEditableMaterialParameters, AuraMaterialCapabilityDiagnostics, AuraMaterialCapabilityInput, AuraMaterialInspectorPanel, AuraMaterialSpec, AuraMaterialVisualQAResult, AuraProceduralTextureSpec, AuraSceneNode } from "../nodes/types.js";
+import { proceduralTexture } from "../nodes/materialTools.js";
+import type { AuraSolarPlanetMaterialPreset } from "../nodes/types.js";
+/**
+ * PRD-04 P2-10 (R15): enumerable symbol on preset-produced material specs. Its value is the set of
+ * spec field names that came from the preset's own defaults rather than the caller's options, so the
+ * flag-on override lowering (C-15, §7.2) can ignore preset-defaulted values — most importantly
+ * `spec.color`, which the legacy tint bridge treated as authored intent even when it was a stock
+ * preset colour.
+ */
+export declare const AURA_PRESET_DEFAULTS: unique symbol;
+/** Merge `defaults` with `options` and mark which resulting fields the user did not supply. */
+export declare function resolveMaterialSpecDefaults(defaults: AuraMaterialSpec, options: AuraMaterialSpec): AuraMaterialSpec;
+export declare const material: {
+    readonly pbr: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly physical: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly emissive: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly metal: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly rubber: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly glass: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly clearcoat: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly neon: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly reflectiveFloor: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly solarSun: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly solarCorona: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly fabric: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly chrome: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly brushedMetal: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly frostedGlass: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly clearGlass: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly blackRubber: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly matteClay: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly ceramic: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly glowingEmissive: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly clearcoatPaint: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly sneakerMesh: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly sneakerRubber: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    /**
+     * #84 (R-14-14 §8.6, Bank Shot): billiard felt. A pure C-03 sheen lobe over a rough diffuse base,
+     * with the fabric procedural normal for the nap. No clearcoat, no metal.
+     */
+    readonly felt: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    /**
+     * #84 (R-14-14 §8.6, Bank Shot rails): high-gloss lacquered wood/plastic. A dielectric base under a
+     * C-03 clearcoat lobe; colour and roughness stay authored-overridable.
+     */
+    readonly lacquer: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    /**
+     * #84 (R-14-14 §8.6, Turbo Drift): metallic car paint. A semi-metal base coat under a C-03
+     * clearcoat lobe. The flake normal is not a procedural kind yet (#84 follow-up); the base
+     * roughness carries the metallic sparkle spread meanwhile.
+     */
+    readonly carPaint: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    /**
+     * #80 (R-14-14 §8.1) / #258: planet surface presets, delegating to the solar-system preset table
+     * (`nodes/solar.ts`) so both entry points share one definition. Caller options override the preset.
+     */
+    readonly planet: (preset?: AuraSolarPlanetMaterialPreset, options?: AuraMaterialSpec) => AuraMaterialSpec;
+    /**
+     * #80 (R-14-14 §8.1): atmosphere / shield shell for a slightly larger sphere around a planet.
+     * Translucent, emissive, unlit-looking (roughness 1, no env): the §8.1 fallback without a rim
+     * term. The rim falloff lobe is #88.
+     */
+    readonly atmosphere: (options?: AuraMaterialSpec) => AuraMaterialSpec;
+    readonly proceduralTexture: typeof proceduralTexture;
+    readonly proceduralTextures: {
+        readonly fabric: (options?: Partial<Omit<AuraProceduralTextureSpec, "kind" | "texture">>) => AuraProceduralTextureSpec;
+        readonly rubber: (options?: Partial<Omit<AuraProceduralTextureSpec, "kind" | "texture">>) => AuraProceduralTextureSpec;
+        readonly brushedMetal: (options?: Partial<Omit<AuraProceduralTextureSpec, "kind" | "texture">>) => AuraProceduralTextureSpec;
+        readonly plastic: (options?: Partial<Omit<AuraProceduralTextureSpec, "kind" | "texture">>) => AuraProceduralTextureSpec;
+    };
+    readonly parameters: (name: string, spec: AuraMaterialSpec) => AuraEditableMaterialParameters;
+    readonly fromParameters: (parameters: AuraEditableMaterialParameters) => AuraMaterialSpec;
+    readonly labParameters: () => readonly AuraEditableMaterialParameters[];
+    readonly presets: () => Readonly<Record<string, AuraMaterialSpec>>;
+    readonly inspector: (name: string, spec: AuraMaterialSpec) => AuraMaterialInspectorPanel;
+    /**
+     * @deprecated Name-heuristic check (#192, PRD-13 T1.11): every result carries
+     * `deprecated: true, kind: "structural-name-heuristic"`. Use `structuralQA.material` instead.
+     */
+    readonly visualQA: (nodes: readonly AuraSceneNode[]) => AuraMaterialVisualQAResult;
+    readonly capabilityDiagnostics: (input?: AuraMaterialCapabilityInput) => AuraMaterialCapabilityDiagnostics;
+};
+//# sourceMappingURL=material.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/material.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,8BAA8B,EAAE,iCAAiC,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5P,OAAO,EAAoF,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAKhJ,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAIvE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAAO,MAA4C,CAAC;AAEvF,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAUnH;AAeD,eAAO,MAAM,QAAQ;6BACJ,gBAAgB,KAAQ,gBAAgB;kCAMnC,gBAAgB,KAAQ,gBAAgB;kCAqBxC,gBAAgB,KAAQ,gBAAgB;+BAQ3C,gBAAgB,KAAQ,gBAAgB;gCASvC,gBAAgB,KAAQ,gBAAgB;+BAMzC,gBAAgB,KAAQ,gBAAgB;mCAepC,gBAAgB,KAAQ,gBAAgB;8BAS7C,gBAAgB,KAAQ,gBAAgB;yCAS7B,gBAAgB,KAAQ,gBAAgB;kCAS/C,gBAAgB,KAAQ,gBAAgB;qCAWrC,gBAAgB,KAAQ,gBAAgB;gCAa7C,gBAAgB,KAAQ,gBAAgB;gCAUxC,gBAAgB,KAAQ,gBAAgB;sCAUlC,gBAAgB,KAAQ,gBAAgB;sCAUxC,gBAAgB,KAAQ,gBAAgB;oCAU1C,gBAAgB,KAAQ,gBAAgB;qCAUvC,gBAAgB,KAAQ,gBAAgB;mCAQ1C,gBAAgB,KAAQ,gBAAgB;iCAQ1C,gBAAgB,KAAQ,gBAAgB;yCAQhC,gBAAgB,KAAQ,gBAAgB;wCAQzC,gBAAgB,KAAQ,gBAAgB;qCAU3C,gBAAgB,KAAQ,gBAAgB;uCAQtC,gBAAgB,KAAQ,gBAAgB;IAOjE;;;OAGG;8BACa,gBAAgB,KAAQ,gBAAgB;IAUxD;;;OAGG;iCACgB,gBAAgB,KAAQ,gBAAgB;IAU3D;;;;OAIG;kCACiB,gBAAgB,KAAQ,gBAAgB;IAU5D;;;OAGG;+BACc,6BAA6B,YAAqB,gBAAgB,KAAQ,gBAAgB;IAG3G;;;;OAIG;oCACmB,gBAAgB,KAAQ,gBAAgB;;;oCAW1C,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;oCAC5D,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;0CACtD,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;qCACjE,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;;gCAE9D,MAAM,QAAQ,gBAAgB,KAAG,8BAA8B;0CAkBrD,8BAA8B,KAAG,gBAAgB;kCAgB3D,SAAS,8BAA8B,EAAE;4BAO/C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;+BAiBrC,MAAM,QAAQ,gBAAgB,KAAG,0BAA0B;IAC7E;;;OAGG;+BACe,SAAS,aAAa,EAAE,KAAG,0BAA0B;6CACvC,2BAA2B,KAAG,iCAAiC;CAErF,CAAC"}