@woosh/meep-engine 2.169.1 → 2.169.2

package/src/engine/ecs/ik/ik_probe_terrain_contact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ik_probe_terrain_contact.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/ik/ik_probe_terrain_contact.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wLAJW,MAAM,GAEJ,MAAM,CA8ElB"}

package/src/engine/ecs/ik/ik_probe_terrain_contact.js

@@ -0,0 +1,119 @@
+import { v3_displace_in_direction } from "../../../core/geom/vec3/v3_displace_in_direction.js";
+import { v3_dot } from "../../../core/geom/vec3/v3_dot.js";
+import { v3_length } from "../../../core/geom/vec3/v3_length.js";
+import { clamp01 } from "../../../core/math/clamp01.js";
+import { inverseLerp } from "../../../core/math/inverseLerp.js";
+
+/**
+ * Find where an IK chain meets the terrain and how strongly the solver should pull towards it.
+ *
+ * Two casts are made. The first travels from `origin` towards `effector` and establishes which
+ * surface the limb is over at all. The second starts just outside that surface, directly above the
+ * effector along the surface normal, and comes back down — that is what actually locates the point
+ * under the effector rather than the point under the limb's root, and it is what `out_contact` and
+ * `out_target` describe on return.
+ *
+ * The returned influence answers "how much of this correction should apply":
+ * - the effector is BELOW the surface (penetrating) → `1`, correct it fully;
+ * - the effector HOVERS above the surface → falls off from `1` to `0` across
+ *   `constraint.distance`, measured as a fraction of `length_scale`, so the same constraint reads
+ *   the same way for a long limb and a short one;
+ * - no surface was found at all → `0`.
+ *
+ * This exists because {@link TwoBoneInverseKinematicsSolver} and
+ * {@link OneBoneSurfaceAlignmentSolver} carried the identical ~70-line probe, comments and variable
+ * names included, differing only in which lengths they scaled by. The solvers now hold nothing but
+ * their rotation math.
+ *
+ * @param {Vector3} out_target receives the world position the effector should be moved to; only
+ * written when a non-zero influence is returned
+ * @param {SurfacePoint3} out_contact receives the surface contact from the SECOND cast; only
+ * written when a non-zero influence is returned. Solvers that need the contact normal (surface
+ * alignment) read it from here
+ * @param {Terrain} terrain
+ * @param {Vector3} origin start of the limb, the root bone's world position
+ * @param {Vector3} effector world position of the bone being placed. The probe direction is
+ * `effector - origin`, so these must not coincide
+ * @param {IKConstraint} constraint supplies `offset` (how far off the surface the effector rests)
+ * and `distance` (the hover band over which influence falls off)
+ * @param {number} length_scale limb length in world units; `constraint.offset` and the hover
+ * distance are both expressed relative to it. Must be greater than 0
+ * @returns {number} influence in `[0,1]`; `0` means "do nothing"
+ */
+export function ik_probe_terrain_contact(
+    out_target,
+    out_contact,
+    terrain,
+    origin,
+    effector,
+    constraint,
+    length_scale
+) {
+
+    //check if the there is a penetration with the terrain between the two bones
+    const directionX = effector.x - origin.x;
+    const directionY = effector.y - origin.y;
+    const directionZ = effector.z - origin.z;
+
+    let contactExists = terrain.raycastFirstSync(
+        out_contact,
+        origin.x,
+        origin.y,
+        origin.z,
+        directionX,
+        directionY,
+        directionZ
+    );
+
+    if (!contactExists) {
+        //no contact
+        return 0;
+    }
+
+    const contactPosition = out_contact.position;
+    const contactNormal = out_contact.normal;
+
+    //perform secondary cast from the bone, back along the surface normal
+    contactExists = terrain.raycastFirstSync(
+        out_contact,
+        effector.x + contactNormal.x,
+        effector.y + contactNormal.y,
+        effector.z + contactNormal.z,
+        -contactNormal.x,
+        -contactNormal.y,
+        -contactNormal.z
+    );
+
+    if (!contactExists) {
+        //no contact
+        return 0;
+    }
+
+    const targetOffsetDistance = constraint.offset * length_scale;
+
+    v3_displace_in_direction(
+        out_target,
+        targetOffsetDistance,
+        contactPosition.x, contactPosition.y, contactPosition.z,
+        contactNormal.x, contactNormal.y, contactNormal.z
+    );
+
+    const delta_contact_c_x = out_target.x - effector.x;
+    const delta_contact_c_y = out_target.y - effector.y;
+    const delta_contact_c_z = out_target.z - effector.z;
+
+    //check if current effector position is above the contact point
+    const dot_contact_side = v3_dot(directionX, directionY, directionZ, delta_contact_c_x, delta_contact_c_y, delta_contact_c_z);
+
+    if (dot_contact_side < 0) {
+        //penetration detected
+        return 1;
+    }
+
+    //no penetration, hovering case, use hover distance for influence
+    const delta_contact_c_length = v3_length(delta_contact_c_x, delta_contact_c_y, delta_contact_c_z);
+
+    const normalized_effector_distance = inverseLerp(0, length_scale, delta_contact_c_length);
+
+    return 1 - clamp01(constraint.distance.normalizeValue(normalized_effector_distance));
+}

package/src/engine/ecs/terrain/util/paintTerrainOverlayViaLookupTable.d.ts

@@ -16,6 +16,5 @@ export function paintTerrainOverlayViaLookupTable({ overlay, sampler, lut, range
     channel?: number;
 }): void;
 import { Sampler2D } from "../../../graphics/texture/sampler/Sampler2D.js";
-import { ParameterLookupTable } from "../../../graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
 import { NumericInterval } from "../../../../core/math/interval/NumericInterval.js";
 //# sourceMappingURL=paintTerrainOverlayViaLookupTable.d.ts.map

package/src/engine/ecs/terrain/util/paintTerrainOverlayViaLookupTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paintTerrainOverlayViaLookupTable.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/util/paintTerrainOverlayViaLookupTable.js"],"names":[],"mappings":"AA2BA;;;;;;;;GAQG;AACH;IAPkC,OAAO;IACZ,OAAO,EAAzB,SAAS;IACqB,GAAG,GAAjC,oBAAoB;IACK,KAAK,GAA9B,eAAe;IACkB,mBAAmB,UAA3C,MAAM,KAAE,MAAM;IACP,OAAO,GAAvB,MAAM;SAiEhB;0BA7FyB,gDAAgD;qCAFrC,iFAAiF;gCADtF,mDAAmD"}
+{"version":3,"file":"paintTerrainOverlayViaLookupTable.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/util/paintTerrainOverlayViaLookupTable.js"],"names":[],"mappings":"AAeA;;;;;;;;GAQG;AACH;IAPkC,OAAO;IACZ,OAAO,EAAzB,SAAS;IACqB,GAAG;IACR,KAAK,GAA9B,eAAe;IACkB,mBAAmB,UAA3C,MAAM,KAAE,MAAM;IACP,OAAO,GAAvB,MAAM;SAiEhB;0BAjFyB,gDAAgD;gCAH1C,mDAAmD"}

package/src/engine/ecs/terrain/util/paintTerrainOverlayViaLookupTable.js

@@ -2,23 +2,11 @@ import { assert } from "../../../../core/assert.js";
 import { passThrough } from "../../../../core/function/passThrough.js";
 import { clamp01 } from "../../../../core/math/clamp01.js";
 import { NumericInterval } from "../../../../core/math/interval/NumericInterval.js";
-import { ParameterLookupTable } from "../../../graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
+import { LUT_HEATMAP } from "../../../../core/math/lookup/LUT_HEATMAP.js";
 import { sampler2d_scale } from "../../../graphics/texture/sampler/resize/sampler2d_scale.js";
 import { Sampler2D } from "../../../graphics/texture/sampler/Sampler2D.js";
 import { logger } from "../../../logging/GlobalLogger.js";
 
-
-const heatmap_lut = new ParameterLookupTable(4);
-heatmap_lut.write([
-    0, 0, 0, 255,
-    0, 0, 255, 255,
-    0, 179, 179, 255,
-    0, 255, 0, 255,
-    255, 255, 0, 255,
-    255, 5, 5, 255
-]);
-heatmap_lut.computeUniformPositions();
-
 /**
  * Color to use when sampled value is NaN
  * @type {number[]}
@@ -37,7 +25,7 @@ const NAN_COLOR = [0, 0, 0, 0];
 export function paintTerrainOverlayViaLookupTable({
                                                       overlay,
                                                       sampler,
-                                                      lut = heatmap_lut,
+                                                      lut = LUT_HEATMAP,
                                                       range = new NumericInterval(0, 1),
                                                       lookupScaleFunction = passThrough,
                                                       channel = 0

package/src/engine/graphics/FULL_SCREEN_QUAD_VERTEX_SHADER.d.ts

@@ -1,2 +1,13 @@
-export const FULL_SCREEN_QUAD_VERTEX_SHADER: "        \n        varying vec2 vUv;\n\n        void main() {\n\n            vUv = uv;\n                \n            gl_Position = vec4( (uv - 0.5)*2.0, 0.0, 1.0 );\n            \n        }";
+/**
+ * Vertex shader for a full-screen quad, NDC form: the quad's own model matrix is ignored and the
+ * position is derived from `uv` directly.
+ *
+ * This used to be a second, hand-typed copy of {@link ScreenSpaceQuadShader.vertexShader} - the
+ * same five lines of GLSL living under two different names, which made the pair impossible to spot
+ * from an import list. `ScreenSpaceQuadShader` is the home (it has more consumers and is co-located
+ * with `glsl_gen_swizzled_read`); this name is kept because it is public surface.
+ *
+ * @type {string}
+ */
+export const FULL_SCREEN_QUAD_VERTEX_SHADER: string;
 //# sourceMappingURL=FULL_SCREEN_QUAD_VERTEX_SHADER.d.ts.map

package/src/engine/graphics/FULL_SCREEN_QUAD_VERTEX_SHADER.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FULL_SCREEN_QUAD_VERTEX_SHADER.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics/FULL_SCREEN_QUAD_VERTEX_SHADER.js"],"names":[],"mappings":"AAAA,6OASW"}
+{"version":3,"file":"FULL_SCREEN_QUAD_VERTEX_SHADER.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics/FULL_SCREEN_QUAD_VERTEX_SHADER.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,6CAFU,MAAM,CAEmE"}

package/src/engine/graphics/FULL_SCREEN_QUAD_VERTEX_SHADER.js

@@ -1,10 +1,14 @@
-export const FULL_SCREEN_QUAD_VERTEX_SHADER = `        
-        varying vec2 vUv;
-
-        void main() {
-
-            vUv = uv;
-                
-            gl_Position = vec4( (uv - 0.5)*2.0, 0.0, 1.0 );
-            
-        }`;
+import { ScreenSpaceQuadShader } from "./shaders/ScreenSpaceQuadShader.js";
+
+/**
+ * Vertex shader for a full-screen quad, NDC form: the quad's own model matrix is ignored and the
+ * position is derived from `uv` directly.
+ *
+ * This used to be a second, hand-typed copy of {@link ScreenSpaceQuadShader.vertexShader} - the
+ * same five lines of GLSL living under two different names, which made the pair impossible to spot
+ * from an import list. `ScreenSpaceQuadShader` is the home (it has more consumers and is co-located
+ * with `glsl_gen_swizzled_read`); this name is kept because it is public surface.
+ *
+ * @type {string}
+ */
+export const FULL_SCREEN_QUAD_VERTEX_SHADER = ScreenSpaceQuadShader.vertexShader();

package/src/engine/graphics/ecs/camera/auto_set_camera_clipping_planes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto_set_camera_clipping_planes.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/auto_set_camera_clipping_planes.js"],"names":[],"mappings":"AAyBA;;;;;;;GAOG;AACH,6FA2FC"}
+{"version":3,"file":"auto_set_camera_clipping_planes.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/auto_set_camera_clipping_planes.js"],"names":[],"mappings":"AA0BA;;;;;;;GAOG;AACH,6FAqEC"}

package/src/engine/graphics/ecs/camera/auto_set_camera_clipping_planes.js

@@ -1,5 +1,6 @@
 import { Frustum as ThreeFrustum } from "three";
 import { frustum3_planes_to_flat_from_three } from "../../../../core/geom/3d/frustum/frustum3_planes_to_flat_from_three.js";
+import { render_layers_compute_depth_range } from "../render_layers_compute_depth_range.js";
 import { frustum_from_camera } from "./frustum_from_camera.js";
 
 const CLIPPING_EPSILON = 0.001;
@@ -54,34 +55,12 @@ export function auto_set_camera_clipping_planes(c, layers) {
     frustum_from_camera(camera, scratch_three_frustum, true);
     frustum3_planes_to_flat_from_three(scratch_three_frustum.planes, scratch_frustum_planes);
 
-    // Depth plane: passes through camera position, normal pointing along the
-    // view direction (-Z in camera local). A world-space point's distance to
-    // this plane equals its signed depth in front of the camera.
-    const m = camera.matrixWorld.elements;
-    const nx = -m[8];
-    const ny = -m[9];
-    const nz = -m[10];
-    const cam_x = m[12];
-    const cam_y = m[13];
-    const cam_z = m[14];
-    const plane_constant = -(nx * cam_x + ny * cam_y + nz * cam_z);
-
-    scratch_range.near = Number.POSITIVE_INFINITY;
-    scratch_range.far = Number.NEGATIVE_INFINITY;
-
-    layers.traverse((layer) => {
-        if (!layer.state.visible) {
-            return;
-        }
-
-        const compute = layer.compute_depth_range;
-
-        if (compute === null) {
-            return;
-        }
-
-        compute(scratch_range, scratch_frustum_planes, nx, ny, nz, plane_constant);
-    });
+    render_layers_compute_depth_range(
+        scratch_range,
+        layers,
+        scratch_frustum_planes,
+        camera.matrixWorld.elements
+    );
 
     let new_near = scratch_range.near - CLIPPING_EPSILON;
     let new_far = scratch_range.far + CLIPPING_EPSILON;

package/src/engine/graphics/ecs/highlight/renderer/HighlightDecodeShader.d.ts

@@ -1,3 +1,2 @@
-export function makeHighlightDecodeShader(): ShaderMaterial;
-import { ShaderMaterial } from "three";
+export function makeHighlightDecodeShader(): import("three").ShaderMaterial;
 //# sourceMappingURL=HighlightDecodeShader.d.ts.map

package/src/engine/graphics/ecs/highlight/renderer/HighlightDecodeShader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HighlightDecodeShader.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/HighlightDecodeShader.js"],"names":[],"mappings":"AAoCA,4DA8BC;+BAlEmD,OAAO"}
+{"version":3,"file":"HighlightDecodeShader.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/HighlightDecodeShader.js"],"names":[],"mappings":"AAoCA,4EAsBC"}

package/src/engine/graphics/ecs/highlight/renderer/HighlightDecodeShader.js

@@ -1,5 +1,5 @@
-import { NoBlending, ShaderMaterial, Vector2 } from "three";
-import { ScreenSpaceQuadShader } from "../../../shaders/ScreenSpaceQuadShader.js";
+import { Vector2 } from "three";
+import { make_screen_space_quad_material } from "./make_screen_space_quad_material.js";
 
 const fragmentShader = `
 
@@ -50,17 +50,9 @@ export function makeHighlightDecodeShader() {
         }
     };
 
-    const material = new ShaderMaterial({
+    const material = make_screen_space_quad_material({
         uniforms,
-        vertexShader: ScreenSpaceQuadShader.vertexShader(),
-        fragmentShader: fragmentShader,
-        blending: NoBlending,
-        lights: false,
-        fog: false,
-        depthTest: false,
-        depthWrite: false,
-        transparent: true,
-        vertexColors: false
+        fragmentShader
     });
 
     return material;

package/src/engine/graphics/ecs/highlight/renderer/OutlineRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OutlineRenderer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/OutlineRenderer.js"],"names":[],"mappings":"AA+JA;IAQQ;;;OAGG;IACH,wBAAoB;IAEpB;;;OAGG;IACH,eAAkB;IAElB;;;OAGG;IACH,OAFU,KAAK,CAEE;IAEjB;;;;OAIG;IACH,gCAGE;IAEF,gCAA6D;IAC7D,kBAA6B;IAE7B,kCAAoD;IACpD,kCAA6C;IAC7C,gCAAuC;IAEvC,qDAAsF;IAGtF,kBAA6B;IAK7B;;;OAGG;IACH,eAFU,OAAO,CAEQ;IAEzB,sCAMC;IASD,6CAOE;IAEF,6CAOE;IAEF,6CAOE;IAEF,uCAOE;IAEF,uCAOE;IASF;;;;OAIG;IACH,yBAAyB;IAEzB;;;;OAIG;IACH,2BAA2B;IAG3B;;;;OAIG;IACH,4BAA+B;IAGnC,2BAEC;IAED;;;OAGG;IACH,gDAEC;IAED;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QA2BhB;IAED;;;OAGG;IACH,kBAFW,oBAAkB,kBAAkB,QAI9C;IAED;;;;OAIG;IACH,sCAyBC;IAED;;;;OAIG;IACH,6BAmBC;IAED;;;OAGG;IACH,mDAiDC;IAhDG,sCAA4B;IAkDhC;;;OAGG;IACH,2BAFW,MAAM,QA0ChB;IAED;;;;;OAKG;IACH,8BAyBC;IAED,wBAEC;IAED;;OAEG;IACH,uBAIC;IAED;;;;;OAKG;IACH,0CAgBC;IAED,wBAEC;IAGD;;;OAGG;IACH,0CAqBC;IAED,0BAeC;IAED;;;;OAIG;IACH,gBAcC;CACJ;sBA7nBM,OAAO;mCAAP,OAAO;+BAAP,OAAO;oCAAP,OAAO;qBAAP,OAAO;4BAAP,OAAO;kCAAP,OAAO"}
+{"version":3,"file":"OutlineRenderer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/OutlineRenderer.js"],"names":[],"mappings":"AAsJA;IAQQ;;;OAGG;IACH,wBAAoB;IAEpB;;;OAGG;IACH,eAAkB;IAElB;;;OAGG;IACH,OAFU,KAAK,CAEE;IAEjB;;;;OAIG;IACH,gCAGE;IAEF,gCAA6D;IAC7D,kBAA6B;IAE7B,kCAAoD;IACpD,kCAA6C;IAC7C,gCAAuC;IAEvC,qDAAsF;IAGtF,kBAA6B;IAK7B;;;OAGG;IACH,eAFU,OAAO,CAEQ;IAEzB,sCAMC;IASD,6CAOE;IAEF,6CAOE;IAEF,6CAOE;IAEF,uCAOE;IAEF,uCAOE;IASF;;;;OAIG;IACH,yBAAyB;IAEzB;;;;OAIG;IACH,2BAA2B;IAG3B;;;;OAIG;IACH,4BAA+B;IAGnC,2BAEC;IAED;;;OAGG;IACH,gDAEC;IAED;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QA2BhB;IAED;;;OAGG;IACH,kBAFW,oBAAkB,kBAAkB,QAI9C;IAED;;;;OAIG;IACH,sCAyBC;IAED;;;;OAIG;IACH,6BAmBC;IAED;;;OAGG;IACH,mDAiDC;IAhDG,sCAA4B;IAkDhC;;;OAGG;IACH,2BAFW,MAAM,QA0ChB;IAED;;;;;OAKG;IACH,8BAyBC;IAED,wBAEC;IAED;;OAEG;IACH,uBAIC;IAED;;;;;OAKG;IACH,0CAgBC;IAED,wBAEC;IAGD;;;OAGG;IACH,0CAqBC;IAED,0BAeC;IAED;;;;OAIG;IACH,gBAcC;CACJ;sBArnBM,OAAO;mCAAP,OAAO;+BAAP,OAAO;oCAAP,OAAO;qBAAP,OAAO;4BAAP,OAAO;kCAAP,OAAO"}

package/src/engine/graphics/ecs/highlight/renderer/OutlineRenderer.js

@@ -5,7 +5,6 @@ import {
     LinearFilter,
     Mesh,
     NearestFilter,
-    NoBlending,
     Object3D,
     OrthographicCamera,
     PlaneBufferGeometry,
@@ -22,11 +21,11 @@ import { assert } from "../../../../../core/assert.js";
 import { HashMap } from "../../../../../core/collection/map/HashMap.js";
 import { invokeObjectEquals } from "../../../../../core/model/object/invokeObjectEquals.js";
 import { invokeObjectHash } from "../../../../../core/model/object/invokeObjectHash.js";
-import { ScreenSpaceQuadShader } from "../../../shaders/ScreenSpaceQuadShader.js";
 import { three_setSceneAutoUpdate } from "../../../three/three_setSceneAutoUpdate.js";
 import { makeHighlightDecodeShader } from "./HighlightDecodeShader.js";
 import { makeDilationShader } from "./makeDilationShader.js";
 import { makeGaussianBlurShader } from "./makeGaussianBlurShader.js";
+import { make_screen_space_quad_material } from "./make_screen_space_quad_material.js";
 import { traverseThreeObject } from "./traverseThreeObject.js";
 
 const material_id_fragment_shader = `
@@ -137,20 +136,12 @@ function makeBlurShader() {
     const blurShader = makeGaussianBlurShader({ samples: 5, distance: 5 });
 
 
-    return new ShaderMaterial({
+    return make_screen_space_quad_material({
         uniforms: {
             "tDiffuse": { type: "t", value: null },
             "tMask": { type: "t", value: null },
             "resolution": { type: "v2", value: new Vector2(800, 600) },
         },
-        blending: NoBlending,
-        lights: false,
-        fog: false,
-        depthTest: false,
-        depthWrite: false,
-        transparent: true,
-        vertexColors: false,
-        vertexShader: ScreenSpaceQuadShader.vertexShader(),
         fragmentShader: blurShader
     });
 }

package/src/engine/graphics/ecs/highlight/renderer/makeBlurShader_9.d.ts

@@ -1,3 +1,2 @@
-export function makeBlurShader_9(): ShaderMaterial;
-import { ShaderMaterial } from "three";
+export function makeBlurShader_9(): import("three").ShaderMaterial;
 //# sourceMappingURL=makeBlurShader_9.d.ts.map

package/src/engine/graphics/ecs/highlight/renderer/makeBlurShader_9.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makeBlurShader_9.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/makeBlurShader_9.js"],"names":[],"mappings":"AAGA,mDA6CC;+BAhDmD,OAAO"}
+{"version":3,"file":"makeBlurShader_9.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/makeBlurShader_9.js"],"names":[],"mappings":"AAGA,mEAqCC"}

package/src/engine/graphics/ecs/highlight/renderer/makeBlurShader_9.js

@@ -1,9 +1,9 @@
-import { NoBlending, ShaderMaterial, Vector2 } from "three";
-import { ScreenSpaceQuadShader } from "../../../shaders/ScreenSpaceQuadShader.js";
+import { Vector2 } from "three";
+import { make_screen_space_quad_material } from "./make_screen_space_quad_material.js";
 
 export function makeBlurShader_9(){
 
-    return new ShaderMaterial({
+    return make_screen_space_quad_material({
         uniforms: {
             tDiffuse: {
                 type: 't',
@@ -14,14 +14,6 @@ export function makeBlurShader_9(){
                 value: new Vector2(1, 1)
             }
         },
-        blending: NoBlending,
-        light: false,
-        fog: false,
-        depthTest: false,
-        depthWrite: false,
-        transparent: true,
-        vertexColors: false,
-        vertexShader: ScreenSpaceQuadShader.vertexShader(),
         fragmentShader: `
         
                 uniform sampler2D tDiffuse;

package/src/engine/graphics/ecs/highlight/renderer/makeDilationShader.d.ts

@@ -1,3 +1,2 @@
-export function makeDilationShader(): ShaderMaterial;
-import { ShaderMaterial } from "three";
+export function makeDilationShader(): import("three").ShaderMaterial;
 //# sourceMappingURL=makeDilationShader.d.ts.map

package/src/engine/graphics/ecs/highlight/renderer/makeDilationShader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makeDilationShader.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/makeDilationShader.js"],"names":[],"mappings":"AAGA,qDAwFC;+BA3FmD,OAAO"}
+{"version":3,"file":"makeDilationShader.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/makeDilationShader.js"],"names":[],"mappings":"AAGA,qEAgFC"}

package/src/engine/graphics/ecs/highlight/renderer/makeDilationShader.js

@@ -1,8 +1,8 @@
-import { NoBlending, ShaderMaterial, Vector2 } from "three";
-import { ScreenSpaceQuadShader } from "../../../shaders/ScreenSpaceQuadShader.js";
+import { Vector2 } from "three";
+import { make_screen_space_quad_material } from "./make_screen_space_quad_material.js";
 
 export function makeDilationShader() {
-    return new ShaderMaterial({
+    return make_screen_space_quad_material({
         uniforms: {
             tInput: {
                 type: 't',
@@ -13,14 +13,6 @@ export function makeDilationShader() {
                 value: new Vector2(1, 1)
             }
         },
-        blending: NoBlending,
-        lights: false,
-        fog: false,
-        depthTest: false,
-        depthWrite: false,
-        transparent: true,
-        vertexColors: false,
-        vertexShader: ScreenSpaceQuadShader.vertexShader(),
         fragmentShader: `
         
                 uniform sampler2D tInput;

package/src/engine/graphics/ecs/highlight/renderer/make_screen_space_quad_material.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Build a `ShaderMaterial` for a full-screen post-processing pass: no blending,
+ * no lighting, no fog, no depth interaction, and the standard screen-space quad
+ * vertex shader.
+ *
+ * WHY THIS EXISTS
+ *
+ * The outline renderer built four of these — `makeBlurShader_9`,
+ * `makeDilationShader`, `HighlightDecodeShader` and `OutlineRenderer`'s own
+ * blur — and each restated the same eight properties by hand. Copy-paste drift
+ * had already happened: `makeBlurShader_9` wrote `light: false`, which is not a
+ * three.js material property at all, so `Material.setValues` logged a warning
+ * on every construction and the intended flag was never among the values set.
+ * That is exactly the class of mistake a shared constructor removes.
+ *
+ * It also keeps the three.js imports (`ShaderMaterial`, `NoBlending`) at one
+ * boundary instead of four.
+ *
+ * NOTE ON HOME: every current caller lives in this directory, so it lives here.
+ * It belongs beside `ScreenSpaceQuadShader` in `engine/graphics/shaders/` once
+ * something outside the outline renderer needs it.
+ *
+ * @param {Object} spec
+ * @param {Object} spec.uniforms uniform declarations, passed through unchanged
+ * @param {string} spec.fragmentShader GLSL source for the pass
+ * @returns {ShaderMaterial}
+ */
+export function make_screen_space_quad_material({ uniforms, fragmentShader }: {
+    uniforms: any;
+    fragmentShader: string;
+}): ShaderMaterial;
+import { ShaderMaterial } from "three";
+//# sourceMappingURL=make_screen_space_quad_material.d.ts.map

package/src/engine/graphics/ecs/highlight/renderer/make_screen_space_quad_material.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make_screen_space_quad_material.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/renderer/make_screen_space_quad_material.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAJwB,QAAQ;IACR,cAAc,EAA3B,MAAM;IACJ,cAAc,CAe1B;+BA3C0C,OAAO"}

package/src/engine/graphics/ecs/highlight/renderer/make_screen_space_quad_material.js

@@ -0,0 +1,44 @@
+import { NoBlending, ShaderMaterial } from "three";
+import { ScreenSpaceQuadShader } from "../../../shaders/ScreenSpaceQuadShader.js";
+
+/**
+ * Build a `ShaderMaterial` for a full-screen post-processing pass: no blending,
+ * no lighting, no fog, no depth interaction, and the standard screen-space quad
+ * vertex shader.
+ *
+ * WHY THIS EXISTS
+ *
+ * The outline renderer built four of these — `makeBlurShader_9`,
+ * `makeDilationShader`, `HighlightDecodeShader` and `OutlineRenderer`'s own
+ * blur — and each restated the same eight properties by hand. Copy-paste drift
+ * had already happened: `makeBlurShader_9` wrote `light: false`, which is not a
+ * three.js material property at all, so `Material.setValues` logged a warning
+ * on every construction and the intended flag was never among the values set.
+ * That is exactly the class of mistake a shared constructor removes.
+ *
+ * It also keeps the three.js imports (`ShaderMaterial`, `NoBlending`) at one
+ * boundary instead of four.
+ *
+ * NOTE ON HOME: every current caller lives in this directory, so it lives here.
+ * It belongs beside `ScreenSpaceQuadShader` in `engine/graphics/shaders/` once
+ * something outside the outline renderer needs it.
+ *
+ * @param {Object} spec
+ * @param {Object} spec.uniforms uniform declarations, passed through unchanged
+ * @param {string} spec.fragmentShader GLSL source for the pass
+ * @returns {ShaderMaterial}
+ */
+export function make_screen_space_quad_material({ uniforms, fragmentShader }) {
+    return new ShaderMaterial({
+        uniforms,
+        vertexShader: ScreenSpaceQuadShader.vertexShader(),
+        fragmentShader,
+        blending: NoBlending,
+        lights: false,
+        fog: false,
+        depthTest: false,
+        depthWrite: false,
+        transparent: true,
+        vertexColors: false
+    });
+}

package/src/engine/graphics/ecs/highlight/system/HighlightSystemBase.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Shared scaffold for the outline-highlight systems.
+ *
+ * WHY THIS EXISTS
+ *
+ * `MeshHighlightSystem`, `RenderableHighlightSystem` and
+ * `ShadedGeometryHighlightSystem` were three copies of one system. The
+ * `OutlineRenderPlugin` reference lifecycle in particular — acquire in
+ * `startup`, `removeSource` + `release` + null out in `shutdown` — is a
+ * resource protocol that is easy to get subtly wrong, and it was written out
+ * three times. So were the element-source registration, the dataset-null guard
+ * and the pool/group plumbing. Everything that genuinely differs between the
+ * three is now exactly one method, {@link visit}.
+ *
+ * Plain typed inheritance: a subclass names its component class in the
+ * constructor and implements `visit`. No registry, no string keys.
+ *
+ * @abstract
+ */
+export class HighlightSystemBase extends System<any> {
+    /**
+     * @param {Engine} engine
+     * @param {Function} component_class renderable component this system outlines, paired with {@link Highlight}
+     */
+    constructor(engine: Engine, component_class: Function);
+    dependencies: Function[];
+    /**
+     * @type {HighlightElementSupplier}
+     * @private
+     */
+    private __element_source;
+    /**
+     * Queue one outline element for the current frame. Only valid to call from
+     * inside {@link visit}, which is the only point at which the pool and the
+     * render group exist.
+     *
+     * @param {THREE.Object3D} object three.js object whose silhouette is outlined
+     * @param {HighlightDefinition[]} definitions outline styles to draw for it
+     */
+    submit(object: THREE.Object3D, definitions: HighlightDefinition[]): void;
+    /**
+     * Decide whether this entity should be outlined this frame and, if so, call
+     * {@link submit} with the three.js object to trace.
+     *
+     * @abstract
+     * @param {Highlight} highlight
+     * @param {*} component instance of the component class given to the constructor
+     * @param {number} entity
+     */
+    visit(highlight: Highlight, component: any, entity: number): void;
+    #private;
+}
+import { System } from "../../../../ecs/System.js";
+import Highlight from "../Highlight.js";
+//# sourceMappingURL=HighlightSystemBase.d.ts.map

package/src/engine/graphics/ecs/highlight/system/HighlightSystemBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HighlightSystemBase.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/highlight/system/HighlightSystemBase.js"],"names":[],"mappings":"AA8FA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IAYI;;;OAGG;IACH,uDAYC;IAPG,yBAAgD;IAEhD;;;OAGG;IACH,yBAA2E;IAwC/E;;;;;;;OAOG;IACH,eAHW,MAAM,QAAQ,eACd,qBAAqB,QAI/B;IAED;;;;;;;;OAQG;IACH,iBAJW,SAAS,0BAET,MAAM,QAIhB;;CACJ;uBA5MsB,2BAA2B;sBAC5B,iBAAiB"}