leaflet-city-mapper 0.1.0 → 0.1.1

package/src/cog/validCogGeoArrays.js

@@ -1,17 +1,17 @@
-import { finiteCogValues } from './finiteCogValues.js';
-
-/**
- * Validate the structure and numeric values of GeoTIFF key, pixel scale and tiepoint arrays.
- *
- * @param {Array<number>} keys GeoKey directory.
- * @param {Array<number>} scale Pixel scale values.
- * @param {Array<number>} tie Tiepoint values.
- *
- * @returns {boolean} Whether the arrays describe a supported north-up grid.
- */
-export function validCogGeoArrays(keys, scale, tie) {
-  return !!keys && keys[0] === 1 && keys.length === 4 + keys[3] * 4 &&
-    !!scale && scale.length === 3 && finiteCogValues(scale) &&
-    scale[0] > 0 && Math.abs(scale[0] - scale[1]) <= 1e-8 &&
-    !!tie && tie.length === 6 && finiteCogValues(tie) && tie[0] === 0 && tie[1] === 0;
-}
+import { finiteCogValues } from './finiteCogValues.js';
+
+/**
+ * Validate the structure and numeric values of GeoTIFF key, pixel scale and tiepoint arrays.
+ *
+ * @param {Array<number>} keys GeoKey directory.
+ * @param {Array<number>} scale Pixel scale values.
+ * @param {Array<number>} tie Tiepoint values.
+ *
+ * @returns {boolean} Whether the arrays describe a supported north-up grid.
+ */
+export function validCogGeoArrays(keys, scale, tie) {
+  return !!keys && keys[0] === 1 && keys.length === 4 + keys[3] * 4 &&
+    !!scale && scale.length === 3 && finiteCogValues(scale) &&
+    scale[0] > 0 && Math.abs(scale[0] - scale[1]) <= 1e-8 &&
+    !!tie && tie.length === 6 && finiteCogValues(tie) && tie[0] === 0 && tie[1] === 0;
+}

package/src/cog/validCogGrid.js

@@ -1,22 +1,22 @@
-/**
- * Check that a COG level aligns with the supported Web Mercator XYZ grid.
- *
- * @param {Object} source COG source and existing levels.
- * @param {Object} base Base image profile and georeferencing.
- * @param {Object} profile Level dimensions and elevation flag.
- * @param {number} zoom Derived XYZ zoom.
- * @param {number} x Level's XYZ column origin.
- * @param {number} y Level's XYZ row origin.
- * @param {number} resolution Level resolution.
- *
- * @returns {boolean} Whether the level is supported and grid-aligned.
- */
-export function validCogGrid(source, base, profile, zoom, x, y, resolution) {
-  return zoom >= 0 && zoom <= 24 &&
-    Math.abs(20037508.342789244 * 2 / (256 * 2 ** zoom) - resolution) <= resolution * 1e-7 &&
-    (!profile.elevation || Number.isInteger(x) && Number.isInteger(y)) &&
-    Math.abs(base.width / profile.width - base.height / profile.height) <= 1e-7 &&
-    profile.elevation === base.elevation &&
-    x >= 0 && y >= 0 && x + profile.width / 256 <= 2 ** zoom && y + profile.height / 256 <= 2 ** zoom &&
-    !source.levels.has(zoom) && !(base.elevation && source.levels.size);
-}
+/**
+ * Check that a COG level aligns with the supported Web Mercator XYZ grid.
+ *
+ * @param {Object} source COG source and existing levels.
+ * @param {Object} base Base image profile and georeferencing.
+ * @param {Object} profile Level dimensions and elevation flag.
+ * @param {number} zoom Derived XYZ zoom.
+ * @param {number} x Level's XYZ column origin.
+ * @param {number} y Level's XYZ row origin.
+ * @param {number} resolution Level resolution.
+ *
+ * @returns {boolean} Whether the level is supported and grid-aligned.
+ */
+export function validCogGrid(source, base, profile, zoom, x, y, resolution) {
+  return zoom >= 0 && zoom <= 24 &&
+    Math.abs(20037508.342789244 * 2 / (256 * 2 ** zoom) - resolution) <= resolution * 1e-7 &&
+    (!profile.elevation || Number.isInteger(x) && Number.isInteger(y)) &&
+    Math.abs(base.width / profile.width - base.height / profile.height) <= 1e-7 &&
+    profile.elevation === base.elevation &&
+    x >= 0 && y >= 0 && x + profile.width / 256 <= 2 ** zoom && y + profile.height / 256 <= 2 ** zoom &&
+    !source.levels.has(zoom) && !(base.elevation && source.levels.size);
+}

package/src/cog/validCogTileCoordinates.js

@@ -1,13 +1,13 @@
-/**
- * Check that XYZ coordinates are safe integers within the supported zoom and tile range.
- *
- * @param {number} z Tile zoom.
- * @param {number} x Tile column.
- * @param {number} y Tile row.
- *
- * @returns {boolean} Whether the coordinates are valid.
- */
-export function validCogTileCoordinates(z, x, y) {
-  return Number.isSafeInteger(z) && Number.isSafeInteger(x) && Number.isSafeInteger(y) &&
-    z >= 0 && z <= 24 && x >= 0 && y >= 0 && x < 2 ** z && y < 2 ** z;
-}
+/**
+ * Check that XYZ coordinates are safe integers within the supported zoom and tile range.
+ *
+ * @param {number} z Tile zoom.
+ * @param {number} x Tile column.
+ * @param {number} y Tile row.
+ *
+ * @returns {boolean} Whether the coordinates are valid.
+ */
+export function validCogTileCoordinates(z, x, y) {
+  return Number.isSafeInteger(z) && Number.isSafeInteger(x) && Number.isSafeInteger(y) &&
+    z >= 0 && z <= 24 && x >= 0 && y >= 0 && x < 2 ** z && y < 2 ** z;
+}

package/src/cog/validateCogContainer.js

@@ -1,17 +1,17 @@
-/**
- * Validate the PMTiles header and bounds for a COG asset container.
- *
- * @param {Object} container Container source with known size.
- * @param {Object} header Decoded PMTiles header.
- *
- * @throws {Error} If the container metadata or tile data range is invalid.
- */
-export function validateCogContainer(container, header) {
-  if (header.tileType !== 0 || header.tileCompression !== 1 ||
-    !Number.isSafeInteger(header.jsonMetadataOffset) || !Number.isSafeInteger(header.jsonMetadataLength) ||
-    header.jsonMetadataLength <= 0 || header.jsonMetadataLength > 1048576 ||
-    !Number.isSafeInteger(header.tileDataOffset) || !Number.isSafeInteger(header.tileDataLength) ||
-    header.tileDataOffset < 127 || header.tileDataOffset + header.tileDataLength > container.size) {
-    throw /* alloc */ new Error('Invalid PMTiles COG asset container');
-  }
-}
+/**
+ * Validate the PMTiles header and bounds for a COG asset container.
+ *
+ * @param {Object} container Container source with known size.
+ * @param {Object} header Decoded PMTiles header.
+ *
+ * @throws {Error} If the container metadata or tile data range is invalid.
+ */
+export function validateCogContainer(container, header) {
+  if (header.tileType !== 0 || header.tileCompression !== 1 ||
+    !Number.isSafeInteger(header.jsonMetadataOffset) || !Number.isSafeInteger(header.jsonMetadataLength) ||
+    header.jsonMetadataLength <= 0 || header.jsonMetadataLength > 1048576 ||
+    !Number.isSafeInteger(header.tileDataOffset) || !Number.isSafeInteger(header.tileDataLength) ||
+    header.tileDataOffset < 127 || header.tileDataOffset + header.tileDataLength > container.size) {
+    throw /* alloc */ new Error('Invalid PMTiles COG asset container');
+  }
+}

package/src/cog/validateCogContentRange.js

@@ -1,18 +1,18 @@
-/**
- * Validate a parsed Content-Range against the requested bytes and known source size.
- *
- * @param {Object} source COG source and optional known size.
- * @param {RegExpExecArray|null} range Parsed Content-Range.
- * @param {number} rangeStart Requested absolute byte offset.
- * @param {number} length Requested byte length.
- *
- * @throws {Error} If the content range or total size is inconsistent.
- */
-export function validateCogContentRange(source, range, rangeStart, length) {
-  if (!range || Number(range[1]) !== rangeStart || Number(range[2]) !== rangeStart + length - 1 ||
-    !Number.isSafeInteger(Number(range[3])) || Number(range[3]) < rangeStart + length ||
-    (source.containerSize ?? source.size) !== undefined &&
-      (source.containerSize ?? source.size) !== Number(range[3])) {
-    throw /* alloc */ new Error('Invalid COG range response');
-  }
-}
+/**
+ * Validate a parsed Content-Range against the requested bytes and known source size.
+ *
+ * @param {Object} source COG source and optional known size.
+ * @param {RegExpExecArray|null} range Parsed Content-Range.
+ * @param {number} rangeStart Requested absolute byte offset.
+ * @param {number} length Requested byte length.
+ *
+ * @throws {Error} If the content range or total size is inconsistent.
+ */
+export function validateCogContentRange(source, range, rangeStart, length) {
+  if (!range || Number(range[1]) !== rangeStart || Number(range[2]) !== rangeStart + length - 1 ||
+    !Number.isSafeInteger(Number(range[3])) || Number(range[3]) < rangeStart + length ||
+    (source.containerSize ?? source.size) !== undefined &&
+      (source.containerSize ?? source.size) !== Number(range[3])) {
+    throw /* alloc */ new Error('Invalid COG range response');
+  }
+}

package/src/cog/validateCogOffsets.js

@@ -1,19 +1,19 @@
-/**
- * Validate the number and bounds of COG tile offsets and lengths.
- *
- * @param {Object} source COG source with known size.
- * @param {Object} level Level dimensions, offsets and lengths.
- *
- * @throws {Error} If the offset or length arrays have invalid counts.
- * @throws {Error} If a tile range is empty, oversized or outside the source.
- */
-export function validateCogOffsets(source, level) {
-  if (level.offsets?.length !== level.columns * level.rows || level.lengths?.length !== level.offsets.length) {
-    throw /* alloc */ new Error('Invalid COG tile offsets or lengths');
-  }
-  let i;
-  for (i = 0; i < level.offsets.length; i++) {
-    if (!level.offsets[i] || !level.lengths[i] || level.lengths[i] > 1048576 ||
-      level.offsets[i] + level.lengths[i] > source.size) throw /* alloc */ new Error('Invalid COG tile offsets or lengths');
-  }
-}
+/**
+ * Validate the number and bounds of COG tile offsets and lengths.
+ *
+ * @param {Object} source COG source with known size.
+ * @param {Object} level Level dimensions, offsets and lengths.
+ *
+ * @throws {Error} If the offset or length arrays have invalid counts.
+ * @throws {Error} If a tile range is empty, oversized or outside the source.
+ */
+export function validateCogOffsets(source, level) {
+  if (level.offsets?.length !== level.columns * level.rows || level.lengths?.length !== level.offsets.length) {
+    throw /* alloc */ new Error('Invalid COG tile offsets or lengths');
+  }
+  let i;
+  for (i = 0; i < level.offsets.length; i++) {
+    if (!level.offsets[i] || !level.lengths[i] || level.lengths[i] > 1048576 ||
+      level.offsets[i] + level.lengths[i] > source.size) throw /* alloc */ new Error('Invalid COG tile offsets or lengths');
+  }
+}

package/src/cog/validateCogRange.js

@@ -1,16 +1,16 @@
-/**
- * Validate a requested COG byte range against size and numeric limits.
- *
- * @param {Object} source COG source with optional known size.
- * @param {number} offset Source-relative byte offset.
- * @param {number} length Requested byte length.
- *
- * @throws {Error} If the range is invalid or exceeds the supported bounds.
- */
-export function validateCogRange(source, offset, length) {
-  if (!Number.isSafeInteger(offset) || !Number.isSafeInteger(length) || offset < 0 ||
-    length <= 0 || length > 32000000 || !Number.isSafeInteger(offset + length) ||
-    source.size !== undefined && offset + length > source.size) {
-    throw /* alloc */ new Error('Invalid COG byte range');
-  }
-}
+/**
+ * Validate a requested COG byte range against size and numeric limits.
+ *
+ * @param {Object} source COG source with optional known size.
+ * @param {number} offset Source-relative byte offset.
+ * @param {number} length Requested byte length.
+ *
+ * @throws {Error} If the range is invalid or exceeds the supported bounds.
+ */
+export function validateCogRange(source, offset, length) {
+  if (!Number.isSafeInteger(offset) || !Number.isSafeInteger(length) || offset < 0 ||
+    length <= 0 || length > 32000000 || !Number.isSafeInteger(offset + length) ||
+    source.size !== undefined && offset + length > source.size) {
+    throw /* alloc */ new Error('Invalid COG byte range');
+  }
+}

package/src/cog/validateCogResponse.js

@@ -1,26 +1,26 @@
-import { validateCogContentRange } from './validateCogContentRange.js';
-import { invalidCogFullResponse } from './invalidCogFullResponse.js';
-
-/**
- * Validate a COG HTTP response's entity tag, range and full-response size.
- *
- * @param {Object} source COG source whose ETag and size are updated.
- * @param {Response} response HTTP response.
- * @param {number} rangeStart Requested absolute byte offset.
- * @param {number} length Requested byte length.
- *
- * @throws {Error} If the source ETag changes.
- * @throws {Error} If a full response is unsupported or too large.
- */
-export function validateCogResponse(source, response, rangeStart, length) {
-  const etag = response.headers.get('ETag');
-  if (source.etag && source.etag !== etag) throw /* alloc */ new Error('COG changed; recreate the layer');
-  if (etag) source.etag = etag;
-  const range = /^bytes (\d+)-(\d+)\/(\d+)$/.exec(response.headers.get('Content-Range') || '');
-  if (response.status === 206) {
-    validateCogContentRange(source, range, rangeStart, length);
-    if (source.baseOffset === undefined) source.size = Number(range[3]);
-  } else if (invalidCogFullResponse(response)) {
-    throw /* alloc */ new Error('COG server must support byte ranges for files over 32 MB');
-  }
-}
+import { validateCogContentRange } from './validateCogContentRange.js';
+import { invalidCogFullResponse } from './invalidCogFullResponse.js';
+
+/**
+ * Validate a COG HTTP response's entity tag, range and full-response size.
+ *
+ * @param {Object} source COG source whose ETag and size are updated.
+ * @param {Response} response HTTP response.
+ * @param {number} rangeStart Requested absolute byte offset.
+ * @param {number} length Requested byte length.
+ *
+ * @throws {Error} If the source ETag changes.
+ * @throws {Error} If a full response is unsupported or too large.
+ */
+export function validateCogResponse(source, response, rangeStart, length) {
+  const etag = response.headers.get('ETag');
+  if (source.etag && source.etag !== etag) throw /* alloc */ new Error('COG changed; recreate the layer');
+  if (etag) source.etag = etag;
+  const range = /^bytes (\d+)-(\d+)\/(\d+)$/.exec(response.headers.get('Content-Range') || '');
+  if (response.status === 206) {
+    validateCogContentRange(source, range, rangeStart, length);
+    if (source.baseOffset === undefined) source.size = Number(range[3]);
+  } else if (invalidCogFullResponse(response)) {
+    throw /* alloc */ new Error('COG server must support byte ranges for files over 32 MB');
+  }
+}

package/src/collision/collectIntersections.js

@@ -1,41 +1,41 @@
-import { CELL } from '../globals/CELL.js';
-import { horizontalRay } from './horizontalRay.js';
-
-/**
- * Collect positive X-ray hits and polygon footprint crossings, grouped by feature in the shared hits array.
- *
- * @param {Object} shape Cached collider and its spatial grid.
- * @param {number} x Ray origin x coordinate.
- * @param {number} y Ray origin y coordinate.
- * @param {number} z Ray origin z coordinate.
- * @param {Set<number>} seen Reusable set of visited triangle indices.
- * @param {number[]} hits Output array of feature keys and distances.
- * @param {number} end Last x cell to inspect.
- * @param {number} iz Z cell containing the ray.
- */
-export function collectIntersections(shape, x, y, z, seen, hits, end, iz) {
-  const { tri, features, ranges } = shape;
-  let ix, cell, triangle, distance, feature, i, ax, az, bx, bz, cx, cz, ab, ac, bc;
-  for (ix = Math.floor(x / CELL); ix <= end; ix++) {
-    cell = shape.cells.get(`${ix},${iz}`);
-    if (!cell) continue;
-    for (triangle of cell) {
-      if (seen.has(triangle)) continue;
-      seen.add(triangle);
-      feature = features[triangle];
-      distance = horizontalRay(tri, triangle, x, y, z, 1, 0);
-      if (distance > 1e-4) hits.push(feature * 2, distance);
-      if (!ranges?.[feature]?.polygon) continue;
-      i = triangle * 9;
-      ax = tri[i], az = tri[i + 2], bx = tri[i + 3], bz = tri[i + 5], cx = tri[i + 6], cz = tri[i + 8];
-      ab = (ax - bx) ** 2 + (az - bz) ** 2;
-      ac = (ax - cx) ** 2 + (az - cz) ** 2;
-      bc = (bx - cx) ** 2 + (bz - cz) ** 2;
-      if (ac > ab && ac >= bc) bx = cx, bz = cz;
-      else if (bc > ab && bc > ac) ax = bx, az = bz, bx = cx, bz = cz;
-      if ((az > z) === (bz > z)) continue;
-      distance = ax + (z - az) * (bx - ax) / (bz - az) - x;
-      if (distance > 1e-4) hits.push(feature * 2 + 1, distance);
-    }
-  }
-}
+import { CELL } from '../globals/CELL.js';
+import { horizontalRay } from './horizontalRay.js';
+
+/**
+ * Collect positive X-ray hits and polygon footprint crossings, grouped by feature in the shared hits array.
+ *
+ * @param {Object} shape Cached collider and its spatial grid.
+ * @param {number} x Ray origin x coordinate.
+ * @param {number} y Ray origin y coordinate.
+ * @param {number} z Ray origin z coordinate.
+ * @param {Set<number>} seen Reusable set of visited triangle indices.
+ * @param {number[]} hits Output array of feature keys and distances.
+ * @param {number} end Last x cell to inspect.
+ * @param {number} iz Z cell containing the ray.
+ */
+export function collectIntersections(shape, x, y, z, seen, hits, end, iz) {
+  const { tri, features, ranges } = shape;
+  let ix, cell, triangle, distance, feature, i, ax, az, bx, bz, cx, cz, ab, ac, bc;
+  for (ix = Math.floor(x / CELL); ix <= end; ix++) {
+    cell = shape.cells.get(`${ix},${iz}`);
+    if (!cell) continue;
+    for (triangle of cell) {
+      if (seen.has(triangle)) continue;
+      seen.add(triangle);
+      feature = features[triangle];
+      distance = horizontalRay(tri, triangle, x, y, z, 1, 0);
+      if (distance > 1e-4) hits.push(feature * 2, distance);
+      if (!ranges?.[feature]?.polygon) continue;
+      i = triangle * 9;
+      ax = tri[i], az = tri[i + 2], bx = tri[i + 3], bz = tri[i + 5], cx = tri[i + 6], cz = tri[i + 8];
+      ab = (ax - bx) ** 2 + (az - bz) ** 2;
+      ac = (ax - cx) ** 2 + (az - cz) ** 2;
+      bc = (bx - cx) ** 2 + (bz - cz) ** 2;
+      if (ac > ab && ac >= bc) bx = cx, bz = cz;
+      else if (bc > ab && bc > ac) ax = bx, az = bz, bx = cx, bz = cz;
+      if ((az > z) === (bz > z)) continue;
+      distance = ax + (z - az) * (bx - ax) / (bz - az) - x;
+      if (distance > 1e-4) hits.push(feature * 2 + 1, distance);
+    }
+  }
+}

package/src/collision/hiddenLightHit.js

@@ -1,19 +1,19 @@
-/**
- * Reject picks on light halos that are invisible in the current day/night state.
- *
- * @param {Object} mesh Picked mesh.
- * @param {number} i Triangle's first vertex or index offset.
- * @param {number} u First barycentric coordinate.
- * @param {number} v Second barycentric coordinate.
- * @param {number} night Current night-light intensity.
- *
- * @returns {boolean} Whether the hit belongs to an invisible halo.
- */
-export function hiddenLightHit(mesh, i, u, v, night) {
-  if (!mesh.program.nightLight) return false;
-  const { index, uv: { data: uv } } = mesh.geometry.attributes;
-  const idA = index ? index.data[i] : i, idB = index ? index.data[i + 1] : i + 1, idC = index ? index.data[i + 2] : i + 2;
-  const x = uv[idA * 2] * (1 - u - v) + uv[idB * 2] * u + uv[idC * 2] * v;
-  const y = uv[idA * 2 + 1] * (1 - u - v) + uv[idB * 2 + 1] * u + uv[idC * 2 + 1] * v;
-  return x <= 2 && (!night || x * x + y * y > 0.9);
-}
+/**
+ * Reject picks on light halos that are invisible in the current day/night state.
+ *
+ * @param {Object} mesh Picked mesh.
+ * @param {number} i Triangle's first vertex or index offset.
+ * @param {number} u First barycentric coordinate.
+ * @param {number} v Second barycentric coordinate.
+ * @param {number} night Current night-light intensity.
+ *
+ * @returns {boolean} Whether the hit belongs to an invisible halo.
+ */
+export function hiddenLightHit(mesh, i, u, v, night) {
+  if (!mesh.program.nightLight) return false;
+  const { index, uv: { data: uv } } = mesh.geometry.attributes;
+  const idA = index ? index.data[i] : i, idB = index ? index.data[i + 1] : i + 1, idC = index ? index.data[i + 2] : i + 2;
+  const x = uv[idA * 2] * (1 - u - v) + uv[idB * 2] * u + uv[idC * 2] * v;
+  const y = uv[idA * 2 + 1] * (1 - u - v) + uv[idB * 2 + 1] * u + uv[idC * 2 + 1] * v;
+  return x <= 2 && (!night || x * x + y * y > 0.9);
+}

package/src/collision/indexTriangle.js

@@ -1,18 +1,18 @@
-import { CELL } from '../globals/CELL.js';
-
-/**
- * Add a triangle index to every X/Z grid cell touched by its projected bounding box.
- *
- * @param {Map<string, number[]>} cells Spatial grid receiving triangle indices.
- * @param {number[]} v Packed triangle coordinates.
- * @param {number} t Triangle index.
- */
-export function indexTriangle(cells, v, t) {
-  let ix, iz, key;
-  for (ix = Math.floor(Math.min(v[0], v[3], v[6]) / CELL); ix <= Math.floor(Math.max(v[0], v[3], v[6]) / CELL); ix++)
-    for (iz = Math.floor(Math.min(v[2], v[5], v[8]) / CELL); iz <= Math.floor(Math.max(v[2], v[5], v[8]) / CELL); iz++) {
-      key = ix + ',' + iz;
-      if (!cells.has(key)) cells.set(key, /* alloc */ []);
-      cells.get(key).push(t);
-    }
-}
+import { CELL } from '../globals/CELL.js';
+
+/**
+ * Add a triangle index to every X/Z grid cell touched by its projected bounding box.
+ *
+ * @param {Map<string, number[]>} cells Spatial grid receiving triangle indices.
+ * @param {number[]} v Packed triangle coordinates.
+ * @param {number} t Triangle index.
+ */
+export function indexTriangle(cells, v, t) {
+  let ix, iz, key;
+  for (ix = Math.floor(Math.min(v[0], v[3], v[6]) / CELL); ix <= Math.floor(Math.max(v[0], v[3], v[6]) / CELL); ix++)
+    for (iz = Math.floor(Math.min(v[2], v[5], v[8]) / CELL); iz <= Math.floor(Math.max(v[2], v[5], v[8]) / CELL); iz++) {
+      key = ix + ',' + iz;
+      if (!cells.has(key)) cells.set(key, /* alloc */ []);
+      cells.get(key).push(t);
+    }
+}

package/src/collision/insideMesh.js

@@ -1,47 +1,47 @@
-import { CELL } from '../globals/CELL.js';
-import { collider } from './collider.js';
-import { computeBounds } from '../geometry/computeBounds.js';
-import { collectIntersections } from './collectIntersections.js';
-import { countCrossings } from './countCrossings.js';
-
-/**
- * Test a world-space point against visible mesh features, reusing the supplied intersection scratch buffers.
- *
- * @param {Object} mesh Mesh to test.
- * @param {number} x World-space x coordinate.
- * @param {number} y World-space y coordinate.
- * @param {number} z World-space z coordinate.
- * @param {Set<number>} seen Reusable set of visited triangle indices.
- * @param {number[]} intersections Reusable array of crossing data.
- *
- * @returns {boolean} Whether a feature encloses the point.
- */
-export function insideMesh(mesh, x, y, z, seen, intersections) {
-  const geometry = mesh.geometry;
-  if (!mesh.visible || !geometry?.attributes?.position?.data || mesh.program?.depthTest === false) return false;
-  if (!geometry.bounds) computeBounds(geometry);
-  const bounds = geometry.bounds;
-  const world = mesh.worldMatrix;
-  const center = bounds.center;
-  const cx = world[0] * center[0] + world[4] * center[1] + world[8] * center[2] + world[12];
-  const cy = world[1] * center[0] + world[5] * center[1] + world[9] * center[2] + world[13];
-  const cz = world[2] * center[0] + world[6] * center[1] + world[10] * center[2] + world[14];
-  const radius = bounds.radius * Math.max(
-    Math.hypot(world[0], world[1], world[2]),
-    Math.hypot(world[4], world[5], world[6]),
-    Math.hypot(world[8], world[9], world[10])
-  );
-  if (Math.hypot(cx - x, cy - y, cz - z) > radius) return false;
-  const shape = collider(mesh);
-  x += shape.origin[0] - world[12];
-  y += shape.origin[1] - world[13];
-  z += shape.origin[2] - world[14];
-  const end = Math.floor(shape.maxX / CELL);
-  if (x >= shape.maxX) return false;
-  const iz = Math.floor(z / CELL);
-  const hits = intersections;
-  hits.length = 0;
-  seen.clear();
-  collectIntersections(shape, x, y, z, seen, hits, end, iz);
-  return countCrossings(hits, shape.ranges) > 0;
-}
+import { CELL } from '../globals/CELL.js';
+import { collider } from './collider.js';
+import { computeBounds } from '../geometry/computeBounds.js';
+import { collectIntersections } from './collectIntersections.js';
+import { countCrossings } from './countCrossings.js';
+
+/**
+ * Test a world-space point against visible mesh features, reusing the supplied intersection scratch buffers.
+ *
+ * @param {Object} mesh Mesh to test.
+ * @param {number} x World-space x coordinate.
+ * @param {number} y World-space y coordinate.
+ * @param {number} z World-space z coordinate.
+ * @param {Set<number>} seen Reusable set of visited triangle indices.
+ * @param {number[]} intersections Reusable array of crossing data.
+ *
+ * @returns {boolean} Whether a feature encloses the point.
+ */
+export function insideMesh(mesh, x, y, z, seen, intersections) {
+  const geometry = mesh.geometry;
+  if (!mesh.visible || !geometry?.attributes?.position?.data || mesh.program?.depthTest === false) return false;
+  if (!geometry.bounds) computeBounds(geometry);
+  const bounds = geometry.bounds;
+  const world = mesh.worldMatrix;
+  const center = bounds.center;
+  const cx = world[0] * center[0] + world[4] * center[1] + world[8] * center[2] + world[12];
+  const cy = world[1] * center[0] + world[5] * center[1] + world[9] * center[2] + world[13];
+  const cz = world[2] * center[0] + world[6] * center[1] + world[10] * center[2] + world[14];
+  const radius = bounds.radius * Math.max(
+    Math.hypot(world[0], world[1], world[2]),
+    Math.hypot(world[4], world[5], world[6]),
+    Math.hypot(world[8], world[9], world[10])
+  );
+  if (Math.hypot(cx - x, cy - y, cz - z) > radius) return false;
+  const shape = collider(mesh);
+  x += shape.origin[0] - world[12];
+  y += shape.origin[1] - world[13];
+  z += shape.origin[2] - world[14];
+  const end = Math.floor(shape.maxX / CELL);
+  if (x >= shape.maxX) return false;
+  const iz = Math.floor(z / CELL);
+  const hits = intersections;
+  hits.length = 0;
+  seen.clear();
+  collectIntersections(shape, x, y, z, seen, hits, end, iz);
+  return countCrossings(hits, shape.ranges) > 0;
+}