@aura3d/engine 4.6.2 → 4.7.1

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

@@ -1,71 +1,118 @@
-import type { AuraAssetRef, AuraColor, AuraMaterialSpec, AuraModelNode, AuraModelOptions, AuraPrimitiveNode, AuraPrimitiveOptions, AuraTransformSpec } from "../nodes/types.js";
+import type { AuraAssetRef, AuraColor, AuraGroupNode, AuraMaterialSpec, AuraModelNode, AuraModelOptions, AuraPrimitiveNode, AuraPrimitiveOptions, AuraSceneNode, AuraTransformSpec, AuraVec3 } from "../nodes/types.js";
 import { AuraNodeBuilder } from "../nodes/builder.js";
 import { type AuraCustomGeometrySpec } from "../RootGeometry.js";
+import { type AuraWindOptions } from "../world/wind.js";
+import type { AuraWindSpec } from "../../contracts/world.js";
+import { type FrameContributor } from "../../../rendering/contracts/index.js";
+import type { RenderItem } from "../../../rendering/index.js";
+/**
+ * GU47 E-G (WP-7): what an instance colour multiplies — `"base"` (base
+ * colour, today's behaviour), `"emissive"` (emissive only) or `"both"`.
+ * Stamped on the node for the renderer (E-D reads it).
+ * GU47(E-D): E-D declares `AuraInstanceColorTarget` and the node fields
+ * `AuraPrimitiveNode.instanceColorTarget` / `AuraModelNode.instanceColorTarget`
+ * in nodes/types.ts; swap this local alias and the structural stamps below to
+ * them once E-D merges.
+ */
+type InstanceColorTarget = "base" | "emissive" | "both";
+/**
+ * GU47 E-G (WP-7): instance wind without the WORLD lane. `true` sways with
+ * the default wind (or the scene's `world.wind` node when WORLD is on); an
+ * object tunes it with the `world.wind` options plus `assetHeight`, the
+ * mesh-local height that bends fully (default 1, in the mesh's own units).
+ * Every wind instance in a frame shares one wind field (the first wind node).
+ */
+export type AuraInstanceWindOption = boolean | (AuraWindOptions & {
+    readonly assetHeight?: number;
+});
+/** The options every `instances.<primitive>` builder takes. */
+export type AuraInstancedPrimitiveOptions = AuraPrimitiveOptions & {
+    readonly transforms: readonly AuraTransformSpec[];
+    readonly colors?: readonly AuraColor[];
+    /** GU47 E-G: what the instance `colors` tint (default `"base"`). */
+    readonly instanceColorTarget?: InstanceColorTarget;
+    /** GU47 E-G: bend the instances in the wind (Path G `prd10.wind` deform, no WORLD lane needed). */
+    readonly wind?: AuraInstanceWindOption;
+};
+/** The resolved wind a wind-opted node carries (`node.instanceWind`). */
+export interface AuraInstanceWind {
+    readonly wind: Required<AuraWindSpec>;
+    readonly assetHeight: number;
+}
+/** Resolve a `wind` option (`false`/absent → null). */
+export declare function resolveInstanceWind(option: AuraInstanceWindOption | undefined): AuraInstanceWind | null;
+/**
+ * Collect contributor (flag `A3D_QR_WORLD_WIND`): labels the render items of
+ * wind-opted instance nodes with the `prd10.wind:` prefix (the feature's
+ * selection contract) and, unless the WORLD lane publishes its own wind,
+ * publishes this frame's wind for the deform. Registered on the first
+ * wind-opted build, so apps without instance wind never run it.
+ */
+export declare const INSTANCE_WIND_CONTRIBUTOR: FrameContributor;
+/** Prefix the items of wind nodes; returns the first wind found (the frame's wind field). */
+export declare function labelInstanceWindItems(items: RenderItem[]): {
+    readonly items: RenderItem[];
+    readonly wind: AuraInstanceWind | null;
+};
+/**
+ * GU47 E-G (WP-7): one clustered point light per instance of
+ * `instances.model` (lamp posts, lanterns). `offset` is in the instance's
+ * local frame (it rotates and scales with the instance); `power` is in watts
+ * and `distance` is the light range in metres (`lights.point`).
+ */
+export interface AuraInstanceLightsOptions {
+    readonly offset: AuraVec3;
+    readonly color: string;
+    readonly power: number;
+    readonly distance: number;
+}
+/** `instances.model` options. */
+export type AuraInstancedModelOptions = AuraModelOptions & {
+    readonly transforms: readonly AuraTransformSpec[];
+    readonly colors?: readonly AuraColor[];
+    readonly lod?: {
+        readonly levels: readonly {
+            readonly maxDistance: number;
+        }[];
+        readonly hysteresis?: number;
+    };
+    readonly instancingAware?: boolean;
+    readonly maxInstancesPerDraw?: number;
+    readonly static?: boolean;
+    readonly chunkSize?: number;
+    readonly shadowLod?: "none" | "lod1" | "impostor";
+    /** Wind sway; GU47 E-G: works without the WORLD lane (see `AuraInstanceWindOption`). */
+    readonly wind?: AuraInstanceWindOption;
+    readonly impostor?: AuraAssetRef<"texture"> | "none";
+    /** GU47 E-G: what the instance `colors` tint (default `"base"`). */
+    readonly instanceColorTarget?: InstanceColorTarget;
+    /** GU47 E-G: one point light per instance; the builder then returns a group (model + lights). */
+    readonly lights?: AuraInstanceLightsOptions;
+};
+/** `instances.model`: a group (model + per-instance point lights) when `lights` is set, else the model node. */
+export interface AuraInstancesModelBuilder {
+    <TAsset extends AuraAssetRef<"model">>(asset: TAsset, options: AuraInstancedModelOptions & {
+        readonly lights: AuraInstanceLightsOptions;
+    }): AuraNodeBuilder<AuraGroupNode>;
+    <TAsset extends AuraAssetRef<"model">>(asset: TAsset, options: AuraInstancedModelOptions): AuraNodeBuilder<AuraModelNode>;
+}
 export declare const instances: {
-    readonly box: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly sphere: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly plane: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly cylinder: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly capsule: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly torus: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly cone: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly circle: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly ring: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly tube: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly lathe: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly extrude: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly shape: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly torusKnot: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly polyhedron: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
-    readonly roundedBox: (options: AuraPrimitiveOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly box: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly sphere: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly plane: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly cylinder: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly capsule: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly torus: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly cone: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly circle: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly ring: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly tube: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly lathe: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly extrude: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly shape: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly torusKnot: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly polyhedron: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly roundedBox: (options: AuraInstancedPrimitiveOptions) => AuraNodeBuilder<AuraPrimitiveNode>;
     /**
      * SG-01 (parity-L5): `instances.mesh(geometry, material, count)` — three.js
      * `InstancedMesh` parity on the dense instance store (per-instance
@@ -74,33 +121,28 @@ export declare const instances: {
      * `Geometry`, a builtin primitive name, or an `AuraCustomGeometrySpec`.
      */
     readonly mesh: (geometry: import("./instancedMesh.js").AuraInstancedGeometryInput, material: AuraMaterialSpec | undefined, count: number) => import("./instancedMesh.js").AuraInstancedMeshHandle;
-    readonly custom: (spec: AuraCustomGeometrySpec, options: Omit<AuraPrimitiveOptions, "geometry"> & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-    }) => AuraNodeBuilder<AuraPrimitiveNode>;
+    readonly custom: (spec: AuraCustomGeometrySpec, options: Omit<AuraInstancedPrimitiveOptions, "geometry">) => AuraNodeBuilder<AuraPrimitiveNode>;
     /**
      * 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.
+     *
+     * Skinned GLBs do not instance (each draws once). For skinned crowds use the
+     * crowd kit instead: `loadCrowdPoses(asset, ...)` + `createCrowd(...)`, one
+     * draw per baked pose (GU47 E-H). No option here can carry the async bake.
      */
-    readonly model: <TAsset extends AuraAssetRef<"model">>(asset: TAsset, options: AuraModelOptions & {
-        readonly transforms: readonly AuraTransformSpec[];
-        readonly colors?: readonly AuraColor[];
-        readonly lod?: {
-            readonly levels: readonly {
-                readonly maxDistance: number;
-            }[];
-            readonly hysteresis?: number;
-        };
-        readonly instancingAware?: boolean;
-        readonly maxInstancesPerDraw?: number;
-        readonly static?: boolean;
-        readonly chunkSize?: number;
-        readonly shadowLod?: "none" | "lod1" | "impostor";
-        readonly wind?: boolean;
-        readonly impostor?: AuraAssetRef<"texture"> | "none";
-    }) => AuraNodeBuilder<AuraModelNode>;
+    readonly model: typeof instancedModel;
 };
+declare function instancedModel<TAsset extends AuraAssetRef<"model">>(asset: TAsset, options: AuraInstancedModelOptions & {
+    readonly lights: AuraInstanceLightsOptions;
+}): AuraNodeBuilder<AuraGroupNode>;
+declare function instancedModel<TAsset extends AuraAssetRef<"model">>(asset: TAsset, options: AuraInstancedModelOptions): AuraNodeBuilder<AuraModelNode>;
+/**
+ * GU47 E-G (WP-7): one `lights.point` per instance at
+ * `position + R(rotation) * (scale * offset)`, in the model node's space.
+ * Many point lights take the renderer's clustered-light path.
+ */
+export declare function instanceLightNodes(name: string, transforms: readonly AuraTransformSpec[], spec: AuraInstanceLightsOptions): AuraSceneNode[];
 /** §7.1.5 scatter placements block carried on a model node pending promotion. */
 export interface AuraScatterPlacement {
     readonly asset: AuraAssetRef<"model">;
@@ -112,8 +154,6 @@ export interface AuraScatterPlacement {
     readonly chunkSize?: number;
     readonly tags?: readonly string[];
 }
-export declare function instancedPrimitive(primitiveName: AuraPrimitiveNode["primitive"], options: AuraPrimitiveOptions & {
-    readonly transforms: readonly AuraTransformSpec[];
-    readonly colors?: readonly AuraColor[];
-}): AuraNodeBuilder<AuraPrimitiveNode>;
+export declare function instancedPrimitive(primitiveName: AuraPrimitiveNode["primitive"], options: AuraInstancedPrimitiveOptions): AuraNodeBuilder<AuraPrimitiveNode>;
+export {};
 //# sourceMappingURL=instances.d.ts.map

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

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

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

@@ -12,8 +12,83 @@ import { INSTANCED_PRIMITIVE_OPTION_KEYS, primitive } from "../nodes/primitives.
 import { createInstancedModelNode } from "../../instances-model/InstancedModel.js";
 import { defineAuraCustomGeometry } from "../RootGeometry.js";
 import { material } from "./material.js";
+import { lights } from "./lights.js";
 import { instancedMeshFactory } from "./batchedState.js";
 import { lazyNamespace } from "../lazyNamespace.js";
+import { normalizeWind } from "../world/wind.js";
+import { registerFrameContributor } from "../../../rendering/contracts/index.js";
+import { setPrd10WindState } from "../../../rendering/world/index.js";
+/**
+ * Wind-opted nodes by their `userData` object: the compiler forwards a
+ * node's `userData` reference onto every render item it emits, so the
+ * contributor below can find the items of wind nodes without a label or
+ * compiler change. The builder gives each wind node its own copy.
+ */
+const instanceWindByUserData = new WeakMap();
+let instanceWindNodeCount = 0;
+/** Resolve a `wind` option (`false`/absent → null). */
+export function resolveInstanceWind(option) {
+    if (option === undefined || option === false)
+        return null;
+    const opts = option === true ? undefined : option;
+    const height = opts?.assetHeight;
+    return { wind: normalizeWind(opts), assetHeight: typeof height === "number" && Number.isFinite(height) && height > 0 ? height : 1 };
+}
+/** The Path G opt-in label prefix of the `prd10.wind` feature. */
+const WIND_LABEL_PREFIX = "prd10.wind:";
+/**
+ * Collect contributor (flag `A3D_QR_WORLD_WIND`): labels the render items of
+ * wind-opted instance nodes with the `prd10.wind:` prefix (the feature's
+ * selection contract) and, unless the WORLD lane publishes its own wind,
+ * publishes this frame's wind for the deform. Registered on the first
+ * wind-opted build, so apps without instance wind never run it.
+ */
+export const INSTANCE_WIND_CONTRIBUTOR = {
+    id: "prd10.instanceWind",
+    owner: "prd10",
+    flag: "A3D_QR_WORLD_WIND",
+    phases: ["collect"],
+    order: 10,
+    collect(items, ctx) {
+        if (instanceWindNodeCount === 0)
+            return items;
+        const out = labelInstanceWindItems(items);
+        if (out.wind && !ctx.flags.on("A3D_QR_WORLD"))
+            setPrd10WindState(out.wind.wind, ctx.timeSeconds, out.wind.assetHeight);
+        return out.items;
+    }
+};
+/** Prefix the items of wind nodes; returns the first wind found (the frame's wind field). */
+export function labelInstanceWindItems(items) {
+    let wind = null;
+    let out = null;
+    for (let i = 0; i < items.length; i += 1) {
+        const item = items[i];
+        const data = item.userData;
+        const spec = typeof data === "object" && data !== null ? instanceWindByUserData.get(data) : undefined;
+        if (!spec)
+            continue;
+        wind ??= spec;
+        const label = item.label ?? "";
+        if (label.startsWith(WIND_LABEL_PREFIX))
+            continue;
+        out ??= items.slice();
+        out[i] = { ...item, label: `${WIND_LABEL_PREFIX}${label}` };
+    }
+    return { items: out ?? items, wind };
+}
+let releaseInstanceWindContributor = null;
+/**
+ * Give a wind-opted node its own `userData` (a copy of the authored one),
+ * register it and make sure the contributor is installed.
+ */
+function adoptInstanceWind(userData, wind) {
+    const own = typeof userData === "object" && userData !== null ? { ...userData } : {};
+    instanceWindByUserData.set(own, wind);
+    instanceWindNodeCount += 1;
+    releaseInstanceWindContributor ??= registerFrameContributor(INSTANCE_WIND_CONTRIBUTOR);
+    return own;
+}
 export const instances = lazyNamespace(() => ({
     box: (options) => instancedPrimitive("box", options),
     sphere: (options) => instancedPrimitive("sphere", options),
@@ -46,58 +121,115 @@ export const instances = lazyNamespace(() => ({
      * 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.
+     *
+     * Skinned GLBs do not instance (each draws once). For skinned crowds use the
+     * crowd kit instead: `loadCrowdPoses(asset, ...)` + `createCrowd(...)`, one
+     * draw per baked pose (GU47 E-H). No option here can carry the async bake.
      */
-    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 = buildModel(asset, options, { builder: "instances.model", validKeys: INSTANCED_MODEL_OPTION_KEYS }).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);
-    }
+    model: instancedModel
 }));
+function instancedModel(asset, options) {
+    const model = instancedModelNode(asset, options);
+    if (!options.lights)
+        return model;
+    const node = model.toJSON();
+    const group = {
+        kind: "group",
+        name: `${node.name ?? "instances.model"} with lights`,
+        children: [node, ...instanceLightNodes(node.name ?? "instances.model", options.transforms, options.lights)]
+    };
+    return new AuraNodeBuilder(group);
+}
+/** Rotate `v` by Euler XYZ radians — the same basis as `packScatterPlacements` (three.js XYZ order). */
+function rotateEulerXYZ(v, r) {
+    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]);
+    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;
+    return [m00 * v[0] + m01 * v[1] + m02 * v[2], m10 * v[0] + m11 * v[1] + m12 * v[2], m20 * v[0] + m21 * v[1] + m22 * v[2]];
+}
+/**
+ * GU47 E-G (WP-7): one `lights.point` per instance at
+ * `position + R(rotation) * (scale * offset)`, in the model node's space.
+ * Many point lights take the renderer's clustered-light path.
+ */
+export function instanceLightNodes(name, transforms, spec) {
+    return transforms.map((t, i) => {
+        const p = t.position ?? [0, 0, 0];
+        const s = t.scale === undefined ? [1, 1, 1] : typeof t.scale === "number" ? [t.scale, t.scale, t.scale] : t.scale;
+        const local = [spec.offset[0] * s[0], spec.offset[1] * s[1], spec.offset[2] * s[2]];
+        const o = rotateEulerXYZ(local, t.rotation ?? [0, 0, 0]);
+        return lights.point({
+            name: `${name} light ${i}`,
+            position: [p[0] + o[0], p[1] + o[1], p[2] + o[2]],
+            color: spec.color,
+            power: spec.power,
+            distance: spec.distance
+        }).toJSON();
+    });
+}
+function instancedModelNode(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 = buildModel(asset, options, { builder: "instances.model", validKeys: INSTANCED_MODEL_OPTION_KEYS }).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 instanceWind = resolveInstanceWind(options.wind);
+    const placements = worldOpted
+        ? packScatterPlacements(asset, options.transforms, options.colors, { ...options, wind: options.wind === undefined ? undefined : instanceWind !== null })
+        : undefined;
+    const node = {
+        ...base,
+        ...(placements ? { placements } : {}),
+        ...(options.instanceColorTarget !== undefined ? { instanceColorTarget: options.instanceColorTarget } : {}),
+        // GU47 E-G (WP-7): wind without the WORLD lane (see INSTANCE_WIND_CONTRIBUTOR).
+        ...(instanceWind ? { instanceWind, userData: adoptInstanceWind(base.userData, instanceWind) } : {}),
+        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);
+}
 /** `instances.model` reads the `model()` options plus these (anim-phys-06). */
 const INSTANCED_MODEL_OPTION_KEYS = [
     ...MODEL_OPTION_KEYS,
     "transforms", "colors", "lod", "instancingAware", "maxInstancesPerDraw",
-    "static", "chunkSize", "shadowLod", "wind", "impostor"
+    "static", "chunkSize", "shadowLod", "wind", "impostor",
+    // GU47 E-G (WP-7)
+    "instanceColorTarget", "lights"
 ];
+/** `instances.<primitive>` / `instances.custom` read the primitive options plus these. */
+const INSTANCED_PRIMITIVE_BUILDER_KEYS = [...INSTANCED_PRIMITIVE_OPTION_KEYS, "instanceColorTarget", "wind"];
 /** Compose `transforms` into packed row-major mat3x4 matrices (12 f32 each). */
 function packScatterPlacements(asset, transforms, colors, options) {
     const matrices = new Float32Array(transforms.length * 12);
@@ -147,12 +279,24 @@ export function instancedPrimitive(primitiveName, options) {
     // Zero transforms is valid (a pool that is empty this frame): the compiler skips the node with INSTANCES_EMPTY.
     if (options.colors && options.colors.length !== options.transforms.length)
         throw new Error("Aura3D instance color count must match transform count.");
-    const { transforms, colors, ...primitiveOptions } = options;
+    const { transforms, colors, instanceColorTarget, wind, ...primitiveOptions } = options;
     // The OPTION_IGNORED note names `instances.<kind>` and accepts `transforms` / `colors` (anim-phys-07).
-    return primitive(primitiveName, { ...primitiveOptions, instances: transforms, instanceColors: colors }, {
+    const built = primitive(primitiveName, { ...primitiveOptions, instances: transforms, instanceColors: colors }, {
         builder: `instances.${primitiveName}`,
-        validKeys: INSTANCED_PRIMITIVE_OPTION_KEYS,
+        validKeys: INSTANCED_PRIMITIVE_BUILDER_KEYS,
         options
     });
+    const instanceWind = resolveInstanceWind(wind);
+    if (instanceColorTarget === undefined && !instanceWind)
+        return built;
+    // GU47 E-G (WP-7): stamp the colour target for the renderer (GU47(E-D) node
+    // field) and opt the node into wind without the WORLD lane.
+    const base = built.toJSON();
+    const node = {
+        ...base,
+        ...(instanceColorTarget !== undefined ? { instanceColorTarget } : {}),
+        ...(instanceWind ? { instanceWind, userData: adoptInstanceWind(base.userData, instanceWind) } : {})
+    };
+    return new AuraNodeBuilder(node);
 }
 //# sourceMappingURL=instances.js.map

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/material.d.ts

@@ -1,4 +1,4 @@
-import type { AuraCustomMaterialSpec, AuraEditableMaterialParameters, AuraMaterialCapabilityDiagnostics, AuraMaterialCapabilityInput, AuraMaterialInspectorPanel, AuraMaterialSpec, AuraMaterialVisualQAResult, AuraProceduralTextureSpec, AuraSceneNode } from "../nodes/types.js";
+import type { AuraCustomMaterialSpec, AuraEditableMaterialParameters, AuraMaterialCapabilityDiagnostics, AuraMaterialCapabilityInput, AuraMaterialInspectorPanel, AuraMaterialSpec, AuraMaterialVisualQAResult, AuraProceduralTextureSpec, AuraSceneNode, AuraToonMaterialOptions } from "../nodes/types.js";
 import { materialNode } from "./tsl/index.js";
 import { proceduralTexture } from "../nodes/materialTools.js";
 import type { AuraSolarPlanetMaterialPreset } from "../nodes/types.js";
@@ -12,6 +12,8 @@ import type { AuraSolarPlanetMaterialPreset } from "../nodes/types.js";
 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;
+/** GU47 E-D (PRD §3.1): `material.toon(opts)` lowers to a `material.custom` spec over the `a3d_lights` / `a3d_toon` / `a3d_rim` chunks. */
+export declare function toonMaterial(options?: AuraToonMaterialOptions): AuraMaterialSpec;
 export declare const material: {
     /**
      * threejs-parity SH-02 (L1): three-style custom shader material. `spec.glsl`
@@ -21,6 +23,11 @@ export declare const material: {
      * here rather than at mount.
      */
     readonly custom: (spec: AuraCustomMaterialSpec) => AuraMaterialSpec;
+    /**
+     * GU47 E-D: cel-shaded material (`AuraToonMaterialOptions`): every scene light banded into `steps` between
+     * `shadowColor` and `color` (or through a `ramp` texture), hemisphere fill, optional `rim`, scene fog, shadows.
+     */
+    readonly toon: (options?: AuraToonMaterialOptions) => AuraMaterialSpec;
     /**
      * SH-01 (L1-11): TSL-subset node material — `colorNode/emissiveNode/opacityNode/positionNode`
      * graphs built with `tsl.*` lower to a GLSL `material.custom` spec. GLSL only; see `tsl`.