@woosh/meep-engine 3.0.1 → 3.0.2

package/src/engine/graphics/sh3/path_tracer/populate_path_traced_scene_from_ecd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"populate_path_traced_scene_from_ecd.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/populate_path_traced_scene_from_ecd.js"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,+GAkDC"}
+{"version":3,"file":"populate_path_traced_scene_from_ecd.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/populate_path_traced_scene_from_ecd.js"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;GAcG;AACH,+GAkDC"}

package/src/engine/graphics/sh3/path_tracer/populate_path_traced_scene_from_ecd.js

@@ -1,64 +1,74 @@
-import { assert } from "../../../../core/assert.js";
-import { Transform } from "../../../ecs/transform/Transform.js";
-import { Light } from "../../ecs/light/Light.js";
-import { LightType } from "../../ecs/light/LightType.js";
-import { ShadedGeometry } from "../../ecs/mesh-v2/ShadedGeometry.js";
-import { DirectionalLight } from "../../render/forward_plus/model/DirectionalLight.js";
-import { PointLight } from "../../render/forward_plus/model/PointLight.js";
-
-/**
- *
- * @param {EntityComponentDataset} ecd
- * @param {PathTracedScene} scene
- */
-export function populate_path_traced_scene_from_ecd(ecd, scene) {
-    assert.defined(ecd, 'ecd');
-    assert.defined(scene, 'scene');
-
-    ecd.traverseEntities([ShadedGeometry, Transform],
-        /**
-         *
-         * @param {ShadedGeometry} sg
-         * @param {Transform} transform
-         */
-        (sg, transform) => {
-
-            scene.createMesh(sg.geometry, sg.material, transform.matrix)
-
-        });
-
-
-    ecd.traverseEntities([Light, Transform],
-        /**
-         *
-         * @param {Light} light
-         * @param {Transform} transform
-         */
-        (light, transform) => {
-
-            const type = light.type.getValue();
-            if (type === LightType.DIRECTION) {
-
-                const l = new DirectionalLight();
-
-                l.color.copy(light.color);
-                l.direction.copy(transform.forward);
-                l.intensity.copy(light.intensity);
-
-                scene.addLight(l);
-
-            }else if(type === LightType.POINT){
-
-                const l = new PointLight();
-
-                l.color.copy(light.color);
-                l.position.copy(transform.position);
-                l.intensity.copy(light.intensity);
-                l.radius.copy(light.distance);
-
-                scene.addLight(l);
-
-            }
-
-        });
+import { assert } from "../../../../core/assert.js";
+import { Transform } from "../../../ecs/transform/Transform.js";
+import { Light } from "../../ecs/light/Light.js";
+import { LightType } from "../../ecs/light/LightType.js";
+import { ShadedGeometry } from "../../ecs/mesh-v2/ShadedGeometry.js";
+import { DirectionalLight } from "../../render/forward_plus/model/DirectionalLight.js";
+import { PointLight } from "../../render/forward_plus/model/PointLight.js";
+
+/**
+ * Fill a traced scene from the entities of a dataset.
+ *
+ * **Two pieces are missing for this to work under Shade, and both are features rather than
+ * omissions** (D62). A `ShadedGeometry` placed by `shade_node_to_entity_composition` holds a
+ * `MeshletGeometry`, whose triangles are quantized inside meshlet pages —
+ * `geometry_build_from_meshlet_geometry` decodes one into the `Geometry` `createMesh` wants, and
+ * who holds that decode is undecided. And it holds a `ShadeMaterial`, where the tracer integrates
+ * against its own `StandardMaterial`; the three path had a converter for exactly that step and
+ * Shade has no twin of it yet. A component carrying a `Geometry` and handed a `StandardMaterial`
+ * goes through as it stands.
+ *
+ * @param {EntityComponentDataset} ecd
+ * @param {PathTracedScene} scene
+ */
+export function populate_path_traced_scene_from_ecd(ecd, scene) {
+    assert.defined(ecd, 'ecd');
+    assert.defined(scene, 'scene');
+
+    ecd.traverseEntities([ShadedGeometry, Transform],
+        /**
+         *
+         * @param {ShadedGeometry} sg
+         * @param {Transform} transform
+         */
+        (sg, transform) => {
+
+            scene.createMesh(sg.geometry, sg.material, transform.matrix)
+
+        });
+
+
+    ecd.traverseEntities([Light, Transform],
+        /**
+         *
+         * @param {Light} light
+         * @param {Transform} transform
+         */
+        (light, transform) => {
+
+            const type = light.type.getValue();
+            if (type === LightType.DIRECTION) {
+
+                const l = new DirectionalLight();
+
+                l.color.copy(light.color);
+                l.direction.copy(transform.forward);
+                l.intensity.copy(light.intensity);
+
+                scene.addLight(l);
+
+            }else if(type === LightType.POINT){
+
+                const l = new PointLight();
+
+                l.color.copy(light.color);
+                l.position.copy(transform.position);
+                l.intensity.copy(light.intensity);
+                l.radius.copy(light.distance);
+
+                scene.addLight(l);
+
+            }
+
+        });
 }

package/src/engine/graphics/sh3/path_tracer/texture/sample_material.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sample_material.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/texture/sample_material.js"],"names":[],"mappings":"AA8CA;;;;;;;GAOG;AACH,qCANW,MAAM,EAAE,sCAER,MAAM,KACN,MAAM,KACN,MAAM,QA4FhB"}
+{"version":3,"file":"sample_material.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/texture/sample_material.js"],"names":[],"mappings":"AA+CA;;;;;;;GAOG;AACH,qCANW,MAAM,EAAE,sCAER,MAAM,KACN,MAAM,KACN,MAAM,QAwFhB"}

package/src/engine/graphics/sh3/path_tracer/texture/sample_material.js

@@ -1,3 +1,4 @@
+import { StandardAttributes } from "../../../../../shade/renderer/geometry/StandardAttributes.js";
 import { compute_binary_data_type_from_typed_array } from "../../../../../core/collection/array/typed/compute_binary_data_type_from_typed_array.js";
 import { v3_distance_sqr } from "../../../../../core/geom/vec3/v3_distance_sqr.js";
 import { v3_multiply } from "../../../../../core/geom/vec3/v3_multiply.js";
@@ -31,7 +32,7 @@ function sample_color_attribute(
     index_0, index_1, index_2,
     u, v
 ) {
-    const color_array = color_attribute.array;
+    const color_array = color_attribute.data;
     sample_triangle_attribute(color, 0, index_0, index_1, index_2, color_array, color_attribute.itemSize, u, v);
 
     const type = compute_binary_data_type_from_typed_array(color_array);
@@ -61,8 +62,7 @@ export function sample_material(
 
     const material = mesh.material;
     const geometry = mesh.geometry;
-    const index_attribute = geometry.getIndex();
-    const index_array = index_attribute.array;
+    const index_array = geometry.index.data;
 
 
     // sample surface normal
@@ -72,19 +72,17 @@ export function sample_material(
     const index_1 = index_array[index_offset + 1];
     const index_2 = index_array[index_offset + 2];
 
-    const normal_attribute = geometry.getAttribute('normal');
+    const normal_attribute = geometry.getAttribute(StandardAttributes.Normal);
 
     if (normal_attribute !== undefined) {
         // vertex normals are present, use those
-        const normal_array = normal_attribute.array;
-
-        sample_triangle_attribute(out, 3, index_0, index_1, index_2, normal_array, 3, u, v);
+        sample_triangle_attribute(out, 3, index_0, index_1, index_2, normal_attribute.data, 3, u, v);
 
     } else {
-        const position_attribute = geometry.getAttribute('position');
+        const position_attribute = geometry.getAttribute(StandardAttributes.Position);
 
         // copy hit normal
-        geometry_construct_triangle_normal(out, 3, index_0, index_1, index_2, position_attribute.array);
+        geometry_construct_triangle_normal(out, 3, index_0, index_1, index_2, position_attribute.data);
     }
 
     // transform normal to world space via the normal matrix (correct under non-uniform scale);
@@ -92,11 +90,10 @@ export function sample_material(
     v3_matrix3_rotate(out, 3, out[3], out[4], out[5], mesh.normal_matrix);
 
     // sample texture coordinates for THIS hit; must be computed before any texture is sampled
-    const uv_attribute = geometry.getAttribute('uv');
+    const uv_attribute = geometry.getAttribute(StandardAttributes.TextureCoordinates0);
 
     if (uv_attribute !== undefined) {
-        const uv_array = uv_attribute.array;
-        sample_triangle_attribute(texture_uv, 0, index_0, index_1, index_2, uv_array, 2, u, v);
+        sample_triangle_attribute(texture_uv, 0, index_0, index_1, index_2, uv_attribute.data, 2, u, v);
     } else {
         // default texture uv
         texture_uv[0] = 0;
@@ -122,7 +119,7 @@ export function sample_material(
         out[5] = scratch_m3[2] * normal[0] + scratch_m3[5] * normal[1] + scratch_m3[8] * normal[2];
     }
 
-    const color_attribute = geometry.getAttribute('color');
+    const color_attribute = geometry.getAttribute(StandardAttributes.Color);
 
     if (color_attribute !== undefined) {
         sample_color_attribute(color, color_attribute, index_0, index_1, index_2, u, v);

package/src/engine/graphics/shadows/vsm.glsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vsm.glsl.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/shadows/vsm.glsl.js"],"names":[],"mappings":"AAIA,oFAIE;AAEF,0zCA8BE"}
+{"version":3,"file":"vsm.glsl.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/shadows/vsm.glsl.js"],"names":[],"mappings":"AAMA,oFAIE;AAEF,0zCA8BE"}

package/src/engine/graphics/shadows/vsm.glsl.js

@@ -1,41 +1,43 @@
-/*
-Taken from three.js r134
- */
-
-export const vertex = /* glsl */`
-void main() {
-	gl_Position = vec4( position, 1.0 );
-}
-`;
-
-export const fragment = /* glsl */`
-uniform sampler2D shadow_pass;
-uniform vec2 resolution;
-uniform float radius;
-#include <packing>
-void main() {
-	const float samples = float( VSM_SAMPLES );
-	float mean = 0.0;
-	float squared_mean = 0.0;
-	// This seems totally useless but it's a crazy work around for a Adreno compiler bug
-	// float depth = unpackRGBAToDepth( texture2D( shadow_pass, ( gl_FragCoord.xy ) / resolution ) );
-	float uvStride = samples <= 1.0 ? 0.0 : 2.0 / ( samples - 1.0 );
-	float uvStart = samples <= 1.0 ? 0.0 : - 1.0;
-	for ( float i = 0.0; i < samples; i ++ ) {
-		float uvOffset = uvStart + i * uvStride;
-		#ifdef HORIZONTAL_PASS
-			vec2 distribution = unpackRGBATo2Half( texture2D( shadow_pass, ( gl_FragCoord.xy + vec2( uvOffset, 0.0 ) * radius ) / resolution ) );
-			mean += distribution.x;
-			squared_mean += distribution.y * distribution.y + distribution.x * distribution.x;
-		#else
-			float depth = unpackRGBAToDepth( texture2D( shadow_pass, ( gl_FragCoord.xy + vec2( 0.0, uvOffset ) * radius ) / resolution ) );
-			mean += depth;
-			squared_mean += depth * depth;
-		#endif
-	}
-	mean = mean / samples;
-	squared_mean = squared_mean / samples;
-	float std_dev = sqrt( squared_mean - mean * mean );
-	gl_FragColor = pack2HalfToRGBA( vec2( mean, std_dev ) );
-}
-`;
+/*
+ Taken from three.js r134, verbatim: the two-pass VSM shadow blur.
+
+ Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+*/
+
+export const vertex = /* glsl */`
+void main() {
+	gl_Position = vec4( position, 1.0 );
+}
+`;
+
+export const fragment = /* glsl */`
+uniform sampler2D shadow_pass;
+uniform vec2 resolution;
+uniform float radius;
+#include <packing>
+void main() {
+	const float samples = float( VSM_SAMPLES );
+	float mean = 0.0;
+	float squared_mean = 0.0;
+	// This seems totally useless but it's a crazy work around for a Adreno compiler bug
+	// float depth = unpackRGBAToDepth( texture2D( shadow_pass, ( gl_FragCoord.xy ) / resolution ) );
+	float uvStride = samples <= 1.0 ? 0.0 : 2.0 / ( samples - 1.0 );
+	float uvStart = samples <= 1.0 ? 0.0 : - 1.0;
+	for ( float i = 0.0; i < samples; i ++ ) {
+		float uvOffset = uvStart + i * uvStride;
+		#ifdef HORIZONTAL_PASS
+			vec2 distribution = unpackRGBATo2Half( texture2D( shadow_pass, ( gl_FragCoord.xy + vec2( uvOffset, 0.0 ) * radius ) / resolution ) );
+			mean += distribution.x;
+			squared_mean += distribution.y * distribution.y + distribution.x * distribution.x;
+		#else
+			float depth = unpackRGBAToDepth( texture2D( shadow_pass, ( gl_FragCoord.xy + vec2( 0.0, uvOffset ) * radius ) / resolution ) );
+			mean += depth;
+			squared_mean += depth * depth;
+		#endif
+	}
+	mean = mean / samples;
+	squared_mean = squared_mean / samples;
+	float std_dev = sqrt( squared_mean - mean * mean );
+	gl_FragColor = pack2HalfToRGBA( vec2( mean, std_dev ) );
+}
+`;

package/src/engine/graphics/texture/computeThreeTextureInternalFormatFromDataType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"computeThreeTextureInternalFormatFromDataType.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/texture/computeThreeTextureInternalFormatFromDataType.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,kEAJW,cAAc,iBACd,MAAM,GACJ,MAAM,GAAC,MAAM,cAAc,CAqCvC;+BA5C8B,6CAA6C"}
+{"version":3,"file":"computeThreeTextureInternalFormatFromDataType.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/texture/computeThreeTextureInternalFormatFromDataType.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,kEAJW,cAAc,iBACd,MAAM,GACJ,MAAM,uBAAqB,CAqCvC;+BA5C8B,6CAA6C"}

package/src/engine/graphics3/WaterSystem3.js

@@ -226,7 +226,7 @@ export class WaterSystem3 extends System {
          past the terrain the height map clamps — which is what lets the shore line continue instead
          of stopping at the boundary.
 
-         `Water.updateShaderForTerrain` states the same thing as a UV transform,
+         The three path stated the same thing as a UV transform,
          `(uv - 0.25) * (WATER_SIZE / terrain_size)`, and the two agree by construction: world
          position is `(u - 0.25) * WATER_SIZE`, and terrain uv is that over the terrain's own size.
         */

package/src/engine/grid/grid2transform/GridPosition2TransformSystem.d.ts

@@ -1,6 +1,6 @@
 export class GridPosition2TransformSystem extends System<any> {
     constructor();
-    dependencies: (typeof Transform | typeof GridPosition2Transform | typeof GridPosition)[];
+    dependencies: (typeof Transform | typeof GridPosition | typeof GridPosition2Transform)[];
     components_used: ResourceAccessSpecification<typeof Transform>[];
     data: any[];
     mapPoint: (x: any, y: any, v3: any) => void;
@@ -24,7 +24,7 @@ export class GridPosition2TransformSystem extends System<any> {
 }
 import { System } from '../../ecs/System.js';
 import { Transform } from '../../ecs/transform/Transform.js';
-import { GridPosition2Transform } from './GridPosition2Transform.js';
 import GridPosition from '../position/GridPosition.js';
+import { GridPosition2Transform } from './GridPosition2Transform.js';
 import { ResourceAccessSpecification } from "../../../core/model/ResourceAccessSpecification.js";
 //# sourceMappingURL=GridPosition2TransformSystem.d.ts.map

package/src/engine/grid/grid2transform/GridPosition2TransformSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GridPosition2TransformSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/grid/grid2transform/GridPosition2TransformSystem.js"],"names":[],"mappings":"AAWA;IAOI,cASC;IAfD,yFAAiE;IACjE,iEAEE;IACF,YAAU;IAKN,4CAKC;IAGL;;;;;;OAMG;IACH,gBALW,sBAAsB,MACtB,YAAY,aACZ,SAAS,UACT,MAAM,QAgChB;IAED;;;;;;OAMG;IACH,kBALW,sBAAsB,MACtB,YAAY,aACZ,SAAS,UACT,MAAM,QAQhB;IAED,cAeC;CACJ;uBAhGsB,qBAAqB;0BAElB,kCAAkC;uCAErB,6BAA6B;yBAD3C,6BAA6B;4CAJV,oDAAoD"}
+{"version":3,"file":"GridPosition2TransformSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/grid/grid2transform/GridPosition2TransformSystem.js"],"names":[],"mappings":"AAWA;IAOI,cASC;IAfD,yFAAiE;IACjE,iEAEE;IACF,YAAU;IAKN,4CAKC;IAGL;;;;;;OAMG;IACH,gBALW,sBAAsB,MACtB,YAAY,aACZ,SAAS,UACT,MAAM,QAgChB;IAED;;;;;;OAMG;IACH,kBALW,sBAAsB,MACtB,YAAY,aACZ,SAAS,UACT,MAAM,QAQhB;IAED,cAeC;CACJ;uBAhGsB,qBAAqB;0BAElB,kCAAkC;yBACnC,6BAA6B;uCACf,6BAA6B;4CALxB,oDAAoD"}

package/src/shade/renderer/geometry/Geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Geometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/Geometry.js"],"names":[],"mappings":"4BA2BU,MAAM;;;;AAQhB;;GAEG;AACH;IAQI;;;;OAIG;IACH,iBAEC;IAED;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,YAFU,SAAS,EAAE,CAEL;IAEhB;;;OAGG;IACH,OAFU,SAAS,GAAC,IAAI,CAEX;IAEb;;;OAGG;IACH,cAFU,YAAY,CAEa;IACnC;;;OAGG;IACH,iBAFU,YAAY,CAEgB;IAEtC;;;OAGG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;;;;;;;OAUG;IACH,sBAEC;IAED;;OAEG;IACH,8BAIC;IAGD;;;;OAIG;IACH,cAHW,MAAM,GAAC,aAAa,GAClB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,aAAa,GAClB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,aAAa,SACpB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,aAAa,GAClB,OAAO,CAInB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAYnB;IAED,eAQC;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACL,SAAS,GAAC,SAAS,CAkB9B;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,CAMnB;IAED;;;OAGG;IACH,wBAFW,SAAS,QAQnB;IAED;;;OAGG;IACH,wBAFW,SAAS,QASnB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACL,SAAS,GAAC,SAAS,CAiB9B;IAED;;;OAGG;IACH,kBAFY,MAAM,CAWjB;IAED;;;OAGG;IACH,iBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,qBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAIC;IAED;;OAEG;IACH,mBASC;IAED,qBAIC;IAED;;OAEG;IACH,qCAoBC;IAED,8BAaC;IAED,8BAKC;IAED,2BAeC;IAED,sBAOC;IAED,uBA4BC;IAmFD,uBAOC;IAED,wBAWC;IAED;;;OAGG;IACH,YAFW,QAAQ,QAmBlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED,eAEC;IAED;;;OAGG;IACH,iCAYC;IAGL;;;OAGG;IACH,qBAFU,OAAO,CAEY;;CAN5B;0BAtkByB,gBAAgB"}
+{"version":3,"file":"Geometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/Geometry.js"],"names":[],"mappings":"4BA2BU,MAAM;;;;AAQhB;;GAEG;AACH;IAQI;;;;OAIG;IACH,iBAEC;IAED;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,YAFU,SAAS,EAAE,CAEL;IAEhB;;;OAGG;IACH,OAFU,SAAS,GAAC,IAAI,CAEX;IAEb;;;OAGG;IACH,cAFU,YAAY,CAEa;IACnC;;;OAGG;IACH,iBAFU,YAAY,CAEgB;IAEtC;;;OAGG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;;;;;;;OAUG;IACH,sBAEC;IAED;;OAEG;IACH,8BAIC;IAGD;;;;OAIG;IACH,cAHW,MAAM,GAAC,aAAa,GAClB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,aAAa,GAClB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,aAAa,SACpB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,aAAa,GAClB,OAAO,CAInB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAYnB;IAED,eAQC;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACL,SAAS,GAAC,SAAS,CAkB9B;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,CAMnB;IAED;;;OAGG;IACH,wBAFW,SAAS,QAQnB;IAED;;;OAGG;IACH,wBAFW,SAAS,QASnB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACL,SAAS,GAAC,SAAS,CAiB9B;IAED;;;OAGG;IACH,kBAFY,MAAM,CAWjB;IAED;;;OAGG;IACH,iBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,qBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAIC;IAED;;OAEG;IACH,mBASC;IAED,qBAIC;IAED;;OAEG;IACH,qCAoBC;IAED,8BAaC;IAED,8BAKC;IAED,2BAeC;IAED,sBAOC;IAED,uBA4BC;IAoFD,uBAOC;IAED,wBAWC;IAED;;;OAGG;IACH,YAFW,QAAQ,QAmBlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED,eAEC;IAED;;;OAGG;IACH,iCAYC;IAGL;;;OAGG;IACH,qBAFU,OAAO,CAEY;;CAN5B;0BAvkByB,gBAAgB"}

package/src/shade/renderer/geometry/Geometry.js

@@ -457,7 +457,12 @@ export class Geometry {
     }
 
     #compute_tangents_uv() {
-        // based on implementation from three.js
+        /*
+         A port of three's `BufferGeometry.computeTangents`, which is itself Lengyel's
+         per-vertex tangent method (http://www.terathon.com/code/tangent.html).
+
+         Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+        */
 
         const index = this.index;
 
@@ -465,10 +470,6 @@ export class Geometry {
         const normal_attribute = this.getAttribute(StandardAttributes.Normal);
         const uv_attribute = this.getAttribute(StandardAttributes.TextureCoordinates0);
 
-
-        // based on http://www.terathon.com/code/tangent.html
-        // (per vertex tangents)
-
         if (index === null ||
             position_attribute === undefined ||
             normal_attribute === undefined ||

package/src/shade/renderer/geometry/primitives/make_box_geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make_box_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_box_geometry.js"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,6JAFa,QAAQ,CAuIpB;yBAlJwB,gBAAgB"}
+{"version":3,"file":"make_box_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_box_geometry.js"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,6JAFa,QAAQ,CA4IpB;yBAvJwB,gBAAgB"}

package/src/shade/renderer/geometry/primitives/make_box_geometry.js

@@ -14,7 +14,12 @@ import { StandardAttributes } from "../StandardAttributes.js";
  */
 export function make_box_geometry(width = 1, height = 1, depth = 1, widthSegments = 1, heightSegments = 1, depthSegments = 1) {
 
-    // based on three.js code
+    /*
+     A port of three's `BoxGeometry` onto `Geometry`: the same subdivision and the same
+     winding, writing meep attributes instead of three ones.
+
+     Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+    */
 
     const geo = new Geometry();
 

package/src/shade/renderer/geometry/primitives/make_cylinder_geometry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The axis runs along Y and the body is centred on the origin.
+ *
+ * `Geometry` carries no multi-material groups, so the torso and the two caps are one index run
+ * rather than three; three's cylinder splits them only to address a material array.
+ *
+ * @param {number} [radiusTop]
+ * @param {number} [radiusBottom]
+ * @param {number} [height]
+ * @param {number} [radialSegments] segments around the axis
+ * @param {number} [heightSegments] segments along the axis
+ * @param {boolean} [openEnded] leave the caps off, which makes the surface a tube rather than a solid
+ * @param {number} [thetaStart]
+ * @param {number} [thetaLength] how much of the turn to build, in radians
+ * @returns {Geometry}
+ */
+export function make_cylinder_geometry(radiusTop?: number, radiusBottom?: number, height?: number, radialSegments?: number, heightSegments?: number, openEnded?: boolean, thetaStart?: number, thetaLength?: number): Geometry;
+import { Geometry } from "../Geometry.js";
+//# sourceMappingURL=make_cylinder_geometry.d.ts.map

package/src/shade/renderer/geometry/primitives/make_cylinder_geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make_cylinder_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_cylinder_geometry.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,mDAVW,MAAM,iBACN,MAAM,WACN,MAAM,mBACN,MAAM,mBACN,MAAM,cACN,OAAO,eACP,MAAM,gBACN,MAAM,GACJ,QAAQ,CA6NpB;yBA9OwB,gBAAgB"}