isard 1.16.0 → 2.0.0

package/dist/map/hover-pick.js

@@ -1,9 +1,29 @@
 /**
- * The picking of what is under the pointer for 'hoverfeature', without stalling the GPU: the engine is asked once the
- * frame is drawn, its answer read on a later frame, when the GPU is done.
+ * The picking of what is under a point, without stalling the GPU: the engine draws its picking pass at once, its
+ * answer is read on a later frame, when the GPU is done. For 'hoverfeature' (the latest request only) and for
+ * `map.pick` (`pickOnce`).
  */
-/** Frames the hover picking waits for its answer at most (usually one) */
+/** Frames a picking waits for its answer at most (usually one or two) */
 const MAX_POLLS = 30;
+/** What the engine finds under a point (CSS pixels), within `radius` CSS pixels, in the layers of `only` if given;
+ * undefined if it cannot pick, or no answer came in time */
+export const pickOnce = (engine, point, radius, only) => {
+    const id = engine().requestPick(point[0], point[1], radius, only);
+    if (!id)
+        return Promise.resolve(undefined);
+    return new Promise((resolve) => {
+        let polls = 0;
+        const next = () => {
+            const result = engine().pollPick(id);
+            polls += 1;
+            if (result || polls >= MAX_POLLS)
+                resolve(result);
+            else
+                requestAnimationFrame(next);
+        };
+        requestAnimationFrame(next);
+    });
+};
 /** The hover picking of a map: one request in flight at most, its answer polled frame after frame */
 export class HoverPick {
     engine;
@@ -14,6 +34,8 @@ export class HoverPick {
     poll = 0;
     /** Polls under way: given up after `MAX_POLLS` (an answer that never comes) */
     polls = 0;
+    /** The request whose answer is awaited */
+    id = 0;
     /** `engine`: the map's engine of the moment; `answer`: called with what the engine found */
     constructor(engine, lost, answer) {
         this.engine = engine;
@@ -23,12 +45,13 @@ export class HoverPick {
     /** Asks the engine what is under the pointer; its answer, read without waiting for the GPU, comes on a later frame */
     request(point, { radius = 0, layers }) {
         const only = layers && Uint32Array.from(layers.map((l) => l.id));
+        this.id = this.engine().requestPick(point[0], point[1], radius, only);
         // The engine cannot pick (no request in flight): the poll under way would wait for nothing
-        if (!this.engine().requestPick(point[0], point[1], radius, only)) {
+        if (!this.id) {
             this.cancel();
             return;
         }
-        // A new request replaces the one in flight (in the engine too): one poll loop at most
+        // A new request replaces the one awaited: one poll loop at most
         this.polls = 0;
         if (!this.poll)
             this.poll = requestAnimationFrame(this.next);
@@ -42,7 +65,7 @@ export class HoverPick {
         this.poll = 0;
         if (this.lost())
             return;
-        const result = this.engine().pollPick();
+        const result = this.engine().pollPick(this.id);
         if (!result) {
             // The GPU is not done yet (usually a frame): asked again next frame, without drawing; given up at last
             this.polls += 1;

package/dist/map/hover-pick.js.map

@@ -1 +1 @@
-{"version":3,"file":"hover-pick.js","sourceRoot":"","sources":["../../src/map/hover-pick.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,0EAA0E;AAC1E,MAAM,SAAS,GAAG,EAAE,CAAC;AAQrB,qGAAqG;AACrG,MAAM,OAAO,SAAS;IACH,MAAM,CAAe;IACtC,qDAAqD;IACpC,IAAI,CAAgB;IACpB,MAAM,CAA+B;IACtD,yDAAyD;IACjD,IAAI,GAAG,CAAC,CAAC;IACjB,+EAA+E;IACvE,KAAK,GAAG,CAAC,CAAC;IAElB,4FAA4F;IAC5F,YAAY,MAAoB,EAAE,IAAmB,EAAE,MAAoC;QACzF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,sHAAsH;IACtH,OAAO,CAAC,KAAY,EAAE,EAAE,MAAM,GAAG,CAAC,EAAE,MAAM,EAAgB;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjE,2FAA2F;QAC3F,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,MAAM,EAAE,CAAC;YAEd,OAAO;QACT,CAAC;QACD,sFAAsF;QACtF,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,mCAAmC;IACnC,MAAM;QACJ,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAChB,CAAC;IAEgB,IAAI,GAAG,GAAS,EAAE;QACjC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO;QAExB,MAAM,MAAM,GAA2B,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;QAEhE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,uGAAuG;YACvG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;YAChB,IAAI,IAAI,CAAC,KAAK,GAAG,SAAS;gBAAE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEzE,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC,CAAC;CACH","sourcesContent":["/**\n * The picking of what is under the pointer for 'hoverfeature', without stalling the GPU: the engine is asked once the\n * frame is drawn, its answer read on a later frame, when the GPU is done.\n */\n\nimport type { Layer } from '../layers/layers.ts';\nimport type { Point } from '../types.ts';\nimport type { Engine, PickResult } from '../wasm/isard.js';\n\n/** Frames the hover picking waits for its answer at most (usually one) */\nconst MAX_POLLS = 30;\n\n/** What 'hoverfeature' looks for: within `radius` CSS pixels, in `layers` only if given */\nexport interface HoverPicking {\n  radius?: number;\n  layers?: readonly Layer[];\n}\n\n/** The hover picking of a map: one request in flight at most, its answer polled frame after frame */\nexport class HoverPick {\n  private readonly engine: () => Engine;\n  /** The WebGL context is lost: no answer will come */\n  private readonly lost: () => boolean;\n  private readonly answer: (result: PickResult) => void;\n  /** Frame polling the engine for the answer, 0 if none */\n  private poll = 0;\n  /** Polls under way: given up after `MAX_POLLS` (an answer that never comes) */\n  private polls = 0;\n\n  /** `engine`: the map's engine of the moment; `answer`: called with what the engine found */\n  constructor(engine: () => Engine, lost: () => boolean, answer: (result: PickResult) => void) {\n    this.engine = engine;\n    this.lost = lost;\n    this.answer = answer;\n  }\n\n  /** Asks the engine what is under the pointer; its answer, read without waiting for the GPU, comes on a later frame */\n  request(point: Point, { radius = 0, layers }: HoverPicking): void {\n    const only = layers && Uint32Array.from(layers.map((l) => l.id));\n\n    // The engine cannot pick (no request in flight): the poll under way would wait for nothing\n    if (!this.engine().requestPick(point[0], point[1], radius, only)) {\n      this.cancel();\n\n      return;\n    }\n    // A new request replaces the one in flight (in the engine too): one poll loop at most\n    this.polls = 0;\n    if (!this.poll) this.poll = requestAnimationFrame(this.next);\n  }\n\n  /** Stops waiting for the answer */\n  cancel(): void {\n    cancelAnimationFrame(this.poll);\n    this.poll = 0;\n  }\n\n  private readonly next = (): void => {\n    this.poll = 0;\n    if (this.lost()) return;\n\n    const result: PickResult | undefined = this.engine().pollPick();\n\n    if (!result) {\n      // The GPU is not done yet (usually a frame): asked again next frame, without drawing; given up at last\n      this.polls += 1;\n      if (this.polls < MAX_POLLS) this.poll = requestAnimationFrame(this.next);\n\n      return;\n    }\n    this.answer(result);\n  };\n}\n"]}
+{"version":3,"file":"hover-pick.js","sourceRoot":"","sources":["../../src/map/hover-pick.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The picking of what is under a point, without stalling the GPU: the engine draws its picking pass at once, its\n * answer is read on a later frame, when the GPU is done. For 'hoverfeature' (the latest request only) and for\n * `map.pick` (`pickOnce`).\n */\n\nimport type { Layer } from '../layers/layers.ts';\nimport type { Point } from '../types.ts';\nimport type { Engine, PickResult } from '../wasm/isard_webgpu.js';\n\n/** Frames a picking waits for its answer at most (usually one or two) */\nconst MAX_POLLS = 30;\n\n/** What the engine finds under a point (CSS pixels), within `radius` CSS pixels, in the layers of `only` if given;\n * undefined if it cannot pick, or no answer came in time */\nexport const pickOnce = (\n  engine: () => Engine,\n  point: Point,\n  radius: number,\n  only: Uint32Array | undefined,\n): Promise<PickResult | undefined> => {\n  const id = engine().requestPick(point[0], point[1], radius, only);\n\n  if (!id) return Promise.resolve(undefined);\n\n  return new Promise((resolve) => {\n    let polls = 0;\n    const next = () => {\n      const result: PickResult | undefined = engine().pollPick(id);\n\n      polls += 1;\n      if (result || polls >= MAX_POLLS) resolve(result);\n      else requestAnimationFrame(next);\n    };\n\n    requestAnimationFrame(next);\n  });\n};\n\n/** What 'hoverfeature' looks for: within `radius` CSS pixels, in `layers` only if given */\nexport interface HoverPicking {\n  radius?: number;\n  layers?: readonly Layer[];\n}\n\n/** The hover picking of a map: one request in flight at most, its answer polled frame after frame */\nexport class HoverPick {\n  private readonly engine: () => Engine;\n  /** The WebGL context is lost: no answer will come */\n  private readonly lost: () => boolean;\n  private readonly answer: (result: PickResult) => void;\n  /** Frame polling the engine for the answer, 0 if none */\n  private poll = 0;\n  /** Polls under way: given up after `MAX_POLLS` (an answer that never comes) */\n  private polls = 0;\n  /** The request whose answer is awaited */\n  private id = 0;\n\n  /** `engine`: the map's engine of the moment; `answer`: called with what the engine found */\n  constructor(engine: () => Engine, lost: () => boolean, answer: (result: PickResult) => void) {\n    this.engine = engine;\n    this.lost = lost;\n    this.answer = answer;\n  }\n\n  /** Asks the engine what is under the pointer; its answer, read without waiting for the GPU, comes on a later frame */\n  request(point: Point, { radius = 0, layers }: HoverPicking): void {\n    const only = layers && Uint32Array.from(layers.map((l) => l.id));\n\n    this.id = this.engine().requestPick(point[0], point[1], radius, only);\n    // The engine cannot pick (no request in flight): the poll under way would wait for nothing\n    if (!this.id) {\n      this.cancel();\n\n      return;\n    }\n    // A new request replaces the one awaited: one poll loop at most\n    this.polls = 0;\n    if (!this.poll) this.poll = requestAnimationFrame(this.next);\n  }\n\n  /** Stops waiting for the answer */\n  cancel(): void {\n    cancelAnimationFrame(this.poll);\n    this.poll = 0;\n  }\n\n  private readonly next = (): void => {\n    this.poll = 0;\n    if (this.lost()) return;\n\n    const result: PickResult | undefined = this.engine().pollPick(this.id);\n\n    if (!result) {\n      // The GPU is not done yet (usually a frame): asked again next frame, without drawing; given up at last\n      this.polls += 1;\n      if (this.polls < MAX_POLLS) this.poll = requestAnimationFrame(this.next);\n\n      return;\n    }\n    this.answer(result);\n  };\n}\n"]}

package/dist/map/layer-stack.d.ts

@@ -3,7 +3,7 @@
  * in the order but not in the engine yet, and the order recreates the layers in a new engine after a context loss.
  */
 import type { Layer } from '../layers/layers.ts';
-import type { Engine } from '../wasm/isard.js';
+import type { Engine } from '../wasm/isard_webgpu.js';
 /** A map's layers in drawing order, bottom first, and those kept on top */
 export declare class LayerStack {
     /** Layers in drawing order (bottom first), to recreate them after a context loss */
@@ -26,7 +26,7 @@ export declare class LayerStack {
     toBottom(layer: Layer): void;
     /** 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: Engine, waiting: (layer: Layer) => boolean): void;
+    reattach(engine: Engine): void;
     /** Frees what the layers hold beside the engine (custom layers' WebGL objects, models' data) */
     dispose(): void;
     /** Takes a layer out of the drawing order (to put it back elsewhere, or for good) */

package/dist/map/layer-stack.js

@@ -54,14 +54,12 @@ export class LayerStack {
     }
     /** 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) {
+    reattach(engine) {
         // 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);
             }

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

@@ -1 +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"]}
+{"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_webgpu.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): 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      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/symbol-atlases.d.ts

@@ -1,15 +1,16 @@
 /** 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';
+import type { Engine } from '../wasm/isard_webgpu.js';
 /** The glyphs and icons of a map */
 export declare class SymbolAtlases {
     #private;
-    private readonly canvas;
+    private readonly maxSize;
     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);
+    /** `maxSize`: the largest texture the engine takes (undefined if unknown); `glyphsUrl`: the map's option; `engine`:
+     * the map's engine of the moment */
+    constructor(maxSize: () => number | undefined, 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 */

package/dist/map/symbol-atlases.js

@@ -1,30 +1,25 @@
 /** 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;
+    maxSize;
     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;
+    /** `maxSize`: the largest texture the engine takes (undefined if unknown); `glyphsUrl`: the map's option; `engine`:
+     * the map's engine of the moment */
+    constructor(maxSize, glyphsUrl, engine) {
+        this.maxSize = maxSize;
         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));
+            // The engine's device: the atlas stays within its texture size limit
+            this.#glyphs = new Glyphs(this.glyphsUrl, this.maxSize());
             this.#glyphs.attach(this.engine());
         }
         return this.#glyphs;
@@ -32,7 +27,7 @@ export class SymbolAtlases {
     /** 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 = new Icons(this.maxSize());
             this.#icons.attach(this.engine());
         }
         return this.#icons;

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

@@ -1 +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"]}
+{"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,oCAAoC;AACpC,MAAM,OAAO,aAAa;IACP,OAAO,CAA2B;IAClC,SAAS,CAAqB;IAC9B,MAAM,CAAe;IACtC,OAAO,CAAqB;IAC5B,MAAM,CAAoB;IAE1B;wCACoC;IACpC,YAAY,OAAiC,EAAE,SAA6B,EAAE,MAAoB;QAChG,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,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,qEAAqE;YACrE,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,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,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACxC,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_webgpu.js';\n\n/** The glyphs and icons of a map */\nexport class SymbolAtlases {\n  private readonly maxSize: () => number | undefined;\n  private readonly glyphsUrl: string | undefined;\n  private readonly engine: () => Engine;\n  #glyphs: Glyphs | undefined;\n  #icons: Icons | undefined;\n\n  /** `maxSize`: the largest texture the engine takes (undefined if unknown); `glyphsUrl`: the map's option; `engine`:\n   * the map's engine of the moment */\n  constructor(maxSize: () => number | undefined, glyphsUrl: string | undefined, engine: () => Engine) {\n    this.maxSize = maxSize;\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 device: the atlas stays within its texture size limit\n      this.#glyphs = new Glyphs(this.glyphsUrl, this.maxSize());\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(this.maxSize());\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

@@ -1,5 +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';
+import type { Engine } from '../wasm/isard_webgpu.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.map

@@ -1 +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"]}
+{"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_webgpu.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.d.ts

@@ -26,14 +26,15 @@ import { Tiles3dLayer } from './layers/tiles3d.ts';
 import { type TreeOptions } from './layers/trees.ts';
 import { type HoverPicking } from './map/hover-pick.ts';
 import { type LayerSpec } from './map/layer-spec.ts';
-import type { AnimationOptions, AtmosphereOptions, Basemap, FeatureHit, FirstPersonView, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, NetworkOptions, PickOptions, Point, Projection, Quality, RasterOptions, SunOptions, SwipeOptions, TerrainModel, TerrainOptions, Tiles3dOptions, ViewshedOptions } from './types.ts';
+import type { AnimationOptions, AtmosphereOptions, Basemap, FeatureHit, FirstPersonView, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, MapGpuTimings, NetworkOptions, PickOptions, Point, Projection, Quality, RasterOptions, SunOptions, SwipeOptions, TerrainModel, TerrainOptions, Tiles3dOptions, ViewshedOptions } from './types.ts';
 import { type Control, type ControlPosition } from './ui/controls.ts';
-import type { Camera, PickHit, RasterLayerStats } from './wasm/isard.js';
+import type { Camera, PickHit, RasterLayerStats } from './wasm/isard_webgpu.js';
 export type { LayerSpec } from './map/layer-spec.ts';
-/** A map (see `GeoMap.create`); layers take it as their host */
 export declare class GeoMap {
     #private;
     readonly canvas: HTMLCanvasElement;
+    /** The frames' parts timed on the GPU (`setGpuTiming`), again on a new engine */
+    private gpuTiming;
     /** The engine class (core, or with 3D Tiles) and the engine with 3D Tiles loaded when needed */
     private readonly engines;
     /** The layers in drawing order and those kept on top */
@@ -84,13 +85,6 @@ export declare class GeoMap {
     private get layers();
     /** Layers new layers go under */
     private get onTop();
-    private createEngine;
-    /** A 3D Tiles layer or a model on the core engine: loads the engine with 3D Tiles, then rebuilds the map on it
-     * (camera, settings and layers kept, as after a context loss); the layer is created then */
-    private upgrade;
-    /** Downloads and compiles the engine with 3D Tiles once the map is idle (`tiles3d: 'preload'`), without running
-     * it: the first 3D Tiles layer then only instantiates it */
-    private preloadTiles3d;
     /**
      * The context is lost: its engine freed at once, the map's calls going to one that does nothing until `restore`
      * builds the next. The old engine's GPU objects went with the context: deleted now, it is silent (on the context
@@ -98,8 +92,12 @@ export declare class GeoMap {
      * would fail on the lost context, whose limits read 0
      */
     private dropLostEngine;
-    /** After a context loss: a new engine with the same camera, settings and layers (same handles, same order) */
+    /** After a context loss: a new engine with the same camera, settings and layers (same handles, same order); the
+     * engine made asynchronously, adopted once there */
     private restore;
+    /** A new engine in place of the map's (a placeholder, or a lost one): the same camera, settings and layers (same
+     * handles, same order) */
+    private adopt;
     /** The street-level eye, if the camera is one */
     get firstPerson(): Readonly<Required<FirstPersonView>> | undefined;
     /**
@@ -182,18 +180,25 @@ export declare class GeoMap {
     setBackground(color: string): void;
     /** Tile counters of the raster layers, for diagnostics */
     stats(): RasterLayerStats[];
+    /** Times the parts of each frame on the GPU, for profiling (`gpuTimings`): timer queries, read a few frames later.
+     * An engine built to profile only (`PROFILE=1 bun run build`); false without one, or if the browser cannot
+     * (`EXT_disjoint_timer_query_webgl2`) */
+    setGpuTiming(on: boolean): boolean;
+    /** The GPU time of the last frame measured (`setGpuTiming`), in all and by part: the backdrop, the ground (the raster
+     * layers over the relief), each layer, the shadows, the panorama, the viewshed (ms) */
+    gpuTimings(): MapGpuTimings | undefined;
     /**
-     * The feature under a screen point (CSS pixels), undefined if none: its layer id and index. Reads one pixel of an
-     * offscreen picking pass, whatever the number of features, but waits for the GPU to finish the frame (a stall): for
-     * clicks and one-off queries. On hover, listen to 'hoverfeature' instead, which picks without waiting.
+     * The feature under a screen point (CSS pixels), undefined if none: its layer id and index. Reads the pixels around
+     * the point of an offscreen picking pass, whatever the number of features, once the GPU is done (a frame or two
+     * later: the GPU is not waited for). On hover, listen to 'hoverfeature' instead.
      */
-    pick(point: Point, { radius, layers }?: PickOptions): PickHit | undefined;
+    pick(point: Point, { radius, layers }?: PickOptions): Promise<PickHit | undefined>;
     /**
      * The feature under a screen point (CSS pixels), or the nearest one within `radius` pixels: its layer handle, its
      * index there and, for line, circle and fill layers, the feature itself; undefined if none. `layers` restricts the
      * search to some layers (the others hide nothing).
      */
-    pickFeature(point: Point, options?: PickOptions): FeatureHit | undefined;
+    pickFeature(point: Point, options?: PickOptions): Promise<FeatureHit | undefined>;
     /** A hit with its layer handle and feature; undefined if the layer is gone */
     private featureHit;
     /** Screen point (CSS pixels) of a position on the ground (the relief), or `height` metres above it, undefined
@@ -220,15 +225,16 @@ export declare class GeoMap {
      * where it starts, a roof or a mesh as the relief (on by default), or around the screen center */
     setRotateAroundPointer(enabled: boolean): void;
     /** What is drawn under a screen point (CSS pixels), on the relief or standing on it (a roof, a wall, a mesh): its
-     * position and its height above the relief, in metres; undefined where nothing was drawn. The last frame's scene is
-     * drawn again and read back, waiting for the GPU (a stall): for clicks and drags */
+     * position and its height above the relief, in metres; undefined where nothing was drawn. Read from the last copy of
+     * the scene's depth (a frame or two old, a pixel every 4 CSS pixels): at once, without waiting for the GPU */
     pickSurface(point: Point): {
         lonLat: LonLat;
         height: number;
     } | undefined;
     /** The height above the relief, in metres, of the top of what stands at a position: a roof, a mesh, 0 on the bare
-     * ground; undefined where nothing of the last frame is there. The scene is drawn from above into a single pixel and
-     * read back: cheap, but it waits for the GPU */
+     * ground; undefined where nothing of the last frame is there, or until measured: the scene is drawn looking down at
+     * it after a frame and read back a frame or two later, the answer kept and measured again every 250 ms at most (ask
+     * again on the next `render` event) */
     surfaceAt(lonLat: LonLat): number | undefined;
     /** Adds a control in a corner of the map; controls stack from the corner inward */
     addControl(control: Control, position?: ControlPosition): this;