@neutrinoparticles/js-v1.1-phaser 1.0.0 → 1.1.0

package/dist/neutrinoparticles.js-v1.1-phaser.es.js

@@ -1,6 +1,6 @@
 var K = Object.defineProperty;
-var k = (s, e, t) => e in s ? K(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
-var n = (s, e, t) => k(s, typeof e != "symbol" ? e + "" : e, t);
+var z = (s, e, t) => e in s ? K(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
+var n = (s, e, t) => z(s, typeof e != "symbol" ? e + "" : e, t);
 import Phaser from "phaser";
 import * as Neutrino from "@neutrinoparticles/js-v1.1";
 const vertexShaderSource = `#version 300 es
@@ -54,7 +54,8 @@ vec4 fetchTexel(int globalTexelIndex) {
 }
 
 // Strip geometry helpers (port of GPU33 makeScreenSpaceStrip).
-// 2D screen-space variant — PIXI7 renderer is 2D, world Z is dropped at gl_Position.
+// 2D screen-space variant used by the Faced strip frame; world Z reaches
+// gl_Position only through uViewProjMatrix (ortho or v1.0-parity perspective).
 vec2 stripOrtho(vec2 v) {
     return vec2(-v.y, v.x);
 }
@@ -91,9 +92,9 @@ void main() {
     //   0 (Faced): screen-space ortho to dir12 — equivalent to camera-faced
     //              billboard normal in a 2D camera setup.
     //   1 (Free):  the quaternion stored in texel 2 nominally encodes a 3D
-    //              orientation. The current PIXI7 renderer is fundamentally
-    //              2D (worldPos.z is dropped at gl_Position for quads), so
-    //              the quat is read but its 3D y-axis is projected to screen
+    //              orientation. The PIXI7 renderer has no true 3D camera
+    //              (uViewProjMatrix is ortho or the v1.0-parity perspective),
+    //              so the quat is read but its 3D y-axis is projected to screen
     //              and used as the section normal. When the projection
     //              degenerates (looking along the y-axis) we fall back to
     //              the screen-space ortho. Real 3D free-rotation requires a
@@ -128,6 +129,10 @@ void main() {
             float((packedColorNex >> 8u) & 0xFFu) / 255.0,
             float((packedColorNex >> 16u) & 0xFFu) / 255.0,
             float((packedColorNex >> 24u) & 0xFFu) / 255.0);
+        // HDR color scale S (RGBS, bloom TDD #175 §13.12): offset+60 (t3.a) per-particle
+        // float scale; multiply BEFORE the cross-fade. S=1 for LDR (no-op).
+        color1.rgb *= (isCur ? t3.a : ts3.a);
+        color2.rgb *= (isCur ? ts3.a : t3.a);
 
         // neighborIdxP0 / neighborIdxP3 are stored on every meta of a pair
         // (both meta_cur and meta_nex hold the same pair of indices), so we
@@ -174,6 +179,10 @@ void main() {
         // by the sign of w). Forces a discard outside the [-w,w] cube at the end.
         bool nearPlaneClipped = (sp1.w < 1e-3) || (sp2.w < 1e-3);
 
+        // #236: set when the segment itself is degenerate (much shorter than
+        // the ribbon half-width) — the pair is discarded like nearPlaneClipped.
+        bool stripDegenerate = false;
+
         // Aspect correction so the 2D Faced ortho gives visually-perpendicular
         // dirs on non-square viewports (inverted before gl_Position).
         vec2 aspectMul = vec2(1.0, 1.0 / max(uViewportAspect, 1e-6));
@@ -211,9 +220,15 @@ void main() {
             float wlen01 = length(wp01);
             float wlen12 = length(wp12);
             float wlen23 = length(wp23);
+            // #236: degeneracy guards at visual scale (mirror of GPU33).
+            // A segment much shorter than the ribbon half-width cannot define
+            // a visually meaningful direction; a degenerate neighbour falls
+            // back to the straight cap instead of a noise knee.
+            float wDegenEps = max(max(abs(halfSize1), abs(halfSize2)) * 0.02, 1e-6);
+            if (wlen12 < wDegenEps) stripDegenerate = true;
             vec3 wdir12 = (wlen12 > 1e-6) ? (wp12 / wlen12) : vec3(1.0, 0.0, 0.0);
-            vec3 wdir01 = (wlen01 > 1e-6) ? (wp01 / wlen01) : wdir12;
-            vec3 wdir23 = (wlen23 > 1e-6) ? (wp23 / wlen23) : wdir12;
+            vec3 wdir01 = (wlen01 > wDegenEps) ? (wp01 / wlen01) : wdir12;
+            vec3 wdir23 = (wlen23 > wDegenEps) ? (wp23 / wlen23) : wdir12;
             noKnee1 = dot(wdir01, wdir12) > 0.999;
             noKnee2 = dot(wdir12, wdir23) > 0.999;
             pathLen12 = wlen12;
@@ -225,9 +240,12 @@ void main() {
                 vec3 K1 = Kmul1 * normalize(cross(wdir01 + wdir12, n1));
                 Bmul1 = sign(dot(B1raw, K1));
                 vec3 B1 = B1raw * Bmul1;
-                float ik1 = halfSize1 / max(dot(B1, K1), 1e-6);
-                if (dot(-wdir01, ik1 * -K1) > wlen01) ik1 = wlen01;
-                if (dot( wdir12, ik1 * -K1) > wlen12) ik1 = wlen12;
+                // #236: inner vertex at the ribbon half-width along the
+                // bisector, symmetric to the outer vertex (mirror of GPU33).
+                // The old true-miter-with-neighbour-length-clamp cut an
+                // uncovered wedge out of sharp bends whenever halfSize
+                // exceeded the particle spacing.
+                float ik1 = halfSize1;
                 worldK1 = p1 + K1 * halfSize1;
                 worldB1 = p1 + B1 * halfSize1;
                 worldIK1 = p1 - K1 * ik1;
@@ -248,9 +266,8 @@ void main() {
                 vec3 K2 = Kmul2 * normalize(cross(wdir12 + wdir23, n2));
                 Bmul2 = sign(dot(B2raw, K2));
                 vec3 B2 = B2raw * Bmul2;
-                float ik2 = halfSize2 / max(dot(B2, K2), 1e-6);
-                if (dot(-wdir12, ik2 * -K2) > wlen12) ik2 = wlen12;
-                if (dot( wdir23, ik2 * -K2) > wlen23) ik2 = wlen23;
+                // #236: see ik1 — inner vertex at the ribbon half-width.
+                float ik2 = halfSize2;
                 worldK2 = p2 + K2 * halfSize2;
                 worldB2 = p2 + B2 * halfSize2;
                 worldIK2 = p2 - K2 * ik2;
@@ -267,10 +284,16 @@ void main() {
             // Faced: screen-space NDC frame around dir12.
             vec4 sp0 = mvpMatrix * vec4(p0, 1.0);
             vec4 sp3 = mvpMatrix * vec4(p3, 1.0);
-            vec2 ndc0 = (sp0.xy / sp0.w) * aspectMul;
             vec2 ndc1 = (sp1.xy / sp1.w) * aspectMul;
             vec2 ndc2 = (sp2.xy / sp2.w) * aspectMul;
-            vec2 ndc3 = (sp3.xy / sp3.w) * aspectMul;
+            // Neighbor anchors behind the near plane produce garbage NDC after
+            // the perspective divide (possible only with Projection3D, where w
+            // varies); collapse them onto their segment anchor so the existing
+            // zero-length degeneracy path (dir01 = dir12 / dir23 = dir12)
+            // handles the knee instead of a poisoned miter. spU1/spU2 need no
+            // guard: uCameraUp has zero Z, so their w equals sp1.w / sp2.w.
+            vec2 ndc0 = (sp0.w < 1e-3) ? ndc1 : (sp0.xy / sp0.w) * aspectMul;
+            vec2 ndc3 = (sp3.w < 1e-3) ? ndc2 : (sp3.xy / sp3.w) * aspectMul;
 
             vec2 d01 = ndc1 - ndc0;
             vec2 d12 = ndc2 - ndc1;
@@ -278,12 +301,6 @@ void main() {
             float len01 = length(d01);
             float len12 = length(d12);
             float len23 = length(d23);
-            vec2 dir12 = (len12 > 1e-6) ? (d12 / len12) : vec2(1.0, 0.0);
-            vec2 dir01 = (len01 > 1e-6) ? (d01 / len01) : dir12;
-            vec2 dir23 = (len23 > 1e-6) ? (d23 / len23) : dir12;
-            noKnee1 = dot(dir01, dir12) > 0.999;
-            noKnee2 = dot(dir12, dir23) > 0.999;
-            pathLen12 = len12;
 
             // Section magnitude: project camera_up*halfSize per anchor into NDC.
             vec4 spU1 = mvpMatrix * vec4(p1 + uCameraUp * halfSize1, 1.0);
@@ -291,15 +308,25 @@ void main() {
             float ndcHalfSize1 = length((spU1.xy / spU1.w) * aspectMul - ndc1);
             float ndcHalfSize2 = length((spU2.xy / spU2.w) * aspectMul - ndc2);
 
+            // #236: degeneracy guards at visual scale (mirror of GPU33).
+            float degenEps = max(max(ndcHalfSize1, ndcHalfSize2) * 0.02, 1e-6);
+            if (len12 < degenEps) stripDegenerate = true;
+            vec2 dir12 = (len12 > 1e-6) ? (d12 / len12) : vec2(1.0, 0.0);
+            vec2 dir01 = (len01 > degenEps) ? (d01 / len01) : dir12;
+            vec2 dir23 = (len23 > degenEps) ? (d23 / len23) : dir12;
+            noKnee1 = dot(dir01, dir12) > 0.999;
+            noKnee2 = dot(dir12, dir23) > 0.999;
+            pathLen12 = len12;
+
             vec2 B = stripOrtho(dir12);
             if (!noKnee1) {
                 float Kmul1 = -sign(dot(stripOrtho(dir01), dir12));
                 vec2 K1 = Kmul1 * normalize(stripOrtho(dir01 + dir12));
                 Bmul1 = sign(dot(B, K1));
                 vec2 B1 = B * Bmul1;
-                float ik1 = ndcHalfSize1 / max(dot(B1, K1), 1e-6);
-                if (dot(-dir01, ik1 * -K1) > len01) ik1 = len01;
-                if (dot(dir12, ik1 * -K1) > len12) ik1 = len12;
+                // #236: inner vertex at the ribbon half-width (see the Free
+                // branch comment above).
+                float ik1 = ndcHalfSize1;
                 k1 = ndc1 + K1 * ndcHalfSize1;
                 b1 = ndc1 + B1 * ndcHalfSize1;
                 IK1 = ndc1 - K1 * ik1;
@@ -317,9 +344,8 @@ void main() {
                 vec2 K2 = Kmul2 * normalize(stripOrtho(dir12 + dir23));
                 Bmul2 = sign(dot(B, K2));
                 vec2 B2 = B * Bmul2;
-                float ik2 = ndcHalfSize2 / max(dot(B2, K2), 1e-6);
-                if (dot(-dir12, ik2 * -K2) > len12) ik2 = len12;
-                if (dot(dir23, ik2 * -K2) > len23) ik2 = len23;
+                // #236: see ik1 — inner vertex at the ribbon half-width.
+                float ik2 = ndcHalfSize2;
                 k2 = ndc2 + K2 * ndcHalfSize2;
                 b2 = ndc2 + B2 * ndcHalfSize2;
                 IK2 = ndc2 - K2 * ik2;
@@ -334,6 +360,34 @@ void main() {
             }
         }
 
+        // #236: a noKnee (straight-cap) end carries no bend side of its own —
+        // its raw side label is always the +B side. If the segment's other
+        // end is a real knee on the -B side, the mismatched labels would send
+        // the ladder into the opposite-sides (twist) branch and flip the
+        // texture V across a segment that does not actually change bend side.
+        // Relabel the straight end to the knee end's side (swap its k/IK and
+        // re-collapse b onto the new k) so the ladder stays untwisted. Both
+        // frames are swapped; only the active one is meaningful.
+        if (noKnee1 && !noKnee2 && Bmul2 < 0.0) {
+            // Swap only the ACTIVE frame's variables - the inactive frame's
+            // are uninitialized and must not be read.
+            if (isFreeRotation) {
+                vec3 tRw1 = worldK1; worldK1 = worldIK1; worldIK1 = tRw1; worldB1 = worldK1;
+            } else {
+                vec2 tRl1 = k1; k1 = IK1; IK1 = tRl1; b1 = k1;
+            }
+            Bmul1 = Bmul2;
+        }
+        if (noKnee2 && !noKnee1 && Bmul1 < 0.0) {
+            if (isFreeRotation) {
+                vec3 tRw2 = worldK2; worldK2 = worldIK2; worldIK2 = tRw2; worldB2 = worldK2;
+            } else {
+                vec2 tRl2 = k2; k2 = IK2; IK2 = tRl2; b2 = k2;
+            }
+            Bmul2 = Bmul1;
+        }
+
+
         // V coords (mirror of preview3 / GPU33 make*Strip):
         //   V at outer knee (k)  = (Bmul + 1) * 0.5
         //   V at inner knee (IK) = 1 - V_outer ; bend (b) = outer
@@ -435,7 +489,10 @@ void main() {
 
         // Free projects the world-space vertex through MVP directly; Faced
         // reconstructs clip space from aspect-corrected NDC (mirror of preview3).
-        if (isFreeRotation) {
+        if (stripDegenerate) {
+            // #236: sub-visual segment — discard the pair entirely.
+            gl_Position = vec4(2.0, 2.0, 2.0, 1.0);
+        } else if (isFreeRotation) {
             gl_Position = mvpMatrix * vec4(vertPos3D, 1.0);
         } else if (nearPlaneClipped) {
             // At least one anchor is at / behind the near plane → the NDC math
@@ -472,6 +529,10 @@ void main() {
         float((packedColor >> 16u) & 0xFFu) / 255.0,
         float((packedColor >> 24u) & 0xFFu) / 255.0
     );
+    // HDR color scale S (RGBS, bloom TDD #175 §13.12): offset+60 (t3.a) is a
+    // per-particle float scale. RGB was normalized by S at pack time; restore HDR
+    // here. S=1 for LDR colors (no-op). Alpha is untouched.
+    vColor.rgb *= t3.a;
 
     uint gridConfig = floatBitsToUint(t3.g);
     float gridWidth = max(float(gridConfig & 0xFFFFu), 1.0);
@@ -519,7 +580,23 @@ void main() {
 
     mat4 mvpMatrix = uViewProjMatrix * uModelMatrix;
     vec3 worldPos = position + posDisp;
-    gl_Position = mvpMatrix * vec4(worldPos.xy, 0.0, 1.0);
+    gl_Position = mvpMatrix * vec4(worldPos, 1.0);
+
+    // v1.0-parity near-plane culling for the perspective projection: the
+    // whole quad is discarded when ANY of its 4 corners is behind the near
+    // plane (w < 0.01 == pos.z > 0.99 * z_cam in PerspectiveProjection
+    // terms). w is linear in position, so the corner minimum comes from the
+    // w-row and the corner offsets (x in {-ox, 1-ox}, y in {-oy, 1-oy}).
+    // Without a projection every w is 1.0 and this is a no-op.
+    vec4 wRow = vec4(mvpMatrix[0].w, mvpMatrix[1].w, mvpMatrix[2].w, mvpMatrix[3].w);
+    float wx = dot(wRow.xyz, xaxis);
+    float wy = dot(wRow.xyz, yaxis);
+    float minW = dot(wRow.xyz, position) + wRow.w
+        - origin.x * wx + min(wx, 0.0)
+        - origin.y * wy + min(wy, 0.0);
+    if (minW < 0.01) {
+        gl_Position = vec4(2.0, 2.0, 2.0, 1.0);
+    }
 
     // Texture coordinates with grid + atlas remap
     vec2 baseTexCoord = TEX_COORD[vertexIndex];
@@ -739,6 +816,11 @@ void main() {
         // Colors: the meta M1 sample is the normalized RGBA directly.
         vec4 color1 = fetchMeta(curBase + 1.0);
         vec4 color2 = fetchMeta(nexBase + 1.0);
+        // HDR color scale S (RGBS, bloom TDD #175 §13.12): a plain float at offset+60,
+        // read straight from the float DATA texture (texel 3, .a) — like gridIndex — not
+        // the meta texture. Multiply BEFORE the cross-fade. S=1 → no-op.
+        color1.rgb *= fetchData(curBase + 3.0).a;
+        color2.rgb *= fetchData(nexBase + 3.0).a;
 
         // Neighbor RECORD indices (system.js convention: neighborIdxP0 on the
         // pair-cur meta, neighborIdxP3 on the pair-nex meta; boundary
@@ -770,6 +852,10 @@ void main() {
         // unaffected by the sign of w).
         bool nearPlaneClipped = (sp1.w < 1e-3) || (sp2.w < 1e-3);
 
+        // #236: set when the segment itself is degenerate (much shorter than
+        // the ribbon half-width) - the pair is discarded like nearPlaneClipped.
+        bool stripDegenerate = false;
+
         // Aspect correction for the 2D Faced ortho on non-square viewports.
         vec2 aspectMul = vec2(1.0, 1.0 / max(uViewportAspect, 1e-6));
 
@@ -812,9 +898,12 @@ void main() {
             float wlen01 = length(wp01);
             float wlen12 = length(wp12);
             float wlen23 = length(wp23);
+            // #236: degeneracy guards at visual scale (mirror of GPU33).
+            float wDegenEps = max(max(abs(halfSize1), abs(halfSize2)) * 0.02, 1e-6);
+            if (wlen12 < wDegenEps) stripDegenerate = true;
             vec3 wdir12 = (wlen12 > 1e-6) ? (wp12 / wlen12) : vec3(1.0, 0.0, 0.0);
-            vec3 wdir01 = (wlen01 > 1e-6) ? (wp01 / wlen01) : wdir12;
-            vec3 wdir23 = (wlen23 > 1e-6) ? (wp23 / wlen23) : wdir12;
+            vec3 wdir01 = (wlen01 > wDegenEps) ? (wp01 / wlen01) : wdir12;
+            vec3 wdir23 = (wlen23 > wDegenEps) ? (wp23 / wlen23) : wdir12;
             noKnee1 = dot(wdir01, wdir12) > 0.999;
             noKnee2 = dot(wdir12, wdir23) > 0.999;
             pathLen12 = wlen12;
@@ -826,9 +915,9 @@ void main() {
                 vec3 K1 = Kmul1 * normalize(cross(wdir01 + wdir12, n1));
                 Bmul1 = sign(dot(B1raw, K1));
                 vec3 B1 = B1raw * Bmul1;
-                float ik1 = halfSize1 / max(dot(B1, K1), 1e-6);
-                if (dot(-wdir01, ik1 * -K1) > wlen01) ik1 = wlen01;
-                if (dot( wdir12, ik1 * -K1) > wlen12) ik1 = wlen12;
+                // #236: inner vertex at the ribbon half-width (mirror of
+                // GPU33; see the ES 3.00 shader for the rationale).
+                float ik1 = halfSize1;
                 worldK1 = p1 + K1 * halfSize1;
                 worldB1 = p1 + B1 * halfSize1;
                 worldIK1 = p1 - K1 * ik1;
@@ -849,9 +938,8 @@ void main() {
                 vec3 K2 = Kmul2 * normalize(cross(wdir12 + wdir23, n2));
                 Bmul2 = sign(dot(B2raw, K2));
                 vec3 B2 = B2raw * Bmul2;
-                float ik2 = halfSize2 / max(dot(B2, K2), 1e-6);
-                if (dot(-wdir12, ik2 * -K2) > wlen12) ik2 = wlen12;
-                if (dot( wdir23, ik2 * -K2) > wlen23) ik2 = wlen23;
+                // #236: see ik1 - inner vertex at the ribbon half-width.
+                float ik2 = halfSize2;
                 worldK2 = p2 + K2 * halfSize2;
                 worldB2 = p2 + B2 * halfSize2;
                 worldIK2 = p2 - K2 * ik2;
@@ -868,10 +956,16 @@ void main() {
             // Faced: screen-space NDC frame around dir12.
             vec4 sp0 = mvpMatrix * vec4(p0, 1.0);
             vec4 sp3 = mvpMatrix * vec4(p3, 1.0);
-            vec2 ndc0 = (sp0.xy / sp0.w) * aspectMul;
             vec2 ndc1 = (sp1.xy / sp1.w) * aspectMul;
             vec2 ndc2 = (sp2.xy / sp2.w) * aspectMul;
-            vec2 ndc3 = (sp3.xy / sp3.w) * aspectMul;
+            // Neighbor anchors behind the near plane produce garbage NDC after
+            // the perspective divide (possible only with Projection3D, where w
+            // varies); collapse them onto their segment anchor so the existing
+            // zero-length degeneracy path (dir01 = dir12 / dir23 = dir12)
+            // handles the knee instead of a poisoned miter. spU1/spU2 need no
+            // guard: uCameraUp has zero Z, so their w equals sp1.w / sp2.w.
+            vec2 ndc0 = (sp0.w < 1e-3) ? ndc1 : (sp0.xy / sp0.w) * aspectMul;
+            vec2 ndc3 = (sp3.w < 1e-3) ? ndc2 : (sp3.xy / sp3.w) * aspectMul;
 
             vec2 d01 = ndc1 - ndc0;
             vec2 d12 = ndc2 - ndc1;
@@ -879,12 +973,6 @@ void main() {
             float len01 = length(d01);
             float len12 = length(d12);
             float len23 = length(d23);
-            vec2 dir12 = (len12 > 1e-6) ? (d12 / len12) : vec2(1.0, 0.0);
-            vec2 dir01 = (len01 > 1e-6) ? (d01 / len01) : dir12;
-            vec2 dir23 = (len23 > 1e-6) ? (d23 / len23) : dir12;
-            noKnee1 = dot(dir01, dir12) > 0.999;
-            noKnee2 = dot(dir12, dir23) > 0.999;
-            pathLen12 = len12;
 
             // Section magnitude: project camera_up*halfSize per anchor into NDC.
             vec4 spU1 = mvpMatrix * vec4(p1 + uCameraUp * halfSize1, 1.0);
@@ -892,15 +980,24 @@ void main() {
             float ndcHalfSize1 = length((spU1.xy / spU1.w) * aspectMul - ndc1);
             float ndcHalfSize2 = length((spU2.xy / spU2.w) * aspectMul - ndc2);
 
+            // #236: degeneracy guards at visual scale (mirror of GPU33).
+            float degenEps = max(max(ndcHalfSize1, ndcHalfSize2) * 0.02, 1e-6);
+            if (len12 < degenEps) stripDegenerate = true;
+            vec2 dir12 = (len12 > 1e-6) ? (d12 / len12) : vec2(1.0, 0.0);
+            vec2 dir01 = (len01 > degenEps) ? (d01 / len01) : dir12;
+            vec2 dir23 = (len23 > degenEps) ? (d23 / len23) : dir12;
+            noKnee1 = dot(dir01, dir12) > 0.999;
+            noKnee2 = dot(dir12, dir23) > 0.999;
+            pathLen12 = len12;
+
             vec2 B = stripOrtho(dir12);
             if (!noKnee1) {
                 float Kmul1 = -sign(dot(stripOrtho(dir01), dir12));
                 vec2 K1 = Kmul1 * normalize(stripOrtho(dir01 + dir12));
                 Bmul1 = sign(dot(B, K1));
                 vec2 B1 = B * Bmul1;
-                float ik1 = ndcHalfSize1 / max(dot(B1, K1), 1e-6);
-                if (dot(-dir01, ik1 * -K1) > len01) ik1 = len01;
-                if (dot(dir12, ik1 * -K1) > len12) ik1 = len12;
+                // #236: inner vertex at the ribbon half-width.
+                float ik1 = ndcHalfSize1;
                 k1 = ndc1 + K1 * ndcHalfSize1;
                 b1 = ndc1 + B1 * ndcHalfSize1;
                 IK1 = ndc1 - K1 * ik1;
@@ -918,9 +1015,8 @@ void main() {
                 vec2 K2 = Kmul2 * normalize(stripOrtho(dir12 + dir23));
                 Bmul2 = sign(dot(B, K2));
                 vec2 B2 = B * Bmul2;
-                float ik2 = ndcHalfSize2 / max(dot(B2, K2), 1e-6);
-                if (dot(-dir12, ik2 * -K2) > len12) ik2 = len12;
-                if (dot(dir23, ik2 * -K2) > len23) ik2 = len23;
+                // #236: see ik1 - inner vertex at the ribbon half-width.
+                float ik2 = ndcHalfSize2;
                 k2 = ndc2 + K2 * ndcHalfSize2;
                 b2 = ndc2 + B2 * ndcHalfSize2;
                 IK2 = ndc2 - K2 * ik2;
@@ -935,6 +1031,33 @@ void main() {
             }
         }
 
+        // #236: a noKnee (straight-cap) end carries no bend side of its own -
+        // its raw side label is always the +B side. If the segment's other
+        // end is a real knee on the -B side, the mismatched labels would send
+        // the ladder into the opposite-sides (twist) branch and flip the
+        // texture V across a segment that does not actually change bend side.
+        // Relabel the straight end to the knee end's side (swap its k/IK and
+        // re-collapse b onto the new k) so the ladder stays untwisted. Both
+        // frames are swapped; only the active one is meaningful.
+        if (noKnee1 && !noKnee2 && Bmul2 < 0.0) {
+            // Swap only the ACTIVE frame's variables - the inactive frame's
+            // are uninitialized and must not be read.
+            if (isFreeRotation) {
+                vec3 tRw1 = worldK1; worldK1 = worldIK1; worldIK1 = tRw1; worldB1 = worldK1;
+            } else {
+                vec2 tRl1 = k1; k1 = IK1; IK1 = tRl1; b1 = k1;
+            }
+            Bmul1 = Bmul2;
+        }
+        if (noKnee2 && !noKnee1 && Bmul1 < 0.0) {
+            if (isFreeRotation) {
+                vec3 tRw2 = worldK2; worldK2 = worldIK2; worldIK2 = tRw2; worldB2 = worldK2;
+            } else {
+                vec2 tRl2 = k2; k2 = IK2; IK2 = tRl2; b2 = k2;
+            }
+            Bmul2 = Bmul1;
+        }
+
         // V coords: V at outer knee (k) = (Bmul + 1) * 0.5; inner = 1 - outer.
         float Vtop1 = (Bmul1 + 1.0) * 0.5;
         float Vbot1 = 1.0 - Vtop1;
@@ -1006,7 +1129,10 @@ void main() {
 
         // Free projects the world-space vertex through MVP directly; Faced
         // reconstructs clip space from aspect-corrected NDC.
-        if (isFreeRotation) {
+        if (stripDegenerate) {
+            // #236: sub-visual segment - discard the pair entirely.
+            gl_Position = vec4(2.0, 2.0, 2.0, 1.0);
+        } else if (isFreeRotation) {
             gl_Position = mvpMatrix * vec4(vertPos3D, 1.0);
         } else if (nearPlaneClipped) {
             gl_Position = vec4(2.0, 2.0, 2.0, 1.0);
@@ -1031,6 +1157,9 @@ void main() {
 
     // Meta M1: the packedColor u32 LE bytes ARE the normalized RGBA sample.
     vColor = fetchMeta(baseTexel + 1.0);
+    // HDR color scale S (RGBS, bloom TDD #175 §13.12): a plain float at offset+60,
+    // read directly from the float DATA texture (t3.a) like gridIndex. S=1 → no-op.
+    vColor.rgb *= t3.a;
 
     // Meta M2: gridConfig — [gridW lo, gridW hi, gridH lo, gridH hi].
     vec4 m2 = fetchMeta(baseTexel + 2.0);
@@ -1077,7 +1206,23 @@ void main() {
 
     mat4 mvpMatrix = uViewProjMatrix * uModelMatrix;
     vec3 worldPos = position + posDisp;
-    gl_Position = mvpMatrix * vec4(worldPos.xy, 0.0, 1.0);
+    gl_Position = mvpMatrix * vec4(worldPos, 1.0);
+
+    // v1.0-parity near-plane culling for the perspective projection: the
+    // whole quad is discarded when ANY of its 4 corners is behind the near
+    // plane (w < 0.01 == pos.z > 0.99 * z_cam in PerspectiveProjection
+    // terms). w is linear in position, so the corner minimum comes from the
+    // w-row and the corner offsets (x in {-ox, 1-ox}, y in {-oy, 1-oy}).
+    // Without a projection every w is 1.0 and this is a no-op.
+    vec4 wRow = vec4(mvpMatrix[0].w, mvpMatrix[1].w, mvpMatrix[2].w, mvpMatrix[3].w);
+    float wx = dot(wRow.xyz, xaxis);
+    float wy = dot(wRow.xyz, yaxis);
+    float minW = dot(wRow.xyz, position) + wRow.w
+        - origin.x * wx + min(wx, 0.0)
+        - origin.y * wy + min(wy, 0.0);
+    if (minW < 0.01) {
+        gl_Position = vec4(2.0, 2.0, 2.0, 1.0);
+    }
 
     // Texture coordinates with grid + atlas remap
     vec2 baseTexCoord = texCoordOf(corner);
@@ -1152,7 +1297,7 @@ void main() {
     // world alpha scales the whole RGBA (mirror of the ES 3.00 shader).
     gl_FragColor = texColor * vColor * uWorldAlpha;
 }
-`, S = class S {
+`, A = class A {
   constructor(e, t) {
     n(this, "neutrino");
     // On a WebGL1 context this actually holds a WebGLRenderingContext; the
@@ -1165,7 +1310,7 @@ void main() {
     n(this, "_vao", null);
     // WebGL1 render path state (TDD_js-v1.1-webgl1.md)
     n(this, "_isWebGL1", !1);
-    n(this, "_maxBatchTextures", S.MAX_BATCH_TEXTURES);
+    n(this, "_maxBatchTextures", A.MAX_BATCH_TEXTURES);
     n(this, "_hasElementIndexUint", !1);
     n(this, "_vaoExt", null);
     n(this, "_aIdBuffer", null);
@@ -1325,7 +1470,7 @@ void main() {
     const r = e.getParameter(e.MAX_COMBINED_TEXTURE_IMAGE_UNITS), o = e.getParameter(e.MAX_TEXTURE_IMAGE_UNITS);
     this._maxBatchTextures = Math.max(
       1,
-      Math.min(S.MAX_BATCH_TEXTURES, r - 2, o)
+      Math.min(A.MAX_BATCH_TEXTURES, r - 2, o)
     );
   }
   /**
@@ -1354,29 +1499,29 @@ void main() { gl_FragColor = vC; }
     e.activeTexture(e.TEXTURE0);
     const u = e.getParameter(e.TEXTURE_BINDING_2D);
     e.activeTexture(e.TEXTURE1);
-    const _ = e.getParameter(e.TEXTURE_BINDING_2D), U = e.isEnabled(e.BLEND), E = e.isEnabled(e.DEPTH_TEST), I = e.isEnabled(e.SCISSOR_TEST);
-    let x = null, b = null, B = null, p = null, v = null, T = null, d = -1, w = !1, f = null, h = 4, y = 0, g = 0, P = 0, D = !1, A = !1;
-    const m = new Uint8Array(4);
+    const _ = e.getParameter(e.TEXTURE_BINDING_2D), y = e.isEnabled(e.BLEND), E = e.isEnabled(e.DEPTH_TEST), I = e.isEnabled(e.SCISSOR_TEST);
+    let m = null, w = null, B = null, f = null, v = null, g = null, d = -1, b = !1, x = null, h = 4, U = 0, p = 0, R = 0, D = !1, S = !1;
+    const T = new Uint8Array(4);
     try {
-      x = e.createProgram(), e.attachShader(x, this._compileShader(e.VERTEX_SHADER, t)), e.attachShader(x, this._compileShader(e.FRAGMENT_SHADER, a)), e.linkProgram(x);
-      const C = (R, F) => {
+      m = e.createProgram(), e.attachShader(m, this._compileShader(e.VERTEX_SHADER, t)), e.attachShader(m, this._compileShader(e.FRAGMENT_SHADER, a)), e.linkProgram(m);
+      const C = (P, F) => {
         const M = e.createTexture();
-        return e.bindTexture(e.TEXTURE_2D, M), e.texParameteri(e.TEXTURE_2D, e.TEXTURE_MIN_FILTER, e.NEAREST), e.texParameteri(e.TEXTURE_2D, e.TEXTURE_MAG_FILTER, e.NEAREST), e.texParameteri(e.TEXTURE_2D, e.TEXTURE_WRAP_S, e.CLAMP_TO_EDGE), e.texParameteri(e.TEXTURE_2D, e.TEXTURE_WRAP_T, e.CLAMP_TO_EDGE), e.texImage2D(e.TEXTURE_2D, 0, e.RGBA, 1, 1, 0, e.RGBA, R, F), M;
+        return e.bindTexture(e.TEXTURE_2D, M), e.texParameteri(e.TEXTURE_2D, e.TEXTURE_MIN_FILTER, e.NEAREST), e.texParameteri(e.TEXTURE_2D, e.TEXTURE_MAG_FILTER, e.NEAREST), e.texParameteri(e.TEXTURE_2D, e.TEXTURE_WRAP_S, e.CLAMP_TO_EDGE), e.texParameteri(e.TEXTURE_2D, e.TEXTURE_WRAP_T, e.CLAMP_TO_EDGE), e.texImage2D(e.TEXTURE_2D, 0, e.RGBA, 1, 1, 0, e.RGBA, P, F), M;
       };
-      e.activeTexture(e.TEXTURE0), b = C(e.FLOAT, new Float32Array([1, 0.5, 0.25, 1])), B = C(e.UNSIGNED_BYTE, new Uint8Array([51, 102, 153, 255])), p = e.createTexture(), e.bindTexture(e.TEXTURE_2D, p), e.texImage2D(e.TEXTURE_2D, 0, e.RGBA, 1, 1, 0, e.RGBA, e.UNSIGNED_BYTE, null), v = e.createFramebuffer(), e.bindFramebuffer(e.FRAMEBUFFER, v), e.framebufferTexture2D(e.FRAMEBUFFER, e.COLOR_ATTACHMENT0, e.TEXTURE_2D, p, 0), T = e.createBuffer(), e.bindBuffer(e.ARRAY_BUFFER, T), e.bufferData(e.ARRAY_BUFFER, new Float32Array([0]), e.STATIC_DRAW), A = e.getProgramParameter(x, e.LINK_STATUS), A && (e.useProgram(x), e.activeTexture(e.TEXTURE0), e.bindTexture(e.TEXTURE_2D, b), e.activeTexture(e.TEXTURE1), e.bindTexture(e.TEXTURE_2D, B), e.uniform1i(e.getUniformLocation(x, "uF"), 0), e.uniform1i(e.getUniformLocation(x, "uB"), 1), d = e.getAttribLocation(x, "aId"), w = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_ENABLED), f = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING), h = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_SIZE), y = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_TYPE), D = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_NORMALIZED), g = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_STRIDE), P = e.getVertexAttribOffset(d, e.VERTEX_ATTRIB_ARRAY_POINTER), e.enableVertexAttribArray(d), e.vertexAttribPointer(d, 1, e.FLOAT, !1, 0, 0), e.viewport(0, 0, 1, 1), e.disable(e.BLEND), e.disable(e.DEPTH_TEST), e.disable(e.SCISSOR_TEST), e.drawArrays(e.POINTS, 0, 1), e.readPixels(0, 0, 1, 1, e.RGBA, e.UNSIGNED_BYTE, m), A = Math.abs(m[0] - 51) <= 2 && Math.abs(m[1] - 51) <= 2 && Math.abs(m[2] - 38) <= 2);
+      e.activeTexture(e.TEXTURE0), w = C(e.FLOAT, new Float32Array([1, 0.5, 0.25, 1])), B = C(e.UNSIGNED_BYTE, new Uint8Array([51, 102, 153, 255])), f = e.createTexture(), e.bindTexture(e.TEXTURE_2D, f), e.texImage2D(e.TEXTURE_2D, 0, e.RGBA, 1, 1, 0, e.RGBA, e.UNSIGNED_BYTE, null), v = e.createFramebuffer(), e.bindFramebuffer(e.FRAMEBUFFER, v), e.framebufferTexture2D(e.FRAMEBUFFER, e.COLOR_ATTACHMENT0, e.TEXTURE_2D, f, 0), g = e.createBuffer(), e.bindBuffer(e.ARRAY_BUFFER, g), e.bufferData(e.ARRAY_BUFFER, new Float32Array([0]), e.STATIC_DRAW), S = e.getProgramParameter(m, e.LINK_STATUS), S && (e.useProgram(m), e.activeTexture(e.TEXTURE0), e.bindTexture(e.TEXTURE_2D, w), e.activeTexture(e.TEXTURE1), e.bindTexture(e.TEXTURE_2D, B), e.uniform1i(e.getUniformLocation(m, "uF"), 0), e.uniform1i(e.getUniformLocation(m, "uB"), 1), d = e.getAttribLocation(m, "aId"), b = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_ENABLED), x = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING), h = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_SIZE), U = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_TYPE), D = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_NORMALIZED), p = e.getVertexAttrib(d, e.VERTEX_ATTRIB_ARRAY_STRIDE), R = e.getVertexAttribOffset(d, e.VERTEX_ATTRIB_ARRAY_POINTER), e.enableVertexAttribArray(d), e.vertexAttribPointer(d, 1, e.FLOAT, !1, 0, 0), e.viewport(0, 0, 1, 1), e.disable(e.BLEND), e.disable(e.DEPTH_TEST), e.disable(e.SCISSOR_TEST), e.drawArrays(e.POINTS, 0, 1), e.readPixels(0, 0, 1, 1, e.RGBA, e.UNSIGNED_BYTE, T), S = Math.abs(T[0] - 51) <= 2 && Math.abs(T[1] - 51) <= 2 && Math.abs(T[2] - 38) <= 2);
     } finally {
-      d >= 0 && (f && (e.bindBuffer(e.ARRAY_BUFFER, f), e.vertexAttribPointer(
+      d >= 0 && (x && (e.bindBuffer(e.ARRAY_BUFFER, x), e.vertexAttribPointer(
         d,
         h,
-        y,
+        U,
         D,
-        g,
-        P
-      )), w ? e.enableVertexAttribArray(d) : e.disableVertexAttribArray(d)), v && e.deleteFramebuffer(v), p && e.deleteTexture(p), b && e.deleteTexture(b), B && e.deleteTexture(B), T && e.deleteBuffer(T), x && e.deleteProgram(x), e.bindFramebuffer(e.FRAMEBUFFER, c), e.bindBuffer(e.ARRAY_BUFFER, l), e.useProgram(o), e.activeTexture(e.TEXTURE0), e.bindTexture(e.TEXTURE_2D, u), e.activeTexture(e.TEXTURE1), e.bindTexture(e.TEXTURE_2D, _), e.activeTexture(i), U && e.enable(e.BLEND), E && e.enable(e.DEPTH_TEST), I && e.enable(e.SCISSOR_TEST), e.viewport(r[0], r[1], r[2], r[3]);
+        p,
+        R
+      )), b ? e.enableVertexAttribArray(d) : e.disableVertexAttribArray(d)), v && e.deleteFramebuffer(v), f && e.deleteTexture(f), w && e.deleteTexture(w), B && e.deleteTexture(B), g && e.deleteBuffer(g), m && e.deleteProgram(m), e.bindFramebuffer(e.FRAMEBUFFER, c), e.bindBuffer(e.ARRAY_BUFFER, l), e.useProgram(o), e.activeTexture(e.TEXTURE0), e.bindTexture(e.TEXTURE_2D, u), e.activeTexture(e.TEXTURE1), e.bindTexture(e.TEXTURE_2D, _), e.activeTexture(i), y && e.enable(e.BLEND), E && e.enable(e.DEPTH_TEST), I && e.enable(e.SCISSOR_TEST), e.viewport(r[0], r[1], r[2], r[3]);
     }
-    if (!A)
+    if (!S)
       throw new Error(
-        `NeutrinoParticles (js-v1.1): WebGL1 vertex texture fetch smoke test failed (got ${m[0]},${m[1]},${m[2]}); WebGL2 or WebGL1 with working vertex float textures is required.`
+        `NeutrinoParticles (js-v1.1): WebGL1 vertex texture fetch smoke test failed (got ${T[0]},${T[1]},${T[2]}); WebGL2 or WebGL1 with working vertex float textures is required.`
       );
   }
   _initShader() {
@@ -1384,7 +1529,7 @@ void main() { gl_FragColor = vC; }
     if (this._shaderProgram = e.createProgram(), e.attachShader(this._shaderProgram, r), e.attachShader(this._shaderProgram, o), e.linkProgram(this._shaderProgram), !e.getProgramParameter(this._shaderProgram, e.LINK_STATUS))
       throw new Error("Shader link error: " + e.getProgramInfoLog(this._shaderProgram));
     e.deleteShader(r), e.deleteShader(o), this._uDataTexture = e.getUniformLocation(this._shaderProgram, "uDataTexture"), this._uCameraRight = e.getUniformLocation(this._shaderProgram, "uCameraRight"), this._uCameraUp = e.getUniformLocation(this._shaderProgram, "uCameraUp"), this._uCameraDir = e.getUniformLocation(this._shaderProgram, "uCameraDir"), this._uViewProjMatrix = e.getUniformLocation(this._shaderProgram, "uViewProjMatrix"), this._uModelMatrix = e.getUniformLocation(this._shaderProgram, "uModelMatrix"), this._uViewportAspect = e.getUniformLocation(this._shaderProgram, "uViewportAspect"), this._uWorldAlpha = e.getUniformLocation(this._shaderProgram, "uWorldAlpha"), this._isWebGL1 ? (this._uMetaTexture = e.getUniformLocation(this._shaderProgram, "uMetaTexture"), this._uDataTexSize = e.getUniformLocation(this._shaderProgram, "uDataTexSize"), this._aIdLocation = e.getAttribLocation(this._shaderProgram, "aId")) : this._uDataTextureWidth = e.getUniformLocation(this._shaderProgram, "uDataTextureWidth"), this._uTextures = [], this._uTexRemaps = [];
-    for (let l = 0; l < S.MAX_BATCH_TEXTURES; l++)
+    for (let l = 0; l < A.MAX_BATCH_TEXTURES; l++)
       this._uTextures.push(e.getUniformLocation(this._shaderProgram, `uTextures[${l}]`)), this._uTexRemaps.push(e.getUniformLocation(this._shaderProgram, `uTexRemaps[${l}]`));
   }
   _compileShader(e, t) {
@@ -1396,8 +1541,8 @@ void main() { gl_FragColor = vC; }
     return r;
   }
 };
-n(S, "MAX_BATCH_TEXTURES", 8);
-let NeutrinoContext = S;
+n(A, "MAX_BATCH_TEXTURES", 8);
+let NeutrinoContext = A;
 class GamePlugin extends Phaser.Plugins.BasePlugin {
   constructor() {
     super(...arguments);
@@ -1729,6 +1874,9 @@ class DrawBatch {
 class NeutrinoRenderer {
   constructor() {
     n(this, "_orthoMatrix", new Float32Array(16));
+    n(this, "_perspMatrix", new Float32Array(16));
+    n(this, "_vpMatrix", new Float32Array(16));
+    n(this, "_projFrame", { x: 0, y: 0, width: 0, height: 0 });
     n(this, "_modelMatrix", new Float32Array(16));
     n(this, "_texSlotMap", /* @__PURE__ */ new Map());
     n(this, "_batchPool");
@@ -1739,66 +1887,70 @@ class NeutrinoRenderer {
   }
   render(e, t, a, r, o, l, c) {
     if (l === 0) return;
-    const i = e.gl, u = e.isWebGL1, _ = e.maxBatchTextures, U = c.renderStyles, E = c.materials, I = u ? t.meta : null;
+    const i = e.gl, u = e.isWebGL1, _ = e.maxBatchTextures, y = c.renderStyles, E = c.materials, I = u ? t.meta : null;
     I && I.build(r, l), this._batchCount = 0;
-    const x = this._texSlotMap;
+    const m = this._texSlotMap;
     for (; this._batchPool.length < o.length; )
       this._batchPool.push(new DrawBatch());
-    let b = 0;
-    for (; b < o.length; ) {
-      const p = this._batchPool[this._batchCount];
-      p.reset(), p.blendMode = this._resolveBlend(o[b].blendMode, E), p.startParticle = o[b].startParticleIndex, x.clear();
-      let v = b;
-      for (; v < o.length && this._resolveBlend(o[v].blendMode, E) === p.blendMode; ) {
-        const T = U[o[v].renderStyleIndex].textureIndices[0];
-        if (!x.has(T)) {
-          if (x.size >= _) break;
-          const f = x.size;
-          x.set(T, f), p.glTextures[f] = c.glTextures[T] || null, p.remaps[f] = c.remaps[T] || null, p.numTextures = f + 1;
+    let w = 0;
+    for (; w < o.length; ) {
+      const f = this._batchPool[this._batchCount];
+      f.reset(), f.blendMode = this._resolveBlend(o[w].blendMode, E), f.startParticle = o[w].startParticleIndex, m.clear();
+      let v = w;
+      for (; v < o.length && this._resolveBlend(o[v].blendMode, E) === f.blendMode; ) {
+        const g = y[o[v].renderStyleIndex].textureIndices[0];
+        if (!m.has(g)) {
+          if (m.size >= _) break;
+          const x = m.size;
+          m.set(g, x), f.glTextures[x] = c.glTextures[g] || null, f.remaps[x] = c.remaps[g] || null, f.numTextures = x + 1;
         }
-        const d = x.get(T), w = o[v];
+        const d = m.get(g), b = o[v];
         if (I)
-          I.patchSlot(w.startParticleIndex, w.numParticles, d);
-        else
-          for (let f = 0; f < w.numParticles; f++) {
-            const h = (w.startParticleIndex + f) * BYTES_PER_PARTICLE, y = a.getUint32(h, !0);
-            a.setUint32(h, y & 4294967040 | d, !0);
+          I.patchSlot(b.startParticleIndex, b.numParticles, d);
+        else if (d !== 0)
+          for (let x = 0; x < b.numParticles; x++) {
+            const h = (b.startParticleIndex + x) * BYTES_PER_PARTICLE, U = a.getUint32(h, !0);
+            a.setUint32(h, U & 4294967040 | d, !0);
           }
-        p.numParticles += w.numParticles, v++;
+        f.numParticles += b.numParticles, v++;
       }
-      this._batchCount++, b = v;
+      this._batchCount++, w = v;
     }
     const B = i.isEnabled(i.SCISSOR_TEST);
     try {
       if (i.disable(i.DEPTH_TEST), i.disable(i.STENCIL_TEST), i.disable(i.SCISSOR_TEST), i.disable(i.CULL_FACE), i.depthMask(!1), i.colorMask(!0, !0, !0, !0), i.useProgram(e.shaderProgram), u) {
-        const g = t;
-        g.upload(l, DATA_TEXTURE_UNIT, META_TEXTURE_UNIT), i.uniform1i(e.uDataTexture, DATA_TEXTURE_UNIT), i.uniform1i(e.uMetaTexture, META_TEXTURE_UNIT), i.uniform2f(e.uDataTexSize, g.textureWidth, g.textureHeight);
+        const p = t;
+        p.upload(l, DATA_TEXTURE_UNIT, META_TEXTURE_UNIT), i.uniform1i(e.uDataTexture, DATA_TEXTURE_UNIT), i.uniform1i(e.uMetaTexture, META_TEXTURE_UNIT), i.uniform2f(e.uDataTexSize, p.textureWidth, p.textureHeight);
       } else {
-        const g = t;
-        g.uploadAndBind(DATA_TEXTURE_UNIT), i.uniform1i(e.uDataTexture, DATA_TEXTURE_UNIT), i.uniform1i(e.uDataTextureWidth, g.textureWidth);
+        const p = t;
+        p.uploadAndBind(DATA_TEXTURE_UNIT), i.uniform1i(e.uDataTexture, DATA_TEXTURE_UNIT), i.uniform1i(e.uDataTextureWidth, p.textureWidth);
       }
       i.uniform3f(e.uCameraRight, 1, 0, 0), i.uniform3f(e.uCameraUp, 0, -1, 0), i.uniform3f(e.uCameraDir, 0, 0, -1);
-      const p = c.viewportWidth, v = c.viewportHeight, T = c.zoom || 1, d = this._orthoMatrix;
-      d.fill(0), d[0] = 2 / p * T, d[5] = -2 / v * T, d[10] = 1, d[15] = 1, d[12] = -1 - 2 / p * T * c.scrollX, d[13] = 1 + 2 / v * T * c.scrollY, i.uniformMatrix4fv(e.uViewProjMatrix, !1, d);
-      const w = v > 0 ? p / v : 1;
-      e.uViewportAspect && i.uniform1f(e.uViewportAspect, w), e.uWorldAlpha && i.uniform1f(e.uWorldAlpha, c.worldAlpha);
-      const f = c.model, h = this._modelMatrix;
-      h[0] = f.a, h[1] = f.b, h[2] = 0, h[3] = 0, h[4] = f.c, h[5] = f.d, h[6] = 0, h[7] = 0, h[8] = 0, h[9] = 0, h[10] = 1, h[11] = 0, h[12] = f.tx, h[13] = f.ty, h[14] = 0, h[15] = 1, i.uniformMatrix4fv(e.uModelMatrix, !1, h), u ? (e.unbindVao(), i.bindBuffer(i.ARRAY_BUFFER, e.aIdBuffer), i.enableVertexAttribArray(e.aIdLocation), i.vertexAttribPointer(e.aIdLocation, 1, i.FLOAT, !1, 0, 0), i.bindBuffer(i.ELEMENT_ARRAY_BUFFER, e.indexBuffer)) : i.bindVertexArray(e.vao);
-      const y = u ? PARTICLE_TEXTURE_START_UNIT_GL1 : PARTICLE_TEXTURE_START_UNIT;
+      const f = c.viewportWidth, v = c.viewportHeight, g = c.zoom || 1, d = this._orthoMatrix;
+      if (d.fill(0), d[0] = 2 / f * g, d[5] = -2 / v * g, d[10] = 0, d[15] = 1, d[12] = -1 - 2 / f * g * c.scrollX, d[13] = 1 + 2 / v * g * c.scrollY, c.projection) {
+        const p = this._projFrame;
+        p.x = 0, p.y = 0, p.width = f, p.height = v, c.projection.setScreenFrame(p), c.projection.writeMatrix(this._perspMatrix), this._mulMatrix(this._vpMatrix, d, this._perspMatrix), i.uniformMatrix4fv(e.uViewProjMatrix, !1, this._vpMatrix);
+      } else
+        i.uniformMatrix4fv(e.uViewProjMatrix, !1, d);
+      const b = v > 0 ? f / v : 1;
+      e.uViewportAspect && i.uniform1f(e.uViewportAspect, b), e.uWorldAlpha && i.uniform1f(e.uWorldAlpha, c.worldAlpha);
+      const x = c.model, h = this._modelMatrix;
+      h[0] = x.a, h[1] = x.b, h[2] = 0, h[3] = 0, h[4] = x.c, h[5] = x.d, h[6] = 0, h[7] = 0, h[8] = 0, h[9] = 0, h[10] = 1, h[11] = 0, h[12] = x.tx, h[13] = x.ty, h[14] = 0, h[15] = 1, i.uniformMatrix4fv(e.uModelMatrix, !1, h), u ? (e.unbindVao(), i.bindBuffer(i.ARRAY_BUFFER, e.aIdBuffer), i.enableVertexAttribArray(e.aIdLocation), i.vertexAttribPointer(e.aIdLocation, 1, i.FLOAT, !1, 0, 0), i.bindBuffer(i.ELEMENT_ARRAY_BUFFER, e.indexBuffer)) : i.bindVertexArray(e.vao);
+      const U = u ? PARTICLE_TEXTURE_START_UNIT_GL1 : PARTICLE_TEXTURE_START_UNIT;
       i.enable(i.BLEND);
-      for (let g = 0; g < this._batchCount; g++) {
-        const P = this._batchPool[g];
-        this._applyBlendMode(i, P.blendMode);
-        for (let m = 0; m < P.numTextures; m++) {
-          const C = y + m;
-          i.activeTexture(i.TEXTURE0 + C), i.bindTexture(i.TEXTURE_2D, P.glTextures[m]), i.uniform1i(e.uTextures[m], C);
-          const R = P.remaps[m];
-          R ? i.uniform4f(e.uTexRemaps[m], R.x, R.y, R.width, R.height) : i.uniform4f(e.uTexRemaps[m], 0, 0, 1, 1);
+      for (let p = 0; p < this._batchCount; p++) {
+        const R = this._batchPool[p];
+        this._applyBlendMode(i, R.blendMode);
+        for (let T = 0; T < R.numTextures; T++) {
+          const C = U + T;
+          i.activeTexture(i.TEXTURE0 + C), i.bindTexture(i.TEXTURE_2D, R.glTextures[T]), i.uniform1i(e.uTextures[T], C);
+          const P = R.remaps[T];
+          P ? i.uniform4f(e.uTexRemaps[T], P.x, P.y, P.width, P.height) : i.uniform4f(e.uTexRemaps[T], 0, 0, 1, 1);
         }
-        const D = P.startParticle * 6, A = P.numParticles * 6;
+        const D = R.startParticle * 6, S = R.numParticles * 6;
         i.drawElements(
           i.TRIANGLES,
-          A,
+          S,
           e.indexType,
           D * (e.indexType === i.UNSIGNED_INT ? 4 : 2)
         );
@@ -1813,6 +1965,13 @@ class NeutrinoRenderer {
   // materials[], NOT the blend itself — without this deref a single-material effect
   // (materialIndex 0) would always render as materials[0]'s slot 0 (Normal). Falls back to
   // the raw value if materials is missing/out of range (mirror of cocos _resolveBlendMode).
+  // Column-major 4x4 multiply: out = a * b. Preallocated outputs only.
+  _mulMatrix(e, t, a) {
+    for (let r = 0; r < 16; r += 4) {
+      const o = a[r], l = a[r + 1], c = a[r + 2], i = a[r + 3];
+      e[r] = t[0] * o + t[4] * l + t[8] * c + t[12] * i, e[r + 1] = t[1] * o + t[5] * l + t[9] * c + t[13] * i, e[r + 2] = t[2] * o + t[6] * l + t[10] * c + t[14] * i, e[r + 3] = t[3] * o + t[7] * l + t[11] * c + t[15] * i;
+    }
+  }
   _resolveBlend(e, t) {
     return t && e >= 0 && e < t.length ? t[e] : e;
   }
@@ -1858,6 +2017,8 @@ class Effect extends Phaser.GameObjects.GameObject {
     n(this, "alpha", 1);
     n(this, "depth", 0);
     n(this, "blendMode", Phaser.BlendModes.NORMAL);
+    /** Optional v1.0-parity perspective projection (Projection3D). */
+    n(this, "projection");
     n(this, "_dataTextureManager", null);
     n(this, "_worldPosition");
     n(this, "_worldScaledPosition");
@@ -1867,7 +2028,7 @@ class Effect extends Phaser.GameObjects.GameObject {
     n(this, "_tempMatrix2");
     n(this, "_unpauseOnUpdateRender");
     n(this, "_glTexturesScratch", []);
-    this.gamePlugin = a.plugins.get("neutrino"), this.effectModel = t, this.x = r.position[0], this.y = r.position[1], this.z = r.position[2], this.angle = r.angle, this.scaleX = r.scale, this.scaleY = r.scale, this._worldPosition = new Phaser.Math.Vector2(), this._worldScaledPosition = [0, 0, 0], this._worldScale = 1, this._tempMatrix1 = new Phaser.GameObjects.Components.TransformMatrix(), this._tempMatrix2 = new Phaser.GameObjects.Components.TransformMatrix(), this._unpauseOnUpdateRender = r.pause === Pause.BEFORE_UPDATE_OR_RENDER, this._updateWorldTransform();
+    this.gamePlugin = a.plugins.get("neutrino"), this.effectModel = t, this.x = r.position[0], this.y = r.position[1], this.z = r.position[2], this.angle = r.angle, this.scaleX = r.scale, this.scaleY = r.scale, this.projection = r.projection, this._worldPosition = new Phaser.Math.Vector2(), this._worldScaledPosition = [0, 0, 0], this._worldScale = 1, this._tempMatrix1 = new Phaser.GameObjects.Components.TransformMatrix(), this._tempMatrix2 = new Phaser.GameObjects.Components.TransformMatrix(), this._unpauseOnUpdateRender = r.pause === Pause.BEFORE_UPDATE_OR_RENDER, this._updateWorldTransform();
     const o = {
       paused: r.pause !== Pause.NO,
       generatorsPaused: r.generatorsPaused
@@ -1906,7 +2067,7 @@ class Effect extends Phaser.GameObjects.GameObject {
     _.length = u;
     for (let E = 0; E < u; ++E)
       _[E] = this.effectModel.glTexture(E);
-    const U = this._worldScale;
+    const y = this._worldScale;
     try {
       sharedRenderer.render(
         o,
@@ -1916,13 +2077,14 @@ class Effect extends Phaser.GameObjects.GameObject {
         c,
         i,
         {
-          model: { a: U, b: 0, c: 0, d: U, tx: 0, ty: 0 },
+          model: { a: y, b: 0, c: 0, d: y, tx: 0, ty: 0 },
           viewportWidth: t.width,
           viewportHeight: t.height,
           scrollX: r.scrollX * this.scrollFactorX,
           scrollY: r.scrollY * this.scrollFactorY,
           zoom: r.zoom,
           worldAlpha: this.alpha,
+          projection: this.projection,
           glTextures: _,
           remaps: this.effectModel.texturesRemap,
           renderStyles: this.effect.model.renderStyles,
@@ -1960,6 +2122,19 @@ class Effect extends Phaser.GameObjects.GameObject {
   setPropertyInAllEmitters(t, a) {
     this.ready && this.effect.setPropertyInAllEmitters(t, a);
   }
+  setPropertyInEmitter(t, a, r) {
+    this.ready && this.effect.setPropertyInEmitter(t, a, r);
+  }
+  getEmitterPropertyValue(t, a) {
+    if (this.ready)
+      return a === void 0 ? this.effect.getEmitterPropertyValue(t) : this.effect.getEmitterPropertyValue(t, a);
+  }
+  hasEmitterProperty(t, a) {
+    return this.ready ? a === void 0 ? this.effect.hasEmitterProperty(t) : this.effect.hasEmitterProperty(t, a) : !1;
+  }
+  getEmitterProperties() {
+    return this.ready ? this.effect.getEmitterProperties() : [];
+  }
   getNumParticles() {
     return this.ready ? this.effect.getNumParticles() : 0;
   }
@@ -2063,6 +2238,19 @@ class PerspectiveProjection {
   _getScale(e) {
     return this._z / (this._z - e[2]);
   }
+  /**
+   * Writes the projection as a 4x4 column-major matrix operating in screen
+   * space, for the GPU render path. Homogeneous equivalent of
+   * transformPosition(): clip.xy = p.xy - center * (p.z / z),
+   * clip.w = 1 - p.z / z; the z row is zeroed (no depth on this path).
+   * setScreenFrame() must have been called before.
+   *
+   * @param {Float32Array} out 16-element column-major output matrix.
+   */
+  writeMatrix(e) {
+    const t = this._z, a = Number.isFinite(t) && t > 0 ? 1 / t : 0;
+    e.fill(0), e[0] = 1, e[5] = 1, e[8] = -this._screenPosX * a, e[9] = -this._screenPosY * a, e[11] = -a, e[15] = 1;
+  }
 }
 let _installed = !1;
 function installPlugin() {