@aura3d/rendering 3.0.1 → 4.0.2

package/dist/vfx/ProceduralVolumeEmitter.d.ts

@@ -0,0 +1,90 @@
+import { type ParticleInstanceRing } from "./ParticleInstanceLayout.js";
+export type Vec3Tuple = readonly [number, number, number];
+export interface VolumeEmitterSpec {
+    /** Full extent of the wrap volume centred on the camera. */
+    readonly extent: Vec3Tuple;
+    /** Per-particle fall velocity (world units/s). */
+    readonly fallVelocity: Vec3Tuple;
+    /** Sway amplitude per axis. */
+    readonly sway: Vec3Tuple;
+    readonly swayFreq: number;
+    readonly seed?: number;
+    /** Particle size (uniform scalar). */
+    readonly size: number;
+    readonly color: Vec3Tuple;
+    readonly alpha: number;
+    /** Velocity-stretch factor for rain streaks (0 = camera-facing billboards). */
+    readonly stretch?: number;
+}
+/** §14 presets — rain, snow, marine snow, dust motes. */
+export declare const VOLUME_PRESETS: {
+    readonly rain: {
+        readonly extent: readonly [40, 24, 40];
+        readonly fallVelocity: readonly [0, -9, 0];
+        readonly sway: readonly [0.15, 0, 0.15];
+        readonly swayFreq: 0.7;
+        readonly size: 0.09;
+        readonly color: readonly [0.55, 0.62, 0.72];
+        readonly alpha: 0.45;
+        readonly stretch: 6;
+    };
+    readonly snow: {
+        readonly extent: readonly [36, 18, 36];
+        readonly fallVelocity: readonly [0, -1.2, 0];
+        readonly sway: readonly [0.6, 0.05, 0.6];
+        readonly swayFreq: 0.5;
+        readonly size: 0.12;
+        readonly color: readonly [0.95, 0.96, 1];
+        readonly alpha: 0.9;
+        readonly stretch: 0;
+    };
+    readonly marineSnow: {
+        readonly extent: readonly [20, 12, 20];
+        readonly fallVelocity: readonly [0, -0.12, 0];
+        readonly sway: readonly [0.25, 0.1, 0.25];
+        readonly swayFreq: 0.22;
+        readonly size: 0.05;
+        readonly color: readonly [0.85, 0.9, 0.95];
+        readonly alpha: 0.7;
+        readonly stretch: 0;
+    };
+    readonly dustMotes: {
+        readonly extent: readonly [12, 8, 12];
+        readonly fallVelocity: readonly [0, -0.04, 0];
+        readonly sway: readonly [0.18, 0.12, 0.18];
+        readonly swayFreq: 0.35;
+        readonly size: 0.04;
+        readonly color: readonly [0.9, 0.85, 0.7];
+        readonly alpha: 0.35;
+        readonly stretch: 0;
+    };
+};
+/** a3dHash31 — CPU mirror (identical constants to the GLSL chunk). */
+export declare function a3dHash31Cpu(x: number): Vec3Tuple;
+/**
+ * §8.2 `a3dProceduralVolumePos` CPU mirror: returns the wrapped position of
+ * particle `id` at time `t` inside the camera-centred volume.
+ */
+export declare function proceduralVolumePos(id: number, t: number, spec: VolumeEmitterSpec, cameraPosition: Vec3Tuple): Vec3Tuple;
+/** §8.2 edge fade — min over axes of the 15% margin ramp. */
+export declare function proceduralVolumeEdgeFade(pos: Vec3Tuple, spec: VolumeEmitterSpec, cameraPosition: Vec3Tuple): number;
+/**
+ * §8.2 procedural volume emitter: writes `count` particles into an
+ * instance ring each frame (positions via the CPU mirror above), so the
+ * draw path is the same instanced particle pass used by CPU emitters.
+ * A future GPU-position variant would instead bind `a3d_prd07_volume`.
+ */
+export declare class ProceduralVolumeEmitter {
+    private readonly spec;
+    private readonly count;
+    constructor(spec: VolumeEmitterSpec, count: number);
+    /** Deterministic positions for all `count` ids at camera `cam`, time `t`. */
+    positions(t: number, cam: Vec3Tuple): Float32Array;
+    /**
+     * Fill a ParticleInstanceRing with this frame's wrapped positions (alpha
+     * scaled by the edge fade). Positions feed the same instanced draw as
+     * emitter-driven particles — §6.2.1 layout, 16 floats per particle.
+     */
+    fillInstanceRing(ring: ParticleInstanceRing, t: number, cam: Vec3Tuple): void;
+}
+//# sourceMappingURL=ProceduralVolumeEmitter.d.ts.map

package/dist/vfx/ProceduralVolumeEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProceduralVolumeEmitter.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/vfx/ProceduralVolumeEmitter.ts"],"names":[],"mappings":"AAMA,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAI/F,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,yDAAyD;AACzD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC2B,CAAC;AAMvD,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAWjD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,iBAAiB,EACvB,cAAc,EAAE,SAAS,GACxB,SAAS,CAgBX;AAED,6DAA6D;AAC7D,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,iBAAiB,EACvB,cAAc,EAAE,SAAS,GACxB,MAAM,CAQR;AAED;;;;;GAKG;AACH,qBAAa,uBAAuB;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAqB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAA/C,IAAI,EAAE,iBAAiB,EAAmB,KAAK,EAAE,MAAM;IAEpF,6EAA6E;IAC7E,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,YAAY;IAWlD;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI;CAuB9E"}

package/dist/vfx/ProceduralVolumeEmitter.js

@@ -0,0 +1,155 @@
+// PRD-07 P5-T2 — §8.2 procedural volume source: camera-following rain, snow,
+// marine snow and dust motes. The CPU mirror below matches the
+// `a3d_prd07_volume` chunk hash-for-hash so a producer can write instance
+// buffers (the existing instanced particle path) that agree with generated
+// shaders calling a3dProceduralVolumePos directly.
+import { PARTICLE_INSTANCE_FLOATS } from "./ParticleInstanceLayout.js";
+const clamp = (v, lo, hi) => Math.min(Math.max(v, lo), hi);
+/** §14 presets — rain, snow, marine snow, dust motes. */
+export const VOLUME_PRESETS = {
+    rain: {
+        extent: [40, 24, 40],
+        fallVelocity: [0, -9, 0],
+        sway: [0.15, 0, 0.15],
+        swayFreq: 0.7,
+        size: 0.09,
+        color: [0.55, 0.62, 0.72],
+        alpha: 0.45,
+        stretch: 6
+    },
+    snow: {
+        extent: [36, 18, 36],
+        fallVelocity: [0, -1.2, 0],
+        sway: [0.6, 0.05, 0.6],
+        swayFreq: 0.5,
+        size: 0.12,
+        color: [0.95, 0.96, 1.0],
+        alpha: 0.9,
+        stretch: 0
+    },
+    marineSnow: {
+        extent: [20, 12, 20],
+        fallVelocity: [0, -0.12, 0],
+        sway: [0.25, 0.1, 0.25],
+        swayFreq: 0.22,
+        size: 0.05,
+        color: [0.85, 0.9, 0.95],
+        alpha: 0.7,
+        stretch: 0
+    },
+    dustMotes: {
+        extent: [12, 8, 12],
+        fallVelocity: [0, -0.04, 0],
+        sway: [0.18, 0.12, 0.18],
+        swayFreq: 0.35,
+        size: 0.04,
+        color: [0.9, 0.85, 0.7],
+        alpha: 0.35,
+        stretch: 0
+    }
+};
+function fract(x) {
+    return x - Math.floor(x);
+}
+/** a3dHash31 — CPU mirror (identical constants to the GLSL chunk). */
+export function a3dHash31Cpu(x) {
+    let px = fract(x * 0.1031);
+    let py = fract(x * 0.103);
+    let pz = fract(x * 0.0973);
+    const d = px * (py + 33.33) + py * (pz + 33.33) + pz * (px + 33.33);
+    px += d;
+    py += d;
+    pz += d;
+    return [
+        fract((px + px) * pz + px * py),
+        fract((py + pz) * px + py * pz),
+        fract((pz + px) * py + pz * px)
+    ];
+}
+/**
+ * §8.2 `a3dProceduralVolumePos` CPU mirror: returns the wrapped position of
+ * particle `id` at time `t` inside the camera-centred volume.
+ */
+export function proceduralVolumePos(id, t, spec, cameraPosition) {
+    const h = a3dHash31Cpu(id * 0.6180339 + (spec.seed ?? 0));
+    const swayPhase = t * spec.swayFreq + h[0] * Math.PI * 2;
+    const p = [
+        h[0] * spec.extent[0] + spec.fallVelocity[0] * t + spec.sway[0] * Math.sin(swayPhase),
+        h[1] * spec.extent[1] + spec.fallVelocity[1] * t + spec.sway[1] * Math.sin(swayPhase),
+        h[2] * spec.extent[2] + spec.fallVelocity[2] * t + spec.sway[2] * Math.sin(swayPhase)
+    ];
+    const o0 = p[0] - cameraPosition[0] + spec.extent[0] * 0.5;
+    const o1 = p[1] - cameraPosition[1] + spec.extent[1] * 0.5;
+    const o2 = p[2] - cameraPosition[2] + spec.extent[2] * 0.5;
+    return [
+        cameraPosition[0] + (o0 - Math.floor(o0 / spec.extent[0]) * spec.extent[0]) - spec.extent[0] * 0.5,
+        cameraPosition[1] + (o1 - Math.floor(o1 / spec.extent[1]) * spec.extent[1]) - spec.extent[1] * 0.5,
+        cameraPosition[2] + (o2 - Math.floor(o2 / spec.extent[2]) * spec.extent[2]) - spec.extent[2] * 0.5
+    ];
+}
+/** §8.2 edge fade — min over axes of the 15% margin ramp. */
+export function proceduralVolumeEdgeFade(pos, spec, cameraPosition) {
+    let f = 1;
+    for (let i = 0; i < 3; i += 1) {
+        const edge = Math.abs(pos[i] - cameraPosition[i]);
+        const denom = Math.max(spec.extent[i] * 0.15, 1e-4);
+        f = Math.min(f, clamp((spec.extent[i] * 0.5 - edge) / denom, 0, 1));
+    }
+    return f;
+}
+/**
+ * §8.2 procedural volume emitter: writes `count` particles into an
+ * instance ring each frame (positions via the CPU mirror above), so the
+ * draw path is the same instanced particle pass used by CPU emitters.
+ * A future GPU-position variant would instead bind `a3d_prd07_volume`.
+ */
+export class ProceduralVolumeEmitter {
+    spec;
+    count;
+    constructor(spec, count) {
+        this.spec = spec;
+        this.count = count;
+    }
+    /** Deterministic positions for all `count` ids at camera `cam`, time `t`. */
+    positions(t, cam) {
+        const out = new Float32Array(this.count * 3);
+        for (let id = 0; id < this.count; id += 1) {
+            const p = proceduralVolumePos(id, t, this.spec, cam);
+            out[id * 3] = p[0];
+            out[id * 3 + 1] = p[1];
+            out[id * 3 + 2] = p[2];
+        }
+        return out;
+    }
+    /**
+     * Fill a ParticleInstanceRing with this frame's wrapped positions (alpha
+     * scaled by the edge fade). Positions feed the same instanced draw as
+     * emitter-driven particles — §6.2.1 layout, 16 floats per particle.
+     */
+    fillInstanceRing(ring, t, cam) {
+        const data = new Float32Array(this.count * PARTICLE_INSTANCE_FLOATS);
+        for (let id = 0; id < this.count; id += 1) {
+            const p = proceduralVolumePos(id, t, this.spec, cam);
+            const fade = proceduralVolumeEdgeFade(p, this.spec, cam);
+            const i = id * PARTICLE_INSTANCE_FLOATS;
+            data[i] = p[0];
+            data[i + 1] = p[1];
+            data[i + 2] = p[2];
+            data[i + 3] = this.spec.size;
+            data[i + 4] = this.spec.fallVelocity[0];
+            data[i + 5] = this.spec.fallVelocity[1];
+            data[i + 6] = this.spec.fallVelocity[2];
+            data[i + 7] = this.spec.stretch ?? 0;
+            data[i + 8] = this.spec.color[0];
+            data[i + 9] = this.spec.color[1];
+            data[i + 10] = this.spec.color[2];
+            data[i + 11] = this.spec.alpha * fade;
+            data[i + 12] = 0; // rotation
+            data[i + 13] = 0; // frame
+            data[i + 14] = fade; // near-fade seed
+            data[i + 15] = 0;
+        }
+        ring.write(data, this.count);
+    }
+}
+//# sourceMappingURL=ProceduralVolumeEmitter.js.map

package/dist/vfx/ProceduralVolumeEmitter.js.map

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

package/dist/vfx/RibbonBatch.d.ts

@@ -0,0 +1,71 @@
+export type AuraVec3 = readonly [number, number, number];
+export type AuraVec4 = readonly [number, number, number, number];
+export interface RibbonPoint {
+    readonly position: AuraVec3;
+    readonly time: number;
+    readonly width: number;
+    readonly color: AuraVec4;
+}
+export type RibbonOrientation = "camera" | "surface";
+export interface RibbonTrailOptions {
+    readonly id: string;
+    /** Ring capacity; a full trail drops the oldest point (default 48). */
+    readonly maxPoints?: number;
+    /** Minimum world-space distance between appended points (default 0.05). */
+    readonly minVertexDistance?: number;
+    /** Default ribbon half-width multiplier (`point.width` wins when set). */
+    readonly width?: number;
+    readonly color?: AuraVec4;
+    readonly orientation?: RibbonOrientation;
+    /** `surface` orientation: strip is pinned to this normal (skid marks). */
+    readonly surfaceNormal?: AuraVec3;
+}
+export declare class RibbonTrail {
+    private readonly points;
+    readonly options: Required<Omit<RibbonTrailOptions, "surfaceNormal">> & {
+        readonly surfaceNormal?: AuraVec3;
+    };
+    constructor(options: RibbonTrailOptions);
+    get pointCount(): number;
+    getPoints(): readonly RibbonPoint[];
+    /** Appends a point when the trail moved farther than minVertexDistance. */
+    push(position: AuraVec3, time: number, width?: number, color?: AuraVec4): boolean;
+    clear(): void;
+}
+export interface RibbonGeometry {
+    /** 12 floats per vertex: position(3) normal(3) uv(2) color(4). */
+    readonly vertices: Float32Array;
+    readonly indices: Uint32Array;
+    readonly vertexCount: number;
+    readonly triangleCount: number;
+    /** Which orientation group produced this geometry ("camera" | "surface"). */
+    readonly orientation: RibbonOrientation;
+}
+/** Ribbon vertex stride in floats: pos3 + normal3 + uv2 + color4. */
+export declare const RIBBON_VERTEX_FLOATS = 12;
+/**
+ * Owns every live trail and builds the per-orientation draw geometry. One
+ * batch = one draw per orientation key (§6.2.9).
+ */
+export declare class RibbonBatch {
+    private readonly trails;
+    /**
+     * §6.9/P6-T3: producers that route `surface` trails through the decal pass
+     * narrow this to ["camera"] under A3D_QR_VFX_DECALS so the ribbon pass does
+     * not double-draw them. Default draws both groups (flag-off identical).
+     */
+    enabledOrientations: readonly RibbonOrientation[];
+    upsertTrail(options: RibbonTrailOptions): RibbonTrail;
+    getTrail(id: string): RibbonTrail | undefined;
+    removeTrail(id: string): void;
+    get trailCount(): number;
+    clear(): void;
+    /**
+     * Expand a trail's point ring into vertices/indices. `cameraPosition` is
+     * required for `camera` orientation and ignored for `surface`.
+     */
+    buildGeometry(trail: RibbonTrail, cameraPosition: AuraVec3): RibbonGeometry | null;
+    /** One merged geometry per enabled orientation group (the draw-key split). */
+    buildAll(cameraPosition: AuraVec3): RibbonGeometry[];
+}
+//# sourceMappingURL=RibbonBatch.d.ts.map

package/dist/vfx/RibbonBatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RibbonBatch.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/vfx/RibbonBatch.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC;CACnC;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC,GAAG;QAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;gBAElG,OAAO,EAAE,kBAAkB;IAYvC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,SAAS,IAAI,SAAS,WAAW,EAAE;IAInC,2EAA2E;IAC3E,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO;IAkBjF,KAAK,IAAI,IAAI;CAGd;AAED,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;CACzC;AAED,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAIvC;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAEzD;;;;OAIG;IACH,mBAAmB,EAAE,SAAS,iBAAiB,EAAE,CAAyB;IAE1E,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;IASrD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7B,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,GAAG,cAAc,GAAG,IAAI;IAuFlF,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,QAAQ,GAAG,cAAc,EAAE;CA+BrD"}

package/dist/vfx/RibbonBatch.js

@@ -0,0 +1,234 @@
+// PRD-07 P2-T4 — CPU ribbon trails (§6.2.9). Each trail keeps a ring of
+// (position, time, width, color) points, appended only when the target moved
+// farther than `minVertexDistance`. `buildGeometry` expands every trail into a
+// camera-facing or surface-pinned triangle strip: 2 vertices per point, two
+// triangles per segment, so an N-point trail draws 2·(N−1) triangles.
+//
+// The default alpha curve is the Resident renderer's ribbon alpha
+// `0.45·(1 − segment/depth)` (ResidentGPUParticleRenderer.ts:512, E10).
+const MAX_POINTS = 48;
+const MIN_VERTEX_DISTANCE = 0.05;
+const RIBBON_ALPHA_PEAK = 0.45;
+export class RibbonTrail {
+    points = [];
+    options;
+    constructor(options) {
+        this.options = {
+            id: options.id,
+            maxPoints: options.maxPoints ?? MAX_POINTS,
+            minVertexDistance: options.minVertexDistance ?? MIN_VERTEX_DISTANCE,
+            width: options.width ?? 0.3,
+            color: options.color ?? [1, 1, 1, 1],
+            orientation: options.orientation ?? "camera",
+            surfaceNormal: options.surfaceNormal
+        };
+    }
+    get pointCount() {
+        return this.points.length;
+    }
+    getPoints() {
+        return this.points;
+    }
+    /** Appends a point when the trail moved farther than minVertexDistance. */
+    push(position, time, width, color) {
+        const last = this.points[this.points.length - 1];
+        if (last) {
+            const dx = position[0] - last.position[0];
+            const dy = position[1] - last.position[1];
+            const dz = position[2] - last.position[2];
+            if (Math.hypot(dx, dy, dz) < this.options.minVertexDistance)
+                return false;
+        }
+        this.points.push({
+            position,
+            time,
+            width: width ?? this.options.width,
+            color: color ?? this.options.color
+        });
+        while (this.points.length > this.options.maxPoints)
+            this.points.shift();
+        return true;
+    }
+    clear() {
+        this.points.length = 0;
+    }
+}
+/** Ribbon vertex stride in floats: pos3 + normal3 + uv2 + color4. */
+export const RIBBON_VERTEX_FLOATS = 12;
+const EPS = 1e-6;
+/**
+ * Owns every live trail and builds the per-orientation draw geometry. One
+ * batch = one draw per orientation key (§6.2.9).
+ */
+export class RibbonBatch {
+    trails = new Map();
+    /**
+     * §6.9/P6-T3: producers that route `surface` trails through the decal pass
+     * narrow this to ["camera"] under A3D_QR_VFX_DECALS so the ribbon pass does
+     * not double-draw them. Default draws both groups (flag-off identical).
+     */
+    enabledOrientations = ["camera", "surface"];
+    upsertTrail(options) {
+        let trail = this.trails.get(options.id);
+        if (!trail) {
+            trail = new RibbonTrail(options);
+            this.trails.set(options.id, trail);
+        }
+        return trail;
+    }
+    getTrail(id) {
+        return this.trails.get(id);
+    }
+    removeTrail(id) {
+        this.trails.delete(id);
+    }
+    get trailCount() {
+        return this.trails.size;
+    }
+    clear() {
+        this.trails.clear();
+    }
+    /**
+     * Expand a trail's point ring into vertices/indices. `cameraPosition` is
+     * required for `camera` orientation and ignored for `surface`.
+     */
+    buildGeometry(trail, cameraPosition) {
+        const pts = trail.getPoints();
+        const n = pts.length;
+        if (n < 2)
+            return null;
+        const orientation = trail.options.orientation;
+        const vertexCount = n * 2;
+        const vertices = new Float32Array(vertexCount * RIBBON_VERTEX_FLOATS);
+        const segments = n - 1;
+        const indices = new Uint32Array(segments * 6);
+        for (let i = 0; i < n; i++) {
+            const p = pts[i];
+            // Central-difference tangent; endpoints reuse the neighbour edge.
+            const prev = pts[Math.max(0, i - 1)].position;
+            const next = pts[Math.min(n - 1, i + 1)].position;
+            let tx = next[0] - prev[0];
+            let ty = next[1] - prev[1];
+            let tz = next[2] - prev[2];
+            const tl = Math.hypot(tx, ty, tz);
+            if (tl < EPS) {
+                tx = 1;
+                ty = 0;
+                tz = 0;
+            }
+            else {
+                tx /= tl;
+                ty /= tl;
+                tz /= tl;
+            }
+            let sx;
+            let sy;
+            let sz;
+            let nx;
+            let ny;
+            let nz;
+            if (orientation === "surface") {
+                const sn = trail.options.surfaceNormal ?? [0, 1, 0];
+                const nl = Math.hypot(sn[0], sn[1], sn[2]) || 1;
+                nx = sn[0] / nl;
+                ny = sn[1] / nl;
+                nz = sn[2] / nl;
+                // side = normalize(cross(tangent, normal))
+                sx = ty * nz - tz * ny;
+                sy = tz * nx - tx * nz;
+                sz = tx * ny - ty * nx;
+            }
+            else {
+                // side = normalize(cross(tangent, cameraPosition − point))
+                const cx = cameraPosition[0] - p.position[0];
+                const cy = cameraPosition[1] - p.position[1];
+                const cz = cameraPosition[2] - p.position[2];
+                sx = ty * cz - tz * cy;
+                sy = tz * cx - tx * cz;
+                sz = tx * cy - ty * cx;
+                const cl = Math.hypot(cx, cy, cz) || 1;
+                nx = cx / cl;
+                ny = cy / cl;
+                nz = cz / cl;
+            }
+            const sl = Math.hypot(sx, sy, sz);
+            if (sl < EPS) {
+                sx = nx;
+                sy = ny;
+                sz = nz;
+            }
+            else {
+                sx /= sl;
+                sy /= sl;
+                sz /= sl;
+            }
+            const u = i / segments;
+            // §6.2.9 / E10: default alpha curve 0.45·(1 − segment/maxPoints).
+            const alpha = RIBBON_ALPHA_PEAK * (1 - i / trail.options.maxPoints) * p.color[3];
+            const w = p.width * 0.5;
+            for (let side = 0; side < 2; side++) {
+                const sign = side === 0 ? -1 : 1;
+                const o = (i * 2 + side) * RIBBON_VERTEX_FLOATS;
+                vertices[o + 0] = p.position[0] + sx * w * sign;
+                vertices[o + 1] = p.position[1] + sy * w * sign;
+                vertices[o + 2] = p.position[2] + sz * w * sign;
+                vertices[o + 3] = nx;
+                vertices[o + 4] = ny;
+                vertices[o + 5] = nz;
+                vertices[o + 6] = u;
+                vertices[o + 7] = side;
+                vertices[o + 8] = p.color[0];
+                vertices[o + 9] = p.color[1];
+                vertices[o + 10] = p.color[2];
+                vertices[o + 11] = alpha;
+            }
+            if (i > 0) {
+                const base = (i - 1) * 6;
+                const v0 = (i - 1) * 2;
+                indices[base + 0] = v0;
+                indices[base + 1] = v0 + 1;
+                indices[base + 2] = v0 + 2;
+                indices[base + 3] = v0 + 1;
+                indices[base + 4] = v0 + 3;
+                indices[base + 5] = v0 + 2;
+            }
+        }
+        return { vertices, indices, vertexCount, triangleCount: segments * 2, orientation };
+    }
+    /** One merged geometry per enabled orientation group (the draw-key split). */
+    buildAll(cameraPosition) {
+        const out = [];
+        for (const orientation of this.enabledOrientations) {
+            const group = [...this.trails.values()].filter((t) => t.options.orientation === orientation);
+            if (group.length === 0)
+                continue;
+            let totalVerts = 0;
+            let totalIdx = 0;
+            const built = group
+                .map((t) => this.buildGeometry(t, cameraPosition))
+                .filter((g) => g !== null);
+            for (const g of built) {
+                totalVerts += g.vertexCount;
+                totalIdx += g.indices.length;
+            }
+            if (totalIdx === 0)
+                continue;
+            const vertices = new Float32Array(totalVerts * RIBBON_VERTEX_FLOATS);
+            const indices = new Uint32Array(totalIdx);
+            let vo = 0;
+            let io = 0;
+            let triangles = 0;
+            for (const g of built) {
+                vertices.set(g.vertices, vo);
+                for (let i = 0; i < g.indices.length; i++)
+                    indices[io + i] = g.indices[i] + vo / RIBBON_VERTEX_FLOATS;
+                vo += g.vertices.length;
+                io += g.indices.length;
+                triangles += g.triangleCount;
+            }
+            out.push({ vertices, indices, vertexCount: totalVerts, triangleCount: triangles, orientation });
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=RibbonBatch.js.map

package/dist/vfx/RibbonBatch.js.map

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

package/dist/vfx/RibbonPass.d.ts

@@ -0,0 +1,21 @@
+import type { RenderDevice } from "../RenderDevice.js";
+import type { FrameContributorContext, TransparentQueueItem } from "../contracts/frameGraph.js";
+import { VertexFormat } from "../VertexFormat.js";
+import { RibbonBatch } from "./RibbonBatch.js";
+export declare const RIBBON_VERTEX_FORMAT: VertexFormat;
+export declare class RibbonPass {
+    private readonly device;
+    private readonly programs;
+    private vertexBuffer;
+    private indexBuffer;
+    private vertexCapacity;
+    private indexCapacity;
+    constructor(device: RenderDevice);
+    /** C-01 contributor: one queue item per populated orientation group. */
+    transparentItems(batch: RibbonBatch, ctx: FrameContributorContext): TransparentQueueItem[];
+    private drawGeometry;
+    private ensureBuffer;
+    private program;
+    dispose(): void;
+}
+//# sourceMappingURL=RibbonPass.d.ts.map

package/dist/vfx/RibbonPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RibbonPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/vfx/RibbonPass.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,YAAY,EAAuB,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAA6C,MAAM,eAAe,CAAC;AAIvF,eAAO,MAAM,oBAAoB,cAQhC,CAAC;AAEF,qBAAa,UAAU;IAOT,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAK;gBAEG,MAAM,EAAE,YAAY;IAEjD,wEAAwE;IACxE,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,uBAAuB,GAAG,oBAAoB,EAAE;IAM1F,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,OAAO;IAef,OAAO,IAAI,IAAI;CAKhB"}