reze-engine 0.55.4 → 0.55.7

package/dist/engine.js

@@ -593,6 +593,16 @@ function vertexMorphReach(model) {
 }
 /** Tried in order when a PMX names a texture without an extension. */
 const TEXTURE_EXTENSION_GUESSES = [".png", ".jpg", ".jpeg", ".bmp", ".tga", ".dds", ".spa", ".sph"];
+/** One effect's GPU particle pool. Per effect: each declares its own count. */
+/**
+ * The binding number an effect's params take in each pass.
+ *
+ * 7 in the composite, the particle stages and the ribbon pass, which all stop
+ * below it. The GRID reaches 8 on its own, so it takes the next one up rather
+ * than everything else moving to accommodate one mount.
+ */
+const EFFECT_PARAMS_BINDING = 7;
+const EFFECT_PARAMS_BINDING_GRID = 9;
 /**
  * How one field draw lands on the ones before it: OVER, into a premultiplied
  * target. Shared by both field attachments so they cannot drift apart, which
@@ -2214,6 +2224,9 @@ export class Engine {
                 { binding: 6, resource: { buffer: this.compositeUniformBuffer } },
                 { binding: 7, resource: { buffer: this.midiBuffer } },
                 { binding: 8, resource: { buffer: this.lyricsBuffer } },
+                // The grid is the one pass whose own bindings reach 8, so its params sit
+                // above them rather than everything else shifting for one mount.
+                ...(g.params ? [{ binding: EFFECT_PARAMS_BINDING_GRID, resource: { buffer: g.params } }] : []),
             ],
         });
     }
@@ -2251,7 +2264,7 @@ export class Engine {
             if (e.grid)
                 e.grid.binds = [this.gridBindGroup(e.grid, 0), this.gridBindGroup(e.grid, 1)];
             if (e.lights)
-                e.lights.bind = this.lightEmitBindGroup(e.lights.layout, e.lights.uniform);
+                e.lights.bind = this.lightEmitBindGroup(e.lights.layout, e.lights.uniform, e.lights.params);
         }
     }
     /**
@@ -2545,9 +2558,18 @@ export class Engine {
                 paramsData[slot.offset + 2] = value.z;
             }
         }
-        const paramsDecl = entries.length
-            ? `struct EffectParams {\n${fields.join("\n")}\n}\n@group(0) @binding(7) var<uniform> params: EffectParams;\n`
+        /**
+         * The params block, at whatever binding the pass asking has free.
+         *
+         * A single hardcoded slot cannot serve every mount — the grid's layout
+         * already reaches binding 8 — so the struct is generated per pass and each
+         * one states the number it can spare. Empty when nothing is declared: WGSL
+         * has no empty struct, and a binding nothing reads is a layout mismatch.
+         */
+        const paramsWgsl = (binding) => entries.length
+            ? `struct EffectParams {\n${fields.join("\n")}\n}\n@group(0) @binding(${binding}) var<uniform> params: EffectParams;\n`
             : "";
+        const paramsDecl = paramsWgsl(EFFECT_PARAMS_BINDING);
         // ── Compile with validation captured, not thrown at the console. Line
         // numbers in diagnostics are rebased to the USER's source.
         // The composite is STATIC: user field code compiles in its own half-res
@@ -2654,7 +2676,31 @@ export class Engine {
         let particles = null;
         let grid = null;
         let trails = null;
+        // PARAMS ARE NOT A FIELD-MOUNT FEATURE, and used to be one by accident.
+        //
+        // `paramsDecl` was spliced into the composite alone, so `#param` worked for
+        // background/foreground and produced "unresolved value 'params'" for every
+        // particle, grid and ribbon effect — which is most of the ones anyone wants
+        // a dial on. Rain's fall speed is the whole example.
+        //
+        // The buffer is created HERE rather than beside the instance it ends up on,
+        // because the mount builders below need to bind it and they run first. That
+        // makes `abandon` its owner: a mount that fails to compile must not leak it.
+        let paramsBuffer = null;
+        if (entries.length) {
+            paramsBuffer = this.device.createBuffer({
+                label: "effect params",
+                size: paramsData.byteLength,
+                usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            });
+            this.device.queue.writeBuffer(paramsBuffer, 0, paramsData);
+        }
+        /** What every mount splices and binds: a generator for the struct decl at
+         *  the binding that mount has free, and the buffer behind it. The buffer is
+         *  null when nothing is declared, and then no binding is added at all. */
+        const paramsFor = { wgsl: paramsWgsl, buffer: paramsBuffer };
         const abandon = (diagnostics) => {
+            paramsBuffer?.destroy();
             particles?.buffer.destroy();
             particles?.uniform.destroy();
             grid?.textures[0].destroy();
@@ -2664,13 +2710,13 @@ export class Engine {
             return { ok: false, diagnostics, mounts, params: d.params, duration: d.duration };
         };
         if (wantsParticles) {
-            const built = await this.buildParticles(wgsl, d, anchors, alias);
+            const built = await this.buildParticles(wgsl, d, anchors, alias, paramsFor);
             if (!built.ok)
                 return abandon(built.diagnostics);
             particles = built.state;
         }
         if (gridEntryPoint(wgsl)) {
-            const built = await this.buildSim(wgsl, d, anchors, alias);
+            const built = await this.buildSim(wgsl, d, anchors, alias, paramsFor);
             if (!built.ok)
                 return abandon(built.diagnostics);
             grid = built.state;
@@ -2680,9 +2726,9 @@ export class Engine {
             // bone recorded without one would read zeroes and paint a line to the origin.
             const trailSlots = anchors.filter((a) => a.trail).length;
             if (trailSlots === 0) {
-                return { ok: false, diagnostics: ["a ribbon effect needs at least one #anchor <bone> trail"], mounts, params: d.params, duration: d.duration };
+                return abandon(["a ribbon effect needs at least one #anchor <bone> trail"]);
             }
-            const built = await this.buildTrails(wgsl, d, anchors, alias);
+            const built = await this.buildTrails(wgsl, d, anchors, alias, paramsFor);
             if (!built.ok)
                 return abandon(built.diagnostics);
             trails = built.state;
@@ -2705,7 +2751,7 @@ export class Engine {
             ]);
         }
         if (declaredLights > 0) {
-            const built = await this.buildLightEmit(wgsl, declaredLights, alias, anchors);
+            const built = await this.buildLightEmit(wgsl, declaredLights, alias, anchors, paramsFor);
             if (!built.ok)
                 return abandon(built.diagnostics);
             lights = built.state;
@@ -2718,15 +2764,6 @@ export class Engine {
                 usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
             })
             : null;
-        let paramsBuffer = null;
-        if (entries.length) {
-            paramsBuffer = this.device.createBuffer({
-                label: "effect params",
-                size: paramsData.byteLength,
-                usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
-            });
-            this.device.queue.writeBuffer(paramsBuffer, 0, paramsData);
-        }
         const instance = {
             wgsl,
             paramDecls: d.params,
@@ -2955,11 +2992,14 @@ export class Engine {
     /** This effect's local→scene slot map. Passed rather than read off the
      *  engine: the builders run BEFORE the swap, so this.anchorTable still
      *  describes the effect that is still on screen. */
-    alias) {
+    alias, 
+    /** The effect's declared dials. Spliced into both stages and bound at 7,
+     *  the same binding the composite gives them. */
+    params) {
         // No pragma means "some": an author who wrote the trio clearly wants
         // particles, and failing over a missing comment would be pedantry.
         const count = Math.min(d.particles || 1024, Engine.MAX_PARTICLES);
-        const src = { wgsl, count, blend: d.particleBlend, bloom: d.bloom };
+        const src = { wgsl, count, blend: d.particleBlend, bloom: d.bloom, paramsDecl: params.wgsl(EFFECT_PARAMS_BINDING) };
         // Sparks want to spawn where a trail is, so the particle stages see the same
         // cast buffer the trail draw reads.
         const cast = {
@@ -3022,6 +3062,9 @@ export class Engine {
                 // rule and a background read the same instant.
                 { binding: 5, visibility, buffer: { type: "read-only-storage" } },
                 { binding: 6, visibility, buffer: { type: "read-only-storage" } },
+                // Only when the effect declared any: WGSL has no empty struct, so a
+                // param-less effect must not carry the decl OR the binding.
+                ...(params.buffer ? [{ binding: 7, visibility, buffer: { type: "uniform" } }] : []),
             ],
         });
         const bindFor = (layout, camera) => this.device.createBindGroup({
@@ -3034,6 +3077,7 @@ export class Engine {
                 { binding: 4, resource: { buffer: this.audioBuffer } },
                 { binding: 5, resource: { buffer: this.midiBuffer } },
                 { binding: 6, resource: { buffer: this.lyricsBuffer } },
+                ...(params.buffer ? [{ binding: 7, resource: { buffer: params.buffer } }] : []),
             ],
         });
         const computeLayout = layoutFor("storage", GPUShaderStage.COMPUTE);
@@ -3115,7 +3159,7 @@ export class Engine {
      * writable view here means a material pipeline cannot accidentally acquire
      * one.
      */
-    async buildLightEmit(wgsl, count, alias, anchors) {
+    async buildLightEmit(wgsl, count, alias, anchors, params) {
         const layout = this.device.createBindGroupLayout({
             label: "light emit layout",
             entries: [
@@ -3126,13 +3170,16 @@ export class Engine {
                 { binding: 4, visibility: GPUShaderStage.COMPUTE, buffer: { type: "read-only-storage" } },
                 { binding: 5, visibility: GPUShaderStage.COMPUTE, buffer: { type: "read-only-storage" } },
                 { binding: 6, visibility: GPUShaderStage.COMPUTE, buffer: { type: "read-only-storage" } },
+                ...(params.buffer
+                    ? [{ binding: EFFECT_PARAMS_BINDING, visibility: GPUShaderStage.COMPUTE, buffer: { type: "uniform" } }]
+                    : []),
             ],
         });
         const module = this.device.createShaderModule({
             label: "light emit",
             // The same scene API and the same per-effect anchor alias its drawing
             // half gets, so a lamp reads the cast exactly as the beam that paints it.
-            code: buildLightEmitShader(wgsl, EFFECT_SCENE_API + anchorAliasWgsl(alias), { trailCount: anchors.filter((a) => a.trail).length }),
+            code: buildLightEmitShader(wgsl, EFFECT_SCENE_API + anchorAliasWgsl(alias), { trailCount: anchors.filter((a) => a.trail).length }, params.wgsl(EFFECT_PARAMS_BINDING)),
         });
         const info = await module.getCompilationInfo();
         const diagnostics = info.messages.filter((m) => m.type === "error").map((m) => `${m.lineNum}:${m.linePos} ${m.message}`);
@@ -3155,14 +3202,14 @@ export class Engine {
             uniform.destroy();
             return { ok: false, diagnostics: [scoped.message] };
         }
-        const bind = this.lightEmitBindGroup(layout, uniform);
+        const bind = this.lightEmitBindGroup(layout, uniform, params.buffer);
         // The layout travels with the state so the emitter can be rebound when a
         // shared buffer under it is replaced — see rebindSharedBuffers.
-        return { ok: true, state: { pipeline, bind, layout, uniform, data, count } };
+        return { ok: true, state: { pipeline, bind, layout, uniform, data, count, params: params.buffer } };
     }
     /** The light emitter's bind group. One author, for the reason gridBindGroup
      *  gives: it is built once and rebuilt on every shared-buffer swap. */
-    lightEmitBindGroup(layout, uniform) {
+    lightEmitBindGroup(layout, uniform, params) {
         return this.device.createBindGroup({
             label: "light emit bind",
             layout,
@@ -3174,6 +3221,7 @@ export class Engine {
                 { binding: 4, resource: { buffer: this.audioBuffer } },
                 { binding: 5, resource: { buffer: this.midiBuffer } },
                 { binding: 6, resource: { buffer: this.lyricsBuffer } },
+                ...(params ? [{ binding: EFFECT_PARAMS_BINDING, resource: { buffer: params } }] : []),
             ],
         });
     }
@@ -3281,7 +3329,9 @@ export class Engine {
     /** This effect's local→scene slot map. Passed rather than read off the
      *  engine: the builders run BEFORE the swap, so this.anchorTable still
      *  describes the effect that is still on screen. */
-    alias) {
+    alias, 
+    /** The effect's declared dials, spliced and bound at 7 as everywhere else. */
+    params) {
         // `slots` here is how many RIBBONS to draw — one per trailed anchor — which
         // is a different number from the anchor ADDRESS SPACE the accessors index
         // by. Conflating the two is what made a trail declared after a bare anchor
@@ -3291,7 +3341,7 @@ export class Engine {
         // nothing before: ribbon i was read as anchor slot i.
         const ribbonSlots = anchors.map((a, i) => (a.trail ? i : -1)).filter((i) => i >= 0);
         const slots = ribbonSlots.length;
-        const src = { wgsl, slots, ribbonSlots, blend: d.particleBlend, bloom: d.bloom };
+        const src = { wgsl, slots, ribbonSlots, blend: d.particleBlend, bloom: d.bloom, paramsDecl: params.wgsl(EFFECT_PARAMS_BINDING) };
         const code = buildTrailShader(src, {
             subjects: MAX_EFFECT_SUBJECTS,
             samples: TRAIL_SAMPLES,
@@ -3336,6 +3386,9 @@ export class Engine {
                 { binding: 5, visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT, buffer: { type: "read-only-storage" } },
                 // The lyrics, for rzLyric*.
                 { binding: 6, visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT, buffer: { type: "read-only-storage" } },
+                ...(params.buffer
+                    ? [{ binding: 7, visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT, buffer: { type: "uniform" } }]
+                    : []),
             ],
         });
         // TWO targets, the scene pass's own: HDR colour and the aux (bloom mask,
@@ -3388,6 +3441,7 @@ export class Engine {
                             { binding: 4, resource: { buffer: this.audioBuffer } },
                             { binding: 5, resource: { buffer: this.midiBuffer } },
                             { binding: 6, resource: { buffer: this.lyricsBuffer } },
+                            ...(params.buffer ? [{ binding: 7, resource: { buffer: params.buffer } }] : []),
                         ],
                     }),
                     mirrorBind: this.device.createBindGroup({
@@ -3399,6 +3453,7 @@ export class Engine {
                             { binding: 4, resource: { buffer: this.audioBuffer } },
                             { binding: 5, resource: { buffer: this.midiBuffer } },
                             { binding: 6, resource: { buffer: this.lyricsBuffer } },
+                            ...(params.buffer ? [{ binding: 7, resource: { buffer: params.buffer } }] : []),
                         ],
                     }),
                 },
@@ -3595,7 +3650,9 @@ export class Engine {
     /** This effect's local→scene slot map. Passed rather than read off the
      *  engine: the builders run BEFORE the swap, so this.anchorTable still
      *  describes the effect that is still on screen. */
-    alias) {
+    alias, 
+    /** The effect's declared dials, spliced and bound above the grid's own. */
+    params) {
         const size = Math.min(d.grid || 256, GRID_MAX);
         const cast = {
             subjects: MAX_EFFECT_SUBJECTS,
@@ -3606,7 +3663,7 @@ export class Engine {
             trailCount: anchors.filter((x) => x.trail).length,
             alias,
         };
-        const code = buildSimShader(wgsl, size, cast);
+        const code = buildSimShader(wgsl, size, cast, params.wgsl(EFFECT_PARAMS_BINDING_GRID));
         const offset = code.slice(0, code.indexOf(wgsl)).split("\n").length - 1;
         this.device.pushErrorScope("validation");
         const module = this.device.createShaderModule({ label: "grid step", code });
@@ -3635,6 +3692,9 @@ export class Engine {
                 { binding: 6, visibility: GPUShaderStage.COMPUTE, buffer: { type: "uniform" } },
                 { binding: 7, visibility: GPUShaderStage.COMPUTE, buffer: { type: "read-only-storage" } },
                 { binding: 8, visibility: GPUShaderStage.COMPUTE, buffer: { type: "read-only-storage" } },
+                ...(params.buffer
+                    ? [{ binding: EFFECT_PARAMS_BINDING_GRID, visibility: GPUShaderStage.COMPUTE, buffer: { type: "uniform" } }]
+                    : []),
             ],
         });
         const make = (n) => this.device.createTexture({
@@ -3665,7 +3725,7 @@ export class Engine {
                 return { ok: false, diagnostics: [scoped.message] };
             }
             // One per parity: binds[i] READS textures[i] and WRITES the other.
-            const bindFor = (i) => this.gridBindGroup({ layout, uniform, read, textures }, i);
+            const bindFor = (i) => this.gridBindGroup({ layout, uniform, read, textures, params: params.buffer }, i);
             return {
                 ok: true,
                 state: {
@@ -3679,6 +3739,7 @@ export class Engine {
                     data: new Float32Array(4),
                     parity: 0,
                     frame: 0,
+                    params: params.buffer,
                 },
             };
         }
@@ -6339,17 +6400,23 @@ export class Engine {
         this.camera.attachControl(this.canvas);
     }
     setCameraTarget(modelOrVec, boneName, offset) {
+        // panLocked tracks the BINDING, on every path that changes it — a target
+        // set to a fixed point is pannable again, and forgetting it here is how the
+        // pan stays dead after the follow was turned off. See Camera.panLocked.
         if (modelOrVec === null) {
+            this.camera.panLocked = false;
             this.cameraTargetModel = null;
             return;
         }
         if ("x" in modelOrVec && "y" in modelOrVec && "z" in modelOrVec) {
+            this.camera.panLocked = false;
             this.cameraTargetModel = null;
             this.camera.target.x = modelOrVec.x;
             this.camera.target.y = modelOrVec.y;
             this.camera.target.z = modelOrVec.z;
             return;
         }
+        this.camera.panLocked = true;
         this.cameraTargetModel = modelOrVec;
         this.cameraTargetBoneName = boneName ?? "";
         this.cameraTargetOffset.x = offset?.x ?? 0;
@@ -6358,6 +6425,9 @@ export class Engine {
     }
     /** Souls-style follow cam: orbit center tracks a model bone each frame. Shorthand for setCameraTarget(model, boneName, offset). */
     setCameraFollow(model, boneName, offset, smoothing) {
+        // Panning sets the very thing the follow overwrites each frame, so it is
+        // refused for as long as the shot is riding a bone. See Camera.panLocked.
+        this.camera.panLocked = model !== null;
         if (model === null) {
             this.cameraTargetModel = null;
             return;
@@ -7958,6 +8028,52 @@ export class Engine {
         else
             inst.hiddenMaterials.add(materialName);
     }
+    /**
+     * Push a colour/shading edit straight into a material's own uniform buffer —
+     * the same block createMaterialUniformBuffer wrote at load, offset for
+     * offset. A single write per call, on the fields that actually moved, so
+     * dragging one slider does not touch the other eleven.
+     *
+     * UNGROUPED materials only. A grouped material renders through its style
+     * group's own compiled graph (setupPipelines' neutral/DEFAULT_GRAPH path is
+     * what reads this buffer, and a grouped material never runs it) — the call
+     * still writes the bytes, they are simply never sampled, which would look
+     * like the edit silently failing. Callers check groupsByModel first and this
+     * quietly no-ops rather than assume that check was made, since a document
+     * edit landing to the WRONG channel (the group's own colour input) would be
+     * a worse failure than one that does nothing.
+     *
+     * Structural fields — anything that changes which draw bucket a material is
+     * in, or which texture it binds — are NOT here: alpha crossing the 1.0
+     * opaque/transparent line, edge on/off, a texture swap, all need the draw
+     * list or the bind group rebuilt, not a uniform write. Those get their own
+     * call when something needs them.
+     */
+    setMaterialUniforms(modelName, materialName, patch) {
+        const inst = this.modelInstances.get(modelName);
+        if (!inst)
+            return false;
+        const materials = inst.model.getMaterials();
+        const index = materials.findIndex((m) => m.name === materialName);
+        if (index < 0)
+            return false;
+        const buffer = inst.materialUniformBuffers[index];
+        if (!buffer)
+            return false;
+        if (patch.diffuse) {
+            this.device.queue.writeBuffer(buffer, 0, new Float32Array(patch.diffuse));
+        }
+        if (patch.ambient) {
+            this.device.queue.writeBuffer(buffer, 16, new Float32Array(patch.ambient));
+        }
+        if (patch.specularPower !== undefined) {
+            this.device.queue.writeBuffer(buffer, 28, new Float32Array([patch.specularPower]));
+        }
+        if (patch.specular) {
+            this.device.queue.writeBuffer(buffer, 32, new Float32Array(patch.specular));
+        }
+        return true;
+    }
     isMaterialVisible(modelName, materialName) {
         const inst = this.modelInstances.get(modelName);
         return inst ? !inst.hiddenMaterials.has(materialName) : false;

package/dist/index.d.ts

@@ -36,4 +36,17 @@ export { RezePhysics } from "./physics";
 export type { WindOptions } from "./physics/world";
 export { RigidbodyShape, RigidbodyType, type Rigidbody, type Joint } from "./physics/types";
 export { boneOverlay, boneMarkerPositions, rigidbodyOverlay, jointOverlay, buildOverlayShapes, lineBetween, writeOverlayInstance, OVERLAY_SHAPES, OVERLAY_INSTANCE_FLOATS, OVERLAY_VERTEX_FLOATS, DEFAULT_BONE_PALETTE, DEFAULT_RIGIDBODY_PALETTE, DEFAULT_JOINT_PALETTE, DEFAULT_VERTEX_COLOR, OVERLAY_STYLE, type OverlayPrimitive, type OverlayShape, type OverlayGeometry, type BoneOverlayOptions, type BoneClass, type RigidbodyOverlayOptions, type RigidbodyClass, type JointOverlayOptions, type RGBA, type Vec3Tuple, } from "./overlay";
+/**
+ * The WGSL an effect's own source is compiled against — the hashes, the noise,
+ * the falloff, and the Particle struct the particle trio is written in terms of.
+ *
+ * Exported because reze-design renders LIBRARY PREVIEWS by hosting an effect's
+ * source itself, and a preview that reimplements this drifts from the renderer
+ * it is previewing. `rzHash13` meaning one thing on a card and another in the
+ * scene is worse than no card at all — and a preview missing them entirely just
+ * fails to compile, which is a blank card with nothing said anywhere.
+ *
+ * Pure strings, no GPU: importing them costs a host nothing.
+ */
+export { EFFECT_MATH_API, PARTICLE_STRUCT_WGSL } from "./shaders/passes/hosted-api";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -50,3 +50,16 @@ export { RigidbodyShape, RigidbodyType } from "./physics/types";
 // engine methods that call them, so a host can produce the same list itself —
 // to show it as data, diff two poses, or hit-test it on the CPU.
 export { boneOverlay, boneMarkerPositions, rigidbodyOverlay, jointOverlay, buildOverlayShapes, lineBetween, writeOverlayInstance, OVERLAY_SHAPES, OVERLAY_INSTANCE_FLOATS, OVERLAY_VERTEX_FLOATS, DEFAULT_BONE_PALETTE, DEFAULT_RIGIDBODY_PALETTE, DEFAULT_JOINT_PALETTE, DEFAULT_VERTEX_COLOR, OVERLAY_STYLE, } from "./overlay";
+/**
+ * The WGSL an effect's own source is compiled against — the hashes, the noise,
+ * the falloff, and the Particle struct the particle trio is written in terms of.
+ *
+ * Exported because reze-design renders LIBRARY PREVIEWS by hosting an effect's
+ * source itself, and a preview that reimplements this drifts from the renderer
+ * it is previewing. `rzHash13` meaning one thing on a card and another in the
+ * scene is worse than no card at all — and a preview missing them entirely just
+ * fails to compile, which is a blank card with nothing said anywhere.
+ *
+ * Pure strings, no GPU: importing them costs a host nothing.
+ */
+export { EFFECT_MATH_API, PARTICLE_STRUCT_WGSL } from "./shaders/passes/hosted-api";

package/dist/shaders/lights.d.ts

@@ -63,7 +63,7 @@ export declare function hasLightEmit(wgsl: string): boolean;
  */
 export declare function buildLightEmitShader(wgsl: string, sceneApi: string, cast: {
     trailCount: number;
-}): string;
+}, paramsDecl?: string): string;
 /** The rz*Light accessors, with the buffer declared at the given binding. */
 export declare function lightsApi(group: number, binding: number): string;
 //# sourceMappingURL=lights.d.ts.map

package/dist/shaders/lights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lights.d.ts","sourceRoot":"","sources":["../../src/shaders/lights.ts"],"names":[],"mappings":"AAmCA;yEACyE;AACzE,eAAO,MAAM,YAAY,IAAI,CAAA;AAC7B,+CAA+C;AAC/C,eAAO,MAAM,YAAY,IAAI,CAAA;AAC7B;;;;;GAKG;AACH,eAAO,MAAM,UAAU,KAAK,CAAA;AAC5B,kCAAkC;AAClC,eAAO,MAAM,aAAa,QAA2C,CAAA;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,qJAQhC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,idAa9B,CAAA;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAC3B,MAAM,CAgFR;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkEhE"}
+{"version":3,"file":"lights.d.ts","sourceRoot":"","sources":["../../src/shaders/lights.ts"],"names":[],"mappings":"AAmCA;yEACyE;AACzE,eAAO,MAAM,YAAY,IAAI,CAAA;AAC7B,+CAA+C;AAC/C,eAAO,MAAM,YAAY,IAAI,CAAA;AAC7B;;;;;GAKG;AACH,eAAO,MAAM,UAAU,KAAK,CAAA;AAC5B,kCAAkC;AAClC,eAAO,MAAM,aAAa,QAA2C,CAAA;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,qJAQhC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,idAa9B,CAAA;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EAC5B,UAAU,SAAK,GACd,MAAM,CAoFR;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkEhE"}

package/dist/shaders/lights.js

@@ -117,7 +117,7 @@ export function hasLightEmit(wgsl) {
  * did not know where she was could only sit where the fixture hangs. It also
  * brings RzLight, which is why this builder does not declare it again.
  */
-export function buildLightEmitShader(wgsl, sceneApi, cast) {
+export function buildLightEmitShader(wgsl, sceneApi, cast, paramsDecl = "") {
     return /* wgsl */ `
 // read_write HERE and read-only in the material shaders. Different passes, so
 // the two never coexist: this compute runs before the scene pass that reads it.
@@ -154,6 +154,10 @@ ${trailSlotsApi(cast.trailCount)}
 // The id accessors, stubbed: this module cannot read an attachment the
 // scene pass writes. See id-api.ts — the author's whole file compiles here.
 ${idApi(false, 0, 0) + castDistanceStub()}
+// The dials the author declared, if any. A lamp is exactly the thing someone
+// retunes — its colour and its reach — so an emitter reads params like every
+// other mount rather than being the one place a #param resolves to nothing.
+${paramsDecl}
 ${wgsl}
 
 @compute @workgroup_size(64)

package/dist/shaders/passes/grid.d.ts

@@ -25,5 +25,5 @@ export declare function gridReadApi(group: number, tex: number, samp: number, si
  * from", and that place is almost never a texel centre. Point-sampling it is
  * what turns smoke into a staircase.
  */
-export declare function buildSimShader(wgsl: string, size: number, cast: CastLayout): string;
+export declare function buildSimShader(wgsl: string, size: number, cast: CastLayout, paramsDecl?: string): string;
 //# sourceMappingURL=grid.d.ts.map

package/dist/shaders/passes/grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/shaders/passes/grid.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAkC7C,eAAO,MAAM,QAAQ,OAAO,CAAA;AAC5B,uEAAuE;AACvE,eAAO,MAAM,UAAU,EAAE,gBAAgC,CAAA;AAEzD,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA6B1F;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CA8EnF"}
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/shaders/passes/grid.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAkC7C,eAAO,MAAM,QAAQ,OAAO,CAAA;AAC5B,uEAAuE;AACvE,eAAO,MAAM,UAAU,EAAE,gBAAgC,CAAA;AAEzD,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA6B1F;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,SAAK,GAAG,MAAM,CAiFpG"}

package/dist/shaders/passes/grid.js

@@ -100,8 +100,11 @@ struct SimU {
  * from", and that place is almost never a texel centre. Point-sampling it is
  * what turns smoke into a staircase.
  */
-export function buildSimShader(wgsl, size, cast) {
+export function buildSimShader(wgsl, size, cast, paramsDecl = "") {
     return (SIM_UNIFORMS +
+        // The effect's declared dials, ahead of everything that reads them. Empty
+        // when it declared none.
+        paramsDecl +
         /* wgsl */ `
 @group(0) @binding(0) var<uniform> su: SimU;
 @group(0) @binding(1) var _rzGridPrevTex: texture_2d<f32>;

package/dist/shaders/passes/particles.d.ts

@@ -23,6 +23,10 @@ type ParticleSource = {
     blend: ParticleBlend;
     /** Feed the bloom pyramid. Off by default — rain should not glow. */
     bloom: boolean;
+    /** The effect's `#param` block, or empty. Spliced into BOTH stages: a spawn
+     *  rule reads the same dial the shading does, and rain's fall speed is used
+     *  in the compute half. */
+    paramsDecl: string;
 };
 /** Bytes per particle. Explicitly padded — see the struct below. */
 export declare const PARTICLE_STRIDE = 48;

package/dist/shaders/passes/particles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"particles.d.ts","sourceRoot":"","sources":["../../../src/shaders/passes/particles.ts"],"names":[],"mappings":"AA2BA,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;IACb;;mFAE+E;IAC/E,UAAU,EAAE,MAAM,CAAA;IAClB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAiCD,qDAAqD;AACrD,KAAK,aAAa,GAAG,OAAO,GAAG,UAAU,CAAA;AAEzC,KAAK,cAAc,GAAG;IACpB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,aAAa,CAAA;IACpB,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,eAAe,KAAK,CAAA;AAuDjC,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAMlG;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CA6CxF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CA4HvF"}
+{"version":3,"file":"particles.d.ts","sourceRoot":"","sources":["../../../src/shaders/passes/particles.ts"],"names":[],"mappings":"AA2BA,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;IACb;;mFAE+E;IAC/E,UAAU,EAAE,MAAM,CAAA;IAClB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAiCD,qDAAqD;AACrD,KAAK,aAAa,GAAG,OAAO,GAAG,UAAU,CAAA;AAEzC,KAAK,cAAc,GAAG;IACpB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,aAAa,CAAA;IACpB,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAA;IACd;;+BAE2B;IAC3B,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,eAAe,KAAK,CAAA;AAuDjC,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAMlG;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CA8CxF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CA6HvF"}

package/dist/shaders/passes/particles.js

@@ -110,6 +110,7 @@ export function buildParticleComputeShader(src, cast) {
         CAMERA_STRUCT +
         PARTICLE_UNIFORMS +
         `
+${src.paramsDecl}
 @group(0) @binding(0) var<storage, read_write> particles: array<Particle>;
 @group(0) @binding(1) var<uniform> pu: ParticleU;
 @group(0) @binding(2) var<uniform> cam: CameraU;
@@ -169,6 +170,7 @@ override ADDITIVE: bool = ${src.blend === "additive" ? "true" : "false"};\n` +
         CAMERA_STRUCT +
         PARTICLE_UNIFORMS +
         `
+${src.paramsDecl}
 @group(0) @binding(0) var<storage, read> particles: array<Particle>;
 @group(0) @binding(1) var<uniform> pu: ParticleU;
 @group(0) @binding(2) var<uniform> cam: CameraU;

package/dist/shaders/passes/trails.d.ts

@@ -6,6 +6,8 @@ type TrailSource = {
     /** For each ribbon, the LOCAL anchor slot it belongs to. Identity when every
      *  anchor is trailed; otherwise it skips the untrailed ones. */
     ribbonSlots: number[];
+    /** The effect's `#param` block, or empty. */
+    paramsDecl: string;
     /** Additive, like most glowing ribbons, or straight alpha. */
     blend: "alpha" | "additive";
     bloom: boolean;

package/dist/shaders/passes/trails.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trails.d.ts","sourceRoot":"","sources":["../../../src/shaders/passes/trails.ts"],"names":[],"mappings":"AA2BA,KAAK,WAAW,GAAG;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb;oEACgE;IAChE,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,8DAA8D;IAC9D,KAAK,EAAE,OAAO,GAAG,UAAU,CAAA;IAC3B,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAKjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,EAAE,CAAA;IACf;;;;kFAI8E;IAC9E,SAAS,EAAE,OAAO,CAAA;CACnB,GACA,MAAM,CAgVR"}
+{"version":3,"file":"trails.d.ts","sourceRoot":"","sources":["../../../src/shaders/passes/trails.ts"],"names":[],"mappings":"AA2BA,KAAK,WAAW,GAAG;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb;oEACgE;IAChE,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,KAAK,EAAE,OAAO,GAAG,UAAU,CAAA;IAC3B,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAKjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,EAAE,CAAA;IACf;;;;kFAI8E;IAC9E,SAAS,EAAE,OAAO,CAAA;CACnB,GACA,MAAM,CAiVR"}

package/dist/shaders/passes/trails.js

@@ -89,6 +89,7 @@ struct TrailU {
   weight: f32,
   _pad2: f32,
 }
+${src.paramsDecl}
 @group(0) @binding(0) var<storage, read> _rzCast: array<vec4f>;
 @group(0) @binding(1) var<uniform> tu: TrailU;
 @group(0) @binding(2) var<uniform> cam: CameraU;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reze-engine",
-  "version": "0.55.4",
+  "version": "0.55.7",
   "description": "A lightweight WebGPU engine for real-time 3D MMD/PMX model rendering",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/camera.ts

@@ -44,6 +44,16 @@ export class Camera {
   // Input state
   private canvas: HTMLCanvasElement | null = null
   private inputLocked: boolean = false
+  /**
+   * Panning is refused while the orbit rides a bone (Engine.setCameraFollow).
+   *
+   * A pan moves `target`, and the follow rewrites `target` from the bone every
+   * frame — so the drag was already going nowhere, it just spent a frame
+   * fighting for it and read as the camera stuttering under the pointer.
+   * Refusing it says the same thing the follow already means: while the shot is
+   * on somebody, where it points is theirs to decide.
+   */
+  panLocked: boolean = false
   private isDragging: boolean = false
   private mouseButton: number | null = null // Track which mouse button is pressed (0 = left, 2 = right)
   private lastMousePos = { x: 0, y: 0 }
@@ -430,7 +440,7 @@ export class Camera {
 
     if (this.mouseButton === 2) {
       // Right-click: pan the camera target
-      this.panCamera(deltaX, deltaY)
+      if (!this.panLocked) this.panCamera(deltaX, deltaY)
     } else {
       // Left-click (or default): rotate the camera
       this.alpha += deltaX * this.angularSensitivity
@@ -549,7 +559,7 @@ export class Camera {
       if (isPanGesture) {
         // Primary gesture is pan (two-finger drag)
         // Use panning similar to right-click pan
-        this.panCamera(midpointDeltaX, midpointDeltaY)
+        if (!this.panLocked) this.panCamera(midpointDeltaX, midpointDeltaY)
       }
 
       // Update tracking values