isard 1.0.0 → 1.2.0

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/vectortiles.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,2BAA2B,CAAC;AAUhE,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/vectortiles.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/vectortiles.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/vectortiles.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

package/dist/map/workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.js","sourceRoot":"","sources":["../../src/map/workers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,oBAAoB,EAAwC,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAI/E,iDAAiD;AACjD,MAAM,OAAO,UAAU;IACrB,iCAAiC;IACxB,GAAG,CAAe;IACV,OAAO,CAA2B;IACnD,gEAAgE;IAC/C,IAAI,CAAgB;IACrC,8DAA8D;IAC7C,KAAK,CAAS;IAC/B,4CAA4C;IACpC,MAAM,CAA6B;IAC3C;mDAC+C;IAC9B,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEnE,4EAA4E;IAC5E,YAAY,GAAiB,EAAE,OAAiC,EAAE,IAAmB,EAAE,KAAa;QAClG,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,KAAc,EAAE,GAAkB;QACrC,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,MAAM,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QAElC,IAAI,OAAO,KAAK,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,MAAM,KAAK,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAErD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC3C,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACrE,CAAC;IAED,4BAA4B;IAC5B,SAAS;QACP,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED,oEAAoE;IAC3D,kBAAkB,GAAuB,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CACtE,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAEhE,kGAAkG;IACzF,aAAa,GAAG,CAAC,GAAW,EAAE,QAAqB,EAAE,KAAc,EAAiB,EAAE;QAC7F,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,KAAK,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE5C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAE9E,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAErC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEe,aAAa,GAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CACrF,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAE/E;;;OAGG;IACK,YAAY;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,OAAO,KAAK,KAAK,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QAClG,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,eAAe,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QAE9F,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF","sourcesContent":["/**\n * A map's workers: the pool drawing vector tiles, shared by the map's `VectorTiles`, which also decodes the relief and\n * reprojects rasters off the page; and the loaders of the relief, one per tile source.\n */\n\nimport type { RemoteReprojection } from '../basemap/grid.ts';\nimport { encodedTerrainLoader, type PngEncoding, type RemoteHeights } from '../basemap/terrain.ts';\nimport { BasemapWorkers, defaultWorkerCount } from '../basemap/vectortiles.ts';\nimport type { TerrainLoader } from '../settings.ts';\nimport type { GeoMapOptions } from '../types.ts';\n\n/** The workers of a map, created on first use */\nexport class MapWorkers {\n  /** URL of the workers' script */\n  readonly url: string | URL;\n  private readonly workers: GeoMapOptions['workers'];\n  /** The map is destroyed: nothing more is sent to the workers */\n  private readonly gone: () => boolean;\n  /** Whose requests the workers' answer (cancelled together) */\n  private readonly owner: object;\n  /** The shared pool, created on first use */\n  private shared: BasemapWorkers | undefined;\n  /** The loaders of the relief by encoding, URL and floor: the same loader for the same tiles (the engine keeps its\n   * tiles when only the exaggeration changes) */\n  private readonly terrainLoaders = new Map<string, TerrainLoader>();\n\n  /** `workers`: the map's option (false or 0, no worker); `owner`: the map */\n  constructor(url: string | URL, workers: GeoMapOptions['workers'], gone: () => boolean, owner: object) {\n    this.url = url;\n    this.workers = workers;\n    this.gone = gone;\n    this.owner = owner;\n  }\n\n  /**\n   * The workers for a `VectorTiles`: the shared pool, or a pool of its own (`own`, to stop with it) when it asks for\n   * another count or URL\n   */\n  pool(count?: number, url?: string | URL): { pool: BasemapWorkers; own: boolean } {\n    const shared = defaultWorkerCount();\n    const workers = Math.max(1, count ?? shared);\n    const workerUrl = url ?? this.url;\n\n    if (workers === shared && String(workerUrl) === String(this.url)) {\n      this.shared ??= new BasemapWorkers(shared, this.url);\n\n      return { pool: this.shared, own: false };\n    }\n\n    return { pool: new BasemapWorkers(workers, workerUrl), own: true };\n  }\n\n  /** Stops the shared pool */\n  terminate(): void {\n    this.shared?.terminate();\n    this.shared = undefined;\n  }\n\n  /** Rasters reprojected by the workers (in the page without them) */\n  readonly remoteReprojection: RemoteReprojection = (job, tile, signal) =>\n    this.decodingPool()?.reproject(job, tile, signal, this.owner);\n\n  /** The loader of the relief tiles of `url` in a PNG encoding (one per URL, encoding and floor) */\n  readonly terrainLoader = (url: string, encoding: PngEncoding, floor?: number): TerrainLoader => {\n    const key = `${encoding} ${floor ?? ''} ${url}`;\n    const cached = this.terrainLoaders.get(key);\n\n    if (cached) return cached;\n\n    const loader = encodedTerrainLoader(url, encoding, floor, this.remoteHeights);\n\n    this.terrainLoaders.set(key, loader);\n\n    return loader;\n  };\n\n  private readonly remoteHeights: RemoteHeights = (url, encoding, floor, tile, signal) =>\n    this.decodingPool()?.heights(url, encoding, floor, tile, signal, this.owner);\n\n  /**\n   * The workers decoding the relief and reprojecting rasters: the shared pool, unless the map has no workers\n   * (`workers: false` or 0, or none in this browser): that is done in the page then\n   */\n  private decodingPool(): BasemapWorkers | undefined {\n    const workers = this.workers;\n\n    if (this.gone() || workers === false || (workers !== undefined && workers <= 0)) return undefined;\n    if (typeof Worker === 'undefined' || typeof OffscreenCanvas === 'undefined') return undefined;\n\n    return this.pool().pool;\n  }\n}\n"]}