leaflet-city-mapper 0.1.0 → 0.1.1

package/src/walk/updateWalkerView.js

@@ -1,31 +1,31 @@
-import { degrees } from '../globals/degrees.js';
-import { radians } from '../globals/radians.js';
-import { mapGetBearing } from '../camera/mapGetBearing.js';
-import { mapSetPitchAndBearing } from '../camera/mapSetPitchAndBearing.js';
-import { mapGetPitch } from '../camera/mapGetPitch.js';
-import { wrap } from '../utils/wrap.js';
-
-/**
- * Follow movement with the map camera and ease the limb swing toward its active or idle amplitude.
- *
- * @param {number} forward Signed movement direction.
- * @param {number} turn Signed turning direction.
- * @param {number} dt Frame duration in seconds.
- *
- * @returns {boolean} Whether the limb swing was updated.
- */
-export function updateWalkerView(forward, turn, dt) {
-  const map = this.layer._map;
-  if (forward || turn) {
-    // Swing the camera behind the walker.
-    const bearing = mapGetBearing(map) * radians, behind = wrap(-this.state.heading - bearing);
-    if (Math.abs(behind) > 1e-3) mapSetPitchAndBearing(map, mapGetPitch(map), (bearing + behind * Math.min(1, dt * 4)) * degrees);
-    map.setView(this.state.latlng, map.getZoom(), /* alloc */ { animate: false });
-  }
-  const target = forward ? 0.9 : 0;
-  if (Math.abs(this.swing - target) > 1e-3) {
-    this.swing += (target - this.swing) * Math.min(1, dt * 10);
-    return true;
-  }
-  return false;
-}
+import { degrees } from '../globals/degrees.js';
+import { radians } from '../globals/radians.js';
+import { mapGetBearing } from '../camera/mapGetBearing.js';
+import { mapSetPitchAndBearing } from '../camera/mapSetPitchAndBearing.js';
+import { mapGetPitch } from '../camera/mapGetPitch.js';
+import { wrap } from '../utils/wrap.js';
+
+/**
+ * Follow movement with the map camera and ease the limb swing toward its active or idle amplitude.
+ *
+ * @param {number} forward Signed movement direction.
+ * @param {number} turn Signed turning direction.
+ * @param {number} dt Frame duration in seconds.
+ *
+ * @returns {boolean} Whether the limb swing was updated.
+ */
+export function updateWalkerView(forward, turn, dt) {
+  const map = this.layer._map;
+  if (forward || turn) {
+    // Swing the camera behind the walker.
+    const bearing = mapGetBearing(map) * radians, behind = wrap(-this.state.heading - bearing);
+    if (Math.abs(behind) > 1e-3) mapSetPitchAndBearing(map, mapGetPitch(map), (bearing + behind * Math.min(1, dt * 4)) * degrees);
+    map.setView(this.state.latlng, map.getZoom(), /* alloc */ { animate: false });
+  }
+  const target = forward ? 0.9 : 0;
+  if (Math.abs(this.swing - target) > 1e-3) {
+    this.swing += (target - this.swing) * Math.min(1, dt * 10);
+    return true;
+  }
+  return false;
+}

package/src/weakmaps/cameraHandlersByMap.js

@@ -1,6 +1,6 @@
-/**
- * Camera interaction handlers indexed by name for each map.
- *
- * @type {WeakMap<Object, Map>}
- */
-export const cameraHandlersByMap = new WeakMap();
+/**
+ * Camera interaction handlers indexed by name for each map.
+ *
+ * @type {WeakMap<Object, Map>}
+ */
+export const cameraHandlersByMap = new WeakMap();

package/src/weakmaps/geometryWorkersByMap.js

@@ -1,6 +1,6 @@
-/**
- * Geometry worker pools shared by layers on each map.
- *
- * @type {WeakMap<Object, Object>}
- */
-export const geometryWorkersByMap = new WeakMap();
+/**
+ * Geometry worker pools shared by layers on each map.
+ *
+ * @type {WeakMap<Object, Object>}
+ */
+export const geometryWorkersByMap = new WeakMap();

package/src/weakmaps/nativeProgramsByRenderer.js

@@ -1,6 +1,6 @@
-/**
- * Cached native material program templates keyed by renderer.
- *
- * @type {WeakMap<Object, Map>}
- */
-export const nativeProgramsByRenderer = new WeakMap();
+/**
+ * Cached native material program templates keyed by renderer.
+ *
+ * @type {WeakMap<Object, Map>}
+ */
+export const nativeProgramsByRenderer = new WeakMap();

package/src/weakmaps/pathProjectionByMap.js

@@ -1,6 +1,6 @@
-/**
- * Cached native path projection state keyed by map.
- *
- * @type {WeakMap<Object, Object>}
- */
-export const pathProjectionByMap = new WeakMap();
+/**
+ * Cached native path projection state keyed by map.
+ *
+ * @type {WeakMap<Object, Object>}
+ */
+export const pathProjectionByMap = new WeakMap();

package/src/weakmaps/streamTerrainByLayer.js

@@ -1,6 +1,6 @@
-/**
- * Flags identifying terrain layers backed by streaming tile callbacks.
- *
- * @type {WeakMap<Object, boolean>}
- */
-export const streamTerrainByLayer = new WeakMap();
+/**
+ * Flags identifying terrain layers backed by streaming tile callbacks.
+ *
+ * @type {WeakMap<Object, boolean>}
+ */
+export const streamTerrainByLayer = new WeakMap();

package/src/weakmaps/streamTerrainByMap.js

@@ -1,6 +1,6 @@
-/**
- * Active streamed terrain state keyed by map.
- *
- * @type {WeakMap<Object, Object>}
- */
-export const streamTerrainByMap = new WeakMap();
+/**
+ * Active streamed terrain state keyed by map.
+ *
+ * @type {WeakMap<Object, Object>}
+ */
+export const streamTerrainByMap = new WeakMap();

package/src/weakmaps/sunByMap.js

@@ -1,6 +1,6 @@
-/**
- * Shared sunlight control state keyed by map.
- *
- * @type {WeakMap<Object, Object>}
- */
-export const sunByMap = new WeakMap();
+/**
+ * Shared sunlight control state keyed by map.
+ *
+ * @type {WeakMap<Object, Object>}
+ */
+export const sunByMap = new WeakMap();

package/src/weakmaps/vectorTileOptionsByLayer.js

@@ -1,6 +1,6 @@
-/**
- * Resolved vector tile source settings keyed by layer.
- *
- * @type {WeakMap<Object, Object>}
- */
-export const vectorTileOptionsByLayer = new WeakMap();
+/**
+ * Resolved vector tile source settings keyed by layer.
+ *
+ * @type {WeakMap<Object, Object>}
+ */
+export const vectorTileOptionsByLayer = new WeakMap();

package/src/weakmaps/vectorWorkerByLayer.js

@@ -1,6 +1,6 @@
-/**
- * Vector tile worker entries and temporary URLs keyed by layer.
- *
- * @type {WeakMap<Object, Object>}
- */
-export const vectorWorkerByLayer = new WeakMap();
+/**
+ * Vector tile worker entries and temporary URLs keyed by layer.
+ *
+ * @type {WeakMap<Object, Object>}
+ */
+export const vectorWorkerByLayer = new WeakMap();

package/src/weakmaps/walkByMap.js

@@ -1,6 +1,6 @@
-/**
- * Walking control state shared by each map.
- *
- * @type {WeakMap<Object, Object>}
- */
-export const walkByMap = new WeakMap();
+/**
+ * Walking control state shared by each map.
+ *
+ * @type {WeakMap<Object, Object>}
+ */
+export const walkByMap = new WeakMap();

package/src/weakmaps/workerMapByLayer.js

@@ -1,6 +1,6 @@
-/**
- * Map used to obtain shared workers for detached source layers.
- *
- * @type {WeakMap<Object, Object>}
- */
-export const workerMapByLayer = new WeakMap();
+/**
+ * Map used to obtain shared workers for detached source layers.
+ *
+ * @type {WeakMap<Object, Object>}
+ */
+export const workerMapByLayer = new WeakMap();

package/src/workers/acquireGeometryWorker.js

@@ -1,39 +1,39 @@
-import { geometryWorkersByMap } from '../weakmaps/geometryWorkersByMap.js';
-import { closeGeometryWorkers } from './closeGeometryWorkers.js';
-import { createGeometryWorker } from './createGeometryWorker.js';
-
-/**
- * Reuse an idle worker for the URL or create one, closing the map's pool on unload.
- *
- * @param {L.Map|null|undefined} map Owner of the worker pool, if available.
- * @param {string} url Worker module URL.
- *
- * @returns {Object} The acquired worker entry.
- *
- * @throws {DOMException} If the map's worker pool is closed.
- */
-export function acquireGeometryWorker(map, url) {
-  let pool = map && geometryWorkersByMap.get(map);
-  if (map && !pool) {
-    pool = /* alloc */ { entries: /* alloc */ new Set(), idle: /* alloc */ [], closed: false };
-    geometryWorkersByMap.set(map, pool);
-    map.once('unload', closeGeometryWorkers.bind(null, pool));
-  }
-  let entry, i;
-  if (pool) {
-    if (pool.closed) throw /* alloc */ new DOMException('Map removed', 'AbortError');
-    for (i = 0; i < pool.idle.length; i++) {
-      if (pool.idle[i].url !== url) continue;
-      entry = pool.idle[i];
-      pool.idle.splice(i, 1);
-      return entry;
-    }
-    entry = pool.idle.pop();
-    if (entry) {
-      entry.closed = true;
-      entry.worker.terminate();
-      pool.entries.delete(entry);
-    }
-  }
-  return createGeometryWorker(url, pool);
-}
+import { geometryWorkersByMap } from '../weakmaps/geometryWorkersByMap.js';
+import { closeGeometryWorkers } from './closeGeometryWorkers.js';
+import { createGeometryWorker } from './createGeometryWorker.js';
+
+/**
+ * Reuse an idle worker for the URL or create one, closing the map's pool on unload.
+ *
+ * @param {L.Map|null|undefined} map Owner of the worker pool, if available.
+ * @param {string} url Worker module URL.
+ *
+ * @returns {Object} The acquired worker entry.
+ *
+ * @throws {DOMException} If the map's worker pool is closed.
+ */
+export function acquireGeometryWorker(map, url) {
+  let pool = map && geometryWorkersByMap.get(map);
+  if (map && !pool) {
+    pool = /* alloc */ { entries: /* alloc */ new Set(), idle: /* alloc */ [], closed: false };
+    geometryWorkersByMap.set(map, pool);
+    map.once('unload', closeGeometryWorkers.bind(null, pool));
+  }
+  let entry, i;
+  if (pool) {
+    if (pool.closed) throw /* alloc */ new DOMException('Map removed', 'AbortError');
+    for (i = 0; i < pool.idle.length; i++) {
+      if (pool.idle[i].url !== url) continue;
+      entry = pool.idle[i];
+      pool.idle.splice(i, 1);
+      return entry;
+    }
+    entry = pool.idle.pop();
+    if (entry) {
+      entry.closed = true;
+      entry.worker.terminate();
+      pool.entries.delete(entry);
+    }
+  }
+  return createGeometryWorker(url, pool);
+}

package/src/workers/buildAreaInWorker.js

@@ -1,24 +1,24 @@
-import { runSourceWorker } from './runSourceWorker.js';
-
-/**
- * Prepare area geometry in a worker, copy the returned ranges and buffers, and release queued jobs.
- *
- * @param {Object} context Area preparation state and queued jobs.
- * @param {AbortSignal} signal Cancellation signal.
- *
- * @returns {Promise<void>} Resolves after the geometry is copied into the context.
- */
-export async function buildAreaInWorker(context, signal) {
-  try {
-    const data = await runSourceWorker(context.map || context.backend._map, context.backend.options.workerUrl,
-      /* alloc */ { jobs: context.jobs, nightLight: Boolean(context.backend.options.nightLight) }, signal);
-    let i;
-    for (i = 0; i < data.ranges.length; i++) Object.assign(context.featureFaces[i], data.ranges[i]);
-    context.positions = data.positions;
-    context.uvs = data.uvs;
-    context.lights = data.lights;
-    context.preparedGeometry = data;
-  } finally {
-    context.jobs = null;
-  }
-}
+import { runSourceWorker } from './runSourceWorker.js';
+
+/**
+ * Prepare area geometry in a worker, copy the returned ranges and buffers, and release queued jobs.
+ *
+ * @param {Object} context Area preparation state and queued jobs.
+ * @param {AbortSignal} signal Cancellation signal.
+ *
+ * @returns {Promise<void>} Resolves after the geometry is copied into the context.
+ */
+export async function buildAreaInWorker(context, signal) {
+  try {
+    const data = await runSourceWorker(context.map || context.backend._map, context.backend.options.workerUrl,
+      /* alloc */ { jobs: context.jobs, nightLight: Boolean(context.backend.options.nightLight) }, signal);
+    let i;
+    for (i = 0; i < data.ranges.length; i++) Object.assign(context.featureFaces[i], data.ranges[i]);
+    context.positions = data.positions;
+    context.uvs = data.uvs;
+    context.lights = data.lights;
+    context.preparedGeometry = data;
+  } finally {
+    context.jobs = null;
+  }
+}

package/src/workers/closeGeometryWorkers.js

@@ -1,16 +1,16 @@
-/**
- * Close a map's worker pool, terminating workers and rejecting pending tasks.
- *
- * @param {Object} pool Worker pool to close.
- */
-export function closeGeometryWorkers(pool) {
-  pool.closed = true;
-  let entry;
-  for (entry of pool.entries) {
-    entry.closed = true;
-    entry.worker.terminate();
-    if (entry.task) entry.task.reject(/* alloc */ new DOMException('Map removed', 'AbortError'));
-  }
-  pool.entries.clear();
-  pool.idle.length = 0;
-}
+/**
+ * Close a map's worker pool, terminating workers and rejecting pending tasks.
+ *
+ * @param {Object} pool Worker pool to close.
+ */
+export function closeGeometryWorkers(pool) {
+  pool.closed = true;
+  let entry;
+  for (entry of pool.entries) {
+    entry.closed = true;
+    entry.worker.terminate();
+    if (entry.task) entry.task.reject(/* alloc */ new DOMException('Map removed', 'AbortError'));
+  }
+  pool.entries.clear();
+  pool.idle.length = 0;
+}

package/src/workers/cogWorker.js

@@ -1,27 +1,27 @@
-import { openCog } from '../cog/openCog.js';
-import { workerCogSource } from '../globals/workerCogSource.js';
-
-/**
- * Read a COG header or tile in the worker, transferring result buffers or reporting the error.
- *
- * @param {MessageEvent} event Request containing the COG URL, asset and optional tile coordinates.
- *
- * @returns {Promise<void>} Resolves after the response is posted.
- */
-export async function onCogMessage({ data }) {
-  try {
-    const key = JSON.stringify(/* alloc */ [data.url, data.asset]);
-    if (!workerCogSource.has(key)) {
-      workerCogSource.set(key, openCog(data.url, data.asset));
-      if (workerCogSource.size > 4) workerCogSource.delete(workerCogSource.keys().next().value);
-    }
-    const archive = await workerCogSource.get(key);
-    const result = data.z === undefined ? await archive.getHeader() : await archive.getZxy(data.z, data.x, data.y);
-    const transfers = /* alloc */ [];
-    if (result?.data) transfers.push(result.data);
-    if (result?.image) transfers.push(result.image);
-    self.postMessage(result, transfers);
-  } catch (error) {
-    self.postMessage(/* alloc */ { error: /* alloc */ { name: error.name, message: error.message } });
-  }
-}
+import { openCog } from '../cog/openCog.js';
+import { workerCogSource } from '../globals/workerCogSource.js';
+
+/**
+ * Read a COG header or tile in the worker, transferring result buffers or reporting the error.
+ *
+ * @param {MessageEvent} event Request containing the COG URL, asset and optional tile coordinates.
+ *
+ * @returns {Promise<void>} Resolves after the response is posted.
+ */
+export async function onCogMessage({ data }) {
+  try {
+    const key = JSON.stringify(/* alloc */ [data.url, data.asset]);
+    if (!workerCogSource.has(key)) {
+      workerCogSource.set(key, openCog(data.url, data.asset));
+      if (workerCogSource.size > 4) workerCogSource.delete(workerCogSource.keys().next().value);
+    }
+    const archive = await workerCogSource.get(key);
+    const result = data.z === undefined ? await archive.getHeader() : await archive.getZxy(data.z, data.x, data.y);
+    const transfers = /* alloc */ [];
+    if (result?.data) transfers.push(result.data);
+    if (result?.image) transfers.push(result.image);
+    self.postMessage(result, transfers);
+  } catch (error) {
+    self.postMessage(/* alloc */ { error: /* alloc */ { name: error.name, message: error.message } });
+  }
+}

package/src/workers/createGeometryWorker.js

@@ -1,30 +1,30 @@
-/**
- * Create a module worker, using a temporary blob for cross-origin URLs, and register it in the pool.
- *
- * @param {string} url Worker module URL.
- * @param {Object|null|undefined} pool Optional owner of the worker entry.
- *
- * @returns {Object} The worker entry, including its URL and optional blob URL.
- *
- * @throws {Error} If Web Workers are unavailable.
- */
-export function createGeometryWorker(url, pool) {
-  if (typeof Worker === 'undefined') throw /* alloc */ new Error('Web Workers are required to prepare source geometry');
-  let workerUrl = url, blobUrl, worker;
-  if (globalThis.location) {
-    const resolved = /* alloc */ new URL(url, location.href);
-    if ((resolved.protocol === 'https:' || resolved.protocol === 'http:') && resolved.origin !== location.origin) {
-      blobUrl = URL.createObjectURL(/* alloc */ new Blob(/* alloc */ [`import ${JSON.stringify(resolved.href)};`],
-        /* alloc */ { type: 'text/javascript' }));
-      workerUrl = blobUrl;
-    }
-  }
-  try {
-    worker = /* alloc */ new Worker(workerUrl, /* alloc */ { type: 'module' });
-  } finally {
-    if (!worker && blobUrl) URL.revokeObjectURL(blobUrl);
-  }
-  const entry = /* alloc */ { url, pool, worker, blobUrl };
-  if (pool) pool.entries.add(entry);
-  return entry;
-}
+/**
+ * Create a module worker, using a temporary blob for cross-origin URLs, and register it in the pool.
+ *
+ * @param {string} url Worker module URL.
+ * @param {Object|null|undefined} pool Optional owner of the worker entry.
+ *
+ * @returns {Object} The worker entry, including its URL and optional blob URL.
+ *
+ * @throws {Error} If Web Workers are unavailable.
+ */
+export function createGeometryWorker(url, pool) {
+  if (typeof Worker === 'undefined') throw /* alloc */ new Error('Web Workers are required to prepare source geometry');
+  let workerUrl = url, blobUrl, worker;
+  if (globalThis.location) {
+    const resolved = /* alloc */ new URL(url, location.href);
+    if ((resolved.protocol === 'https:' || resolved.protocol === 'http:') && resolved.origin !== location.origin) {
+      blobUrl = URL.createObjectURL(/* alloc */ new Blob(/* alloc */ [`import ${JSON.stringify(resolved.href)};`],
+        /* alloc */ { type: 'text/javascript' }));
+      workerUrl = blobUrl;
+    }
+  }
+  try {
+    worker = /* alloc */ new Worker(workerUrl, /* alloc */ { type: 'module' });
+  } finally {
+    if (!worker && blobUrl) URL.revokeObjectURL(blobUrl);
+  }
+  const entry = /* alloc */ { url, pool, worker, blobUrl };
+  if (pool) pool.entries.add(entry);
+  return entry;
+}

package/src/workers/geometryWorker.js

@@ -1,34 +1,34 @@
-import { assembleAreaGeometry } from '../geometry/assembleAreaGeometry.js';
-import { onVectorTileMessage } from './vectorTileWorker.js';
-import { onCogMessage } from './cogWorker.js';
-import { onModelMessage } from './modelWorker.js';
-
-/**
- * Route worker requests to the appropriate source handler or assemble and transfer area geometry.
- *
- * @param {MessageEvent} event Worker request.
- */
-export function onGeometryMessage(event) {
-  if (event.data.type === 'model') {
-    onModelMessage(event);
-    return;
-  }
-  if (event.data.type === 'cog') {
-    onCogMessage(event);
-    return;
-  }
-  if (event.data.type === 'vector') {
-    onVectorTileMessage(event);
-    return;
-  }
-  try {
-    const data = assembleAreaGeometry(event.data);
-    const transfers = /* alloc */ [data.positions.buffer, data.normals.buffer, data.colors.buffer, data.uvs.buffer];
-    if (data.instanceOffsets) transfers.push(data.instanceOffsets.buffer);
-    self.postMessage(data, transfers);
-  } catch (error) {
-    self.postMessage(/* alloc */ { error: /* alloc */ { name: error.name, message: error.message } });
-  }
-}
-
-self.addEventListener('message', onGeometryMessage);
+import { assembleAreaGeometry } from '../geometry/assembleAreaGeometry.js';
+import { onVectorTileMessage } from './vectorTileWorker.js';
+import { onCogMessage } from './cogWorker.js';
+import { onModelMessage } from './modelWorker.js';
+
+/**
+ * Route worker requests to the appropriate source handler or assemble and transfer area geometry.
+ *
+ * @param {MessageEvent} event Worker request.
+ */
+export function onGeometryMessage(event) {
+  if (event.data.type === 'model') {
+    onModelMessage(event);
+    return;
+  }
+  if (event.data.type === 'cog') {
+    onCogMessage(event);
+    return;
+  }
+  if (event.data.type === 'vector') {
+    onVectorTileMessage(event);
+    return;
+  }
+  try {
+    const data = assembleAreaGeometry(event.data);
+    const transfers = /* alloc */ [data.positions.buffer, data.normals.buffer, data.colors.buffer, data.uvs.buffer];
+    if (data.instanceOffsets) transfers.push(data.instanceOffsets.buffer);
+    self.postMessage(data, transfers);
+  } catch (error) {
+    self.postMessage(/* alloc */ { error: /* alloc */ { name: error.name, message: error.message } });
+  }
+}
+
+self.addEventListener('message', onGeometryMessage);

package/src/workers/getCogInWorker.js

@@ -1,18 +1,18 @@
-import { workerMapByLayer } from '../weakmaps/workerMapByLayer.js';
-import { runSourceWorker } from './runSourceWorker.js';
-
-/**
- * Request a COG header or tile through the shared geometry worker pool.
- *
- * @param {Object} context Layer, source URL, asset and worker URL.
- * @param {number|undefined} z Tile zoom, or undefined for the header.
- * @param {number|undefined} x Tile column.
- * @param {number|undefined} y Tile row.
- * @param {AbortSignal|undefined} signal Cancellation signal.
- *
- * @returns {Promise<*>} The header or tile returned by the worker.
- */
-export function getCogInWorker(context, z, x, y, signal) {
-  return runSourceWorker(context.layer._map || workerMapByLayer.get(context.layer), context.workerUrl,
-    /* alloc */ { type: 'cog', url: context.url, asset: context.asset, z, x, y }, signal);
-}
+import { workerMapByLayer } from '../weakmaps/workerMapByLayer.js';
+import { runSourceWorker } from './runSourceWorker.js';
+
+/**
+ * Request a COG header or tile through the shared geometry worker pool.
+ *
+ * @param {Object} context Layer, source URL, asset and worker URL.
+ * @param {number|undefined} z Tile zoom, or undefined for the header.
+ * @param {number|undefined} x Tile column.
+ * @param {number|undefined} y Tile row.
+ * @param {AbortSignal|undefined} signal Cancellation signal.
+ *
+ * @returns {Promise<*>} The header or tile returned by the worker.
+ */
+export function getCogInWorker(context, z, x, y, signal) {
+  return runSourceWorker(context.layer._map || workerMapByLayer.get(context.layer), context.workerUrl,
+    /* alloc */ { type: 'cog', url: context.url, asset: context.asset, z, x, y }, signal);
+}

package/src/workers/modelWorker.js

@@ -1,17 +1,17 @@
-import { prepareModel } from '../models/prepareModel.js';
-
-/**
- * Prepare a model in the worker and transfer its buffers, reporting errors to the caller.
- *
- * @param {MessageEvent} event Request containing the model URL.
- *
- * @returns {Promise<void>} Resolves after the response is posted.
- */
-export async function onModelMessage({ data }) {
-  try {
-    const result = await prepareModel(data.url);
-    self.postMessage(/* alloc */ { description: result.description, images: result.images }, result.transfers);
-  } catch (error) {
-    self.postMessage(/* alloc */ { error: /* alloc */ { name: error.name, message: error.message } });
-  }
-}
+import { prepareModel } from '../models/prepareModel.js';
+
+/**
+ * Prepare a model in the worker and transfer its buffers, reporting errors to the caller.
+ *
+ * @param {MessageEvent} event Request containing the model URL.
+ *
+ * @returns {Promise<void>} Resolves after the response is posted.
+ */
+export async function onModelMessage({ data }) {
+  try {
+    const result = await prepareModel(data.url);
+    self.postMessage(/* alloc */ { description: result.description, images: result.images }, result.transfers);
+  } catch (error) {
+    self.postMessage(/* alloc */ { error: /* alloc */ { name: error.name, message: error.message } });
+  }
+}