@woosh/meep-engine 2.49.8 → 2.50.0

package/src/engine/graphics/camera/testClippingPlaneComputation.js

@@ -38,7 +38,7 @@ import { FogOfWarSystem } from "../../ecs/fow/FogOfWarSystem.js";
 import { FogOfWarRevealerSystem } from "../../ecs/fow/FogOfWarRevealerSystem.js";
 import { BehaviorSystem } from "../../intelligence/behavior/ecs/BehaviorSystem.js";
 import { SerializationMetadataSystem } from "../../ecs/systems/SerializationMetadataSystem.js";
-import { InverseKinematicsSystem } from "../../ecs/animation/InverseKinematicsSystem.js";
+import { InverseKinematicsSystem } from "../../ecs/ik/InverseKinematicsSystem.js";
 import { PathDisplaySystem } from "../ecs/path/PathDisplaySystem.js";
 import RenderSystem from "../../ecs/systems/RenderSystem.js";
 import { makeEngineOptionsModel } from "../../../../../model/game/options/makeEngineOptionsModel.js";

package/src/engine/graphics/ecs/animation/AnimationControllerSystem.js

@@ -6,6 +6,7 @@
 import { System } from '../../../ecs/System.js';
 import AnimationController from './AnimationController.js';
 import { Animation } from '../../../ecs/animation/Animation.js';
+import { AnimationClip } from "../../../ecs/animation/AnimationClip.js";
 
 class AnimationControllerSystem extends System {
     constructor() {
@@ -33,7 +34,7 @@ class AnimationControllerSystem extends System {
                 removeAnimation(animation);
 
                 //create a new animation according to the rule
-                const clip = new Animation.Clip();
+                const clip = new AnimationClip();
                 clip.fromJSON({
                     name: r.animation,
                     timeScale: r.speed,

package/src/engine/graphics/ecs/path/testPathDisplaySystem.js

@@ -39,7 +39,7 @@ import AnimationControllerSystem from "../animation/AnimationControllerSystem.js
 import { AnimationGraphSystem } from "../animation/animator/AnimationGraphSystem.js";
 import { BehaviorSystem } from "../../../intelligence/behavior/ecs/BehaviorSystem.js";
 import { SerializationMetadataSystem } from "../../../ecs/systems/SerializationMetadataSystem.js";
-import { InverseKinematicsSystem } from "../../../ecs/animation/InverseKinematicsSystem.js";
+import { InverseKinematicsSystem } from "../../../ecs/ik/InverseKinematicsSystem.js";
 import { PathDisplaySystem } from "./PathDisplaySystem.js";
 import { PathDisplay } from "./PathDisplay.js";
 import { PathDisplayType } from "./PathDisplayType.js";

package/src/engine/graphics/ecs/path/tube/build/computeFrenetFrames.js

@@ -3,7 +3,7 @@ import { max2 } from "../../../../../../core/math/max2.js";
 import { min2 } from "../../../../../../core/math/min2.js";
 import { clamp } from "../../../../../../core/math/clamp.js";
 import { vec3 } from "gl-matrix";
-import { array_copy } from "../../../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../../../core/collection/array/array_copy.js";
 
 /**
  * Compute a normal vector for Frenet frame based on a tangent (direction in which vertex points)

package/src/engine/graphics/ecs/path/tube/prototypeAnimatedPathMask.js

@@ -37,7 +37,7 @@ import AnimationControllerSystem from "../../animation/AnimationControllerSystem
 import { AnimationGraphSystem } from "../../animation/animator/AnimationGraphSystem.js";
 import { BehaviorSystem } from "../../../../intelligence/behavior/ecs/BehaviorSystem.js";
 import { SerializationMetadataSystem } from "../../../../ecs/systems/SerializationMetadataSystem.js";
-import { InverseKinematicsSystem } from "../../../../ecs/animation/InverseKinematicsSystem.js";
+import { InverseKinematicsSystem } from "../../../../ecs/ik/InverseKinematicsSystem.js";
 import { PathDisplaySystem } from "../PathDisplaySystem.js";
 import {
     AmbientOcclusionPostProcessEffect

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

@@ -8,7 +8,7 @@ import { GROUP_WITH_ANY } from "./constants/GROUP_WITH_ANY.js";
 import { INTERNAL_RND_SORT_SEED } from "./constants/INTERNAL_RND_SORT_SEED.js";
 import { QuickSort } from "./QuickSort.js";
 import { CompareSubGroups } from "./CompareSubGroups.js";
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { EvalTspace } from "./EvalTspace.js";
 import { ORIENT_PRESERVING } from "./constants/ORIENT_PRESERVING.js";
 import { AvgTSpace } from "./AvgTSpace.js";

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

@@ -1,4 +1,4 @@
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 
 /**
  *

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

@@ -1,4 +1,4 @@
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 
 /**
  *

package/src/engine/graphics/geometry/bvh/buffered/BVHGeometryRaycaster.js

@@ -8,7 +8,7 @@ import { v3_length } from "../../../../../core/geom/v3_length.js";
 import { ray3_array_apply_matrix4 } from "../../../../../core/geom/3d/ray/ray3_array_apply_matrix4.js";
 import { mat4 } from "gl-matrix";
 import { ray3_array_compose } from "../../../../../core/geom/3d/ray/ray3_array_compose.js";
-import { array_copy } from "../../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../../core/collection/array/array_copy.js";
 import { MATRIX_4_IDENTITY } from "../../../../../core/geom/3d/matrix/MATRIX_4_IDENTITY.js";
 
 const hit = new ThreeVector3();

package/src/engine/graphics/geometry/instancing/InstancedMeshGroup.js

@@ -17,7 +17,7 @@ import { rewriteMaterial } from "./rewriteMaterial.js";
 import { max3 } from "../../../../core/math/max3.js";
 import { min2 } from "../../../../core/math/min2.js";
 import { DrawMode } from "../../ecs/mesh-v2/DrawMode.js";
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { Cache } from "../../../../core/cache/Cache.js";
 import { computeMaterialHash } from "../../../asset/loaders/material/computeMaterialHash.js";
 

package/src/engine/graphics/geometry/optimization/merge/merge_geometry_hierarchy.js

@@ -2,7 +2,7 @@ import { StaticMaterialCache } from "../../../../asset/loaders/material/StaticMa
 import { HashMap } from "../../../../../core/collection/HashMap.js";
 import { computeGeometryEquality } from "../../buffered/computeGeometryEquality.js";
 import { computeGeometryHash } from "../../buffered/computeGeometryHash.js";
-import { array_copy } from "../../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../../core/collection/array/array_copy.js";
 import { mat4 } from "gl-matrix";
 import { Group, Matrix4, Mesh } from "three";
 import { mergeBufferGeometries } from "three/examples/jsm/utils/BufferGeometryUtils.js";

package/src/engine/graphics/impostors/octahedral/util/build_cutout_from_atlas_by_alpha.js

@@ -3,7 +3,7 @@
 import { renderSamplerFromTexture } from "../../../render/visibility/hiz/buildCanvasViewFromTexture.js";
 import { convex_hull_jarvis_2d } from "../../../../../core/geom/2d/convex-hull/convex_hull_jarvis_2d.js";
 import { fixed_convex_hull_relaxation } from "../../../../../core/geom/2d/convex-hull/fixed_convex_hull_relaxation.js";
-import { array_copy } from "../../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../../core/collection/array/array_copy.js";
 import { Sampler2D } from "../../../texture/sampler/Sampler2D.js";
 import { max2 } from "../../../../../core/math/max2.js";
 import { sampler2d_find_pixels } from "../../../texture/sampler/search/sampler2d_find_pixels.js";

package/src/engine/graphics/load_and_set_cubemap_v0.js

@@ -12,7 +12,7 @@ export async function load_and_set_cubemap_v0(graphics, folder_path, file_extens
 
     const { filtered } = await load_environment_map({
         path: paths,
-        renderer: this.renderer,
+        renderer: graphics.renderer,
         original: false,
         filtered: true
     });

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

@@ -2,7 +2,7 @@ import Signal from "../../../../../../../core/events/signal/Signal.js";
 import {
     DataType2TypedArrayConstructorMapping
 } from "../../../../../../../core/binary/type/DataType2TypedArrayConstructorMapping.js";
-import { array_copy } from "../../../../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../../../../core/collection/array/array_copy.js";
 import { min2 } from "../../../../../../../core/math/min2.js";
 import { assert } from "../../../../../../../core/assert.js";
 import { ParameterLookupTable } from "../../parameter/ParameterLookupTable.js";

package/src/engine/graphics/render/Lines.js

@@ -1,5 +1,5 @@
 import { DynamicDrawUsage, LineBasicMaterial, LineSegments } from "three";
-import { array_copy } from "../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../core/collection/array/array_copy.js";
 import { BufferGeometry } from "three/src/core/BufferGeometry.js";
 import { Float32BufferAttribute } from "three/src/core/BufferAttribute.js";
 

package/src/engine/graphics/render/buffer/buffers/prototypeNormalFrameBuffer.js

@@ -39,7 +39,7 @@ import { FogOfWarSystem } from "../../../../ecs/fow/FogOfWarSystem.js";
 import { FogOfWarRevealerSystem } from "../../../../ecs/fow/FogOfWarRevealerSystem.js";
 import { BehaviorSystem } from "../../../../intelligence/behavior/ecs/BehaviorSystem.js";
 import { SerializationMetadataSystem } from "../../../../ecs/systems/SerializationMetadataSystem.js";
-import { InverseKinematicsSystem } from "../../../../ecs/animation/InverseKinematicsSystem.js";
+import { InverseKinematicsSystem } from "../../../../ecs/ik/InverseKinematicsSystem.js";
 import { CanvasView } from "../../../../../view/elements/CanvasView.js";
 import Vector3 from "../../../../../core/geom/Vector3.js";
 import Vector2 from "../../../../../core/geom/Vector2.js";

package/src/engine/graphics/render/buffer/simple-fx/taa/TemporalSupersamplingRenderPlugin.js

@@ -1,6 +1,6 @@
 import { EnginePlugin } from "../../../../../plugin/EnginePlugin.js";
 import { halton_sequence } from "../../../../../../core/math/statistics/halton_sequence.js";
-import { array_copy } from "../../../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../../../core/collection/array/array_copy.js";
 
 /**
  * Generates a number of 2d jitter offsets in range -1...1

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

@@ -38,7 +38,7 @@ import { Decal } from "./model/Decal.js";
 import { ReferencedTextureAtlas } from "../../texture/atlas/ReferencedTextureAtlas.js";
 import { v3_morton_encode_transformed } from "../../../../core/geom/3d/morton/v3_morton_encode_transformed.js";
 import { v3_distance } from "../../../../core/geom/v3_distance.js";
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { arrayQuickSort } from "../../../../core/collection/array/arrayQuickSort.js";
 import { frustum_from_camera } from "../../ecs/camera/frustum_from_camera.js";
 import { arraySwapElements } from "../../../../core/collection/array/arraySwapElements.js";

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

@@ -1,7 +1,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/copyArray.js";
+import { array_copy } from "../../../../../core/collection/array/array_copy.js";
 import { mat4 } from "gl-matrix";
 import Signal from "../../../../../core/events/signal/Signal.js";
 

package/src/engine/graphics/render/forward_plus/plugin/ptototypeFPPlugin.js

@@ -40,7 +40,7 @@ import { FogOfWarSystem } from "../../../../ecs/fow/FogOfWarSystem.js";
 import { FogOfWarRevealerSystem } from "../../../../ecs/fow/FogOfWarRevealerSystem.js";
 import { BehaviorSystem } from "../../../../intelligence/behavior/ecs/BehaviorSystem.js";
 import { SerializationMetadataSystem } from "../../../../ecs/systems/SerializationMetadataSystem.js";
-import { InverseKinematicsSystem } from "../../../../ecs/animation/InverseKinematicsSystem.js";
+import { InverseKinematicsSystem } from "../../../../ecs/ik/InverseKinematicsSystem.js";
 import { PathDisplaySystem } from "../../../ecs/path/PathDisplaySystem.js";
 import {
     BoxBufferGeometry,

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

@@ -49,7 +49,7 @@ import { Decal } from "../model/Decal.js";
 import { mat4 } from "gl-matrix";
 import { Sampler2D } from "../../../texture/sampler/Sampler2D.js";
 import { makeHelperBoxGeometry } from "../../../../../../editor/process/symbolic/makeHelperBoxGeometry.js";
-import { array_copy } from "../../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../../core/collection/array/array_copy.js";
 import { BufferGeometry } from "three/src/core/BufferGeometry.js";
 import { Float32BufferAttribute } from "three/src/core/BufferAttribute.js";
 import Quaternion from "../../../../../core/geom/Quaternion.js";

package/src/engine/graphics/render/gizmo/GizmoShapeRenderingInterface.js

@@ -1,4 +1,4 @@
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { assert } from "../../../../core/assert.js";
 import { InstancedMeshGroup } from "../../geometry/instancing/InstancedMeshGroup.js";
 import { BoxBufferGeometry, LineBasicMaterial, MeshBasicMaterial, OctahedronBufferGeometry } from "three";

package/src/engine/graphics/render/view/CameraView.js

@@ -6,7 +6,7 @@ import { read_frustum_planes_to_array } from "../../../../core/geom/3d/frustum/r
 import Signal from "../../../../core/events/signal/Signal.js";
 import { compare_three_objects } from "../../three/compare_three_objects.js";
 import { frustum_from_camera } from "../../ecs/camera/frustum_from_camera.js";
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { array_remove_first } from "../../../../core/collection/array/array_remove_first.js";
 
 const DEFAULT_FLAGS = CameraViewFlags.Active

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

@@ -39,7 +39,7 @@ import { FogOfWarSystem } from "../../../../ecs/fow/FogOfWarSystem.js";
 import { FogOfWarRevealerSystem } from "../../../../ecs/fow/FogOfWarRevealerSystem.js";
 import { BehaviorSystem } from "../../../../intelligence/behavior/ecs/BehaviorSystem.js";
 import { SerializationMetadataSystem } from "../../../../ecs/systems/SerializationMetadataSystem.js";
-import { InverseKinematicsSystem } from "../../../../ecs/animation/InverseKinematicsSystem.js";
+import { InverseKinematicsSystem } from "../../../../ecs/ik/InverseKinematicsSystem.js";
 import Vector3 from "../../../../../core/geom/Vector3.js";
 import Vector2 from "../../../../../core/geom/Vector2.js";
 import RenderSystem from "../../../../ecs/systems/RenderSystem.js";

package/src/engine/graphics/render/visibility/hiz/query/BatchOcclusionQuery.js

@@ -8,7 +8,7 @@ import {
     UnsignedByteType,
     WebGLRenderTarget
 } from "three";
-import { array_copy } from "../../../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../../../core/collection/array/array_copy.js";
 import { makeQueryShader } from "./QueryShader.js";
 import { renderScreenSpace } from "../../../utils/renderScreenSpace.js";
 import { assert } from "../../../../../../core/assert.js";

package/src/engine/graphics/render/webgpu/sample/MeshInstance.js

@@ -1,4 +1,4 @@
-import { array_copy } from "../../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../../core/collection/array/array_copy.js";
 
 const BIND_GROUP_MATERIAL = 1;
 

package/src/engine/graphics/sh3/LightProbeVolume.js

@@ -19,7 +19,7 @@ import {
 } from "three";
 import { DrawMode } from "../ecs/mesh-v2/DrawMode.js";
 import { Transform } from "../../ecs/transform/Transform.js";
-import { array_copy } from "../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../core/collection/array/array_copy.js";
 import { SurfacePoint3 } from "../../../core/geom/3d/SurfacePoint3.js";
 import { Light } from "../ecs/light/Light.js";
 import { threeMakeLight } from "../ecs/light/binding/three/threeMakeLight.js";

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

@@ -1,4 +1,4 @@
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { mat4 } from "gl-matrix";
 import { ray3_array_apply_matrix4 } from "../../../../core/geom/3d/ray/ray3_array_apply_matrix4.js";
 import { ray_hit_apply_transform } from "./ray_hit_apply_transform.js";

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

@@ -3,7 +3,7 @@ import {
 } from "../../../../core/bvh2/bvh3/ExplicitBinaryBoundingVolumeHierarchy.js";
 import { bvh_query_leaves_ray } from "../../../../core/bvh2/bvh3/query/bvh_query_leaves_ray.js";
 import { aabb3_matrix4_project } from "../../../../core/geom/3d/aabb/aabb3_matrix4_project.js";
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { mat4, vec3 } from "gl-matrix";
 import { ensureGeometryBoundingBox } from "../../util/ensureGeometryBoundingBox.js";
 import { GeometryBVHBatched } from "./GeometryBVHBatched.js";

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

@@ -3,7 +3,7 @@ import {
     sky_hosek_precompute
 } from "../sky/hosek/sky_hosek_compute_irradiance_by_direction.js";
 import { vec3 } from "gl-matrix";
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { max2 } from "../../../../core/math/max2.js";
 
 export function make_sky_hosek(sun = [0, 1, 0], turbidity = 1, overcast = 0, albedo = [0, 0, 0]) {

package/src/engine/graphics/sh3/prototypeSH3Probe.js

@@ -19,7 +19,7 @@ import { Transform } from "../../ecs/transform/Transform.js";
 import Vector3 from "../../../core/geom/Vector3.js";
 import { BinaryBuffer } from "../../../core/binary/BinaryBuffer.js";
 import { is_typed_array_equals } from "../../../core/collection/array/typed/is_typed_array_equals.js";
-import { array_copy } from "../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../core/collection/array/array_copy.js";
 import { randomFloatBetween } from "../../../core/math/random/randomFloatBetween.js";
 import { GLTFAssetLoader } from "../../asset/loaders/GLTFAssetLoader.js";
 import { three_object_to_entity_composition } from "../ecs/mesh-v2/three_object_to_entity_composition.js";

package/src/engine/graphics/texture/3d/scs3d_read_2d_slice.js

@@ -1,4 +1,4 @@
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 
 /**
  *

package/src/engine/graphics/texture/CanvasClone.js

@@ -3,7 +3,11 @@
  */
 
 
-
+/**
+ *
+ * @param {HTMLCanvasElement} oldCanvas
+ * @return {HTMLCanvasElement}
+ */
 function cloneCanvas(oldCanvas) {
 
     //create a new canvas

package/src/engine/graphics/texture/sampler/Sampler2D.js

@@ -92,50 +92,14 @@ export class Sampler2D {
     }
 
     /**
+     * @deprecated
      * @param {number[]} result
+     * @param {number} result_offset
      * @param {number} [channel=0]
+     * @returns {number} number of matches written to result array
      */
-    computeMinIndices(result, channel = 0) {
-        const itemSize = this.itemSize;
-
-        assert.typeOf(channel, "number", "channel");
-        assert.ok(channel >= 0, `channel must be >= 0, was ${channel}`);
-        assert.ok(channel < itemSize, `channel must be less than itemSize(=${itemSize}), was ${channel}`);
-
-        assert.ok(Array.isArray(result), "result is not an array");
-
-        const data = this.data;
-
-        const l = data.length;
-
-        if (l === 0) {
-            //no data
-            return;
-        }
-
-        let bestValue = data[channel];
-
-        let resultCount = 0;
-
-        for (let i = channel + itemSize; i < l; i += itemSize) {
-            const value = data[i];
-
-            if (bestValue > value) {
-                bestValue = value;
-                //drop result
-                resultCount = 1;
-
-                result[0] = i;
-            } else if (value === bestValue) {
-                result[resultCount++] = i;
-            }
-
-        }
-
-        //crop results
-        if (resultCount < result.length) {
-            result.splice(resultCount, result.length - resultCount);
-        }
+    computeMinIndices(result, result_offset = 0, channel = 0) {
+        throw new Error("deprecated, use sampler2d_channel_compute_min_indices")
     }
 
     /**
@@ -410,7 +374,7 @@ export class Sampler2D {
      *
      * @param {number} x
      * @param {number} y
-     * @param {number[]} result
+     * @param {number[]|Float32Array|Float64Array} result
      * @param {number} result_offset
      */
     sampleBilinear(x, y, result, result_offset = 0) {
@@ -446,6 +410,12 @@ export class Sampler2D {
      * @returns {number}
      */
     sampleChannelBilinear(x, y, channel) {
+        assert.isNumber(x, 'x');
+        assert.notNaN(x, 'x');
+
+        assert.isNumber(y, 'y');
+        assert.notNaN(y, 'y');
+
         assert.isNonNegativeInteger(channel, 'channel');
 
         const itemSize = this.itemSize;
@@ -548,6 +518,7 @@ export class Sampler2D {
         assert.isNumber(channel, "channel");
 
         assert.isNonNegativeInteger(channel, 'channel');
+        assert.lessThanOrEqual(channel, this.itemSize);
 
         const index = (y * this.width + x) * this.itemSize + channel;
 
@@ -933,6 +904,7 @@ export class Sampler2D {
 
     /**
      * Fill data values with zeros for a given area
+     * Specialized version of `fill` method, optimized for speed
      * @param {Number} x
      * @param {Number} y
      * @param {Number} width
@@ -1205,39 +1177,6 @@ export class Sampler2D {
         throw new Error('Deprecated, use Sampler2DSerializationAdapter instead');
     }
 
-    /**
-     *
-     * @param {number} x
-     * @param {number} y
-     * @param {function(x:number, y:number, value:number, index:number):boolean?} visitor
-     * @param {*} [thisArg]
-     */
-    traverseOrthogonalNeighbours(x, y, visitor, thisArg) {
-        const width = this.width;
-        const height = this.height;
-
-        const index = this.point2index(x, y);
-
-        let i = 0;
-        const data = this.data;
-        if (x > 0) {
-            i = index - 1;
-            visitor.call(thisArg, x - 1, y, data[i], i);
-        }
-        if (x < width - 1) {
-            i = index + 1;
-            visitor.call(thisArg, x + 1, y, data[i], i);
-        }
-        if (y > 0) {
-            i = index - width;
-            visitor.call(thisArg, x, y - 1, data[i], i);
-        }
-        if (y < height - 1) {
-            i = index + width;
-            visitor.call(thisArg, x, y + 1, data[i], i);
-        }
-    }
-
     /**
      *
      * @param {Sampler2D} other

package/src/engine/graphics/texture/sampler/bicubic.js

@@ -1,24 +1,24 @@
 /**
  * @see https://github.com/hughsk/bicubic/blob/master/index.js
- * @param xf
- * @param yf
- * @param p00
- * @param p01
- * @param p02
- * @param p03
- * @param p10
- * @param p11
- * @param p12
- * @param p13
- * @param p20
- * @param p21
- * @param p22
- * @param p23
- * @param p30
- * @param p31
- * @param p32
- * @param p33
- * @returns {*}
+ * @param {number} xf
+ * @param {number} yf
+ * @param {number} p00
+ * @param {number} p01
+ * @param {number} p02
+ * @param {number} p03
+ * @param {number} p10
+ * @param {number} p11
+ * @param {number} p12
+ * @param {number} p13
+ * @param {number} p20
+ * @param {number} p21
+ * @param {number} p22
+ * @param {number} p23
+ * @param {number} p30
+ * @param {number} p31
+ * @param {number} p32
+ * @param {number} p33
+ * @returns {number}
  */
 export function bicubic(
     xf, yf

package/src/engine/graphics/texture/sampler/convertSampler2D2DataURL.spec.js

@@ -0,0 +1,10 @@
+import { convertSampler2D2DataURL } from "./convertSampler2D2DataURL.js";
+import { Sampler2D } from "./Sampler2D.js";
+
+// currently does not run in Node.js context due to reliance on HTMLCanvasElement that is absent in Node.js
+test.skip("result is a data URL", () => {
+    const result = convertSampler2D2DataURL(Sampler2D.uint8(4, 1, 1));
+
+    expect(typeof result).toBe('string');
+    expect(result.startsWith("data://")).toBe(true);
+});

package/src/engine/graphics/texture/sampler/copy_Sampler2D_channel_data.spec.js

@@ -0,0 +1,90 @@
+import { copy_Sampler2D_channel_data } from "./copy_Sampler2D_channel_data.js";
+import { Sampler2D } from "./Sampler2D.js";
+
+test("should throw when dimensions do not match", () => {
+    expect(() => copy_Sampler2D_channel_data(
+        Sampler2D.uint8(1, 1, 1),
+        Sampler2D.uint8(1, 2, 1),
+    )).toThrow();
+
+    expect(() => copy_Sampler2D_channel_data(
+        Sampler2D.uint8(1, 2, 1),
+        Sampler2D.uint8(1, 1, 1),
+    )).toThrow();
+
+    expect(() => copy_Sampler2D_channel_data(
+        Sampler2D.uint8(1, 1, 2),
+        Sampler2D.uint8(1, 1, 1),
+    )).toThrow();
+
+    expect(() => copy_Sampler2D_channel_data(
+        Sampler2D.uint8(1, 1, 1),
+        Sampler2D.uint8(1, 1, 2),
+    )).toThrow();
+
+    expect(() => copy_Sampler2D_channel_data(
+        Sampler2D.uint8(1, 2, 2),
+        Sampler2D.uint8(1, 1, 1),
+    )).toThrow();
+
+    expect(() => copy_Sampler2D_channel_data(
+        Sampler2D.uint8(1, 1, 1),
+        Sampler2D.uint8(1, 2, 2),
+    )).toThrow();
+});
+
+test("channel counts match", () => {
+    const source = Sampler2D.uint8(1, 1, 1);
+    source.writeChannel(0, 0, 0, 7);
+
+    const target = Sampler2D.uint8(1, 1, 1);
+
+    copy_Sampler2D_channel_data(source, target);
+
+    expect(target.readChannel(0, 0, 0)).toEqual(7);
+});
+
+test("from 2 channels to 1", () => {
+
+    const source = Sampler2D.uint8(2, 1, 1);
+    source.writeChannel(0, 0, 0, 7);
+    source.writeChannel(0, 0, 1, 13);
+
+    const target = Sampler2D.uint8(1, 1, 1);
+
+    copy_Sampler2D_channel_data(source, target);
+
+    expect(target.readChannel(0, 0, 0)).toEqual(7);
+});
+
+test("from 3 channels to 4", () => {
+
+    const source = Sampler2D.uint8(3, 1, 1);
+    source.set(0, 0, [3, 7, 13]);
+
+    const target = Sampler2D.uint8(4, 1, 1);
+
+    copy_Sampler2D_channel_data(source, target);
+
+    const sample = [];
+
+    target.read(0, 0, sample);
+
+    expect(sample).toEqual([3, 7, 13, 255]);
+});
+
+test("from 2 channels to 4", () => {
+
+    const source = Sampler2D.uint8(2, 1, 1);
+    source.set(0, 0, [3, 7]);
+
+    const target = Sampler2D.uint8(4, 1, 1);
+
+    copy_Sampler2D_channel_data(source, target);
+
+    const sample = [];
+
+    target.read(0, 0, sample);
+
+    expect(sample).toEqual([3, 3, 3, 7]);
+});