@woosh/meep-engine 2.164.0 → 2.165.0

package/src/engine/graphics/geometry/MikkT/MikkTSpace.js

@@ -1,4 +1,4 @@
-import { vec3 } from "gl-matrix";
+import { v3_equals_array } from "../../../../core/geom/vec3/v3_equals_array.js";
 import { v3_allocate } from "../../../../core/geom/vec3/v3_allocate.js";
 import { DEG_TO_RAD } from "../../../../core/math/DEG_TO_RAD.js";
 import { Build4RuleGroups } from "./Build4RuleGroups.js";
@@ -194,9 +194,9 @@ export function genTangSpace(pContext, fAngularThreshold = 180) {
     const iTotTris = iNrTrianglesIn;
     let iDegenTriangles = 0;
 
-    const p0 = vec3.create();
-    const p1 = vec3.create();
-    const p2 = vec3.create();
+    const p0 = new Float32Array(3);
+    const p1 = new Float32Array(3);
+    const p2 = new Float32Array(3);
 
     for (let t = 0; t < iTotTris; t++) {
 
@@ -211,9 +211,9 @@ export function genTangSpace(pContext, fAngularThreshold = 180) {
         GetPosition(p2, 0, pContext, i2);
 
         if (
-            vec3.exactEquals(p0, p1) ||
-            vec3.exactEquals(p0, p2) ||
-            vec3.exactEquals(p1, p2)
+            v3_equals_array(p0, 0, p1, 0) ||
+            v3_equals_array(p0, 0, p2, 0) ||
+            v3_equals_array(p1, 0, p2, 0)
         ) {
             // degenerate
             pTriInfos[t].iFlag |= MARK_DEGENERATE;

package/src/engine/graphics/geometry/MikkT/NormalizeSafe.d.ts

@@ -4,5 +4,4 @@
  * @param {vec3} input
  */
 export function NormalizeSafe(out: vec3, input: vec3): void;
-import { vec3 } from "gl-matrix";
 //# sourceMappingURL=NormalizeSafe.d.ts.map

package/src/engine/graphics/geometry/MikkT/NormalizeSafe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NormalizeSafe.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/geometry/MikkT/NormalizeSafe.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,mCAHW,IAAI,SACJ,IAAI,QAcd;qBAnBoB,WAAW"}
+{"version":3,"file":"NormalizeSafe.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/geometry/MikkT/NormalizeSafe.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,4DAYC"}

package/src/engine/graphics/geometry/MikkT/NormalizeSafe.js

@@ -1,4 +1,6 @@
-import { vec3 } from "gl-matrix";
+import { v3_length } from "../../../../core/geom/vec3/v3_length.js";
+import { v3_scale } from "../../../../core/geom/vec3/v3_scale.js";
+import { v3_copy_array } from "../../../../core/geom/vec3/v3_copy_array.js";
 
 /**
  *
@@ -7,14 +9,14 @@ import { vec3 } from "gl-matrix";
  */
 export function NormalizeSafe(out, input) {
 
-    const len = vec3.length(input);
+    const len = v3_length(input[0], input[1], input[2]);
 
     if (len !== 0) {
         const m = 1 / len;
 
-        vec3.scale(out, input, m)
+        v3_scale(out, 0, input[0], input[1], input[2], m);
 
     } else {
-        vec3.copy(out, input);
+        v3_copy_array(out, 0, input, 0);
     }
 }

package/src/engine/graphics/geometry/MikkT/STSpace.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="gl-matrix/index.js" />
 export class STSpace {
     /**
      *
@@ -20,5 +19,4 @@ export class STSpace {
      */
     copy(other: STSpace): void;
 }
-import { vec3 } from "gl-matrix";
 //# sourceMappingURL=STSpace.d.ts.map

package/src/engine/graphics/geometry/MikkT/STSpace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"STSpace.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/geometry/MikkT/STSpace.js"],"names":[],"mappings":";AAGA;IACI;;;OAGG;IACH,KAFU,IAAI,GAAC,YAAY,CAEP;IACpB;;;OAGG;IACH,KAFU,IAAI,GAAC,YAAY,CAEP;IAEpB,cAAU;IACV,cAAU;IAEV,iBAAa;IACb,iBAAgB;IAEhB;;;OAGG;IACH,YAFW,OAAO,QASjB;CACJ;qBAjCoB,WAAW"}
+{"version":3,"file":"STSpace.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/geometry/MikkT/STSpace.js"],"names":[],"mappings":"AAGA;IACI;;;OAGG;IACH,KAFU,OAAK,YAAY,CAEP;IACpB;;;OAGG;IACH,KAFU,OAAK,YAAY,CAEP;IAEpB,cAAU;IACV,cAAU;IAEV,iBAAa;IACb,iBAAgB;IAEhB;;;OAGG;IACH,YAFW,OAAO,QASjB;CACJ"}

package/src/engine/graphics/geometry/MikkT/STSpace.js

@@ -1,5 +1,5 @@
-import { vec3 } from "gl-matrix";
 import { v3_allocate } from "../../../../core/geom/vec3/v3_allocate.js";
+import { v3_copy_array } from "../../../../core/geom/vec3/v3_copy_array.js";
 
 export class STSpace {
     /**
@@ -24,9 +24,9 @@ export class STSpace {
      * @param {STSpace} other
      */
     copy(other) {
-        vec3.copy(this.vOs, other.vOs);
+        v3_copy_array(this.vOs, 0, other.vOs, 0);
         this.fMagS = other.fMagS;
-        vec3.copy(this.vOt, other.vOt);
+        v3_copy_array(this.vOt, 0, other.vOt, 0);
         this.fMagT = other.fMagT;
         this.iCounter = other.iCounter;
         this.bOrient = other.bOrient;

package/src/engine/graphics/geometry/MikkT/v3_scale_dot_sub_normalize.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="gl-matrix/index.js" />
 /**
  * executes following formula: v1 - v0*( dot(v0,v1) )
  * @param {vec3} out
@@ -6,5 +5,4 @@
  * @param {vec3} v1
  */
 export function v3_scale_dot_sub_normalize(out: vec3, v0: vec3, v1: vec3): void;
-import { vec3 } from "gl-matrix";
 //# sourceMappingURL=v3_scale_dot_sub_normalize.d.ts.map

package/src/engine/graphics/geometry/MikkT/v3_scale_dot_sub_normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v3_scale_dot_sub_normalize.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/geometry/MikkT/v3_scale_dot_sub_normalize.js"],"names":[],"mappings":";AAIA;;;;;GAKG;AACH,gDAJW,IAAI,MACJ,IAAI,MACJ,IAAI,QA2Cd;qBAnDoB,WAAW"}
+{"version":3,"file":"v3_scale_dot_sub_normalize.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/geometry/MikkT/v3_scale_dot_sub_normalize.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,gFAyCC"}

package/src/engine/graphics/geometry/MikkT/v3_scale_dot_sub_normalize.js

@@ -1,4 +1,3 @@
-import { vec3 } from "gl-matrix";
 import { v3_length } from "../../../../core/geom/vec3/v3_length.js";
 import { v3_dot } from "../../../../core/geom/vec3/v3_dot.js";
 

package/src/engine/graphics/impostors/octahedral/ImpostorBaker.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="gl-matrix/index.js" />
 export class ImpostorBaker {
     /**
      *
@@ -34,5 +33,4 @@ export class ImpostorBaker {
     }[]): ImpostorDescription;
 }
 import { ImpostorDescription } from "./ImpostorDescription.js";
-import { mat4 } from "gl-matrix";
 //# sourceMappingURL=ImpostorBaker.d.ts.map

package/src/engine/graphics/impostors/octahedral/ImpostorBaker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImpostorBaker.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/impostors/octahedral/ImpostorBaker.js"],"names":[],"mappings":";AAqBA;IAEI;;;;OAIG;IACH,kBAAiB;IAEjB;;;OAGG;IACH,iDAEC;IAGD;;;;;;;OAOG;IACH,yEANW,MAAM,EAAE,OAAK,uBAgPvB;IAED;;;;;;;OAOG;IACH,4CANW;QAAC,IAAI,iBAAgB;QAAC,SAAS,EAAC,IAAI,CAAA;KAAC,EAAE,GAIrC,mBAAmB,CA4E/B;CACJ;oCA7VmC,0BAA0B;qBAjBnC,WAAW"}
+{"version":3,"file":"ImpostorBaker.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/impostors/octahedral/ImpostorBaker.js"],"names":[],"mappings":"AAsBA;IAEI;;;;OAIG;IACH,kBAAiB;IAEjB;;;OAGG;IACH,iDAEC;IAGD;;;;;;;OAOG;IACH,yEANW,MAAM,EAAE,OAAK,uBAgPvB;IAED;;;;;;;OAOG;IACH,4CANW;QAAC,IAAI,iBAAgB;QAAC,SAAS,OAAK;KAAC,EAAE,GAIrC,mBAAmB,CA4E/B;CACJ;oCA7VmC,0BAA0B"}

package/src/engine/graphics/impostors/octahedral/ImpostorBaker.js

@@ -1,5 +1,6 @@
-import { mat4, vec3 } from "gl-matrix";
 import { Mesh, OrthographicCamera, Scene, Vector4, WebGLMultipleRenderTargets } from "three";
+import { v3_copy_array } from "../../../../core/geom/vec3/v3_copy_array.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { assert } from "../../../../core/assert.js";
 import { collectIteratorValueToArray } from "../../../../core/collection/collectIteratorValueToArray.js";
 import { HashMap } from "../../../../core/collection/map/HashMap.js";
@@ -170,7 +171,7 @@ export class ImpostorBaker {
             mesh.matrixWorldNeedsUpdate = false;
             mesh.frustumCulled = false;
 
-            mat4.copy(mesh.matrixWorld.elements, object.transform);
+            array_copy(object.transform, 0, mesh.matrixWorld.elements, 0, 16);
 
             scene.add(mesh);
 
@@ -276,7 +277,7 @@ export class ImpostorBaker {
 
 
         id.sphere_radius = bounding_sphere[3];
-        vec3.copy(id.offset, bounding_sphere);
+        v3_copy_array(id.offset, 0, bounding_sphere, 0);
 
         return id;
     }

package/src/engine/graphics/impostors/octahedral/grid/HemiOctahedralUvEncoder.js

@@ -1,5 +1,5 @@
 import { UvEncoder } from "./UvEncoder.js";
-import { vec3 } from "gl-matrix";
+import { v3_normalize_array } from "../../../../../core/geom/vec3/v3_normalize_array.js";
 
 export class HemiOctahedralUvEncoder extends UvEncoder {
     uv_to_unit(output, input) {
@@ -15,6 +15,6 @@ export class HemiOctahedralUvEncoder extends UvEncoder {
         output[1] = r_y;
         output[2] = pz;
 
-        vec3.normalize(output, output);
+        v3_normalize_array(output, 0, output, 0);
     }
 }

package/src/engine/graphics/impostors/octahedral/grid/UvEncoder.d.ts

@@ -1,7 +1,17 @@
-import {vec2, vec3} from "gl-matrix";
-
-export declare class UvEncoder {
-    uv_to_unit(output: vec3, input: vec2): void
-
-    unit_to_uv(output: vec2, inout: vec3): void
-}
+export class UvEncoder {
+    /**
+     *
+     * @param {number[]|vec3} output
+     * @param {number[]|vec2} input
+     * @returns {void}
+     */
+    uv_to_unit(output: number[] | vec3, input: number[] | vec2): void;
+    /**
+     *
+     * @param {number[]|vec2} output
+     * @param {number[]|vec3} input
+     * @returns {void}
+     */
+    unit_to_uv(output: number[] | vec2, input: number[] | vec3): void;
+}
+//# sourceMappingURL=UvEncoder.d.ts.map

package/src/engine/graphics/impostors/voxel/VoxelImpostorBaker.js

@@ -1,4 +1,4 @@
-import { vec3 } from "gl-matrix";
+import { v3_copy_array } from "../../../../core/geom/vec3/v3_copy_array.js";
 import { assert } from "../../../../core/assert.js";
 import { ImpostorBaker } from "../octahedral/ImpostorBaker.js";
 import { ImpostorCaptureType } from "../octahedral/ImpostorCaptureType.js";
@@ -349,7 +349,7 @@ export class VoxelImpostorBaker {
 
         result.capture_type = capture_type;
         result.sphere_radius = bake_result.sphere_radius;
-        vec3.copy(result.offset, bake_result.offset);
+        v3_copy_array(result.offset, 0, bake_result.offset, 0);
 
         result.points = bake_result.voxelised.points;
         result.point_count = bake_result.voxelised.point_count;

package/src/engine/graphics/particles/particular/engine/utils/volume/ParticleVolume.js

@@ -6,7 +6,7 @@ import Quaternion from "../../../../../../../core/geom/Quaternion.js";
 import { ParticleEmitter } from "../../emitter/ParticleEmitter.js";
 import { Transform } from "../../../../../../ecs/transform/Transform.js";
 import Entity from "../../../../../../ecs/Entity.js";
-import { vec3 } from "gl-matrix";
+import { v3_matrix4_multiply } from "../../../../../../../core/geom/vec3/v3_matrix4_multiply.js";
 import { AttributeValue } from "./AttributeValue.js";
 import { PARTICULAR_PARTICLE_SPECIFICATION } from "../../emitter/PARTICULAR_PARTICLE_SPECIFICATION.js";
 import { SerializationMetadata } from "../../../../../../ecs/components/SerializationMetadata.js";
@@ -443,7 +443,7 @@ export class ParticleVolume {
 
                     if (ts.contains_point(v3_position)) {
 
-                        vec3.transformMat4(v3_position, v3_position, matrix_elements);
+                        v3_matrix4_multiply(v3_position, 0, v3_position, 0, matrix_elements);
 
                         particles.writeAttributeVector3(particle_index, PARTICLE_ATTRIBUTE_POSITION, v3_position[0], v3_position[1], v3_position[2]);
 
@@ -521,7 +521,7 @@ export class ParticleVolume {
         for (let i = 0; i < particle_count; i++) {
             shape.sample_random_point_in_volume(v3_position, 0, random);
 
-            vec3.transformMat4(v3_position, v3_position, matrix_elements);
+            v3_matrix4_multiply(v3_position, 0, v3_position, 0, matrix_elements);
 
             particles.writeAttributeVector3(i, PARTICLE_ATTRIBUTE_POSITION, v3_position[0], v3_position[1], v3_position[2]);
         }

package/src/engine/graphics/particles/particular/engine/utils/volume/prototypeParticleVolume.js

@@ -1,4 +1,5 @@
-import { mat4 } from "gl-matrix";
+import { m4_allocate } from "../../../../../../../core/geom/3d/mat4/m4_allocate.js";
+import { m4_from_rotation_translation_scale } from "../../../../../../../core/geom/3d/mat4/m4_from_rotation_translation_scale.js";
 import { LineBasicMaterial } from "three";
 import { TransformControls } from "three/examples/jsm/controls/TransformControls.js";
 import { makeEngineOptionsModel } from "../../../../../../../../../model/game/options/makeEngineOptionsModel.js";
@@ -243,9 +244,9 @@ function make_shape_vis_toggle(engine) {
 }
 
 function mat_from_aabb3(aabb3) {
-    const m4 = mat4.create();
+    const m4 = m4_allocate();
 
-    mat4.fromRotationTranslationScale(m4, [0, 0, 0, 1], [(aabb3.x0 + aabb3.x1) / 2, (aabb3.y0 + aabb3.y1) / 2, (aabb3.z0 + aabb3.z1) / 2], [aabb3.getExtentsX(), aabb3.getExtentsY(), aabb3.getExtentsZ()]);
+    m4_from_rotation_translation_scale(m4, [0, 0, 0, 1], [(aabb3.x0 + aabb3.x1) / 2, (aabb3.y0 + aabb3.y1) / 2, (aabb3.z0 + aabb3.z1) / 2], [aabb3.getExtentsX(), aabb3.getExtentsY(), aabb3.getExtentsZ()]);
 
     return m4;
 }

package/src/engine/graphics/render/forward_plus/LightManager.js

@@ -1,4 +1,4 @@
-import { mat4 } from "gl-matrix";
+import { m4_multiply } from "../../../../core/geom/3d/mat4/m4_multiply.js";
 import {
     ClampToEdgeWrapping,
     DataTexture,
@@ -1079,7 +1079,7 @@ export class LightManager {
         camera.matrixWorldInverse.invert();
 
         // this.__projection_matrix.set(camera.matrixWorldInverse.elements);
-        mat4.multiply(this.__projection_matrix, camera.projectionMatrix.elements, camera.matrixWorldInverse.elements);
+        m4_multiply(this.__projection_matrix, camera.projectionMatrix.elements, camera.matrixWorldInverse.elements);
 
         // console.time('__build_view_frustum');
         this.__build_view_frustum(camera);

package/src/engine/graphics/render/forward_plus/model/Decal.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="gl-matrix/index.js" />
 export class Decal extends AbstractLight {
     /**
      * Transform matrix, initial volume is a unit cube
@@ -41,6 +40,5 @@ export class Decal extends AbstractLight {
     ENCODED_SLOT_COUNT: number;
 }
 import { AbstractLight } from "./AbstractLight.js";
-import { mat4 } from "gl-matrix";
 import Signal from "../../../../../core/events/signal/Signal.js";
 //# sourceMappingURL=Decal.d.ts.map

package/src/engine/graphics/render/forward_plus/model/Decal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Decal.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/render/forward_plus/model/Decal.js"],"names":[],"mappings":";AASA;IAIQ;;;OAGG;IACH,WAFU,MAAM,EAAE,GAAC,YAAY,GAAC,IAAI,EAAE,CAED;IACrC,gCAA6C;IAC7C,iBAA6B;IAE7B,oBAAgC;IAKhC;;;OAGG;IACH,2BAA2B;IAE3B;;;;OAIG;IACH,eAFU,MAAM,CAEM;IAEtB,0EAA6C;IAGjD;;;OAGG;IACH,gBAFW,MAAM,EAAE,GAAC,YAAY,GAAC,UAAU,MAAM,CAAC,QAOjD;IAED,6CAGC;IAED,yCAGC;IAED,4BAUC;IAED,+CAGC;IAED,gDAGC;IAED,6BAKC;IAED,2BAIC;IAED,gDAcC;IAGL;;;OAGG;IACH,kBAFU,OAAO,CAEM;IAEvB,2BAAkC;CARjC;8BAjH6B,oBAAoB;qBAI7B,WAAW;mBACb,6CAA6C"}
+{"version":3,"file":"Decal.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/render/forward_plus/model/Decal.js"],"names":[],"mappings":"AASA;IAIQ;;;OAGG;IACH,WAFU,MAAM,EAAE,GAAC,YAAY,GAAC,MAAM,CAED;IACrC,gCAA6C;IAC7C,iBAA6B;IAE7B,oBAAgC;IAKhC;;;OAGG;IACH,2BAA2B;IAE3B;;;;OAIG;IACH,eAFU,MAAM,CAEM;IAEtB,0EAA6C;IAGjD;;;OAGG;IACH,gBAFW,MAAM,EAAE,GAAC,YAAY,GAAC,UAAU,MAAM,CAAC,QAOjD;IAED,6CAGC;IAED,yCAGC;IAED,4BAUC;IAED,+CAGC;IAED,gDAGC;IAED,6BAKC;IAED,2BAIC;IAED,gDAcC;IAGL;;;OAGG;IACH,kBAFU,OAAO,CAEM;IAEvB,2BAAkC;CARjC;8BAjH6B,oBAAoB;mBAK/B,6CAA6C"}

package/src/engine/graphics/render/forward_plus/model/Decal.js

@@ -2,7 +2,7 @@ import { AbstractLight } from "./AbstractLight.js";
 import { aabb3_matrix4_project_by_corners } from "../../../../../core/geom/3d/aabb/aabb3_matrix4_project_by_corners.js";
 import { aabb3_build_corners } from "../../../../../core/geom/3d/aabb/aabb3_build_corners.js";
 import { array_copy } from "../../../../../core/collection/array/array_copy.js";
-import { mat4 } from "gl-matrix";
+import { m4_invert } from "../../../../../core/geom/3d/mat4/m4_invert.js";
 import Signal from "../../../../../core/events/signal/Signal.js";
 
 const corners = [];
@@ -45,8 +45,8 @@ export class Decal extends AbstractLight {
      * @param {number[]|Float32Array|ArrayLike<number>} m
      */
     setTransform(m) {
-        mat4.copy(this.transform, m);
-        mat4.invert(this.transform_inverse, this.transform);
+        array_copy(m, 0, this.transform, 0, 16);
+        m4_invert(this.transform_inverse, this.transform);
 
         this.__signal_transfom_changed.send0();
     }

package/src/engine/graphics/render/forward_plus/prototype/prototypeLightManager.js

@@ -1,4 +1,5 @@
-import { mat4 } from "gl-matrix";
+import { m4_from_rotation_translation_scale } from "../../../../../core/geom/3d/mat4/m4_from_rotation_translation_scale.js";
+import { m4_invert } from "../../../../../core/geom/3d/mat4/m4_invert.js";
 import SimplexNoise from "simplex-noise";
 import {
     AmbientLight,
@@ -388,8 +389,8 @@ function addDecal({
                   }) {
     const decal = new Decal();
 
-    mat4.fromRotationTranslationScale(decal.transform, rotation, position, scale);
-    mat4.invert(decal.transform_inverse, decal.transform);
+    m4_from_rotation_translation_scale(decal.transform, rotation, position, scale);
+    m4_invert(decal.transform_inverse, decal.transform);
 
     decal.texture_diffuse = sampler;
 

package/src/engine/graphics/render/visibility/hiz/prototypeHiZ.js

@@ -1,4 +1,6 @@
-import { mat4 } from "gl-matrix";
+import { m4_allocate } from "../../../../../core/geom/3d/mat4/m4_allocate.js";
+import { m4_multiply } from "../../../../../core/geom/3d/mat4/m4_multiply.js";
+import { array_copy } from "../../../../../core/collection/array/array_copy.js";
 import FacingDirectionSystem from "../../../../../../../model/game/ecs/system/FacingDirectionSystem.js";
 import { initializeEditor } from "../../../../../../../model/game/initializeEditor.js";
 import { makeEngineOptionsModel } from "../../../../../../../model/game/options/makeEngineOptionsModel.js";
@@ -208,12 +210,12 @@ function prepare_query_test(hiz, graphics, ecd) {
 
         const camera = graphics.camera;
 
-        const projection = mat4.create();
+        const projection = m4_allocate();
         const world_inverse = camera.matrixWorldInverse.elements;
         const camera_projection = camera.projectionMatrix.elements;
 
-        mat4.copy(projection, world_inverse);
-        mat4.multiply(projection, camera_projection, projection);
+        array_copy(world_inverse, 0, projection, 0, 16);
+        m4_multiply(projection, camera_projection, projection);
         const aabb = new AABB3();
 
         const query_size = query.getSize();

package/src/engine/graphics/sh3/lightmap/ARTIFACTS_PLAN.md

@@ -0,0 +1,146 @@
+# Plan: fixing seams & contact leaks
+
+Driven by two observed artifacts plus the Bakery author's article
+"Baking artifact-free lightmaps" (https://ndotl.wordpress.com/2018/08/29/baking-artifact-free-lightmaps/).
+
+## Status (2026-06): implemented
+
+- **P0 carry original normals** — `lightmap_build_geometry.js` now accumulates the SOURCE
+  mesh's per-corner normals via `tri_face` (continuous across seams, hard edges preserved),
+  falling back to the geometric recompute. Fixes sphere faceting. ✅
+- **P0 sample-position push** — `lightmap_push_sample.js`; the bake relocates contact/buried
+  samples (tangential backface probe → push out) instead of discarding. Fixes the contact
+  black line. ✅
+- **P1 supersampling** — `lightmap_gather.js` jitters each ray ORIGIN within the texel
+  footprint (`supersample` option), antialiasing contacts/silhouettes; directions stay
+  independent per texel. ✅
+- **P1 graded adaptive sampling** — smooth interior texels take a reduced *real* sample count
+  (`min_sample_fraction`, default 0.25) instead of a pure lerp (which is now opt-in via
+  `min_sample_fraction = 0`). Edges still full-sampled. ✅
+- **P1 UV seam stitching** — `lightmap_seam_fix.js` pairs chart boundary edges by source vertex
+  and blends both atlas sides; runs after dilation (`seam_fix_iterations`). ✅
+- Post order now: bake (push + supersample) → variance denoise → dilate → seam-fix.
+- Specs: +`lightmap_push_sample.spec.js`, +`lightmap_seam_fix.spec.js`, +carry-normals case;
+  24 tests across 8 suites green; webpack build clean.
+
+### P2 bicubic — SKIPPED for now (user decision)
+The lightmap is sampled inside three's unexpanded `#include <lights_fragment_maps>`, so a clean
+4-tap bicubic needs either a global `THREE.ShaderChunk.lights_fragment_maps` override (affects
+every lit material) or hard-coding three's chunk text in a per-material `onBeforeCompile`
+(brittle across three versions), and it must compose with the FP+ fragment rebuild. It's
+cosmetic polish (masks low resolution) on top of fixes that already address the root artifacts,
+so it was deliberately skipped. Revisit only if the lightmap still reads low-res after the P0/P1
+fixes; the two viable approaches are recorded above.
+
+---
+
+## Original analysis
+
+## The two artifacts, diagnosed against our code
+
+### A. Seams on the smooth sphere
+Two independent causes stack here:
+
+1. **Shading faceting (the dominant one).** `lightmap_build_geometry.js` *recomputes* normals
+   per concatenated chart (`geometry_compute_vertex_normals_indexed`). A seam vertex is
+   duplicated per chart and not shared, so each side averages only its own chart's triangles →
+   the shading normal is **discontinuous at every chart boundary** → hard facets on a surface
+   that should be smooth. This is a regression we flagged ("normals recomputed, not original").
+
+2. **Lighting value step across the UV seam.** The two sides of a seam are the same 3D edge but
+   live in different atlas locations, sampled independently → slightly different indirect values →
+   a faint step. Denoise/dilate never bridge it (the two sides are far apart in the atlas).
+
+### B. Black line where the box meets the floor (contact leak)
+The contact texels — floor texels whose footprint straddles the box base, and the box's
+bottom-edge texels — are getting near-zero indirect. Likely contributors:
+- Our **confidence mask discards** over-occluded contact texels (`coverage = 0`) and lets
+  dilation fill them — but dilation pulls from the *adjacent dark contact texels*, so the line
+  stays dark instead of getting a proper value.
+- **No spatial anti-aliasing**: every sample for a texel originates from the *same* texel-center
+  point, so a texel half in shadow / half lit resolves to one hard value → a one-texel hard line
+  rather than a soft gradient.
+- Bilinear reaching toward the chart silhouette / gutter at the contact.
+
+## Bakery techniques and how they map to us
+
+| Bakery technique | Our adaptation |
+|---|---|
+| **Shadow-leak prevention**: trace 4+ **tangential** rays of length `0.5 × worldTexelSize`; if one hits a **backface**, *push* the sample out (`pos += rayDir·hitDist + faceNormal·bias`) | Replace our *discard-on-low-confidence* with **relocate**: keep the texel, move its sample to a valid spot. Directly targets artifact B. |
+| **Supersampling**: 25 sub-texel UV taps | **Jitter the ray ORIGIN within the texel footprint** (surface tangent plane), not just the direction. Antialiases the contact line and silhouettes (artifact B). |
+| **Seam fixing**: detect seam edge pairs (same pos+normal, different UV), draw lines blending both sides until they match (iterative, ping-pong) | CPU equivalent: pair `chart.boundary_edges` across charts by original vertex id, walk both sides in atlas space, average a few iterations. Targets artifact A.2. |
+| **Dilation** (8-neighbour fill) | We have `lightmap_dilate`. Keep; fix ordering. |
+| **Bicubic read-time filtering** ("0 reasons not to") | Optional three.js lightmap shader patch — hides low-res, softens lines. Bigger lift (custom material). |
+| **Phong-tessellated smooth sample position** (shadow terminator on low-poly) | Defer — our content is either smooth-normalled (sphere) or genuinely flat (boxes). |
+| Post order: bake-push → dilate → denoise → seam-fix | Adopt: currently denoise → dilate, no seam-fix. |
+
+Note: the Bakery seam detection uses pos<ε, normal<ε, **uv>ε** — exactly the seam definition we
+can derive from `vertex_of_local` + `chart.uv`.
+
+## Prioritized next steps
+
+### P0 — Carry original smooth normals (fixes sphere faceting, A.1)
+- `lightmap_build_geometry.js`: take the source geometry's `normal` attribute; set each
+  chart-local vertex normal to `original_normal[chart.vertex_of_local[lv]]` instead of
+  recomputing. For a smooth mesh welding is a no-op, so this reproduces the original normals
+  exactly; for welded hard edges it's the representative's normal (fine — those are hard anyway).
+  Fall back to the current recompute when `vertex_of_local[lv] >= original_vertex_count`
+  (T-junction-added vertices) or the geometry has no normals.
+- `bake_lightmap_for_scene.js`: pass `geometry.getAttribute('normal')?.array` (captured before
+  the geometry is swapped) into `lightmap_build_geometry`.
+- Smallest change, biggest visible win on the sphere.
+
+### P0 — Sample-position PUSH instead of discard (fixes contact black line, B)
+- New `lightmap_push_sample.js`: given world pos + normal + tangent basis + `texel_world_size`,
+  trace 4 tangential rays (length `0.5 × texel_world_size`); if any hits a backface, push the
+  origin out (`pos += rayDir·hitDist + hitFaceNormal·bias`); repeat until clear or a cap.
+- `bake_lightmap_for_scene.js` `prepare()`: run the push when generating each job; store the
+  corrected position. Drop the confidence-discard path in `lightmap_gather` (keep a cheap
+  "still buried after push" → mark hole only as a last resort).
+- Reuses `scene.trace` (already used by the confidence probe).
+
+### P1 — Supersampling: jitter the ray origin in the texel footprint (antialias B, general AA)
+- `lightmap_gather.js`: build a tangent basis from the normal; offset each sample's origin by a
+  random sub-texel amount (`±0.5 × texel_world_size`) in the tangent plane (keep directions
+  independent per sample — no shared set). A contact texel then averages lit/shadowed
+  sub-positions → soft edge instead of a hard line.
+- Pass `texel_world_size` (already available) + reuse `v3_orthonormal_matrix_from_normal`.
+
+### P1 — Graded adaptive sampling (your note: CPU isn't all-or-nothing)
+- `bake_lightmap_for_scene.js`: replace the binary interpolate-vs-full fine path with a
+  **floor of samples** on "smooth" texels: take e.g. `max(samples/4, k)` rays and blend with the
+  bilinear prediction (or accept the samples if they deviate from the prediction beyond
+  `interpolation_threshold`). Keeps a real estimate everywhere — pure lerp can erase small
+  features — while still cutting cost on flats. `adaptive_step`/threshold stay the controls.
+
+### P1 — UV seam stitching (residual sphere value step, A.2)
+- New `lightmap_seam_fix.js`: from each entry's charts, pair `boundary_edges` across charts by
+  `vertex_of_local` (same original edge, different `uv`); for each pair, walk both atlas-space
+  edges and average the texels over a few iterations (Bakery's line-blend, done on the CPU
+  buffer). Run after dilation.
+- Most involved item; do it only if P0-normals + AA leave a visible step.
+
+### P2 — Bicubic lightmap sampling at read time (optional, global softening)
+- Patch the forward-plus lightmap sampling to 4-tap bicubic (`vUv2`). Hides low resolution and
+  softens any remaining jagged lines. Larger change (touches the material/shader); evaluate after
+  the above.
+
+### Post-process order to converge on
+`bake (with push + supersample)` → `variance denoise` → `dilate` → `seam-fix`.
+
+## Verification
+- Sphere: after P0-normals, no facet creases across chart boundaries; after seam-fix, no value
+  step. Add a spec asserting `lightmap_build_geometry` reproduces input normals for a smooth mesh
+  (sphere) within tolerance.
+- Contact: after push + supersample, the box/floor contact is a soft darkening, not a black line.
+  Add a gather/push spec: a texel wedged at a contact gets relocated to a non-buried position
+  (its post-push confidence is high) and bakes > 0.
+- Keep the existing 18 specs green; re-run the webpack build.
+
+## Effort / impact summary
+1. P0 original normals — small, high impact (sphere). **Do first.**
+2. P0 sample push — medium, high impact (contact). **Do first.**
+3. P1 supersample — small/medium, high impact (contact softness + AA).
+4. P1 graded adaptive — small, quality/robustness.
+5. P1 seam stitching — larger, medium impact (only if needed after 1).
+6. P2 bicubic — larger, polish.