isard 0.7.0 → 1.0.0

package/dist/layers.js

@@ -5,6 +5,7 @@
  */
 import { parseColor, rampTexels, stops } from "./features.js";
 import { mercatorX, mercatorY, toMercator } from "./geo.js";
+import { rgb } from "./settings.js";
 export class Layer {
     #id = -1;
     /** @internal */
@@ -17,6 +18,17 @@ export class Layer {
     get id() {
         return this.#id;
     }
+    #ready;
+    /** Resolves once the map has drawn the layer, what it shows in view loaded (the map idle after it was added; a
+     * layer waiting for the engine with 3D Tiles, once that one has drawn it) */
+    get ready() {
+        this.#ready ??= (async () => {
+            do
+                await this.map.whenIdle();
+            while (this.#id < 0 && this.needsFullEngine);
+        })();
+        return this.#ready;
+    }
     /** @internal Creates the layer in an engine (again after a context loss); its id is -1 if that fails */
     attach(engine) {
         this.#id = -1;
@@ -55,10 +67,10 @@ export class RasterLayer extends Layer {
         super(map);
         this.options = options;
     }
-    setStyle(style, saturation = 1) {
-        const changed = typeof style === 'number' ? { opacity: style, saturation } : style;
-        this.options.opacity = changed.opacity ?? this.options.opacity;
-        this.options.saturation = changed.saturation ?? this.options.saturation;
+    /** Changes the opacity or saturation, the other kept */
+    setStyle(style) {
+        this.options.opacity = style.opacity ?? this.options.opacity;
+        this.options.saturation = style.saturation ?? this.options.saturation;
         this.map.engine.setRasterStyle(this.id, this.options.opacity, this.options.saturation);
         this.map.requestRender();
     }
@@ -192,11 +204,13 @@ function mercatorPoints(lonLat) {
 /** Textured meshes in 3D Tiles */
 export class Tiles3dLayer extends Layer {
     url;
+    geoid;
     style;
     /** @internal */
-    constructor(map, url, style) {
+    constructor(map, url, geoid, style) {
         super(map);
         this.url = url;
+        this.geoid = geoid;
         this.style = style;
     }
     setStyle(style) {
@@ -204,13 +218,24 @@ export class Tiles3dLayer extends Layer {
         // Kept for its creation while the engine with 3D Tiles loads
         if (this.id < 0)
             return;
-        this.map.engine.setTiles3dStyle(this.id, this.style.maxScreenSpaceError, this.style.opacity, this.style.pointSize);
+        this.applyStyle(this.map.engine, this.id);
         this.map.requestRender();
     }
     /** @internal */
     get needsFullEngine() {
         return true;
     }
+    /** @internal The feature picked (`pickFeature`, 'hoverfeature'): the properties of its feature in the tile
+     * (`EXT_structural_metadata`, a b3dm batch table), none for a mesh without features; its index in the tile as id */
+    featureAt(index) {
+        if (this.id < 0)
+            return undefined;
+        const hit = this.map.engine.tiles3dFeature(this.id, index);
+        if (!hit)
+            return undefined;
+        const [properties, feature] = hit;
+        return { type: 'Feature', id: feature, properties: properties ?? {}, geometry: null };
+    }
     /** Loading counters; undefined once the layer is removed, and while the engine with 3D Tiles loads (see
      * `GeoMapOptions.tiles3d`) */
     stats() {
@@ -218,10 +243,14 @@ export class Tiles3dLayer extends Layer {
     }
     /** @internal */
     create(engine) {
-        const id = engine.addTiles3d(this.url, this.style.maxScreenSpaceError);
-        engine.setTiles3dStyle(id, this.style.maxScreenSpaceError, this.style.opacity, this.style.pointSize);
+        const id = engine.addTiles3d(this.url, this.style.maxScreenSpaceError, this.geoid);
+        this.applyStyle(engine, id);
         return id;
     }
+    applyStyle(engine, id) {
+        const { maxScreenSpaceError, opacity, pointSize, color } = this.style;
+        engine.setTiles3dStyle(id, maxScreenSpaceError, opacity, pointSize, new Float32Array(color ? rgb(color) : []));
+    }
 }
 const bytesOf = (data) => new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
 /** The application's fragment shader run over the ground, draped on the relief (water depth, heat maps…) */

package/dist/layers.js.map

@@ -1 +1 @@
-{"version":3,"file":"layers.js","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Handles of the layers added to a map. Each one keeps what it needs to be created again: after a WebGL context loss,\n * the map recreates its engine and every layer in order, with the same handle (its id is updated). Also the page's\n * own 3D content: custom layers (its WebGL code called in every frame) and glTF models drawn at positions.\n */\nimport { parseColor, rampTexels, stops } from './features.ts';\nimport { mercatorX, mercatorY, toMercator } from './geo.ts';\nimport type { GeoMap } from './map.ts';\nimport type {\n  LayerHost,\n  LonLat,\n  NetworkOptions,\n  NetworkStyle,\n  RasterOptions,\n  RasterStyle,\n  Tiles3dStyle,\n} from './types.ts';\nimport type { Camera, Engine, NetworkStats, Tiles3dStats } from './wasm/isard.js';\n\nexport abstract class Layer {\n  #id = -1;\n\n  /** @internal */\n  protected readonly map: LayerHost;\n\n  /** @internal */\n  constructor(map: LayerHost) {\n    this.map = map;\n  }\n\n  /** Id of the layer in the engine */\n  get id(): number {\n    return this.#id;\n  }\n\n  /** @internal Creates the layer in an engine (again after a context loss); its id is -1 if that fails */\n  attach(engine: Engine): void {\n    this.#id = -1;\n    this.#id = this.create(engine);\n  }\n\n  /** @internal Forgets its id in an engine that is gone (before the layers are created in a new one) */\n  forgetEngine(): void {\n    this.#id = -1;\n  }\n\n  /** @internal Sends what refers to other layers, once every layer of a new engine has its id */\n  relink(_engine: Engine): void {}\n\n  /** @internal Drawn by the engine with 3D Tiles only (3D Tiles, models): on the core engine, it waits for that one */\n  get needsFullEngine(): boolean {\n    return false;\n  }\n\n  /** @internal The layer is removed or its map destroyed: frees what it holds outside the engine */\n  dispose(): void {}\n\n  /** @internal */\n  protected abstract create(engine: Engine): number;\n\n  remove(): void {\n    // Not created yet: a 3D Tiles layer or a model waiting for the engine with 3D Tiles\n    if (this.#id >= 0) this.map.engine.removeLayer(this.#id);\n    this.#id = -1;\n    this.map.detach(this);\n    this.map.requestRender();\n  }\n\n  /** Moves the layer under `other`, or on top of every layer (above the labels of a vector basemap too) */\n  moveBefore(other: Layer | undefined): void {\n    this.map.moveLayer(this, other);\n  }\n}\n\n/** Raster tiles (basemaps, overlays) */\nexport class RasterLayer extends Layer {\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly options: Required<Omit<RasterOptions, 'size' | 'loader' | 'grid' | 'attribution'>> & {\n      size: number | undefined;\n      loader: RasterOptions['loader'] | undefined;\n    },\n  ) {\n    super(map);\n  }\n\n  /** Changes the opacity or saturation, the other kept */\n  setStyle(style: Partial<RasterStyle>): void;\n  /** @deprecated Positional form (saturation back to 1 when not given): `setStyle({ opacity, saturation })` */\n  setStyle(opacity: number, saturation?: number): void;\n  setStyle(style: Partial<RasterStyle> | number, saturation = 1): void {\n    const changed = typeof style === 'number' ? { opacity: style, saturation } : style;\n    this.options.opacity = changed.opacity ?? this.options.opacity;\n    this.options.saturation = changed.saturation ?? this.options.saturation;\n    this.map.engine.setRasterStyle(this.id, this.options.opacity, this.options.saturation);\n    this.map.requestRender();\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const { url, minZoom, maxZoom, opacity, saturation, size, loader } = this.options;\n    return engine.addRaster(url, minZoom, maxZoom, opacity, saturation, size, loader);\n  }\n}\n\n/** Line network colored by a value per node (travel time, water depth…) */\nexport class NetworkLayer extends Layer {\n  private values: Float32Array | undefined;\n  /** Node and line positions in Mercator, kept for a context loss: f32 offsets from an origin (exact to the centimetre\n   * across a region, half the memory of f64) */\n  private kept: { origin: [number, number]; nodes: Float32Array; lines: Float32Array | undefined } | undefined;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private geometry: { nodes: Float64Array; edges: Uint32Array; lines: NetworkOptions['lines'] | undefined },\n    private costs: Float32Array | undefined,\n    private style: NetworkStyle,\n    private edgeWidths: Float32Array | undefined,\n  ) {\n    super(map);\n  }\n\n  /** One value per node, in node order; negative (or 1e30 and above) = unreached. Costs one texture upload, drawn\n   * next frame. */\n  setValues(values: Float32Array): void {\n    this.values = values;\n    this.map.engine.setNetworkValues(this.id, values);\n    this.map.requestRender();\n  }\n\n  /** Costs of the edges, A → B then B → A (see `NetworkOptions.costs`), when the way the network is travelled\n   * changes; undefined: values interpolated along the edges. The geometry stays on the graphics card. */\n  setCosts(costs: Float32Array | undefined): void {\n    this.costs = costs;\n    this.map.engine.setNetworkCosts(this.id, costs);\n    this.map.requestRender();\n  }\n\n  setStyle(style: Partial<NetworkStyle>): void {\n    const ramp = this.style.ramp;\n    this.style = { ...this.style, ...style };\n    this.map.engine.setNetworkStyle(this.id, networkStyle(this.style));\n    if (this.style.ramp !== ramp)\n      this.map.engine.setNetworkRamp(this.id, this.style.ramp && rampTexels(this.style.ramp).rgba);\n    this.map.requestRender();\n  }\n\n  /** Width factor of each edge (undefined: 1 for all) */\n  setEdgeWidths(widths: Float32Array | undefined): void {\n    this.edgeWidths = widths;\n    this.map.engine.setNetworkScales(this.id, widths);\n    this.map.requestRender();\n  }\n\n  /** Pieces in all and drawn in the last frame */\n  stats(): NetworkStats | undefined {\n    return this.map.engine.networkStats(this.id);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const { nodes, edges, lines } = this.geometry;\n    let mercator: { nodes: Float64Array; lines: Float64Array | undefined };\n    if (this.kept) {\n      const { origin, nodes: n, lines: l } = this.kept;\n      mercator = { nodes: unpack(n, origin), lines: l && unpack(l, origin) };\n    } else {\n      // Mercator here: Math.tan and Math.log run natively, several times faster than in WebAssembly\n      mercator = { nodes: mercatorPoints(nodes), lines: lines && mercatorPoints(lines.points) };\n      const origin: [number, number] = [mercator.nodes[0] ?? 0, mercator.nodes[1] ?? 0];\n      this.kept = {\n        origin,\n        nodes: pack(mercator.nodes, origin),\n        lines: mercator.lines && pack(mercator.lines, origin),\n      };\n      // The degrees are not needed again: millions of points for a region\n      this.geometry = { nodes: EMPTY, edges, lines: lines && { start: lines.start, points: EMPTY } };\n    }\n    const id = engine.addNetwork(\n      mercator.nodes,\n      edges,\n      lines?.start,\n      mercator.lines,\n      this.costs,\n      networkStyle(this.style),\n    );\n    if (this.style.ramp) engine.setNetworkRamp(id, rampTexels(this.style.ramp).rgba);\n    if (this.edgeWidths) engine.setNetworkScales(id, this.edgeWidths);\n    if (this.values) engine.setNetworkValues(id, this.values);\n    return id;\n  }\n}\n\n/** The 25 numbers of a network style for the engine */\nfunction networkStyle(style: NetworkStyle): Float32Array {\n  const { width, halo, max, contour, opacity, haloOpacity, unreachedColor, fade } = style;\n  return Float32Array.from([\n    ...stops(width),\n    ...stops(halo),\n    max,\n    contour,\n    opacity,\n    haloOpacity,\n    ...parseColor(unreachedColor),\n    fade,\n  ]);\n}\n\nconst EMPTY = new Float64Array(0);\n\n/** Interleaved points as f32 offsets from an origin, and back */\nfunction pack(points: Float64Array, [ox, oy]: [number, number]): Float32Array {\n  const out = new Float32Array(points.length);\n  for (let i = 0; i < points.length; i += 2) {\n    out[i] = (points[i] ?? 0) - ox;\n    out[i + 1] = (points[i + 1] ?? 0) - oy;\n  }\n  return out;\n}\n\nfunction unpack(points: Float32Array, [ox, oy]: [number, number]): Float64Array {\n  const out = new Float64Array(points.length);\n  for (let i = 0; i < points.length; i += 2) {\n    out[i] = (points[i] ?? 0) + ox;\n    out[i + 1] = (points[i + 1] ?? 0) + oy;\n  }\n  return out;\n}\n\n/** Longitudes and latitudes (degrees, interleaved) to Mercator [0, 1], y towards the south */\nfunction mercatorPoints(lonLat: Float64Array): Float64Array {\n  const out = new Float64Array(lonLat.length);\n  for (let i = 0; i < lonLat.length; i += 2) {\n    out[i] = mercatorX(lonLat[i] ?? 0);\n    out[i + 1] = mercatorY(lonLat[i + 1] ?? 0);\n  }\n  return out;\n}\n\n/** Textured meshes in 3D Tiles */\nexport class Tiles3dLayer extends Layer {\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly url: string,\n    private style: Tiles3dStyle,\n  ) {\n    super(map);\n  }\n\n  setStyle(style: Partial<Tiles3dStyle>): void {\n    this.style = { ...this.style, ...style };\n    // Kept for its creation while the engine with 3D Tiles loads\n    if (this.id < 0) return;\n    this.map.engine.setTiles3dStyle(this.id, this.style.maxScreenSpaceError, this.style.opacity, this.style.pointSize);\n    this.map.requestRender();\n  }\n\n  /** @internal */\n  override get needsFullEngine(): boolean {\n    return true;\n  }\n\n  /** Loading counters; undefined once the layer is removed, and while the engine with 3D Tiles loads (see\n   * `GeoMapOptions.tiles3d`) */\n  stats(): Tiles3dStats | undefined {\n    return this.id < 0 ? undefined : this.map.engine.tiles3dStats(this.id);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const id = engine.addTiles3d(this.url, this.style.maxScreenSpaceError);\n    engine.setTiles3dStyle(id, this.style.maxScreenSpaceError, this.style.opacity, this.style.pointSize);\n    return id;\n  }\n}\n\n/** A texture of a ground layer (see `GroundLayer`) */\nexport interface GroundTexture {\n  /** `r8`, `r8ui`, `r16ui`, `r16i`, `r32ui`, `r32f`, `rg16ui`, `rg32f`, `rgba8`, `rgba8ui`, `rgba16ui`, `rgba32f`:\n   * integer formats are read with `usampler2D` / `isampler2D` and `texelFetch` */\n  format: string;\n  width: number;\n  height: number;\n  /** Layers of a 2D array (`sampler2DArray`, `usampler2DArray`…); 0 or undefined: a 2D texture */\n  depth?: number;\n  /** Linear filtering (non-integer formats); default nearest */\n  linear?: boolean;\n  /** Texels row after row (layer after layer), any typed array; undefined: left empty */\n  data?: ArrayBufferView;\n}\n\nexport interface GroundOptions {\n  /**\n   * GLSL ES 3.0 defining `vec4 ground(vec2 offset)`: the color of the ground (premultiplied alpha, 0 for nothing) at\n   * `offset`, the Mercator offset of the pixel from `anchor` (times `ISARD_CIRCUMFERENCE`: metres of EPSG:3857), exact to\n   * the millimetre at any zoom. The code declares its own uniforms and samplers; also there: `u_zoom`,\n   * `u_pixel_ratio`\n   */\n  code: string;\n  /** Where the offsets are taken from */\n  anchor: LonLat;\n  /** Box it shows in, `[west, south, east, north]` (default the world): only the ground there is drawn again */\n  bounds?: [west: number, south: number, east: number, north: number];\n  textures?: Record<string, GroundTexture>;\n  uniforms?: Record<string, number | readonly number[]>;\n}\n\nconst bytesOf = (data: ArrayBufferView) => new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n\n/** The application's fragment shader run over the ground, draped on the relief (water depth, heat maps…) */\nexport class GroundLayer extends Layer {\n  private readonly textures = new Map<string, GroundTexture>();\n  private readonly uniforms = new Map<string, number[]>();\n  private visible = true;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly options: GroundOptions,\n  ) {\n    super(map);\n    for (const [name, texture] of Object.entries(options.textures ?? {})) this.textures.set(name, texture);\n    for (const [name, value] of Object.entries(options.uniforms ?? {})) this.uniforms.set(name, [value].flat());\n  }\n\n  /** Creates or replaces a texture of the code's sampler `name` */\n  setTexture(name: string, texture: GroundTexture): void {\n    this.textures.set(name, texture);\n    this.sendTexture(this.map.engine, this.id, name, texture);\n    this.map.requestRender();\n  }\n\n  /**\n   * Replaces a region of a texture: `data` holds `width` × `height` texels for (`x`, `y`) of `layer` (2D arrays).\n   * Keep the texture's own `data` up to date too if it must survive a WebGL context loss.\n   */\n  updateTexture(\n    name: string,\n    data: ArrayBufferView,\n    region: { x?: number; y?: number; layer?: number; width: number; height: number },\n  ): void {\n    const { x = 0, y = 0, layer = 0, width, height } = region;\n    this.map.engine.updateGroundTexture(this.id, name, x, y, layer, width, height, bytesOf(data));\n    this.map.requestRender();\n  }\n\n  /** A uniform of the code: a number, or numbers for vectors, arrays and matrices (column major) */\n  setUniform(name: string, value: number | readonly number[]): void {\n    const values = [value].flat();\n    this.uniforms.set(name, values);\n    this.map.engine.setGroundUniform(this.id, name, Float64Array.from(values));\n    this.map.requestRender();\n  }\n\n  setBounds(bounds: [west: number, south: number, east: number, north: number]): void {\n    this.options.bounds = bounds;\n    this.map.engine.setGroundBounds(this.id, ...mercatorBox(bounds));\n    this.map.requestRender();\n  }\n\n  setVisible(visible: boolean): void {\n    this.visible = visible;\n    this.map.engine.setGroundVisible(this.id, visible);\n    this.map.requestRender();\n  }\n\n  private sendTexture(engine: Engine, id: number, name: string, t: GroundTexture): void {\n    const data = t.data && bytesOf(t.data);\n    engine.setGroundTexture(id, name, t.format, t.width, t.height, t.depth ?? 0, t.linear ?? false, data);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const [ax, ay] = toMercator(this.options.anchor);\n    const id = engine.addGround(\n      this.options.code,\n      ax,\n      ay,\n      ...mercatorBox(this.options.bounds ?? [-180, -85.06, 180, 85.06]),\n    );\n    for (const [name, texture] of this.textures) this.sendTexture(engine, id, name, texture);\n    for (const [name, values] of this.uniforms) engine.setGroundUniform(id, name, Float64Array.from(values));\n    engine.setGroundVisible(id, this.visible);\n    return id;\n  }\n}\n\n/** A lon/lat box to Mercator min x, min y, max x, max y (y towards the south) */\nfunction mercatorBox([west, south, east, north]: [number, number, number, number]): [number, number, number, number] {\n  const [x0, y1] = toMercator([west, south]);\n  const [x1, y0] = toMercator([east, north]);\n  return [x0, y0, x1, y1];\n}\n\n// ── The page's own 3D content: custom layers, glTF models ──\n\n/** Reports an error of the page without throwing it here: the console shows it, as an uncaught one */\nfunction report(error: unknown): void {\n  if (typeof reportError === 'function') reportError(error);\n  else\n    queueMicrotask(() => {\n      throw error;\n    });\n}\n\n/** What a custom layer gets to draw a frame (`CustomLayerInterface.render`) */\nexport interface CustomFrame {\n  /**\n   * The model-view-projection matrix of a local frame at a position and altitude (metres above the ellipsoid, as the\n   * relief is drawn: times its exaggeration), column-major for `uniformMatrix4fv` or a three.js camera: x east, y\n   * north, z up, in metres. Made in double precision relative to the camera, so that what is drawn stays exact at\n   * any zoom; draw within a few kilometres of the position (or take one matrix per object far apart). Only during\n   * `render`.\n   */\n  matrixAt(lonLat: LonLat, altitude?: number): Float32Array;\n  /** The camera of the frame */\n  readonly camera: Camera;\n}\n\n/**\n * A layer drawn by the page with its own WebGL code, as MapLibre's `CustomLayerInterface`: `render` is called at the\n * layer's place in every frame drawn. It starts with the canvas bound, its viewport set, blending on (`SRC_ALPHA`,\n * `ONE_MINUS_SRC_ALPHA`), no culling, and in `'3d'` mode the depth test on (`LEQUAL`, depth written): the relief, the\n * buildings and the 3D Tiles hide what it draws and what it draws hides them. Whatever WebGL state it changes is set\n * back afterwards; a library that caches the WebGL state (three.js) must forget it first (`renderer.resetState()`).\n *\n * The map is busy drawing meanwhile: `render` reads the frame, not the map (`getCamera` excepted); it may call\n * `requestRender` for an animation.\n */\nexport interface CustomLayerInterface {\n  /** A name for the application (the map numbers its layers) */\n  id?: string;\n  /** `'2d'` (the default): drawn over what is under it; `'3d'`: with the depth buffer of the 3D layers */\n  renderingMode?: '2d' | '3d';\n  /** Creates the WebGL objects: once added, and again after the WebGL context was lost and restored */\n  onAdd?(gl: WebGL2RenderingContext, map: GeoMap): void;\n  render(gl: WebGL2RenderingContext, frame: CustomFrame): void;\n  /** Frees the WebGL objects: the layer is removed, or the map destroyed */\n  onRemove?(gl: WebGL2RenderingContext, map: GeoMap): void;\n}\n\n/** The model-view-projection of a local frame in the engine running the map (`Engine.customMatrix`) */\n/** @internal */\nexport type CustomMatrix = (lon: number, lat: number, altitude: number) => Float32Array | undefined;\n\n/** A layer drawn by the page's WebGL code (see `CustomLayerInterface`) */\nexport class CustomLayer extends Layer {\n  /** The map's WebGL context, and whether `onAdd` made the layer's objects there (until `onRemove`) */\n  private readonly gl: WebGL2RenderingContext;\n  private added = false;\n  /** The context was lost since `onAdd`: its objects are gone */\n  private stale = false;\n  private readonly lost = () => {\n    this.stale = true;\n  };\n  private readonly frame: CustomFrame;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    /** The application's object */\n    readonly implementation: CustomLayerInterface,\n    private readonly canvas: HTMLCanvasElement,\n    private readonly owner: GeoMap,\n    matrix: CustomMatrix,\n    camera: () => Camera,\n  ) {\n    super(map);\n    // The context the engine made on the canvas\n    this.gl = canvas.getContext('webgl2') as WebGL2RenderingContext;\n    this.frame = {\n      matrixAt: ([lon, lat], altitude = 0) => {\n        const m = matrix(lon, lat, altitude);\n        if (!m) throw new Error('isard: frame.matrixAt is only available during render');\n        return m;\n      },\n      get camera() {\n        return camera();\n      },\n    };\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    // Once, and again on a context restored (not when the map moves onto another engine: the same context)\n    if (!this.added || this.stale) {\n      if (!this.added) this.canvas.addEventListener('webglcontextlost', this.lost);\n      this.added = true;\n      this.stale = false;\n      this.implementation.onAdd?.(this.gl, this.owner);\n    }\n    return engine.addCustomLayer(this.draw, this.implementation.renderingMode === '3d');\n  }\n\n  /** Called by the engine at the layer's place in the frame; the page's errors are reported, the frame goes on */\n  private readonly draw = (): void => {\n    try {\n      this.implementation.render(this.gl, this.frame);\n    } catch (error) {\n      report(error);\n    }\n  };\n\n  override remove(): void {\n    super.remove();\n    this.dispose();\n  }\n\n  /** @internal The layer is removed or the map destroyed: `onRemove`, unless the context is lost */\n  override dispose(): void {\n    if (!this.added) return;\n    this.added = false;\n    this.canvas.removeEventListener('webglcontextlost', this.lost);\n    if (this.stale) return;\n    try {\n      this.implementation.onRemove?.(this.gl, this.owner);\n    } catch (error) {\n      report(error);\n    }\n  }\n}\n\n/** Where and how a model stands */\nexport interface ModelInstance {\n  lonLat: LonLat;\n  /** Metres above the ground (or above the ellipsoid, `altitudeReference: 'sea'`); 0 by default */\n  altitude?: number;\n  /** Degrees clockwise from the north of the model's front (glTF +Z); 0 by default */\n  heading?: number;\n  /** Degrees, nose up */\n  pitch?: number;\n  /** Degrees, right side down */\n  roll?: number;\n  /** 1 by default: the model's metres */\n  scale?: number;\n}\n\nexport interface ModelOptions {\n  /** URL of a glTF binary (`.glb`): meshes, textures, Draco, meshopt, KTX2, as in 3D Tiles; or its bytes (`data`) */\n  url?: string;\n  data?: ArrayBuffer | ArrayBufferView<ArrayBuffer>;\n  instances: readonly ModelInstance[];\n  /** What the altitudes are above: `'ground'` (the relief, the default) or `'sea'` (the ellipsoid) */\n  altitudeReference?: 'ground' | 'sea';\n}\n\n/** The numbers of instances for the engine: longitude, latitude, altitude, heading, pitch, roll, scale */\nexport function instanceNumbers(instances: readonly ModelInstance[]): Float64Array {\n  const out = new Float64Array(instances.length * 7);\n  instances.forEach(({ lonLat, altitude = 0, heading = 0, pitch = 0, roll = 0, scale = 1 }, i) => {\n    out.set([lonLat[0], lonLat[1], altitude, heading, pitch, roll, scale], i * 7);\n  });\n  return out;\n}\n\n/** A glTF model drawn at positions, in one instanced draw; `pickFeature` gives the instance's index */\nexport class ModelLayer extends Layer {\n  private readonly url: string;\n  /** The `blob:` URL of the page's bytes, revoked once the layer is gone */\n  private readonly blob: string | undefined;\n  private instances: Float64Array;\n  private ground: boolean;\n\n  /** @internal */\n  constructor(map: LayerHost, options: ModelOptions) {\n    super(map);\n    const { url, data } = options;\n    if (data) {\n      this.blob = URL.createObjectURL(new Blob([data], { type: 'model/gltf-binary' }));\n      this.url = this.blob;\n    } else if (url) {\n      // Against the page: the decoding workers fetch it, and a relative URL would be theirs\n      const base = typeof document === 'undefined' ? undefined : document.baseURI;\n      this.url = base ? new URL(url, base).href : url;\n    } else {\n      throw new Error('isard: a model needs a url or data');\n    }\n    this.instances = instanceNumbers(options.instances);\n    this.ground = options.altitudeReference !== 'sea';\n  }\n\n  /** @internal The engine with 3D Tiles decodes and draws the models */\n  override get needsFullEngine(): boolean {\n    return true;\n  }\n\n  /** Replaces the instances (and what their altitudes are above, kept if not given) */\n  setInstances(instances: readonly ModelInstance[], altitudeReference?: 'ground' | 'sea'): void {\n    this.instances = instanceNumbers(instances);\n    if (altitudeReference) this.ground = altitudeReference === 'ground';\n    // Kept for its creation while the engine with 3D Tiles loads\n    if (this.id < 0) return;\n    this.map.engine.setModelInstances(this.id, this.instances, this.ground);\n    this.map.requestRender();\n  }\n\n  override remove(): void {\n    super.remove();\n    this.dispose();\n  }\n\n  /** @internal */\n  override dispose(): void {\n    if (this.blob) URL.revokeObjectURL(this.blob);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    return engine.addModels(this.url, this.instances, this.ground);\n  }\n}\n"]}
+{"version":3,"file":"layers.js","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Handles of the layers added to a map. Each one keeps what it needs to be created again: after a WebGL context loss,\n * the map recreates its engine and every layer in order, with the same handle (its id is updated). Also the page's\n * own 3D content: custom layers (its WebGL code called in every frame) and glTF models drawn at positions.\n */\nimport { type Feature, parseColor, rampTexels, stops } from './features.ts';\nimport { mercatorX, mercatorY, toMercator } from './geo.ts';\nimport type { GeoMap } from './map.ts';\nimport { rgb } from './settings.ts';\nimport type {\n  LayerHost,\n  LonLat,\n  NetworkOptions,\n  NetworkStyle,\n  RasterOptions,\n  RasterStyle,\n  Tiles3dStyle,\n} from './types.ts';\nimport type { Camera, Engine, NetworkStats, Tiles3dStats } from './wasm/isard.js';\n\nexport abstract class Layer {\n  #id = -1;\n\n  /** @internal */\n  protected readonly map: LayerHost;\n\n  /** @internal */\n  constructor(map: LayerHost) {\n    this.map = map;\n  }\n\n  /** Id of the layer in the engine */\n  get id(): number {\n    return this.#id;\n  }\n\n  #ready: Promise<void> | undefined;\n\n  /** Resolves once the map has drawn the layer, what it shows in view loaded (the map idle after it was added; a\n   * layer waiting for the engine with 3D Tiles, once that one has drawn it) */\n  get ready(): Promise<void> {\n    this.#ready ??= (async () => {\n      do await this.map.whenIdle();\n      while (this.#id < 0 && this.needsFullEngine);\n    })();\n    return this.#ready;\n  }\n\n  /** @internal Creates the layer in an engine (again after a context loss); its id is -1 if that fails */\n  attach(engine: Engine): void {\n    this.#id = -1;\n    this.#id = this.create(engine);\n  }\n\n  /** @internal Forgets its id in an engine that is gone (before the layers are created in a new one) */\n  forgetEngine(): void {\n    this.#id = -1;\n  }\n\n  /** @internal Sends what refers to other layers, once every layer of a new engine has its id */\n  relink(_engine: Engine): void {}\n\n  /** @internal Drawn by the engine with 3D Tiles only (3D Tiles, models): on the core engine, it waits for that one */\n  get needsFullEngine(): boolean {\n    return false;\n  }\n\n  /** @internal The layer is removed or its map destroyed: frees what it holds outside the engine */\n  dispose(): void {}\n\n  /** @internal */\n  protected abstract create(engine: Engine): number;\n\n  remove(): void {\n    // Not created yet: a 3D Tiles layer or a model waiting for the engine with 3D Tiles\n    if (this.#id >= 0) this.map.engine.removeLayer(this.#id);\n    this.#id = -1;\n    this.map.detach(this);\n    this.map.requestRender();\n  }\n\n  /** Moves the layer under `other`, or on top of every layer (above the labels of a vector basemap too) */\n  moveBefore(other: Layer | undefined): void {\n    this.map.moveLayer(this, other);\n  }\n}\n\n/** Raster tiles (basemaps, overlays) */\nexport class RasterLayer extends Layer {\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly options: Required<Omit<RasterOptions, 'size' | 'loader' | 'grid' | 'attribution'>> & {\n      size: number | undefined;\n      loader: RasterOptions['loader'] | undefined;\n    },\n  ) {\n    super(map);\n  }\n\n  /** Changes the opacity or saturation, the other kept */\n  setStyle(style: Partial<RasterStyle>): void {\n    this.options.opacity = style.opacity ?? this.options.opacity;\n    this.options.saturation = style.saturation ?? this.options.saturation;\n    this.map.engine.setRasterStyle(this.id, this.options.opacity, this.options.saturation);\n    this.map.requestRender();\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const { url, minZoom, maxZoom, opacity, saturation, size, loader } = this.options;\n    return engine.addRaster(url, minZoom, maxZoom, opacity, saturation, size, loader);\n  }\n}\n\n/** Line network colored by a value per node (travel time, water depth…) */\nexport class NetworkLayer extends Layer {\n  private values: Float32Array | undefined;\n  /** Node and line positions in Mercator, kept for a context loss: f32 offsets from an origin (exact to the centimetre\n   * across a region, half the memory of f64) */\n  private kept: { origin: [number, number]; nodes: Float32Array; lines: Float32Array | undefined } | undefined;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private geometry: { nodes: Float64Array; edges: Uint32Array; lines: NetworkOptions['lines'] | undefined },\n    private costs: Float32Array | undefined,\n    private style: NetworkStyle,\n    private edgeWidths: Float32Array | undefined,\n  ) {\n    super(map);\n  }\n\n  /** One value per node, in node order; negative (or 1e30 and above) = unreached. Costs one texture upload, drawn\n   * next frame. */\n  setValues(values: Float32Array): void {\n    this.values = values;\n    this.map.engine.setNetworkValues(this.id, values);\n    this.map.requestRender();\n  }\n\n  /** Costs of the edges, A → B then B → A (see `NetworkOptions.costs`), when the way the network is travelled\n   * changes; undefined: values interpolated along the edges. The geometry stays on the graphics card. */\n  setCosts(costs: Float32Array | undefined): void {\n    this.costs = costs;\n    this.map.engine.setNetworkCosts(this.id, costs);\n    this.map.requestRender();\n  }\n\n  setStyle(style: Partial<NetworkStyle>): void {\n    const ramp = this.style.ramp;\n    this.style = { ...this.style, ...style };\n    this.map.engine.setNetworkStyle(this.id, networkStyle(this.style));\n    if (this.style.ramp !== ramp)\n      this.map.engine.setNetworkRamp(this.id, this.style.ramp && rampTexels(this.style.ramp).rgba);\n    this.map.requestRender();\n  }\n\n  /** Width factor of each edge (undefined: 1 for all) */\n  setEdgeWidths(widths: Float32Array | undefined): void {\n    this.edgeWidths = widths;\n    this.map.engine.setNetworkScales(this.id, widths);\n    this.map.requestRender();\n  }\n\n  /** Pieces in all and drawn in the last frame */\n  stats(): NetworkStats | undefined {\n    return this.map.engine.networkStats(this.id);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const { nodes, edges, lines } = this.geometry;\n    let mercator: { nodes: Float64Array; lines: Float64Array | undefined };\n    if (this.kept) {\n      const { origin, nodes: n, lines: l } = this.kept;\n      mercator = { nodes: unpack(n, origin), lines: l && unpack(l, origin) };\n    } else {\n      // Mercator here: Math.tan and Math.log run natively, several times faster than in WebAssembly\n      mercator = { nodes: mercatorPoints(nodes), lines: lines && mercatorPoints(lines.points) };\n      const origin: [number, number] = [mercator.nodes[0] ?? 0, mercator.nodes[1] ?? 0];\n      this.kept = {\n        origin,\n        nodes: pack(mercator.nodes, origin),\n        lines: mercator.lines && pack(mercator.lines, origin),\n      };\n      // The degrees are not needed again: millions of points for a region\n      this.geometry = { nodes: EMPTY, edges, lines: lines && { start: lines.start, points: EMPTY } };\n    }\n    const id = engine.addNetwork(\n      mercator.nodes,\n      edges,\n      lines?.start,\n      mercator.lines,\n      this.costs,\n      networkStyle(this.style),\n    );\n    if (this.style.ramp) engine.setNetworkRamp(id, rampTexels(this.style.ramp).rgba);\n    if (this.edgeWidths) engine.setNetworkScales(id, this.edgeWidths);\n    if (this.values) engine.setNetworkValues(id, this.values);\n    return id;\n  }\n}\n\n/** The 25 numbers of a network style for the engine */\nfunction networkStyle(style: NetworkStyle): Float32Array {\n  const { width, halo, max, contour, opacity, haloOpacity, unreachedColor, fade } = style;\n  return Float32Array.from([\n    ...stops(width),\n    ...stops(halo),\n    max,\n    contour,\n    opacity,\n    haloOpacity,\n    ...parseColor(unreachedColor),\n    fade,\n  ]);\n}\n\nconst EMPTY = new Float64Array(0);\n\n/** Interleaved points as f32 offsets from an origin, and back */\nfunction pack(points: Float64Array, [ox, oy]: [number, number]): Float32Array {\n  const out = new Float32Array(points.length);\n  for (let i = 0; i < points.length; i += 2) {\n    out[i] = (points[i] ?? 0) - ox;\n    out[i + 1] = (points[i + 1] ?? 0) - oy;\n  }\n  return out;\n}\n\nfunction unpack(points: Float32Array, [ox, oy]: [number, number]): Float64Array {\n  const out = new Float64Array(points.length);\n  for (let i = 0; i < points.length; i += 2) {\n    out[i] = (points[i] ?? 0) + ox;\n    out[i + 1] = (points[i + 1] ?? 0) + oy;\n  }\n  return out;\n}\n\n/** Longitudes and latitudes (degrees, interleaved) to Mercator [0, 1], y towards the south */\nfunction mercatorPoints(lonLat: Float64Array): Float64Array {\n  const out = new Float64Array(lonLat.length);\n  for (let i = 0; i < lonLat.length; i += 2) {\n    out[i] = mercatorX(lonLat[i] ?? 0);\n    out[i + 1] = mercatorY(lonLat[i + 1] ?? 0);\n  }\n  return out;\n}\n\n/** Textured meshes in 3D Tiles */\nexport class Tiles3dLayer extends Layer {\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly url: string,\n    private readonly geoid: boolean,\n    private style: Tiles3dStyle,\n  ) {\n    super(map);\n  }\n\n  setStyle(style: Partial<Tiles3dStyle>): void {\n    this.style = { ...this.style, ...style };\n    // Kept for its creation while the engine with 3D Tiles loads\n    if (this.id < 0) return;\n    this.applyStyle(this.map.engine, this.id);\n    this.map.requestRender();\n  }\n\n  /** @internal */\n  override get needsFullEngine(): boolean {\n    return true;\n  }\n\n  /** @internal The feature picked (`pickFeature`, 'hoverfeature'): the properties of its feature in the tile\n   * (`EXT_structural_metadata`, a b3dm batch table), none for a mesh without features; its index in the tile as id */\n  featureAt(index: number): Feature<Record<string, unknown>> | undefined {\n    if (this.id < 0) return undefined;\n    const hit = this.map.engine.tiles3dFeature(this.id, index);\n    if (!hit) return undefined;\n    const [properties, feature] = hit;\n    return { type: 'Feature', id: feature, properties: properties ?? {}, geometry: null };\n  }\n\n  /** Loading counters; undefined once the layer is removed, and while the engine with 3D Tiles loads (see\n   * `GeoMapOptions.tiles3d`) */\n  stats(): Tiles3dStats | undefined {\n    return this.id < 0 ? undefined : this.map.engine.tiles3dStats(this.id);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const id = engine.addTiles3d(this.url, this.style.maxScreenSpaceError, this.geoid);\n    this.applyStyle(engine, id);\n    return id;\n  }\n\n  private applyStyle(engine: Engine, id: number): void {\n    const { maxScreenSpaceError, opacity, pointSize, color } = this.style;\n    engine.setTiles3dStyle(id, maxScreenSpaceError, opacity, pointSize, new Float32Array(color ? rgb(color) : []));\n  }\n}\n\n/** A texture of a ground layer (see `GroundLayer`) */\nexport interface GroundTexture {\n  /** `r8`, `r8ui`, `r16ui`, `r16i`, `r32ui`, `r32f`, `rg16ui`, `rg32f`, `rgba8`, `rgba8ui`, `rgba16ui`, `rgba32f`:\n   * integer formats are read with `usampler2D` / `isampler2D` and `texelFetch` */\n  format: string;\n  width: number;\n  height: number;\n  /** Layers of a 2D array (`sampler2DArray`, `usampler2DArray`…); 0 or undefined: a 2D texture */\n  depth?: number;\n  /** Linear filtering (non-integer formats); default nearest */\n  linear?: boolean;\n  /** Texels row after row (layer after layer), any typed array; undefined: left empty */\n  data?: ArrayBufferView;\n}\n\nexport interface GroundOptions {\n  /**\n   * GLSL ES 3.0 defining `vec4 ground(vec2 offset)`: the color of the ground (premultiplied alpha, 0 for nothing) at\n   * `offset`, the Mercator offset of the pixel from `anchor` (times `ISARD_CIRCUMFERENCE`: metres of EPSG:3857), exact to\n   * the millimetre at any zoom. The code declares its own uniforms and samplers; also there: `u_zoom`,\n   * `u_pixel_ratio`\n   */\n  code: string;\n  /** Where the offsets are taken from */\n  anchor: LonLat;\n  /** Box it shows in, `[west, south, east, north]` (default the world): only the ground there is drawn again */\n  bounds?: [west: number, south: number, east: number, north: number];\n  textures?: Record<string, GroundTexture>;\n  uniforms?: Record<string, number | readonly number[]>;\n}\n\nconst bytesOf = (data: ArrayBufferView) => new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n\n/** The application's fragment shader run over the ground, draped on the relief (water depth, heat maps…) */\nexport class GroundLayer extends Layer {\n  private readonly textures = new Map<string, GroundTexture>();\n  private readonly uniforms = new Map<string, number[]>();\n  private visible = true;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly options: GroundOptions,\n  ) {\n    super(map);\n    for (const [name, texture] of Object.entries(options.textures ?? {})) this.textures.set(name, texture);\n    for (const [name, value] of Object.entries(options.uniforms ?? {})) this.uniforms.set(name, [value].flat());\n  }\n\n  /** Creates or replaces a texture of the code's sampler `name` */\n  setTexture(name: string, texture: GroundTexture): void {\n    this.textures.set(name, texture);\n    this.sendTexture(this.map.engine, this.id, name, texture);\n    this.map.requestRender();\n  }\n\n  /**\n   * Replaces a region of a texture: `data` holds `width` × `height` texels for (`x`, `y`) of `layer` (2D arrays).\n   * Keep the texture's own `data` up to date too if it must survive a WebGL context loss.\n   */\n  updateTexture(\n    name: string,\n    data: ArrayBufferView,\n    region: { x?: number; y?: number; layer?: number; width: number; height: number },\n  ): void {\n    const { x = 0, y = 0, layer = 0, width, height } = region;\n    this.map.engine.updateGroundTexture(this.id, name, x, y, layer, width, height, bytesOf(data));\n    this.map.requestRender();\n  }\n\n  /** A uniform of the code: a number, or numbers for vectors, arrays and matrices (column major) */\n  setUniform(name: string, value: number | readonly number[]): void {\n    const values = [value].flat();\n    this.uniforms.set(name, values);\n    this.map.engine.setGroundUniform(this.id, name, Float64Array.from(values));\n    this.map.requestRender();\n  }\n\n  setBounds(bounds: [west: number, south: number, east: number, north: number]): void {\n    this.options.bounds = bounds;\n    this.map.engine.setGroundBounds(this.id, ...mercatorBox(bounds));\n    this.map.requestRender();\n  }\n\n  setVisible(visible: boolean): void {\n    this.visible = visible;\n    this.map.engine.setGroundVisible(this.id, visible);\n    this.map.requestRender();\n  }\n\n  private sendTexture(engine: Engine, id: number, name: string, t: GroundTexture): void {\n    const data = t.data && bytesOf(t.data);\n    engine.setGroundTexture(id, name, t.format, t.width, t.height, t.depth ?? 0, t.linear ?? false, data);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const [ax, ay] = toMercator(this.options.anchor);\n    const id = engine.addGround(\n      this.options.code,\n      ax,\n      ay,\n      ...mercatorBox(this.options.bounds ?? [-180, -85.06, 180, 85.06]),\n    );\n    for (const [name, texture] of this.textures) this.sendTexture(engine, id, name, texture);\n    for (const [name, values] of this.uniforms) engine.setGroundUniform(id, name, Float64Array.from(values));\n    engine.setGroundVisible(id, this.visible);\n    return id;\n  }\n}\n\n/** A lon/lat box to Mercator min x, min y, max x, max y (y towards the south) */\nfunction mercatorBox([west, south, east, north]: [number, number, number, number]): [number, number, number, number] {\n  const [x0, y1] = toMercator([west, south]);\n  const [x1, y0] = toMercator([east, north]);\n  return [x0, y0, x1, y1];\n}\n\n// ── The page's own 3D content: custom layers, glTF models ──\n\n/** Reports an error of the page without throwing it here: the console shows it, as an uncaught one */\nfunction report(error: unknown): void {\n  if (typeof reportError === 'function') reportError(error);\n  else\n    queueMicrotask(() => {\n      throw error;\n    });\n}\n\n/** What a custom layer gets to draw a frame (`CustomLayerInterface.render`) */\nexport interface CustomFrame {\n  /**\n   * The model-view-projection matrix of a local frame at a position and altitude (metres above the ellipsoid, as the\n   * relief is drawn: times its exaggeration), column-major for `uniformMatrix4fv` or a three.js camera: x east, y\n   * north, z up, in metres. Made in double precision relative to the camera, so that what is drawn stays exact at\n   * any zoom; draw within a few kilometres of the position (or take one matrix per object far apart). Only during\n   * `render`.\n   */\n  matrixAt(lonLat: LonLat, altitude?: number): Float32Array;\n  /** The camera of the frame */\n  readonly camera: Camera;\n}\n\n/**\n * A layer drawn by the page with its own WebGL code, as MapLibre's `CustomLayerInterface`: `render` is called at the\n * layer's place in every frame drawn. It starts with the canvas bound, its viewport set, blending on (`SRC_ALPHA`,\n * `ONE_MINUS_SRC_ALPHA`), no culling, and in `'3d'` mode the depth test on (`LEQUAL`, depth written): the relief, the\n * buildings and the 3D Tiles hide what it draws and what it draws hides them. Whatever WebGL state it changes is set\n * back afterwards; a library that caches the WebGL state (three.js) must forget it first (`renderer.resetState()`).\n *\n * The map is busy drawing meanwhile: `render` reads the frame, not the map (`getCamera` excepted); it may call\n * `requestRender` for an animation.\n */\nexport interface CustomLayerInterface {\n  /** A name for the application (the map numbers its layers) */\n  id?: string;\n  /** `'2d'` (the default): drawn over what is under it; `'3d'`: with the depth buffer of the 3D layers */\n  renderingMode?: '2d' | '3d';\n  /** Creates the WebGL objects: once added, and again after the WebGL context was lost and restored */\n  onAdd?(gl: WebGL2RenderingContext, map: GeoMap): void;\n  render(gl: WebGL2RenderingContext, frame: CustomFrame): void;\n  /** Frees the WebGL objects: the layer is removed, or the map destroyed */\n  onRemove?(gl: WebGL2RenderingContext, map: GeoMap): void;\n}\n\n/** The model-view-projection of a local frame in the engine running the map (`Engine.customMatrix`) */\n/** @internal */\nexport type CustomMatrix = (lon: number, lat: number, altitude: number) => Float32Array | undefined;\n\n/** A layer drawn by the page's WebGL code (see `CustomLayerInterface`) */\nexport class CustomLayer extends Layer {\n  /** The map's WebGL context, and whether `onAdd` made the layer's objects there (until `onRemove`) */\n  private readonly gl: WebGL2RenderingContext;\n  private added = false;\n  /** The context was lost since `onAdd`: its objects are gone */\n  private stale = false;\n  private readonly lost = () => {\n    this.stale = true;\n  };\n  private readonly frame: CustomFrame;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    /** The application's object */\n    readonly implementation: CustomLayerInterface,\n    private readonly canvas: HTMLCanvasElement,\n    private readonly owner: GeoMap,\n    matrix: CustomMatrix,\n    camera: () => Camera,\n  ) {\n    super(map);\n    // The context the engine made on the canvas\n    this.gl = canvas.getContext('webgl2') as WebGL2RenderingContext;\n    this.frame = {\n      matrixAt: ([lon, lat], altitude = 0) => {\n        const m = matrix(lon, lat, altitude);\n        if (!m) throw new Error('isard: frame.matrixAt is only available during render');\n        return m;\n      },\n      get camera() {\n        return camera();\n      },\n    };\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    // Once, and again on a context restored (not when the map moves onto another engine: the same context)\n    if (!this.added || this.stale) {\n      if (!this.added) this.canvas.addEventListener('webglcontextlost', this.lost);\n      this.added = true;\n      this.stale = false;\n      this.implementation.onAdd?.(this.gl, this.owner);\n    }\n    return engine.addCustomLayer(this.draw, this.implementation.renderingMode === '3d');\n  }\n\n  /** Called by the engine at the layer's place in the frame; the page's errors are reported, the frame goes on */\n  private readonly draw = (): void => {\n    try {\n      this.implementation.render(this.gl, this.frame);\n    } catch (error) {\n      report(error);\n    }\n  };\n\n  override remove(): void {\n    super.remove();\n    this.dispose();\n  }\n\n  /** @internal The layer is removed or the map destroyed: `onRemove`, unless the context is lost */\n  override dispose(): void {\n    if (!this.added) return;\n    this.added = false;\n    this.canvas.removeEventListener('webglcontextlost', this.lost);\n    if (this.stale) return;\n    try {\n      this.implementation.onRemove?.(this.gl, this.owner);\n    } catch (error) {\n      report(error);\n    }\n  }\n}\n\n/** Where and how a model stands */\nexport interface ModelInstance {\n  lonLat: LonLat;\n  /** Metres above the ground (or above the ellipsoid, `altitudeReference: 'sea'`); 0 by default */\n  altitude?: number;\n  /** Degrees clockwise from the north of the model's front (glTF +Z); 0 by default */\n  heading?: number;\n  /** Degrees, nose up */\n  pitch?: number;\n  /** Degrees, right side down */\n  roll?: number;\n  /** 1 by default: the model's metres */\n  scale?: number;\n}\n\nexport interface ModelOptions {\n  /** URL of a glTF binary (`.glb`): meshes, textures, Draco, meshopt, KTX2, as in 3D Tiles; or its bytes (`data`) */\n  url?: string;\n  data?: ArrayBuffer | ArrayBufferView<ArrayBuffer>;\n  instances: readonly ModelInstance[];\n  /** What the altitudes are above: `'ground'` (the relief, the default) or `'sea'` (the ellipsoid) */\n  altitudeReference?: 'ground' | 'sea';\n}\n\n/** The numbers of instances for the engine: longitude, latitude, altitude, heading, pitch, roll, scale */\nexport function instanceNumbers(instances: readonly ModelInstance[]): Float64Array {\n  const out = new Float64Array(instances.length * 7);\n  instances.forEach(({ lonLat, altitude = 0, heading = 0, pitch = 0, roll = 0, scale = 1 }, i) => {\n    out.set([lonLat[0], lonLat[1], altitude, heading, pitch, roll, scale], i * 7);\n  });\n  return out;\n}\n\n/** A glTF model drawn at positions, in one instanced draw; `pickFeature` gives the instance's index */\nexport class ModelLayer extends Layer {\n  private readonly url: string;\n  /** The `blob:` URL of the page's bytes, revoked once the layer is gone */\n  private readonly blob: string | undefined;\n  private instances: Float64Array;\n  private ground: boolean;\n\n  /** @internal */\n  constructor(map: LayerHost, options: ModelOptions) {\n    super(map);\n    const { url, data } = options;\n    if (data) {\n      this.blob = URL.createObjectURL(new Blob([data], { type: 'model/gltf-binary' }));\n      this.url = this.blob;\n    } else if (url) {\n      // Against the page: the decoding workers fetch it, and a relative URL would be theirs\n      const base = typeof document === 'undefined' ? undefined : document.baseURI;\n      this.url = base ? new URL(url, base).href : url;\n    } else {\n      throw new Error('isard: a model needs a url or data');\n    }\n    this.instances = instanceNumbers(options.instances);\n    this.ground = options.altitudeReference !== 'sea';\n  }\n\n  /** @internal The engine with 3D Tiles decodes and draws the models */\n  override get needsFullEngine(): boolean {\n    return true;\n  }\n\n  /** Replaces the instances (and what their altitudes are above, kept if not given) */\n  setInstances(instances: readonly ModelInstance[], altitudeReference?: 'ground' | 'sea'): void {\n    this.instances = instanceNumbers(instances);\n    if (altitudeReference) this.ground = altitudeReference === 'ground';\n    // Kept for its creation while the engine with 3D Tiles loads\n    if (this.id < 0) return;\n    this.map.engine.setModelInstances(this.id, this.instances, this.ground);\n    this.map.requestRender();\n  }\n\n  override remove(): void {\n    super.remove();\n    this.dispose();\n  }\n\n  /** @internal */\n  override dispose(): void {\n    if (this.blob) URL.revokeObjectURL(this.blob);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    return engine.addModels(this.url, this.instances, this.ground);\n  }\n}\n"]}

package/dist/loader.d.ts

@@ -18,6 +18,8 @@ export declare class TileLoader implements TileLoaderLike {
     private readonly pending;
     /** Every worker failed: why */
     private failed;
+    /** The page's request headers, sent to the workers as they change */
+    private readonly unfollow;
     constructor(module: WebAssembly.Module, workerUrl: string | URL, size: number, decoders: DecoderUrls, formats: TextureFormats, 
     /** URL of the point cloud module, for the workers */
     points?: string);

package/dist/loader.js

@@ -1,3 +1,4 @@
+import { headerRules, onHeaderRules } from "./requests.js";
 export class TileLoader {
     module;
     workerUrl;
@@ -11,6 +12,11 @@ export class TileLoader {
     pending = new Map();
     /** Every worker failed: why */
     failed;
+    /** The page's request headers, sent to the workers as they change */
+    unfollow = onHeaderRules((rules) => {
+        for (const worker of this.workers)
+            this.send(worker, { type: 'headers', rules });
+    });
     constructor(module, workerUrl, size, decoders, formats, 
     /** URL of the point cloud module, for the workers */
     points = '') {
@@ -50,6 +56,7 @@ export class TileLoader {
             this.send(pending.worker, { type: 'abort', id });
     }
     destroy() {
+        this.unfollow();
         for (const worker of this.workers)
             worker.terminate();
         this.workers = [];
@@ -72,6 +79,9 @@ export class TileLoader {
                 worker.onmessageerror = () => this.fail(worker, `the decoding worker ${this.workerUrl} sent an unreadable message`);
                 const { module, decoders, formats, points } = this;
                 this.send(worker, { type: 'init', module, decoders, formats, points });
+                const rules = headerRules();
+                if (rules.length > 0)
+                    this.send(worker, { type: 'headers', rules });
                 this.workers.push(worker);
                 this.busy.set(worker, 0);
             }

package/dist/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,UAAU;IASF;IACA;IACA;IACA;IACA;IAEA;IAdX,OAAO,GAAa,EAAE,CAAC;IAC/B,oCAAoC;IACnB,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjC,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtD,+BAA+B;IACvB,MAAM,CAAoB;IAElC,YACmB,MAA0B,EAC1B,SAAuB,EACvB,IAAY,EACZ,QAAqB,EACrB,OAAuB;IACxC,qDAAqD;IACpC,SAAiB,EAAE;QANnB,WAAM,GAAN,MAAM,CAAoB;QAC1B,cAAS,GAAT,SAAS,CAAc;QACvB,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAa;QACrB,YAAO,GAAP,OAAO,CAAgB;QAEvB,WAAM,GAAN,MAAM,CAAa;IACnC,CAAC;IAEJ,2FAA2F;IAC3F,IAAI,CACF,EAAU,EACV,GAAW,EACX,SAAuB,EACvB,GAAY,EACZ,MAAe,EACf,QAAyB;QAEzB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAA6B,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACjF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1G,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iHAAiH;IACjH,UAAU,CACR,EAAU,EACV,GAAW,EACX,MAAc,EACd,IAAY,EACZ,GAAe,EACf,MAAoB,EACpB,IAAkB,EAClB,KAAa,EACb,QAAyB;QAEzB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAA6B,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACjF,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAW,CAAC;YAC7F,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,EAAU;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO;QACL,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,8EAA8E;IACtE,SAAS;QACf,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC9D,MAAM,CAAC,SAAS,GAAG,CAAC,KAAgC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1F,4GAA4G;gBAC5G,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;oBACzB,KAAK,CAAC,cAAc,EAAE,CAAC;oBACvB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,uBAAuB,IAAI,CAAC,SAAS,UAAU,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChH,CAAC,CAAC;gBACF,MAAM,CAAC,cAAc,GAAG,GAAG,EAAE,CAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,uBAAuB,IAAI,CAAC,SAAS,6BAA6B,CAAC,CAAC;gBACxF,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;gBACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAW,CAAC;QACrC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAAE,IAAI,GAAG,MAAM,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,IAAI,CAAC,MAAc,EAAE,OAAsB;QACjD,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAEO,OAAO,CAAC,MAAc,EAAE,KAAkB;QAChD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aAClD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;aAC7D,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,KAAK,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;;YAC9F,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,8CAA8C;IACtC,IAAI,CAAC,MAAc,EAAE,OAAe;QAC1C,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,UAAU,OAAO,+GAA+G,CACjI,CAAC;QACF,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;gBAAE,SAAS;YACxC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,qEAAqE;QACrE,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACrD,CAAC;CACF","sourcesContent":["/**\n * Pool of decoding workers for 3D Tiles content and point clouds. The engine calls `load`, `loadPoints` and `abort`\n * (`TileLoaderLike`); the main thread then only uploads the decoded arrays to the GPU.\n */\nimport type { DecoderUrls } from './decoders.ts';\nimport type { WorkerReply, WorkerRequest } from './protocol.ts';\nimport type { DecodedTile, TextureFormats, TileLoaderLike } from './wasm/isard.js';\n\ninterface Pending {\n  resolve: (result: DecodedTile | Uint8Array<ArrayBuffer>) => void;\n  reject: (error: Error) => void;\n  worker: Worker;\n}\n\nexport class TileLoader implements TileLoaderLike {\n  private workers: Worker[] = [];\n  /** Requests in flight per worker */\n  private readonly busy = new Map<Worker, number>();\n  private readonly pending = new Map<number, Pending>();\n  /** Every worker failed: why */\n  private failed: Error | undefined;\n\n  constructor(\n    private readonly module: WebAssembly.Module,\n    private readonly workerUrl: string | URL,\n    private readonly size: number,\n    private readonly decoders: DecoderUrls,\n    private readonly formats: TextureFormats,\n    /** URL of the point cloud module, for the workers */\n    private readonly points: string = '',\n  ) {}\n\n  /** Called by the engine: fetch and decode off the main thread, on the least busy worker */\n  load(\n    id: number,\n    url: string,\n    transform: Float64Array,\n    yUp: boolean,\n    reload: boolean,\n    priority?: 'high' | 'low',\n  ): Promise<DecodedTile> {\n    if (this.failed) return Promise.reject(this.failed);\n    const worker = this.leastBusy();\n    this.busy.set(worker, (this.busy.get(worker) ?? 0) + 1);\n    return new Promise((resolve, reject) => {\n      this.pending.set(id, { resolve: resolve as Pending['resolve'], reject, worker });\n      this.send(worker, { type: 'load', id, url, transform, yUp, reload, ...(priority ? { priority } : {}) });\n    });\n  }\n\n  /** Called by the engine: the points of a COPC node, fetched (a range request) and decoded off the main thread */\n  loadPoints(\n    id: number,\n    url: string,\n    offset: number,\n    size: number,\n    laz: Uint8Array,\n    layout: Float64Array,\n    grid: Float64Array,\n    count: number,\n    priority?: 'high' | 'low',\n  ): Promise<Uint8Array<ArrayBuffer>> {\n    if (this.failed) return Promise.reject(this.failed);\n    const worker = this.leastBusy();\n    this.busy.set(worker, (this.busy.get(worker) ?? 0) + 1);\n    return new Promise((resolve, reject) => {\n      this.pending.set(id, { resolve: resolve as Pending['resolve'], reject, worker });\n      const message = { type: 'points', id, url, offset, size, laz, layout, grid, count } as const;\n      this.send(worker, { ...message, ...(priority ? { priority } : {}) });\n    });\n  }\n\n  abort(id: number): void {\n    const pending = this.pending.get(id);\n    if (pending) this.send(pending.worker, { type: 'abort', id });\n  }\n\n  destroy(): void {\n    for (const worker of this.workers) worker.terminate();\n    this.workers = [];\n    this.busy.clear();\n    for (const { reject } of this.pending.values()) reject(new Error('loader destroyed'));\n    this.pending.clear();\n  }\n\n  /** Workers start with the first tile: a map without 3D Tiles costs nothing */\n  private leastBusy(): Worker {\n    if (this.workers.length === 0) {\n      for (let i = 0; i < this.size; i++) {\n        const worker = new Worker(this.workerUrl, { type: 'module' });\n        worker.onmessage = (event: MessageEvent<WorkerReply>) => this.receive(worker, event.data);\n        // A worker that fails to load (a bundler serving it from elsewhere) or to read a message fails its requests\n        worker.onerror = (event) => {\n          event.preventDefault();\n          this.fail(worker, `the decoding worker ${this.workerUrl} failed${event.message ? `: ${event.message}` : ''}`);\n        };\n        worker.onmessageerror = () =>\n          this.fail(worker, `the decoding worker ${this.workerUrl} sent an unreadable message`);\n        const { module, decoders, formats, points } = this;\n        this.send(worker, { type: 'init', module, decoders, formats, points });\n        this.workers.push(worker);\n        this.busy.set(worker, 0);\n      }\n    }\n    let best = this.workers[0] as Worker;\n    for (const worker of this.workers) {\n      if ((this.busy.get(worker) ?? 0) < (this.busy.get(best) ?? 0)) best = worker;\n    }\n    return best;\n  }\n\n  private send(worker: Worker, message: WorkerRequest): void {\n    worker.postMessage(message);\n  }\n\n  private receive(worker: Worker, reply: WorkerReply): void {\n    this.busy.set(worker, Math.max(0, (this.busy.get(worker) ?? 1) - 1));\n    const pending = this.pending.get(reply.id);\n    if (!pending) return;\n    this.pending.delete(reply.id);\n    if (reply.type === 'tile') pending.resolve(reply.tile);\n    else if (reply.type === 'points') pending.resolve(reply.vertices);\n    else if (reply.aborted) pending.reject(new DOMException(`tile ${reply.id} aborted`, 'AbortError'));\n    else pending.reject(new Error(reply.error));\n  }\n\n  /** Rejects the requests of a failed worker */\n  private fail(worker: Worker, message: string): void {\n    const error = new Error(\n      `isard: ${message}. If a bundler moves the worker, give its URL in the \\`workerUrl\\` option (see \"With a bundler\" in the guide)`,\n    );\n    for (const [id, pending] of this.pending) {\n      if (pending.worker !== worker) continue;\n      this.pending.delete(id);\n      pending.reject(error);\n    }\n    // Out of the pool: when none is left, the next requests fail at once\n    worker.terminate();\n    this.workers = this.workers.filter((w) => w !== worker);\n    this.busy.delete(worker);\n    if (this.workers.length === 0) this.failed = error;\n  }\n}\n"]}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAS3D,MAAM,OAAO,UAAU;IAaF;IACA;IACA;IACA;IACA;IAEA;IAlBX,OAAO,GAAa,EAAE,CAAC;IAC/B,oCAAoC;IACnB,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjC,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtD,+BAA+B;IACvB,MAAM,CAAoB;IAClC,qEAAqE;IACpD,QAAQ,GAAG,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE;QAClD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,YACmB,MAA0B,EAC1B,SAAuB,EACvB,IAAY,EACZ,QAAqB,EACrB,OAAuB;IACxC,qDAAqD;IACpC,SAAiB,EAAE;QANnB,WAAM,GAAN,MAAM,CAAoB;QAC1B,cAAS,GAAT,SAAS,CAAc;QACvB,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAa;QACrB,YAAO,GAAP,OAAO,CAAgB;QAEvB,WAAM,GAAN,MAAM,CAAa;IACnC,CAAC;IAEJ,2FAA2F;IAC3F,IAAI,CACF,EAAU,EACV,GAAW,EACX,SAAuB,EACvB,GAAY,EACZ,MAAe,EACf,QAAyB;QAEzB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAA6B,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACjF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1G,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iHAAiH;IACjH,UAAU,CACR,EAAU,EACV,GAAW,EACX,MAAc,EACd,IAAY,EACZ,GAAe,EACf,MAAoB,EACpB,IAAkB,EAClB,KAAa,EACb,QAAyB;QAEzB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAA6B,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACjF,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAW,CAAC;YAC7F,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,EAAU;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO;QACL,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,8EAA8E;IACtE,SAAS;QACf,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC9D,MAAM,CAAC,SAAS,GAAG,CAAC,KAAgC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1F,4GAA4G;gBAC5G,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;oBACzB,KAAK,CAAC,cAAc,EAAE,CAAC;oBACvB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,uBAAuB,IAAI,CAAC,SAAS,UAAU,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChH,CAAC,CAAC;gBACF,MAAM,CAAC,cAAc,GAAG,GAAG,EAAE,CAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,uBAAuB,IAAI,CAAC,SAAS,6BAA6B,CAAC,CAAC;gBACxF,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;gBACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvE,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;gBACpE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAW,CAAC;QACrC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAAE,IAAI,GAAG,MAAM,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,IAAI,CAAC,MAAc,EAAE,OAAsB;QACjD,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAEO,OAAO,CAAC,MAAc,EAAE,KAAkB;QAChD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aAClD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;aAC7D,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,KAAK,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;;YAC9F,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,8CAA8C;IACtC,IAAI,CAAC,MAAc,EAAE,OAAe;QAC1C,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,UAAU,OAAO,+GAA+G,CACjI,CAAC;QACF,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;gBAAE,SAAS;YACxC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,qEAAqE;QACrE,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACrD,CAAC;CACF","sourcesContent":["/**\n * Pool of decoding workers for 3D Tiles content and point clouds. The engine calls `load`, `loadPoints` and `abort`\n * (`TileLoaderLike`); the main thread then only uploads the decoded arrays to the GPU.\n */\nimport type { DecoderUrls } from './decoders.ts';\nimport type { WorkerReply, WorkerRequest } from './protocol.ts';\nimport { headerRules, onHeaderRules } from './requests.ts';\nimport type { DecodedTile, TextureFormats, TileLoaderLike } from './wasm/isard.js';\n\ninterface Pending {\n  resolve: (result: DecodedTile | Uint8Array<ArrayBuffer>) => void;\n  reject: (error: Error) => void;\n  worker: Worker;\n}\n\nexport class TileLoader implements TileLoaderLike {\n  private workers: Worker[] = [];\n  /** Requests in flight per worker */\n  private readonly busy = new Map<Worker, number>();\n  private readonly pending = new Map<number, Pending>();\n  /** Every worker failed: why */\n  private failed: Error | undefined;\n  /** The page's request headers, sent to the workers as they change */\n  private readonly unfollow = onHeaderRules((rules) => {\n    for (const worker of this.workers) this.send(worker, { type: 'headers', rules });\n  });\n\n  constructor(\n    private readonly module: WebAssembly.Module,\n    private readonly workerUrl: string | URL,\n    private readonly size: number,\n    private readonly decoders: DecoderUrls,\n    private readonly formats: TextureFormats,\n    /** URL of the point cloud module, for the workers */\n    private readonly points: string = '',\n  ) {}\n\n  /** Called by the engine: fetch and decode off the main thread, on the least busy worker */\n  load(\n    id: number,\n    url: string,\n    transform: Float64Array,\n    yUp: boolean,\n    reload: boolean,\n    priority?: 'high' | 'low',\n  ): Promise<DecodedTile> {\n    if (this.failed) return Promise.reject(this.failed);\n    const worker = this.leastBusy();\n    this.busy.set(worker, (this.busy.get(worker) ?? 0) + 1);\n    return new Promise((resolve, reject) => {\n      this.pending.set(id, { resolve: resolve as Pending['resolve'], reject, worker });\n      this.send(worker, { type: 'load', id, url, transform, yUp, reload, ...(priority ? { priority } : {}) });\n    });\n  }\n\n  /** Called by the engine: the points of a COPC node, fetched (a range request) and decoded off the main thread */\n  loadPoints(\n    id: number,\n    url: string,\n    offset: number,\n    size: number,\n    laz: Uint8Array,\n    layout: Float64Array,\n    grid: Float64Array,\n    count: number,\n    priority?: 'high' | 'low',\n  ): Promise<Uint8Array<ArrayBuffer>> {\n    if (this.failed) return Promise.reject(this.failed);\n    const worker = this.leastBusy();\n    this.busy.set(worker, (this.busy.get(worker) ?? 0) + 1);\n    return new Promise((resolve, reject) => {\n      this.pending.set(id, { resolve: resolve as Pending['resolve'], reject, worker });\n      const message = { type: 'points', id, url, offset, size, laz, layout, grid, count } as const;\n      this.send(worker, { ...message, ...(priority ? { priority } : {}) });\n    });\n  }\n\n  abort(id: number): void {\n    const pending = this.pending.get(id);\n    if (pending) this.send(pending.worker, { type: 'abort', id });\n  }\n\n  destroy(): void {\n    this.unfollow();\n    for (const worker of this.workers) worker.terminate();\n    this.workers = [];\n    this.busy.clear();\n    for (const { reject } of this.pending.values()) reject(new Error('loader destroyed'));\n    this.pending.clear();\n  }\n\n  /** Workers start with the first tile: a map without 3D Tiles costs nothing */\n  private leastBusy(): Worker {\n    if (this.workers.length === 0) {\n      for (let i = 0; i < this.size; i++) {\n        const worker = new Worker(this.workerUrl, { type: 'module' });\n        worker.onmessage = (event: MessageEvent<WorkerReply>) => this.receive(worker, event.data);\n        // A worker that fails to load (a bundler serving it from elsewhere) or to read a message fails its requests\n        worker.onerror = (event) => {\n          event.preventDefault();\n          this.fail(worker, `the decoding worker ${this.workerUrl} failed${event.message ? `: ${event.message}` : ''}`);\n        };\n        worker.onmessageerror = () =>\n          this.fail(worker, `the decoding worker ${this.workerUrl} sent an unreadable message`);\n        const { module, decoders, formats, points } = this;\n        this.send(worker, { type: 'init', module, decoders, formats, points });\n        const rules = headerRules();\n        if (rules.length > 0) this.send(worker, { type: 'headers', rules });\n        this.workers.push(worker);\n        this.busy.set(worker, 0);\n      }\n    }\n    let best = this.workers[0] as Worker;\n    for (const worker of this.workers) {\n      if ((this.busy.get(worker) ?? 0) < (this.busy.get(best) ?? 0)) best = worker;\n    }\n    return best;\n  }\n\n  private send(worker: Worker, message: WorkerRequest): void {\n    worker.postMessage(message);\n  }\n\n  private receive(worker: Worker, reply: WorkerReply): void {\n    this.busy.set(worker, Math.max(0, (this.busy.get(worker) ?? 1) - 1));\n    const pending = this.pending.get(reply.id);\n    if (!pending) return;\n    this.pending.delete(reply.id);\n    if (reply.type === 'tile') pending.resolve(reply.tile);\n    else if (reply.type === 'points') pending.resolve(reply.vertices);\n    else if (reply.aborted) pending.reject(new DOMException(`tile ${reply.id} aborted`, 'AbortError'));\n    else pending.reject(new Error(reply.error));\n  }\n\n  /** Rejects the requests of a failed worker */\n  private fail(worker: Worker, message: string): void {\n    const error = new Error(\n      `isard: ${message}. If a bundler moves the worker, give its URL in the \\`workerUrl\\` option (see \"With a bundler\" in the guide)`,\n    );\n    for (const [id, pending] of this.pending) {\n      if (pending.worker !== worker) continue;\n      this.pending.delete(id);\n      pending.reject(error);\n    }\n    // Out of the pool: when none is left, the next requests fail at once\n    worker.terminate();\n    this.workers = this.workers.filter((w) => w !== worker);\n    this.busy.delete(worker);\n    if (this.workers.length === 0) this.failed = error;\n  }\n}\n"]}

package/dist/map.d.ts

@@ -3,9 +3,10 @@ import { ExtrusionLayer, type ExtrusionOptions } from './extrusions.ts';
 import { CircleLayer, type CircleOptions, FillLayer, type FillOptions, LineLayer, type LineOptions } from './features.ts';
 import { type ImageOptions, type Pixels } from './icons.ts';
 import { CustomLayer, type CustomLayerInterface, GroundLayer, type GroundOptions, type Layer, ModelLayer, type ModelOptions, NetworkLayer, RasterLayer, Tiles3dLayer } from './layers.ts';
+import { type PanoramaOptions, type Panoramas } from './panoramas.ts';
 import { PointCloudLayer, type PointCloudOptions } from './pointclouds.ts';
 import { SymbolLayer, type SymbolOptions } from './symbols.ts';
-import type { AnimationOptions, AtmosphereOptions, Basemap, FeatureHit, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, NetworkOptions, Point, Projection, RasterOptions, TerrainModel, TerrainOptions, Tiles3dOptions, ViewshedOptions } from './types.ts';
+import type { AnimationOptions, AtmosphereOptions, Basemap, FeatureHit, FirstPersonView, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, NetworkOptions, Point, Projection, RasterOptions, SwipeOptions, TerrainModel, TerrainOptions, Tiles3dOptions, ViewshedOptions } from './types.ts';
 import { type PmtilesOptions, VectorTiles, type VectorTilesOptions } from './vectortiles.ts';
 import type { Camera, PickHit, RasterLayerStats } from './wasm/isard.js';
 /** A map (see `GeoMap.create`); layers take it as their host */
@@ -82,13 +83,15 @@ export declare class GeoMap {
     private basemapPool;
     /** Stops watching the device pixel ratio */
     private unwatchRatio;
+    /** Stops following the page's request headers (`setRequestHeaders`) */
+    private unwatchHeaders;
     /** Stops listening to the canvas's context loss and restoration */
     private readonly unwatchContext;
     /** The loaders of the relief by encoding, URL and floor: the same loader for the same tiles (the engine keeps its
      * tiles when only the exaggeration changes) */
     private readonly terrainLoaders;
     /** Loads the engine (once per page) and creates a map filling `container` */
-    static create(container: HTMLElement, options?: GeoMapOptions): Promise<GeoMap>;
+    static create(container: HTMLElement, given?: GeoMapOptions): Promise<GeoMap>;
     private constructor();
     /** The element the map was created in */
     getContainer(): HTMLElement;
@@ -104,15 +107,69 @@ export declare class GeoMap {
     private preloadTiles3d;
     /** After a context loss: a new engine with the same camera, settings and layers (same handles, same order) */
     private restore;
+    /** The street-level eye, if the camera is one */
+    get firstPerson(): Readonly<Required<FirstPersonView>> | undefined;
+    /**
+     * Puts the camera at street level: an eye `height` metres above the ground, looking `bearing` and `pitch`, the
+     * drag turning it around (the wheel narrows or widens its field of view); undefined gives back the camera turning
+     * around a point, above where the eye stood, facing the same way
+     */
+    setFirstPerson(view: FirstPersonView | undefined): void;
+    /** The swipe set (`setSwipe`), applied again with the layers' ids of a new engine */
+    private swipe;
+    /**
+     * Compares two states of a place: `layers` shown on one side of a vertical line only, at `position` CSS pixels
+     * from the left of the map (left of it by default, `side: 'right'` for the other), the layers beneath them on the
+     * other side. Set again as the line moves (a slider, a drag); undefined stops
+     */
+    setSwipe(options: SwipeOptions | undefined): void;
+    private applySwipe;
     /** Takes a layer out of the drawing order (to put it back elsewhere, or for good) */
     private unlist;
-    private add;
+    private addLayer;
     /** Index in the engine of the layer at `index`: the layers waiting for the engine with 3D Tiles are not in it yet */
     private engineIndex;
     /** Moves a layer under all the others */
     private toBottom;
     /** Listens to an event; returns the function that stops listening */
     on<K extends keyof MapEvents>(type: K, listener: (event: MapEvents[K]) => void): () => void;
+    /**
+     * The camera's methods together: `get`, `set`, `easeTo`, `flyTo`, `bounds`, `firstPerson` and `setFirstPerson`
+     * (street level), `project`, `unproject`; the same as the map's own (`getCamera`, `setCamera`…)
+     */
+    readonly camera: {
+        readonly get: () => Camera;
+        readonly set: (camera: Partial<Camera>) => void;
+        readonly easeTo: (camera: Partial<Camera>, options?: number | AnimationOptions) => void;
+        readonly flyTo: (camera: Partial<Camera>, options?: FlyToOptions) => void;
+        readonly bounds: () => [west: number, south: number, east: number, north: number];
+        readonly firstPerson: () => Readonly<Required<FirstPersonView>> | undefined;
+        readonly setFirstPerson: (view: FirstPersonView | undefined) => void;
+        readonly project: (lonLat: LonLat, height?: number) => Point | undefined;
+        readonly unproject: (point: Point) => LonLat | undefined;
+    };
+    /**
+     * What lies under a point or at a position, together: `feature` (`pickFeature`), `surface` (`pickSurface`),
+     * `surfaceAt`, `elevationAt`, `metersPerPixel`
+     */
+    readonly query: {
+        readonly feature: (point: Point, options?: {
+            radius?: number;
+            layers?: readonly Layer[];
+        }) => FeatureHit | undefined;
+        readonly surface: (point: Point) => {
+            lonLat: LonLat;
+            height: number;
+        } | undefined;
+        readonly surfaceAt: (lonLat: LonLat) => number | undefined;
+        readonly elevationAt: (lonLat: LonLat) => number | undefined;
+        readonly metersPerPixel: (point?: Point) => number | undefined;
+    };
+    /** What is drawn over the scene, together: `viewshed` (`setViewshed`), `swipe` (`setSwipe`) */
+    readonly effects: {
+        readonly viewshed: (options: ViewshedOptions | readonly ViewshedOptions[] | undefined) => void;
+        readonly swipe: (options: SwipeOptions | undefined) => void;
+    };
     getCamera(): Camera;
     setCamera(camera: Partial<Camera>): void;
     /** Animated move to a camera: over `duration` milliseconds (or the options), ease-out by default */
@@ -140,6 +197,8 @@ export declare class GeoMap {
      * (`direction`): the relief, extrusions, 3D Tiles and models hide what lies behind them (only what the map has
      * loaded for its view). Several observers (16 at most): what any of them sees is seen, what is hidden from all those
      * that reach it is hidden, in the colors and opacity of the first. Undefined or none removes it */
+    /** The viewshed set, set again in a new engine */
+    private viewshed;
     setViewshed(options: ViewshedOptions | readonly ViewshedOptions[] | undefined): void;
     /** Relief under the basemap: true for the body's terrain model (on the Earth the worldwide Terrain Tiles, NASA's
      * on the Moon and Mars), one of the Earth's models by name (`'ign'`), its options, or false; on another body, its
@@ -176,6 +235,21 @@ export declare class GeoMap {
     project(lonLat: LonLat, height?: number): Point | undefined;
     /** Position under a screen point (CSS pixels), undefined above the horizon */
     unproject(point: Point): LonLat | undefined;
+    /**
+     * Street-level panoramas (oriented images of a vehicle's cameras, the iTowns immersive format): their positions
+     * and calibrations loaded, none shown until `show`, which projects one onto the scene around it
+     */
+    addPanoramas(options: PanoramaOptions): Promise<Panoramas>;
+    /** The panorama sets, their panorama shown again in a new engine */
+    private readonly panoramaSets;
+    /** Altitude of the relief at a position, in metres (exaggeration included): from the copy of its tiles the map
+     * keeps, as fine as the tiles loaded there; undefined without relief or where none is loaded yet */
+    elevationAt(lonLat: LonLat): number | undefined;
+    /** Metres on the ground per CSS pixel at a screen point (default the center of the map), across the screen: for a
+     * scale bar; undefined above the horizon */
+    metersPerPixel(point?: Point): number | undefined;
+    /** Whether a double click zooms in (Shift: out), on by default: off while a drawing takes double clicks */
+    setDoubleClickZoom(enabled: boolean): void;
     /** What is drawn under a screen point (CSS pixels), on the relief or standing on it (a roof, a wall, a mesh): its
      * position and its height above the relief, in metres; undefined where nothing was drawn. The last frame's scene is
      * drawn again and read back, waiting for the GPU (a stall): for clicks and drags */
@@ -191,7 +265,7 @@ export declare class GeoMap {
     addControl(control: Control, position?: ControlPosition): this;
     removeControl(control: Control): this;
     /** Replaces the basemap and the IGN hillshade, under the other layers (hillshade by default: 0, none). The former
-     * names of the Géoplateforme basemaps (`LegacyBasemap`) are taken under their new ones */
+     * names of the Géoplateforme basemaps throw, naming the new ones */
     setBasemap(basemap: Basemap, hillshade?: number): void;
     /** Raster tiles ({z}, {x}, {y} URL; Web Mercator, or reprojected from another `grid`: longitudes and latitudes,
      * Lambert-93, UTM…), over the layers already added */
@@ -207,6 +281,12 @@ export declare class GeoMap {
     addPmtiles(url: string, options?: PmtilesOptions): Promise<RasterLayer | VectorTiles>;
     /** Line network colored by a value per node; `layer.setValues` recolors it in one texture upload */
     addNetwork(options: NetworkOptions): NetworkLayer;
+    /**
+     * A layer from its description, as an application's configuration gives it: `{ type, ...options }`, the options of
+     * the `add…` method of that type (`'lines'` for `addLines`, `'tiles3d'` for `addTiles3d`…); `before` to go under
+     * another layer. The layer's `ready` resolves once the map has drawn it
+     */
+    add<P = Record<string, unknown>>(spec: LayerSpec<P>): Layer;
     /** Lines from GeoJSON (line strings, and polygon outlines), styled per feature */
     addLines<P = Record<string, unknown>>(options: LineOptions<P>): LineLayer<P>;
     /** Discs from GeoJSON points, styled per feature */
@@ -279,3 +359,35 @@ export declare class GeoMap {
     private resize;
     destroy(): void;
 }
+/** A layer by its type and the options of its `add…` method (`GeoMap.add`) */
+export type LayerSpec<P = Record<string, unknown>> = ({
+    type: 'lines';
+} & LineOptions<P>) | ({
+    type: 'circles';
+} & CircleOptions<P>) | ({
+    type: 'fills';
+} & FillOptions<P>) | ({
+    type: 'symbols';
+} & SymbolOptions<P>) | ({
+    type: 'extrusions';
+} & ExtrusionOptions<P>) | ({
+    type: 'raster';
+} & RasterOptions & {
+    before?: Layer;
+}) | ({
+    type: 'ground';
+} & GroundOptions & {
+    before?: Layer;
+}) | ({
+    type: 'network';
+} & NetworkOptions) | ({
+    type: 'tiles3d';
+} & Tiles3dOptions) | ({
+    type: 'pointcloud';
+} & PointCloudOptions & {
+    before?: Layer;
+}) | ({
+    type: 'models';
+} & ModelOptions & {
+    before?: Layer;
+});