isard 0.2.0 → 0.3.0

package/dist/lru.js

@@ -0,0 +1,52 @@
+/**
+ * A cache keeping its most recently used entries (the decoded tiles and images of the workers, the source tiles of a
+ * reprojection, the labels of the vector tiles): a `Map` in order of use, the least recent dropped past `capacity`.
+ */
+export class Lru {
+    capacity;
+    evict;
+    entries = new Map();
+    /** `evict`: told of each entry dropped for room (not of those deleted) */
+    constructor(capacity, evict) {
+        this.capacity = capacity;
+        this.evict = evict;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    /** The value of a key, now the most recently used; undefined if absent */
+    get(key) {
+        const value = this.entries.get(key);
+        if (value !== undefined) {
+            this.entries.delete(key);
+            this.entries.set(key, value);
+        }
+        return value;
+    }
+    /** Whether a key is kept, without using it */
+    has(key) {
+        return this.entries.has(key);
+    }
+    /** Adds or replaces a value, the most recently used; drops the least recent ones past the capacity */
+    set(key, value) {
+        this.entries.delete(key);
+        this.entries.set(key, value);
+        for (const [oldest, old] of this.entries) {
+            if (this.entries.size <= this.capacity)
+                break;
+            this.entries.delete(oldest);
+            this.evict?.(old, oldest);
+        }
+    }
+    delete(key) {
+        return this.entries.delete(key);
+    }
+    /** The values, least recently used first */
+    values() {
+        return this.entries.values();
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=lru.js.map

package/dist/lru.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru.js","sourceRoot":"","sources":["../src/lru.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,GAAG;IAKL;IACU;IALF,OAAO,GAAG,IAAI,GAAG,EAAQ,CAAC;IAE3C,0EAA0E;IAC1E,YACS,QAAgB,EACN,KAAkC;QAD5C,aAAQ,GAAR,QAAQ,CAAQ;QACN,UAAK,GAAL,KAAK,CAA6B;IAClD,CAAC;IAEJ,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,0EAA0E;IAC1E,GAAG,CAAC,GAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8CAA8C;IAC9C,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,sGAAsG;IACtG,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ;gBAAE,MAAM;YAC9C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,CAAC,GAAM;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,4CAA4C;IAC5C,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["/**\n * A cache keeping its most recently used entries (the decoded tiles and images of the workers, the source tiles of a\n * reprojection, the labels of the vector tiles): a `Map` in order of use, the least recent dropped past `capacity`.\n */\nexport class Lru<K, V> {\n  private readonly entries = new Map<K, V>();\n\n  /** `evict`: told of each entry dropped for room (not of those deleted) */\n  constructor(\n    public capacity: number,\n    private readonly evict?: (value: V, key: K) => void,\n  ) {}\n\n  get size(): number {\n    return this.entries.size;\n  }\n\n  /** The value of a key, now the most recently used; undefined if absent */\n  get(key: K): V | undefined {\n    const value = this.entries.get(key);\n    if (value !== undefined) {\n      this.entries.delete(key);\n      this.entries.set(key, value);\n    }\n    return value;\n  }\n\n  /** Whether a key is kept, without using it */\n  has(key: K): boolean {\n    return this.entries.has(key);\n  }\n\n  /** Adds or replaces a value, the most recently used; drops the least recent ones past the capacity */\n  set(key: K, value: V): void {\n    this.entries.delete(key);\n    this.entries.set(key, value);\n    for (const [oldest, old] of this.entries) {\n      if (this.entries.size <= this.capacity) break;\n      this.entries.delete(oldest);\n      this.evict?.(old, oldest);\n    }\n  }\n\n  delete(key: K): boolean {\n    return this.entries.delete(key);\n  }\n\n  /** The values, least recently used first */\n  values(): IterableIterator<V> {\n    return this.entries.values();\n  }\n\n  clear(): void {\n    this.entries.clear();\n  }\n}\n"]}

package/dist/map.d.ts

@@ -6,8 +6,6 @@ import { SymbolLayer, type SymbolOptions } from './symbols.ts';
 import type { AnimationOptions, AtmosphereOptions, Basemap, FeatureHit, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, NetworkOptions, Point, Projection, RasterOptions, TerrainModel, TerrainOptions, Tiles3dOptions } from './types.ts';
 import { VectorTiles, type VectorTilesOptions } from './vectortiles.ts';
 import type { Camera, PickHit, RasterLayerStats } from './wasm/isard.js';
-/** MapLibre's default easing: cubic Bézier (0.25, 0.1, 0.25, 1) */
-export declare function defaultEasing(t: number): number;
 /** A map (see `GeoMap.create`); layers take it as their host */
 export declare class GeoMap {
     #private;
@@ -18,6 +16,8 @@ export declare class GeoMap {
     private vector;
     private readonly glyphsUrl;
     private readonly basemapWorkerUrl;
+    /** Texture size of the vector basemap's tiles */
+    private readonly basemapTileSize;
     private readonly container;
     /** Markers and popups, over the canvas */
     private readonly overlay;
@@ -58,6 +58,8 @@ export declare class GeoMap {
     private hoverPoint;
     /** Frame polling the engine for the answer of the hover picking, 0 if none */
     private hoverPoll;
+    /** Polls of the hover picking under way: given up after `MAX_POLLS` (an answer that never comes) */
+    private hoverPolls;
     /** What 'hoverfeature' looks for: within `radius` CSS pixels, in `layers` only if given */
     hoverPicking: {
         radius?: number;
@@ -76,6 +78,11 @@ export declare class GeoMap {
     private basemapPool;
     /** Stops watching the device pixel ratio */
     private unwatchRatio;
+    /** Stops listening to the canvas's context loss and restoration */
+    private readonly unwatchContext;
+    /** The loaders of the relief by encoding, URL and floor: the same loader for the same tiles (the engine keeps its
+     * tiles when only the exaggeration changes) */
+    private readonly terrainLoaders;
     /** Loads the engine (once per page) and creates a map filling `container` */
     static create(container: HTMLElement, options?: GeoMapOptions): Promise<GeoMap>;
     private constructor();
@@ -88,6 +95,9 @@ export declare class GeoMap {
     /** A 3D Tiles layer 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;
     /** After a context loss: a new engine with the same camera, settings and layers (same handles, same order) */
     private restore;
     /** Takes a layer out of the drawing order (to put it back elsewhere, or for good) */
@@ -132,8 +142,9 @@ export declare class GeoMap {
     /** Tile counters of the raster layers, for diagnostics */
     stats(): RasterLayerStats[];
     /**
-     * Network edge under a screen point (CSS pixels), undefined if none. Reads one pixel of an offscreen picking pass:
-     * cheap whatever the number of features, call it on hover.
+     * 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.
      */
     pick(point: Point, radius?: number, layers?: readonly Layer[]): PickHit | undefined;
     /**
@@ -161,8 +172,8 @@ export declare class GeoMap {
     /** Replaces the basemap and the IGN hillshade, under the other layers (hillshade by default: 0, none). The former
      * names of the Géoplateforme basemaps (`LegacyBasemap`) are taken under their new ones */
     setBasemap(basemap: Basemap, hillshade?: number): void;
-    /** Raster tiles ({z}, {x}, {y} URL; Web Mercator, or reprojected from an equirectangular `grid`), over the layers
-     * already added */
+    /** Raster tiles ({z}, {x}, {y} URL; Web Mercator, or reprojected from another `grid`: longitudes and latitudes,
+     * Lambert-93, UTM…), over the layers already added */
     addRaster(options: RasterOptions & {
         before?: Layer;
     }): RasterLayer;
@@ -188,6 +199,15 @@ export declare class GeoMap {
      * basemap.
      */
     vectorTiles(options?: VectorTilesOptions): VectorTiles;
+    /**
+     * The workers decoding the relief and reprojecting rasters: the map's pool, unless the map has no workers
+     * (`workers: false` or 0, or none in this browser): that is done in the page then
+     */
+    private decodingPool;
+    private readonly remoteHeights;
+    private readonly remoteReprojection;
+    /** The loader of the relief tiles of `url` in a PNG encoding (one per URL, encoding and floor) */
+    private readonly terrainLoader;
     /** Adds a layer, under `before` if given */
     private place;
     /** Textured meshes in 3D Tiles (photogrammetry, buildings), drawn with depth over the basemap */