isard 1.1.0 → 1.3.0

package/dist/layers/vectors.js

@@ -0,0 +1,130 @@
+/**
+ * The fills and lines of a MapLibre style drawn as geometry, tile by tile (`VectorTiles.vectors`), instead of into the
+ * images of a raster layer: sharp at any zoom and pitch, on the relief, picked by feature, restyled without cutting the
+ * tiles again. The workers cut each vector tile into polygons and lines and style its features; the engine draws the
+ * style's layers in their order, each over its zoom range.
+ */
+import { FLOATS, stops } from "./features.js";
+import { Layer } from "./layers.js";
+export class VectorLayer extends Layer {
+    tiles = new Map();
+    sublayers = [];
+    nextKey = 0;
+    /** The whole layer shown (`setVisible`), over each style layer's visibility */
+    shown = true;
+    /** @internal Resolved once the style is loaded and its layers drawn known (set by its `VectorTiles`) */
+    styled = Promise.resolve();
+    /** @internal Changes a property of a style layer drawn (set by its `VectorTiles`) */
+    restyle;
+    /** @internal Asks the workers for the tiles in view again (set by its `VectorTiles`): an engine made anew has none */
+    recut;
+    /** @internal */
+    constructor(map) {
+        super(map);
+    }
+    /** Resolves once the style is loaded, its layers drawn known (`layers`), and the map has drawn the layer; rejected
+     * if the style fails */
+    get ready() {
+        return this.styled.then(() => super.ready);
+    }
+    /** The style layers drawn, in order */
+    get layers() {
+        return this.sublayers;
+    }
+    /** Keys of the tiles held (`z/x/y`) */
+    get tileKeys() {
+        return [...this.tiles.keys()];
+    }
+    /** @internal Sets the style layers drawn, in order (the tiles' sublayers) */
+    setSublayers(sublayers) {
+        this.sublayers = sublayers;
+        this.sendSublayers(this.map.engine, this.id);
+        this.map.requestRender();
+    }
+    /** @internal Adds or replaces a tile, cut by the workers (and made ready for the GPU there, with its mesh) */
+    setTile(tile, vectors) {
+        const key = this.tiles.get(tile)?.key ?? this.nextKey++;
+        const { properties, sublayer } = vectors;
+        this.tiles.set(tile, { key, vectors: { properties, sublayer } });
+        this.sendTile(this.map.engine, this.id, key, vectors);
+        this.map.requestRender();
+    }
+    /** @internal New styles of a tile's features, as the workers evaluated them (the same features) */
+    setTileStyles(tile, styles) {
+        const t = this.tiles.get(tile);
+        if (!t || styles.length !== t.vectors.properties.length * FLOATS)
+            return;
+        this.map.engine.setFeatureStyle(this.id, styles, t.key);
+        this.map.requestRender();
+    }
+    /** @internal */
+    removeTile(tile) {
+        const t = this.tiles.get(tile);
+        if (!t)
+            return;
+        this.tiles.delete(tile);
+        this.map.engine.removeVectorTile(this.id, t.key);
+        this.map.requestRender();
+    }
+    /** The feature of a picked index (no geometry: the tiles hold it cut), its properties and style layer. Tiles are
+     * numbered one after the other, in the order they were first added */
+    featureAt(index) {
+        const tiles = [...this.tiles.values()].sort((a, b) => a.key - b.key);
+        // The tile holding the index, and the index among its features (one pass, the features of the tiles before
+        // taken off)
+        const { tile, rest } = tiles.reduce((found, t) => {
+            if (found.tile)
+                return found;
+            const count = t.vectors.properties.length;
+            return found.rest < count ? { tile: t, rest: found.rest } : { rest: found.rest - count };
+        }, { rest: index });
+        if (!tile)
+            return undefined;
+        const properties = tile.vectors.properties[rest];
+        const sublayer = this.sublayers[tile.vectors.sublayer[rest] ?? -1];
+        if (properties === undefined || !sublayer)
+            return undefined;
+        return { type: 'Feature', properties, geometry: null, layer: sublayer.id, sourceLayer: sublayer.sourceLayer };
+    }
+    /** Changes a paint property of a style layer drawn, as MapLibre's `setPaintProperty`: the tiles are restyled, not cut
+     * again */
+    setPaintProperty(layer, name, value) {
+        this.restyle?.(layer, 'paint', name, value);
+    }
+    /** Changes a layout property of a style layer drawn (`visibility`: shown or hidden at once), as MapLibre's
+     * `setLayoutProperty` */
+    setLayoutProperty(layer, name, value) {
+        this.restyle?.(layer, 'layout', name, value);
+    }
+    setVisible(visible) {
+        this.shown = visible;
+        this.sendSublayers(this.map.engine, this.id);
+        this.map.requestRender();
+    }
+    sendSublayers(engine, id) {
+        const s = this.sublayers;
+        engine.setVectorSublayers(id, Uint8Array.from(s, (l) => ({ fill: 0, line: 1, extrusion: 2 })[l.kind]), Float64Array.from(s.flatMap((l) => [l.minZoom, l.maxZoom])), Uint8Array.from(s, (l) => (l.visible && this.shown ? 1 : 0)), Float32Array.from(s.flatMap((l) => l.dash)), Float32Array.from(s.flatMap((l) => stops(l.opacity))), Uint8Array.from(s, (l) => ({ butt: 0, round: 1, square: 2 })[l.cap]), Uint8Array.from(s, (l) => (l.lit ? 1 : 0)));
+    }
+    /** A tile to the engine: its mesh uploaded as it is, or without one its geometry, which the engine makes ready */
+    sendTile(engine, id, key, vectors) {
+        const { fills, lines, styles, properties, mesh } = vectors;
+        if (mesh) {
+            engine.setVectorTileMesh(id, key, fills.points, fills.ringStart, fills.polygonStart, fills.feature, fills.fillStart, mesh.vertices, mesh.indices, mesh.fillRanges, mesh.prism, mesh.pieces, mesh.lineTable, mesh.lineRanges, mesh.blocks, mesh.blockIndices, mesh.blockRanges, mesh.bounds, properties.length);
+            engine.setFeatureStyle(id, styles, key);
+            return;
+        }
+        engine.setVectorTile(id, key, fills.points, fills.ringStart, fills.polygonStart, fills.feature, fills.fillStart, lines.points, lines.start, lines.feature, lines.lineStart, properties.length, vectors.tile ?? new Float64Array());
+        engine.setFeatureStyle(id, styles, key);
+    }
+    /** @internal */
+    create(engine) {
+        const id = engine.addVectorTiles();
+        this.sendSublayers(engine, id);
+        // An engine made anew (after a context loss, or the one with 3D Tiles): its tiles cut again by the workers, once
+        // the layer has its id there. Keeping their geometry here would double the memory they take
+        this.tiles.clear();
+        queueMicrotask(() => this.recut?.());
+        return id;
+    }
+}
+//# sourceMappingURL=vectors.js.map

package/dist/layers/vectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.js","sourceRoot":"","sources":["../../src/layers/vectors.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The fills and lines of a MapLibre style drawn as geometry, tile by tile (`VectorTiles.vectors`), instead of into the\n * images of a raster layer: sharp at any zoom and pitch, on the relief, picked by feature, restyled without cutting the\n * tiles again. The workers cut each vector tile into polygons and lines and style its features; the engine draws the\n * style's layers in their order, each over its zoom range.\n */\n\nimport type { LayerHost } from '../types.ts';\nimport type { Engine } from '../wasm/isard.js';\nimport type { TileVectors } from '../workers/basemap.worker.ts';\nimport { type Feature, FLOATS, type Size, stops } from './features.ts';\nimport { Layer } from './layers.ts';\n\n/** A style layer as the engine draws it: its kind, zoom range, visibility and dashes (dash, gap, dash, gap, in line\n * widths; zeros: solid) */\nexport interface VectorSublayer {\n  /** The style layer's id */\n  id: string;\n  /** Its source layer, if any (not for a background) */\n  sourceLayer: string | undefined;\n  kind: 'fill' | 'line' | 'extrusion';\n  minZoom: number;\n  maxZoom: number;\n  visible: boolean;\n  /** Its opacity when it depends on the zoom only, evaluated at the camera's zoom (else 1: the features' colors hold\n   * it) */\n  opacity: Size;\n  dash: [number, number, number, number];\n  /** The caps of its lines' ends (`line-cap`; the joins between their pieces are round) */\n  cap: 'butt' | 'round' | 'square';\n  /** Its lines glow at night (the streets: its id names a road, not its casing; `setSun`) */\n  lit: boolean;\n}\n\n/** The properties of a picked feature, with the style layer that drew it */\nexport type VectorFeature = Feature<Record<string, unknown>> & { layer: string; sourceLayer: string | undefined };\n\ninterface Tile {\n  /** Its number in the engine: tiles are numbered for picking in this order */\n  key: number;\n  /** What picking needs (its geometry and styles are the engine's only: an engine made anew asks the tiles again) */\n  vectors: Pick<TileVectors, 'properties' | 'sublayer'>;\n}\n\nexport class VectorLayer extends Layer {\n  private readonly tiles = new Map<string, Tile>();\n  private sublayers: VectorSublayer[] = [];\n  private nextKey = 0;\n  /** The whole layer shown (`setVisible`), over each style layer's visibility */\n  private shown = true;\n  /** @internal Resolved once the style is loaded and its layers drawn known (set by its `VectorTiles`) */\n  styled: Promise<void> = Promise.resolve();\n  /** @internal Changes a property of a style layer drawn (set by its `VectorTiles`) */\n  restyle: ((layer: string, group: 'paint' | 'layout', name: string, value: unknown) => void) | undefined;\n  /** @internal Asks the workers for the tiles in view again (set by its `VectorTiles`): an engine made anew has none */\n  recut: (() => void) | undefined;\n\n  /** @internal */\n  constructor(map: LayerHost) {\n    super(map);\n  }\n\n  /** Resolves once the style is loaded, its layers drawn known (`layers`), and the map has drawn the layer; rejected\n   * if the style fails */\n  override get ready(): Promise<void> {\n    return this.styled.then(() => super.ready);\n  }\n\n  /** The style layers drawn, in order */\n  get layers(): readonly VectorSublayer[] {\n    return this.sublayers;\n  }\n\n  /** Keys of the tiles held (`z/x/y`) */\n  get tileKeys(): string[] {\n    return [...this.tiles.keys()];\n  }\n\n  /** @internal Sets the style layers drawn, in order (the tiles' sublayers) */\n  setSublayers(sublayers: VectorSublayer[]): void {\n    this.sublayers = sublayers;\n    this.sendSublayers(this.map.engine, this.id);\n    this.map.requestRender();\n  }\n\n  /** @internal Adds or replaces a tile, cut by the workers (and made ready for the GPU there, with its mesh) */\n  setTile(tile: string, vectors: TileVectors): void {\n    const key = this.tiles.get(tile)?.key ?? this.nextKey++;\n    const { properties, sublayer } = vectors;\n\n    this.tiles.set(tile, { key, vectors: { properties, sublayer } });\n    this.sendTile(this.map.engine, this.id, key, vectors);\n    this.map.requestRender();\n  }\n\n  /** @internal New styles of a tile's features, as the workers evaluated them (the same features) */\n  setTileStyles(tile: string, styles: Float32Array): void {\n    const t = this.tiles.get(tile);\n\n    if (!t || styles.length !== t.vectors.properties.length * FLOATS) return;\n    this.map.engine.setFeatureStyle(this.id, styles, t.key);\n    this.map.requestRender();\n  }\n\n  /** @internal */\n  removeTile(tile: string): void {\n    const t = this.tiles.get(tile);\n\n    if (!t) return;\n    this.tiles.delete(tile);\n    this.map.engine.removeVectorTile(this.id, t.key);\n    this.map.requestRender();\n  }\n\n  /** The feature of a picked index (no geometry: the tiles hold it cut), its properties and style layer. Tiles are\n   * numbered one after the other, in the order they were first added */\n  featureAt(index: number): VectorFeature | undefined {\n    const tiles = [...this.tiles.values()].sort((a, b) => a.key - b.key);\n    // The tile holding the index, and the index among its features (one pass, the features of the tiles before\n    // taken off)\n    const { tile, rest } = tiles.reduce<{ tile?: Tile; rest: number }>(\n      (found, t) => {\n        if (found.tile) return found;\n\n        const count = t.vectors.properties.length;\n\n        return found.rest < count ? { tile: t, rest: found.rest } : { rest: found.rest - count };\n      },\n      { rest: index },\n    );\n\n    if (!tile) return undefined;\n\n    const properties = tile.vectors.properties[rest];\n    const sublayer = this.sublayers[tile.vectors.sublayer[rest] ?? -1];\n\n    if (properties === undefined || !sublayer) return undefined;\n\n    return { type: 'Feature', properties, geometry: null, layer: sublayer.id, sourceLayer: sublayer.sourceLayer };\n  }\n\n  /** Changes a paint property of a style layer drawn, as MapLibre's `setPaintProperty`: the tiles are restyled, not cut\n   * again */\n  setPaintProperty(layer: string, name: string, value: unknown): void {\n    this.restyle?.(layer, 'paint', name, value);\n  }\n\n  /** Changes a layout property of a style layer drawn (`visibility`: shown or hidden at once), as MapLibre's\n   * `setLayoutProperty` */\n  setLayoutProperty(layer: string, name: string, value: unknown): void {\n    this.restyle?.(layer, 'layout', name, value);\n  }\n\n  setVisible(visible: boolean): void {\n    this.shown = visible;\n    this.sendSublayers(this.map.engine, this.id);\n    this.map.requestRender();\n  }\n\n  private sendSublayers(engine: Engine, id: number): void {\n    const s = this.sublayers;\n\n    engine.setVectorSublayers(\n      id,\n      Uint8Array.from(s, (l) => ({ fill: 0, line: 1, extrusion: 2 })[l.kind]),\n      Float64Array.from(s.flatMap((l) => [l.minZoom, l.maxZoom])),\n      Uint8Array.from(s, (l) => (l.visible && this.shown ? 1 : 0)),\n      Float32Array.from(s.flatMap((l) => l.dash)),\n      Float32Array.from(s.flatMap((l) => stops(l.opacity))),\n      Uint8Array.from(s, (l) => ({ butt: 0, round: 1, square: 2 })[l.cap]),\n      Uint8Array.from(s, (l) => (l.lit ? 1 : 0)),\n    );\n  }\n\n  /** A tile to the engine: its mesh uploaded as it is, or without one its geometry, which the engine makes ready */\n  private sendTile(engine: Engine, id: number, key: number, vectors: TileVectors): void {\n    const { fills, lines, styles, properties, mesh } = vectors;\n\n    if (mesh) {\n      engine.setVectorTileMesh(\n        id,\n        key,\n        fills.points,\n        fills.ringStart,\n        fills.polygonStart,\n        fills.feature,\n        fills.fillStart,\n        mesh.vertices,\n        mesh.indices,\n        mesh.fillRanges,\n        mesh.prism,\n        mesh.pieces,\n        mesh.lineTable,\n        mesh.lineRanges,\n        mesh.blocks,\n        mesh.blockIndices,\n        mesh.blockRanges,\n        mesh.bounds,\n        properties.length,\n      );\n      engine.setFeatureStyle(id, styles, key);\n\n      return;\n    }\n    engine.setVectorTile(\n      id,\n      key,\n      fills.points,\n      fills.ringStart,\n      fills.polygonStart,\n      fills.feature,\n      fills.fillStart,\n      lines.points,\n      lines.start,\n      lines.feature,\n      lines.lineStart,\n      properties.length,\n      vectors.tile ?? new Float64Array(),\n    );\n    engine.setFeatureStyle(id, styles, key);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const id = engine.addVectorTiles();\n\n    this.sendSublayers(engine, id);\n    // An engine made anew (after a context loss, or the one with 3D Tiles): its tiles cut again by the workers, once\n    // the layer has its id there. Keeping their geometry here would double the memory they take\n    this.tiles.clear();\n    queueMicrotask(() => this.recut?.());\n\n    return id;\n  }\n}\n"]}

package/dist/map/basemap-layers.d.ts

@@ -0,0 +1,26 @@
+/** The layers of a map's basemap: a raster or vector basemap (its labels kept on top) and the IGN hillshade, under the
+ * other layers. */
+import type { GeoMap } from '../map.ts';
+import type { BasemapName } from '../types.ts';
+import type { LayerStack } from './layer-stack.ts';
+/** The basemap and the hillshade of a map, replaced together */
+export declare class BasemapLayers {
+    private readonly map;
+    private readonly stack;
+    /** URL of the vector basemaps' workers */
+    private readonly workerUrl;
+    /** Texture size of the vector basemap's tiles */
+    private readonly tileSize;
+    private basemap;
+    private hillshade;
+    /** The vector basemap, if any: its tiles' workers and its labels */
+    private vector;
+    /** `stack`: the map's drawing order */
+    constructor(map: GeoMap, stack: LayerStack, workerUrl: string | URL, tileSize: number | undefined);
+    /** Removes the basemap and the hillshade, then adds the basemap `name` (none for 'none') */
+    replace(name: BasemapName): void;
+    /** Adds the hillshade at `opacity` (0: none), then puts it and the basemap under all the other layers */
+    addHillshade(opacity: number): void;
+    /** Stops the vector basemap's tiles (their layers removed) */
+    destroy(): void;
+}

package/dist/map/basemap-layers.js

@@ -0,0 +1,61 @@
+/** The layers of a map's basemap: a raster or vector basemap (its labels kept on top) and the IGN hillshade, under the
+ * other layers. */
+import { BASEMAPS, HILLSHADE } from "../basemap/basemaps.js";
+import { VECTOR_BASEMAPS, VectorTiles } from "../basemap/vectortiles.js";
+const isVector = (name) => Object.hasOwn(VECTOR_BASEMAPS, name);
+const isRaster = (name) => Object.hasOwn(BASEMAPS, name);
+/** The basemap and the hillshade of a map, replaced together */
+export class BasemapLayers {
+    map;
+    stack;
+    /** URL of the vector basemaps' workers */
+    workerUrl;
+    /** Texture size of the vector basemap's tiles */
+    tileSize;
+    basemap;
+    hillshade;
+    /** The vector basemap, if any: its tiles' workers and its labels */
+    vector;
+    /** `stack`: the map's drawing order */
+    constructor(map, stack, workerUrl, tileSize) {
+        this.map = map;
+        this.stack = stack;
+        this.workerUrl = workerUrl;
+        this.tileSize = tileSize;
+    }
+    /** Removes the basemap and the hillshade, then adds the basemap `name` (none for 'none') */
+    replace(name) {
+        const { map } = this;
+        if (this.basemap && map.hasLayer(this.basemap))
+            this.basemap.remove();
+        if (this.hillshade && map.hasLayer(this.hillshade))
+            this.hillshade.remove();
+        // Its raster and labels go with it
+        this.destroy();
+        this.vector = undefined;
+        if (isVector(name)) {
+            const tiles = new VectorTiles(map, {
+                style: VECTOR_BASEMAPS[name],
+                ...(this.workerUrl ? { workerUrl: this.workerUrl } : {}),
+            });
+            this.basemap = tiles.raster(this.tileSize ? { size: this.tileSize } : {});
+            this.vector = { tiles, labels: tiles.labels() };
+        }
+        else {
+            this.basemap = isRaster(name) ? map.addRaster(BASEMAPS[name]) : undefined;
+        }
+    }
+    /** Adds the hillshade at `opacity` (0: none), then puts it and the basemap under all the other layers */
+    addHillshade(opacity) {
+        this.hillshade = opacity > 0 ? this.map.addRaster({ ...HILLSHADE, opacity }) : undefined;
+        if (this.hillshade)
+            this.stack.toBottom(this.hillshade);
+        if (this.basemap)
+            this.stack.toBottom(this.basemap);
+    }
+    /** Stops the vector basemap's tiles (their layers removed) */
+    destroy() {
+        this.vector?.tiles.destroy();
+    }
+}
+//# sourceMappingURL=basemap-layers.js.map

package/dist/map/basemap-layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basemap-layers.js","sourceRoot":"","sources":["../../src/map/basemap-layers.ts"],"names":[],"mappings":"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","sourcesContent":["/** The layers of a map's basemap: a raster or vector basemap (its labels kept on top) and the IGN hillshade, under the\n * other layers. */\n\nimport { BASEMAPS, HILLSHADE } from '../basemap/basemaps.ts';\nimport type { LabelCandidate } from '../basemap/vectorstyle.ts';\nimport { VECTOR_BASEMAPS, VectorTiles } from '../basemap/vectortiles.ts';\nimport type { RasterLayer } from '../layers/layers.ts';\nimport type { SymbolLayer } from '../layers/symbols.ts';\nimport type { GeoMap } from '../map.ts';\nimport type { BasemapName } from '../types.ts';\nimport type { LayerStack } from './layer-stack.ts';\n\nconst isVector = (name: BasemapName): name is keyof typeof VECTOR_BASEMAPS => Object.hasOwn(VECTOR_BASEMAPS, name);\nconst isRaster = (name: BasemapName): name is keyof typeof BASEMAPS => Object.hasOwn(BASEMAPS, name);\n\n/** The basemap and the hillshade of a map, replaced together */\nexport class BasemapLayers {\n  private readonly map: GeoMap;\n  private readonly stack: LayerStack;\n  /** URL of the vector basemaps' workers */\n  private readonly workerUrl: string | URL;\n  /** Texture size of the vector basemap's tiles */\n  private readonly tileSize: number | undefined;\n  private basemap: RasterLayer | undefined;\n  private hillshade: RasterLayer | undefined;\n  /** The vector basemap, if any: its tiles' workers and its labels */\n  private vector: { tiles: VectorTiles; labels: SymbolLayer<LabelCandidate> } | undefined;\n\n  /** `stack`: the map's drawing order */\n  constructor(map: GeoMap, stack: LayerStack, workerUrl: string | URL, tileSize: number | undefined) {\n    this.map = map;\n    this.stack = stack;\n    this.workerUrl = workerUrl;\n    this.tileSize = tileSize;\n  }\n\n  /** Removes the basemap and the hillshade, then adds the basemap `name` (none for 'none') */\n  replace(name: BasemapName): void {\n    const { map } = this;\n\n    if (this.basemap && map.hasLayer(this.basemap)) this.basemap.remove();\n    if (this.hillshade && map.hasLayer(this.hillshade)) this.hillshade.remove();\n    // Its raster and labels go with it\n    this.destroy();\n    this.vector = undefined;\n\n    if (isVector(name)) {\n      const tiles = new VectorTiles(map, {\n        style: VECTOR_BASEMAPS[name],\n        ...(this.workerUrl ? { workerUrl: this.workerUrl } : {}),\n      });\n\n      this.basemap = tiles.raster(this.tileSize ? { size: this.tileSize } : {});\n      this.vector = { tiles, labels: tiles.labels() };\n    } else {\n      this.basemap = isRaster(name) ? map.addRaster(BASEMAPS[name]) : undefined;\n    }\n  }\n\n  /** Adds the hillshade at `opacity` (0: none), then puts it and the basemap under all the other layers */\n  addHillshade(opacity: number): void {\n    this.hillshade = opacity > 0 ? this.map.addRaster({ ...HILLSHADE, opacity }) : undefined;\n    if (this.hillshade) this.stack.toBottom(this.hillshade);\n    if (this.basemap) this.stack.toBottom(this.basemap);\n  }\n\n  /** Stops the vector basemap's tiles (their layers removed) */\n  destroy(): void {\n    this.vector?.tiles.destroy();\n  }\n}\n"]}

package/dist/map/canvas.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The map's canvas: created, named for screen readers, its WebGL context's loss and restoration followed, the device
+ * pixel ratio watched (a canvas's pixels follow it).
+ */
+/** A canvas filling its container, the pointer's gestures left to the map */
+export declare const createCanvas: () => HTMLCanvasElement;
+/** Reached with Tab when the keys move the map (`keyboard`); named for screen readers either way */
+export declare const labelCanvas: (canvas: HTMLCanvasElement, keyboard: boolean, label: string) => void;
+/**
+ * Follows the loss and restoration of the canvas's WebGL context (the browser may take the GPU away: driver reset,
+ * background tab on mobile): `lost` once it is gone, the context kept to be restored, `restored` once it is back.
+ * Returns what stops following them
+ */
+export declare const watchContext: (canvas: HTMLCanvasElement, lost: () => void, restored: () => void) => (() => void);
+/** Calls `changed` when the device pixel ratio changes (browser zoom, a window moved to another screen); returns what
+ * stops watching it */
+export declare const watchPixelRatio: (changed: () => void) => (() => void);

package/dist/map/canvas.js

@@ -0,0 +1,56 @@
+/**
+ * The map's canvas: created, named for screen readers, its WebGL context's loss and restoration followed, the device
+ * pixel ratio watched (a canvas's pixels follow it).
+ */
+/** A canvas filling its container, the pointer's gestures left to the map */
+export const createCanvas = () => {
+    const canvas = document.createElement('canvas');
+    Object.assign(canvas.style, { display: 'block', width: '100%', height: '100%', touchAction: 'none' });
+    return canvas;
+};
+/** Reached with Tab when the keys move the map (`keyboard`); named for screen readers either way */
+export const labelCanvas = (canvas, keyboard, label) => {
+    canvas.classList.add('isard-canvas');
+    canvas.setAttribute('role', keyboard ? 'application' : 'region');
+    canvas.setAttribute('aria-roledescription', 'map');
+    canvas.setAttribute('aria-label', label);
+    if (keyboard)
+        canvas.tabIndex = 0;
+};
+/**
+ * Follows the loss and restoration of the canvas's WebGL context (the browser may take the GPU away: driver reset,
+ * background tab on mobile): `lost` once it is gone, the context kept to be restored, `restored` once it is back.
+ * Returns what stops following them
+ */
+export const watchContext = (canvas, lost, restored) => {
+    const onLost = (event) => {
+        event.preventDefault();
+        lost();
+    };
+    canvas.addEventListener('webglcontextlost', onLost);
+    canvas.addEventListener('webglcontextrestored', restored);
+    return () => {
+        canvas.removeEventListener('webglcontextlost', onLost);
+        canvas.removeEventListener('webglcontextrestored', restored);
+    };
+};
+/** Calls `changed` when the device pixel ratio changes (browser zoom, a window moved to another screen); returns what
+ * stops watching it */
+export const watchPixelRatio = (changed) => {
+    if (typeof matchMedia !== 'function')
+        return () => undefined;
+    let stop = () => undefined;
+    const watch = () => {
+        const query = matchMedia(`(resolution: ${window.devicePixelRatio || 1}dppx)`);
+        const listener = () => {
+            // A query for the new ratio
+            watch();
+            changed();
+        };
+        query.addEventListener('change', listener, { once: true });
+        stop = () => query.removeEventListener('change', listener);
+    };
+    watch();
+    return () => stop();
+};
+//# sourceMappingURL=canvas.js.map

package/dist/map/canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../src/map/canvas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAsB,EAAE;IAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEhD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtG,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,oGAAoG;AACpG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAyB,EAAE,QAAiB,EAAE,KAAa,EAAQ,EAAE;IAC/F,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACrC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,CAAC,YAAY,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAyB,EAAE,IAAgB,EAAE,QAAoB,EAAgB,EAAE;IAC9G,MAAM,MAAM,GAAG,CAAC,KAAY,EAAE,EAAE;QAC9B,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IAE1D,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;uBACuB;AACvB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAmB,EAAgB,EAAE;IACnE,IAAI,OAAO,UAAU,KAAK,UAAU;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAE7D,IAAI,IAAI,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;IACjC,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,MAAM,KAAK,GAAG,UAAU,CAAC,gBAAgB,MAAM,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9E,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,4BAA4B;YAC5B,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC,CAAC;IAEF,KAAK,EAAE,CAAC;IAER,OAAO,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC,CAAC","sourcesContent":["/**\n * The map's canvas: created, named for screen readers, its WebGL context's loss and restoration followed, the device\n * pixel ratio watched (a canvas's pixels follow it).\n */\n\n/** A canvas filling its container, the pointer's gestures left to the map */\nexport const createCanvas = (): HTMLCanvasElement => {\n  const canvas = document.createElement('canvas');\n\n  Object.assign(canvas.style, { display: 'block', width: '100%', height: '100%', touchAction: 'none' });\n\n  return canvas;\n};\n\n/** Reached with Tab when the keys move the map (`keyboard`); named for screen readers either way */\nexport const labelCanvas = (canvas: HTMLCanvasElement, keyboard: boolean, label: string): void => {\n  canvas.classList.add('isard-canvas');\n  canvas.setAttribute('role', keyboard ? 'application' : 'region');\n  canvas.setAttribute('aria-roledescription', 'map');\n  canvas.setAttribute('aria-label', label);\n  if (keyboard) canvas.tabIndex = 0;\n};\n\n/**\n * Follows the loss and restoration of the canvas's WebGL context (the browser may take the GPU away: driver reset,\n * background tab on mobile): `lost` once it is gone, the context kept to be restored, `restored` once it is back.\n * Returns what stops following them\n */\nexport const watchContext = (canvas: HTMLCanvasElement, lost: () => void, restored: () => void): (() => void) => {\n  const onLost = (event: Event) => {\n    event.preventDefault();\n    lost();\n  };\n\n  canvas.addEventListener('webglcontextlost', onLost);\n  canvas.addEventListener('webglcontextrestored', restored);\n\n  return () => {\n    canvas.removeEventListener('webglcontextlost', onLost);\n    canvas.removeEventListener('webglcontextrestored', restored);\n  };\n};\n\n/** Calls `changed` when the device pixel ratio changes (browser zoom, a window moved to another screen); returns what\n * stops watching it */\nexport const watchPixelRatio = (changed: () => void): (() => void) => {\n  if (typeof matchMedia !== 'function') return () => undefined;\n\n  let stop = (): void => undefined;\n  const watch = () => {\n    const query = matchMedia(`(resolution: ${window.devicePixelRatio || 1}dppx)`);\n    const listener = () => {\n      // A query for the new ratio\n      watch();\n      changed();\n    };\n\n    query.addEventListener('change', listener, { once: true });\n    stop = () => query.removeEventListener('change', listener);\n  };\n\n  watch();\n\n  return () => stop();\n};\n"]}

package/dist/map/checks.d.ts

@@ -0,0 +1,11 @@
+/**
+ * What the map checks of what the application gives it before the engine sees it (a basemap's name, a network's
+ * arrays), and how it reports an error it does not throw.
+ */
+import type { Basemap, BasemapName } from '../types.ts';
+/** Reports an error without throwing it here: the console shows it, as an uncaught one */
+export declare const report: (error: unknown) => void;
+/** Checks a network's arrays before the engine reads them: node index pairs, indices of existing nodes */
+export declare const validateNetwork: (nodes: Float64Array, edges: Uint32Array) => void;
+/** The name of a basemap, checked: an unknown one throws */
+export declare const checkBasemap: (basemap: Basemap) => BasemapName;

package/dist/map/checks.js

@@ -0,0 +1,39 @@
+/**
+ * What the map checks of what the application gives it before the engine sees it (a basemap's name, a network's
+ * arrays), and how it reports an error it does not throw.
+ */
+import { BASEMAPS, RENAMED_BASEMAPS } from "../basemap/basemaps.js";
+import { VECTOR_BASEMAPS } from "../basemap/vectortiles.js";
+/** Reports an error without throwing it here: the console shows it, as an uncaught one */
+export const report = (error) => {
+    if (typeof reportError === 'function')
+        reportError(error);
+    else
+        queueMicrotask(() => {
+            throw error;
+        });
+};
+/** Checks a network's arrays before the engine reads them: node index pairs, indices of existing nodes */
+export const validateNetwork = (nodes, edges) => {
+    if (nodes.length % 2 !== 0)
+        throw new Error(`isard: network nodes must be lon, lat pairs (length ${nodes.length})`);
+    if (edges.length % 2 !== 0)
+        throw new Error(`isard: network edges must be node index pairs (length ${edges.length})`);
+    const count = nodes.length / 2;
+    for (let i = 0; i < edges.length; i += 1) {
+        const node = edges[i];
+        if (node >= count)
+            throw new Error(`isard: network edge ${i >> 1} refers to node ${node}, of ${count} nodes`);
+    }
+};
+/** The name of a basemap, checked: an unknown one throws */
+export const checkBasemap = (basemap) => {
+    const renamed = RENAMED_BASEMAPS[basemap];
+    if (renamed)
+        throw new Error(`isard: the basemap '${basemap}' is now named '${renamed}'`);
+    if (basemap !== 'none' && !(basemap in VECTOR_BASEMAPS) && !(basemap in BASEMAPS)) {
+        throw new Error(`isard: unknown basemap '${basemap}'`);
+    }
+    return basemap;
+};
+//# sourceMappingURL=checks.js.map

package/dist/map/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../src/map/checks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,0FAA0F;AAC1F,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAQ,EAAE;IAC7C,IAAI,OAAO,WAAW,KAAK,UAAU;QAAE,WAAW,CAAC,KAAK,CAAC,CAAC;;QAExD,cAAc,CAAC,GAAG,EAAE;YAClB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAmB,EAAE,KAAkB,EAAQ,EAAE;IAC/E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACpH,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAEtH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC;QAEhC,IAAI,IAAI,IAAI,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,IAAI,CAAC,mBAAmB,IAAI,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAChH,CAAC;AACH,CAAC,CAAC;AAEF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAe,EAAE;IAC5D,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE1C,IAAI,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,mBAAmB,OAAO,GAAG,CAAC,CAAC;IAC1F,IAAI,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/**\n * What the map checks of what the application gives it before the engine sees it (a basemap's name, a network's\n * arrays), and how it reports an error it does not throw.\n */\n\nimport { BASEMAPS, RENAMED_BASEMAPS } from '../basemap/basemaps.ts';\nimport { VECTOR_BASEMAPS } from '../basemap/vectortiles.ts';\nimport type { Basemap, BasemapName } from '../types.ts';\n\n/** Reports an error without throwing it here: the console shows it, as an uncaught one */\nexport const report = (error: unknown): void => {\n  if (typeof reportError === 'function') reportError(error);\n  else\n    queueMicrotask(() => {\n      throw error;\n    });\n};\n\n/** Checks a network's arrays before the engine reads them: node index pairs, indices of existing nodes */\nexport const validateNetwork = (nodes: Float64Array, edges: Uint32Array): void => {\n  if (nodes.length % 2 !== 0) throw new Error(`isard: network nodes must be lon, lat pairs (length ${nodes.length})`);\n  if (edges.length % 2 !== 0) throw new Error(`isard: network edges must be node index pairs (length ${edges.length})`);\n\n  const count = nodes.length / 2;\n\n  for (let i = 0; i < edges.length; i += 1) {\n    const node = edges[i] as number;\n\n    if (node >= count) throw new Error(`isard: network edge ${i >> 1} refers to node ${node}, of ${count} nodes`);\n  }\n};\n\n/** The name of a basemap, checked: an unknown one throws */\nexport const checkBasemap = (basemap: Basemap): BasemapName => {\n  const renamed = RENAMED_BASEMAPS[basemap];\n\n  if (renamed) throw new Error(`isard: the basemap '${basemap}' is now named '${renamed}'`);\n  if (basemap !== 'none' && !(basemap in VECTOR_BASEMAPS) && !(basemap in BASEMAPS)) {\n    throw new Error(`isard: unknown basemap '${basemap}'`);\n  }\n\n  return basemap;\n};\n"]}

package/dist/map/credits.d.ts

@@ -0,0 +1,17 @@
+/** The credits of a map's raster layers, and who is told when they change (the attribution controls). */
+/** The credits of the raster layers that have some (basemaps, hillshade, the Géoplateforme's rasters…) */
+export declare class Credits {
+    private readonly byLayer;
+    /** Called when the credits of the layers or relief change */
+    private readonly listeners;
+    /** A layer's credit */
+    set(layer: object, credit: string): void;
+    /** Forgets a removed layer's credit, if it had one */
+    forget(layer: object): void;
+    /** The credits of `layers` (in their order) and of the relief, each once */
+    of(layers: readonly object[], relief: string | undefined): string[];
+    /** Calls `listener` when the credits change; returns what stops it */
+    onChange(listener: () => void): () => void;
+    /** Tells the listeners the credits changed */
+    changed(): void;
+}

package/dist/map/credits.js

@@ -0,0 +1,34 @@
+/** The credits of a map's raster layers, and who is told when they change (the attribution controls). */
+/** The credits of the raster layers that have some (basemaps, hillshade, the Géoplateforme's rasters…) */
+export class Credits {
+    byLayer = new Map();
+    /** Called when the credits of the layers or relief change */
+    listeners = new Set();
+    /** A layer's credit */
+    set(layer, credit) {
+        this.byLayer.set(layer, credit);
+        this.changed();
+    }
+    /** Forgets a removed layer's credit, if it had one */
+    forget(layer) {
+        if (this.byLayer.delete(layer))
+            this.changed();
+    }
+    /** The credits of `layers` (in their order) and of the relief, each once */
+    of(layers, relief) {
+        const credits = [...layers.map((layer) => this.byLayer.get(layer)), relief];
+        return [...new Set(credits.filter((c) => c !== undefined))];
+    }
+    /** Calls `listener` when the credits change; returns what stops it */
+    onChange(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** Tells the listeners the credits changed */
+    changed() {
+        this.listeners.forEach((listener) => {
+            listener();
+        });
+    }
+}
+//# sourceMappingURL=credits.js.map

package/dist/map/credits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.js","sourceRoot":"","sources":["../../src/map/credits.ts"],"names":[],"mappings":"AAAA,yGAAyG;AAEzG,0GAA0G;AAC1G,MAAM,OAAO,OAAO;IACD,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrD,6DAA6D;IAC5C,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAEnD,uBAAuB;IACvB,GAAG,CAAC,KAAa,EAAE,MAAc;QAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,sDAAsD;IACtD,MAAM,CAAC,KAAa;QAClB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC;IAED,4EAA4E;IAC5E,EAAE,CAAC,MAAyB,EAAE,MAA0B;QACtD,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAE5E,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,sEAAsE;IACtE,QAAQ,CAAC,QAAoB;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,8CAA8C;IAC9C,OAAO;QACL,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAClC,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["/** The credits of a map's raster layers, and who is told when they change (the attribution controls). */\n\n/** The credits of the raster layers that have some (basemaps, hillshade, the Géoplateforme's rasters…) */\nexport class Credits {\n  private readonly byLayer = new Map<object, string>();\n  /** Called when the credits of the layers or relief change */\n  private readonly listeners = new Set<() => void>();\n\n  /** A layer's credit */\n  set(layer: object, credit: string): void {\n    this.byLayer.set(layer, credit);\n    this.changed();\n  }\n\n  /** Forgets a removed layer's credit, if it had one */\n  forget(layer: object): void {\n    if (this.byLayer.delete(layer)) this.changed();\n  }\n\n  /** The credits of `layers` (in their order) and of the relief, each once */\n  of(layers: readonly object[], relief: string | undefined): string[] {\n    const credits = [...layers.map((layer) => this.byLayer.get(layer)), relief];\n\n    return [...new Set(credits.filter((c): c is string => c !== undefined))];\n  }\n\n  /** Calls `listener` when the credits change; returns what stops it */\n  onChange(listener: () => void): () => void {\n    this.listeners.add(listener);\n\n    return () => this.listeners.delete(listener);\n  }\n\n  /** Tells the listeners the credits changed */\n  changed(): void {\n    this.listeners.forEach((listener) => {\n      listener();\n    });\n  }\n}\n"]}

package/dist/map/engine-settings.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The settings of the map's engine: made from the options, given to each new engine (at creation, and again after a
+ * context loss or once the engine with 3D Tiles is loaded), with the page's request headers.
+ */
+import type { PngEncoding } from '../basemap/terrain.ts';
+import { type HeaderRules } from '../engine/requests.ts';
+import { type Settings, type TerrainLoader } from '../settings.ts';
+import type { GeoMapOptions } from '../types.ts';
+import type { Engine } from '../wasm/isard.js';
+/** The settings of a map from its options; `earth`: the map is of the Earth */
+export declare const mapSettings: (options: GeoMapOptions, earth: boolean, terrainLoader: (url: string, encoding: PngEncoding, floor?: number) => TerrainLoader) => Settings;
+/** Gives a new engine the settings and the page's request headers */
+export declare const applySettings: (engine: Engine, settings: Settings) => void;
+/** The page's request headers to an engine (its own requests: raster tiles, tilesets, point clouds) */
+export declare const sendHeaders: (engine: Engine, rules: HeaderRules) => void;

package/dist/map/engine-settings.js

@@ -0,0 +1,45 @@
+/**
+ * The settings of the map's engine: made from the options, given to each new engine (at creation, and again after a
+ * context loss or once the engine with 3D Tiles is loaded), with the page's request headers.
+ */
+import { SEA } from "../basemap/basemaps.js";
+import { headerRules } from "../engine/requests.js";
+import { atmosphereSettings, bodySettings, haloSettings, rgb, terrainSettings, } from "../settings.js";
+/** The settings of a map from its options; `earth`: the map is of the Earth */
+export const mapSettings = (options, earth, terrainLoader) => {
+    const body = bodySettings(options.body);
+    return {
+        body,
+        zoomRange: [options.minZoom ?? 0, options.maxZoom ?? 22],
+        maxPitch: options.maxPitch ?? 70,
+        globe: (options.projection ?? 'globe') === 'globe',
+        sky: options.sky ?? true,
+        atmosphere: atmosphereSettings(options.atmosphere),
+        terrain: terrainSettings(options.terrain, options.body, body.radius, terrainLoader),
+        loading: options.loading ?? 'immediate',
+        background: rgb(options.background ?? (earth ? '#f2f2f0' : '#000000')),
+        globeColor: earth ? SEA['osm-positron'] : rgb(body.color),
+    };
+};
+/** Gives a new engine the settings and the page's request headers */
+export const applySettings = (engine, settings) => {
+    // The body first: the layers' shaders may take its size
+    const { radius, flattening, atmosphere: air, relief } = settings.body;
+    engine.setBody(radius, flattening, haloSettings(air), ...relief);
+    sendHeaders(engine, headerRules());
+    const { zoomRange, maxPitch, globe, sky, atmosphere, terrain, loading, background, globeColor } = settings;
+    engine.setZoomRange(...zoomRange);
+    engine.setMaxPitch(maxPitch);
+    engine.setGlobe(globe);
+    engine.setSky(sky);
+    engine.setAtmosphere(atmosphere);
+    engine.setTerrain(terrain?.url, terrain?.exaggeration ?? 1, terrain?.maxZoom, terrain?.geoid, terrain?.loader);
+    engine.setImmediateLoading(loading === 'immediate');
+    engine.setBackground(...background);
+    engine.setGlobeColor(...globeColor);
+};
+/** The page's request headers to an engine (its own requests: raster tiles, tilesets, point clouds) */
+export const sendHeaders = (engine, rules) => {
+    engine.setRequestHeaders(rules.map(([prefix]) => prefix), Uint32Array.from(rules, ([, headers]) => Object.keys(headers).length), rules.flatMap(([, headers]) => Object.entries(headers).flat()));
+};
+//# sourceMappingURL=engine-settings.js.map

package/dist/map/engine-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-settings.js","sourceRoot":"","sources":["../../src/map/engine-settings.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The settings of the map's engine: made from the options, given to each new engine (at creation, and again after a\n * context loss or once the engine with 3D Tiles is loaded), with the page's request headers.\n */\n\nimport { SEA } from '../basemap/basemaps.ts';\nimport type { PngEncoding } from '../basemap/terrain.ts';\nimport { type HeaderRules, headerRules } from '../engine/requests.ts';\nimport {\n  atmosphereSettings,\n  bodySettings,\n  haloSettings,\n  rgb,\n  type Settings,\n  type TerrainLoader,\n  terrainSettings,\n} from '../settings.ts';\nimport type { GeoMapOptions } from '../types.ts';\nimport type { Engine } from '../wasm/isard.js';\n\n/** The settings of a map from its options; `earth`: the map is of the Earth */\nexport const mapSettings = (\n  options: GeoMapOptions,\n  earth: boolean,\n  terrainLoader: (url: string, encoding: PngEncoding, floor?: number) => TerrainLoader,\n): Settings => {\n  const body = bodySettings(options.body);\n\n  return {\n    body,\n    zoomRange: [options.minZoom ?? 0, options.maxZoom ?? 22],\n    maxPitch: options.maxPitch ?? 70,\n    globe: (options.projection ?? 'globe') === 'globe',\n    sky: options.sky ?? true,\n    atmosphere: atmosphereSettings(options.atmosphere),\n    terrain: terrainSettings(options.terrain, options.body, body.radius, terrainLoader),\n    loading: options.loading ?? 'immediate',\n    background: rgb(options.background ?? (earth ? '#f2f2f0' : '#000000')),\n    globeColor: earth ? SEA['osm-positron'] : rgb(body.color),\n  };\n};\n\n/** Gives a new engine the settings and the page's request headers */\nexport const applySettings = (engine: Engine, settings: Settings): void => {\n  // The body first: the layers' shaders may take its size\n  const { radius, flattening, atmosphere: air, relief } = settings.body;\n\n  engine.setBody(radius, flattening, haloSettings(air), ...relief);\n  sendHeaders(engine, headerRules());\n\n  const { zoomRange, maxPitch, globe, sky, atmosphere, terrain, loading, background, globeColor } = settings;\n\n  engine.setZoomRange(...zoomRange);\n  engine.setMaxPitch(maxPitch);\n  engine.setGlobe(globe);\n  engine.setSky(sky);\n  engine.setAtmosphere(atmosphere);\n  engine.setTerrain(terrain?.url, terrain?.exaggeration ?? 1, terrain?.maxZoom, terrain?.geoid, terrain?.loader);\n  engine.setImmediateLoading(loading === 'immediate');\n  engine.setBackground(...background);\n  engine.setGlobeColor(...globeColor);\n};\n\n/** The page's request headers to an engine (its own requests: raster tiles, tilesets, point clouds) */\nexport const sendHeaders = (engine: Engine, rules: HeaderRules): void => {\n  engine.setRequestHeaders(\n    rules.map(([prefix]) => prefix),\n    Uint32Array.from(rules, ([, headers]) => Object.keys(headers).length),\n    rules.flatMap(([, headers]) => Object.entries(headers).flat()),\n  );\n};\n"]}

package/dist/map/engines.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Which engine a map runs: the core one, or the one with 3D Tiles, from the start or loaded once a layer needs it
+ * (the map is rebuilt on it then); and the workers decoding its 3D Tiles, started with the first engine that has them.
+ */
+import { type EngineClass } from '../engine-loader.ts';
+import type { Settings } from '../settings.ts';
+import type { GeoMapOptions } from '../types.ts';
+import type { Engine } from '../wasm/isard.js';
+/** What loading the engine with 3D Tiles and its workers needs */
+export type Tiles3dEngineOptions = Pick<GeoMapOptions, 'wasmUrl' | 'workers' | 'workerUrl' | 'decoders' | 'pointsWasmUrl' | 'assetsUrl'>;
+/** The engine class of a map, and the engine with 3D Tiles loaded when needed */
+export declare class MapEngines {
+    #private;
+    /** The class of the engine: without 3D Tiles until a 3D Tiles layer is added, unless asked for from the start */
+    private engineClass;
+    /** The module of the engine with 3D Tiles once it runs the map (the decoding workers run it too) */
+    private module;
+    private loader;
+    private readonly options;
+    /** The map is destroyed: a loaded engine is not used */
+    private readonly gone;
+    /** `module`: the module of the engine with 3D Tiles if `engineClass` is that engine */
+    constructor(engineClass: EngineClass, module: WebAssembly.Module | undefined, options: Tiles3dEngineOptions, gone: () => boolean);
+    /** The engine with 3D Tiles runs the map */
+    get tiles3d(): boolean;
+    /** The engine with 3D Tiles is loading, for the 3D Tiles layers added on the core engine */
+    get upgrading(): Promise<void> | undefined;
+    /** A new engine drawing on `canvas`, with the settings and the decoding workers of 3D Tiles if it has them */
+    create(canvas: HTMLCanvasElement, redraw: () => void, settings: Settings): Engine;
+    /** Height of the geoid above the ellipsoid at a position, in metres */
+    geoidHeight(lon: number, lat: number): number;
+    /** The matrix of a custom layer's model at a position */
+    customMatrix(lon: number, lat: number, altitude: number): Float32Array | undefined;
+    /** Loads the engine with 3D Tiles, once at a time: `loaded` once it is the map's class, `failed` with the error;
+     * neither if the map is gone by then */
+    upgrade(loaded: () => void, failed: (error: unknown) => void): void;
+    /** Downloads and compiles the engine with 3D Tiles without running it, unless the map is gone or has it by then */
+    preload(): void;
+    /** Stops the decoding workers */
+    destroy(): void;
+}