@aura3d/engine 4.1.2 → 4.2.0

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

@@ -5,10 +5,13 @@ export class AuraNodeBuilder {
         this.value = value;
     }
     position(x, y, z) {
-        return this.with({ position: [x, y, z] });
+        const v = typeof x === "number" ? [x, y, z] : [x[0], x[1], x[2]];
+        return this.with({ position: v });
     }
     rotate(x, y, z, order) {
-        return this.with(order === undefined ? { rotation: [x, y, z] } : { rotation: [x, y, z], rotationOrder: order });
+        const vec = typeof x === "number" ? [x, y, z] : [x[0], x[1], x[2]];
+        const eulerOrder = typeof x === "number" ? order : y;
+        return this.with(eulerOrder === undefined ? { rotation: vec } : { rotation: vec, rotationOrder: eulerOrder });
     }
     /** C-06 (PR 0a): quaternion rotation; wins over `rotation` in the compiled transform. */
     quaternion(x, y, z, w) {
@@ -18,7 +21,8 @@ export class AuraNodeBuilder {
         return this.with({ scale: value });
     }
     lookAt(x, y, z) {
-        return this.with({ lookAt: [x, y, z] });
+        const v = typeof x === "number" ? [x, y, z] : [x[0], x[1], x[2]];
+        return this.with({ lookAt: v });
     }
     material(material) {
         return this.with({ material });

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

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/builder.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAI/G,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;IAAG,CAAC;IAE7C,QAAQ,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,KAA2D;QACjG,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;IACpI,CAAC;IAED,yFAAyF;IACzF,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,KAAwB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,QAAQ,CAAC,QAA0B;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,SAA4B;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,SAAS,CAAC,WAAgC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,IAAyB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,IAAyB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEO,IAAI,CAAwC,KAAa;QAC/D,OAAO,IAAI,eAAe,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAoB,CAAC,CAAC;IAC5E,CAAC;CACF"}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/builder.ts"],"names":[],"mappings":"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"}

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

@@ -10,6 +10,7 @@
  */
 import type { AuraCameraSpec, AuraSceneNode, AuraTransformSpec, AuraVec3 } from "./types.js";
 import { AuraNodeBuilder } from "./builder.js";
+import { type ChaseOptions, type ChaseRig } from "./chaseCamera.js";
 export type AuraStereoLayout = "side-by-side" | "over-under";
 /** Normalized viewport in [0, 1] of the render target, origin bottom-left (three/WebGL convention). */
 export interface AuraCameraViewport {
@@ -90,6 +91,12 @@ export declare function isAuraCubeCameraNode(node: {
     readonly kind: "cube-camera";
 };
 export declare const cameras: {
+    /**
+     * Gameplay chase camera rig (runtime controller, not a scene node): feed it the followed target each frame and apply
+     * the returned pose with `app.camera.setPose`. Offset mode places the eye behind and the look target ahead; framed mode
+     * (`wantEye`/`wantLook`) only smooths. See `docs/api/camera-rig.md`.
+     */
+    readonly chase: (options?: ChaseOptions) => ChaseRig;
     /**
      * three's `new CubeCamera(near, far, renderTarget)` — cube render target via
      * `Renderer.renderProbeFace`; consume the capture through

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

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

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

@@ -11,6 +11,7 @@
 import { AuraNodeBuilder } from "./builder.js";
 import { AuraRuntimeError } from "../compiler/errors.js";
 import { STEREO_DEFAULT_EYE_SEPARATION, STEREO_DEFAULT_FOCUS } from "../stereoMath.js";
+import { createChaseRig } from "./chaseCamera.js";
 export function isAuraCameraArrayNode(node) {
     return node.kind === "camera-array";
 }
@@ -37,6 +38,12 @@ export function isAuraCubeCameraNode(node) {
     return node.kind === "cube-camera";
 }
 export const cameras = {
+    /**
+     * Gameplay chase camera rig (runtime controller, not a scene node): feed it the followed target each frame and apply
+     * the returned pose with `app.camera.setPose`. Offset mode places the eye behind and the look target ahead; framed mode
+     * (`wantEye`/`wantLook`) only smooths. See `docs/api/camera-rig.md`.
+     */
+    chase: (options = {}) => createChaseRig(options),
     /**
      * three's `new CubeCamera(near, far, renderTarget)` — cube render target via
      * `Renderer.renderProbeFace`; consume the capture through

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

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

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

@@ -0,0 +1,122 @@
+/**
+ * `cameras.chase`: the gameplay chase camera rig shared by the Crayon ports.
+ *
+ * Pure, deterministic math (no DOM, no clock, no randomness): the caller feeds the followed target each frame and
+ * applies the returned pose with `app.camera.setPose`. Two ways to drive it:
+ * - offset mode: pass `position`, `heading`, `speed` and the rig places the eye behind and the look target ahead using
+ *   `offset`, smooths the follow heading, eye, look and fov with `lag`, opens the fov with `fovKick` and adds shake;
+ * - framed mode: pass `wantEye` / `wantLook` (and optionally `fovTarget`) computed on a road frame, a rail or a menu orbit,
+ *   and the rig only does the exponential smoothing, the first-frame snap and the cut flag.
+ * A lag rate is a per-second exponential rate (`1 - exp(-rate * dt)`); `Infinity` (or an absent lag) follows exactly.
+ */
+export type ChaseVec3 = readonly [number, number, number];
+export interface ChaseOffset {
+    /** Distance behind the target along the follow heading. */
+    readonly back?: number;
+    readonly backPerSpeed?: number;
+    /** Extra distance while `boosting`. */
+    readonly backBoost?: number;
+    /** Eye height above the target. */
+    readonly up?: number;
+    readonly upPerSpeed?: number;
+    /** The eye never drops below `groundAt(x, z) + minAboveGround` when the target supplies `groundAt`. */
+    readonly minAboveGround?: number;
+    /** Look target lead ahead of the target. */
+    readonly lead?: number;
+    readonly leadPerSpeed?: number;
+    /** Look target height above the target. */
+    readonly lookUp?: number;
+}
+export interface ChaseLag {
+    readonly eye?: number;
+    readonly look?: number;
+    readonly fov?: number;
+    /** Follow-heading rate at full speed (offset mode). */
+    readonly heading?: number;
+    /** Fraction of the heading rate applied at standstill (default 1: no speed ramp). */
+    readonly headingMinFollow?: number;
+    /** Speed at which the heading follow reaches its full rate (default 15). */
+    readonly headingFullSpeed?: number;
+}
+export interface ChaseFovKick {
+    readonly base?: number;
+    readonly perSpeed?: number;
+    /** Cap on the speed-driven opening. */
+    readonly maxSpeedKick?: number;
+    /** Extra fov while `boosting`. */
+    readonly boost?: number;
+}
+export interface ChaseShake {
+    /** Amplitude per unit of the target's `shake` value. */
+    readonly perShake?: number;
+    /** Speed above which a speed-driven shake begins, the speed span to full strength and its amplitude. */
+    readonly speedStart?: number;
+    readonly speedRange?: number;
+    readonly speedAmp?: number;
+    readonly boostAmp?: number;
+    /** Target `shake` values at or below this (with no speed shake) add nothing. */
+    readonly threshold?: number;
+    /** Vertical share of the amplitude and the wobble phase of the vertical axis. */
+    readonly verticalScale?: number;
+    readonly verticalPhase?: number;
+    /** `accumulate` adds the wobble into the smoothed eye state (a low-passed shake); `overlay` adds it to the output only. */
+    readonly mode?: "accumulate" | "overlay";
+}
+export interface ChaseOptions {
+    readonly offset?: ChaseOffset;
+    readonly lag?: ChaseLag;
+    readonly fovKick?: ChaseFovKick;
+    readonly shake?: ChaseShake;
+    /** Pose used by `snap` in offset mode. */
+    readonly snapOffset?: {
+        readonly back: number;
+        readonly up: number;
+        readonly lead: number;
+        readonly lookUp: number;
+        readonly fov: number;
+    };
+}
+export interface ChaseTarget {
+    readonly position?: ChaseVec3;
+    /** Heading in radians; forward is `(sin h, cos h)` on x/z. */
+    readonly heading?: number;
+    readonly speed?: number;
+    readonly boosting?: boolean;
+    /** Target shake amount, scaled by `shake.perShake`. */
+    readonly shake?: number;
+    readonly groundAt?: (x: number, z: number) => number;
+    /** Framed mode: desired eye and look (replace the offset placement). */
+    readonly wantEye?: ChaseVec3;
+    readonly wantLook?: ChaseVec3;
+    /** Desired fov (replaces the base + kick formula). */
+    readonly fovTarget?: number;
+    /** Per-step lag override (kid-goku style per-phase rates). */
+    readonly lag?: ChaseLag;
+    /** Added to the eye after smoothing, never stored (damage shake, camera bob). */
+    readonly shakeOffset?: ChaseVec3;
+    /** Snap eye, look and fov to their targets this step. */
+    readonly cut?: boolean;
+}
+export interface ChasePose {
+    eye: [number, number, number];
+    look: [number, number, number];
+    fov: number;
+    /** Smoothed follow heading. */
+    heading: number;
+    /** Rig clock (sum of dt), drives the shake wobble. */
+    time: number;
+    /** True when this step snapped instead of smoothing: pass it as `setPose`'s `cut`. */
+    cut: boolean;
+}
+export interface ChaseRig {
+    readonly pose: ChasePose;
+    /** Place the rig exactly on its targets with no smoothing. */
+    snap(target: ChaseTarget): ChasePose;
+    step(target: ChaseTarget, dt: number): ChasePose;
+    /** Forget the pose: the next `step` snaps. */
+    reset(): void;
+}
+export declare function approach(current: number, target: number, rate: number, dt: number): number;
+export declare function approachAngle(current: number, target: number, rate: number, dt: number): number;
+export declare function createChaseRig(options?: ChaseOptions): ChaseRig;
+//# sourceMappingURL=chaseCamera.d.ts.map

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

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

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

@@ -0,0 +1,130 @@
+/**
+ * `cameras.chase`: the gameplay chase camera rig shared by the Crayon ports.
+ *
+ * Pure, deterministic math (no DOM, no clock, no randomness): the caller feeds the followed target each frame and
+ * applies the returned pose with `app.camera.setPose`. Two ways to drive it:
+ * - offset mode: pass `position`, `heading`, `speed` and the rig places the eye behind and the look target ahead using
+ *   `offset`, smooths the follow heading, eye, look and fov with `lag`, opens the fov with `fovKick` and adds shake;
+ * - framed mode: pass `wantEye` / `wantLook` (and optionally `fovTarget`) computed on a road frame, a rail or a menu orbit,
+ *   and the rig only does the exponential smoothing, the first-frame snap and the cut flag.
+ * A lag rate is a per-second exponential rate (`1 - exp(-rate * dt)`); `Infinity` (or an absent lag) follows exactly.
+ */
+export function approach(current, target, rate, dt) {
+    if (!(rate < Infinity))
+        return target;
+    return current + (target - current) * (1 - Math.exp(-rate * dt));
+}
+export function approachAngle(current, target, rate, dt) {
+    let d = target - current;
+    while (d > Math.PI)
+        d -= 2 * Math.PI;
+    while (d < -Math.PI)
+        d += 2 * Math.PI;
+    return current + d * (rate < Infinity ? 1 - Math.exp(-rate * dt) : 1);
+}
+const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+const wobble = (t, amp, phase) => (0.62 * Math.sin(t * (6.1 + phase)) + 0.38 * Math.sin(t * (11.3 + 1.7 * phase))) * amp;
+export function createChaseRig(options = {}) {
+    const o = options.offset ?? {};
+    const baseLag = options.lag ?? {};
+    const kick = options.fovKick ?? {};
+    const sh = options.shake;
+    const snapO = options.snapOffset ?? { back: (o.back ?? 6) + 4.7, up: (o.up ?? 2.5) + 1.8, lead: o.lead ?? 5, lookUp: o.lookUp ?? 1.25, fov: kick.base ?? 56 };
+    const pose = { eye: [0, 0, 0], look: [0, 0, 0], fov: kick.base ?? 56, heading: 0, time: 0, cut: true };
+    let live = false;
+    const wantFov = (t, speed) => t.fovTarget ?? (kick.base ?? 56) + clamp((kick.perSpeed ?? 0) * speed, 0, kick.maxSpeedKick ?? Infinity) + (t.boosting ? kick.boost ?? 0 : 0);
+    const snap = (t) => {
+        const p = t.position ?? [0, 0, 0];
+        const h = t.heading ?? 0;
+        const s = Math.sin(h);
+        const c = Math.cos(h);
+        pose.heading = h;
+        pose.time = 0;
+        pose.cut = true;
+        if (t.wantEye && t.wantLook) {
+            pose.eye = [t.wantEye[0], t.wantEye[1], t.wantEye[2]];
+            pose.look = [t.wantLook[0], t.wantLook[1], t.wantLook[2]];
+            pose.fov = wantFov(t, Math.abs(t.speed ?? 0));
+        }
+        else {
+            pose.eye = [p[0] - snapO.back * s, p[1] + snapO.up, p[2] - snapO.back * c];
+            pose.look = [p[0] + snapO.lead * s, p[1] + snapO.lookUp, p[2] + snapO.lead * c];
+            pose.fov = snapO.fov;
+        }
+        live = true;
+        return pose;
+    };
+    const step = (t, dt) => {
+        if (!live || t.cut) {
+            snap(t);
+            return finish(t);
+        }
+        pose.cut = false;
+        pose.time += dt;
+        const lag = t.lag ? { ...baseLag, ...t.lag } : baseLag;
+        const speed = Math.abs(t.speed ?? 0);
+        let wantEye;
+        let wantLook;
+        if (t.wantEye && t.wantLook) {
+            wantEye = t.wantEye;
+            wantLook = t.wantLook;
+        }
+        else {
+            const p = t.position ?? [0, 0, 0];
+            const follow = (lag.headingMinFollow ?? 1) + (1 - (lag.headingMinFollow ?? 1)) * clamp(speed / (lag.headingFullSpeed ?? 15), 0, 1);
+            pose.heading = approachAngle(pose.heading, t.heading ?? 0, (lag.heading ?? Infinity) * follow, dt);
+            const sn = Math.sin(pose.heading);
+            const cs = Math.cos(pose.heading);
+            const back = (o.back ?? 6) + (o.backPerSpeed ?? 0) * speed + (t.boosting ? o.backBoost ?? 0 : 0);
+            let ey = p[1] + (o.up ?? 2.5) + (o.upPerSpeed ?? 0) * speed;
+            const tx = p[0] - sn * back;
+            const tz = p[2] - cs * back;
+            if (t.groundAt && o.minAboveGround !== undefined)
+                ey = Math.max(ey, t.groundAt(tx, tz) + o.minAboveGround);
+            const lead = (o.lead ?? 5) + (o.leadPerSpeed ?? 0) * speed;
+            wantEye = [tx, ey, tz];
+            wantLook = [p[0] + sn * lead, p[1] + (o.lookUp ?? 1.25), p[2] + cs * lead];
+        }
+        const eyeRate = lag.eye ?? Infinity;
+        const lookRate = lag.look ?? Infinity;
+        pose.eye = [approach(pose.eye[0], wantEye[0], eyeRate, dt), approach(pose.eye[1], wantEye[1], eyeRate, dt), approach(pose.eye[2], wantEye[2], eyeRate, dt)];
+        if (sh && (sh.mode ?? "accumulate") === "accumulate") {
+            const speedShake = (sh.speedAmp ?? 0) * clamp((speed - (sh.speedStart ?? 0)) / (sh.speedRange ?? 1), 0, 1) + (t.boosting ? sh.boostAmp ?? 0 : 0);
+            const shake = t.shake ?? 0;
+            if (shake > (sh.threshold ?? 0) || speedShake > 0) {
+                const amp = (sh.perShake ?? 1) * shake + speedShake;
+                pose.eye[0] += wobble(pose.time, amp, 0);
+                pose.eye[1] += wobble(pose.time, (sh.verticalScale ?? 0.7) * amp, sh.verticalPhase ?? 1.3);
+            }
+        }
+        pose.look = [approach(pose.look[0], wantLook[0], lookRate, dt), approach(pose.look[1], wantLook[1], lookRate, dt), approach(pose.look[2], wantLook[2], lookRate, dt)];
+        pose.fov = approach(pose.fov, wantFov(t, speed), lag.fov ?? Infinity, dt);
+        return finish(t);
+    };
+    const finish = (t) => {
+        if (sh && sh.mode === "overlay") {
+            const speed = Math.abs(t.speed ?? 0);
+            const speedShake = (sh.speedAmp ?? 0) * clamp((speed - (sh.speedStart ?? 0)) / (sh.speedRange ?? 1), 0, 1) + (t.boosting ? sh.boostAmp ?? 0 : 0);
+            const shake = t.shake ?? 0;
+            if (shake > (sh.threshold ?? 0) || speedShake > 0) {
+                const amp = (sh.perShake ?? 1) * shake + speedShake;
+                const out = { ...pose, eye: [pose.eye[0] + wobble(pose.time, amp, 0), pose.eye[1] + wobble(pose.time, (sh.verticalScale ?? 0.7) * amp, sh.verticalPhase ?? 1.3), pose.eye[2]] };
+                if (t.shakeOffset)
+                    out.eye = [out.eye[0] + t.shakeOffset[0], out.eye[1] + t.shakeOffset[1], out.eye[2] + t.shakeOffset[2]];
+                return out;
+            }
+        }
+        if (t.shakeOffset)
+            return { ...pose, eye: [pose.eye[0] + t.shakeOffset[0], pose.eye[1] + t.shakeOffset[1], pose.eye[2] + t.shakeOffset[2]] };
+        return pose;
+    };
+    return {
+        pose,
+        snap: (t) => (snap(t), finish(t)),
+        step,
+        reset() {
+            live = false;
+        }
+    };
+}
+//# sourceMappingURL=chaseCamera.js.map

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

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

package/dist/engine/agent-api/nodes/effects.composite.d.ts

@@ -1,5 +1,6 @@
 export declare const effects: {
     readonly contactShadows: (options?: import("./effects.lighting.js").AuraContactShadowOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly toon: (options?: import("./effects.toon.js").AuraToonOptions) => import("../publishedUnion.js").AuraCustomPostPass;
     readonly bloom: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly neonBloom: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly ambientOcclusion: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;

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

@@ -1 +1 @@
-{"version":3,"file":"effects.composite.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.composite.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;sBAK0mR,CAAC;qBAAkC,CAAC;qBAAuD,CAAC;qBAA2B,CAAC;wBAA+B,CAAC;uBAA6B,CAAC;;;;;;;;;CADxyR,CAAC"}
+{"version":3,"file":"effects.composite.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.composite.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;sBAMyhR,CAAC;qBAAkC,CAAC;qBAAuD,CAAC;qBAA2B,CAAC;wBAA+B,CAAC;uBAA6B,CAAC;;;;;;;;;CADvtR,CAAC"}

package/dist/engine/agent-api/nodes/effects.composite.js

@@ -2,10 +2,12 @@
 import { lightingEffectBuilders } from "./effects.lighting.js";
 import { postEffectBuilders } from "./effects.post.js";
 import { vfxEffectBuilders } from "./effects.js";
+import { toonEffectBuilders } from "./effects.toon.js";
 import { lazyNamespace } from "../lazyNamespace.js";
 export const effects = lazyNamespace(() => ({
     ...vfxEffectBuilders,
     ...postEffectBuilders,
+    ...toonEffectBuilders,
     ...lightingEffectBuilders
 }));
 //# sourceMappingURL=effects.composite.js.map

package/dist/engine/agent-api/nodes/effects.composite.js.map

@@ -1 +1 @@
-{"version":3,"file":"effects.composite.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.composite.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAE/G,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1C,GAAG,iBAAiB;IACpB,GAAG,kBAAkB;IACrB,GAAG,sBAAsB;CAChB,CAAA,CAAC,CAAC"}
+{"version":3,"file":"effects.composite.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.composite.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAE/G,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1C,GAAG,iBAAiB;IACpB,GAAG,kBAAkB;IACrB,GAAG,kBAAkB;IACrB,GAAG,sBAAsB;CAChB,CAAA,CAAC,CAAC"}

package/dist/engine/agent-api/nodes/effects.toon.d.ts

@@ -0,0 +1,26 @@
+import type { AuraCustomPostPass, AuraPostPassOrder } from "../../contracts/post.js";
+export interface AuraToonOptions {
+    readonly name?: string;
+    /** Luma steps (>= 2). Default 5. */
+    readonly bands?: number;
+    /** 0 keeps the smooth image, 1 is fully banded. Default 0.75. */
+    readonly bandMix?: number;
+    /** Outline strength 0..1; 0 disables the Sobel outline. Default 0.75. */
+    readonly outline?: number;
+    /** Outline colour, linear RGB 0..1. Default [0.05, 0.09, 0.11]. */
+    readonly ink?: readonly [number, number, number];
+    /** Sobel magnitude where the outline starts and where it is fully on. Defaults 0.26 and 0.6. */
+    readonly edgeStart?: number;
+    readonly edgeEnd?: number;
+    /** Render-target size in device px; sets `u_texel`. Update on resize with `toonTexel`. */
+    readonly size?: readonly [number, number];
+    readonly order?: AuraPostPassOrder;
+}
+export declare const TOON_FRAGMENT = "\nuniform vec2 u_texel;\nuniform float u_bands;\nuniform float u_band_mix;\nuniform float u_outline;\nuniform vec3 u_ink;\nuniform vec2 u_edge;\nfloat lum(vec3 c) { return dot(c, vec3(0.2126, 0.7152, 0.0722)); }\nvoid main() {\n  vec4 c = texture(u_color, v_uv);\n  float l = lum(c.rgb);\n  float banded = floor(l * u_bands + 0.5) / u_bands;\n  float target = mix(l, banded, u_band_mix);\n  vec3 col = c.rgb * (target / max(l, 0.02));\n  float tl = lum(texture(u_color, v_uv + u_texel * vec2(-1.0, 1.0)).rgb);\n  float t = lum(texture(u_color, v_uv + u_texel * vec2(0.0, 1.0)).rgb);\n  float tr = lum(texture(u_color, v_uv + u_texel * vec2(1.0, 1.0)).rgb);\n  float lf = lum(texture(u_color, v_uv + u_texel * vec2(-1.0, 0.0)).rgb);\n  float rt = lum(texture(u_color, v_uv + u_texel * vec2(1.0, 0.0)).rgb);\n  float bl = lum(texture(u_color, v_uv + u_texel * vec2(-1.0, -1.0)).rgb);\n  float b = lum(texture(u_color, v_uv + u_texel * vec2(0.0, -1.0)).rgb);\n  float br = lum(texture(u_color, v_uv + u_texel * vec2(1.0, -1.0)).rgb);\n  float gx = (tr + 2.0 * rt + br) - (tl + 2.0 * lf + bl);\n  float gy = (tl + 2.0 * t + tr) - (bl + 2.0 * b + br);\n  float edge = smoothstep(u_edge.x, u_edge.y, sqrt(gx * gx + gy * gy));\n  outColor = vec4(mix(col, u_ink, edge * u_outline), c.a);\n}";
+/** `u_texel` value for a render target of `width` x `height` device px; pass it to `app.post.setPassUniform(name, "u_texel", ...)` on resize. */
+export declare function toonTexel(width: number, height: number): number[];
+export declare const toonEffectBuilders: {
+    /** Cel pass over the final image: luma banding plus a Sobel outline. Returns a post pass for `app.post.addPostPass(...)`. */
+    readonly toon: (options?: AuraToonOptions) => AuraCustomPostPass;
+};
+//# sourceMappingURL=effects.toon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"effects.toon.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.toon.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGrF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,gGAAgG;IAChG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED,eAAO,MAAM,aAAa,uwCA0BxB,CAAC;AAEH,iJAAiJ;AACjJ,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AASD,eAAO,MAAM,kBAAkB;IAC7B,6HAA6H;8BAC7G,eAAe,KAAQ,kBAAkB;CAyBjD,CAAC"}

package/dist/engine/agent-api/nodes/effects.toon.js

@@ -0,0 +1,70 @@
+import { AuraRuntimeError } from "../compiler/errors.js";
+import { postEffectBuilders } from "./effects.post.js";
+export const TOON_FRAGMENT = /* glsl */ `
+uniform vec2 u_texel;
+uniform float u_bands;
+uniform float u_band_mix;
+uniform float u_outline;
+uniform vec3 u_ink;
+uniform vec2 u_edge;
+float lum(vec3 c) { return dot(c, vec3(0.2126, 0.7152, 0.0722)); }
+void main() {
+  vec4 c = texture(u_color, v_uv);
+  float l = lum(c.rgb);
+  float banded = floor(l * u_bands + 0.5) / u_bands;
+  float target = mix(l, banded, u_band_mix);
+  vec3 col = c.rgb * (target / max(l, 0.02));
+  float tl = lum(texture(u_color, v_uv + u_texel * vec2(-1.0, 1.0)).rgb);
+  float t = lum(texture(u_color, v_uv + u_texel * vec2(0.0, 1.0)).rgb);
+  float tr = lum(texture(u_color, v_uv + u_texel * vec2(1.0, 1.0)).rgb);
+  float lf = lum(texture(u_color, v_uv + u_texel * vec2(-1.0, 0.0)).rgb);
+  float rt = lum(texture(u_color, v_uv + u_texel * vec2(1.0, 0.0)).rgb);
+  float bl = lum(texture(u_color, v_uv + u_texel * vec2(-1.0, -1.0)).rgb);
+  float b = lum(texture(u_color, v_uv + u_texel * vec2(0.0, -1.0)).rgb);
+  float br = lum(texture(u_color, v_uv + u_texel * vec2(1.0, -1.0)).rgb);
+  float gx = (tr + 2.0 * rt + br) - (tl + 2.0 * lf + bl);
+  float gy = (tl + 2.0 * t + tr) - (bl + 2.0 * b + br);
+  float edge = smoothstep(u_edge.x, u_edge.y, sqrt(gx * gx + gy * gy));
+  outColor = vec4(mix(col, u_ink, edge * u_outline), c.a);
+}`;
+/** `u_texel` value for a render target of `width` x `height` device px; pass it to `app.post.setPassUniform(name, "u_texel", ...)` on resize. */
+export function toonTexel(width, height) {
+    return [1 / Math.max(1, width), 1 / Math.max(1, height)];
+}
+function finiteIn(label, value, min, max) {
+    if (!Number.isFinite(value) || value < min || value > max) {
+        throw new AuraRuntimeError("invalid-material-spec", `effects.toon ${label} must be a finite number in [${min}, ${max}], got ${String(value)}`);
+    }
+    return value;
+}
+export const toonEffectBuilders = {
+    /** Cel pass over the final image: luma banding plus a Sobel outline. Returns a post pass for `app.post.addPostPass(...)`. */
+    toon: (options = {}) => {
+        const bands = finiteIn("bands", options.bands ?? 5, 2, 64);
+        const bandMix = finiteIn("bandMix", options.bandMix ?? 0.75, 0, 1);
+        const outline = finiteIn("outline", options.outline ?? 0.75, 0, 1);
+        const ink = options.ink ?? [0.05, 0.09, 0.11];
+        if (ink.length !== 3)
+            throw new AuraRuntimeError("invalid-material-spec", "effects.toon ink must be [r, g, b]");
+        ink.forEach((v) => finiteIn("ink channel", v, 0, 1));
+        const edgeStart = finiteIn("edgeStart", options.edgeStart ?? 0.26, 0, 4);
+        const edgeEnd = finiteIn("edgeEnd", options.edgeEnd ?? 0.6, 0, 4);
+        if (edgeEnd <= edgeStart)
+            throw new AuraRuntimeError("invalid-material-spec", "effects.toon edgeEnd must be greater than edgeStart");
+        const size = options.size ?? [1280, 720];
+        return postEffectBuilders.shaderPass({
+            name: options.name ?? "toon",
+            order: options.order ?? "after-tonemap",
+            glsl: TOON_FRAGMENT,
+            uniforms: {
+                u_texel: toonTexel(size[0], size[1]),
+                u_bands: bands,
+                u_band_mix: bandMix,
+                u_outline: outline,
+                u_ink: [...ink],
+                u_edge: [edgeStart, edgeEnd]
+            }
+        });
+    }
+};
+//# sourceMappingURL=effects.toon.js.map

package/dist/engine/agent-api/nodes/effects.toon.js.map

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

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

@@ -39,10 +39,17 @@ export declare class AuraInstancedMeshHandle extends AuraNodeBuilder<AuraBatched
     position(x: number, y: number, z: number): AuraNodeBuilder<AuraBatchedNode & {
         readonly position: import("./types.js").AuraVec3;
     }>;
+    position(value: import("./types.js").AuraVec3): AuraNodeBuilder<AuraBatchedNode & {
+        readonly position: import("./types.js").AuraVec3;
+    }>;
     rotate(x: number, y: number, z: number, order?: import("../../contracts/sceneGraph.js").AuraEulerOrder): AuraNodeBuilder<AuraBatchedNode & {
         readonly rotation: import("./types.js").AuraVec3;
         readonly rotationOrder?: import("../../contracts/sceneGraph.js").AuraEulerOrder;
     }>;
+    rotate(value: import("./types.js").AuraVec3, order?: import("../../contracts/sceneGraph.js").AuraEulerOrder): AuraNodeBuilder<AuraBatchedNode & {
+        readonly rotation: import("./types.js").AuraVec3;
+        readonly rotationOrder?: import("../../contracts/sceneGraph.js").AuraEulerOrder;
+    }>;
     quaternion(x: number, y: number, z: number, w: number): AuraNodeBuilder<AuraBatchedNode & {
         readonly quaternion: import("../../contracts/sceneGraph.js").AuraQuat;
     }>;
@@ -52,6 +59,9 @@ export declare class AuraInstancedMeshHandle extends AuraNodeBuilder<AuraBatched
     lookAt(x: number, y: number, z: number): AuraNodeBuilder<AuraBatchedNode & {
         readonly lookAt: import("./types.js").AuraVec3;
     }>;
+    lookAt(value: import("./types.js").AuraVec3): AuraNodeBuilder<AuraBatchedNode & {
+        readonly lookAt: import("./types.js").AuraVec3;
+    }>;
     material(spec: AuraMaterialSpec): AuraNodeBuilder<AuraBatchedNode & {
         readonly material: AuraMaterialSpec;
     }>;

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

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