isard 1.0.0 → 1.2.0

package/dist/map/basemap-layers.js

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

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

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

package/dist/map/canvas.d.ts

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

package/dist/map/canvas.js

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

package/dist/map/canvas.js.map

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

package/dist/map/checks.d.ts

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

package/dist/map/checks.js

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

package/dist/map/checks.js.map

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

package/dist/map/credits.d.ts

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

package/dist/map/credits.js

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

package/dist/map/credits.js.map

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

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

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

package/dist/map/engine-settings.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-settings.js","sourceRoot":"","sources":["../../src/map/engine-settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAE7C,OAAO,EAAoB,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,GAAG,EAGH,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAIxB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,OAAsB,EACtB,KAAc,EACd,aAAoF,EAC1E,EAAE;IACZ,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACxD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,KAAK,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,KAAK,OAAO;QAClD,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI;QACxB,UAAU,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC;QAClD,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC;QACnF,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,WAAW;QACvC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACtE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;KAC1D,CAAC;AACJ,CAAC,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,QAAkB,EAAQ,EAAE;IACxE,wDAAwD;IACxD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;IAEtE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;IACjE,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAEnC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;IAE3G,MAAM,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,CAAC;IAClC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/G,MAAM,CAAC,mBAAmB,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC;IACpD,MAAM,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC,CAAC;IACpC,MAAM,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,uGAAuG;AACvG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,KAAkB,EAAQ,EAAE;IACtE,MAAM,CAAC,iBAAiB,CACtB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAC/B,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EACrE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAC/D,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * The settings of the map's engine: made from the options, given to each new engine (at creation, and again after a\n * context loss or once the engine with 3D Tiles is loaded), with the page's request headers.\n */\n\nimport { SEA } from '../basemap/basemaps.ts';\nimport type { PngEncoding } from '../basemap/terrain.ts';\nimport { type HeaderRules, headerRules } from '../engine/requests.ts';\nimport {\n  atmosphereSettings,\n  bodySettings,\n  haloSettings,\n  rgb,\n  type Settings,\n  type TerrainLoader,\n  terrainSettings,\n} from '../settings.ts';\nimport type { GeoMapOptions } from '../types.ts';\nimport type { Engine } from '../wasm/isard.js';\n\n/** The settings of a map from its options; `earth`: the map is of the Earth */\nexport const mapSettings = (\n  options: GeoMapOptions,\n  earth: boolean,\n  terrainLoader: (url: string, encoding: PngEncoding, floor?: number) => TerrainLoader,\n): Settings => {\n  const body = bodySettings(options.body);\n\n  return {\n    body,\n    zoomRange: [options.minZoom ?? 0, options.maxZoom ?? 22],\n    maxPitch: options.maxPitch ?? 70,\n    globe: (options.projection ?? 'globe') === 'globe',\n    sky: options.sky ?? true,\n    atmosphere: atmosphereSettings(options.atmosphere),\n    terrain: terrainSettings(options.terrain, options.body, body.radius, terrainLoader),\n    loading: options.loading ?? 'immediate',\n    background: rgb(options.background ?? (earth ? '#f2f2f0' : '#000000')),\n    globeColor: earth ? SEA['osm-positron'] : rgb(body.color),\n  };\n};\n\n/** Gives a new engine the settings and the page's request headers */\nexport const applySettings = (engine: Engine, settings: Settings): void => {\n  // The body first: the layers' shaders may take its size\n  const { radius, flattening, atmosphere: air, relief } = settings.body;\n\n  engine.setBody(radius, flattening, haloSettings(air), ...relief);\n  sendHeaders(engine, headerRules());\n\n  const { zoomRange, maxPitch, globe, sky, atmosphere, terrain, loading, background, globeColor } = settings;\n\n  engine.setZoomRange(...zoomRange);\n  engine.setMaxPitch(maxPitch);\n  engine.setGlobe(globe);\n  engine.setSky(sky);\n  engine.setAtmosphere(atmosphere);\n  engine.setTerrain(terrain?.url, terrain?.exaggeration ?? 1, terrain?.maxZoom, terrain?.geoid, terrain?.loader);\n  engine.setImmediateLoading(loading === 'immediate');\n  engine.setBackground(...background);\n  engine.setGlobeColor(...globeColor);\n};\n\n/** The page's request headers to an engine (its own requests: raster tiles, tilesets, point clouds) */\nexport const sendHeaders = (engine: Engine, rules: HeaderRules): void => {\n  engine.setRequestHeaders(\n    rules.map(([prefix]) => prefix),\n    Uint32Array.from(rules, ([, headers]) => Object.keys(headers).length),\n    rules.flatMap(([, headers]) => Object.entries(headers).flat()),\n  );\n};\n"]}

package/dist/map/engines.d.ts

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

package/dist/map/engines.js

@@ -0,0 +1,77 @@
+/**
+ * Which engine a map runs: the core one, or the one with 3D Tiles, from the start or loaded once a layer needs it
+ * (the map is rebuilt on it then); and the workers decoding its 3D Tiles, started with the first engine that has them.
+ */
+import { engineUrl, loadFullEngineLater, preloadFullEngine, startTileLoader, } from "../engine-loader.js";
+import { applySettings } from "./engine-settings.js";
+/** The engine class of a map, and the engine with 3D Tiles loaded when needed */
+export class MapEngines {
+    /** The class of the engine: without 3D Tiles until a 3D Tiles layer is added, unless asked for from the start */
+    engineClass;
+    /** The module of the engine with 3D Tiles once it runs the map (the decoding workers run it too) */
+    module;
+    #upgrading;
+    loader;
+    options;
+    /** The map is destroyed: a loaded engine is not used */
+    gone;
+    /** `module`: the module of the engine with 3D Tiles if `engineClass` is that engine */
+    constructor(engineClass, module, options, gone) {
+        this.engineClass = engineClass;
+        this.module = module;
+        this.options = { ...options };
+        this.gone = gone;
+    }
+    /** The engine with 3D Tiles runs the map */
+    get tiles3d() {
+        return this.module !== undefined;
+    }
+    /** The engine with 3D Tiles is loading, for the 3D Tiles layers added on the core engine */
+    get upgrading() {
+        return this.#upgrading;
+    }
+    /** A new engine drawing on `canvas`, with the settings and the decoding workers of 3D Tiles if it has them */
+    create(canvas, redraw, settings) {
+        const engine = new this.engineClass(canvas, redraw);
+        applySettings(engine, settings);
+        // The decoding workers of 3D Tiles, with the engine that has them (they run its module) and unless turned off
+        this.loader ??= this.module && startTileLoader(this.module, this.options, engine);
+        if (this.loader)
+            engine.setTileLoader(this.loader);
+        return engine;
+    }
+    /** Height of the geoid above the ellipsoid at a position, in metres */
+    geoidHeight(lon, lat) {
+        return this.engineClass.geoidHeight(lon, lat);
+    }
+    /** The matrix of a custom layer's model at a position */
+    customMatrix(lon, lat, altitude) {
+        return this.engineClass.customMatrix(lon, lat, altitude);
+    }
+    /** Loads the engine with 3D Tiles, once at a time: `loaded` once it is the map's class, `failed` with the error;
+     * neither if the map is gone by then */
+    upgrade(loaded, failed) {
+        this.#upgrading ??= loadFullEngineLater(engineUrl('full', this.options)).then(({ module, Engine }) => {
+            this.#upgrading = undefined;
+            if (this.gone())
+                return;
+            this.engineClass = Engine;
+            this.module = module;
+            loaded();
+        }, (error) => {
+            this.#upgrading = undefined;
+            if (this.gone())
+                return;
+            failed(error);
+        });
+    }
+    /** Downloads and compiles the engine with 3D Tiles without running it, unless the map is gone or has it by then */
+    preload() {
+        preloadFullEngine(engineUrl('full', this.options), () => !this.gone() && !this.module);
+    }
+    /** Stops the decoding workers */
+    destroy() {
+        this.loader?.destroy();
+    }
+}
+//# sourceMappingURL=engines.js.map

package/dist/map/engines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engines.js","sourceRoot":"","sources":["../../src/map/engines.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Which engine a map runs: the core one, or the one with 3D Tiles, from the start or loaded once a layer needs it\n * (the map is rebuilt on it then); and the workers decoding its 3D Tiles, started with the first engine that has them.\n */\n\nimport type { TileLoader } from '../engine/loader.ts';\nimport {\n  type EngineClass,\n  engineUrl,\n  loadFullEngineLater,\n  preloadFullEngine,\n  startTileLoader,\n} from '../engine-loader.ts';\nimport type { Settings } from '../settings.ts';\nimport type { GeoMapOptions } from '../types.ts';\nimport type { Engine } from '../wasm/isard.js';\nimport { applySettings } from './engine-settings.ts';\n\n/** What loading the engine with 3D Tiles and its workers needs */\nexport type Tiles3dEngineOptions = Pick<\n  GeoMapOptions,\n  'wasmUrl' | 'workers' | 'workerUrl' | 'decoders' | 'pointsWasmUrl' | 'assetsUrl'\n>;\n\n/** The engine class of a map, and the engine with 3D Tiles loaded when needed */\nexport class MapEngines {\n  /** The class of the engine: without 3D Tiles until a 3D Tiles layer is added, unless asked for from the start */\n  private engineClass: EngineClass;\n  /** The module of the engine with 3D Tiles once it runs the map (the decoding workers run it too) */\n  private module: WebAssembly.Module | undefined;\n  #upgrading: Promise<void> | undefined;\n  private loader: TileLoader | undefined;\n  private readonly options: Tiles3dEngineOptions;\n  /** The map is destroyed: a loaded engine is not used */\n  private readonly gone: () => boolean;\n\n  /** `module`: the module of the engine with 3D Tiles if `engineClass` is that engine */\n  constructor(\n    engineClass: EngineClass,\n    module: WebAssembly.Module | undefined,\n    options: Tiles3dEngineOptions,\n    gone: () => boolean,\n  ) {\n    this.engineClass = engineClass;\n    this.module = module;\n    this.options = { ...options };\n    this.gone = gone;\n  }\n\n  /** The engine with 3D Tiles runs the map */\n  get tiles3d(): boolean {\n    return this.module !== undefined;\n  }\n\n  /** The engine with 3D Tiles is loading, for the 3D Tiles layers added on the core engine */\n  get upgrading(): Promise<void> | undefined {\n    return this.#upgrading;\n  }\n\n  /** A new engine drawing on `canvas`, with the settings and the decoding workers of 3D Tiles if it has them */\n  create(canvas: HTMLCanvasElement, redraw: () => void, settings: Settings): Engine {\n    const engine = new this.engineClass(canvas, redraw);\n\n    applySettings(engine, settings);\n    // The decoding workers of 3D Tiles, with the engine that has them (they run its module) and unless turned off\n    this.loader ??= this.module && startTileLoader(this.module, this.options, engine);\n    if (this.loader) engine.setTileLoader(this.loader);\n\n    return engine;\n  }\n\n  /** Height of the geoid above the ellipsoid at a position, in metres */\n  geoidHeight(lon: number, lat: number): number {\n    return this.engineClass.geoidHeight(lon, lat);\n  }\n\n  /** The matrix of a custom layer's model at a position */\n  customMatrix(lon: number, lat: number, altitude: number): Float32Array | undefined {\n    return this.engineClass.customMatrix(lon, lat, altitude);\n  }\n\n  /** Loads the engine with 3D Tiles, once at a time: `loaded` once it is the map's class, `failed` with the error;\n   * neither if the map is gone by then */\n  upgrade(loaded: () => void, failed: (error: unknown) => void): void {\n    this.#upgrading ??= loadFullEngineLater(engineUrl('full', this.options)).then(\n      ({ module, Engine }) => {\n        this.#upgrading = undefined;\n        if (this.gone()) return;\n        this.engineClass = Engine;\n        this.module = module;\n        loaded();\n      },\n      (error: unknown) => {\n        this.#upgrading = undefined;\n        if (this.gone()) return;\n        failed(error);\n      },\n    );\n  }\n\n  /** Downloads and compiles the engine with 3D Tiles without running it, unless the map is gone or has it by then */\n  preload(): void {\n    preloadFullEngine(engineUrl('full', this.options), () => !this.gone() && !this.module);\n  }\n\n  /** Stops the decoding workers */\n  destroy(): void {\n    this.loader?.destroy();\n  }\n}\n"]}

package/dist/map/events.d.ts

@@ -0,0 +1,14 @@
+/** The listeners of the map's events: added, called, cleared with the map. */
+import type { MapEvents } from '../types.ts';
+/** The listeners of the map's events, by type */
+export declare class MapListeners {
+    private readonly listeners;
+    /** Listens to an event; returns the function that stops listening */
+    on<K extends keyof MapEvents>(type: K, listener: (event: MapEvents[K]) => void): () => void;
+    /** Calls the listeners; one that throws is reported and does not stop the others nor the frame */
+    emit<K extends keyof MapEvents>(type: K, event: MapEvents[K]): void;
+    /** Something listens to `type` */
+    has(type: keyof MapEvents): boolean;
+    /** Forgets every listener */
+    clear(): void;
+}

package/dist/map/events.js

@@ -0,0 +1,46 @@
+/** The listeners of the map's events: added, called, cleared with the map. */
+import { report } from "./checks.js";
+/** The listeners of the map's events, by type */
+export class MapListeners {
+    listeners = {
+        movestart: new Set(),
+        move: new Set(),
+        moveend: new Set(),
+        resize: new Set(),
+        hover: new Set(),
+        hoverfeature: new Set(),
+        click: new Set(),
+        render: new Set(),
+        idle: new Set(),
+        leave: new Set(),
+    };
+    /** Listens to an event; returns the function that stops listening */
+    on(type, listener) {
+        const listeners = this.listeners[type];
+        listeners.add(listener);
+        return () => listeners.delete(listener);
+    }
+    /** Calls the listeners; one that throws is reported and does not stop the others nor the frame */
+    emit(type, event) {
+        const listeners = this.listeners[type];
+        listeners.forEach((listener) => {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                report(error);
+            }
+        });
+    }
+    /** Something listens to `type` */
+    has(type) {
+        return this.listeners[type].size > 0;
+    }
+    /** Forgets every listener */
+    clear() {
+        Object.values(this.listeners).forEach((listeners) => {
+            listeners.clear();
+        });
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/map/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/map/events.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAG9E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,iDAAiD;AACjD,MAAM,OAAO,YAAY;IACN,SAAS,GAAc;QACtC,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,KAAK,EAAE,IAAI,GAAG,EAAE;KACjB,CAAC;IAEF,qEAAqE;IACrE,EAAE,CAA4B,IAAO,EAAE,QAAuC;QAC5E,MAAM,SAAS,GAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE3E,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAExB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,kGAAkG;IAClG,IAAI,CAA4B,IAAO,EAAE,KAAmB;QAC1D,MAAM,SAAS,GAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE3E,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7B,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;IAClC,GAAG,CAAC,IAAqB;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,6BAA6B;IAC7B,KAAK;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YAClD,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["/** The listeners of the map's events: added, called, cleared with the map. */\n\nimport type { MapEvents } from '../types.ts';\nimport { report } from './checks.ts';\n\ntype Listeners = { [K in keyof MapEvents]: Set<(event: MapEvents[K]) => void> };\n\n/** The listeners of the map's events, by type */\nexport class MapListeners {\n  private readonly listeners: Listeners = {\n    movestart: new Set(),\n    move: new Set(),\n    moveend: new Set(),\n    resize: new Set(),\n    hover: new Set(),\n    hoverfeature: new Set(),\n    click: new Set(),\n    render: new Set(),\n    idle: new Set(),\n    leave: new Set(),\n  };\n\n  /** Listens to an event; returns the function that stops listening */\n  on<K extends keyof MapEvents>(type: K, listener: (event: MapEvents[K]) => void): () => void {\n    const listeners: Set<(event: MapEvents[K]) => void> = this.listeners[type];\n\n    listeners.add(listener);\n\n    return () => listeners.delete(listener);\n  }\n\n  /** Calls the listeners; one that throws is reported and does not stop the others nor the frame */\n  emit<K extends keyof MapEvents>(type: K, event: MapEvents[K]): void {\n    const listeners: Set<(event: MapEvents[K]) => void> = this.listeners[type];\n\n    listeners.forEach((listener) => {\n      try {\n        listener(event);\n      } catch (error) {\n        report(error);\n      }\n    });\n  }\n\n  /** Something listens to `type` */\n  has(type: keyof MapEvents): boolean {\n    return this.listeners[type].size > 0;\n  }\n\n  /** Forgets every listener */\n  clear(): void {\n    Object.values(this.listeners).forEach((listeners) => {\n      listeners.clear();\n    });\n  }\n}\n"]}

package/dist/map/frame-loop.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The frame loop of a map: frames drawn on demand only (an idle map costs nothing), the running animation stepped in
+ * each, and the events of a frame sent with it: the camera's moves, the pointer's position (coalesced to one per
+ * frame, so the values computed for it are drawn in the same frame), 'render', and 'idle' once everything is loaded.
+ */
+import type { Point } from '../types.ts';
+import type { Step } from '../util/animation.ts';
+import type { Camera, Engine } from '../wasm/isard.js';
+import type { MapListeners } from './events.ts';
+/** What the frame loop needs of its map */
+export interface FrameHost {
+    /** The map's engine of the moment */
+    engine(): Engine;
+    /** The map's camera */
+    camera(): Camera;
+    /** The WebGL context is lost: nothing is drawn */
+    lost(): boolean;
+    /** The pointer or the keys are moving the camera: no 'moveend' yet */
+    interacting(): boolean;
+    /** Custom layers are drawn: they read the camera of the frame */
+    customLayers(): boolean;
+    /** The engine with 3D Tiles is loading: not idle */
+    upgrading(): boolean;
+    /** The frame is drawn: what follows it (the overlays placed, the hover picking asked for at `hovered`) */
+    drawn(hovered: Point | undefined): void;
+}
+/** The frames of a map, asked for and drawn */
+export declare class FrameLoop {
+    #private;
+    private readonly host;
+    private readonly listeners;
+    /** Frame asked for, 0 if none */
+    private requested;
+    private inFrame;
+    private animation;
+    /** The pointer's position for the next frame */
+    private hoverPoint;
+    private lastCamera;
+    /** The camera moved since the last 'moveend' */
+    private moving;
+    /** `listeners`: the map's, told of the frame's events */
+    constructor(host: FrameHost, listeners: MapListeners);
+    /** The last frame found everything loaded ('idle' sent) */
+    get settled(): boolean;
+    /** The camera of the frame being drawn: what `getCamera` gives the custom layers while the engine is busy */
+    get camera(): Camera | undefined;
+    /** Asks for a frame; several calls before the next frame draw it once */
+    request(): void;
+    /** Runs `step` every frame until it returns false; replaces the running animation */
+    animate(step: Step | undefined): void;
+    /** The pointer's position for the next frame (undefined: none) */
+    hover(point: Point | undefined): void;
+    /** Draws a frame now, in place of the one asked for (a resized canvas is cleared: waiting one frame would flash) */
+    drawNow(): void;
+    /** Cancels the frame asked for (the context is lost); a new one can be asked for */
+    cancel(): void;
+    /** Cancels the frame asked for, for good (the map is destroyed): it stays marked as asked for */
+    stop(): void;
+    private frame;
+    private draw;
+}