@woosh/meep-engine 2.167.0 → 2.168.0

package/package.json

@@ -1,95 +1,95 @@
-{
-  "name": "@woosh/meep-engine",
-  "license": "UNLICENSED",
-  "productName": "Meep",
-  "homepage": "https://meep.company-named.com/",
-  "description": "Pure JavaScript game engine. Fully featured and production ready.",
-  "type": "module",
-  "author": "Alexander Goldring",
-  "version": "2.167.0",
-  "main": "build/meep.module.js",
-  "module": "build/meep.module.js",
-  "exports": {
-    "./build/*": "./build/*",
-    "./src/*": "./src/*",
-    "./editor/*": "./editor/*",
-    "./*.md": "./*"
-  },
-  "scripts": {
-    "test:ci": "jest --config ./jest.conf.json --collectCoverage --coverageDirectory=\"./coverage\" --ci --reporters=default --reporters=jest-junit --watchAll=false",
-    "build-module": "rollup -c rollup.config.js",
-    "publish-npm": "npm publish",
-    "generate-types": "npx -p typescript tsc --project tsconfig.types.json || exit 0;"
-  },
-  "browserslist": [
-    "last 2 chrome version",
-    "last 2 firefox version",
-    "last 2 safari version"
-  ],
-  "files": [
-    "build",
-    "src",
-    "editor",
-    "samples",
-    "package.json",
-    "README.md",
-    "!src/**/*.spec.js",
-    "!editor/**/*.spec.js"
-  ],
-  "dependencies": {
-    "gl-matrix": "3.4.3",
-    "opentype.js": "1.3.3",
-    "pako": "2.0.3",
-    "robust-predicates": "3.0.2"
-  },
-  "peerDependencies": {
-    "three": ">=0.135.0"
-  },
-  "peerDependenciesMeta": {
-    "three": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@babel/core": "7.22.15",
-    "@babel/preset-env": "7.22.15",
-    "@rollup/plugin-commonjs": "25.0.2",
-    "@rollup/plugin-node-resolve": "15.1.0",
-    "@rollup/plugin-strip": "3.0.2",
-    "@rollup/plugin-terser": "0.4.3",
-    "@types/jest": "29.5.12",
-    "@types/three": "^0.135.0",
-    "babel-jest": "29.7.0",
-    "jest": "29.7.0",
-    "jest-environment-jsdom": "29.7.0",
-    "jest-junit": "16.0.0",
-    "rollup": "3.26.2",
-    "typescript": "5.2.2"
-  },
-  "keywords": [
-    "game-engine",
-    "gamedev",
-    "ecs",
-    "entity-component-system",
-    "data-oriented",
-    "zero-allocation",
-    "modular",
-    "tree-shaking",
-    "3d",
-    "webgl",
-    "webgl2",
-    "webgpu",
-    "webaudio",
-    "particles",
-    "bvh",
-    "behavior-tree",
-    "inverse-kinematics",
-    "fabrik",
-    "clustered-lighting",
-    "color-management",
-    "typescript"
-  ],
-  "engines": {
-    "node": ">=24"
-  }
-}
+{
+  "name": "@woosh/meep-engine",
+  "license": "UNLICENSED",
+  "productName": "Meep",
+  "homepage": "https://meep.company-named.com/",
+  "description": "Pure JavaScript game engine. Fully featured and production ready.",
+  "type": "module",
+  "author": "Alexander Goldring",
+  "version": "2.168.0",
+  "main": "build/meep.module.js",
+  "module": "build/meep.module.js",
+  "exports": {
+    "./build/*": "./build/*",
+    "./src/*": "./src/*",
+    "./editor/*": "./editor/*",
+    "./*.md": "./*"
+  },
+  "scripts": {
+    "test:ci": "jest --config ./jest.conf.json --collectCoverage --coverageDirectory=\"./coverage\" --ci --reporters=default --reporters=jest-junit --watchAll=false",
+    "build-module": "rollup -c rollup.config.js",
+    "publish-npm": "npm publish",
+    "generate-types": "npx -p typescript tsc --project tsconfig.types.json || exit 0;"
+  },
+  "browserslist": [
+    "last 2 chrome version",
+    "last 2 firefox version",
+    "last 2 safari version"
+  ],
+  "files": [
+    "build",
+    "src",
+    "editor",
+    "samples",
+    "package.json",
+    "README.md",
+    "!src/**/*.spec.js",
+    "!editor/**/*.spec.js"
+  ],
+  "dependencies": {
+    "gl-matrix": "3.4.3",
+    "opentype.js": "1.3.3",
+    "pako": "2.0.3",
+    "robust-predicates": "3.0.2"
+  },
+  "peerDependencies": {
+    "three": ">=0.135.0"
+  },
+  "peerDependenciesMeta": {
+    "three": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@babel/core": "7.22.15",
+    "@babel/preset-env": "7.22.15",
+    "@rollup/plugin-commonjs": "25.0.2",
+    "@rollup/plugin-node-resolve": "15.1.0",
+    "@rollup/plugin-strip": "3.0.2",
+    "@rollup/plugin-terser": "0.4.3",
+    "@types/jest": "29.5.12",
+    "@types/three": "^0.135.0",
+    "babel-jest": "29.7.0",
+    "jest": "29.7.0",
+    "jest-environment-jsdom": "29.7.0",
+    "jest-junit": "16.0.0",
+    "rollup": "3.26.2",
+    "typescript": "5.2.2"
+  },
+  "keywords": [
+    "game-engine",
+    "gamedev",
+    "ecs",
+    "entity-component-system",
+    "data-oriented",
+    "zero-allocation",
+    "modular",
+    "tree-shaking",
+    "3d",
+    "webgl",
+    "webgl2",
+    "webgpu",
+    "webaudio",
+    "particles",
+    "bvh",
+    "behavior-tree",
+    "inverse-kinematics",
+    "fabrik",
+    "clustered-lighting",
+    "color-management",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=24"
+  }
+}

package/src/engine/ecs/fow/FogOfWarEdgeMode.js

@@ -24,7 +24,8 @@ export const FogOfWarEdgeMode = {
 
     /**
      * The fog EXTENDS outward instead: the border ring mirrors the cells just
-     * inside it, and pixels with no geometry are left alone entirely.
+     * inside it, and a pixel with no geometry is located by projecting its camera
+     * ray onto the fog's own ground plane rather than read off the far plane.
      *
      * For a world with a VISIBLE boundary — a finite arena the camera can see
      * past. Under {@link FogOfWarEdgeMode.Conceal} such a scene gets a hard black

package/src/engine/ecs/fow/shader/screenSpaceFogOfWarShader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenSpaceFogOfWarShader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/fow/shader/screenSpaceFogOfWarShader.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,kDAFW,cAAc,CA4LxB;+BAjMyE,OAAO"}
+{"version":3,"file":"screenSpaceFogOfWarShader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/fow/shader/screenSpaceFogOfWarShader.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,kDAFW,cAAc,CAmNxB;+BAxNyE,OAAO"}

package/src/engine/ecs/fow/shader/screenSpaceFogOfWarShader.js

@@ -108,25 +108,48 @@ export function buildScreenSpaceFogOfWarShader() {
         void main(){
             float sceneDepth = texture2D( tDepth, vUv ).x;
 
-            // NOTHING WAS DRAWN HERE. The depth is the buffer's clear value, so
-            // the position reconstructed from it lands on the far plane: a point
-            // with no relationship to the scene, whose fog lookup is whatever the
-            // sampler's clamp happens to return. In a world with a visible
-            // boundary that is the concealed border ring, and it gets painted
-            // across the entire void as a hard rectangle on the world's edge.
-            // Under Extend, leave such a pixel alone rather than fog it on the
-            // strength of a reconstruction that means nothing.
-            //
-            // Under Conceal this branch never taken, so the legacy path is
-            // bit-identical — including the one case Extend gives up, a real
-            // surface sitting exactly on the far plane.
+            vec3 worldPosition;
+
             if (uEdgeExtend > 0.5 && sceneDepth >= 1.0) {
-                gl_FragColor = vec4(0.0);
-                return;
-            }
+                // NOTHING WAS DRAWN HERE, so there is no surface to locate: the
+                // depth is the buffer's clear value and computeWorldPosition would
+                // hand back a point on the far plane, unrelated to the scene, whose
+                // fog lookup is whatever the sampler's clamp happens to return.
+                //
+                // The fog is a GROUND field though — its sampler is indexed by
+                // world XZ and anchored at the world origin (uFogUvTransform is
+                // built from size and scale alone, with no Y term), so the
+                // meaningful position for such a pixel is where its camera ray
+                // crosses that field's own plane, y = 0.
+                //
+                // PROJECTING rather than skipping is what keeps a world boundary
+                // invisible. At the last pixel of ground the surface hit and the
+                // plane hit are the same point, so the fog value carries straight
+                // on across the edge; skipping instead steps it from whatever the
+                // edge reads to nothing at all, and that step is a visible line
+                // exactly where the world stops.
+                vec3 camPos = uViewInverse[3].xyz;
+                vec3 dir = computeWorldPosition(1.0) - camPos;
+
+                // parallel to the plane, or pointing away from it: nothing to
+                // sample, so leave the pixel alone
+                if (abs(dir.y) < 1e-6) {
+                    gl_FragColor = vec4(0.0);
+                    return;
+                }
+
+                float t = -camPos.y / dir.y;
 
-            //get world fragment position
-            vec3 worldPosition = computeWorldPosition(sceneDepth);
+                if (t <= 0.0) {
+                    gl_FragColor = vec4(0.0);
+                    return;
+                }
+
+                worldPosition = camPos + dir * t;
+            } else {
+                //get world fragment position
+                worldPosition = computeWorldPosition(sceneDepth);
+            }
 
             vec2 fogUv = worldPosition.xz * uFogUvTransform.zw + uFogUvTransform.xy;