isard 0.2.1 → 0.3.0

package/dist/kml.js

@@ -0,0 +1,159 @@
+import { child, children, childText, descendants, parseXml } from "./xml.js";
+/** Positions of a `coordinates` element: `lon,lat[,alt]` tuples separated by spaces */
+function positions(element) {
+    const out = [];
+    for (const tuple of (element?.text ?? '').trim().split(/\s+/)) {
+        const values = tuple.split(',').map(Number);
+        if (values.length >= 2 && values.every(Number.isFinite))
+            out.push(values);
+    }
+    return out;
+}
+/** The geometries of an element (a Placemark, a MultiGeometry), in order */
+function geometries(parent) {
+    const out = [];
+    for (const g of parent.children) {
+        if (g.name === 'Point') {
+            const [p] = positions(child(g, 'coordinates'));
+            if (p)
+                out.push({ type: 'Point', coordinates: p });
+        }
+        else if (g.name === 'LineString' || g.name === 'LinearRing') {
+            const line = positions(child(g, 'coordinates'));
+            if (line.length >= 2)
+                out.push({ type: 'LineString', coordinates: line });
+        }
+        else if (g.name === 'Polygon') {
+            const ring = (b) => positions(child(child(b, 'LinearRing'), 'coordinates'));
+            const outer = child(g, 'outerBoundaryIs');
+            const rings = [...(outer ? [ring(outer)] : []), ...children(g, 'innerBoundaryIs').map(ring)];
+            if ((rings[0]?.length ?? 0) >= 4)
+                out.push({ type: 'Polygon', coordinates: rings.filter((r) => r.length >= 4) });
+        }
+        else if (g.name === 'Track') {
+            // gx:Track: its gx:coord, `lon lat alt`
+            const line = children(g, 'coord')
+                .map((c) => c.text.trim().split(/\s+/).map(Number))
+                .filter((p) => p.length >= 2 && p.every(Number.isFinite));
+            if (line.length >= 2)
+                out.push({ type: 'LineString', coordinates: line });
+        }
+        else if (g.name === 'MultiGeometry' || g.name === 'MultiTrack') {
+            out.push(...geometries(g));
+        }
+    }
+    return out;
+}
+/** One geometry of several: a Multi… of one type, else a collection */
+function merge(list) {
+    const [first] = list;
+    if (!first)
+        return null;
+    if (list.length === 1)
+        return first;
+    const same = list.every((g) => g.type === first.type);
+    if (same && first.type === 'Point') {
+        return { type: 'MultiPoint', coordinates: list.map((g) => g.coordinates) };
+    }
+    if (same && first.type === 'LineString') {
+        return { type: 'MultiLineString', coordinates: list.map((g) => g.coordinates) };
+    }
+    if (same && first.type === 'Polygon') {
+        return { type: 'MultiPolygon', coordinates: list.map((g) => g.coordinates) };
+    }
+    return { type: 'GeometryCollection', geometries: list };
+}
+/** A KML color (`aabbggrr`, hexadecimal) as a CSS color and an opacity */
+function color(element) {
+    const value = childText(element, 'color')?.replace(/^#/, '');
+    if (!value || !/^[\da-f]{8}$/i.test(value))
+        return undefined;
+    const [a, b, g, r] = [0, 2, 4, 6].map((i) => value.slice(i, i + 2));
+    return [`#${r}${g}${b}`.toLowerCase(), Math.round((Number.parseInt(a, 16) / 255) * 1000) / 1000];
+}
+/** The properties of a style (simplestyle's names, as togeojson): stroke, stroke-opacity, stroke-width, fill,
+ * fill-opacity, marker-color */
+function styleProperties(style) {
+    const out = {};
+    if (!style)
+        return out;
+    const line = child(style, 'LineStyle');
+    const stroke = color(line);
+    if (stroke)
+        [out.stroke, out['stroke-opacity']] = stroke;
+    const width = Number(childText(line, 'width'));
+    if (childText(line, 'width') !== undefined && Number.isFinite(width))
+        out['stroke-width'] = width;
+    const poly = child(style, 'PolyStyle');
+    const fill = color(poly);
+    if (fill)
+        [out.fill, out['fill-opacity']] = fill;
+    if (childText(poly, 'fill') === '0')
+        out['fill-opacity'] = 0;
+    if (childText(poly, 'outline') === '0')
+        out['stroke-opacity'] = 0;
+    const icon = color(child(style, 'IconStyle'));
+    if (icon)
+        out['marker-color'] = icon[0];
+    return out;
+}
+/**
+ * The placemarks of a KML document as GeoJSON features: their points, lines (and gx:Track), polygons (with their
+ * holes) and MultiGeometry (a Multi… of one type, else a GeometryCollection); their `name`, `description`, extended
+ * data (`Data`, `SimpleData`) as properties, and the colors of their style (inline, or shared through `styleUrl` and
+ * `StyleMap`) as `stroke`, `stroke-opacity`, `stroke-width`, `fill`, `fill-opacity`, `marker-color`. A placemark
+ * without geometry has a null one
+ */
+export function parseKml(text) {
+    const root = parseXml(text);
+    const styles = new Map();
+    for (const s of descendants(root, 'Style'))
+        if (s.attributes.id)
+            styles.set(s.attributes.id, s);
+    const maps = new Map();
+    for (const m of descendants(root, 'StyleMap')) {
+        const normal = children(m, 'Pair').find((p) => childText(p, 'key') === 'normal');
+        const url = childText(normal, 'styleUrl');
+        if (m.attributes.id && url)
+            maps.set(m.attributes.id, url);
+    }
+    /** The style of a `styleUrl` in this document (`#id`, through a StyleMap) */
+    const shared = (url, depth = 0) => {
+        const id = url?.slice(url.indexOf('#') + 1);
+        if (id === undefined || depth > 4)
+            return undefined;
+        return styles.get(id) ?? shared(maps.get(id), depth + 1);
+    };
+    const features = descendants(root, 'Placemark').map((placemark) => {
+        const properties = { ...styleProperties(shared(childText(placemark, 'styleUrl'))) };
+        Object.assign(properties, styleProperties(child(placemark, 'Style')));
+        for (const key of ['name', 'description', 'address', 'styleUrl']) {
+            const value = childText(placemark, key);
+            if (value !== undefined)
+                properties[key] = value;
+        }
+        const time = childText(child(placemark, 'TimeStamp'), 'when');
+        if (time !== undefined)
+            properties.time = time;
+        const extended = child(placemark, 'ExtendedData');
+        for (const data of children(extended, 'Data')) {
+            if (data.attributes.name)
+                properties[data.attributes.name] = childText(data, 'value') ?? '';
+        }
+        for (const schema of children(extended, 'SchemaData')) {
+            for (const data of children(schema, 'SimpleData')) {
+                if (data.attributes.name)
+                    properties[data.attributes.name] = data.text.trim();
+            }
+        }
+        const id = placemark.attributes.id;
+        return {
+            type: 'Feature',
+            geometry: merge(geometries(placemark)),
+            properties: properties,
+            ...(id === undefined ? {} : { id }),
+        };
+    });
+    return { type: 'FeatureCollection', features };
+}
+//# sourceMappingURL=kml.js.map

package/dist/kml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kml.js","sourceRoot":"","sources":["../src/kml.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * KML to GeoJSON, for the feature layers: `map.addLines({ data: parseKml(await (await fetch(url)).text()) })`.\n */\nimport type { Feature, FeatureCollection, Geometry, Position, Properties } from './features.ts';\nimport { child, children, childText, descendants, parseXml, type XmlElement } from './xml.ts';\n\n/** Positions of a `coordinates` element: `lon,lat[,alt]` tuples separated by spaces */\nfunction positions(element: XmlElement | undefined): Position[] {\n  const out: Position[] = [];\n  for (const tuple of (element?.text ?? '').trim().split(/\\s+/)) {\n    const values = tuple.split(',').map(Number);\n    if (values.length >= 2 && values.every(Number.isFinite)) out.push(values as Position);\n  }\n  return out;\n}\n\n/** The geometries of an element (a Placemark, a MultiGeometry), in order */\nfunction geometries(parent: XmlElement): Geometry[] {\n  const out: Geometry[] = [];\n  for (const g of parent.children) {\n    if (g.name === 'Point') {\n      const [p] = positions(child(g, 'coordinates'));\n      if (p) out.push({ type: 'Point', coordinates: p });\n    } else if (g.name === 'LineString' || g.name === 'LinearRing') {\n      const line = positions(child(g, 'coordinates'));\n      if (line.length >= 2) out.push({ type: 'LineString', coordinates: line });\n    } else if (g.name === 'Polygon') {\n      const ring = (b: XmlElement) => positions(child(child(b, 'LinearRing'), 'coordinates'));\n      const outer = child(g, 'outerBoundaryIs');\n      const rings = [...(outer ? [ring(outer)] : []), ...children(g, 'innerBoundaryIs').map(ring)];\n      if ((rings[0]?.length ?? 0) >= 4) out.push({ type: 'Polygon', coordinates: rings.filter((r) => r.length >= 4) });\n    } else if (g.name === 'Track') {\n      // gx:Track: its gx:coord, `lon lat alt`\n      const line = children(g, 'coord')\n        .map((c) => c.text.trim().split(/\\s+/).map(Number))\n        .filter((p) => p.length >= 2 && p.every(Number.isFinite)) as Position[];\n      if (line.length >= 2) out.push({ type: 'LineString', coordinates: line });\n    } else if (g.name === 'MultiGeometry' || g.name === 'MultiTrack') {\n      out.push(...geometries(g));\n    }\n  }\n  return out;\n}\n\n/** One geometry of several: a Multi… of one type, else a collection */\nfunction merge(list: Geometry[]): Geometry | null {\n  const [first] = list;\n  if (!first) return null;\n  if (list.length === 1) return first;\n  const same = list.every((g) => g.type === first.type);\n  if (same && first.type === 'Point') {\n    return { type: 'MultiPoint', coordinates: list.map((g) => (g as { coordinates: Position }).coordinates) };\n  }\n  if (same && first.type === 'LineString') {\n    return { type: 'MultiLineString', coordinates: list.map((g) => (g as { coordinates: Position[] }).coordinates) };\n  }\n  if (same && first.type === 'Polygon') {\n    return { type: 'MultiPolygon', coordinates: list.map((g) => (g as { coordinates: Position[][] }).coordinates) };\n  }\n  return { type: 'GeometryCollection', geometries: list };\n}\n\n/** A KML color (`aabbggrr`, hexadecimal) as a CSS color and an opacity */\nfunction color(element: XmlElement | undefined): [css: string, opacity: number] | undefined {\n  const value = childText(element, 'color')?.replace(/^#/, '');\n  if (!value || !/^[\\da-f]{8}$/i.test(value)) return undefined;\n  const [a, b, g, r] = [0, 2, 4, 6].map((i) => value.slice(i, i + 2));\n  return [`#${r}${g}${b}`.toLowerCase(), Math.round((Number.parseInt(a as string, 16) / 255) * 1000) / 1000];\n}\n\n/** The properties of a style (simplestyle's names, as togeojson): stroke, stroke-opacity, stroke-width, fill,\n * fill-opacity, marker-color */\nfunction styleProperties(style: XmlElement | undefined): Properties {\n  const out: Properties = {};\n  if (!style) return out;\n  const line = child(style, 'LineStyle');\n  const stroke = color(line);\n  if (stroke) [out.stroke, out['stroke-opacity']] = stroke;\n  const width = Number(childText(line, 'width'));\n  if (childText(line, 'width') !== undefined && Number.isFinite(width)) out['stroke-width'] = width;\n  const poly = child(style, 'PolyStyle');\n  const fill = color(poly);\n  if (fill) [out.fill, out['fill-opacity']] = fill;\n  if (childText(poly, 'fill') === '0') out['fill-opacity'] = 0;\n  if (childText(poly, 'outline') === '0') out['stroke-opacity'] = 0;\n  const icon = color(child(style, 'IconStyle'));\n  if (icon) out['marker-color'] = icon[0];\n  return out;\n}\n\n/**\n * The placemarks of a KML document as GeoJSON features: their points, lines (and gx:Track), polygons (with their\n * holes) and MultiGeometry (a Multi… of one type, else a GeometryCollection); their `name`, `description`, extended\n * data (`Data`, `SimpleData`) as properties, and the colors of their style (inline, or shared through `styleUrl` and\n * `StyleMap`) as `stroke`, `stroke-opacity`, `stroke-width`, `fill`, `fill-opacity`, `marker-color`. A placemark\n * without geometry has a null one\n */\nexport function parseKml<P = Properties>(text: string): FeatureCollection<P> {\n  const root = parseXml(text);\n  const styles = new Map<string, XmlElement>();\n  for (const s of descendants(root, 'Style')) if (s.attributes.id) styles.set(s.attributes.id, s);\n  const maps = new Map<string, string>();\n  for (const m of descendants(root, 'StyleMap')) {\n    const normal = children(m, 'Pair').find((p) => childText(p, 'key') === 'normal');\n    const url = childText(normal, 'styleUrl');\n    if (m.attributes.id && url) maps.set(m.attributes.id, url);\n  }\n  /** The style of a `styleUrl` in this document (`#id`, through a StyleMap) */\n  const shared = (url: string | undefined, depth = 0): XmlElement | undefined => {\n    const id = url?.slice(url.indexOf('#') + 1);\n    if (id === undefined || depth > 4) return undefined;\n    return styles.get(id) ?? shared(maps.get(id), depth + 1);\n  };\n  const features = descendants(root, 'Placemark').map((placemark): Feature<P> => {\n    const properties: Properties = { ...styleProperties(shared(childText(placemark, 'styleUrl'))) };\n    Object.assign(properties, styleProperties(child(placemark, 'Style')));\n    for (const key of ['name', 'description', 'address', 'styleUrl']) {\n      const value = childText(placemark, key);\n      if (value !== undefined) properties[key] = value;\n    }\n    const time = childText(child(placemark, 'TimeStamp'), 'when');\n    if (time !== undefined) properties.time = time;\n    const extended = child(placemark, 'ExtendedData');\n    for (const data of children(extended, 'Data')) {\n      if (data.attributes.name) properties[data.attributes.name] = childText(data, 'value') ?? '';\n    }\n    for (const schema of children(extended, 'SchemaData')) {\n      for (const data of children(schema, 'SimpleData')) {\n        if (data.attributes.name) properties[data.attributes.name] = data.text.trim();\n      }\n    }\n    const id = placemark.attributes.id;\n    return {\n      type: 'Feature',\n      geometry: merge(geometries(placemark)),\n      properties: properties as P,\n      ...(id === undefined ? {} : { id }),\n    };\n  });\n  return { type: 'FeatureCollection', features };\n}\n"]}

package/dist/layers.d.ts

@@ -64,7 +64,7 @@ export interface GroundTexture {
 export interface GroundOptions {
     /**
      * GLSL ES 3.0 defining `vec4 ground(vec2 offset)`: the color of the ground (premultiplied alpha, 0 for nothing) at
-     * `offset`, the Mercator offset of the pixel from `anchor` (times `ISARD_EARTH`: metres of EPSG:3857), exact to
+     * `offset`, the Mercator offset of the pixel from `anchor` (times `ISARD_CIRCUMFERENCE`: metres of EPSG:3857), exact to
      * the millimetre at any zoom. The code declares its own uniforms and samplers; also there: `u_zoom`,
      * `u_pixel_ratio`
      */

package/dist/layers.js

@@ -3,6 +3,7 @@
  * the map recreates its engine and every layer in order, with the same handle (its id is updated).
  */
 import { parseColor, rampTexels, stops } from "./features.js";
+import { mercatorX, mercatorY, toMercator } from "./geo.js";
 export class Layer {
     #id = -1;
     /** @internal */
@@ -120,7 +121,7 @@ export class NetworkLayer extends Layer {
         }
         else {
             // Mercator here: Math.tan and Math.log run natively, several times faster than in WebAssembly
-            mercator = { nodes: toMercator(nodes), lines: lines && toMercator(lines.points) };
+            mercator = { nodes: mercatorPoints(nodes), lines: lines && mercatorPoints(lines.points) };
             const origin = [mercator.nodes[0] ?? 0, mercator.nodes[1] ?? 0];
             this.kept = {
                 origin,
@@ -172,14 +173,12 @@ function unpack(points, [ox, oy]) {
     }
     return out;
 }
-const MAX_LAT = 85.051128779806589;
 /** Longitudes and latitudes (degrees, interleaved) to Mercator [0, 1], y towards the south */
-function toMercator(lonLat) {
+function mercatorPoints(lonLat) {
     const out = new Float64Array(lonLat.length);
     for (let i = 0; i < lonLat.length; i += 2) {
-        const lat = (Math.max(-MAX_LAT, Math.min(MAX_LAT, lonLat[i + 1] ?? 0)) * Math.PI) / 180;
-        out[i] = ((lonLat[i] ?? 0) + 180) / 360;
-        out[i + 1] = 0.5 - Math.log(Math.tan(Math.PI / 4 + lat / 2)) / (2 * Math.PI);
+        out[i] = mercatorX(lonLat[i] ?? 0);
+        out[i + 1] = mercatorY(lonLat[i + 1] ?? 0);
     }
     return out;
 }
@@ -267,7 +266,7 @@ export class GroundLayer extends Layer {
     }
     /** @internal */
     create(engine) {
-        const [ax, ay] = mercatorPoint(this.options.anchor);
+        const [ax, ay] = toMercator(this.options.anchor);
         const id = engine.addGround(this.options.code, ax, ay, ...mercatorBox(this.options.bounds ?? [-180, -85.06, 180, 85.06]));
         for (const [name, texture] of this.textures)
             this.sendTexture(engine, id, name, texture);
@@ -277,14 +276,10 @@ export class GroundLayer extends Layer {
         return id;
     }
 }
-function mercatorPoint([lon, lat]) {
-    const out = toMercator(Float64Array.of(lon, lat));
-    return [out[0] ?? 0, out[1] ?? 0];
-}
 /** A lon/lat box to Mercator min x, min y, max x, max y (y towards the south) */
 function mercatorBox([west, south, east, north]) {
-    const [x0, y1] = mercatorPoint([west, south]);
-    const [x1, y0] = mercatorPoint([east, north]);
+    const [x0, y1] = toMercator([west, south]);
+    const [x1, y0] = toMercator([east, north]);
     return [x0, y0, x1, y1];
 }
 //# sourceMappingURL=layers.js.map

package/dist/layers.js.map

@@ -1 +1 @@
-{"version":3,"file":"layers.js","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Handles of the layers added to a map. Each one keeps what it needs to be created again: after a WebGL context loss,\n * the map recreates its engine and every layer in order, with the same handle (its id is updated).\n */\nimport { parseColor, rampTexels, stops } from './features.ts';\nimport type {\n  LayerHost,\n  LonLat,\n  NetworkOptions,\n  NetworkStyle,\n  RasterOptions,\n  RasterStyle,\n  Tiles3dStyle,\n} from './types.ts';\nimport type { Engine, NetworkStats, Tiles3dStats } from './wasm/isard.js';\n\nexport abstract class Layer {\n  #id = -1;\n\n  /** @internal */\n  protected readonly map: LayerHost;\n\n  /** @internal */\n  constructor(map: LayerHost) {\n    this.map = map;\n  }\n\n  /** Id of the layer in the engine */\n  get id(): number {\n    return this.#id;\n  }\n\n  /** @internal Creates the layer in an engine (again after a context loss); its id is -1 if that fails */\n  attach(engine: Engine): void {\n    this.#id = -1;\n    this.#id = this.create(engine);\n  }\n\n  /** @internal Forgets its id in an engine that is gone (before the layers are created in a new one) */\n  forgetEngine(): void {\n    this.#id = -1;\n  }\n\n  /** @internal Sends what refers to other layers, once every layer of a new engine has its id */\n  relink(_engine: Engine): void {}\n\n  /** @internal */\n  protected abstract create(engine: Engine): number;\n\n  remove(): void {\n    // Not created yet: a 3D Tiles layer waiting for the engine with 3D Tiles\n    if (this.#id >= 0) this.map.engine.removeLayer(this.#id);\n    this.#id = -1;\n    this.map.detach(this);\n    this.map.requestRender();\n  }\n\n  /** Moves the layer under `other`, or on top of every layer (above the labels of a vector basemap too) */\n  moveBefore(other: Layer | undefined): void {\n    this.map.moveLayer(this, other);\n  }\n}\n\n/** Raster tiles (basemaps, overlays) */\nexport class RasterLayer extends Layer {\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly options: Required<Omit<RasterOptions, 'size' | 'loader' | 'grid' | 'attribution'>> & {\n      size: number | undefined;\n      loader: RasterOptions['loader'] | undefined;\n    },\n  ) {\n    super(map);\n  }\n\n  /** Changes the opacity or saturation, the other kept */\n  setStyle(style: Partial<RasterStyle>): void;\n  /** @deprecated Positional form (saturation back to 1 when not given): `setStyle({ opacity, saturation })` */\n  setStyle(opacity: number, saturation?: number): void;\n  setStyle(style: Partial<RasterStyle> | number, saturation = 1): void {\n    const changed = typeof style === 'number' ? { opacity: style, saturation } : style;\n    this.options.opacity = changed.opacity ?? this.options.opacity;\n    this.options.saturation = changed.saturation ?? this.options.saturation;\n    this.map.engine.setRasterStyle(this.id, this.options.opacity, this.options.saturation);\n    this.map.requestRender();\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const { url, minZoom, maxZoom, opacity, saturation, size, loader } = this.options;\n    return engine.addRaster(url, minZoom, maxZoom, opacity, saturation, size, loader);\n  }\n}\n\n/** Line network colored by a value per node (travel time, water depth…) */\nexport class NetworkLayer extends Layer {\n  private values: Float32Array | undefined;\n  /** Node and line positions in Mercator, kept for a context loss: f32 offsets from an origin (exact to the centimetre\n   * across a region, half the memory of f64) */\n  private kept: { origin: [number, number]; nodes: Float32Array; lines: Float32Array | undefined } | undefined;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private geometry: { nodes: Float64Array; edges: Uint32Array; lines: NetworkOptions['lines'] | undefined },\n    private costs: Float32Array | undefined,\n    private style: NetworkStyle,\n    private edgeWidths: Float32Array | undefined,\n  ) {\n    super(map);\n  }\n\n  /** One value per node, in node order; negative (or 1e30 and above) = unreached. Costs one texture upload, drawn\n   * next frame. */\n  setValues(values: Float32Array): void {\n    this.values = values;\n    this.map.engine.setNetworkValues(this.id, values);\n    this.map.requestRender();\n  }\n\n  /** Costs of the edges, A → B then B → A (see `NetworkOptions.costs`), when the way the network is travelled\n   * changes; undefined: values interpolated along the edges. The geometry stays on the graphics card. */\n  setCosts(costs: Float32Array | undefined): void {\n    this.costs = costs;\n    this.map.engine.setNetworkCosts(this.id, costs);\n    this.map.requestRender();\n  }\n\n  setStyle(style: Partial<NetworkStyle>): void {\n    const ramp = this.style.ramp;\n    this.style = { ...this.style, ...style };\n    this.map.engine.setNetworkStyle(this.id, networkStyle(this.style));\n    if (this.style.ramp !== ramp)\n      this.map.engine.setNetworkRamp(this.id, this.style.ramp && rampTexels(this.style.ramp).rgba);\n    this.map.requestRender();\n  }\n\n  /** Width factor of each edge (undefined: 1 for all) */\n  setEdgeWidths(widths: Float32Array | undefined): void {\n    this.edgeWidths = widths;\n    this.map.engine.setNetworkScales(this.id, widths);\n    this.map.requestRender();\n  }\n\n  /** Pieces in all and drawn in the last frame */\n  stats(): NetworkStats | undefined {\n    return this.map.engine.networkStats(this.id);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const { nodes, edges, lines } = this.geometry;\n    let mercator: { nodes: Float64Array; lines: Float64Array | undefined };\n    if (this.kept) {\n      const { origin, nodes: n, lines: l } = this.kept;\n      mercator = { nodes: unpack(n, origin), lines: l && unpack(l, origin) };\n    } else {\n      // Mercator here: Math.tan and Math.log run natively, several times faster than in WebAssembly\n      mercator = { nodes: toMercator(nodes), lines: lines && toMercator(lines.points) };\n      const origin: [number, number] = [mercator.nodes[0] ?? 0, mercator.nodes[1] ?? 0];\n      this.kept = {\n        origin,\n        nodes: pack(mercator.nodes, origin),\n        lines: mercator.lines && pack(mercator.lines, origin),\n      };\n      // The degrees are not needed again: millions of points for a region\n      this.geometry = { nodes: EMPTY, edges, lines: lines && { start: lines.start, points: EMPTY } };\n    }\n    const id = engine.addNetwork(\n      mercator.nodes,\n      edges,\n      lines?.start,\n      mercator.lines,\n      this.costs,\n      networkStyle(this.style),\n    );\n    if (this.style.ramp) engine.setNetworkRamp(id, rampTexels(this.style.ramp).rgba);\n    if (this.edgeWidths) engine.setNetworkScales(id, this.edgeWidths);\n    if (this.values) engine.setNetworkValues(id, this.values);\n    return id;\n  }\n}\n\n/** The 25 numbers of a network style for the engine */\nfunction networkStyle(style: NetworkStyle): Float32Array {\n  const { width, halo, max, contour, opacity, haloOpacity, unreachedColor, fade } = style;\n  return Float32Array.from([\n    ...stops(width),\n    ...stops(halo),\n    max,\n    contour,\n    opacity,\n    haloOpacity,\n    ...parseColor(unreachedColor),\n    fade,\n  ]);\n}\n\nconst EMPTY = new Float64Array(0);\n\n/** Interleaved points as f32 offsets from an origin, and back */\nfunction pack(points: Float64Array, [ox, oy]: [number, number]): Float32Array {\n  const out = new Float32Array(points.length);\n  for (let i = 0; i < points.length; i += 2) {\n    out[i] = (points[i] ?? 0) - ox;\n    out[i + 1] = (points[i + 1] ?? 0) - oy;\n  }\n  return out;\n}\n\nfunction unpack(points: Float32Array, [ox, oy]: [number, number]): Float64Array {\n  const out = new Float64Array(points.length);\n  for (let i = 0; i < points.length; i += 2) {\n    out[i] = (points[i] ?? 0) + ox;\n    out[i + 1] = (points[i + 1] ?? 0) + oy;\n  }\n  return out;\n}\n\nconst MAX_LAT = 85.051128779806589;\n\n/** Longitudes and latitudes (degrees, interleaved) to Mercator [0, 1], y towards the south */\nfunction toMercator(lonLat: Float64Array): Float64Array {\n  const out = new Float64Array(lonLat.length);\n  for (let i = 0; i < lonLat.length; i += 2) {\n    const lat = (Math.max(-MAX_LAT, Math.min(MAX_LAT, lonLat[i + 1] ?? 0)) * Math.PI) / 180;\n    out[i] = ((lonLat[i] ?? 0) + 180) / 360;\n    out[i + 1] = 0.5 - Math.log(Math.tan(Math.PI / 4 + lat / 2)) / (2 * Math.PI);\n  }\n  return out;\n}\n\n/** Textured meshes in 3D Tiles */\nexport class Tiles3dLayer extends Layer {\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly url: string,\n    private style: Tiles3dStyle,\n  ) {\n    super(map);\n  }\n\n  setStyle(style: Partial<Tiles3dStyle>): void {\n    this.style = { ...this.style, ...style };\n    // Kept for its creation while the engine with 3D Tiles loads\n    if (this.id < 0) return;\n    this.map.engine.setTiles3dStyle(this.id, this.style.maxScreenSpaceError, this.style.opacity);\n    this.map.requestRender();\n  }\n\n  /** Loading counters; undefined once the layer is removed, and while the engine with 3D Tiles loads (see\n   * `GeoMapOptions.tiles3d`) */\n  stats(): Tiles3dStats | undefined {\n    return this.id < 0 ? undefined : this.map.engine.tiles3dStats(this.id);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const id = engine.addTiles3d(this.url, this.style.maxScreenSpaceError);\n    engine.setTiles3dStyle(id, this.style.maxScreenSpaceError, this.style.opacity);\n    return id;\n  }\n}\n\n/** A texture of a ground layer (see `GroundLayer`) */\nexport interface GroundTexture {\n  /** `r8`, `r8ui`, `r16ui`, `r16i`, `r32ui`, `r32f`, `rg16ui`, `rg32f`, `rgba8`, `rgba8ui`, `rgba16ui`, `rgba32f`:\n   * integer formats are read with `usampler2D` / `isampler2D` and `texelFetch` */\n  format: string;\n  width: number;\n  height: number;\n  /** Layers of a 2D array (`sampler2DArray`, `usampler2DArray`…); 0 or undefined: a 2D texture */\n  depth?: number;\n  /** Linear filtering (non-integer formats); default nearest */\n  linear?: boolean;\n  /** Texels row after row (layer after layer), any typed array; undefined: left empty */\n  data?: ArrayBufferView;\n}\n\nexport interface GroundOptions {\n  /**\n   * GLSL ES 3.0 defining `vec4 ground(vec2 offset)`: the color of the ground (premultiplied alpha, 0 for nothing) at\n   * `offset`, the Mercator offset of the pixel from `anchor` (times `ISARD_EARTH`: metres of EPSG:3857), exact to\n   * the millimetre at any zoom. The code declares its own uniforms and samplers; also there: `u_zoom`,\n   * `u_pixel_ratio`\n   */\n  code: string;\n  /** Where the offsets are taken from */\n  anchor: LonLat;\n  /** Box it shows in, `[west, south, east, north]` (default the world): only the ground there is drawn again */\n  bounds?: [west: number, south: number, east: number, north: number];\n  textures?: Record<string, GroundTexture>;\n  uniforms?: Record<string, number | readonly number[]>;\n}\n\nconst bytesOf = (data: ArrayBufferView) => new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n\n/** The application's fragment shader run over the ground, draped on the relief (water depth, heat maps…) */\nexport class GroundLayer extends Layer {\n  private readonly textures = new Map<string, GroundTexture>();\n  private readonly uniforms = new Map<string, number[]>();\n  private visible = true;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly options: GroundOptions,\n  ) {\n    super(map);\n    for (const [name, texture] of Object.entries(options.textures ?? {})) this.textures.set(name, texture);\n    for (const [name, value] of Object.entries(options.uniforms ?? {})) this.uniforms.set(name, [value].flat());\n  }\n\n  /** Creates or replaces a texture of the code's sampler `name` */\n  setTexture(name: string, texture: GroundTexture): void {\n    this.textures.set(name, texture);\n    this.sendTexture(this.map.engine, this.id, name, texture);\n    this.map.requestRender();\n  }\n\n  /**\n   * Replaces a region of a texture: `data` holds `width` × `height` texels for (`x`, `y`) of `layer` (2D arrays).\n   * Keep the texture's own `data` up to date too if it must survive a WebGL context loss.\n   */\n  updateTexture(\n    name: string,\n    data: ArrayBufferView,\n    region: { x?: number; y?: number; layer?: number; width: number; height: number },\n  ): void {\n    const { x = 0, y = 0, layer = 0, width, height } = region;\n    this.map.engine.updateGroundTexture(this.id, name, x, y, layer, width, height, bytesOf(data));\n    this.map.requestRender();\n  }\n\n  /** A uniform of the code: a number, or numbers for vectors, arrays and matrices (column major) */\n  setUniform(name: string, value: number | readonly number[]): void {\n    const values = [value].flat();\n    this.uniforms.set(name, values);\n    this.map.engine.setGroundUniform(this.id, name, Float64Array.from(values));\n    this.map.requestRender();\n  }\n\n  setBounds(bounds: [west: number, south: number, east: number, north: number]): void {\n    this.options.bounds = bounds;\n    this.map.engine.setGroundBounds(this.id, ...mercatorBox(bounds));\n    this.map.requestRender();\n  }\n\n  setVisible(visible: boolean): void {\n    this.visible = visible;\n    this.map.engine.setGroundVisible(this.id, visible);\n    this.map.requestRender();\n  }\n\n  private sendTexture(engine: Engine, id: number, name: string, t: GroundTexture): void {\n    const data = t.data && bytesOf(t.data);\n    engine.setGroundTexture(id, name, t.format, t.width, t.height, t.depth ?? 0, t.linear ?? false, data);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const [ax, ay] = mercatorPoint(this.options.anchor);\n    const id = engine.addGround(\n      this.options.code,\n      ax,\n      ay,\n      ...mercatorBox(this.options.bounds ?? [-180, -85.06, 180, 85.06]),\n    );\n    for (const [name, texture] of this.textures) this.sendTexture(engine, id, name, texture);\n    for (const [name, values] of this.uniforms) engine.setGroundUniform(id, name, Float64Array.from(values));\n    engine.setGroundVisible(id, this.visible);\n    return id;\n  }\n}\n\nfunction mercatorPoint([lon, lat]: LonLat): [number, number] {\n  const out = toMercator(Float64Array.of(lon, lat));\n  return [out[0] ?? 0, out[1] ?? 0];\n}\n\n/** A lon/lat box to Mercator min x, min y, max x, max y (y towards the south) */\nfunction mercatorBox([west, south, east, north]: [number, number, number, number]): [number, number, number, number] {\n  const [x0, y1] = mercatorPoint([west, south]);\n  const [x1, y0] = mercatorPoint([east, north]);\n  return [x0, y0, x1, y1];\n}\n"]}
+{"version":3,"file":"layers.js","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Handles of the layers added to a map. Each one keeps what it needs to be created again: after a WebGL context loss,\n * the map recreates its engine and every layer in order, with the same handle (its id is updated).\n */\nimport { parseColor, rampTexels, stops } from './features.ts';\nimport { mercatorX, mercatorY, toMercator } from './geo.ts';\nimport type {\n  LayerHost,\n  LonLat,\n  NetworkOptions,\n  NetworkStyle,\n  RasterOptions,\n  RasterStyle,\n  Tiles3dStyle,\n} from './types.ts';\nimport type { Engine, NetworkStats, Tiles3dStats } from './wasm/isard.js';\n\nexport abstract class Layer {\n  #id = -1;\n\n  /** @internal */\n  protected readonly map: LayerHost;\n\n  /** @internal */\n  constructor(map: LayerHost) {\n    this.map = map;\n  }\n\n  /** Id of the layer in the engine */\n  get id(): number {\n    return this.#id;\n  }\n\n  /** @internal Creates the layer in an engine (again after a context loss); its id is -1 if that fails */\n  attach(engine: Engine): void {\n    this.#id = -1;\n    this.#id = this.create(engine);\n  }\n\n  /** @internal Forgets its id in an engine that is gone (before the layers are created in a new one) */\n  forgetEngine(): void {\n    this.#id = -1;\n  }\n\n  /** @internal Sends what refers to other layers, once every layer of a new engine has its id */\n  relink(_engine: Engine): void {}\n\n  /** @internal */\n  protected abstract create(engine: Engine): number;\n\n  remove(): void {\n    // Not created yet: a 3D Tiles layer waiting for the engine with 3D Tiles\n    if (this.#id >= 0) this.map.engine.removeLayer(this.#id);\n    this.#id = -1;\n    this.map.detach(this);\n    this.map.requestRender();\n  }\n\n  /** Moves the layer under `other`, or on top of every layer (above the labels of a vector basemap too) */\n  moveBefore(other: Layer | undefined): void {\n    this.map.moveLayer(this, other);\n  }\n}\n\n/** Raster tiles (basemaps, overlays) */\nexport class RasterLayer extends Layer {\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly options: Required<Omit<RasterOptions, 'size' | 'loader' | 'grid' | 'attribution'>> & {\n      size: number | undefined;\n      loader: RasterOptions['loader'] | undefined;\n    },\n  ) {\n    super(map);\n  }\n\n  /** Changes the opacity or saturation, the other kept */\n  setStyle(style: Partial<RasterStyle>): void;\n  /** @deprecated Positional form (saturation back to 1 when not given): `setStyle({ opacity, saturation })` */\n  setStyle(opacity: number, saturation?: number): void;\n  setStyle(style: Partial<RasterStyle> | number, saturation = 1): void {\n    const changed = typeof style === 'number' ? { opacity: style, saturation } : style;\n    this.options.opacity = changed.opacity ?? this.options.opacity;\n    this.options.saturation = changed.saturation ?? this.options.saturation;\n    this.map.engine.setRasterStyle(this.id, this.options.opacity, this.options.saturation);\n    this.map.requestRender();\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const { url, minZoom, maxZoom, opacity, saturation, size, loader } = this.options;\n    return engine.addRaster(url, minZoom, maxZoom, opacity, saturation, size, loader);\n  }\n}\n\n/** Line network colored by a value per node (travel time, water depth…) */\nexport class NetworkLayer extends Layer {\n  private values: Float32Array | undefined;\n  /** Node and line positions in Mercator, kept for a context loss: f32 offsets from an origin (exact to the centimetre\n   * across a region, half the memory of f64) */\n  private kept: { origin: [number, number]; nodes: Float32Array; lines: Float32Array | undefined } | undefined;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private geometry: { nodes: Float64Array; edges: Uint32Array; lines: NetworkOptions['lines'] | undefined },\n    private costs: Float32Array | undefined,\n    private style: NetworkStyle,\n    private edgeWidths: Float32Array | undefined,\n  ) {\n    super(map);\n  }\n\n  /** One value per node, in node order; negative (or 1e30 and above) = unreached. Costs one texture upload, drawn\n   * next frame. */\n  setValues(values: Float32Array): void {\n    this.values = values;\n    this.map.engine.setNetworkValues(this.id, values);\n    this.map.requestRender();\n  }\n\n  /** Costs of the edges, A → B then B → A (see `NetworkOptions.costs`), when the way the network is travelled\n   * changes; undefined: values interpolated along the edges. The geometry stays on the graphics card. */\n  setCosts(costs: Float32Array | undefined): void {\n    this.costs = costs;\n    this.map.engine.setNetworkCosts(this.id, costs);\n    this.map.requestRender();\n  }\n\n  setStyle(style: Partial<NetworkStyle>): void {\n    const ramp = this.style.ramp;\n    this.style = { ...this.style, ...style };\n    this.map.engine.setNetworkStyle(this.id, networkStyle(this.style));\n    if (this.style.ramp !== ramp)\n      this.map.engine.setNetworkRamp(this.id, this.style.ramp && rampTexels(this.style.ramp).rgba);\n    this.map.requestRender();\n  }\n\n  /** Width factor of each edge (undefined: 1 for all) */\n  setEdgeWidths(widths: Float32Array | undefined): void {\n    this.edgeWidths = widths;\n    this.map.engine.setNetworkScales(this.id, widths);\n    this.map.requestRender();\n  }\n\n  /** Pieces in all and drawn in the last frame */\n  stats(): NetworkStats | undefined {\n    return this.map.engine.networkStats(this.id);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const { nodes, edges, lines } = this.geometry;\n    let mercator: { nodes: Float64Array; lines: Float64Array | undefined };\n    if (this.kept) {\n      const { origin, nodes: n, lines: l } = this.kept;\n      mercator = { nodes: unpack(n, origin), lines: l && unpack(l, origin) };\n    } else {\n      // Mercator here: Math.tan and Math.log run natively, several times faster than in WebAssembly\n      mercator = { nodes: mercatorPoints(nodes), lines: lines && mercatorPoints(lines.points) };\n      const origin: [number, number] = [mercator.nodes[0] ?? 0, mercator.nodes[1] ?? 0];\n      this.kept = {\n        origin,\n        nodes: pack(mercator.nodes, origin),\n        lines: mercator.lines && pack(mercator.lines, origin),\n      };\n      // The degrees are not needed again: millions of points for a region\n      this.geometry = { nodes: EMPTY, edges, lines: lines && { start: lines.start, points: EMPTY } };\n    }\n    const id = engine.addNetwork(\n      mercator.nodes,\n      edges,\n      lines?.start,\n      mercator.lines,\n      this.costs,\n      networkStyle(this.style),\n    );\n    if (this.style.ramp) engine.setNetworkRamp(id, rampTexels(this.style.ramp).rgba);\n    if (this.edgeWidths) engine.setNetworkScales(id, this.edgeWidths);\n    if (this.values) engine.setNetworkValues(id, this.values);\n    return id;\n  }\n}\n\n/** The 25 numbers of a network style for the engine */\nfunction networkStyle(style: NetworkStyle): Float32Array {\n  const { width, halo, max, contour, opacity, haloOpacity, unreachedColor, fade } = style;\n  return Float32Array.from([\n    ...stops(width),\n    ...stops(halo),\n    max,\n    contour,\n    opacity,\n    haloOpacity,\n    ...parseColor(unreachedColor),\n    fade,\n  ]);\n}\n\nconst EMPTY = new Float64Array(0);\n\n/** Interleaved points as f32 offsets from an origin, and back */\nfunction pack(points: Float64Array, [ox, oy]: [number, number]): Float32Array {\n  const out = new Float32Array(points.length);\n  for (let i = 0; i < points.length; i += 2) {\n    out[i] = (points[i] ?? 0) - ox;\n    out[i + 1] = (points[i + 1] ?? 0) - oy;\n  }\n  return out;\n}\n\nfunction unpack(points: Float32Array, [ox, oy]: [number, number]): Float64Array {\n  const out = new Float64Array(points.length);\n  for (let i = 0; i < points.length; i += 2) {\n    out[i] = (points[i] ?? 0) + ox;\n    out[i + 1] = (points[i + 1] ?? 0) + oy;\n  }\n  return out;\n}\n\n/** Longitudes and latitudes (degrees, interleaved) to Mercator [0, 1], y towards the south */\nfunction mercatorPoints(lonLat: Float64Array): Float64Array {\n  const out = new Float64Array(lonLat.length);\n  for (let i = 0; i < lonLat.length; i += 2) {\n    out[i] = mercatorX(lonLat[i] ?? 0);\n    out[i + 1] = mercatorY(lonLat[i + 1] ?? 0);\n  }\n  return out;\n}\n\n/** Textured meshes in 3D Tiles */\nexport class Tiles3dLayer extends Layer {\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly url: string,\n    private style: Tiles3dStyle,\n  ) {\n    super(map);\n  }\n\n  setStyle(style: Partial<Tiles3dStyle>): void {\n    this.style = { ...this.style, ...style };\n    // Kept for its creation while the engine with 3D Tiles loads\n    if (this.id < 0) return;\n    this.map.engine.setTiles3dStyle(this.id, this.style.maxScreenSpaceError, this.style.opacity);\n    this.map.requestRender();\n  }\n\n  /** Loading counters; undefined once the layer is removed, and while the engine with 3D Tiles loads (see\n   * `GeoMapOptions.tiles3d`) */\n  stats(): Tiles3dStats | undefined {\n    return this.id < 0 ? undefined : this.map.engine.tiles3dStats(this.id);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const id = engine.addTiles3d(this.url, this.style.maxScreenSpaceError);\n    engine.setTiles3dStyle(id, this.style.maxScreenSpaceError, this.style.opacity);\n    return id;\n  }\n}\n\n/** A texture of a ground layer (see `GroundLayer`) */\nexport interface GroundTexture {\n  /** `r8`, `r8ui`, `r16ui`, `r16i`, `r32ui`, `r32f`, `rg16ui`, `rg32f`, `rgba8`, `rgba8ui`, `rgba16ui`, `rgba32f`:\n   * integer formats are read with `usampler2D` / `isampler2D` and `texelFetch` */\n  format: string;\n  width: number;\n  height: number;\n  /** Layers of a 2D array (`sampler2DArray`, `usampler2DArray`…); 0 or undefined: a 2D texture */\n  depth?: number;\n  /** Linear filtering (non-integer formats); default nearest */\n  linear?: boolean;\n  /** Texels row after row (layer after layer), any typed array; undefined: left empty */\n  data?: ArrayBufferView;\n}\n\nexport interface GroundOptions {\n  /**\n   * GLSL ES 3.0 defining `vec4 ground(vec2 offset)`: the color of the ground (premultiplied alpha, 0 for nothing) at\n   * `offset`, the Mercator offset of the pixel from `anchor` (times `ISARD_CIRCUMFERENCE`: metres of EPSG:3857), exact to\n   * the millimetre at any zoom. The code declares its own uniforms and samplers; also there: `u_zoom`,\n   * `u_pixel_ratio`\n   */\n  code: string;\n  /** Where the offsets are taken from */\n  anchor: LonLat;\n  /** Box it shows in, `[west, south, east, north]` (default the world): only the ground there is drawn again */\n  bounds?: [west: number, south: number, east: number, north: number];\n  textures?: Record<string, GroundTexture>;\n  uniforms?: Record<string, number | readonly number[]>;\n}\n\nconst bytesOf = (data: ArrayBufferView) => new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n\n/** The application's fragment shader run over the ground, draped on the relief (water depth, heat maps…) */\nexport class GroundLayer extends Layer {\n  private readonly textures = new Map<string, GroundTexture>();\n  private readonly uniforms = new Map<string, number[]>();\n  private visible = true;\n\n  /** @internal */\n  constructor(\n    map: LayerHost,\n    private readonly options: GroundOptions,\n  ) {\n    super(map);\n    for (const [name, texture] of Object.entries(options.textures ?? {})) this.textures.set(name, texture);\n    for (const [name, value] of Object.entries(options.uniforms ?? {})) this.uniforms.set(name, [value].flat());\n  }\n\n  /** Creates or replaces a texture of the code's sampler `name` */\n  setTexture(name: string, texture: GroundTexture): void {\n    this.textures.set(name, texture);\n    this.sendTexture(this.map.engine, this.id, name, texture);\n    this.map.requestRender();\n  }\n\n  /**\n   * Replaces a region of a texture: `data` holds `width` × `height` texels for (`x`, `y`) of `layer` (2D arrays).\n   * Keep the texture's own `data` up to date too if it must survive a WebGL context loss.\n   */\n  updateTexture(\n    name: string,\n    data: ArrayBufferView,\n    region: { x?: number; y?: number; layer?: number; width: number; height: number },\n  ): void {\n    const { x = 0, y = 0, layer = 0, width, height } = region;\n    this.map.engine.updateGroundTexture(this.id, name, x, y, layer, width, height, bytesOf(data));\n    this.map.requestRender();\n  }\n\n  /** A uniform of the code: a number, or numbers for vectors, arrays and matrices (column major) */\n  setUniform(name: string, value: number | readonly number[]): void {\n    const values = [value].flat();\n    this.uniforms.set(name, values);\n    this.map.engine.setGroundUniform(this.id, name, Float64Array.from(values));\n    this.map.requestRender();\n  }\n\n  setBounds(bounds: [west: number, south: number, east: number, north: number]): void {\n    this.options.bounds = bounds;\n    this.map.engine.setGroundBounds(this.id, ...mercatorBox(bounds));\n    this.map.requestRender();\n  }\n\n  setVisible(visible: boolean): void {\n    this.visible = visible;\n    this.map.engine.setGroundVisible(this.id, visible);\n    this.map.requestRender();\n  }\n\n  private sendTexture(engine: Engine, id: number, name: string, t: GroundTexture): void {\n    const data = t.data && bytesOf(t.data);\n    engine.setGroundTexture(id, name, t.format, t.width, t.height, t.depth ?? 0, t.linear ?? false, data);\n  }\n\n  /** @internal */\n  protected create(engine: Engine): number {\n    const [ax, ay] = toMercator(this.options.anchor);\n    const id = engine.addGround(\n      this.options.code,\n      ax,\n      ay,\n      ...mercatorBox(this.options.bounds ?? [-180, -85.06, 180, 85.06]),\n    );\n    for (const [name, texture] of this.textures) this.sendTexture(engine, id, name, texture);\n    for (const [name, values] of this.uniforms) engine.setGroundUniform(id, name, Float64Array.from(values));\n    engine.setGroundVisible(id, this.visible);\n    return id;\n  }\n}\n\n/** A lon/lat box to Mercator min x, min y, max x, max y (y towards the south) */\nfunction mercatorBox([west, south, east, north]: [number, number, number, number]): [number, number, number, number] {\n  const [x0, y1] = toMercator([west, south]);\n  const [x1, y0] = toMercator([east, north]);\n  return [x0, y0, x1, y1];\n}\n"]}

package/dist/lru.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 declare class Lru<K, V> {
+    capacity: number;
+    private readonly evict?;
+    private readonly entries;
+    /** `evict`: told of each entry dropped for room (not of those deleted) */
+    constructor(capacity: number, evict?: ((value: V, key: K) => void) | undefined);
+    get size(): number;
+    /** The value of a key, now the most recently used; undefined if absent */
+    get(key: K): V | undefined;
+    /** Whether a key is kept, without using it */
+    has(key: K): boolean;
+    /** Adds or replaces a value, the most recently used; drops the least recent ones past the capacity */
+    set(key: K, value: V): void;
+    delete(key: K): boolean;
+    /** The values, least recently used first */
+    values(): IterableIterator<V>;
+    clear(): void;
+}

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;
@@ -80,6 +80,9 @@ export declare class GeoMap {
     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();
@@ -169,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;
@@ -196,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 */