leaflet-city-mapper 0.0.9 → 0.1.1

package/src/vector-tiles/vectorTileSettings.js

@@ -1,17 +1,27 @@
-import { readTileJSON } from './readTileJSON.js';
-import { readVectorStyle } from './readVectorStyle.js';
-import { validateVectorTileZooms } from './validateVectorTileZooms.js';
-
-export async function vectorTileSettings(options) {
-  if (!options || typeof options !== 'object') throw /* alloc */ new TypeError('Vector tiles require source options');
-  if (options.tileJSON) options = await readTileJSON(options);
-  let { url, style, minNativeZoom = 0, maxNativeZoom = 14, maxZoom = 19 } = options;
-  let key;
-  if (typeof url === 'string') url = url.replaceAll(/%7B([zxy])%7D/gi, '{$1}');
-  for (key of /* alloc */ ['{z}', '{x}', '{y}']) {
-    if (typeof url !== 'string' || !url.includes(key)) throw /* alloc */ new Error('Vector tiles require an XYZ URL template');
-  }
-  validateVectorTileZooms(minNativeZoom, maxNativeZoom, maxZoom);
-  style = await readVectorStyle(style);
-  return /* alloc */ { ...options, url, style, minNativeZoom, maxNativeZoom, maxZoom };
-}
+import { readTileJSON } from './readTileJSON.js';
+import { readVectorStyle } from './readVectorStyle.js';
+import { validateVectorTileZooms } from './validateVectorTileZooms.js';
+
+/**
+ * Resolve and validate vector tile source options, metadata and style.
+ *
+ * @param {Object} options Vector tile source options.
+ *
+ * @returns {Promise<Object>} Resolved settings.
+ *
+ * @throws {TypeError} If source options are absent or not an object.
+ * @throws {Error} If the XYZ tile URL template is invalid.
+ */
+export async function vectorTileSettings(options) {
+  if (!options || typeof options !== 'object') throw /* alloc */ new TypeError('Vector tiles require source options');
+  if (options.tileJSON) options = await readTileJSON(options);
+  let { url, style, minNativeZoom = 0, maxNativeZoom = 14, maxZoom = 19 } = options;
+  let key;
+  if (typeof url === 'string') url = url.replaceAll(/%7B([zxy])%7D/gi, '{$1}');
+  for (key of /* alloc */ ['{z}', '{x}', '{y}']) {
+    if (typeof url !== 'string' || !url.includes(key)) throw /* alloc */ new Error('Vector tiles require an XYZ URL template');
+  }
+  validateVectorTileZooms(minNativeZoom, maxNativeZoom, maxZoom);
+  style = await readVectorStyle(style);
+  return /* alloc */ { ...options, url, style, minNativeZoom, maxNativeZoom, maxZoom };
+}

package/src/vector-tiles/vectorTilesIdle.js

@@ -1,3 +1,11 @@
-export function vectorTilesIdle(layer, session) {
-  return layer.session === session && performance.now() - (layer.changedAt || 0) >= 180;
-}
+/**
+ * Check that the vector tile session is current and the map has settled.
+ *
+ * @param {Object} layer Vector tile layer.
+ * @param {Object} session Session identity.
+ *
+ * @returns {boolean} Whether the session is idle.
+ */
+export function vectorTilesIdle(layer, session) {
+  return layer.session === session && performance.now() - (layer.changedAt || 0) >= 180;
+}

package/src/vector-tiles/vectorTolerance.js

@@ -1,4 +1,11 @@
-/** Simplification tolerance in tile units: about 0.7 screen pixels at the displayed scale. */
-export function vectorTolerance(job, layer) {
-  return layer.extent / 256 / 2 ** Math.max(-1, job.mapZoom - job.coords.z) * 0.7;
-}
+/**
+ * Compute a simplification tolerance of about 0.7 screen pixels in tile units.
+ *
+ * @param {Object} job Vector tile preparation job.
+ * @param {Object} layer Decoded source layer.
+ *
+ * @returns {number} Tolerance in tile units.
+ */
+export function vectorTolerance(job, layer) {
+  return layer.extent / 256 / 2 ** Math.max(-1, job.mapZoom - job.coords.z) * 0.7;
+}

package/src/vector-tiles/wrapVectorLabel.js

@@ -1,11 +1,17 @@
-/** Greedy word wrap at 10 ems (MapLibre's default text-max-width), estimating glyph width at 0.52 em. */
-export function wrapVectorLabel(text) {
-  const limit = Math.floor(10 / 0.52), lines = /* alloc */ [];
-  let line = '', word;
-  for (word of text.split(' ')) {
-    if (line && Array.from(`${line} ${word}`).length > limit) { lines.push(line); line = word; }
-    else line = line ? `${line} ${word}` : word;
-  }
-  lines.push(line);
-  return lines;
-}
+/**
+ * Greedily wrap label words at 10 ems, estimating glyph width at 0.52 em.
+ *
+ * @param {string} text Label text.
+ *
+ * @returns {Array<string>} Wrapped lines.
+ */
+export function wrapVectorLabel(text) {
+  const limit = Math.floor(10 / 0.52), lines = /* alloc */ [];
+  let line = '', word;
+  for (word of text.split(' ')) {
+    if (line && Array.from(`${line} ${word}`).length > limit) { lines.push(line); line = word; }
+    else line = line ? `${line} ${word}` : word;
+  }
+  lines.push(line);
+  return lines;
+}

package/src/vehicles/README.md

@@ -0,0 +1,27 @@
+# Vehicle models
+
+[Source guide](../README.md) | [Project README](../../README.md)
+
+Creates procedural vehicle and pedestrian parts for traffic. Walking uses
+shared pedestrian body parts rather than the traffic model itself.
+
+## Shapes versus movement
+
+```mermaid
+flowchart LR
+  Shared["Shared pedestrian body parts"] --> Shapes["Vehicle / pedestrian models"]
+  Shared --> WalkerParts["Walker limbs"]
+  Shapes --> TrafficBuild["Build traffic geometry"]
+  WalkerParts --> WalkBuild["Build walker geometry"]
+  TrafficBuild --> Traffic["Traffic: lanes + GPU poses"]
+  WalkBuild --> Walk["Walk: pedestrian animation"]
+```
+
+These are shapes, not animated layers. Shared-part changes affect both
+consumers; changes here do not alter traffic routing or walker movement.
+
+- [carModel.js](./carModel.js): construct car parts.
+- [pedestrianModel.js](./pedestrianModel.js): construct pedestrian parts.
+- [bicycleModel.js](./bicycleModel.js): construct bicycle parts.
+
+Related: [traffic](../traffic/README.md), [walk](../walk/README.md), [geometry](../geometry/README.md).

package/src/vehicles/bicycleModel.js

@@ -2,9 +2,15 @@ import { paints } from '../globals/paints.js';
 import { dark } from '../globals/dark.js';
 import { skin } from '../globals/skin.js';
 import { trousers } from '../globals/trousers.js';
-
 import { box } from '../geometry/box.js';
 
+/**
+ * Build the geometry parts for a bicycle and rider.
+ *
+ * @param {number} index Index selecting a paint color.
+ *
+ * @returns {Array} Extrusion parts for the model.
+ */
 export function bicycleModel(index) {
   const paint = paints[index % paints.length];
   return /* alloc */ [

package/src/vehicles/boatBenches.js

@@ -1,5 +1,10 @@
 import { mirror } from './mirrorVehiclePart.js';
 
+/**
+ * Build twelve mirrored pairs of benches for the boat deck.
+ *
+ * @returns {Array} Bench extrusion parts.
+ */
 export function boatBenches() {
   const benches = /* alloc */ [];
   let i;

package/src/vehicles/boatModel.js

@@ -1,35 +1,35 @@
 import { hull } from '../globals/hull.js';
 import { white } from '../globals/white.js';
 import { glass } from '../globals/glass.js';
-
-
-import { box } from '../geometry/box.js';
-
-import { mirror } from './mirrorVehiclePart.js';
-
-import { boatBenches } from './boatBenches.js';
-
-// Panoramic river cruiser, about 60 x 11 m.
-export function boatModel() {
-  return /* alloc */ [
-    /* alloc */ [
-      hull, 0, 0.8, /* alloc */ [0.1, 0.16, 0.26]],
-    /* alloc */ [hull, 0.8, 1.4, white],
-    /* alloc */ [box(-5, 5, -18, 26), 1.4, 3.7, glass, box(-4.6, 4.6, -17.4, 25.6)],
-    ...mirror(4.64, 4.74, -17, 25, 3.25, 3.45, /* alloc */ [1.6, 1.25, 0.8]),
-    /* alloc */ [box(-4.8, 4.8, -17.8, 25.8), 3.7, 3.9, white],
-    ...boatBenches(),
-    ...mirror(4.65, 4.8, -13.6, 25.8, 3.9, 4.8, white),
-    /* alloc */ [box(-4.8, 4.8, 25.65, 25.8), 3.9, 4.8, white],
-    /* alloc */ [box(-2.2, 2.2, -17.6, -14), 3.9, 4.7, white],
-    /* alloc */ [box(-2.2, 2.2, -17.6, -14), 4.7, 5.5, glass],
-    /* alloc */ [box(-2.5, 2.5, -18, -13.6), 5.5, 5.7, white],
-    /* alloc */ [
-      box(-2.45, -2.2, -16.2, -15.8), 5, 5.3, /* alloc */ [2, 0.15, 0.1]],
-    /* alloc */ [
-      box(2.2, 2.45, -16.2, -15.8), 5, 5.3, /* alloc */ [0.1, 2, 0.4]],
-    /* alloc */ [box(-0.1, 0.1, -15.9, -15.7), 5.7, 6.6, white],
-    /* alloc */ [
-      box(-0.15, 0.15, -15.95, -15.65), 6.6, 6.8, /* alloc */ [2, 2, 1.9]],
-  ];
-}
+import { box } from '../geometry/box.js';
+import { mirror } from './mirrorVehiclePart.js';
+import { boatBenches } from './boatBenches.js';
+
+/**
+ * Build the geometry parts for a panoramic river cruiser, about 60 by 11 metres.
+ *
+ * @returns {Array} Extrusion parts for the hull, deck and fittings.
+ */
+export function boatModel() {
+  return /* alloc */ [
+    /* alloc */ [
+      hull, 0, 0.8, /* alloc */ [0.1, 0.16, 0.26]],
+    /* alloc */ [hull, 0.8, 1.4, white],
+    /* alloc */ [box(-5, 5, -18, 26), 1.4, 3.7, glass, box(-4.6, 4.6, -17.4, 25.6)],
+    ...mirror(4.64, 4.74, -17, 25, 3.25, 3.45, /* alloc */ [1.6, 1.25, 0.8]),
+    /* alloc */ [box(-4.8, 4.8, -17.8, 25.8), 3.7, 3.9, white],
+    ...boatBenches(),
+    ...mirror(4.65, 4.8, -13.6, 25.8, 3.9, 4.8, white),
+    /* alloc */ [box(-4.8, 4.8, 25.65, 25.8), 3.9, 4.8, white],
+    /* alloc */ [box(-2.2, 2.2, -17.6, -14), 3.9, 4.7, white],
+    /* alloc */ [box(-2.2, 2.2, -17.6, -14), 4.7, 5.5, glass],
+    /* alloc */ [box(-2.5, 2.5, -18, -13.6), 5.5, 5.7, white],
+    /* alloc */ [
+      box(-2.45, -2.2, -16.2, -15.8), 5, 5.3, /* alloc */ [2, 0.15, 0.1]],
+    /* alloc */ [
+      box(2.2, 2.45, -16.2, -15.8), 5, 5.3, /* alloc */ [0.1, 2, 0.4]],
+    /* alloc */ [box(-0.1, 0.1, -15.9, -15.7), 5.7, 6.6, white],
+    /* alloc */ [
+      box(-0.15, 0.15, -15.95, -15.65), 6.6, 6.8, /* alloc */ [2, 2, 1.9]],
+  ];
+}

package/src/vehicles/buildCarriage.js

@@ -3,9 +3,17 @@ import { white } from '../globals/white.js';
 import { tyre } from '../globals/tyre.js';
 import { headlight } from '../globals/headlight.js';
 import { taillight } from '../globals/taillight.js';
-
 import { box } from '../geometry/box.js';
 
+/**
+ * Build a carriage with body, windows, wheels and lights.
+ *
+ * @param {number} center Carriage center along the longitudinal axis.
+ * @param {number} length Carriage length.
+ * @param {number[]} color Body color.
+ *
+ * @returns {Array} Carriage extrusion parts.
+ */
 export function carriage(center, length, color) {
   const front = center - length / 2, rear = center + length / 2;
   return /* alloc */ [

package/src/vehicles/busModel.js

@@ -1,6 +1,14 @@
 import { routeColor } from '../traffic/routeColor.js';
 import { carriage } from './buildCarriage.js';
 
-export function busModel(index, properties) {
-  return carriage(0, 12, routeColor(properties));
+/**
+ * Build a single bus carriage colored from its route properties.
+ *
+ * @param {number} index Vehicle index, unused by this model.
+ * @param {Object} properties Route properties used to choose the color.
+ *
+ * @returns {Array} Bus extrusion parts.
+ */
+export function busModel(index, properties) {
+  return carriage(0, 12, routeColor(properties));
 }

package/src/vehicles/carModel.js

@@ -3,36 +3,37 @@ import { tyre } from '../globals/tyre.js';
 import { glass } from '../globals/glass.js';
 import { headlight } from '../globals/headlight.js';
 import { taillight } from '../globals/taillight.js';
-
-import { box } from '../geometry/box.js';
-
-
-import { mirror } from './mirrorVehiclePart.js';
-
-
-
-
-export function carModel(i) {
-  const paint = paints[i % paints.length];
-  return /* alloc */ [
-    ...mirror(0.7, 0.92, -1.68, -1.02, 0, 0.64, tyre),
-    ...mirror(0.7, 0.92, 1.02, 1.68, 0, 0.64, tyre),
-    /* alloc */ [
-      /* alloc */ [
-        /* alloc */ [-0.9, -1.95],
-        /* alloc */ [-0.72, -2.25],
-        /* alloc */ [0.72, -2.25],
-        /* alloc */ [0.9, -1.95],
-        /* alloc */ [0.9, 2.05],
-        /* alloc */ [0.76, 2.25],
-        /* alloc */ [-0.76, 2.25],
-        /* alloc */ [-0.9, 2.05],
-      ],
-      0.28, 0.82, paint],
-    // Greenhouse: the windscreen leans back, the rear window less.
-    /* alloc */ [box(-0.84, 0.84, -0.75, 1.6), 0.82, 1.38, glass, box(-0.7, 0.7, -0.05, 1.3)],
-    /* alloc */ [box(-0.71, 0.71, -0.06, 1.31), 1.38, 1.46, paint],
-    ...mirror(0.38, 0.8, -2.3, -2.16, 0.56, 0.76, headlight),
-    /* alloc */ [box(-0.78, 0.78, 2.16, 2.3), 0.6, 0.76, taillight],
-  ];
-}
+import { box } from '../geometry/box.js';
+import { mirror } from './mirrorVehiclePart.js';
+
+/**
+ * Build the geometry parts for a car.
+ *
+ * @param {number} i Index selecting a paint color.
+ *
+ * @returns {Array} Car body, wheels, windows and light parts.
+ */
+export function carModel(i) {
+  const paint = paints[i % paints.length];
+  return /* alloc */ [
+    ...mirror(0.7, 0.92, -1.68, -1.02, 0, 0.64, tyre),
+    ...mirror(0.7, 0.92, 1.02, 1.68, 0, 0.64, tyre),
+    /* alloc */ [
+      /* alloc */ [
+        /* alloc */ [-0.9, -1.95],
+        /* alloc */ [-0.72, -2.25],
+        /* alloc */ [0.72, -2.25],
+        /* alloc */ [0.9, -1.95],
+        /* alloc */ [0.9, 2.05],
+        /* alloc */ [0.76, 2.25],
+        /* alloc */ [-0.76, 2.25],
+        /* alloc */ [-0.9, 2.05],
+      ],
+      0.28, 0.82, paint],
+    // Greenhouse: the windscreen leans back, the rear window less.
+    /* alloc */ [box(-0.84, 0.84, -0.75, 1.6), 0.82, 1.38, glass, box(-0.7, 0.7, -0.05, 1.3)],
+    /* alloc */ [box(-0.71, 0.71, -0.06, 1.31), 1.38, 1.46, paint],
+    ...mirror(0.38, 0.8, -2.3, -2.16, 0.56, 0.76, headlight),
+    /* alloc */ [box(-0.78, 0.78, 2.16, 2.3), 0.6, 0.76, taillight],
+  ];
+}

package/src/vehicles/metroModel.js

@@ -1,6 +1,14 @@
 import { routeColor } from '../traffic/routeColor.js';
 import { carriage } from './buildCarriage.js';
 
+/**
+ * Build a five-car metro colored from its route properties.
+ *
+ * @param {number} index Vehicle index, unused by this model.
+ * @param {Object} properties Route properties used to choose the color.
+ *
+ * @returns {Array} Metro extrusion parts.
+ */
 export function metroModel(index, properties) {
   const color = routeColor(properties), parts = /* alloc */ [];
   let car;

package/src/vehicles/mirrorVehiclePart.js

@@ -1,5 +1,16 @@
 import { box } from "../geometry/box.js";
 
+/**
+ * Create a pair of extrusion parts mirrored across the vehicle's longitudinal axis.
+ *
+ * @param {number} x0 Inner lateral bound.
+ * @param {number} x1 Outer lateral bound.
+ * @param {number} z0 First longitudinal bound.
+ * @param {number} z1 Second longitudinal bound.
+ * @param {...*} rest Remaining extrusion-part fields.
+ *
+ * @returns {Array} The two mirrored parts.
+ */
 export function mirror(x0, x1, z0, z1, ...rest) {
   return /* alloc */ [
     /* alloc */ [box(x0, x1, z0, z1), ...rest],

package/src/vehicles/pedestrianModel.js

@@ -2,9 +2,15 @@ import { parts } from '../globals/parts.js';
 import { paints } from '../globals/paints.js';
 import { trousers } from '../globals/trousers.js';
 import { skin } from '../globals/skin.js';
-
 import { box } from '../geometry/box.js';
 
+/**
+ * Build a pedestrian from the shared body and additional limb parts.
+ *
+ * @param {number} index Index selecting a clothing color.
+ *
+ * @returns {Array} Pedestrian extrusion parts.
+ */
 export function pedestrianModel(index) {
   const model = parts.body.slice();
   model[1] = /* alloc */ [model[1][0], model[1][1], model[1][2], paints[index % paints.length]];

package/src/vehicles/tramModel.js

@@ -1,6 +1,14 @@
 import { routeColor } from '../traffic/routeColor.js';
 import { carriage } from './buildCarriage.js';
 
+/**
+ * Build a five-car tram colored from its route properties.
+ *
+ * @param {number} index Vehicle index, unused by this model.
+ * @param {Object} properties Route properties used to choose the color.
+ *
+ * @returns {Array} Tram extrusion parts.
+ */
 export function tramModel(index, properties) {
   const color = routeColor(properties), parts = /* alloc */ [];
   let car;

package/src/walk/README.md

@@ -0,0 +1,30 @@
+# Walk mode
+
+[Source guide](../README.md) | [Project README](../../README.md)
+
+Provides a third-person walking control, including input, walker animation,
+terrain following, camera updates and movement collision checks.
+
+## Enter, move, leave
+
+```mermaid
+flowchart LR
+  Start["Enter: save map state + install listeners"] --> Input["Input + frame time"]
+  Input --> Movement["Turn / move / ascend / fall"]
+  Movement --> Collision["Check obstacles + slide"]
+  Collision --> Landing["Land on terrain or geometry"]
+  Landing --> View["Update walker + camera"]
+  View --> Input
+  Start --> Stop["Leave: remove listeners + meshes; restore map"]
+  Collision --> Enclosed["If enclosed: search nearby clear position"]
+```
+
+Movement checks current obstacles but does not make traffic avoid the walker.
+Pair any new walk-mode state or listener with
+[stopWalking.js](./stopWalking.js).
+
+- [initWalk.js](./initWalk.js): install the walk control.
+- [moveWalker.js](./moveWalker.js): move and slide along obstacles.
+- [resolveWalkerPosition.js](./resolveWalkerPosition.js): find a clear nearby position when enclosed.
+
+Related: [collision](../collision/README.md), [camera](../camera/README.md), [vehicles](../vehicles/README.md).

package/src/walk/animateWalker.js

@@ -1,19 +1,20 @@
 import { rendererByLayer } from '../weakmaps/rendererByLayer.js';
 import { rootByLayer } from '../weakmaps/rootByLayer.js';
-
 import { limbs } from '../globals/limbs.js';
 import { parts } from '../globals/parts.js';
 import { moves } from '../globals/moves.js';
-
-
 import * as createMesh from '../rendering/createMesh.js';
 import { build } from '../geometry/buildGeometryParts.js';
-
 import { local } from '../projections/walkerLocalPosition.js';
 import { stepWalkerHeight } from './stepWalkerHeight.js';
 import { resolveWalkerPosition } from './resolveWalkerPosition.js';
 import { updateWalkerFrame } from './updateWalkerFrame.js';
 
+/**
+ * Advance one walk frame, checking clearance periodically and applying input, height and camera updates.
+ *
+ * @param {number} now Animation-frame timestamp in milliseconds.
+ */
 export function step(now) {
   const layer = this.layer;
   this.frame = requestAnimationFrame(this.step);

package/src/walk/createWalk.js

@@ -1,9 +1,6 @@
 import { typeByLayer } from '../weakmaps/typeByLayer.js';
 import { walkerByLayer } from '../weakmaps/walkerByLayer.js';
-
 import { L } from '../globals/L.js';
-
-
 import { init3D } from '../scene/init3D.js';
 import { onBlur } from './onWalkBlur.js';
 import { onKey } from './onWalkKey.js';
@@ -14,6 +11,12 @@ import { step } from './animateWalker.js';
 import { stop } from './stopWalking.js';
 import { toggle } from './toggleWalking.js';
 
+/**
+ * Create the walk layer, control UI and bound event handlers for a control.
+ *
+ * @param {L.Control} control Control receiving the walk state.
+ * @param {Object} options Walking speed, camera distance and layer options.
+ */
 export function createWalk(control, {
   speed,
   distance,

package/src/walk/initWalk.js

@@ -16,6 +16,11 @@ class WalkControl extends extendLeafletClass(L.Control) {
   static initHooks = true;
   static defaultOptions = { position: 'bottomright', speed: 70, distance: 20 };
 
+  /**
+   * Initialize the control and its hooks explicitly when using Leaflet 2.
+   *
+   * @param {Object} options Walk control options.
+   */
   constructor(options) {
     super(options);
     if (L.version.startsWith('2.')) {

package/src/walk/initializeWalkControl.js

@@ -1,7 +1,12 @@
 import { L } from '../globals/L.js';
-import { createWalk } from './createWalk.js';
-
-export function initialize(options) {
-  L.Util.setOptions(this, options);
-  createWalk(this, this.options);
-}
+import { createWalk } from './createWalk.js';
+
+/**
+ * Apply Leaflet control options and create the walk control's state and UI.
+ *
+ * @param {Object} options Walk control options.
+ */
+export function initialize(options) {
+  L.Util.setOptions(this, options);
+  createWalk(this, this.options);
+}

package/src/walk/isWalkBlocked.js

@@ -1,6 +1,15 @@
-import { hit } from '../picking/hit.js';
-
-export function blocked(east, north, feet) {
-  const length = Math.hypot(east, north);
-  return length > 1e-6 && hit(this.layer, feet[0], feet[1], feet[2], east / length, -north / length, length + 0.3, this.hitData);
-}
+import { hit } from '../picking/hit.js';
+
+/**
+ * Cast a horizontal movement ray with walker clearance and return the nearest obstacle normal.
+ *
+ * @param {number} east Eastward movement in metres.
+ * @param {number} north Northward movement in metres.
+ * @param {number[]} feet Walker's world-space feet position.
+ *
+ * @returns {number[]|null|false} Horizontal obstacle normal, or a falsy value when clear.
+ */
+export function blocked(east, north, feet) {
+  const length = Math.hypot(east, north);
+  return length > 1e-6 && hit(this.layer, feet[0], feet[1], feet[2], east / length, -north / length, length + 0.3, this.hitData);
+}

package/src/walk/landWalker.js

@@ -4,35 +4,39 @@ import { raycasterByLayer } from '../weakmaps/raycasterByLayer.js';
 import { rootByLayer } from '../weakmaps/rootByLayer.js';
 import { sceneByLayer } from '../weakmaps/sceneByLayer.js';
 import { sharedByLayer } from '../weakmaps/sharedByLayer.js';
+import { intersectMeshes } from '../collision/intersectMeshes.js';
+import { traverse } from '../scene/traverse.js';
+import { updateWorldMatrix } from '../transforms/updateWorldMatrix.js';
+import { collectVisibleMesh } from '../picking/collectVisibleMesh.js';
+import { shouldSkipOther } from '../picking/shouldSkipOther.js';
+import { local } from '../projections/walkerLocalPosition.js';
 
-import { intersectMeshes } from '../collision/intersectMeshes.js';
-import { traverse } from '../scene/traverse.js';
-import { updateWorldMatrix } from '../transforms/updateWorldMatrix.js';
-import { collectVisibleMesh } from '../picking/collectVisibleMesh.js';
-import { shouldSkipOther } from '../picking/shouldSkipOther.js';
-import { local } from '../projections/walkerLocalPosition.js';
-
-export function land(previousY) {
-  const ray = raycasterByLayer.get(this.layer)
-  const feet = local.call(this, this.local), root = rootByLayer.get(this.layer);
-  const x = root.position[0] + feet[0] * root.scale[0];
-  const y = root.position[1] + feet[1] * root.scale[1];
-  const z = root.position[2] + feet[2] * root.scale[2];
-  if (y > previousY || this.verticalSpeed > 0) return;
-  updateWorldMatrix(sceneByLayer.get(this.layer));
-  ray.origin[0] = x; ray.origin[1] = previousY + 0.01; ray.origin[2] = z;
-  ray.direction[0] = 0; ray.direction[1] = -1; ray.direction[2] = 0;
-  ray.meshes.length = 0;
-  let layer, hit;
-  for (layer of layersByLayer.get(sharedByLayer.get(this.layer))) {
-    if (shouldSkipOther(layer, this.layer) || kindByLayer.get(layer) === 'raster' || layer.options.nightLight) continue;
-    traverse(rootByLayer.get(layer), collectVisibleMesh, ray.meshes);
-  }
-  for (hit of intersectMeshes(ray, ray.meshes)) {
-    if (hit.point[1] < y - 0.001) break;
-    this.state.height += (hit.point[1] - y) / root.scale[1];
-    this.verticalSpeed = 0;
-    break;
-  }
-  ray.meshes.length = 0;
-}
+/**
+ * Land a descending walker on the first visible surface crossed since its previous height.
+ *
+ * @param {number} previousY Previous world-space feet height.
+ */
+export function land(previousY) {
+  const ray = raycasterByLayer.get(this.layer)
+  const feet = local.call(this, this.local), root = rootByLayer.get(this.layer);
+  const x = root.position[0] + feet[0] * root.scale[0];
+  const y = root.position[1] + feet[1] * root.scale[1];
+  const z = root.position[2] + feet[2] * root.scale[2];
+  if (y > previousY || this.verticalSpeed > 0) return;
+  updateWorldMatrix(sceneByLayer.get(this.layer));
+  ray.origin[0] = x; ray.origin[1] = previousY + 0.01; ray.origin[2] = z;
+  ray.direction[0] = 0; ray.direction[1] = -1; ray.direction[2] = 0;
+  ray.meshes.length = 0;
+  let layer, hit;
+  for (layer of layersByLayer.get(sharedByLayer.get(this.layer))) {
+    if (shouldSkipOther(layer, this.layer) || kindByLayer.get(layer) === 'raster' || layer.options.nightLight) continue;
+    traverse(rootByLayer.get(layer), collectVisibleMesh, ray.meshes);
+  }
+  for (hit of intersectMeshes(ray, ray.meshes)) {
+    if (hit.point[1] < y - 0.001) break;
+    this.state.height += (hit.point[1] - y) / root.scale[1];
+    this.verticalSpeed = 0;
+    break;
+  }
+  ray.meshes.length = 0;
+}