leaflet-city-mapper 0.1.0 → 0.1.1

package/src/textures/uploadNativeImage.js

@@ -1,26 +1,26 @@
-/**
- * Upload a native image, removing its cached GPU texture if the copy fails.
- *
- * @param {Object} state Native layer state containing the texture cache.
- * @param {string} key Texture cache key.
- * @param {Object} texture Destination texture state.
- * @param {HTMLImageElement} image Source image.
- * @param {GPUDevice} device Device owning the destination.
- * @param {number} width Image width in pixels.
- * @param {number} height Image height in pixels.
- *
- * @throws {Error} If the GPU image copy fails.
- */
-export function uploadNativeImage(state, key, texture, image, device, width, height) {
-  try {
-    device.queue.copyExternalImageToTexture(
-      /* alloc */ { source: image },
-      /* alloc */ { texture: texture.texture },
-      /* alloc */ [width, height]);
-  } catch (error) {
-    texture.texture.destroy();
-    state.textures.delete(key);
-    throw error;
-  }
-  texture.uploaded = image;
-}
+/**
+ * Upload a native image, removing its cached GPU texture if the copy fails.
+ *
+ * @param {Object} state Native layer state containing the texture cache.
+ * @param {string} key Texture cache key.
+ * @param {Object} texture Destination texture state.
+ * @param {HTMLImageElement} image Source image.
+ * @param {GPUDevice} device Device owning the destination.
+ * @param {number} width Image width in pixels.
+ * @param {number} height Image height in pixels.
+ *
+ * @throws {Error} If the GPU image copy fails.
+ */
+export function uploadNativeImage(state, key, texture, image, device, width, height) {
+  try {
+    device.queue.copyExternalImageToTexture(
+      /* alloc */ { source: image },
+      /* alloc */ { texture: texture.texture },
+      /* alloc */ [width, height]);
+  } catch (error) {
+    texture.texture.destroy();
+    state.textures.delete(key);
+    throw error;
+  }
+  texture.uploaded = image;
+}

package/src/textures/uploadRoofTile.js

@@ -1,29 +1,29 @@
-import { roofImage } from '../globals/roofImage.js';
-import { roofTarget } from '../globals/roofTarget.js';
-import { roofCopySize } from '../globals/roofCopySize.js';
-
-/**
- * Upload a roof tile image when its texture does not already contain it.
- *
- * @param {GPUDevice} device Device owning the destination texture.
- * @param {Object} tile Raster tile with image and texture state.
- */
-export function uploadRoofTile(device, tile) {
-  const source = tile.texture;
-  if (source.uploaded !== source.image) {
-    device.queue.copyExternalImageToTexture((
-      roofImage.source = tile.image,
-      roofImage
-    ), (
-      roofTarget.texture = source.texture,
-      roofTarget
-    ), (
-      roofCopySize[0] = source.texture.width,
-      roofCopySize[1] = source.texture.height,
-      roofCopySize
-    ));
-    roofImage.source = null;
-    roofTarget.texture = null;
-    source.uploaded = source.image;
-  }
-}
+import { roofImage } from '../globals/roofImage.js';
+import { roofTarget } from '../globals/roofTarget.js';
+import { roofCopySize } from '../globals/roofCopySize.js';
+
+/**
+ * Upload a roof tile image when its texture does not already contain it.
+ *
+ * @param {GPUDevice} device Device owning the destination texture.
+ * @param {Object} tile Raster tile with image and texture state.
+ */
+export function uploadRoofTile(device, tile) {
+  const source = tile.texture;
+  if (source.uploaded !== source.image) {
+    device.queue.copyExternalImageToTexture((
+      roofImage.source = tile.image,
+      roofImage
+    ), (
+      roofTarget.texture = source.texture,
+      roofTarget
+    ), (
+      roofCopySize[0] = source.texture.width,
+      roofCopySize[1] = source.texture.height,
+      roofCopySize
+    ));
+    roofImage.source = null;
+    roofTarget.texture = null;
+    source.uploaded = source.image;
+  }
+}

package/src/traffic/createTrafficMesh.js

@@ -1,18 +1,18 @@
-import * as createMeshApi from '../rendering/createMesh.js';
-
-/**
- * Create a traffic mesh and attach its feature ranges for picking.
- *
- * @param {Object} state Traffic layer state.
- * @param {Object} data Mesh geometry data.
- * @param {Array} featureFaces Face ranges for picking.
- * @param {Object} material Mesh material options.
- * @param {number} [usage=0] Additional GPU buffer usage flags.
- *
- * @returns {Object} The created mesh.
- */
-export function createTrafficMesh(state, data, featureFaces, material, usage = 0) {
-  const result = createMeshApi.createMesh(state.layer, data, material, usage);
-  result.extras.featureFaces = featureFaces;
-  return result;
+import * as createMeshApi from '../rendering/createMesh.js';
+
+/**
+ * Create a traffic mesh and attach its feature ranges for picking.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {Object} data Mesh geometry data.
+ * @param {Array} featureFaces Face ranges for picking.
+ * @param {Object} material Mesh material options.
+ * @param {number} [usage=0] Additional GPU buffer usage flags.
+ *
+ * @returns {Object} The created mesh.
+ */
+export function createTrafficMesh(state, data, featureFaces, material, usage = 0) {
+  const result = createMeshApi.createMesh(state.layer, data, material, usage);
+  result.extras.featureFaces = featureFaces;
+  return result;
 }

package/src/traffic/disposeTrafficObject.js

@@ -1,21 +1,21 @@
-import { highlightedFeatureByLayer } from '../weakmaps/highlightedFeatureByLayer.js';
-import { hoveredFeatureByLayer } from '../weakmaps/hoveredFeatureByLayer.js';
-import * as disposeMesh from '../rendering/disposeMesh.js';
-import * as setHighlight from '../picking/setHighlight.js';
-import * as showFeature from '../picking/showFeature.js';
-
-/**
- * Dispose a traffic mesh, clearing the layer's highlight and tooltip if they reference it.
- *
- * @param {Object} state Traffic layer state.
- * @param {Object|null} object Mesh to dispose, if present.
- */
+import { highlightedFeatureByLayer } from '../weakmaps/highlightedFeatureByLayer.js';
+import { hoveredFeatureByLayer } from '../weakmaps/hoveredFeatureByLayer.js';
+import * as disposeMesh from '../rendering/disposeMesh.js';
+import * as setHighlight from '../picking/setHighlight.js';
+import * as showFeature from '../picking/showFeature.js';
+
+/**
+ * Dispose a traffic mesh, clearing the layer's highlight and tooltip if they reference it.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {Object|null} object Mesh to dispose, if present.
+ */
 export function disposeTrafficObject(state, object) {
-  if (!object) return;
-  if (highlightedFeatureByLayer.get(state.layer)?.mesh === object) {
-    setHighlight.setHighlight(state.layer, null);
-    hoveredFeatureByLayer.set(state.layer, null);
-    showFeature.showFeature(state.layer, null);
-  };
-  disposeMesh.disposeMesh(state.layer, object);
+  if (!object) return;
+  if (highlightedFeatureByLayer.get(state.layer)?.mesh === object) {
+    setHighlight.setHighlight(state.layer, null);
+    hoveredFeatureByLayer.set(state.layer, null);
+    showFeature.showFeature(state.layer, null);
+  };
+  disposeMesh.disposeMesh(state.layer, object);
 }

package/src/traffic/failTraffic.js

@@ -1,12 +1,12 @@
-/**
- * Record and log a traffic error and expose it in the layer status.
- *
- * @param {Object} state Traffic layer state.
- * @param {Error} error Error to report.
- */
-export function failTraffic(state, error) {
-  state.error = error;
-  state.status.textContent = `${state.vehicle}: Error: ${error.message}`;
-  state.status.setAttribute('role', 'alert');
-  console.error('Traffic layer', error);
-}
+/**
+ * Record and log a traffic error and expose it in the layer status.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {Error} error Error to report.
+ */
+export function failTraffic(state, error) {
+  state.error = error;
+  state.status.textContent = `${state.vehicle}: Error: ${error.message}`;
+  state.status.setAttribute('role', 'alert');
+  console.error('Traffic layer', error);
+}

package/src/traffic/failedTrafficLoad.js

@@ -1,12 +1,12 @@
-import { failTraffic } from './failTraffic.js';
-
-/**
- * Report traffic loading errors unless the request was cancelled.
- *
- * @param {Object} state Traffic layer state.
- * @param {AbortSignal} signal Signal for the lane request.
- * @param {Error} error Loading failure.
- */
+import { failTraffic } from './failTraffic.js';
+
+/**
+ * Report traffic loading errors unless the request was cancelled.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {AbortSignal} signal Signal for the lane request.
+ * @param {Error} error Loading failure.
+ */
 export function failedTrafficLoad(state, signal, error) {
-  if (!signal.aborted && error.name !== 'AbortError') failTraffic(state, error);
+  if (!signal.aborted && error.name !== 'AbortError') failTraffic(state, error);
 }

package/src/traffic/fetchTrafficLanes.js

@@ -1,21 +1,21 @@
-/**
- * Load time-dependent lanes from a JS module or fetch and cache a static GeoJSON response.
- *
- * @param {Object} state Traffic layer state.
- * @param {Date} time Current simulation time.
- * @param {AbortSignal} signal Signal for cancelling the request.
- *
- * @returns {Promise<Object>} The loaded GeoJSON data.
- *
- * @throws {Error} If the static data request returns a non-success status.
- */
-export async function fetchTrafficLanes(state, time, signal) {
-  const href = /* alloc */ new URL(state.url, document.baseURI).href;
-  if (/\.m?js(?:[?#]|$)/i.test(state.url)) return (await import(href)).default(time, state.layer, signal);
-  if (!state.file) {
-    const response = await fetch(href, /* alloc */ { signal });
-    if (!response.ok) throw /* alloc */ new Error(`HTTP ${response.status}`);
-    state.file = await response.json();
-  }
-  return state.file;
-}
+/**
+ * Load time-dependent lanes from a JS module or fetch and cache a static GeoJSON response.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {Date} time Current simulation time.
+ * @param {AbortSignal} signal Signal for cancelling the request.
+ *
+ * @returns {Promise<Object>} The loaded GeoJSON data.
+ *
+ * @throws {Error} If the static data request returns a non-success status.
+ */
+export async function fetchTrafficLanes(state, time, signal) {
+  const href = /* alloc */ new URL(state.url, document.baseURI).href;
+  if (/\.m?js(?:[?#]|$)/i.test(state.url)) return (await import(href)).default(time, state.layer, signal);
+  if (!state.file) {
+    const response = await fetch(href, /* alloc */ { signal });
+    if (!response.ok) throw /* alloc */ new Error(`HTTP ${response.status}`);
+    state.file = await response.json();
+  }
+  return state.file;
+}

package/src/traffic/loadedTrafficLanes.js

@@ -1,23 +1,23 @@
-import { toLanes } from './featuresToTrafficLanes.js';
-import { prepareTraffic } from './prepareTraffic.js';
-
-/**
- * Apply loaded lanes unless cancelled or detached, preparing new data and restarting traffic updates.
- *
- * @param {Object} state Traffic layer state.
- * @param {AbortSignal} signal Signal for the completed request.
- * @param {Object} data Loaded GeoJSON data.
- */
+import { toLanes } from './featuresToTrafficLanes.js';
+import { prepareTraffic } from './prepareTraffic.js';
+
+/**
+ * Apply loaded lanes unless cancelled or detached, preparing new data and restarting traffic updates.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {AbortSignal} signal Signal for the completed request.
+ * @param {Object} data Loaded GeoJSON data.
+ */
 export function loadedTrafficLanes(state, signal, data) {
-  if (signal.aborted || !state.layer._map) return;
-  state.error = null;
-  if (data === state.loaded) {
-    state.nextCheck = -Infinity;
-    if (!state.frame) state.tick();
-    return;
-  }
-  state.loaded = data;
-  state.lanes = toLanes(data);
-  prepareTraffic(state);
-  if (!state.frame) state.tick();
+  if (signal.aborted || !state.layer._map) return;
+  state.error = null;
+  if (data === state.loaded) {
+    state.nextCheck = -Infinity;
+    if (!state.frame) state.tick();
+    return;
+  }
+  state.loaded = data;
+  state.lanes = toLanes(data);
+  prepareTraffic(state);
+  if (!state.frame) state.tick();
 }

package/src/traffic/locateTraffic.js

@@ -1,20 +1,20 @@
-import { along } from '../geometry/interpolateRoute.js';
-
-/**
- * Interpolate a trip's current position along its looping lane and apply the lateral offset.
- *
- * @param {Object} state Traffic layer state.
- * @param {Object} trip Trip with lane, distance and speed.
- * @param {Object} target Reusable output position.
- *
- * @returns {Object} Position and direction along the lane.
- */
-export function locateTraffic(state, trip, target) {
-  const { points, lengths, length } = trip.lane;
-  let distance = trip.distance + state.elapsed * trip.speed;
-  distance -= length * Math.floor(distance / length);
-  const position = along(points, lengths, distance, target);
-  position.x -= position.dz * state.side;
-  position.z += position.dx * state.side;
-  return position;
-}
+import { along } from '../geometry/interpolateRoute.js';
+
+/**
+ * Interpolate a trip's current position along its looping lane and apply the lateral offset.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {Object} trip Trip with lane, distance and speed.
+ * @param {Object} target Reusable output position.
+ *
+ * @returns {Object} Position and direction along the lane.
+ */
+export function locateTraffic(state, trip, target) {
+  const { points, lengths, length } = trip.lane;
+  let distance = trip.distance + state.elapsed * trip.speed;
+  distance -= length * Math.floor(distance / length);
+  const position = along(points, lengths, distance, target);
+  position.x -= position.dz * state.side;
+  position.z += position.dx * state.side;
+  return position;
+}

package/src/traffic/moveTraffic.js

@@ -1,21 +1,21 @@
-/**
- * Dispatch the GPU traffic pose computation for the elapsed time and mark CPU geometry stale.
- *
- * @param {Object} state Traffic layer state.
- * @param {number} seconds Seconds elapsed since the trip positions were rebased.
- */
-export function moveTraffic(state, seconds) {
-  const { device } = state.gpu;
-  state.paramFloats[0] = state.elapsed = seconds;
-  state.paramFloats[1] = state.side;
-  state.paramInts[2] = state.vertices;
-  state.paramInts[3] = state.trips.length * state.vertices;
-  device.queue.writeBuffer(state.gpu.params, 0, state.params);
-  const encoder = device.createCommandEncoder(), pass = encoder.beginComputePass();
-  pass.setPipeline(state.gpu.pipeline);
-  pass.setBindGroup(0, state.gpu.bindGroup);
-  pass.dispatchWorkgroups(state.trips.length);
-  pass.end();
-  device.queue.submit(/* alloc */ [encoder.finish()]);
-  state.stale = true;
-}
+/**
+ * Dispatch the GPU traffic pose computation for the elapsed time and mark CPU geometry stale.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {number} seconds Seconds elapsed since the trip positions were rebased.
+ */
+export function moveTraffic(state, seconds) {
+  const { device } = state.gpu;
+  state.paramFloats[0] = state.elapsed = seconds;
+  state.paramFloats[1] = state.side;
+  state.paramInts[2] = state.vertices;
+  state.paramInts[3] = state.trips.length * state.vertices;
+  device.queue.writeBuffer(state.gpu.params, 0, state.params);
+  const encoder = device.createCommandEncoder(), pass = encoder.beginComputePass();
+  pass.setPipeline(state.gpu.pipeline);
+  pass.setBindGroup(0, state.gpu.bindGroup);
+  pass.dispatchWorkgroups(state.trips.length);
+  pass.end();
+  device.queue.submit(/* alloc */ [encoder.finish()]);
+  state.stale = true;
+}

package/src/traffic/readyTraffic.js

@@ -1,11 +1,11 @@
-import { startTraffic } from './startTraffic.js';
-
-/**
- * Mark a traffic layer ready and start it if already attached to a map.
- *
- * @param {Object} state Traffic layer state.
- */
-export function readyTraffic(state) {
-  state.ready = true;
-  if (state.layer._map) startTraffic(state);
+import { startTraffic } from './startTraffic.js';
+
+/**
+ * Mark a traffic layer ready and start it if already attached to a map.
+ *
+ * @param {Object} state Traffic layer state.
+ */
+export function readyTraffic(state) {
+  state.ready = true;
+  if (state.layer._map) startTraffic(state);
 }

package/src/traffic/refreshTrafficTrips.js

@@ -1,42 +1,42 @@
-import { tripsAt } from './tripsAt.js';
-import { failTraffic } from './failTraffic.js';
-import { drawTrafficRoute } from './drawTrafficRoute.js';
-import { rebuildTrafficMesh } from './rebuildTrafficMesh.js';
-import { rebaseTraffic } from './rebaseTraffic.js';
-import { trafficStatusText } from './trafficStatusText.js';
-
-/**
- * Recompute scheduled trips and status, rebuilding changed geometry and rebasing GPU data.
- *
- * @param {Object} state Traffic layer state.
- * @param {Date|undefined} time Simulation time, if available.
- * @param {number|undefined} ms Simulation timestamp in milliseconds, if available.
- * @param {boolean} valid Whether the simulation timestamp is valid.
- *
- * @returns {boolean|undefined} Whether geometry changed, or undefined if updating trips failed.
- */
-export function refreshTrafficTrips(state, time, ms, valid) {
-  let text;
-  try {
-    if (valid) state.trips = tripsAt(time, state.lanes, state.velocity);
-    else state.trips.length = 0;
-    text = trafficStatusText(state, valid);
-  } catch (error) {
-    failTraffic(state, error);
-    return;
-  }
-  state.rebasedAt = ms;
-  state.nextCheck = ms + 1000;
-  let key = '', trip;
-  for (trip of state.trips) key += `${key ? ',' : ''}${trip.id}`;
-  const routeNeeded = state.outline && !state.route && state.lanes.length;
-  const changed = key !== state.tripsKey || Boolean(routeNeeded);
-  if (routeNeeded) drawTrafficRoute(state);
-  if (key !== state.tripsKey) { rebuildTrafficMesh(state); state.tripsKey = key; }
-  if (state.mesh) rebaseTraffic(state);
-  if (!state.error) {
-    if (state.status.textContent !== text) state.status.textContent = text;
-    state.status.removeAttribute('role');
-  }
-  return changed;
-}
+import { tripsAt } from './tripsAt.js';
+import { failTraffic } from './failTraffic.js';
+import { drawTrafficRoute } from './drawTrafficRoute.js';
+import { rebuildTrafficMesh } from './rebuildTrafficMesh.js';
+import { rebaseTraffic } from './rebaseTraffic.js';
+import { trafficStatusText } from './trafficStatusText.js';
+
+/**
+ * Recompute scheduled trips and status, rebuilding changed geometry and rebasing GPU data.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {Date|undefined} time Simulation time, if available.
+ * @param {number|undefined} ms Simulation timestamp in milliseconds, if available.
+ * @param {boolean} valid Whether the simulation timestamp is valid.
+ *
+ * @returns {boolean|undefined} Whether geometry changed, or undefined if updating trips failed.
+ */
+export function refreshTrafficTrips(state, time, ms, valid) {
+  let text;
+  try {
+    if (valid) state.trips = tripsAt(time, state.lanes, state.velocity);
+    else state.trips.length = 0;
+    text = trafficStatusText(state, valid);
+  } catch (error) {
+    failTraffic(state, error);
+    return;
+  }
+  state.rebasedAt = ms;
+  state.nextCheck = ms + 1000;
+  let key = '', trip;
+  for (trip of state.trips) key += `${key ? ',' : ''}${trip.id}`;
+  const routeNeeded = state.outline && !state.route && state.lanes.length;
+  const changed = key !== state.tripsKey || Boolean(routeNeeded);
+  if (routeNeeded) drawTrafficRoute(state);
+  if (key !== state.tripsKey) { rebuildTrafficMesh(state); state.tripsKey = key; }
+  if (state.mesh) rebaseTraffic(state);
+  if (!state.error) {
+    if (state.status.textContent !== text) state.status.textContent = text;
+    state.status.removeAttribute('role');
+  }
+  return changed;
+}

package/src/traffic/routeColor.js

@@ -1,13 +1,13 @@
-/**
- * Decode a six-digit route color to normalized RGB, falling back to the default route color.
- *
- * @param {Object|null|undefined} properties Route properties containing an optional route_color.
- *
- * @returns {number[]} Normalized RGB components.
- */
-export function routeColor(properties) {
-  const color = properties?.route_color;
-  if (!/^[\da-f]{6}$/i.test(color)) return /* alloc */ [0.1, 0.55, 0.65];
-  const value = Number.parseInt(color, 16);
-  return /* alloc */ [(value >> 16 & 255) / 255, (value >> 8 & 255) / 255, (value & 255) / 255];
-}
+/**
+ * Decode a six-digit route color to normalized RGB, falling back to the default route color.
+ *
+ * @param {Object|null|undefined} properties Route properties containing an optional route_color.
+ *
+ * @returns {number[]} Normalized RGB components.
+ */
+export function routeColor(properties) {
+  const color = properties?.route_color;
+  if (!/^[\da-f]{6}$/i.test(color)) return /* alloc */ [0.1, 0.55, 0.65];
+  const value = Number.parseInt(color, 16);
+  return /* alloc */ [(value >> 16 & 255) / 255, (value >> 8 & 255) / 255, (value & 255) / 255];
+}

package/src/traffic/startTraffic.js

@@ -1,13 +1,13 @@
-import { underEntry } from '../layer-controls/underEntry.js';
-
-/**
- * Register time and terrain listeners, show the layer status and start traffic updates.
- *
- * @param {Object} state Traffic layer state.
- */
-export function startTraffic(state) {
-  state.layer._map.off('simulationtimechange layerremove', state.update).on('simulationtimechange layerremove', state.update);
-  state.layer._map.off('terrainchange', state.terrain).on('terrainchange', state.terrain);
-  underEntry(state.layer, state.status);
-  state.update();
+import { underEntry } from '../layer-controls/underEntry.js';
+
+/**
+ * Register time and terrain listeners, show the layer status and start traffic updates.
+ *
+ * @param {Object} state Traffic layer state.
+ */
+export function startTraffic(state) {
+  state.layer._map.off('simulationtimechange layerremove', state.update).on('simulationtimechange layerremove', state.update);
+  state.layer._map.off('terrainchange', state.terrain).on('terrainchange', state.terrain);
+  underEntry(state.layer, state.status);
+  state.update();
 }

package/src/traffic/trafficNow.js

@@ -1,16 +1,16 @@
-import { timeControlByMap } from '../weakmaps/timeControlByMap.js';
-
-/**
- * Return the selected simulation time, or the current time when the map clock is live.
- *
- * @param {Object} state Traffic layer state.
- *
- * @returns {Object} Live-mode flag and selected time.
- */
+import { timeControlByMap } from '../weakmaps/timeControlByMap.js';
+
+/**
+ * Return the selected simulation time, or the current time when the map clock is live.
+ *
+ * @param {Object} state Traffic layer state.
+ *
+ * @returns {Object} Live-mode flag and selected time.
+ */
 export function trafficNow(state) {
-  const control = timeControlByMap.get(state.layer._map);
-  const live = control ? control.live : true;
-  return /* alloc */ {
-    live, time: live ? /* alloc */ new Date() : control.time,
-  };
-}
+  const control = timeControlByMap.get(state.layer._map);
+  const live = control ? control.live : true;
+  return /* alloc */ {
+    live, time: live ? /* alloc */ new Date() : control.time,
+  };
+}

package/src/traffic/trafficStatusText.js

@@ -1,13 +1,13 @@
-/**
- * Format the traffic layer status for an invalid clock, loading state or active trip count.
- *
- * @param {Object} state Traffic layer state.
- * @param {boolean} valid Whether the simulation time is valid.
- *
- * @returns {string} Status text.
- */
-export function trafficStatusText(state, valid) {
-  if (!valid) return `${state.vehicle}: select a valid simulation date`;
-  if (!state.loaded) return `${state.vehicle}: loading…`;
-  return `${state.trips.length} ${state.vehicle === 'boat' ? 'boats' : state.vehicle}`;
-}
+/**
+ * Format the traffic layer status for an invalid clock, loading state or active trip count.
+ *
+ * @param {Object} state Traffic layer state.
+ * @param {boolean} valid Whether the simulation time is valid.
+ *
+ * @returns {string} Status text.
+ */
+export function trafficStatusText(state, valid) {
+  if (!valid) return `${state.vehicle}: select a valid simulation date`;
+  if (!state.loaded) return `${state.vehicle}: loading…`;
+  return `${state.trips.length} ${state.vehicle === 'boat' ? 'boats' : state.vehicle}`;
+}