reze-engine 0.65.0 → 0.66.1

package/dist/model.js

@@ -124,7 +124,7 @@ export class Model {
         this.assetReader = reader;
         this.assetBasePath = basePath;
     }
-    constructor(vertexData, indexData, textures, materials, skeleton, skinning, morphing, rigidbodies = [], joints = [], loadWarnings = [], edgeScales = null) {
+    constructor(vertexData, indexData, textures, materials, skeleton, skinning, morphing, rigidbodies = [], joints = [], loadWarnings = [], edgeScales = null, additionalUvs = []) {
         this._name = "";
         this.morphPrevMinVert = -1; // vertices touched by last applyMorphs (reset to base this pass)
         this.morphPrevMaxVert = -1;
@@ -271,6 +271,7 @@ export class Model {
         // Cached set to track which bones are being computed in current IK pass (to avoid infinite recursion)
         this.ikComputedSet = new Set();
         this.edgeScales = edgeScales;
+        this.additionalUvs = additionalUvs;
         // Store base vertex data (original positions before morphing)
         this.baseVertexData = new Float32Array(vertexData);
         this.vertexData = vertexData;
@@ -676,6 +677,12 @@ export class Model {
     getVertices() {
         return this.vertexData;
     }
+    /** A PMX additional UV channel (1–4) as loaded, four floats a vertex — or
+     *  null when the file has fewer. Its morphs (types 4–7) are in getMorphing(),
+     *  with uvOffsets; the engine applies neither, a native look reads both. */
+    getAdditionalUv(channel) {
+        return this.additionalUvs[channel - 1] ?? null;
+    }
     /**
      * The outline hull's own vertex stream: per vertex, the smoothed rest-pose
      * normal (xyz) and the PMX edge scale (w). See outline-normals.ts. Built on
@@ -785,6 +792,25 @@ export class Model {
             return null;
         return this.runtimeSkeleton.worldMatrices[idx].getPosition();
     }
+    /**
+     * The point `distance` model units down a bone's own axis, posed — where
+     * `#anchor <bone> along <d>` puts an effect. The axis is the bone's rest tail
+     * direction (the way a PMX editor draws it pointing) turned by the bone's
+     * pose, the same mapping the named-points tips use. Model space, like
+     * getBoneWorldPosition. A bone with no tail has no axis: the joint itself.
+     */
+    getBonePointAlong(boneName, distance) {
+        const idx = this.runtimeSkeleton.nameIndex[boneName];
+        if (idx === undefined || idx < 0)
+            return null;
+        const w = this.runtimeSkeleton.worldMatrices[idx].values;
+        const t = this.skeleton.bones[idx]?.tail;
+        const len = t ? Math.hypot(t[0], t[1], t[2]) : 0;
+        if (!t || len < 1e-6)
+            return new Vec3(w[12], w[13], w[14]);
+        const k = distance / len;
+        return new Vec3(w[12] + (w[0] * t[0] + w[4] * t[1] + w[8] * t[2]) * k, w[13] + (w[1] * t[0] + w[5] * t[1] + w[9] * t[2]) * k, w[14] + (w[2] * t[0] + w[6] * t[1] + w[10] * t[2]) * k);
+    }
     /**
      * A bone's forward axis, normalised — which way a foot points, where a head
      * looks. Model space, like getBoneWorldPosition: the caller composes the model

package/dist/pmx-loader.d.ts

@@ -18,6 +18,10 @@ export declare class PmxLoader {
     private inverseBindMatrices;
     private joints0;
     private weights0;
+    /** The PMX's additional UV channels (1–4), each four floats a vertex. The
+     *  engine's own shading reads none of them; a native look can name one as
+     *  the carrier of a game vertex stream (NativeLook.streams). */
+    private additionalUvs;
     /** PMX per-vertex edge scale — the outline's width multiplier, as the
      *  game's outline takes vertex colour alpha. */
     private edgeScales;

package/dist/pmx-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pmx-loader.d.ts","sourceRoot":"","sources":["../src/pmx-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAcN,MAAM,SAAS,CAAA;AAGhB,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEzE,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,mBAAmB,CAAI;IAC/B,OAAO,CAAC,eAAe,CAAI;IAC3B,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,kBAAkB,CAAI;IAC9B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAA0B;IAC1C;oDACgD;IAChD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAY;IAC/B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAe;IAE/B,OAAO;IAQP,OAAO,CAAC,IAAI;WAMC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAI9C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK;WAIpC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAKxF,OAAO,CAAC,KAAK;IAiBb,OAAO,CAAC,WAAW;IAwDnB,OAAO,CAAC,aAAa;IA4GrB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,cAAc;IAsEtB,OAAO,CAAC,UAAU;IAkLlB,OAAO,CAAC,WAAW;IAgMnB,OAAO,CAAC,iBAAiB;IAgDzB,OAAO,CAAC,gBAAgB;IA+FxB,OAAO,CAAC,WAAW;IAmGnB,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,OAAO;IAmJf,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,OAAO;IAwBf,OAAO,CAAC,QAAQ;CAIjB"}
+{"version":3,"file":"pmx-loader.d.ts","sourceRoot":"","sources":["../src/pmx-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAcN,MAAM,SAAS,CAAA;AAGhB,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEzE,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,mBAAmB,CAAI;IAC/B,OAAO,CAAC,eAAe,CAAI;IAC3B,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,kBAAkB,CAAI;IAC9B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAA0B;IAC1C;;oEAEgE;IAChE,OAAO,CAAC,aAAa,CAAqB;IAC1C;oDACgD;IAChD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAY;IAC/B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAe;IAE/B,OAAO;IAQP,OAAO,CAAC,IAAI;WAMC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAI9C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK;WAIpC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAKxF,OAAO,CAAC,KAAK;IAiBb,OAAO,CAAC,WAAW;IAwDnB,OAAO,CAAC,aAAa;IAgHrB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,cAAc;IAsEtB,OAAO,CAAC,UAAU;IAkLlB,OAAO,CAAC,WAAW;IAgMnB,OAAO,CAAC,iBAAiB;IAgDzB,OAAO,CAAC,gBAAgB;IA+FxB,OAAO,CAAC,WAAW;IAmGnB,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,OAAO;IAoJf,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,OAAO;IAwBf,OAAO,CAAC,QAAQ;CAIjB"}

package/dist/pmx-loader.js

@@ -19,6 +19,10 @@ export class PmxLoader {
         this.inverseBindMatrices = null;
         this.joints0 = null;
         this.weights0 = null;
+        /** The PMX's additional UV channels (1–4), each four floats a vertex. The
+         *  engine's own shading reads none of them; a native look can name one as
+         *  the carrier of a game vertex stream (NativeLook.streams). */
+        this.additionalUvs = [];
         /** PMX per-vertex edge scale — the outline's width multiplier, as the
          *  game's outline takes vertex colour alpha. */
         this.edgeScales = null;
@@ -121,6 +125,7 @@ export class PmxLoader {
         const joints = new Uint16Array(count * 4);
         const weights = new Uint8Array(count * 4); // UNORM8, will be normalized to 255
         const edgeScales = new Float32Array(count);
+        this.additionalUvs = Array.from({ length: this.additionalVec4Count }, () => new Float32Array(count * 4));
         for (let i = 0; i < count; i++) {
             const px = this.getFloat32();
             const py = this.getFloat32();
@@ -134,7 +139,11 @@ export class PmxLoader {
             const v = this.getFloat32();
             // PMX UVs are in the same orientation as WebGPU sampling; no flip
             uvs.push(u, v);
-            this.offset += this.additionalVec4Count * 16;
+            for (let k = 0; k < this.additionalVec4Count; k++) {
+                const a = this.additionalUvs[k];
+                for (let c = 0; c < 4; c++)
+                    a[i * 4 + c] = this.getFloat32();
+            }
             const type = this.getUint8();
             const base = i * 4;
             // Initialize defaults
@@ -1029,7 +1038,7 @@ export class PmxLoader {
         const morphing = {
             morphs: this.morphs,
         };
-        return new Model(vertexData, indexData, this.textures, this.materials, skeleton, skinning, morphing, this.rigidbodies, this.joints, this.warnings, this.edgeScales);
+        return new Model(vertexData, indexData, this.textures, this.materials, skeleton, skinning, morphing, this.rigidbodies, this.joints, this.warnings, this.edgeScales, this.additionalUvs);
     }
     getUint8() {
         if (this.offset >= this.view.buffer.byteLength) {

package/dist/shaders/anchor-table.d.ts

@@ -1,6 +1,12 @@
 interface AnchorRequest {
     bone: string;
     trail: boolean;
+    /** Model units down the bone's own axis (`#anchor ... along d`); absent = 0,
+     *  the joint itself. */
+    along?: number;
+    /** World units the bone must move before its trail keeps a point
+     *  (`trail step d`); absent = every 60 Hz tick. */
+    step?: number;
 }
 /** The empty table — a scene with no effect installed asks for no bones. */
 export declare const EMPTY_ANCHOR_TABLE: AnchorTable;
@@ -26,6 +32,11 @@ export interface AnchorTable {
  * Order is first-come, so a single effect gets the identity alias and the whole
  * mechanism is a no-op until a second effect exists — which is what makes this
  * safe to land before setEffects does.
+ *
+ * A point ALONG a bone is a different point: `#anchor 右手首 trail along 0.9`
+ * and a bare `#anchor 右手首` are two entries, keyed by bone and distance, since
+ * sharing one ring would hand one of them the other's path. So is a trail
+ * recorded at a different `step`: its ring keeps different points.
  */
 export declare function buildAnchorTable(requests: AnchorRequest[][], max: number): AnchorTable;
 /**

package/dist/shaders/anchor-table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchor-table.d.ts","sourceRoot":"","sources":["../../src/shaders/anchor-table.ts"],"names":[],"mappings":"AAsBA,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;CACf;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,EAAE,WAAqD,CAAA;AAEtF,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,EAAE,EAAE,CAAA;IACjB,6EAA6E;IAC7E,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAiCtF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAkB3D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAmCvD"}
+{"version":3,"file":"anchor-table.d.ts","sourceRoot":"","sources":["../../src/shaders/anchor-table.ts"],"names":[],"mappings":"AAsBA,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd;4BACwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;uDACmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,EAAE,WAAqD,CAAA;AAEtF,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,EAAE,EAAE,CAAA;IACjB,6EAA6E;IAC7E,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAkCtF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAkB3D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAmCvD"}

package/dist/shaders/anchor-table.js

@@ -32,6 +32,11 @@ export const EMPTY_ANCHOR_TABLE = { entries: [], alias: [], dropped: [] };
  * Order is first-come, so a single effect gets the identity alias and the whole
  * mechanism is a no-op until a second effect exists — which is what makes this
  * safe to land before setEffects does.
+ *
+ * A point ALONG a bone is a different point: `#anchor 右手首 trail along 0.9`
+ * and a bare `#anchor 右手首` are two entries, keyed by bone and distance, since
+ * sharing one ring would hand one of them the other's path. So is a trail
+ * recorded at a different `step`: its ring keeps different points.
  */
 export function buildAnchorTable(requests, max) {
     const entries = [];
@@ -41,7 +46,8 @@ export function buildAnchorTable(requests, max) {
     for (let e = 0; e < requests.length; e++) {
         const local = [];
         for (const req of requests[e]) {
-            let g = index.get(req.bone);
+            const key = req.along || req.step ? `${req.bone}\u0000${req.along ?? 0}\u0000${req.step ?? 0}` : req.bone;
+            let g = index.get(key);
             if (g === undefined) {
                 if (entries.length >= max) {
                     // Refused, and the effect still installs: an effect that loses one of
@@ -52,8 +58,8 @@ export function buildAnchorTable(requests, max) {
                     continue;
                 }
                 g = entries.length;
-                index.set(req.bone, g);
-                entries.push({ bone: req.bone, trail: req.trail });
+                index.set(key, g);
+                entries.push({ bone: req.bone, trail: req.trail, ...(req.along ? { along: req.along } : {}), ...(req.step ? { step: req.step } : {}) });
             }
             else if (req.trail) {
                 // A later request for the same bone can only ever ADD the trail — the

package/dist/shaders/directives.d.ts

@@ -1,3 +1,31 @@
+/**
+ * A bone an effect follows: `#anchor <bone> [trail] [along <d>]`.
+ *
+ * `along` is for an effect that comes off a point ON the bone rather than at its
+ * joint — threads leaving the knuckles, not the wrist; a flame at a sword's tip.
+ * The point is `d` model units down the bone's own axis: the direction a PMX
+ * editor draws the bone pointing (its tail, as an offset or as the bone it
+ * points at), turned by the bone's pose, scaled with the model. A left and a
+ * right wrist point opposite ways, so one number mirrors itself. A bone with no
+ * tail has no axis, and the point stays at the joint.
+ *
+ * Everything the anchor feeds reads the moved point: rzAnchor, the trail, the
+ * ribbon. Two effects naming the same bone at different `along` are two anchors.
+ *
+ * `trail step d` records the path the way a game's trail does (Unity's
+ * minVertexDistance): the newest point follows the bone every frame, and a
+ * point is only LEFT BEHIND once the bone is `d` world units from the last one.
+ * Sampled on the clock alone, a slowing hand leaves a knot of tiny segments
+ * whose directions jitter, and a wide ribbon fans across them into a starburst;
+ * a stepped path has no segment shorter than `d`. Ages stay true — each point
+ * keeps the time it was left. Different steps are different anchors.
+ */
+export type EffectAnchor = {
+    bone: string;
+    trail: boolean;
+    along?: number;
+    step?: number;
+};
 /** A knob an effect exposes, for a host to build a control from. */
 export type EffectParamDecl = {
     name: string;
@@ -9,11 +37,10 @@ export type EffectParamDecl = {
     max?: number;
 };
 export type EffectDirectives = {
-    /** Bones this effect follows, in declaration order — slot 0 is the first. */
-    anchors: {
-        bone: string;
-        trail: boolean;
-    }[];
+    /** Bones this effect follows, in declaration order — slot 0 is the first.
+     *  `along` (model units, absent = 0) moves the point down the bone's own
+     *  axis, its rest tail direction posed with it: see EffectAnchor. */
+    anchors: EffectAnchor[];
     params: EffectParamDecl[];
     /** Field layer: 0 full, 1 half. Full unless `#halfres` says otherwise. */
     fieldLayer: 0 | 1;
@@ -26,6 +53,16 @@ export type EffectDirectives = {
      *  every real grass renderer does, and the only thing that bounds a dense
      *  lawn's cost by the pixels it covers rather than by how deep it stacks. */
     particleBlend: "alpha" | "additive" | "cutout";
+    /** How RIBBONS land, a separate axis from the particles': additive unless
+     *  the file says `#blend over`. Ribbons ignored #blend until that keyword,
+     *  and every shipped ribbon was tuned additive — so the default stays, and
+     *  `over` is the opt-in. The same line sets particles to plain alpha, which
+     *  already IS premultiplied over for them. */
+    trailBlend: "additive" | "over";
+    /** `#depth always`: the particles are drawn over the scene, not depth
+     *  tested — a game glow its material draws with ZTest Always (a moon's halo
+     *  in front of the sky dome it sits behind). Depth tested otherwise. */
+    depthAlways: boolean;
     particles: number;
     lights: number;
     grid: number;

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

@@ -1 +1 @@
-{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../../src/shaders/directives.ts"],"names":[],"mappings":"AA8BA,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;IAChC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;IACjD,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,6EAA6E;IAC7E,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IAC3C,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,0EAA0E;IAC1E,UAAU,EAAE,CAAC,GAAG,CAAC,CAAA;IACjB,8DAA8D;IAC9D,aAAa,EAAE,OAAO,CAAA;IACtB,wEAAwE;IACxE;;;;iFAI6E;IAC7E,aAAa,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ;kFAC8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAA;IACjB;;;;;;;4CAOwC;IACxC,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACjE;;;;;;;;;;;;;OAaG;IACH,MAAM,EAAE,OAAO,CAAA;IACf;;;;;;;OAOG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;;;;;;;;;OAaG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAsBD;;;+BAG+B;AAC/B,eAAO,MAAM,cAAc,QAAmC,CAAA;AAG9D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,QAA8B,CAAA;AAmBzD,MAAM,MAAM,eAAe,GAAG;IAAE,UAAU,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEhF,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CA6L7D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD"}
+{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../../src/shaders/directives.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1F,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;IAChC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;IACjD,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;yEAEqE;IACrE,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,0EAA0E;IAC1E,UAAU,EAAE,CAAC,GAAG,CAAC,CAAA;IACjB,8DAA8D;IAC9D,aAAa,EAAE,OAAO,CAAA;IACtB,wEAAwE;IACxE;;;;iFAI6E;IAC7E,aAAa,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;IAC9C;;;;kDAI8C;IAC9C,UAAU,EAAE,UAAU,GAAG,MAAM,CAAA;IAC/B;;4EAEwE;IACxE,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ;kFAC8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAA;IACjB;;;;;;;4CAOwC;IACxC,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACjE;;;;;;;;;;;;;OAaG;IACH,MAAM,EAAE,OAAO,CAAA;IACf;;;;;;;OAOG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;;;;;;;;;OAaG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAuBD;;;+BAG+B;AAC/B,eAAO,MAAM,cAAc,QAAmC,CAAA;AAG9D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,QAA8B,CAAA;AAmBzD,MAAM,MAAM,eAAe,GAAG;IAAE,UAAU,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEhF,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CA0O7D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/shaders/directives.js

@@ -34,6 +34,7 @@ const SPEC = {
     halfres: 0,
     layer: 1,
     blend: 1,
+    depth: 1,
     particles: 1,
     lights: 1,
     grid: 1,
@@ -88,6 +89,8 @@ export function parseDirectives(wgsl) {
         fieldLayer: 0,
         additiveLayer: false,
         particleBlend: "alpha",
+        trailBlend: "additive",
+        depthAlways: false,
         particles: 0,
         lights: 0,
         grid: 0,
@@ -120,11 +123,41 @@ export function parseDirectives(wgsl) {
         }
         switch (tag) {
             case "anchor": {
-                if (args.length < 1 || args.length > 2 || (args[1] && args[1] !== "trail")) {
-                    errors.push(`${at}: #anchor takes a bone name and optionally the word "trail"`);
+                // <bone> [trail [step <d>]] [along <d>], in that order.
+                const usage = `${at}: #anchor takes a bone name, optionally "trail" (and "step" with a distance), then optionally "along" and a distance`;
+                if (args.length < 1) {
+                    errors.push(usage);
                     return;
                 }
-                d.anchors.push({ bone: args[0], trail: args[1] === "trail" });
+                let k = 1;
+                const trail = args[k] === "trail";
+                if (trail)
+                    k++;
+                let step;
+                if (trail && args[k] === "step") {
+                    const v = num(args[k + 1]);
+                    if (v === null || v <= 0) {
+                        errors.push(`${at}: #anchor ... trail step needs a positive distance in world units, like "step 0.24"`);
+                        return;
+                    }
+                    step = v;
+                    k += 2;
+                }
+                let along;
+                if (args[k] === "along") {
+                    const v = num(args[k + 1]);
+                    if (v === null) {
+                        errors.push(`${at}: #anchor ... along needs a distance in model units, like "along 0.9"`);
+                        return;
+                    }
+                    along = v;
+                    k += 2;
+                }
+                if (k !== args.length) {
+                    errors.push(usage);
+                    return;
+                }
+                d.anchors.push({ bone: args[0], trail, ...(step ? { step } : {}), ...(along ? { along } : {}) });
                 return;
             }
             case "param": {
@@ -181,8 +214,15 @@ export function parseDirectives(wgsl) {
                 d.additiveLayer = true;
                 return;
             case "blend":
+                // `over` is for ribbons: laid over the scene by their alpha instead of
+                // added. For particles it is the default alpha, which is already over.
+                if (args[0] === "over") {
+                    d.trailBlend = "over";
+                    d.particleBlend = "alpha";
+                    return;
+                }
                 if (args[0] !== "additive" && args[0] !== "cutout") {
-                    errors.push(`${at}: #blend takes "additive" or "cutout" — alpha is the default`);
+                    errors.push(`${at}: #blend takes "additive", "cutout" or "over" — alpha is the default`);
                     return;
                 }
                 d.particleBlend = args[0];
@@ -190,6 +230,13 @@ export function parseDirectives(wgsl) {
             case "bloom":
                 d.bloom = true;
                 return;
+            case "depth":
+                if (args[0] !== "always") {
+                    errors.push(`${at}: #depth takes "always" — depth tested is the default`);
+                    return;
+                }
+                d.depthAlways = true;
+                return;
             case "ground": {
                 const m = /^#([0-9a-fA-F]{6})$/.exec(args[0] ?? "");
                 const noise = args[1] === undefined ? 0 : num(args[1]);

package/dist/shaders/lights.d.ts

@@ -1,6 +1,6 @@
 /** Words before the first record: the counts, the grid's placement and the
- *  outside mask, four vec4s — see the layout above. */
-export declare const LIGHT_HEADER = 16;
+ *  outside mask, five vec4s — see the layout above. */
+export declare const LIGHT_HEADER = 20;
 /** Floats per light — see the layout above. */
 export declare const LIGHT_STRIDE = 16;
 /**
@@ -15,10 +15,11 @@ export declare const LIGHT_STRIDE = 16;
  * forty-eight each cut a real scene in half. Past this the extras are dropped.
  *
  * A fragment pays for the document lamps its grid cell names, so the cost
- * follows how many reach a place rather than how many the scene holds. It is
- * also why the cap is 128: one vec4u of bits per cell.
+ * follows how many reach a place rather than how many the scene holds. 256,
+ * two vec4u of bits per cell, is URP's own Forward+ budget for visible lights
+ * — and holds a lit interior's whole rig (X317's 153).
  */
-export declare const MAX_LIGHTS = 128;
+export declare const MAX_LIGHTS = 256;
 /** Words of lamp bits per grid cell — one bit per lamp the cap allows. */
 export declare const LIGHT_MASK_WORDS: number;
 /** The grid's cell budget. 32k cells over a stage a couple of hundred units
@@ -37,7 +38,7 @@ export declare const LIGHTS_FLOATS: number;
  * out of those modules is a compile error on a function the author was right to
  * write, which is the same trap the grid's step-only half documents.
  */
-export declare const RZ_LIGHT_STRUCT_WGSL = "\n/** What an effect returns for one of its lights. */\nstruct RzLight {\n  pos: vec3f,\n  color: vec3f,\n  intensity: f32,\n  radius: f32,\n}\n";
+export declare const RZ_LIGHT_STRUCT_WGSL = "\n/** What an effect returns for one of its lights. */\nstruct RzLight {\n  pos: vec3f,\n  color: vec3f,\n  intensity: f32,\n  radius: f32,\n  /** Its bulb: the distance inside which it stops getting brighter. 0 is the\n   *  engine's default; a glow worn on a hand wants one the size of the glow. */\n  near: f32,\n}\n";
 /** rzWorldAmbient against the materials' and the ground's `light` uniform. */
 export declare const WORLD_AMBIENT_WGSL: string;
 /** Does this source define the emit mount? */
@@ -74,5 +75,8 @@ export declare function buildLightEmitShader(wgsl: string, sceneApi: string, cas
 }, paramsDecl?: string): string;
 /** The rz*Light accessors, with the buffer declared at the given binding.
  *  `layers` is the WGSL expression for the drawing's rendering-layer bits. */
-export declare function lightsApi(group: number, binding: number, layers: string): string;
+export declare function lightsApi(group: number, binding: number, layers: string, cookies: {
+    binding: number;
+    sampler: string;
+}): 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":"AA4DA;uDACuD;AACvD,eAAO,MAAM,YAAY,KAAK,CAAA;AAC9B,+CAA+C;AAC/C,eAAO,MAAM,YAAY,KAAK,CAAA;AAC9B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,MAAM,CAAA;AAC7B,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,QAAkB,CAAA;AAC/C;0EAC0E;AAC1E,eAAO,MAAM,gBAAgB,QAAQ,CAAA;AACrC,uCAAuC;AACvC,eAAO,MAAM,eAAe,QAA2C,CAAA;AACvE,wDAAwD;AACxD,eAAO,MAAM,aAAa,QAAwD,CAAA;AAElF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,qJAQhC,CAAA;AAED,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,QAA4B,CAAA;AAE3D,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,CAoGR;AAED;8EAC8E;AAC9E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgKhF"}
+{"version":3,"file":"lights.d.ts","sourceRoot":"","sources":["../../src/shaders/lights.ts"],"names":[],"mappings":"AA8DA;uDACuD;AACvD,eAAO,MAAM,YAAY,KAAK,CAAA;AAC9B,+CAA+C;AAC/C,eAAO,MAAM,YAAY,KAAK,CAAA;AAC9B;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,MAAM,CAAA;AAC7B,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,QAAkB,CAAA;AAC/C;0EAC0E;AAC1E,eAAO,MAAM,gBAAgB,QAAQ,CAAA;AACrC,uCAAuC;AACvC,eAAO,MAAM,eAAe,QAA2C,CAAA;AACvE,wDAAwD;AACxD,eAAO,MAAM,aAAa,QAAwD,CAAA;AAElF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,oUAWhC,CAAA;AAED,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,QAA4B,CAAA;AAE3D,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,CAoGR;AAED;8EAC8E;AAC9E,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C,MAAM,CAsMR"}