@aura3d/engine 4.0.8 → 4.1.1

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

@@ -0,0 +1,116 @@
+import type { AuraTransformSpec, AuraVec3 } from "./types.js";
+export type AuraScatterRange = readonly [min: number, max: number];
+export type AuraScatterSide = "both" | "left" | "right";
+export type AuraScatterExclusion = {
+    readonly kind: "circle";
+    readonly center: readonly [number, number];
+    readonly radius: number;
+} | {
+    readonly kind: "box";
+    readonly min: readonly [number, number];
+    readonly max: readonly [number, number];
+};
+export type AuraScatterArea = {
+    readonly kind: "rect";
+    readonly min: readonly [number, number];
+    readonly max: readonly [number, number];
+} | {
+    readonly kind: "disc";
+    readonly center: readonly [number, number];
+    readonly radius: number;
+};
+export interface AuraScatterPoint {
+    readonly position: AuraVec3;
+    /** Rotation about +Y in radians. */
+    readonly yaw: number;
+    /** Uniform scale along X and Y, `scale * depthScale` along Z (`depthScale` is 1 unless `scaleDepth` is set). */
+    readonly scale: number;
+    readonly depthScale: number;
+    /** Variant index in `[0, kinds)`; 0 when `kinds` is unset. */
+    readonly kind: number;
+    /** Arc length along the path (path scatter) or 0 (area scatter). */
+    readonly along: number;
+    /** Signed lateral offset from the path (path scatter) or 0 (area scatter). */
+    readonly lateral: number;
+}
+interface AuraScatterCommon {
+    /** Seed for the built-in generator (a 32-bit LCG). Ignored when `random` is given. Default 1. */
+    readonly seed?: number;
+    /** Share one random stream across several calls (chunked worlds). Overrides `seed`. */
+    readonly random?: () => number;
+    /** Number of model/mesh variants; each placement draws `kind` in `[0, kinds)`. Unset draws nothing and gives kind 0. */
+    readonly kinds?: number;
+    /** Extra height added to the base height, drawn uniformly from the range. */
+    readonly yOffset?: AuraScatterRange;
+    /** Uniform scale drawn from the range. Unset gives scale 1 and draws nothing. */
+    readonly scale?: AuraScatterRange;
+    /** Multiplier on the Z scale drawn from the range (squash/stretch variety). */
+    readonly scaleDepth?: AuraScatterRange;
+    /** Yaw in radians: a number (fixed), or a range drawn uniformly. Default `[0, 2π)`. */
+    readonly yaw?: number | AuraScatterRange;
+    /** Placements inside any zone are rejected (XZ plane). */
+    readonly exclude?: readonly AuraScatterExclusion[];
+    /** Reject a placement closer than this (XZ) to an already accepted one. */
+    readonly minDistance?: number;
+    /** Reject placements whose final height is outside the range. */
+    readonly heightRange?: AuraScatterRange;
+    /** With `maxSlope`, rejects placements where the ground gradient magnitude (rise over run) exceeds it. */
+    readonly ground?: (x: number, z: number) => number;
+    readonly maxSlope?: number;
+    /** Final custom filter. Runs after every built-in filter. */
+    readonly accept?: (point: AuraScatterPoint) => boolean;
+    /** Stop after this many accepted placements. */
+    readonly maxCount?: number;
+}
+export interface AuraScatterAlongPathOptions extends AuraScatterCommon {
+    /** World position at arc length `s` and signed lateral offset (positive is the side `side: "right"` uses). */
+    readonly path: (s: number, lateral: number) => AuraVec3;
+    readonly start: number;
+    readonly end: number;
+    /** Arc-length spacing between rows, drawn uniformly from the range after each row. */
+    readonly step: AuraScatterRange;
+    /** Absolute lateral distance from the path, drawn uniformly. Both sides mirror it. */
+    readonly lateral: AuraScatterRange;
+    readonly side?: AuraScatterSide;
+    /** Probability in `[0, 1)` of skipping a placement; draws once per placement when set. */
+    readonly skipChance?: number;
+    /** Total width of random arc-length jitter applied to each placement; draws once when set. */
+    readonly alongJitter?: number;
+    /** Base height for `yOffset`, called with the row's arc length (before `alongJitter`) and the placed position, e.g. the centreline height. Default is the path position's Y. */
+    readonly baseHeight?: (row: number, position: AuraVec3) => number;
+}
+export interface AuraScatterInAreaOptions extends AuraScatterCommon {
+    readonly area: AuraScatterArea;
+    /** Target number of accepted placements. */
+    readonly count: number;
+    /** Attempts per requested placement before giving up (default 12), so filters cannot loop forever. */
+    readonly attemptsPerPoint?: number;
+}
+/** The 32-bit LCG the ported games share (Numerical Recipes constants); one number in `[0, 1)` per call. */
+export declare function createScatterRandom(seed?: number): () => number;
+/**
+ * Scatter placements along a path (roads, rails, rivers, corridors). Draw order per placement is fixed and
+ * documented so a given seed always yields the same layout: skip chance, lateral distance, along-path jitter,
+ * kind, yOffset, scale, scaleDepth, yaw; then one `step` draw per row. Filters run after the draws, so adding a
+ * filter never shifts the random stream and never moves the placements that survive.
+ */
+export declare function scatterAlongPath(options: AuraScatterAlongPathOptions): AuraScatterPoint[];
+/**
+ * Scatter placements over a rectangle or disc. Draw order per attempt: position (x then z, or angle then
+ * radius for discs), kind, yOffset, scale, scaleDepth, yaw. Stops at `count` accepted placements or after
+ * `count * attemptsPerPoint` attempts, so impossible filters return fewer placements instead of hanging.
+ */
+export declare function scatterInArea(options: AuraScatterInAreaOptions): AuraScatterPoint[];
+/**
+ * Radius LOD: split placements into bands by XZ distance from `origin`. `radii` ascend; the result has
+ * `radii.length + 1` arrays: `[0]` is closest (e.g. instanced Meshy models), the last is beyond every radius
+ * (e.g. the cheap procedural fallback). Order inside each band is preserved.
+ */
+export declare function splitScatterByDistance(points: readonly AuraScatterPoint[], origin: readonly [number, number], radii: readonly number[]): AuraScatterPoint[][];
+/** Turn placements into `instances.*` transforms. `kind` keeps only that variant. `baseScale` multiplies the stored scale. */
+export declare function scatterTransforms(points: readonly AuraScatterPoint[], options?: {
+    readonly kind?: number;
+    readonly baseScale?: number | AuraVec3;
+}): AuraTransformSpec[];
+export {};
+//# sourceMappingURL=scatter.d.ts.map

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

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

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

@@ -0,0 +1,211 @@
+/** The 32-bit LCG the ported games share (Numerical Recipes constants); one number in `[0, 1)` per call. */
+export function createScatterRandom(seed = 1) {
+    let state = seed >>> 0;
+    return () => ((state = (Math.imul(state, 1664525) + 1013904223) >>> 0), state / 4294967296);
+}
+const TAU = Math.PI * 2;
+const draw = (random, range) => range[0] + random() * (range[1] - range[0]);
+function finiteRange(range, label) {
+    if (!range)
+        return;
+    if (!Number.isFinite(range[0]) || !Number.isFinite(range[1]) || range[1] < range[0])
+        throw new Error(`Aura3D scatter ${label} must be a finite [min, max] range with max >= min.`);
+}
+function validateCommon(options) {
+    finiteRange(options.yOffset, "yOffset");
+    finiteRange(options.scale, "scale");
+    finiteRange(options.scaleDepth, "scaleDepth");
+    finiteRange(options.heightRange, "heightRange");
+    if (typeof options.yaw === "object")
+        finiteRange(options.yaw, "yaw");
+    if (options.kinds !== undefined && (!Number.isInteger(options.kinds) || options.kinds < 1))
+        throw new Error("Aura3D scatter kinds must be a positive integer.");
+    if (options.minDistance !== undefined && !(options.minDistance >= 0))
+        throw new Error("Aura3D scatter minDistance must be zero or positive.");
+    if (options.maxSlope !== undefined && !options.ground)
+        throw new Error("Aura3D scatter maxSlope needs a ground(x, z) height function.");
+}
+function inZone(zone, x, z) {
+    if (zone.kind === "circle") {
+        const dx = x - zone.center[0];
+        const dz = z - zone.center[1];
+        return dx * dx + dz * dz <= zone.radius * zone.radius;
+    }
+    return x >= zone.min[0] && x <= zone.max[0] && z >= zone.min[1] && z <= zone.max[1];
+}
+function slopeAt(ground, x, z) {
+    const e = 0.5;
+    const gx = (ground(x + e, z) - ground(x - e, z)) / (2 * e);
+    const gz = (ground(x, z + e) - ground(x, z - e)) / (2 * e);
+    return Math.hypot(gx, gz);
+}
+/** Spatial hash for the minimum-distance rule: O(1) neighbour lookups instead of an O(n^2) scan. */
+class SpacingIndex {
+    distance;
+    cells = new Map();
+    constructor(distance) {
+        this.distance = distance;
+    }
+    key(cx, cz) { return `${cx},${cz}`; }
+    cell(v) { return Math.floor(v / this.distance); }
+    blocked(x, z) {
+        if (this.distance <= 0)
+            return false;
+        const cx = this.cell(x);
+        const cz = this.cell(z);
+        for (let ix = cx - 1; ix <= cx + 1; ix += 1)
+            for (let iz = cz - 1; iz <= cz + 1; iz += 1) {
+                const bucket = this.cells.get(this.key(ix, iz));
+                if (!bucket)
+                    continue;
+                for (const p of bucket)
+                    if ((p[0] - x) ** 2 + (p[1] - z) ** 2 < this.distance * this.distance)
+                        return true;
+            }
+        return false;
+    }
+    add(x, z) {
+        if (this.distance <= 0)
+            return;
+        const k = this.key(this.cell(x), this.cell(z));
+        const bucket = this.cells.get(k);
+        if (bucket)
+            bucket.push([x, z]);
+        else
+            this.cells.set(k, [[x, z]]);
+    }
+}
+function makeFilter(options) {
+    const spacing = new SpacingIndex(options.minDistance ?? 0);
+    return {
+        accepts(c) {
+            const [x, y, z] = c.position;
+            if (options.exclude?.some((zone) => inZone(zone, x, z)))
+                return false;
+            if (options.heightRange && (y < options.heightRange[0] || y > options.heightRange[1]))
+                return false;
+            if (options.maxSlope !== undefined && options.ground && slopeAt(options.ground, x, z) > options.maxSlope)
+                return false;
+            if (spacing.blocked(x, z))
+                return false;
+            return options.accept ? options.accept(c) : true;
+        },
+        commit(c) { spacing.add(c.position[0], c.position[2]); }
+    };
+}
+/**
+ * Scatter placements along a path (roads, rails, rivers, corridors). Draw order per placement is fixed and
+ * documented so a given seed always yields the same layout: skip chance, lateral distance, along-path jitter,
+ * kind, yOffset, scale, scaleDepth, yaw; then one `step` draw per row. Filters run after the draws, so adding a
+ * filter never shifts the random stream and never moves the placements that survive.
+ */
+export function scatterAlongPath(options) {
+    validateCommon(options);
+    finiteRange(options.step, "step");
+    finiteRange(options.lateral, "lateral");
+    if (!(options.step[1] > 0) || !(options.step[0] + options.step[1] > 0))
+        throw new Error("Aura3D scatter step must advance (max > 0).");
+    const random = options.random ?? createScatterRandom(options.seed ?? 1);
+    const sides = options.side === "left" ? [-1] : options.side === "right" ? [1] : [-1, 1];
+    const filter = makeFilter(options);
+    const out = [];
+    const limit = options.maxCount ?? Infinity;
+    for (let s = options.start; s < options.end && out.length < limit; s += options.step[0] + random() * (options.step[1] - options.step[0])) {
+        for (const side of sides) {
+            if (out.length >= limit)
+                break;
+            if (options.skipChance !== undefined && random() < options.skipChance)
+                continue;
+            const lateral = side * draw(random, options.lateral);
+            const sAt = options.alongJitter !== undefined ? s + (random() - 0.5) * options.alongJitter : s;
+            const base = options.path(sAt, lateral);
+            const kind = options.kinds !== undefined ? Math.floor(random() * options.kinds) : 0;
+            const baseY = options.baseHeight ? options.baseHeight(s, base) : base[1];
+            const y = baseY + (options.yOffset ? draw(random, options.yOffset) : 0);
+            const scale = options.scale ? draw(random, options.scale) : 1;
+            const depthScale = options.scaleDepth ? draw(random, options.scaleDepth) : 1;
+            const yaw = options.yaw === undefined ? random() * TAU : typeof options.yaw === "number" ? options.yaw : draw(random, options.yaw);
+            const candidate = { position: [base[0], y, base[2]], yaw, scale, depthScale, kind, along: sAt, lateral };
+            if (!filter.accepts(candidate))
+                continue;
+            filter.commit(candidate);
+            out.push(candidate);
+        }
+    }
+    return out;
+}
+/**
+ * Scatter placements over a rectangle or disc. Draw order per attempt: position (x then z, or angle then
+ * radius for discs), kind, yOffset, scale, scaleDepth, yaw. Stops at `count` accepted placements or after
+ * `count * attemptsPerPoint` attempts, so impossible filters return fewer placements instead of hanging.
+ */
+export function scatterInArea(options) {
+    validateCommon(options);
+    if (!Number.isInteger(options.count) || options.count < 0)
+        throw new Error("Aura3D scatterInArea count must be a non-negative integer.");
+    const random = options.random ?? createScatterRandom(options.seed ?? 1);
+    const filter = makeFilter(options);
+    const out = [];
+    const maxAttempts = options.count * (options.attemptsPerPoint ?? 12);
+    const area = options.area;
+    for (let attempt = 0; attempt < maxAttempts && out.length < Math.min(options.count, options.maxCount ?? Infinity); attempt += 1) {
+        let x;
+        let z;
+        if (area.kind === "rect") {
+            x = area.min[0] + random() * (area.max[0] - area.min[0]);
+            z = area.min[1] + random() * (area.max[1] - area.min[1]);
+        }
+        else {
+            const angle = random() * TAU;
+            const radius = area.radius * Math.sqrt(random());
+            x = area.center[0] + Math.cos(angle) * radius;
+            z = area.center[1] + Math.sin(angle) * radius;
+        }
+        const kind = options.kinds !== undefined ? Math.floor(random() * options.kinds) : 0;
+        const y = (options.ground ? options.ground(x, z) : 0) + (options.yOffset ? draw(random, options.yOffset) : 0);
+        const scale = options.scale ? draw(random, options.scale) : 1;
+        const depthScale = options.scaleDepth ? draw(random, options.scaleDepth) : 1;
+        const yaw = options.yaw === undefined ? random() * TAU : typeof options.yaw === "number" ? options.yaw : draw(random, options.yaw);
+        const candidate = { position: [x, y, z], yaw, scale, depthScale, kind, along: 0, lateral: 0 };
+        if (!filter.accepts(candidate))
+            continue;
+        filter.commit(candidate);
+        out.push(candidate);
+    }
+    return out;
+}
+/**
+ * Radius LOD: split placements into bands by XZ distance from `origin`. `radii` ascend; the result has
+ * `radii.length + 1` arrays: `[0]` is closest (e.g. instanced Meshy models), the last is beyond every radius
+ * (e.g. the cheap procedural fallback). Order inside each band is preserved.
+ */
+export function splitScatterByDistance(points, origin, radii) {
+    for (let i = 0; i < radii.length; i += 1) {
+        if (!(radii[i] >= 0) || (i > 0 && radii[i] < radii[i - 1]))
+            throw new Error("Aura3D scatter radii must be non-negative and ascending.");
+    }
+    const bands = Array.from({ length: radii.length + 1 }, () => []);
+    for (const point of points) {
+        const d = Math.hypot(point.position[0] - origin[0], point.position[2] - origin[1]);
+        let band = radii.length;
+        for (let i = 0; i < radii.length; i += 1)
+            if (d <= radii[i]) {
+                band = i;
+                break;
+            }
+        bands[band].push(point);
+    }
+    return bands;
+}
+/** Turn placements into `instances.*` transforms. `kind` keeps only that variant. `baseScale` multiplies the stored scale. */
+export function scatterTransforms(points, options = {}) {
+    const base = options.baseScale === undefined ? [1, 1, 1] : typeof options.baseScale === "number" ? [options.baseScale, options.baseScale, options.baseScale] : options.baseScale;
+    const out = [];
+    for (const p of points) {
+        if (options.kind !== undefined && p.kind !== options.kind)
+            continue;
+        out.push({ position: p.position, rotation: [0, p.yaw, 0], scale: [p.scale * base[0], p.scale * base[1], p.scale * p.depthScale * base[2]] });
+    }
+    return out;
+}
+//# sourceMappingURL=scatter.js.map

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

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

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

@@ -43,5 +43,13 @@ export declare class AuraSceneBuilder {
     toJSON(): AuraSceneSnapshot;
     getPhysicsController(): AuraPhysicsWorldController | undefined;
 }
-export declare function scene(): AuraSceneBuilder;
+/** Optional one-shot construction for `scene({ ... })`; every field has a builder method with the same meaning. */
+export interface AuraSceneInit {
+    readonly children?: readonly (AuraNodeBuilder<AuraSceneNode> | AuraSceneNode)[];
+    readonly background?: AuraColor | AuraSceneBackgroundImage;
+    readonly camera?: AuraCameraSpec;
+    readonly timeline?: AuraTimelineSpec;
+    readonly diagnostics?: boolean;
+}
+export declare function scene(init?: AuraSceneInit): AuraSceneBuilder;
 //# sourceMappingURL=scene.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/scene.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,aAAa,EAAE,0BAA0B,EAAE,cAAc,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErN,OAAO,EAAuC,eAAe,EAAgD,MAAM,2BAA2B,CAAC;AAC/I,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAsC/C,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,2BAA2B,GAAG,MAAM,CASrI;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,oBAAoB,CAAQ;IAGpC,OAAO,CAAC,mBAAmB,CAAuC;IAClE,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,oBAAoB,CAA+B;IAE3D;;;;;;;;OAQG;IACH,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAUrD;;;;;;;OAOG;IACH,UAAU,CACR,KAAK,EAAE,SAAS,GAAG,wBAAwB,EAC3C,OAAO,GAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GAC9C,IAAI;IAcP,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,aAAa,GAAG,IAAI;IAK/D,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC,EAAE,GAAG,IAAI;IAKjF,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAMlC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAKtC,OAAO,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI;IAK/C,WAAW,CAAC,OAAO,UAAO,GAAG,IAAI;IAKjC,MAAM,IAAI,iBAAiB;IAiB3B,oBAAoB,IAAI,0BAA0B,GAAG,SAAS;CAG/D;AAED,wBAAgB,KAAK,IAAI,gBAAgB,CAExC"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/scene.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,aAAa,EAAE,0BAA0B,EAAE,cAAc,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErN,OAAO,EAAuC,eAAe,EAAgD,MAAM,2BAA2B,CAAC;AAC/I,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAuC/C,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,2BAA2B,GAAG,MAAM,CASrI;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,oBAAoB,CAAQ;IAGpC,OAAO,CAAC,mBAAmB,CAAuC;IAClE,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,oBAAoB,CAA+B;IAE3D;;;;;;;;OAQG;IACH,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAUrD;;;;;;;OAOG;IACH,UAAU,CACR,KAAK,EAAE,SAAS,GAAG,wBAAwB,EAC3C,OAAO,GAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GAC9C,IAAI;IAcP,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,aAAa,GAAG,IAAI;IAK/D,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC,EAAE,GAAG,IAAI;IAKjF,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAMlC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAKtC,OAAO,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI;IAK/C,WAAW,CAAC,OAAO,UAAO,GAAG,IAAI;IAKjC,MAAM,IAAI,iBAAiB;IAiB3B,oBAAoB,IAAI,0BAA0B,GAAG,SAAS;CAG/D;AAED,mHAAmH;AACnH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,wBAAwB,CAAC;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAID,wBAAgB,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAoB5D"}

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

@@ -8,6 +8,7 @@ import { physics } from "./physics.js";
 import { resolveCameraClipping } from "../RootRuntimeSupport.js";
 import { timeline } from "./timeline.js";
 import { resolveQrFlags } from "../../contracts/flags.js";
+import { AuraRuntimeError } from "../compiler/errors.js";
 const DEFAULT_SCENE_BACKGROUND = "#070b12";
 /**
  * A3D_QR_LOOKS (lane 13, #1142 follow-up): a look group carries its
@@ -146,7 +147,32 @@ export class AuraSceneBuilder {
         return this.physicsController;
     }
 }
-export function scene() {
-    return new AuraSceneBuilder();
+const SCENE_INIT_KEYS = new Set(["children", "background", "camera", "timeline", "diagnostics"]);
+export function scene(init) {
+    const builder = new AuraSceneBuilder();
+    if (init === undefined)
+        return builder;
+    if (init === null || typeof init !== "object" || Array.isArray(init)) {
+        throw new AuraRuntimeError("invalid-scene-options", "scene(init) takes an options object ({ children, background, camera, timeline, diagnostics }) or nothing. Suggested fix: scene().add(node) for one node, scene({ children: [...] }) for many.");
+    }
+    // `scene({ children })` used to return a silently empty scene (the argument was ignored); unknown keys now fail by name.
+    const unknown = Object.keys(init).filter((key) => !SCENE_INIT_KEYS.has(key));
+    if (unknown.length > 0) {
+        throw new AuraRuntimeError("invalid-scene-options", `scene(init) does not understand ${unknown.map((key) => `"${key}"`).join(", ")}. Supported: children, background, camera, timeline, diagnostics.`);
+    }
+    if (init.children !== undefined) {
+        if (!Array.isArray(init.children))
+            throw new AuraRuntimeError("invalid-scene-options", "scene({ children }) needs an array of nodes.");
+        builder.addMany(init.children);
+    }
+    if (init.background !== undefined)
+        builder.background(init.background);
+    if (init.camera !== undefined)
+        builder.camera(init.camera);
+    if (init.timeline !== undefined)
+        builder.timeline(init.timeline);
+    if (init.diagnostics !== undefined)
+        builder.diagnostics(init.diagnostics);
+    return builder;
 }
 //# sourceMappingURL=scene.js.map

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

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

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

@@ -972,6 +972,8 @@ export interface AuraCreateAppRendererOptions {
     readonly morph?: "gpu" | "cpu";
     readonly skinnedPbr?: "unified" | "fork";
     readonly materialStrictness?: "warn" | "strict";
+    /** What to do with a draw whose shader failed to compile/link: `skip` (default, plus a diagnostic), `magenta` (flat debug colour; default with `?diag=1`) or `throw` (strict). */
+    readonly shaderFailures?: "skip" | "magenta" | "throw";
     readonly materialModel?: "legacy" | "physical-r185";
     readonly transmission?: "auto" | "env" | "off";
     readonly alphaToCoverage?: boolean;
@@ -2140,6 +2142,12 @@ export interface AuraDiagnostics {
     readonly renderer?: AuraRendererDiagnosticReport;
     readonly warnings: readonly string[];
     readonly errors: readonly string[];
+    /**
+     * Custom shaders that failed to compile or link (or have no WGSL twin on WebGPU): stable code, material name,
+     * stage, the driver log and the offending source lines. Each also appears once in `errors`; the failing item
+     * is skipped (or drawn magenta with `?diag=1`) while every other draw continues. Present only when non-empty.
+     */
+    readonly shaderFailures?: readonly import("../../../rendering/index.js").ShaderFailureRecord[];
     /**
      * Labels the world-label layer actually placed on screen this frame, with their
      * projected pixel positions and visibility.