isard 1.1.0 → 1.3.0

package/dist/map/layer-stack.js

@@ -0,0 +1,101 @@
+/**
+ * The drawing order of a map's layers, kept beside the engine's: the layers waiting for the engine with 3D Tiles are
+ * in the order but not in the engine yet, and the order recreates the layers in a new engine after a context loss.
+ */
+import { report } from "./checks.js";
+/** A map's layers in drawing order, bottom first, and those kept on top */
+export class LayerStack {
+    /** Layers in drawing order (bottom first), to recreate them after a context loss */
+    layers = [];
+    /** Layers new layers go under */
+    onTop = new Set();
+    engine;
+    /** `engine`: the map's engine of the moment */
+    constructor(engine) {
+        this.engine = engine;
+    }
+    has(layer) {
+        return this.layers.includes(layer);
+    }
+    /** Puts a new layer on top, under the layers kept on top (the basemap's labels) */
+    add(layer) {
+        this.layers.push(layer);
+        const top = this.layers.find((l) => this.onTop.has(l) && l !== layer);
+        if (top)
+            this.move(layer, top);
+    }
+    /** Forgets a removed layer */
+    forget(layer) {
+        this.unlist(layer);
+        this.onTop.delete(layer);
+    }
+    /** Moves a layer under `before`, or on top of all */
+    move(layer, before) {
+        this.unlist(layer);
+        const index = before ? this.layers.indexOf(before) : -1;
+        const at = index < 0 ? this.layers.length : index;
+        this.layers.splice(at, 0, layer);
+        if (layer.id >= 0)
+            this.engine().moveLayer(layer.id, this.engineIndex(at));
+    }
+    /** A layer made again in the engine under a new id: `old` removed, the new one moved to the layer's place */
+    replace(layer, old) {
+        const engine = this.engine();
+        engine.removeLayer(old);
+        const index = this.layers.indexOf(layer);
+        if (index >= 0)
+            engine.moveLayer(layer.id, this.engineIndex(index));
+    }
+    /** Moves a layer under all the others */
+    toBottom(layer) {
+        this.engine().moveLayer(layer.id, 0);
+        this.unlist(layer);
+        this.layers.unshift(layer);
+    }
+    /** Creates the layers in a new engine, in order, but those still `waiting` (for the engine with 3D Tiles); a layer
+     * that fails is reported and left out */
+    reattach(engine, waiting) {
+        // No layer refers to an id of the old engine while the others are created
+        this.layers.forEach((layer) => {
+            layer.forgetEngine();
+        });
+        this.layers.forEach((layer) => {
+            if (waiting(layer))
+                return;
+            try {
+                layer.attach(engine);
+            }
+            catch (error) {
+                report(error);
+            }
+        });
+        // Links between layers, once every layer has its new id (buildings colored by a network above them)
+        this.layers.forEach((layer) => {
+            if (layer.id < 0)
+                return;
+            try {
+                layer.relink(engine);
+            }
+            catch (error) {
+                report(error);
+            }
+        });
+    }
+    /** Frees what the layers hold beside the engine (custom layers' WebGL objects, models' data) */
+    dispose() {
+        this.layers.forEach((layer) => {
+            layer.dispose();
+        });
+    }
+    /** Takes a layer out of the drawing order (to put it back elsewhere, or for good) */
+    unlist(layer) {
+        const index = this.layers.indexOf(layer);
+        if (index >= 0)
+            this.layers.splice(index, 1);
+    }
+    /** Index in the engine of the layer at `index`: the layers waiting for the engine with 3D Tiles are not in it yet */
+    engineIndex(index) {
+        return this.layers.slice(0, index).filter((layer) => layer.id >= 0).length;
+    }
+}
+//# sourceMappingURL=layer-stack.js.map

package/dist/map/layer-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-stack.js","sourceRoot":"","sources":["../../src/map/layer-stack.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The drawing order of a map's layers, kept beside the engine's: the layers waiting for the engine with 3D Tiles are\n * in the order but not in the engine yet, and the order recreates the layers in a new engine after a context loss.\n */\n\nimport type { Layer } from '../layers/layers.ts';\nimport type { Engine } from '../wasm/isard.js';\nimport { report } from './checks.ts';\n\n/** A map's layers in drawing order, bottom first, and those kept on top */\nexport class LayerStack {\n  /** Layers in drawing order (bottom first), to recreate them after a context loss */\n  readonly layers: Layer[] = [];\n  /** Layers new layers go under */\n  readonly onTop = new Set<Layer>();\n  private readonly engine: () => Engine;\n\n  /** `engine`: the map's engine of the moment */\n  constructor(engine: () => Engine) {\n    this.engine = engine;\n  }\n\n  has(layer: Layer): boolean {\n    return this.layers.includes(layer);\n  }\n\n  /** Puts a new layer on top, under the layers kept on top (the basemap's labels) */\n  add(layer: Layer): void {\n    this.layers.push(layer);\n\n    const top = this.layers.find((l) => this.onTop.has(l) && l !== layer);\n\n    if (top) this.move(layer, top);\n  }\n\n  /** Forgets a removed layer */\n  forget(layer: Layer): void {\n    this.unlist(layer);\n    this.onTop.delete(layer);\n  }\n\n  /** Moves a layer under `before`, or on top of all */\n  move(layer: Layer, before: Layer | undefined): void {\n    this.unlist(layer);\n\n    const index = before ? this.layers.indexOf(before) : -1;\n    const at = index < 0 ? this.layers.length : index;\n\n    this.layers.splice(at, 0, layer);\n    if (layer.id >= 0) this.engine().moveLayer(layer.id, this.engineIndex(at));\n  }\n\n  /** A layer made again in the engine under a new id: `old` removed, the new one moved to the layer's place */\n  replace(layer: Layer, old: number): void {\n    const engine = this.engine();\n\n    engine.removeLayer(old);\n\n    const index = this.layers.indexOf(layer);\n\n    if (index >= 0) engine.moveLayer(layer.id, this.engineIndex(index));\n  }\n\n  /** Moves a layer under all the others */\n  toBottom(layer: Layer): void {\n    this.engine().moveLayer(layer.id, 0);\n    this.unlist(layer);\n    this.layers.unshift(layer);\n  }\n\n  /** Creates the layers in a new engine, in order, but those still `waiting` (for the engine with 3D Tiles); a layer\n   * that fails is reported and left out */\n  reattach(engine: Engine, waiting: (layer: Layer) => boolean): void {\n    // No layer refers to an id of the old engine while the others are created\n    this.layers.forEach((layer) => {\n      layer.forgetEngine();\n    });\n    this.layers.forEach((layer) => {\n      if (waiting(layer)) return;\n      try {\n        layer.attach(engine);\n      } catch (error) {\n        report(error);\n      }\n    });\n    // Links between layers, once every layer has its new id (buildings colored by a network above them)\n    this.layers.forEach((layer) => {\n      if (layer.id < 0) return;\n      try {\n        layer.relink(engine);\n      } catch (error) {\n        report(error);\n      }\n    });\n  }\n\n  /** Frees what the layers hold beside the engine (custom layers' WebGL objects, models' data) */\n  dispose(): void {\n    this.layers.forEach((layer) => {\n      layer.dispose();\n    });\n  }\n\n  /** Takes a layer out of the drawing order (to put it back elsewhere, or for good) */\n  private unlist(layer: Layer): void {\n    const index = this.layers.indexOf(layer);\n\n    if (index >= 0) this.layers.splice(index, 1);\n  }\n\n  /** Index in the engine of the layer at `index`: the layers waiting for the engine with 3D Tiles are not in it yet */\n  private engineIndex(index: number): number {\n    return this.layers.slice(0, index).filter((layer) => layer.id >= 0).length;\n  }\n}\n"]}

package/dist/map/overlay-host.d.ts

@@ -0,0 +1,36 @@
+/**
+ * What the map shows over its canvas, in its container: the markers and popups (placed after every frame) and the
+ * controls in the four corners.
+ */
+import type { GeoMap } from '../map.ts';
+import type { Point } from '../types.ts';
+import type { Control, ControlPosition } from '../ui/controls.ts';
+import type { Positioned } from '../ui/overlay.ts';
+/** The map's container: its canvas, the element of the markers and popups over it, the corners of the controls */
+export declare class OverlayHost {
+    /** Canvas size in CSS pixels, kept on resize so placing overlays never reads the layout */
+    size: Point;
+    private readonly container;
+    private readonly canvas;
+    /** The map the controls are added to */
+    private readonly map;
+    /** Markers and popups, over the canvas */
+    private readonly overlay;
+    private readonly corners;
+    private readonly controls;
+    private readonly positioned;
+    /** Puts the canvas, the overlay and the corners in `container` */
+    constructor(container: HTMLElement, canvas: HTMLCanvasElement, map: GeoMap);
+    /** Adds a control in a corner; controls stack from the corner inward */
+    addControl(control: Control, position: ControlPosition): void;
+    removeControl(control: Control): void;
+    /** Shows a marker or popup, placed after every frame from now on */
+    attach(item: Positioned, element: HTMLElement): void;
+    detach(item: Positioned, element: HTMLElement): void;
+    /** Places one overlay now (it moved) */
+    position(item: Positioned): void;
+    /** Places every overlay for the frame just drawn (camera, relief altitudes): all in one pass, transforms only */
+    positionAll(): void;
+    /** Removes the controls, then the canvas, the overlay and the corners from the container */
+    destroy(): void;
+}

package/dist/map/overlay-host.js

@@ -0,0 +1,101 @@
+/**
+ * What the map shows over its canvas, in its container: the markers and popups (placed after every frame) and the
+ * controls in the four corners.
+ */
+import { injectStyle } from "../ui/style.js";
+const CORNERS = ['top-left', 'top-right', 'bottom-left', 'bottom-right'];
+/** The map's container: its canvas, the element of the markers and popups over it, the corners of the controls */
+export class OverlayHost {
+    /** Canvas size in CSS pixels, kept on resize so placing overlays never reads the layout */
+    size = [0, 0];
+    container;
+    canvas;
+    /** The map the controls are added to */
+    map;
+    /** Markers and popups, over the canvas */
+    overlay;
+    corners;
+    controls = new Map();
+    positioned = new Set();
+    /** Puts the canvas, the overlay and the corners in `container` */
+    constructor(container, canvas, map) {
+        this.container = container;
+        this.canvas = canvas;
+        this.map = map;
+        // Overlays and controls are positioned against the container
+        injectStyle(container.ownerDocument);
+        if (getComputedStyle(container).position === 'static')
+            container.style.position = 'relative';
+        container.classList.add('isard-map');
+        this.overlay = document.createElement('div');
+        this.overlay.className = 'isard-overlay';
+        const corner = (position) => {
+            const element = document.createElement('div');
+            element.className = `isard-ctrl-${position}`;
+            return element;
+        };
+        this.corners = {
+            'top-left': corner('top-left'),
+            'top-right': corner('top-right'),
+            'bottom-left': corner('bottom-left'),
+            'bottom-right': corner('bottom-right'),
+        };
+        container.append(canvas, this.overlay, ...CORNERS.map((position) => this.corners[position]));
+    }
+    /** Adds a control in a corner; controls stack from the corner inward */
+    addControl(control, position) {
+        if (this.controls.has(control))
+            return;
+        const element = control.onAdd(this.map);
+        element.classList.add('isard-ctrl');
+        // In the bottom corners the first control added stays lowest, as in MapLibre
+        if (position.startsWith('bottom'))
+            this.corners[position].prepend(element);
+        else
+            this.corners[position].append(element);
+        this.controls.set(control, element);
+    }
+    removeControl(control) {
+        const element = this.controls.get(control);
+        if (!element)
+            return;
+        this.controls.delete(control);
+        control.onRemove(this.map);
+        element.remove();
+    }
+    /** Shows a marker or popup, placed after every frame from now on */
+    attach(item, element) {
+        this.overlay.append(element);
+        this.positioned.add(item);
+        item.position(this.size);
+    }
+    detach(item, element) {
+        this.positioned.delete(item);
+        element.remove();
+    }
+    /** Places one overlay now (it moved) */
+    position(item) {
+        if (this.positioned.has(item))
+            item.position(this.size);
+    }
+    /** Places every overlay for the frame just drawn (camera, relief altitudes): all in one pass, transforms only */
+    positionAll() {
+        this.positioned.forEach((item) => {
+            item.position(this.size);
+        });
+    }
+    /** Removes the controls, then the canvas, the overlay and the corners from the container */
+    destroy() {
+        [...this.controls.keys()].forEach((control) => {
+            this.removeControl(control);
+        });
+        this.positioned.clear();
+        this.canvas.remove();
+        this.overlay.remove();
+        CORNERS.forEach((position) => {
+            this.corners[position].remove();
+        });
+        this.container.classList.remove('isard-map');
+    }
+}
+//# sourceMappingURL=overlay-host.js.map

package/dist/map/overlay-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-host.js","sourceRoot":"","sources":["../../src/map/overlay-host.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What the map shows over its canvas, in its container: the markers and popups (placed after every frame) and the\n * controls in the four corners.\n */\n\nimport type { GeoMap } from '../map.ts';\nimport type { Point } from '../types.ts';\nimport type { Control, ControlPosition } from '../ui/controls.ts';\nimport type { Positioned } from '../ui/overlay.ts';\nimport { injectStyle } from '../ui/style.ts';\n\nconst CORNERS: readonly ControlPosition[] = ['top-left', 'top-right', 'bottom-left', 'bottom-right'];\n\n/** The map's container: its canvas, the element of the markers and popups over it, the corners of the controls */\nexport class OverlayHost {\n  /** Canvas size in CSS pixels, kept on resize so placing overlays never reads the layout */\n  size: Point = [0, 0];\n  private readonly container: HTMLElement;\n  private readonly canvas: HTMLCanvasElement;\n  /** The map the controls are added to */\n  private readonly map: GeoMap;\n  /** Markers and popups, over the canvas */\n  private readonly overlay: HTMLDivElement;\n  private readonly corners: Record<ControlPosition, HTMLDivElement>;\n  private readonly controls = new Map<Control, HTMLElement>();\n  private readonly positioned = new Set<Positioned>();\n\n  /** Puts the canvas, the overlay and the corners in `container` */\n  constructor(container: HTMLElement, canvas: HTMLCanvasElement, map: GeoMap) {\n    this.container = container;\n    this.canvas = canvas;\n    this.map = map;\n    // Overlays and controls are positioned against the container\n    injectStyle(container.ownerDocument);\n    if (getComputedStyle(container).position === 'static') container.style.position = 'relative';\n    container.classList.add('isard-map');\n    this.overlay = document.createElement('div');\n    this.overlay.className = 'isard-overlay';\n\n    const corner = (position: ControlPosition) => {\n      const element = document.createElement('div');\n\n      element.className = `isard-ctrl-${position}`;\n\n      return element;\n    };\n\n    this.corners = {\n      'top-left': corner('top-left'),\n      'top-right': corner('top-right'),\n      'bottom-left': corner('bottom-left'),\n      'bottom-right': corner('bottom-right'),\n    };\n    container.append(canvas, this.overlay, ...CORNERS.map((position) => this.corners[position]));\n  }\n\n  /** Adds a control in a corner; controls stack from the corner inward */\n  addControl(control: Control, position: ControlPosition): void {\n    if (this.controls.has(control)) return;\n\n    const element = control.onAdd(this.map);\n\n    element.classList.add('isard-ctrl');\n    // In the bottom corners the first control added stays lowest, as in MapLibre\n    if (position.startsWith('bottom')) this.corners[position].prepend(element);\n    else this.corners[position].append(element);\n    this.controls.set(control, element);\n  }\n\n  removeControl(control: Control): void {\n    const element = this.controls.get(control);\n\n    if (!element) return;\n    this.controls.delete(control);\n    control.onRemove(this.map);\n    element.remove();\n  }\n\n  /** Shows a marker or popup, placed after every frame from now on */\n  attach(item: Positioned, element: HTMLElement): void {\n    this.overlay.append(element);\n    this.positioned.add(item);\n    item.position(this.size);\n  }\n\n  detach(item: Positioned, element: HTMLElement): void {\n    this.positioned.delete(item);\n    element.remove();\n  }\n\n  /** Places one overlay now (it moved) */\n  position(item: Positioned): void {\n    if (this.positioned.has(item)) item.position(this.size);\n  }\n\n  /** Places every overlay for the frame just drawn (camera, relief altitudes): all in one pass, transforms only */\n  positionAll(): void {\n    this.positioned.forEach((item) => {\n      item.position(this.size);\n    });\n  }\n\n  /** Removes the controls, then the canvas, the overlay and the corners from the container */\n  destroy(): void {\n    [...this.controls.keys()].forEach((control) => {\n      this.removeControl(control);\n    });\n    this.positioned.clear();\n    this.canvas.remove();\n    this.overlay.remove();\n    CORNERS.forEach((position) => {\n      this.corners[position].remove();\n    });\n    this.container.classList.remove('isard-map');\n  }\n}\n"]}

package/dist/map/panorama-host.d.ts

@@ -0,0 +1,5 @@
+/** What the street-level panoramas need of the map: its engine, its street-level eye, its clicks, keys and wheel. */
+import type { PanoramaHost } from '../layers/panoramas.ts';
+import type { GeoMap } from '../map.ts';
+/** The panoramas' host on a map; `geoidHeight` from the class of the map's engine */
+export declare const panoramaHost: (map: GeoMap, geoidHeight: (lon: number, lat: number) => number) => PanoramaHost;

package/dist/map/panorama-host.js

@@ -0,0 +1,32 @@
+/** What the street-level panoramas need of the map: its engine, its street-level eye, its clicks, keys and wheel. */
+/** The panoramas' host on a map; `geoidHeight` from the class of the map's engine */
+export const panoramaHost = (map, geoidHeight) => ({
+    setPanorama: (...args) => {
+        map.engine.setPanorama(...args);
+        map.requestRender();
+    },
+    setPanoramaImage: (index, image) => map.engine.setPanoramaImage(index, image),
+    clearPanorama: () => map.engine.clearPanorama(),
+    geoidHeight,
+    firstPerson: () => map.firstPerson,
+    setFirstPerson: (view) => map.setFirstPerson(view),
+    elevationAt: (lonLat) => map.elevationAt(lonLat),
+    listen: (click, key, wheel) => {
+        const off = map.on('click', ({ lonLat }) => click(lonLat));
+        const container = map.getContainer();
+        // Before the map's own wheel (its zoom, the eye's field of view)
+        const onWheel = (e) => {
+            e.preventDefault();
+            e.stopImmediatePropagation();
+            wheel(e);
+        };
+        container.addEventListener('keydown', key);
+        container.addEventListener('wheel', onWheel, { capture: true, passive: false });
+        return () => {
+            off();
+            container.removeEventListener('keydown', key);
+            container.removeEventListener('wheel', onWheel, { capture: true });
+        };
+    },
+});
+//# sourceMappingURL=panorama-host.js.map

package/dist/map/panorama-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panorama-host.js","sourceRoot":"","sources":["../../src/map/panorama-host.ts"],"names":[],"mappings":"AAAA,qHAAqH;AAKrH,qFAAqF;AACrF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,WAAiD,EAAgB,EAAE,CAAC,CAAC;IAC7G,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE;QACvB,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,GAAG,CAAC,aAAa,EAAE,CAAC;IACtB,CAAC;IACD,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC;IAC7E,aAAa,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE;IAC/C,WAAW;IACX,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW;IAClC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC;IAClD,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QACrC,iEAAiE;QACjE,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE;YAChC,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,CAAC,CAAC,wBAAwB,EAAE,CAAC;YAC7B,KAAK,CAAC,CAAC,CAAC,CAAC;QACX,CAAC,CAAC;QAEF,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC3C,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhF,OAAO,GAAG,EAAE;YACV,GAAG,EAAE,CAAC;YACN,SAAS,CAAC,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC9C,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC","sourcesContent":["/** What the street-level panoramas need of the map: its engine, its street-level eye, its clicks, keys and wheel. */\n\nimport type { PanoramaHost } from '../layers/panoramas.ts';\nimport type { GeoMap } from '../map.ts';\n\n/** The panoramas' host on a map; `geoidHeight` from the class of the map's engine */\nexport const panoramaHost = (map: GeoMap, geoidHeight: (lon: number, lat: number) => number): PanoramaHost => ({\n  setPanorama: (...args) => {\n    map.engine.setPanorama(...args);\n    map.requestRender();\n  },\n  setPanoramaImage: (index, image) => map.engine.setPanoramaImage(index, image),\n  clearPanorama: () => map.engine.clearPanorama(),\n  geoidHeight,\n  firstPerson: () => map.firstPerson,\n  setFirstPerson: (view) => map.setFirstPerson(view),\n  elevationAt: (lonLat) => map.elevationAt(lonLat),\n  listen: (click, key, wheel) => {\n    const off = map.on('click', ({ lonLat }) => click(lonLat));\n    const container = map.getContainer();\n    // Before the map's own wheel (its zoom, the eye's field of view)\n    const onWheel = (e: WheelEvent) => {\n      e.preventDefault();\n      e.stopImmediatePropagation();\n      wheel(e);\n    };\n\n    container.addEventListener('keydown', key);\n    container.addEventListener('wheel', onWheel, { capture: true, passive: false });\n\n    return () => {\n      off();\n      container.removeEventListener('keydown', key);\n      container.removeEventListener('wheel', onWheel, { capture: true });\n    };\n  },\n});\n"]}

package/dist/map/raster-source.d.ts

@@ -0,0 +1,11 @@
+/** Where a raster layer's tiles come from: a PMTiles archive, Web Mercator tiles, or tiles reprojected from a grid. */
+import { type RemoteReprojection } from '../basemap/grid.ts';
+import type { RasterOptions } from '../types.ts';
+/** The loader of a raster layer's tiles (none: the engine fetches them) and its zooms, in Web Mercator levels */
+export interface RasterSource {
+    loader: RasterOptions['loader'];
+    minZoom: number;
+    maxZoom: number;
+}
+/** The loader of a raster layer's tiles and its zooms; `remote` reprojects in the workers */
+export declare const rasterSource: (options: RasterOptions, remote: RemoteReprojection) => RasterSource;

package/dist/map/raster-source.js

@@ -0,0 +1,26 @@
+/** Where a raster layer's tiles come from: a PMTiles archive, Web Mercator tiles, or tiles reprojected from a grid. */
+import { equirectangularGrid, gridLoader, gridZooms, resolveGrid } from "../basemap/grid.js";
+import { pmtilesRasterLoader } from "../basemap/pmtileslayer.js";
+/** The loader of a raster layer's tiles and its zooms; `remote` reprojects in the workers */
+export const rasterSource = (options, remote) => {
+    const { url, grid = 'mercator', size } = options;
+    const { minZoom = 0, maxZoom = 19 } = options;
+    // A PMTiles archive (`pmtiles://…`): its tiles read by range requests
+    const loader = options.loader ?? pmtilesRasterLoader(url, size ?? 256);
+    if (grid === 'mercator' || loader)
+        return { loader, minZoom, maxZoom };
+    if (grid === 'equirectangular') {
+        // `minZoom` and `maxZoom` are levels of the source: its level n has the pixel size of Mercator level n + 1 at the
+        // equator
+        const reprojected = gridLoader(url, resolveGrid(equirectangularGrid(minZoom, maxZoom)), size ?? 256, remote);
+        return { loader: reprojected, minZoom: minZoom + 1, maxZoom: maxZoom + 1 };
+    }
+    const resolved = resolveGrid(grid);
+    const zooms = gridZooms(resolved);
+    return {
+        loader: gridLoader(url, resolved, size ?? 256, remote),
+        minZoom: options.minZoom ?? zooms.minZoom,
+        maxZoom: options.maxZoom ?? zooms.maxZoom,
+    };
+};
+//# sourceMappingURL=raster-source.js.map

package/dist/map/raster-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster-source.js","sourceRoot":"","sources":["../../src/map/raster-source.ts"],"names":[],"mappings":"AAAA,uHAAuH;AAEvH,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,SAAS,EAA2B,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAUjE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAsB,EAAE,MAA0B,EAAgB,EAAE;IAC/F,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,UAAU,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAC9C,sEAAsE;IACtE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC;IAEvE,IAAI,IAAI,KAAK,UAAU,IAAI,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACvE,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,kHAAkH;QAClH,UAAU;QACV,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,IAAI,GAAG,EAAE,MAAM,CAAC,CAAC;QAE7G,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAElC,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,IAAI,GAAG,EAAE,MAAM,CAAC;QACtD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO;QACzC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO;KAC1C,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/** Where a raster layer's tiles come from: a PMTiles archive, Web Mercator tiles, or tiles reprojected from a grid. */\n\nimport { equirectangularGrid, gridLoader, gridZooms, type RemoteReprojection, resolveGrid } from '../basemap/grid.ts';\nimport { pmtilesRasterLoader } from '../basemap/pmtileslayer.ts';\nimport type { RasterOptions } from '../types.ts';\n\n/** The loader of a raster layer's tiles (none: the engine fetches them) and its zooms, in Web Mercator levels */\nexport interface RasterSource {\n  loader: RasterOptions['loader'];\n  minZoom: number;\n  maxZoom: number;\n}\n\n/** The loader of a raster layer's tiles and its zooms; `remote` reprojects in the workers */\nexport const rasterSource = (options: RasterOptions, remote: RemoteReprojection): RasterSource => {\n  const { url, grid = 'mercator', size } = options;\n  const { minZoom = 0, maxZoom = 19 } = options;\n  // A PMTiles archive (`pmtiles://…`): its tiles read by range requests\n  const loader = options.loader ?? pmtilesRasterLoader(url, size ?? 256);\n\n  if (grid === 'mercator' || loader) return { loader, minZoom, maxZoom };\n  if (grid === 'equirectangular') {\n    // `minZoom` and `maxZoom` are levels of the source: its level n has the pixel size of Mercator level n + 1 at the\n    // equator\n    const reprojected = gridLoader(url, resolveGrid(equirectangularGrid(minZoom, maxZoom)), size ?? 256, remote);\n\n    return { loader: reprojected, minZoom: minZoom + 1, maxZoom: maxZoom + 1 };\n  }\n\n  const resolved = resolveGrid(grid);\n  const zooms = gridZooms(resolved);\n\n  return {\n    loader: gridLoader(url, resolved, size ?? 256, remote),\n    minZoom: options.minZoom ?? zooms.minZoom,\n    maxZoom: options.maxZoom ?? zooms.maxZoom,\n  };\n};\n"]}

package/dist/map/symbol-atlases.d.ts

@@ -0,0 +1,26 @@
+/** The atlases of a map's symbol layers, the glyphs and the icons: created on first use, moved to each new engine. */
+import { Glyphs } from '../layers/glyphs.ts';
+import { Icons, type ImageOptions, type Pixels } from '../layers/icons.ts';
+import type { Engine } from '../wasm/isard.js';
+/** The glyphs and icons of a map */
+export declare class SymbolAtlases {
+    #private;
+    private readonly canvas;
+    private readonly glyphsUrl;
+    private readonly engine;
+    /** `canvas`: the engine's; `glyphsUrl`: the map's option; `engine`: the map's engine of the moment */
+    constructor(canvas: HTMLCanvasElement, glyphsUrl: string | undefined, engine: () => Engine);
+    /** The glyphs of the symbol layers, loaded on first use */
+    get glyphs(): Glyphs;
+    /** The icons of the symbol layers: the application's images and the vector basemaps' sprites */
+    get icons(): Icons;
+    /** An image for the icons, from its pixels or from an image; one without pixels throws */
+    addImage(name: string, image: Pixels | (CanvasImageSource & {
+        width: number;
+        height: number;
+    }), options: ImageOptions): void;
+    hasImage(name: string): boolean;
+    removeImage(name: string): void;
+    /** Uploads the atlases made so far to a new engine (after a context loss, or the one left once the map is gone) */
+    attach(engine: Engine): void;
+}

package/dist/map/symbol-atlases.js

@@ -0,0 +1,59 @@
+/** The atlases of a map's symbol layers, the glyphs and the icons: created on first use, moved to each new engine. */
+import { Glyphs } from "../layers/glyphs.js";
+import { Icons, readPixels } from "../layers/icons.js";
+/** The largest texture the canvas's WebGL context takes, undefined if unknown: the atlases stay within it */
+const maxTextureSize = (canvas) => {
+    const gl = canvas.getContext('webgl2');
+    const max = gl?.getParameter(gl.MAX_TEXTURE_SIZE);
+    return typeof max === 'number' ? max : undefined;
+};
+/** The glyphs and icons of a map */
+export class SymbolAtlases {
+    canvas;
+    glyphsUrl;
+    engine;
+    #glyphs;
+    #icons;
+    /** `canvas`: the engine's; `glyphsUrl`: the map's option; `engine`: the map's engine of the moment */
+    constructor(canvas, glyphsUrl, engine) {
+        this.canvas = canvas;
+        this.glyphsUrl = glyphsUrl;
+        this.engine = engine;
+    }
+    /** The glyphs of the symbol layers, loaded on first use */
+    get glyphs() {
+        if (!this.#glyphs) {
+            // The engine's context: the atlas stays within its texture size limit
+            this.#glyphs = new Glyphs(this.glyphsUrl, maxTextureSize(this.canvas));
+            this.#glyphs.attach(this.engine());
+        }
+        return this.#glyphs;
+    }
+    /** The icons of the symbol layers: the application's images and the vector basemaps' sprites */
+    get icons() {
+        if (!this.#icons) {
+            this.#icons = new Icons(maxTextureSize(this.canvas));
+            this.#icons.attach(this.engine());
+        }
+        return this.#icons;
+    }
+    /** An image for the icons, from its pixels or from an image; one without pixels throws */
+    addImage(name, image, options) {
+        const pixels = 'data' in image ? image : readPixels(image);
+        if (!pixels)
+            throw new Error(`isard: the image ${name} has no pixels`);
+        this.icons.add(name, pixels, options);
+    }
+    hasImage(name) {
+        return this.#icons?.has(name) ?? false;
+    }
+    removeImage(name) {
+        this.#icons?.remove(name);
+    }
+    /** Uploads the atlases made so far to a new engine (after a context loss, or the one left once the map is gone) */
+    attach(engine) {
+        this.#glyphs?.attach(engine);
+        this.#icons?.attach(engine);
+    }
+}
+//# sourceMappingURL=symbol-atlases.js.map

package/dist/map/symbol-atlases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-atlases.js","sourceRoot":"","sources":["../../src/map/symbol-atlases.ts"],"names":[],"mappings":"AAAA,sHAAsH;AAEtH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAkC,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGvF,6GAA6G;AAC7G,MAAM,cAAc,GAAG,CAAC,MAAyB,EAAsB,EAAE;IACvE,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC;IAElD,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC,CAAC;AAEF,oCAAoC;AACpC,MAAM,OAAO,aAAa;IACP,MAAM,CAAoB;IAC1B,SAAS,CAAqB;IAC9B,MAAM,CAAe;IACtC,OAAO,CAAqB;IAC5B,MAAM,CAAoB;IAE1B,sGAAsG;IACtG,YAAY,MAAyB,EAAE,SAA6B,EAAE,MAAoB;QACxF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,2DAA2D;IAC3D,IAAI,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,sEAAsE;YACtE,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACvE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,gGAAgG;IAChG,IAAI,KAAK;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,0FAA0F;IAC1F,QAAQ,CACN,IAAY,EACZ,KAAuE,EACvE,OAAqB;QAErB,MAAM,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE3D,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,gBAAgB,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,mHAAmH;IACnH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF","sourcesContent":["/** The atlases of a map's symbol layers, the glyphs and the icons: created on first use, moved to each new engine. */\n\nimport { Glyphs } from '../layers/glyphs.ts';\nimport { Icons, type ImageOptions, type Pixels, readPixels } from '../layers/icons.ts';\nimport type { Engine } from '../wasm/isard.js';\n\n/** The largest texture the canvas's WebGL context takes, undefined if unknown: the atlases stay within it */\nconst maxTextureSize = (canvas: HTMLCanvasElement): number | undefined => {\n  const gl = canvas.getContext('webgl2');\n  const max = gl?.getParameter(gl.MAX_TEXTURE_SIZE);\n\n  return typeof max === 'number' ? max : undefined;\n};\n\n/** The glyphs and icons of a map */\nexport class SymbolAtlases {\n  private readonly canvas: HTMLCanvasElement;\n  private readonly glyphsUrl: string | undefined;\n  private readonly engine: () => Engine;\n  #glyphs: Glyphs | undefined;\n  #icons: Icons | undefined;\n\n  /** `canvas`: the engine's; `glyphsUrl`: the map's option; `engine`: the map's engine of the moment */\n  constructor(canvas: HTMLCanvasElement, glyphsUrl: string | undefined, engine: () => Engine) {\n    this.canvas = canvas;\n    this.glyphsUrl = glyphsUrl;\n    this.engine = engine;\n  }\n\n  /** The glyphs of the symbol layers, loaded on first use */\n  get glyphs(): Glyphs {\n    if (!this.#glyphs) {\n      // The engine's context: the atlas stays within its texture size limit\n      this.#glyphs = new Glyphs(this.glyphsUrl, maxTextureSize(this.canvas));\n      this.#glyphs.attach(this.engine());\n    }\n\n    return this.#glyphs;\n  }\n\n  /** The icons of the symbol layers: the application's images and the vector basemaps' sprites */\n  get icons(): Icons {\n    if (!this.#icons) {\n      this.#icons = new Icons(maxTextureSize(this.canvas));\n      this.#icons.attach(this.engine());\n    }\n\n    return this.#icons;\n  }\n\n  /** An image for the icons, from its pixels or from an image; one without pixels throws */\n  addImage(\n    name: string,\n    image: Pixels | (CanvasImageSource & { width: number; height: number }),\n    options: ImageOptions,\n  ): void {\n    const pixels = 'data' in image ? image : readPixels(image);\n\n    if (!pixels) throw new Error(`isard: the image ${name} has no pixels`);\n    this.icons.add(name, pixels, options);\n  }\n\n  hasImage(name: string): boolean {\n    return this.#icons?.has(name) ?? false;\n  }\n\n  removeImage(name: string): void {\n    this.#icons?.remove(name);\n  }\n\n  /** Uploads the atlases made so far to a new engine (after a context loss, or the one left once the map is gone) */\n  attach(engine: Engine): void {\n    this.#glyphs?.attach(engine);\n    this.#icons?.attach(engine);\n  }\n}\n"]}

package/dist/map/viewshed.d.ts

@@ -0,0 +1,5 @@
+/** The viewshed's observers given to the engine, in the arrays it reads. */
+import type { ViewshedOptions } from '../types.ts';
+import type { Engine } from '../wasm/isard.js';
+/** Sets the viewshed of the engine, or clears it without observers; true if one is set (a frame to draw) */
+export declare const applyViewshed: (engine: Engine, options: ViewshedOptions | readonly ViewshedOptions[] | undefined) => boolean;

package/dist/map/viewshed.js

@@ -0,0 +1,28 @@
+/** The viewshed's observers given to the engine, in the arrays it reads. */
+import { rgb } from "../settings.js";
+/** The observers of a viewshed option: none, one, or several */
+const observersOf = (options) => {
+    if (!options)
+        return [];
+    return 'position' in options ? [options] : options;
+};
+/** Sets the viewshed of the engine, or clears it without observers; true if one is set (a frame to draw) */
+export const applyViewshed = (engine, options) => {
+    const observers = observersOf(options);
+    const [first] = observers;
+    if (!first) {
+        engine.clearViewshed();
+        return false;
+    }
+    engine.setViewshed(new Float64Array(observers.flatMap((o) => [
+        o.position[0],
+        o.position[1],
+        o.height ?? 1.7,
+        o.range ?? 1000,
+        ...(o.direction === undefined
+            ? [Number.NaN, 0, 0, 0]
+            : [o.direction, o.tilt ?? 0, o.fov ?? 60, o.verticalFov ?? 40]),
+    ])), new Float32Array(rgb(first.visibleColor ?? '#2f9e44')), new Float32Array(rgb(first.hiddenColor ?? '#e03131')), first.opacity ?? 0.7, new Float32Array(first.coneColor ? rgb(first.coneColor) : []));
+    return true;
+};
+//# sourceMappingURL=viewshed.js.map

package/dist/map/viewshed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewshed.js","sourceRoot":"","sources":["../../src/map/viewshed.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAIrC,gEAAgE;AAChE,MAAM,WAAW,GAAG,CAAC,OAAiE,EAA8B,EAAE;IACpH,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,OAAO,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACrD,CAAC,CAAC;AAEF,4GAA4G;AAC5G,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAc,EACd,OAAiE,EACxD,EAAE;IACX,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAE1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,aAAa,EAAE,CAAC;QAEvB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,WAAW,CAChB,IAAI,YAAY,CACd,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACvB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,MAAM,IAAI,GAAG;QACf,CAAC,CAAC,KAAK,IAAI,IAAI;QACf,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS;YAC3B,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;KAClE,CAAC,CACH,EACD,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC,EACtD,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,EACrD,KAAK,CAAC,OAAO,IAAI,GAAG,EACpB,IAAI,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAC9D,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC,CAAC","sourcesContent":["/** The viewshed's observers given to the engine, in the arrays it reads. */\n\nimport { rgb } from '../settings.ts';\nimport type { ViewshedOptions } from '../types.ts';\nimport type { Engine } from '../wasm/isard.js';\n\n/** The observers of a viewshed option: none, one, or several */\nconst observersOf = (options: ViewshedOptions | readonly ViewshedOptions[] | undefined): readonly ViewshedOptions[] => {\n  if (!options) return [];\n\n  return 'position' in options ? [options] : options;\n};\n\n/** Sets the viewshed of the engine, or clears it without observers; true if one is set (a frame to draw) */\nexport const applyViewshed = (\n  engine: Engine,\n  options: ViewshedOptions | readonly ViewshedOptions[] | undefined,\n): boolean => {\n  const observers = observersOf(options);\n  const [first] = observers;\n\n  if (!first) {\n    engine.clearViewshed();\n\n    return false;\n  }\n  engine.setViewshed(\n    new Float64Array(\n      observers.flatMap((o) => [\n        o.position[0],\n        o.position[1],\n        o.height ?? 1.7,\n        o.range ?? 1000,\n        ...(o.direction === undefined\n          ? [Number.NaN, 0, 0, 0]\n          : [o.direction, o.tilt ?? 0, o.fov ?? 60, o.verticalFov ?? 40]),\n      ]),\n    ),\n    new Float32Array(rgb(first.visibleColor ?? '#2f9e44')),\n    new Float32Array(rgb(first.hiddenColor ?? '#e03131')),\n    first.opacity ?? 0.7,\n    new Float32Array(first.coneColor ? rgb(first.coneColor) : []),\n  );\n\n  return true;\n};\n"]}

package/dist/map/workers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * A map's workers: the pool drawing vector tiles, shared by the map's `VectorTiles`, which also decodes the relief and
+ * reprojects rasters off the page; and the loaders of the relief, one per tile source.
+ */
+import type { RemoteReprojection } from '../basemap/grid.ts';
+import { type PngEncoding } from '../basemap/terrain.ts';
+import { BasemapWorkers } from '../basemap/workerpool.ts';
+import type { TerrainLoader } from '../settings.ts';
+import type { GeoMapOptions } from '../types.ts';
+/** The workers of a map, created on first use */
+export declare class MapWorkers {
+    /** URL of the workers' script */
+    readonly url: string | URL;
+    private readonly workers;
+    /** The map is destroyed: nothing more is sent to the workers */
+    private readonly gone;
+    /** Whose requests the workers' answer (cancelled together) */
+    private readonly owner;
+    /** The shared pool, created on first use */
+    private shared;
+    /** 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;
+    /** `workers`: the map's option (false or 0, no worker); `owner`: the map */
+    constructor(url: string | URL, workers: GeoMapOptions['workers'], gone: () => boolean, owner: object);
+    /**
+     * The workers for a `VectorTiles`: the shared pool, or a pool of its own (`own`, to stop with it) when it asks for
+     * another count or URL
+     */
+    pool(count?: number, url?: string | URL): {
+        pool: BasemapWorkers;
+        own: boolean;
+    };
+    /** Stops the shared pool */
+    terminate(): void;
+    /** Rasters reprojected by the workers (in the page without them) */
+    readonly remoteReprojection: RemoteReprojection;
+    /** The loader of the relief tiles of `url` in a PNG encoding (one per URL, encoding and floor) */
+    readonly terrainLoader: (url: string, encoding: PngEncoding, floor?: number) => TerrainLoader;
+    private readonly remoteHeights;
+    /**
+     * The workers decoding the relief and reprojecting rasters: the shared pool, unless the map has no workers
+     * (`workers: false` or 0, or none in this browser): that is done in the page then
+     */
+    private decodingPool;
+}

package/dist/map/workers.js

@@ -0,0 +1,73 @@
+/**
+ * A map's workers: the pool drawing vector tiles, shared by the map's `VectorTiles`, which also decodes the relief and
+ * reprojects rasters off the page; and the loaders of the relief, one per tile source.
+ */
+import { encodedTerrainLoader } from "../basemap/terrain.js";
+import { BasemapWorkers, defaultWorkerCount } from "../basemap/workerpool.js";
+/** The workers of a map, created on first use */
+export class MapWorkers {
+    /** URL of the workers' script */
+    url;
+    workers;
+    /** The map is destroyed: nothing more is sent to the workers */
+    gone;
+    /** Whose requests the workers' answer (cancelled together) */
+    owner;
+    /** The shared pool, created on first use */
+    shared;
+    /** 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) */
+    terrainLoaders = new Map();
+    /** `workers`: the map's option (false or 0, no worker); `owner`: the map */
+    constructor(url, workers, gone, owner) {
+        this.url = url;
+        this.workers = workers;
+        this.gone = gone;
+        this.owner = owner;
+    }
+    /**
+     * The workers for a `VectorTiles`: the shared pool, or a pool of its own (`own`, to stop with it) when it asks for
+     * another count or URL
+     */
+    pool(count, url) {
+        const shared = defaultWorkerCount();
+        const workers = Math.max(1, count ?? shared);
+        const workerUrl = url ?? this.url;
+        if (workers === shared && String(workerUrl) === String(this.url)) {
+            this.shared ??= new BasemapWorkers(shared, this.url);
+            return { pool: this.shared, own: false };
+        }
+        return { pool: new BasemapWorkers(workers, workerUrl), own: true };
+    }
+    /** Stops the shared pool */
+    terminate() {
+        this.shared?.terminate();
+        this.shared = undefined;
+    }
+    /** Rasters reprojected by the workers (in the page without them) */
+    remoteReprojection = (job, tile, signal) => this.decodingPool()?.reproject(job, tile, signal, this.owner);
+    /** The loader of the relief tiles of `url` in a PNG encoding (one per URL, encoding and floor) */
+    terrainLoader = (url, encoding, floor) => {
+        const key = `${encoding} ${floor ?? ''} ${url}`;
+        const cached = this.terrainLoaders.get(key);
+        if (cached)
+            return cached;
+        const loader = encodedTerrainLoader(url, encoding, floor, this.remoteHeights);
+        this.terrainLoaders.set(key, loader);
+        return loader;
+    };
+    remoteHeights = (url, encoding, floor, tile, signal) => this.decodingPool()?.heights(url, encoding, floor, tile, signal, this.owner);
+    /**
+     * The workers decoding the relief and reprojecting rasters: the shared pool, unless the map has no workers
+     * (`workers: false` or 0, or none in this browser): that is done in the page then
+     */
+    decodingPool() {
+        const workers = this.workers;
+        if (this.gone() || workers === false || (workers !== undefined && workers <= 0))
+            return undefined;
+        if (typeof Worker === 'undefined' || typeof OffscreenCanvas === 'undefined')
+            return undefined;
+        return this.pool().pool;
+    }
+}
+//# sourceMappingURL=workers.js.map