@neutrinoparticles/js-v1.1-phaser 1.0.1 → 1.1.1

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

@@ -1,6 +1,6 @@
-var F = Object.defineProperty;
-var N = (s, e, t) => e in s ? F(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
-var n = (s, e, t) => N(s, typeof e != "symbol" ? e + "" : e, t);
+var K = Object.defineProperty;
+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
@@ -175,7 +180,7 @@ void main() {
         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.
+        // the ribbon half-width) — the pair is discarded like nearPlaneClipped.
         bool stripDegenerate = false;
 
         // Aspect correction so the 2D Faced ortho gives visually-perpendicular
@@ -261,7 +266,7 @@ void main() {
                 vec3 K2 = Kmul2 * normalize(cross(wdir12 + wdir23, n2));
                 Bmul2 = sign(dot(B2raw, K2));
                 vec3 B2 = B2raw * Bmul2;
-                // #236: see ik1 - inner vertex at the ribbon half-width.
+                // #236: see ik1 — inner vertex at the ribbon half-width.
                 float ik2 = halfSize2;
                 worldK2 = p2 + K2 * halfSize2;
                 worldB2 = p2 + B2 * halfSize2;
@@ -279,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;
@@ -333,7 +344,7 @@ void main() {
                 vec2 K2 = Kmul2 * normalize(stripOrtho(dir12 + dir23));
                 Bmul2 = sign(dot(B, K2));
                 vec2 B2 = B * Bmul2;
-                // #236: see ik1 - inner vertex at the ribbon half-width.
+                // #236: see ik1 — inner vertex at the ribbon half-width.
                 float ik2 = ndcHalfSize2;
                 k2 = ndc2 + K2 * ndcHalfSize2;
                 b2 = ndc2 + B2 * ndcHalfSize2;
@@ -349,7 +360,7 @@ void main() {
             }
         }
 
-        // #236: a noKnee (straight-cap) end carries no bend side of its own -
+        // #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
@@ -376,6 +387,7 @@ void main() {
             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
@@ -478,7 +490,7 @@ void main() {
         // Free projects the world-space vertex through MVP directly; Faced
         // reconstructs clip space from aspect-corrected NDC (mirror of preview3).
         if (stripDegenerate) {
-            // #236: sub-visual segment - discard the pair entirely.
+            // #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);
@@ -517,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);
@@ -564,13 +580,37 @@ 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];
 
-    float gx = mod(gridIndex, gridWidth);
+    // #283: gx must come from the SAME quotient as gy. GLSL mod(x,y) is
+    // x - y*floor(x/y), but the driver may evaluate its internal quotient
+    // differently from the floor() below (reciprocal-multiply / FMA). At exact
+    // multiples of gridWidth the two disagreed — mod(15,15) gave 15 while
+    // floor(15/15) gave 0 — addressing column 15 of a 15-column grid, whose U
+    // range starts at 1.0 (off the atlas), so the first cell of every row
+    // sampled the clamped transparent edge and vanished. The clamp keeps a
+    // rounding-induced gx == gridWidth inside the last column.
     float gy = floor(gridIndex / gridWidth);
+    float gx = clamp(gridIndex - gy * gridWidth, 0.0, gridWidth - 1.0);
     float cellW = 1.0 / gridWidth;
     float cellH = 1.0 / gridHeight;
 
@@ -656,6 +696,13 @@ void main() {
     else texColor = useGrad ? textureGrad(uTextures[7], atlasUV, gradX, gradY) : texture(uTextures[7], atlasUV);
 
     fragColor = texColor * vColor;
+    // Premultiply the per-particle alpha into RGB. texColor is premultiplied but
+    // vColor.a is not, and every blend func expects a premultiplied source:
+    // NORMAL (ONE, 1-src.a) would only reduce how much background shows through,
+    // ADD (ONE, ONE) would ignore alpha entirely, and MULTIPLY
+    // (DST_COLOR, 1-src.a) would brighten the destination as alpha drops instead
+    // of leaving it untouched.
+    fragColor.rgb *= vColor.a;
     // Apply host world alpha. texColor is premultiplied and the blend funcs use
     // a src factor of ONE (NORMAL) / ONE,ONE (ADD), so the whole RGBA must be
     // scaled — fading RGB, not just the alpha channel — to dim correctly in both
@@ -784,6 +831,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
@@ -919,10 +971,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;
@@ -1114,6 +1172,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);
@@ -1160,13 +1221,33 @@ 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);
 
-    float gx = mod(gridIndex, gridWidth);
+    // #283: gx must come from the SAME quotient as gy — see particle.vert.
+    // mod(x,y) and a separate floor(x/y) can disagree at exact multiples of
+    // gridWidth (mod(15,15) -> 15, floor(15/15) -> 0), which addressed a
+    // column past the grid and blanked the first cell of every row.
     float gy = floor(gridIndex / gridWidth);
+    float gx = clamp(gridIndex - gy * gridWidth, 0.0, gridWidth - 1.0);
     float cellW = 1.0 / gridWidth;
     float cellH = 1.0 / gridHeight;
 
@@ -1234,6 +1315,11 @@ void main() {
     // texColor is premultiplied and blend src factors are ONE-based, so the
     // world alpha scales the whole RGBA (mirror of the ES 3.00 shader).
     gl_FragColor = texColor * vColor * uWorldAlpha;
+    // Premultiply the per-particle alpha into RGB: vColor.a is not premultiplied,
+    // so without this ADD ignores alpha entirely, NORMAL only reduces background
+    // show-through, and MULTIPLY brightens the destination as alpha drops.
+    // Mirror of the ES 3.00 shader.
+    gl_FragColor.rgb *= vColor.a;
 }
 `, A = class A {
   constructor(e, t) {
@@ -1353,8 +1439,8 @@ void main() {
       );
     const d = l ? new Uint32Array(e * 6) : new Uint16Array(e * 6);
     for (let i = 0; i < e; i++) {
-      const u = i * 4, g = i * 6;
-      d[g + 0] = u + 0, d[g + 1] = u + 1, d[g + 2] = u + 2, d[g + 3] = u + 0, d[g + 4] = u + 2, d[g + 5] = u + 3;
+      const u = i * 4, _ = i * 6;
+      d[_ + 0] = u + 0, d[_ + 1] = u + 1, d[_ + 2] = u + 2, d[_ + 3] = u + 0, d[_ + 4] = u + 2, d[_ + 5] = u + 3;
     }
     if (this._indexBuffer = t.createBuffer(), t.bindBuffer(t.ELEMENT_ARRAY_BUFFER, this._indexBuffer), t.bufferData(t.ELEMENT_ARRAY_BUFFER, d, t.STATIC_DRAW), this._isWebGL1) {
       const i = new Float32Array(e * 4);
@@ -1437,29 +1523,29 @@ void main() { gl_FragColor = vC; }
     e.activeTexture(e.TEXTURE0);
     const u = e.getParameter(e.TEXTURE_BINDING_2D);
     e.activeTexture(e.TEXTURE1);
-    const g = e.getParameter(e.TEXTURE_BINDING_2D), I = e.isEnabled(e.BLEND), E = e.isEnabled(e.DEPTH_TEST), U = e.isEnabled(e.SCISSOR_TEST);
-    let x = null, b = null, B = null, p = null, v = null, T = null, c = -1, w = !1, f = null, h = 4, y = 0, _ = 0, P = 0, D = !1, S = !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, U = null, f = null, v = null, g = null, c = -1, b = !1, x = null, h = 4, B = 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, K) => {
+      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, K), 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), S = e.getProgramParameter(x, e.LINK_STATUS), S && (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), c = e.getAttribLocation(x, "aId"), w = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_ENABLED), f = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING), h = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_SIZE), y = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_TYPE), D = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_NORMALIZED), _ = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_STRIDE), P = e.getVertexAttribOffset(c, e.VERTEX_ATTRIB_ARRAY_POINTER), e.enableVertexAttribArray(c), e.vertexAttribPointer(c, 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), S = 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])), U = 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, U), e.uniform1i(e.getUniformLocation(m, "uF"), 0), e.uniform1i(e.getUniformLocation(m, "uB"), 1), c = e.getAttribLocation(m, "aId"), b = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_ENABLED), x = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING), h = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_SIZE), B = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_TYPE), D = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_NORMALIZED), p = e.getVertexAttrib(c, e.VERTEX_ATTRIB_ARRAY_STRIDE), R = e.getVertexAttribOffset(c, e.VERTEX_ATTRIB_ARRAY_POINTER), e.enableVertexAttribArray(c), e.vertexAttribPointer(c, 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 {
-      c >= 0 && (f && (e.bindBuffer(e.ARRAY_BUFFER, f), e.vertexAttribPointer(
+      c >= 0 && (x && (e.bindBuffer(e.ARRAY_BUFFER, x), e.vertexAttribPointer(
         c,
         h,
-        y,
+        B,
         D,
-        _,
-        P
-      )), w ? e.enableVertexAttribArray(c) : e.disableVertexAttribArray(c)), 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, d), 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, g), e.activeTexture(i), I && e.enable(e.BLEND), E && e.enable(e.DEPTH_TEST), U && e.enable(e.SCISSOR_TEST), e.viewport(r[0], r[1], r[2], r[3]);
+        p,
+        R
+      )), b ? e.enableVertexAttribArray(c) : e.disableVertexAttribArray(c)), v && e.deleteFramebuffer(v), f && e.deleteTexture(f), w && e.deleteTexture(w), U && e.deleteTexture(U), g && e.deleteBuffer(g), m && e.deleteProgram(m), e.bindFramebuffer(e.FRAMEBUFFER, d), 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 (!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() {
@@ -1812,6 +1898,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");
@@ -1822,63 +1911,67 @@ class NeutrinoRenderer {
   }
   render(e, t, a, r, o, l, d) {
     if (l === 0) return;
-    const i = e.gl, u = e.isWebGL1, g = e.maxBatchTextures, I = d.renderStyles, E = d.materials, U = u ? t.meta : null;
-    U && U.build(r, l), this._batchCount = 0;
-    const x = this._texSlotMap;
+    const i = e.gl, u = e.isWebGL1, _ = e.maxBatchTextures, y = d.renderStyles, E = d.materials, I = u ? t.meta : null;
+    I && I.build(r, l), this._batchCount = 0;
+    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 = I[o[v].renderStyleIndex].textureIndices[0];
-        if (!x.has(T)) {
-          if (x.size >= g) break;
-          const f = x.size;
-          x.set(T, f), p.glTextures[f] = d.glTextures[T] || null, p.remaps[f] = d.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] = d.glTextures[g] || null, f.remaps[x] = d.remaps[g] || null, f.numTextures = x + 1;
         }
-        const c = x.get(T), w = o[v];
-        if (U)
-          U.patchSlot(w.startParticleIndex, w.numParticles, c);
-        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 | c, !0);
+        const c = m.get(g), b = o[v];
+        if (I)
+          I.patchSlot(b.startParticleIndex, b.numParticles, c);
+        else if (c !== 0)
+          for (let x = 0; x < b.numParticles; x++) {
+            const h = (b.startParticleIndex + x) * BYTES_PER_PARTICLE, B = a.getUint32(h, !0);
+            a.setUint32(h, B & 4294967040 | c, !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);
+    const U = 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 _ = t;
-        _.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, _.textureWidth, _.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 _ = t;
-        _.uploadAndBind(DATA_TEXTURE_UNIT), i.uniform1i(e.uDataTexture, DATA_TEXTURE_UNIT), i.uniform1i(e.uDataTextureWidth, _.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 = d.viewportWidth, v = d.viewportHeight, T = d.zoom || 1, c = this._orthoMatrix;
-      c.fill(0), c[0] = 2 / p * T, c[5] = -2 / v * T, c[10] = 1, c[15] = 1, c[12] = -1 - 2 / p * T * d.scrollX, c[13] = 1 + 2 / v * T * d.scrollY, i.uniformMatrix4fv(e.uViewProjMatrix, !1, c);
-      const w = v > 0 ? p / v : 1;
-      e.uViewportAspect && i.uniform1f(e.uViewportAspect, w), e.uWorldAlpha && i.uniform1f(e.uWorldAlpha, d.worldAlpha);
-      const f = d.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 = d.viewportWidth, v = d.viewportHeight, g = d.zoom || 1, c = this._orthoMatrix;
+      if (c.fill(0), c[0] = 2 / f * g, c[5] = -2 / v * g, c[10] = 0, c[15] = 1, c[12] = -1 - 2 / f * g * d.scrollX, c[13] = 1 + 2 / v * g * d.scrollY, d.projection) {
+        const p = this._projFrame;
+        p.x = 0, p.y = 0, p.width = f, p.height = v, d.projection.setScreenFrame(p), d.projection.writeMatrix(this._perspMatrix), this._mulMatrix(this._vpMatrix, c, this._perspMatrix), i.uniformMatrix4fv(e.uViewProjMatrix, !1, this._vpMatrix);
+      } else
+        i.uniformMatrix4fv(e.uViewProjMatrix, !1, c);
+      const b = v > 0 ? f / v : 1;
+      e.uViewportAspect && i.uniform1f(e.uViewportAspect, b), e.uWorldAlpha && i.uniform1f(e.uWorldAlpha, d.worldAlpha);
+      const x = d.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 B = u ? PARTICLE_TEXTURE_START_UNIT_GL1 : PARTICLE_TEXTURE_START_UNIT;
       i.enable(i.BLEND);
-      for (let _ = 0; _ < this._batchCount; _++) {
-        const P = this._batchPool[_];
-        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 = B + 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, S = P.numParticles * 6;
+        const D = R.startParticle * 6, S = R.numParticles * 6;
         i.drawElements(
           i.TRIANGLES,
           S,
@@ -1887,7 +1980,7 @@ class NeutrinoRenderer {
         );
       }
     } finally {
-      u ? (i.disableVertexAttribArray(e.aIdLocation), i.bindBuffer(i.ARRAY_BUFFER, null), i.bindBuffer(i.ELEMENT_ARRAY_BUFFER, null)) : i.bindVertexArray(null), i.useProgram(null), B && i.enable(i.SCISSOR_TEST);
+      u ? (i.disableVertexAttribArray(e.aIdLocation), i.bindBuffer(i.ARRAY_BUFFER, null), i.bindBuffer(i.ELEMENT_ARRAY_BUFFER, null)) : i.bindVertexArray(null), i.useProgram(null), U && i.enable(i.SCISSOR_TEST);
     }
   }
   // Resolve a renderStyle's compacted material INDEX to the real blend enum (0=Normal/
@@ -1896,6 +1989,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], d = a[r + 2], i = a[r + 3];
+      e[r] = t[0] * o + t[4] * l + t[8] * d + t[12] * i, e[r + 1] = t[1] * o + t[5] * l + t[9] * d + t[13] * i, e[r + 2] = t[2] * o + t[6] * l + t[10] * d + t[14] * i, e[r + 3] = t[3] * o + t[7] * l + t[11] * d + t[15] * i;
+    }
+  }
   _resolveBlend(e, t) {
     return t && e >= 0 && e < t.length ? t[e] : e;
   }
@@ -1941,6 +2041,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");
@@ -1950,7 +2052,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
@@ -1985,11 +2087,11 @@ class Effect extends Phaser.GameObjects.GameObject {
     const d = this.effect.renderInstructions, i = d._totalParticles;
     if (i === 0) return;
     t.flush();
-    const u = this.effectModel.effectModel.textures.length, g = this._glTexturesScratch;
-    g.length = u;
+    const u = this.effectModel.effectModel.textures.length, _ = this._glTexturesScratch;
+    _.length = u;
     for (let E = 0; E < u; ++E)
-      g[E] = this.effectModel.glTexture(E);
-    const I = this._worldScale;
+      _[E] = this.effectModel.glTexture(E);
+    const y = this._worldScale;
     try {
       sharedRenderer.render(
         o,
@@ -1999,14 +2101,15 @@ class Effect extends Phaser.GameObjects.GameObject {
         d,
         i,
         {
-          model: { a: I, b: 0, c: 0, d: I, 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,
-          glTextures: g,
+          projection: this.projection,
+          glTextures: _,
           remaps: this.effectModel.texturesRemap,
           renderStyles: this.effect.model.renderStyles,
           materials: this.effect.model.materials
@@ -2043,6 +2146,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;
   }
@@ -2146,6 +2262,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() {