@aura3d/rendering 3.0.1 → 4.0.2

package/dist/vfx/BeamPass.js

@@ -0,0 +1,249 @@
+// PRD-07 P2-T9 — beam draw pass (§6.2.10). Camera-facing quad strip for
+// `light-beam`, open cone fan for `lightCone`, animated curtain for
+// `auroraRibbon`. One indexed draw per node through the `prd07.beams`
+// transparent-phase contributor. Vertex layout is the ribbon format
+// (pos3 normal3 uv2 color4); taper/falloff is baked into vertex alpha.
+import { TextureBinding } from "../TextureBinding.js";
+import { PRD07_DEPTH_SAMPLER } from "./depthSampler.js";
+import { RIBBON_VERTEX_FORMAT } from "./RibbonPass.js";
+import { resolveOutputColorSpace, resolveSceneDepth } from "./SceneDepthAdapter.js";
+import { BEAM_SHADER_MARKER, beamFragmentSource, beamProgramKey, beamVertexSource } from "./shaders/beam.glsl.js";
+const BEAM_RENDER_STATE = {
+    depthTest: true,
+    depthWrite: false,
+    cullMode: "none",
+    blend: true,
+    // §6.2.10 beams/cones/aurora are additive; C-04 stubs lower this to
+    // alpha-over where named blends are unsupported.
+    blendMode: "additive",
+    depthCompare: "less-equal"
+};
+const IDENTITY_MAT4 = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+function sub(a, b) {
+    return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+}
+function add(a, b) {
+    return [a[0] + b[0], a[1] + b[1], a[2] + b[2]];
+}
+function scale(v, s) {
+    return [v[0] * s, v[1] * s, v[2] * s];
+}
+function normalize(v) {
+    const l = Math.hypot(v[0], v[1], v[2]) || 1;
+    return [v[0] / l, v[1] / l, v[2] / l];
+}
+function cross(a, b) {
+    return [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
+}
+class VertexWriter {
+    verts = [];
+    indices = [];
+    cursor = 0;
+    push(p, n, uv, c) {
+        this.verts.push(p[0], p[1], p[2], n[0], n[1], n[2], uv[0], uv[1], c[0], c[1], c[2], c[3]);
+        return this.cursor++;
+    }
+    tri(a, b, c) {
+        this.indices.push(a, b, c);
+    }
+    quad(a, b, c, d) {
+        this.indices.push(a, b, c, a, c, d);
+    }
+    build() {
+        return { vertices: new Float32Array(this.verts), indices: new Uint32Array(this.indices), vertexCount: this.cursor };
+    }
+}
+/** Camera-facing strip from→to; alpha fades linearly toward `to`. */
+function buildBeam(spec, cameraPos) {
+    const from = spec.from ?? spec.position ?? [0, 0, 0];
+    const to = spec.to ?? [0, 1, 0];
+    const half = (spec.widthWorld ?? 0.15) * 0.5;
+    const segs = Math.max(1, Math.min(64, spec.segmentCount ?? 8));
+    const w = new VertexWriter();
+    const axis = sub(to, from);
+    const dir = normalize(axis);
+    for (let i = 0; i <= segs; i++) {
+        const t = i / segs;
+        const p = [from[0] + axis[0] * t, from[1] + axis[1] * t, from[2] + axis[2] * t];
+        const toCam = normalize(sub(cameraPos, p));
+        // expand axis: perpendicular to both beam dir and view dir
+        let side = cross(dir, toCam);
+        if (Math.hypot(side[0], side[1], side[2]) < 1e-4)
+            side = cross(dir, [0, 1, 0]);
+        side = normalize(side);
+        const alpha = 1 - t;
+        const c = [spec.color[0] * spec.intensity, spec.color[1] * spec.intensity, spec.color[2] * spec.intensity, alpha];
+        const pa = add(p, scale(side, half));
+        const pb = add(p, scale(side, -half));
+        const a = w.push(pa, side, [t, 0], c);
+        const b = w.push(pb, side, [t, 1], c);
+        if (i > 0)
+            w.quad(a - 2, b - 2, b, a);
+    }
+    return w.build();
+}
+/** Open cone fan: apex at `position`, opens along `direction` with axial + radial fade. */
+function buildCone(spec) {
+    const apex = spec.position ?? [0, 0, 0];
+    const axis = normalize(spec.direction ?? [0, -1, 0]);
+    const length = spec.length ?? 6;
+    const radius = Math.tan(spec.coneAngle ?? 0.35) * length;
+    const softness = spec.softness ?? 0.4;
+    const radial = 16;
+    const axial = 6;
+    const w = new VertexWriter();
+    const u = Math.abs(axis[1]) > 0.9 ? normalize(cross(axis, [1, 0, 0])) : normalize(cross(axis, [0, 1, 0]));
+    const v = normalize(cross(axis, u));
+    // rows: t along the axis (apex → base), ring of `radial` points
+    const rows = [];
+    for (let i = 0; i <= axial; i++) {
+        const t = i / axial;
+        const center = add(apex, scale(axis, length * t));
+        const r = radius * t;
+        // PRD 14 §8.9 soft additive volume: coneColor · axial² · (0.15 + 0.05·noise)
+        // — 0.175 is the mean of the noise band (the low-frequency noise term is
+        // not baked per vertex). `softness` widens the axial tail (axial^(2·(1−s/2))).
+        // The old pow(1−t, 0.6) peaked at full alpha and drew a near-opaque cone.
+        const along = 1 - t;
+        const alpha = Math.pow(along, 2 * (1 - Math.min(softness, 0.95) * 0.5)) * 0.175;
+        const c = [spec.color[0] * spec.intensity, spec.color[1] * spec.intensity, spec.color[2] * spec.intensity, alpha];
+        const row = [];
+        for (let j = 0; j <= radial; j++) {
+            const a = (j / radial) * Math.PI * 2;
+            const off = add(scale(u, Math.cos(a) * r), scale(v, Math.sin(a) * r));
+            const p = add(center, off);
+            const n = normalize(add(scale(u, Math.cos(a)), scale(v, Math.sin(a))));
+            row.push(w.push(p, n, [j / radial, t], c));
+        }
+        rows.push(row);
+    }
+    for (let i = 1; i < rows.length; i++) {
+        for (let j = 1; j < rows[i].length; j++) {
+            w.quad(rows[i - 1][j - 1], rows[i - 1][j], rows[i][j], rows[i][j - 1]);
+        }
+    }
+    return w.build();
+}
+/** Animated curtain strip — shimmer bands run in the fragment shader. */
+function buildAurora(spec) {
+    const origin = spec.position ?? [0, 0, 0];
+    const width = spec.width ?? 12;
+    const height = spec.height ?? 8;
+    const segs = Math.max(2, Math.min(256, spec.segments ?? 96));
+    const w = new VertexWriter();
+    const base = spec.color;
+    const top = spec.colorTop ?? base;
+    let prevA = -1;
+    let prevB = -1;
+    for (let i = 0; i <= segs; i++) {
+        const t = i / segs;
+        const x = origin[0] + (t - 0.5) * width;
+        // gentle static curtain fold so the sheet reads non-planar even at t=0
+        const z = origin[2] + Math.sin(t * Math.PI * 3) * width * 0.02;
+        const yBot = origin[1];
+        const yTop = origin[1] + height;
+        const cBot = [base[0] * spec.intensity, base[1] * spec.intensity, base[2] * spec.intensity, base[3]];
+        const cTop = [top[0] * spec.intensity, top[1] * spec.intensity, top[2] * spec.intensity, 0];
+        const a = w.push([x, yBot, z], [0, 0, 1], [t, 0], cBot);
+        const b = w.push([x, yTop, z], [0, 0, 1], [t, 1], cTop);
+        if (prevA >= 0)
+            w.quad(prevA, prevB, b, a);
+        prevA = a;
+        prevB = b;
+    }
+    return w.build();
+}
+export class BeamPass {
+    device;
+    programs = new Map();
+    vertexBuffer = null;
+    indexBuffer = null;
+    vertexCapacity = 0;
+    indexCapacity = 0;
+    constructor(device) {
+        this.device = device;
+    }
+    /** C-01 transparent-phase items: one draw per beam-family node. */
+    transparentItems(specs, ctx) {
+        const cameraPosition = (ctx.camera?.position ?? [0, 0, 0]);
+        const items = [];
+        for (const spec of specs) {
+            const geometry = spec.kind === "lightCone" ? buildCone(spec) : spec.kind === "auroraRibbon" ? buildAurora(spec) : buildBeam(spec, cameraPosition);
+            if (geometry.vertexCount === 0)
+                continue;
+            items.push({ sortDepth: 0, draw: () => this.drawGeometry(spec, geometry, ctx) });
+        }
+        return items;
+    }
+    drawGeometry(spec, geometry, ctx) {
+        const vb = this.ensureBuffer("vertex", geometry.vertices.byteLength, this.vertexBuffer, "vb");
+        this.device.updateBuffer(vb, 0, geometry.vertices);
+        const ib = this.ensureBuffer("index", geometry.indices.byteLength, this.indexBuffer, "ib");
+        this.device.updateBuffer(ib, 0, geometry.indices);
+        const depth = resolveSceneDepth(ctx);
+        const softParticles = depth?.available === true && depth.source.texture !== null;
+        const aurora = spec.kind === "auroraRibbon";
+        const shader = this.program({ softParticles, aurora });
+        const uniforms = new Map([
+            ["u_viewProjection", ctx.camera?.viewProjectionMatrix ?? IDENTITY_MAT4],
+            // Same §6.2.7 output contract as the particle pass: linear into the HDR
+            // scene target when PRD 01 publishes it, gamma-encode only on the legacy
+            // LDR path. A hard-coded 1 gamma-encoded beams into the linear target,
+            // which the output pass then tone-mapped again (washed-out cones).
+            ["u_outputColorSpace", resolveOutputColorSpace(ctx) === "srgb" ? 1 : 0],
+            ["u_time", ctx.timeSeconds ?? 0],
+            ["u_sway", spec.sway ?? 0],
+            ["u_aurora", aurora ? 1 : 0],
+            ["u_shimmer", spec.shimmer ?? 0]
+        ]);
+        if (softParticles && depth) {
+            uniforms.set("u_sceneDepth", new TextureBinding({ name: "u_sceneDepth", texture: depth.source.texture, sampler: PRD07_DEPTH_SAMPLER }));
+            uniforms.set("u_depthLinearize", [depth.source.linearize.near, depth.source.linearize.far, depth.source.linearize.orthographic ? 1 : 0, 0]);
+        }
+        this.device.draw({
+            label: `prd07.beam.${spec.nodeId}`,
+            topology: "triangles",
+            vertexBuffer: vb,
+            vertexFormat: RIBBON_VERTEX_FORMAT,
+            vertexCount: geometry.vertexCount,
+            indexBuffer: ib,
+            indexType: "uint32",
+            indexCount: geometry.indices.length,
+            shader,
+            uniforms,
+            renderState: BEAM_RENDER_STATE
+        });
+    }
+    ensureBuffer(usage, bytes, existing, which) {
+        const capacity = which === "vb" ? this.vertexCapacity : this.indexCapacity;
+        if (existing && capacity >= bytes)
+            return existing;
+        const next = Math.max(bytes, capacity * 2 || 0, 4096);
+        existing?.dispose();
+        const buffer = this.device.createBuffer(usage, next);
+        if (which === "vb") {
+            this.vertexBuffer = buffer;
+            this.vertexCapacity = next;
+        }
+        else {
+            this.indexBuffer = buffer;
+            this.indexCapacity = next;
+        }
+        return buffer;
+    }
+    program(defines) {
+        const key = beamProgramKey(defines);
+        let shader = this.programs.get(key);
+        if (!shader) {
+            shader = this.device.createShaderProgram({
+                label: key,
+                vertex: beamVertexSource(),
+                fragment: beamFragmentSource(defines),
+                marker: BEAM_SHADER_MARKER
+            });
+            this.programs.set(key, shader);
+        }
+        return shader;
+    }
+}
+//# sourceMappingURL=BeamPass.js.map

package/dist/vfx/BeamPass.js.map

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

package/dist/vfx/BlendFallback.d.ts

@@ -0,0 +1,19 @@
+import type { BlendMode } from "../contracts/blend.js";
+import type { RenderCommandState } from "../RenderDevice.js";
+export interface VfxBlendResolution {
+    readonly renderState: RenderCommandState;
+    /** Shader writes premultiplied rgb; HW expects straight rgb under alpha-over. */
+    readonly unpremultiplyOutput: boolean;
+    /** §6.2.7 additive approximation under alpha-over (×1.6 core). */
+    readonly additiveFallback: boolean;
+    /** Batch draws nothing this frame (multiply under the C-04 stub). */
+    readonly skipped: boolean;
+    /** Degradation code reported through diagnostics, once per key. */
+    readonly degraded: "VFX_BLEND_FALLBACK" | "VFX_BLEND_SKIPPED" | null;
+}
+/** Test hook: clear the once-per-key report memory. */
+export declare function resetBlendFallbackReports(): void;
+/** Returns the report once per (key, code) pair. */
+export declare function consumeBlendFallbackReport(key: string, code: string): string | null;
+export declare function resolveVfxBlend(blend: BlendMode, deviceHonoursBlendMode: boolean): VfxBlendResolution;
+//# sourceMappingURL=BlendFallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlendFallback.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/vfx/BlendFallback.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,iFAAiF;IACjF,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,mBAAmB,GAAG,IAAI,CAAC;CACtE;AAID,uDAAuD;AACvD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,oDAAoD;AACpD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKnF;AAqBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,OAAO,GAAG,kBAAkB,CAqCrG"}

package/dist/vfx/BlendFallback.js

@@ -0,0 +1,73 @@
+// PRD-07 P1-T6 — day-0 blend fallback table (PRD-07 §6.2.7).
+// While C-04 BlendMode is stubbed, RenderCommandState.blendMode is ignored and
+// `blend: true` lowers to classic SRC_ALPHA / ONE_MINUS_SRC_ALPHA alpha-over.
+// Every non-alpha blend is emulated there and reported once per batch key.
+const reported = new Set();
+/** Test hook: clear the once-per-key report memory. */
+export function resetBlendFallbackReports() {
+    reported.clear();
+}
+/** Returns the report once per (key, code) pair. */
+export function consumeBlendFallbackReport(key, code) {
+    const id = `${key}:${code}`;
+    if (reported.has(id))
+        return null;
+    reported.add(id);
+    return id;
+}
+const PREMULTIPLIED_STATE = {
+    depthTest: true,
+    depthWrite: false,
+    cullMode: "none",
+    blend: true,
+    depthCompare: "less-equal"
+};
+// C-04 is real on WebGL2 (MultiDraw honours `blendMode`). The particle
+// program writes premultiplied rgb, so honoured modes must name their factors:
+// with no `blendMode` the draw fell back to straight SRC_ALPHA alpha-over and
+// the additive branch (alpha 0) drew nothing.
+const HONOURED_PREMULTIPLIED = { ...PREMULTIPLIED_STATE, blendMode: "premultiplied" };
+const HONOURED_ADDITIVE = {
+    ...PREMULTIPLIED_STATE,
+    blendMode: { kind: "custom", color: { equation: "add", src: "one", dst: "one" }, alpha: { equation: "add", src: "one", dst: "one" } }
+};
+const HONOURED_MULTIPLY = { ...PREMULTIPLIED_STATE, blendMode: "multiply" };
+export function resolveVfxBlend(blend, deviceHonoursBlendMode) {
+    if (typeof blend === "object") {
+        // Custom blends have no alpha-over emulation; skip with an honest report.
+        return { renderState: PREMULTIPLIED_STATE, unpremultiplyOutput: false, additiveFallback: false, skipped: true, degraded: "VFX_BLEND_SKIPPED" };
+    }
+    switch (blend) {
+        case "opaque":
+            return {
+                renderState: { ...PREMULTIPLIED_STATE, blend: false, depthWrite: true },
+                unpremultiplyOutput: false,
+                additiveFallback: false,
+                skipped: false,
+                degraded: null
+            };
+        case "alpha":
+            return deviceHonoursBlendMode
+                ? { renderState: HONOURED_PREMULTIPLIED, unpremultiplyOutput: false, additiveFallback: false, skipped: false, degraded: null }
+                : { renderState: PREMULTIPLIED_STATE, unpremultiplyOutput: true, additiveFallback: false, skipped: false, degraded: null };
+        case "premultiplied":
+            return {
+                renderState: deviceHonoursBlendMode ? HONOURED_PREMULTIPLIED : PREMULTIPLIED_STATE,
+                unpremultiplyOutput: !deviceHonoursBlendMode,
+                additiveFallback: false,
+                skipped: false,
+                degraded: deviceHonoursBlendMode ? null : "VFX_BLEND_FALLBACK"
+            };
+        case "additive":
+            return deviceHonoursBlendMode
+                ? { renderState: HONOURED_ADDITIVE, unpremultiplyOutput: false, additiveFallback: false, skipped: false, degraded: null }
+                : { renderState: PREMULTIPLIED_STATE, unpremultiplyOutput: true, additiveFallback: true, skipped: false, degraded: "VFX_BLEND_FALLBACK" };
+        case "multiply":
+            return deviceHonoursBlendMode
+                ? { renderState: HONOURED_MULTIPLY, unpremultiplyOutput: false, additiveFallback: false, skipped: false, degraded: null }
+                : { renderState: PREMULTIPLIED_STATE, unpremultiplyOutput: false, additiveFallback: false, skipped: true, degraded: "VFX_BLEND_SKIPPED" };
+        default:
+            return { renderState: PREMULTIPLIED_STATE, unpremultiplyOutput: true, additiveFallback: false, skipped: false, degraded: "VFX_BLEND_FALLBACK" };
+    }
+}
+//# sourceMappingURL=BlendFallback.js.map

package/dist/vfx/BlendFallback.js.map

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

package/dist/vfx/DecalBatch.d.ts

@@ -0,0 +1,120 @@
+import type { RibbonGeometry } from "./RibbonBatch.js";
+export type AuraVec3 = readonly [number, number, number];
+export type AuraVec4 = readonly [number, number, number, number];
+export type DecalBlendMode = "alpha" | "multiply";
+/** C-27 decal capacity per tier (§6.9 — was a hard 32). */
+export declare const DECAL_TIER_CAP: {
+    readonly low: 64;
+    readonly medium: 128;
+    readonly high: 256;
+    readonly ultra: 512;
+};
+/** Decal vertex stride in floats: pos3 + normal3 + uv2 + color4 + fade4. */
+export declare const DECAL_VERTEX_FLOATS = 16;
+export interface DecalVertexData {
+    /** Interleaved world-space vertices; `stride` floats per vertex. */
+    readonly vertices: Float32Array;
+    readonly indices: Uint32Array;
+    /**
+     * Vertex stride: 8 (pos3+normal3+uv2 — color/fade stamped from the slot at
+     * merge time) or 16 (full decal layout, fully baked — used by
+     * surface-oriented ribbon trails that carry per-vertex colors). Default 8.
+     */
+    readonly stride?: 8 | 16;
+}
+export interface DecalSlotOptions {
+    /** Stable key (node id / handle id). */
+    readonly id: string;
+    /** Page key — the atlas page or texture identity the decal samples. */
+    readonly pageKey: string;
+    /** Blend group: "alpha" marks or "multiply" grime (§6.9). */
+    readonly blend?: DecalBlendMode;
+    /** Projected world-space vertex data (from ProjectedDecalGeometry or a quad). */
+    readonly geometry: DecalVertexData;
+    readonly color?: AuraVec4;
+    readonly roughness?: number;
+    /** §6.9 fade envelope (degrees + metres). */
+    readonly fade?: {
+        readonly angleStart?: number;
+        readonly angleEnd?: number;
+        readonly near?: number;
+        readonly far?: number;
+    };
+    readonly polygonOffset?: {
+        readonly factor: number;
+        readonly units: number;
+    };
+    /** Life curve (seconds): fadeIn → full → fadeOut → evict at `life`. */
+    readonly life?: number;
+    readonly fadeIn?: number;
+    readonly fadeOut?: number;
+}
+export interface DecalGeometry {
+    readonly vertices: Float32Array;
+    readonly indices: Uint32Array;
+    readonly vertexCount: number;
+    readonly triangleCount: number;
+    readonly pageKey: string;
+    readonly blend: DecalBlendMode;
+    readonly polygonOffset: {
+        readonly factor: number;
+        readonly units: number;
+    } | null;
+}
+interface DecalSlot extends Required<Pick<DecalSlotOptions, "id" | "pageKey" | "geometry">> {
+    blend: DecalBlendMode;
+    color: AuraVec4;
+    roughness: number;
+    fade: {
+        angleStart: number;
+        angleEnd: number;
+        near: number;
+        far: number;
+    };
+    polygonOffset: {
+        factor: number;
+        units: number;
+    } | null;
+    spawnTime: number;
+    life: number;
+    fadeIn: number;
+    fadeOut: number;
+}
+/** α at age `t` for the fade-in/hold/fade-out life curve. */
+export declare function decalLifeAlpha(slot: Pick<DecalSlot, "life" | "fadeIn" | "fadeOut" | "spawnTime">, now: number): number;
+/**
+ * The merged decal ring. `upsert` inserts or replaces; on overflow the
+ * oldest-inserted slot evicts (oldest-first, §6.9). `buildAll` merges each
+ * (pageKey, blend) group into one interleaved buffer for a single draw.
+ */
+export declare class DecalBatch {
+    readonly capacity: number;
+    private readonly slots;
+    private readonly spawns;
+    constructor(capacity: number);
+    get size(): number;
+    /** Live slot ids — lets producers drop slots whose nodes left the scene. */
+    ids(): readonly string[];
+    has(id: string): boolean;
+    /** True when the decal is present after upsert; evicted-oldest semantics. */
+    upsert(options: DecalSlotOptions, now: number): boolean;
+    remove(id: string): void;
+    clear(): void;
+    /** Age out expired decals, then merge each (page, blend) group. */
+    buildAll(now: number): DecalGeometry[];
+}
+/**
+ * Flat-quad decal geometry for the common `decals.project` path: XZ ±0.5
+ * plane (facing +Y) transformed by quaternion `q` + `position`, lifted along
+ * the rotated +Y by `normalOffset`, UV [0,1]².
+ */
+export declare function decalQuadGeometry(q: readonly [number, number, number, number], position: AuraVec3, size: readonly [number, number], normalOffset: number): DecalVertexData;
+/**
+ * §6.9/P6-T3 — convert a built surface-orientation ribbon strip (12-float
+ * layout: pos3+normal3+uv2+color4) into fully baked 16-float decal vertices:
+ * per-vertex color preserved, fade baked to "no fade" (angleEnd<=angleStart,
+ * far=+inf, disabled in the shader). Indices shared verbatim.
+ */
+export declare function ribbonStripToDecalGeometry(geometry: RibbonGeometry): DecalVertexData;
+export {};
+//# sourceMappingURL=DecalBatch.d.ts.map

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

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