isard 2.4.1 → 2.5.0

package/CHANGELOG.md

@@ -5,6 +5,38 @@ versions [Semantic Versioning](https://semver.org) (before 1.0.0, a minor versio
 
 ## [Unreleased]
 
+## [2.5.0] - 2026-11-02
+
+With `isard-react-native` and `isard-map` (Python) 2.5.0.
+
+### Added
+
+- Finding a feature and framing it (#176): `map.fitBounds(box, options)` frames a box on the ground or in space (its
+  bottom and top altitudes: a building, a pipe underground), all of it within the canvas less the padding, at the pitch
+  and bearing given; `tiles3d.refine(box)` loads the tiles meeting a box to their finest level, first, in view or not,
+  resolved once they are there; `tiles3d.find(matches)` gives the first feature of the tiles drawn whose properties
+  match; `map.geoidHeight([lon, lat])`. The example Find a building, in its four versions.
+- `onGpuLost` on `<IsardMap>` (the `'gpulost'` event).
+
+### Fixed
+
+- The API page listed `map.camera`, `map.query` and `map.effects`, gone since the public API was made consistent.
+
+## [2.4.2] - 2026-11-02
+
+With `isard-react-native` and `isard-map` (Python) 2.4.2.
+
+### Added
+
+- `map.renderer` (`'webgpu'` or `'webgl2'`) and the `'gpulost'` event: `{ reason, message, losses, recovery }`; in
+  `isard-react-native`, the view's `onError` hears it, and the examples' app too.
+
+### Fixed
+
+- A map whose WebGPU device is lost (an iPhone taking its memory back: Paris by night went black and stayed so) is made
+  again lighter so as not to lose it again: the low quality and half the GPU memory budget at the first loss, the WebGL2
+  fallback at the next one, or when WebGPU gives no new device.
+
 ## [2.4.1] - 2026-11-02
 
 With `isard-react-native` and `isard-map` (Python) 2.4.1.

package/README.md

@@ -187,10 +187,13 @@ More in [Develop and release](https://ideal-adventure-zqn6y6p.pages.github.io/gu
 By priority:
 
 - **P1**, next: the memory budget measured on a phone (a phone closes a page past about a gigabyte).
-- **P2**, then: rasters draped within an area; a clipping volume; a performance report.
-- **P3**, later: objects moving along paths; video in the scene.
-- **P4**, when time allows: the whole MapLibre style drawn as vectors, a 3D vector map to walk through, Panoramax's
-  street-level photos, fluids on the globe, several projections on the globe, smaller items.
+- **P2**, then: OGC API - Features and Tiles (#177); virtual point clouds (#183); Cloud-Optimized GeoTIFF (#184);
+  measured against iTowns on 3D data (#178); rasters draped within an area; a performance report.
+- **P3**, later: several elevation sources (#179); a time for layers (#180); objects moving along paths (#181); photos
+  projected onto the meshes (#187) and video in the scene; composable effects over the frame (#182).
+- **P4**, when time allows: Gaussian splats (#186), WebXR (#185), the whole MapLibre style drawn as vectors, a 3D
+  vector map to walk through, Panoramax's street-level photos, fluids on the globe, several projections on the globe,
+  smaller items.
 
 See [Roadmap](https://ideal-adventure-zqn6y6p.pages.github.io/guide/roadmap).
 

package/dist/index.d.ts

@@ -67,7 +67,7 @@ export { type VectorFeature, VectorLayer, type VectorSublayer } from './layers/v
 export type { HoverPicking } from './map/hover-pick.ts';
 export { GeoMap, type LayerSpec } from './map.ts';
 export { PANORAMAX_API, type PanoramaxPicture, type PanoramaxSequenceOptions, panoramaxPanoramas, panoramaxPhoto, panoramaxPicture, panoramaxSequence, panoramaxStyle, } from './panoramax.ts';
-export type { AnimationOptions, AtmosphereOptions, Basemap, BasemapName, BodyOptions, CelestialBody, ClipBox, ClipCylinder, ClipPolygon, ClipVolume, Drape, FeatureColor, FeatureHit, FirstPersonView, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, MapGpuTimings, MapHoverFeatureEvent, MapMemory, MapPointerEvent, NetworkOptions, NetworkStyle, PickOptions, Placement, Point, Projection, Quality, RasterGrid, RasterOptions, RasterStyle, SunOptions, SwipeOptions, TerrainEncoding, TerrainModel, TerrainOptions, Tiles3dOptions, Tiles3dStyle, ViewshedOptions, } from './types.ts';
+export type { AnimationOptions, AtmosphereOptions, Basemap, BasemapName, BodyOptions, CelestialBody, ClipBox, ClipCylinder, ClipPolygon, ClipVolume, Drape, FeatureColor, FeatureHit, FirstPersonView, FitBoundsOptions, FitBox, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, MapGpuTimings, MapHoverFeatureEvent, MapMemory, MapPointerEvent, NetworkOptions, NetworkStyle, PickOptions, Placement, Point, Projection, Quality, RasterGrid, RasterOptions, RasterStyle, SunOptions, SwipeOptions, TerrainEncoding, TerrainModel, TerrainOptions, Tiles3dOptions, Tiles3dStyle, ViewshedOptions, } from './types.ts';
 export { AttributionControl, type AttributionOptions, type Control, type ControlPosition, NavigationControl, type NavigationOptions, } from './ui/controls.ts';
 export { MinimapControl, type MinimapOptions } from './ui/minimap.ts';
 export { type Anchor, Marker, type MarkerEvent, type MarkerEvents, type MarkerOptions, Panel, type PanelOptions, Popup, type PopupEvents, type PopupOptions, } from './ui/overlay.ts';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * isard: a WebGL2 map engine for large, interactive data layers, labels and 3D Tiles.\n *\n * ```ts\n * import { GeoMap } from 'isard';\n * const map = await GeoMap.create(container, { center: [2.4246, 48.8457], zoom: 13 });\n * const network = map.addNetwork({ nodes, edges, max: 1800, contour: 300 });\n * map.on('hover', ({ lonLat }) => lonLat && network.setValues(travelTimes(lonLat)));\n * map.addTiles3d({ url: 'https://…/tileset.json' });\n * map.addControl(new NavigationControl());\n * new Marker().setLonLat([2.4246, 48.8457]).setPopup(new Popup({ offset: [0, -34] }).setText('Here')).addTo(map);\n * ```\n */\nexport { OPENFREEMAP_ATTRIBUTION, TERRAIN_TILES_ATTRIBUTION } from './basemap/basemaps.ts';\nexport type { TileGrid, TileMatrix } from './basemap/grid.ts';\nexport { coniferModel, type TreeColors, treeModel } from './basemap/models/trees.ts';\nexport {\n  PMTiles,\n  type PmtilesEntry,\n  type PmtilesHeader,\n  type PmtilesTileType,\n  tileIdToZxy,\n  zxyToTileId,\n} from './basemap/pmtiles.ts';\nexport { basicStyle, type PmtilesOptions } from './basemap/pmtileslayer.ts';\nexport type {\n  CandidateIcon,\n  CandidateOverlap,\n  Json,\n  LabelCandidate,\n  RasterSource,\n  Style,\n  StyleLayer,\n} from './basemap/vectorstyle.ts';\nexport type { VectorExtrusionOptions } from './basemap/vectortiles/extrusions.ts';\nexport type { FurnitureOptions } from './basemap/vectortiles/furniture.ts';\nexport type { LabelsOptions } from './basemap/vectortiles/labels.ts';\nexport type { LampsOptions } from './basemap/vectortiles/lamps.ts';\nexport type { StreetWindLayer, StreetWindOptions } from './basemap/vectortiles/street-wind.ts';\nexport type { LoadedStyle } from './basemap/vectortiles/style.ts';\nexport type { TreesOptions } from './basemap/vectortiles/trees.ts';\nexport { isStreet, type VectorsOptions } from './basemap/vectortiles/vectors.ts';\nexport type { VectorRasterOptions, VectorTilesOptions } from './basemap/vectortiles.ts';\nexport { OPENFREEMAP_STYLES, PLAN_STYLES, VectorTiles } from './basemap/vectortiles.ts';\nexport { parseWmtsGrid, wmtsGrid } from './basemap/wmts.ts';\nexport { type ColladaImages, colladaImages, loadCollada, parseCollada } from './data/collada.ts';\nexport {\n  type Crs,\n  type CrsLike,\n  getCrs,\n  lambertConformalConic,\n  registerCrs,\n  reproject,\n  transverseMercator,\n} from './data/crs.ts';\nexport { parseGpx } from './data/gpx.ts';\nexport {\n  type IfcElement,\n  type IfcModel,\n  type IfcOptions,\n  type IfcPlace,\n  type IfcProperties,\n  type IfcStorey,\n  loadIfc,\n  WEB_IFC,\n} from './data/ifc.ts';\nexport { parseKml } from './data/kml.ts';\nexport { parseTopoJson, type TopoGeometry, type Topology } from './data/topojson.ts';\nexport type { DecoderUrls } from './decoding/decoders.ts';\nexport {\n  BATIMENTS_3D_URL,\n  type BdTopoBuilding,\n  batiments3d,\n  bdtopoBuildings,\n  bdtopoRoofs,\n  type GeocodedPlace,\n  geoplateformeGeocode,\n  geoplateformeWfs,\n  geoplateformeWms,\n  geoplateformeWmts,\n  IGN_ATTRIBUTION,\n  IGN_PRESETS,\n  type IgnPreset,\n  lambert93Grid,\n} from './geoplateforme.ts';\nexport { type Grid, windAt, windFields } from './grids.ts';\nexport type { CustomFrame, CustomLayerInterface } from './layers/custom.ts';\nexport { CustomLayer } from './layers/custom.ts';\nexport type { ExtrusionOptions, ExtrusionStyle, PolygonArrays, TileKey } from './layers/extrusions.ts';\nexport { ExtrusionLayer } from './layers/extrusions.ts';\nexport type {\n  CircleOptions,\n  CircleStyle,\n  Feature,\n  FeatureCollection,\n  FeatureData,\n  FeatureLayerStyle,\n  FillOptions,\n  FillStyle,\n  Geometry,\n  LineOptions,\n  LineStyle,\n  Position,\n  Properties,\n  Ramp,\n  Size,\n  Stops,\n  Styled,\n} from './layers/features.ts';\nexport { CircleLayer, FeatureLayer, FillLayer, interpolate, LineLayer, parseColor } from './layers/features.ts';\nexport type { FlowField, FlowOptions, FlowStyle, TimedField } from './layers/flow.ts';\nexport { FlowLayer, flowFieldFromImage, flowFieldsFromImage } from './layers/flow.ts';\nexport type { TextPart } from './layers/glyphs.ts';\nexport { DEFAULT_FONT, GLYPHS_URL } from './layers/glyphs.ts';\nexport type { GroundOptions, GroundTexture, GroundUniform } from './layers/ground.ts';\nexport { GroundLayer } from './layers/ground.ts';\nexport type { ImageOptions, Pixels, SpriteIcon } from './layers/icons.ts';\nexport { Layer } from './layers/layers.ts';\nexport type { ModelInstance, ModelOptions } from './layers/models.ts';\nexport { ModelLayer } from './layers/models.ts';\nexport { NetworkLayer } from './layers/network.ts';\nexport {\n  type CalibratedPanoramaOptions,\n  type Panorama,\n  type PanoramaOptions,\n  type PanoramaPhoto,\n  Panoramas,\n  type PhotoPanoramaOptions,\n} from './layers/panoramas.ts';\nexport { type PhotoOptions, photoModel } from './layers/photos.ts';\nexport type { ClassStyle, PointCloudOptions, PointCloudStyle, PointColor } from './layers/pointclouds.ts';\nexport { CLASSIFICATIONS, ELEVATION_RAMP, PointCloudLayer } from './layers/pointclouds.ts';\nexport { RasterLayer } from './layers/raster.ts';\nexport type { Overlap, SymbolOptions, SymbolStyle } from './layers/symbols.ts';\nexport { SymbolLayer } from './layers/symbols.ts';\nexport { Tiles3dLayer } from './layers/tiles3d.ts';\nexport { type TreeKind, type TreeOptions, treeKind } from './layers/trees.ts';\nexport { type VectorFeature, VectorLayer, type VectorSublayer } from './layers/vectors.ts';\nexport type { HoverPicking } from './map/hover-pick.ts';\nexport { GeoMap, type LayerSpec } from './map.ts';\nexport {\n  PANORAMAX_API,\n  type PanoramaxPicture,\n  type PanoramaxSequenceOptions,\n  panoramaxPanoramas,\n  panoramaxPhoto,\n  panoramaxPicture,\n  panoramaxSequence,\n  panoramaxStyle,\n} from './panoramax.ts';\nexport type {\n  AnimationOptions,\n  AtmosphereOptions,\n  Basemap,\n  BasemapName,\n  BodyOptions,\n  CelestialBody,\n  ClipBox,\n  ClipCylinder,\n  ClipPolygon,\n  ClipVolume,\n  Drape,\n  FeatureColor,\n  FeatureHit,\n  FirstPersonView,\n  FlyToOptions,\n  GeoMapOptions,\n  LoadingMode,\n  LonLat,\n  MapEvents,\n  MapGpuTimings,\n  MapHoverFeatureEvent,\n  MapMemory,\n  MapPointerEvent,\n  NetworkOptions,\n  NetworkStyle,\n  PickOptions,\n  Placement,\n  Point,\n  Projection,\n  Quality,\n  RasterGrid,\n  RasterOptions,\n  RasterStyle,\n  SunOptions,\n  SwipeOptions,\n  TerrainEncoding,\n  TerrainModel,\n  TerrainOptions,\n  Tiles3dOptions,\n  Tiles3dStyle,\n  ViewshedOptions,\n} from './types.ts';\nexport {\n  AttributionControl,\n  type AttributionOptions,\n  type Control,\n  type ControlPosition,\n  NavigationControl,\n  type NavigationOptions,\n} from './ui/controls.ts';\nexport { MinimapControl, type MinimapOptions } from './ui/minimap.ts';\nexport {\n  type Anchor,\n  Marker,\n  type MarkerEvent,\n  type MarkerEvents,\n  type MarkerOptions,\n  Panel,\n  type PanelOptions,\n  Popup,\n  type PopupEvents,\n  type PopupOptions,\n} from './ui/overlay.ts';\nexport { lengthLabel, roundLength, ScaleControl, type ScaleOptions } from './ui/scale.ts';\nexport { SearchControl, type SearchOptions } from './ui/search.ts';\nexport { setRequestHeaders } from './util/requests.ts';\nexport type { RoofMode } from './util/roofs.ts';\nexport { sunPosition } from './util/sun.ts';\nexport type {\n  Camera,\n  NetworkStats,\n  PickHit,\n  PickResult,\n  PointCloudInfo,\n  PointCloudPoint,\n  PointCloudStats,\n  RasterLayerStats,\n  Tiles3dStats,\n} from './wasm/isard_webgpu.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * isard: a WebGL2 map engine for large, interactive data layers, labels and 3D Tiles.\n *\n * ```ts\n * import { GeoMap } from 'isard';\n * const map = await GeoMap.create(container, { center: [2.4246, 48.8457], zoom: 13 });\n * const network = map.addNetwork({ nodes, edges, max: 1800, contour: 300 });\n * map.on('hover', ({ lonLat }) => lonLat && network.setValues(travelTimes(lonLat)));\n * map.addTiles3d({ url: 'https://…/tileset.json' });\n * map.addControl(new NavigationControl());\n * new Marker().setLonLat([2.4246, 48.8457]).setPopup(new Popup({ offset: [0, -34] }).setText('Here')).addTo(map);\n * ```\n */\nexport { OPENFREEMAP_ATTRIBUTION, TERRAIN_TILES_ATTRIBUTION } from './basemap/basemaps.ts';\nexport type { TileGrid, TileMatrix } from './basemap/grid.ts';\nexport { coniferModel, type TreeColors, treeModel } from './basemap/models/trees.ts';\nexport {\n  PMTiles,\n  type PmtilesEntry,\n  type PmtilesHeader,\n  type PmtilesTileType,\n  tileIdToZxy,\n  zxyToTileId,\n} from './basemap/pmtiles.ts';\nexport { basicStyle, type PmtilesOptions } from './basemap/pmtileslayer.ts';\nexport type {\n  CandidateIcon,\n  CandidateOverlap,\n  Json,\n  LabelCandidate,\n  RasterSource,\n  Style,\n  StyleLayer,\n} from './basemap/vectorstyle.ts';\nexport type { VectorExtrusionOptions } from './basemap/vectortiles/extrusions.ts';\nexport type { FurnitureOptions } from './basemap/vectortiles/furniture.ts';\nexport type { LabelsOptions } from './basemap/vectortiles/labels.ts';\nexport type { LampsOptions } from './basemap/vectortiles/lamps.ts';\nexport type { StreetWindLayer, StreetWindOptions } from './basemap/vectortiles/street-wind.ts';\nexport type { LoadedStyle } from './basemap/vectortiles/style.ts';\nexport type { TreesOptions } from './basemap/vectortiles/trees.ts';\nexport { isStreet, type VectorsOptions } from './basemap/vectortiles/vectors.ts';\nexport type { VectorRasterOptions, VectorTilesOptions } from './basemap/vectortiles.ts';\nexport { OPENFREEMAP_STYLES, PLAN_STYLES, VectorTiles } from './basemap/vectortiles.ts';\nexport { parseWmtsGrid, wmtsGrid } from './basemap/wmts.ts';\nexport { type ColladaImages, colladaImages, loadCollada, parseCollada } from './data/collada.ts';\nexport {\n  type Crs,\n  type CrsLike,\n  getCrs,\n  lambertConformalConic,\n  registerCrs,\n  reproject,\n  transverseMercator,\n} from './data/crs.ts';\nexport { parseGpx } from './data/gpx.ts';\nexport {\n  type IfcElement,\n  type IfcModel,\n  type IfcOptions,\n  type IfcPlace,\n  type IfcProperties,\n  type IfcStorey,\n  loadIfc,\n  WEB_IFC,\n} from './data/ifc.ts';\nexport { parseKml } from './data/kml.ts';\nexport { parseTopoJson, type TopoGeometry, type Topology } from './data/topojson.ts';\nexport type { DecoderUrls } from './decoding/decoders.ts';\nexport {\n  BATIMENTS_3D_URL,\n  type BdTopoBuilding,\n  batiments3d,\n  bdtopoBuildings,\n  bdtopoRoofs,\n  type GeocodedPlace,\n  geoplateformeGeocode,\n  geoplateformeWfs,\n  geoplateformeWms,\n  geoplateformeWmts,\n  IGN_ATTRIBUTION,\n  IGN_PRESETS,\n  type IgnPreset,\n  lambert93Grid,\n} from './geoplateforme.ts';\nexport { type Grid, windAt, windFields } from './grids.ts';\nexport type { CustomFrame, CustomLayerInterface } from './layers/custom.ts';\nexport { CustomLayer } from './layers/custom.ts';\nexport type { ExtrusionOptions, ExtrusionStyle, PolygonArrays, TileKey } from './layers/extrusions.ts';\nexport { ExtrusionLayer } from './layers/extrusions.ts';\nexport type {\n  CircleOptions,\n  CircleStyle,\n  Feature,\n  FeatureCollection,\n  FeatureData,\n  FeatureLayerStyle,\n  FillOptions,\n  FillStyle,\n  Geometry,\n  LineOptions,\n  LineStyle,\n  Position,\n  Properties,\n  Ramp,\n  Size,\n  Stops,\n  Styled,\n} from './layers/features.ts';\nexport { CircleLayer, FeatureLayer, FillLayer, interpolate, LineLayer, parseColor } from './layers/features.ts';\nexport type { FlowField, FlowOptions, FlowStyle, TimedField } from './layers/flow.ts';\nexport { FlowLayer, flowFieldFromImage, flowFieldsFromImage } from './layers/flow.ts';\nexport type { TextPart } from './layers/glyphs.ts';\nexport { DEFAULT_FONT, GLYPHS_URL } from './layers/glyphs.ts';\nexport type { GroundOptions, GroundTexture, GroundUniform } from './layers/ground.ts';\nexport { GroundLayer } from './layers/ground.ts';\nexport type { ImageOptions, Pixels, SpriteIcon } from './layers/icons.ts';\nexport { Layer } from './layers/layers.ts';\nexport type { ModelInstance, ModelOptions } from './layers/models.ts';\nexport { ModelLayer } from './layers/models.ts';\nexport { NetworkLayer } from './layers/network.ts';\nexport {\n  type CalibratedPanoramaOptions,\n  type Panorama,\n  type PanoramaOptions,\n  type PanoramaPhoto,\n  Panoramas,\n  type PhotoPanoramaOptions,\n} from './layers/panoramas.ts';\nexport { type PhotoOptions, photoModel } from './layers/photos.ts';\nexport type { ClassStyle, PointCloudOptions, PointCloudStyle, PointColor } from './layers/pointclouds.ts';\nexport { CLASSIFICATIONS, ELEVATION_RAMP, PointCloudLayer } from './layers/pointclouds.ts';\nexport { RasterLayer } from './layers/raster.ts';\nexport type { Overlap, SymbolOptions, SymbolStyle } from './layers/symbols.ts';\nexport { SymbolLayer } from './layers/symbols.ts';\nexport { Tiles3dLayer } from './layers/tiles3d.ts';\nexport { type TreeKind, type TreeOptions, treeKind } from './layers/trees.ts';\nexport { type VectorFeature, VectorLayer, type VectorSublayer } from './layers/vectors.ts';\nexport type { HoverPicking } from './map/hover-pick.ts';\nexport { GeoMap, type LayerSpec } from './map.ts';\nexport {\n  PANORAMAX_API,\n  type PanoramaxPicture,\n  type PanoramaxSequenceOptions,\n  panoramaxPanoramas,\n  panoramaxPhoto,\n  panoramaxPicture,\n  panoramaxSequence,\n  panoramaxStyle,\n} from './panoramax.ts';\nexport type {\n  AnimationOptions,\n  AtmosphereOptions,\n  Basemap,\n  BasemapName,\n  BodyOptions,\n  CelestialBody,\n  ClipBox,\n  ClipCylinder,\n  ClipPolygon,\n  ClipVolume,\n  Drape,\n  FeatureColor,\n  FeatureHit,\n  FirstPersonView,\n  FitBoundsOptions,\n  FitBox,\n  FlyToOptions,\n  GeoMapOptions,\n  LoadingMode,\n  LonLat,\n  MapEvents,\n  MapGpuTimings,\n  MapHoverFeatureEvent,\n  MapMemory,\n  MapPointerEvent,\n  NetworkOptions,\n  NetworkStyle,\n  PickOptions,\n  Placement,\n  Point,\n  Projection,\n  Quality,\n  RasterGrid,\n  RasterOptions,\n  RasterStyle,\n  SunOptions,\n  SwipeOptions,\n  TerrainEncoding,\n  TerrainModel,\n  TerrainOptions,\n  Tiles3dOptions,\n  Tiles3dStyle,\n  ViewshedOptions,\n} from './types.ts';\nexport {\n  AttributionControl,\n  type AttributionOptions,\n  type Control,\n  type ControlPosition,\n  NavigationControl,\n  type NavigationOptions,\n} from './ui/controls.ts';\nexport { MinimapControl, type MinimapOptions } from './ui/minimap.ts';\nexport {\n  type Anchor,\n  Marker,\n  type MarkerEvent,\n  type MarkerEvents,\n  type MarkerOptions,\n  Panel,\n  type PanelOptions,\n  Popup,\n  type PopupEvents,\n  type PopupOptions,\n} from './ui/overlay.ts';\nexport { lengthLabel, roundLength, ScaleControl, type ScaleOptions } from './ui/scale.ts';\nexport { SearchControl, type SearchOptions } from './ui/search.ts';\nexport { setRequestHeaders } from './util/requests.ts';\nexport type { RoofMode } from './util/roofs.ts';\nexport { sunPosition } from './util/sun.ts';\nexport type {\n  Camera,\n  NetworkStats,\n  PickHit,\n  PickResult,\n  PointCloudInfo,\n  PointCloudPoint,\n  PointCloudStats,\n  RasterLayerStats,\n  Tiles3dStats,\n} from './wasm/isard_webgpu.js';\n"]}

package/dist/layers/tiles3d.d.ts

@@ -1,6 +1,7 @@
 /** A 3D Tiles tileset as a layer: its style, its features picked */
-import type { Drape, Tiles3dStyle } from '../types.ts';
+import type { Drape, FitBox, Tiles3dStyle } from '../types.ts';
 import type { Tiles3dStats } from '../wasm/isard_webgpu.js';
+import type { Feature } from './features.ts';
 import { Layer } from './layers.ts';
 /** Textured meshes in 3D Tiles */
 export declare class Tiles3dLayer extends Layer {
@@ -9,6 +10,17 @@ export declare class Tiles3dLayer extends Layer {
     private style;
     private facades;
     private drape;
+    /** The box loaded to its finest tiles (`refine`): west, south, east, north, bottom, top */
+    private focus;
+    /**
+     * Loads the tiles meeting a box to their finest level, before the others and whether the box is in view or not (a
+     * feature framed to be found in them: its finest geometry, its ID); resolved once they are all there. The box stays
+     * so until another one, or `refine(undefined)`. `box`: as `fitBounds` takes it, altitudes in metres above the
+     * ellipsoid; `timeout` (ms, default 30 s): rejected past it
+     */
+    refine(box: FitBox | FitBox['bounds'] | undefined, { timeout }?: {
+        timeout?: number | undefined;
+    }): Promise<void>;
     /** Whether the walls of its untextured meshes (buildings without their photos, as the IGN's Bâtiments 3D) show
      * windows, as the vector tiles' buildings do: glass by day, some lit at night. Their faces near vertical are walls,
      * bays of 3 metres along them and floors of 3.2 metres from the ellipsoid (a mesh tells neither foot nor top) */
@@ -16,6 +28,12 @@ export declare class Tiles3dLayer extends Layer {
     /** A raster layer draped on its meshes, its roofs by default (see `Drape`); undefined: none */
     setDrape(drape: Drape | undefined): void;
     setStyle(style: Partial<Tiles3dStyle>): void;
+    /**
+     * The first feature of the tiles drawn whose properties `matches` takes (its ID, its attributes), the finest tiles
+     * first: a feature framed and loaded (`fitBounds`, `refine`) found in them, to show or color (`featureColor`);
+     * undefined if none drawn has it
+     */
+    find(matches: (properties: Record<string, unknown>) => boolean): Feature<Record<string, unknown>> | undefined;
     /** Loading counters; undefined once the layer is removed, and while the map waits for a new engine (the GPU lost) */
     stats(): Tiles3dStats | undefined;
     private applyStyle;

package/dist/layers/tiles3d.js

@@ -43,6 +43,35 @@ export class Tiles3dLayer extends Layer {
         this.facades = facades;
         this.drape = drape;
     }
+    /** The box loaded to its finest tiles (`refine`): west, south, east, north, bottom, top */
+    focus = [];
+    /**
+     * Loads the tiles meeting a box to their finest level, before the others and whether the box is in view or not (a
+     * feature framed to be found in them: its finest geometry, its ID); resolved once they are all there. The box stays
+     * so until another one, or `refine(undefined)`. `box`: as `fitBounds` takes it, altitudes in metres above the
+     * ellipsoid; `timeout` (ms, default 30 s): rejected past it
+     */
+    async refine(box, { timeout = 30_000 } = {}) {
+        const { bounds, bottom = -1e4, top = 1e4 } = !box || Array.isArray(box) ? { bounds: box } : box;
+        this.focus = bounds ? [...bounds, Math.min(bottom, top), Math.max(bottom, top)] : [];
+        if (this.id >= 0)
+            this.map.engine.setTiles3dFocus(this.id, Float64Array.from(this.focus));
+        this.map.requestRender();
+        if (!bounds)
+            return;
+        const focus = this.focus;
+        const until = performance.now() + timeout;
+        // Its tiles counted by the frames drawn with the box (undefined before), the box still this one
+        while (this.focus === focus) {
+            const pending = this.id < 0 ? undefined : this.map.engine.tiles3dFocusPending(this.id);
+            if (pending === 0)
+                return;
+            if (performance.now() >= until)
+                throw new Error("isard: the box's tiles were not loaded in time");
+            this.map.requestRender();
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+    }
     /** Whether the walls of its untextured meshes (buildings without their photos, as the IGN's Bâtiments 3D) show
      * windows, as the vector tiles' buildings do: glass by day, some lit at night. Their faces near vertical are walls,
      * bays of 3 metres along them and floors of 3.2 metres from the ellipsoid (a mesh tells neither foot nor top) */
@@ -85,6 +114,20 @@ export class Tiles3dLayer extends Layer {
         const [properties, feature] = hit;
         return { type: 'Feature', id: feature, properties: properties ?? {}, geometry: null };
     }
+    /**
+     * The first feature of the tiles drawn whose properties `matches` takes (its ID, its attributes), the finest tiles
+     * first: a feature framed and loaded (`fitBounds`, `refine`) found in them, to show or color (`featureColor`);
+     * undefined if none drawn has it
+     */
+    find(matches) {
+        if (this.id < 0)
+            return undefined;
+        const hit = this.map.engine.tiles3dFind(this.id, matches);
+        if (!hit)
+            return undefined;
+        const [properties, feature] = hit;
+        return { type: 'Feature', id: feature, properties, geometry: null };
+    }
     /** Loading counters; undefined once the layer is removed, and while the map waits for a new engine (the GPU lost) */
     stats() {
         return this.id < 0 ? undefined : this.map.engine.tiles3dStats(this.id);
@@ -95,6 +138,7 @@ export class Tiles3dLayer extends Layer {
         this.applyStyle(engine, id);
         this.applyFeatureColor(engine, id);
         engine.setTiles3dFacades(id, this.facades);
+        engine.setTiles3dFocus(id, Float64Array.from(this.focus));
         // A raster created before (on a new engine, the map relinks once every layer is there)
         sendDrape(engine, id, this.drape);
         return id;

package/dist/layers/tiles3d.js.map

@@ -1 +1 @@
-{"version":3,"file":"tiles3d.js","sourceRoot":"","sources":["../../src/layers/tiles3d.ts"],"names":[],"mappings":"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","sourcesContent":["/** A 3D Tiles tileset as a layer: its style, its features picked */\n\nimport { rgb } from '../settings.ts';\nimport type { Drape, FeatureColor, LayerHost, Tiles3dStyle } from '../types.ts';\nimport { parseColor } from '../util/color.ts';\nimport type { Engine, Tiles3dStats } from '../wasm/isard_webgpu.js';\nimport type { Feature } from './features.ts';\nimport { Layer } from './layers.ts';\nimport { sendDrape } from './raster.ts';\n\n/**\n * The engine's colors of a tile's features from a `featureColor`: RGBA bytes for each (alpha 0: the layer's color),\n * the CSS colors parsed once each\n */\nconst featureColors = (color: FeatureColor) => {\n  const parsed = new Map<string, number[]>();\n  const bytesOf = (css: string) => {\n    const known = parsed.get(css);\n\n    if (known) return known;\n\n    const [r, g, b] = parseColor(css);\n    const made = [r, g, b].map((c) => Math.round(c * 255)).concat(255);\n\n    parsed.set(css, made);\n\n    return made;\n  };\n\n  return (properties: Record<string, unknown>[] | undefined, count: number): Uint8Array => {\n    const rgba = new Uint8Array(count * 4);\n\n    Array.from({ length: count }, (_, i) => color(properties?.[i] ?? {}, i)).forEach((css, i) => {\n      if (css) rgba.set(bytesOf(css), i * 4);\n    });\n\n    return rgba;\n  };\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 readonly geoid: boolean,\n    private style: Tiles3dStyle,\n    private facades = false,\n    private drape: Drape | undefined = undefined,\n  ) {\n    super(map);\n  }\n\n  /** Whether the walls of its untextured meshes (buildings without their photos, as the IGN's Bâtiments 3D) show\n   * windows, as the vector tiles' buildings do: glass by day, some lit at night. Their faces near vertical are walls,\n   * bays of 3 metres along them and floors of 3.2 metres from the ellipsoid (a mesh tells neither foot nor top) */\n  setFacades(facades: boolean): void {\n    this.facades = facades;\n    // Kept for its creation in a new engine (the GPU lost and given back), none while it has no id\n    if (this.id < 0) return;\n    this.map.engine.setTiles3dFacades(this.id, facades);\n    this.map.requestRender();\n  }\n\n  /** A raster layer draped on its meshes, its roofs by default (see `Drape`); undefined: none */\n  setDrape(drape: Drape | undefined): void {\n    this.drape = drape;\n    // Kept for its creation in a new engine (the GPU lost and given back), none while it has no id\n    if (this.id < 0) return;\n    sendDrape(this.map.engine, this.id, drape);\n    this.map.requestRender();\n  }\n\n  setStyle(style: Partial<Tiles3dStyle>): void {\n    this.style = { ...this.style, ...style };\n    // Kept for its creation in a new engine (the GPU lost and given back), none while it has no id\n    if (this.id < 0) return;\n    this.applyStyle(this.map.engine, this.id);\n    // The features colored again only when their function changed: every tile asks for its colors then\n    if ('featureColor' in style) this.applyFeatureColor(this.map.engine, this.id);\n    this.map.requestRender();\n  }\n\n  /** @internal The feature picked (`pickFeature`, 'hoverfeature'): the properties of its feature in the tile\n   * (`EXT_structural_metadata`, a b3dm batch table), none for a mesh without features; its index in the tile as id */\n  featureAt(index: number): Feature<Record<string, unknown>> | undefined {\n    if (this.id < 0) return undefined;\n\n    const hit = this.map.engine.tiles3dFeature(this.id, index);\n\n    if (!hit) return undefined;\n\n    const [properties, feature] = hit;\n\n    return { type: 'Feature', id: feature, properties: properties ?? {}, geometry: null };\n  }\n\n  /** Loading counters; undefined once the layer is removed, and while the map waits for a new engine (the GPU lost) */\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 * this.map.quality.errorScale, this.geoid);\n\n    this.applyStyle(engine, id);\n    this.applyFeatureColor(engine, id);\n    engine.setTiles3dFacades(id, this.facades);\n    // A raster created before (on a new engine, the map relinks once every layer is there)\n    sendDrape(engine, id, this.drape);\n\n    return id;\n  }\n\n  /** @internal On a new engine, the raster may come after the tiles: draped once both are there */\n  override relink(engine: Engine): void {\n    sendDrape(engine, this.id, this.drape);\n  }\n\n  /** @internal */\n  override qualityChanged(): void {\n    if (this.id >= 0) this.applyStyle(this.map.engine, this.id);\n  }\n\n  private applyStyle(engine: Engine, id: number): void {\n    const { maxScreenSpaceError, opacity, pointSize, color } = this.style;\n    // Coarser far away at a lower quality\n    const error = maxScreenSpaceError * this.map.quality.errorScale;\n\n    engine.setTiles3dStyle(id, error, opacity, pointSize, new Float32Array(color ? rgb(color) : []));\n  }\n\n  private applyFeatureColor(engine: Engine, id: number): void {\n    const { featureColor } = this.style;\n\n    engine.setTiles3dFeatureColors(id, featureColor ? featureColors(featureColor) : null);\n  }\n}\n"]}
+{"version":3,"file":"tiles3d.js","sourceRoot":"","sources":["../../src/layers/tiles3d.ts"],"names":[],"mappings":"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","sourcesContent":["/** A 3D Tiles tileset as a layer: its style, its features picked */\n\nimport { rgb } from '../settings.ts';\nimport type { Drape, FeatureColor, FitBox, LayerHost, Tiles3dStyle } from '../types.ts';\nimport { parseColor } from '../util/color.ts';\nimport type { Engine, Tiles3dStats } from '../wasm/isard_webgpu.js';\nimport type { Feature } from './features.ts';\nimport { Layer } from './layers.ts';\nimport { sendDrape } from './raster.ts';\n\n/**\n * The engine's colors of a tile's features from a `featureColor`: RGBA bytes for each (alpha 0: the layer's color),\n * the CSS colors parsed once each\n */\nconst featureColors = (color: FeatureColor) => {\n  const parsed = new Map<string, number[]>();\n  const bytesOf = (css: string) => {\n    const known = parsed.get(css);\n\n    if (known) return known;\n\n    const [r, g, b] = parseColor(css);\n    const made = [r, g, b].map((c) => Math.round(c * 255)).concat(255);\n\n    parsed.set(css, made);\n\n    return made;\n  };\n\n  return (properties: Record<string, unknown>[] | undefined, count: number): Uint8Array => {\n    const rgba = new Uint8Array(count * 4);\n\n    Array.from({ length: count }, (_, i) => color(properties?.[i] ?? {}, i)).forEach((css, i) => {\n      if (css) rgba.set(bytesOf(css), i * 4);\n    });\n\n    return rgba;\n  };\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 readonly geoid: boolean,\n    private style: Tiles3dStyle,\n    private facades = false,\n    private drape: Drape | undefined = undefined,\n  ) {\n    super(map);\n  }\n\n  /** The box loaded to its finest tiles (`refine`): west, south, east, north, bottom, top */\n  private focus: number[] = [];\n\n  /**\n   * Loads the tiles meeting a box to their finest level, before the others and whether the box is in view or not (a\n   * feature framed to be found in them: its finest geometry, its ID); resolved once they are all there. The box stays\n   * so until another one, or `refine(undefined)`. `box`: as `fitBounds` takes it, altitudes in metres above the\n   * ellipsoid; `timeout` (ms, default 30 s): rejected past it\n   */\n  async refine(box: FitBox | FitBox['bounds'] | undefined, { timeout = 30_000 } = {}): Promise<void> {\n    const { bounds, bottom = -1e4, top = 1e4 } = !box || Array.isArray(box) ? { bounds: box } : box;\n\n    this.focus = bounds ? [...bounds, Math.min(bottom, top), Math.max(bottom, top)] : [];\n    if (this.id >= 0) this.map.engine.setTiles3dFocus(this.id, Float64Array.from(this.focus));\n    this.map.requestRender();\n    if (!bounds) return;\n\n    const focus = this.focus;\n    const until = performance.now() + timeout;\n\n    // Its tiles counted by the frames drawn with the box (undefined before), the box still this one\n    while (this.focus === focus) {\n      const pending = this.id < 0 ? undefined : this.map.engine.tiles3dFocusPending(this.id);\n\n      if (pending === 0) return;\n      if (performance.now() >= until) throw new Error(\"isard: the box's tiles were not loaded in time\");\n      this.map.requestRender();\n      await new Promise((resolve) => setTimeout(resolve, 100));\n    }\n  }\n\n  /** Whether the walls of its untextured meshes (buildings without their photos, as the IGN's Bâtiments 3D) show\n   * windows, as the vector tiles' buildings do: glass by day, some lit at night. Their faces near vertical are walls,\n   * bays of 3 metres along them and floors of 3.2 metres from the ellipsoid (a mesh tells neither foot nor top) */\n  setFacades(facades: boolean): void {\n    this.facades = facades;\n    // Kept for its creation in a new engine (the GPU lost and given back), none while it has no id\n    if (this.id < 0) return;\n    this.map.engine.setTiles3dFacades(this.id, facades);\n    this.map.requestRender();\n  }\n\n  /** A raster layer draped on its meshes, its roofs by default (see `Drape`); undefined: none */\n  setDrape(drape: Drape | undefined): void {\n    this.drape = drape;\n    // Kept for its creation in a new engine (the GPU lost and given back), none while it has no id\n    if (this.id < 0) return;\n    sendDrape(this.map.engine, this.id, drape);\n    this.map.requestRender();\n  }\n\n  setStyle(style: Partial<Tiles3dStyle>): void {\n    this.style = { ...this.style, ...style };\n    // Kept for its creation in a new engine (the GPU lost and given back), none while it has no id\n    if (this.id < 0) return;\n    this.applyStyle(this.map.engine, this.id);\n    // The features colored again only when their function changed: every tile asks for its colors then\n    if ('featureColor' in style) this.applyFeatureColor(this.map.engine, this.id);\n    this.map.requestRender();\n  }\n\n  /** @internal The feature picked (`pickFeature`, 'hoverfeature'): the properties of its feature in the tile\n   * (`EXT_structural_metadata`, a b3dm batch table), none for a mesh without features; its index in the tile as id */\n  featureAt(index: number): Feature<Record<string, unknown>> | undefined {\n    if (this.id < 0) return undefined;\n\n    const hit = this.map.engine.tiles3dFeature(this.id, index);\n\n    if (!hit) return undefined;\n\n    const [properties, feature] = hit;\n\n    return { type: 'Feature', id: feature, properties: properties ?? {}, geometry: null };\n  }\n\n  /**\n   * The first feature of the tiles drawn whose properties `matches` takes (its ID, its attributes), the finest tiles\n   * first: a feature framed and loaded (`fitBounds`, `refine`) found in them, to show or color (`featureColor`);\n   * undefined if none drawn has it\n   */\n  find(matches: (properties: Record<string, unknown>) => boolean): Feature<Record<string, unknown>> | undefined {\n    if (this.id < 0) return undefined;\n\n    const hit = this.map.engine.tiles3dFind(this.id, matches);\n\n    if (!hit) return undefined;\n\n    const [properties, feature] = hit;\n\n    return { type: 'Feature', id: feature, properties, geometry: null };\n  }\n\n  /** Loading counters; undefined once the layer is removed, and while the map waits for a new engine (the GPU lost) */\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 * this.map.quality.errorScale, this.geoid);\n\n    this.applyStyle(engine, id);\n    this.applyFeatureColor(engine, id);\n    engine.setTiles3dFacades(id, this.facades);\n    engine.setTiles3dFocus(id, Float64Array.from(this.focus));\n    // A raster created before (on a new engine, the map relinks once every layer is there)\n    sendDrape(engine, id, this.drape);\n\n    return id;\n  }\n\n  /** @internal On a new engine, the raster may come after the tiles: draped once both are there */\n  override relink(engine: Engine): void {\n    sendDrape(engine, this.id, this.drape);\n  }\n\n  /** @internal */\n  override qualityChanged(): void {\n    if (this.id >= 0) this.applyStyle(this.map.engine, this.id);\n  }\n\n  private applyStyle(engine: Engine, id: number): void {\n    const { maxScreenSpaceError, opacity, pointSize, color } = this.style;\n    // Coarser far away at a lower quality\n    const error = maxScreenSpaceError * this.map.quality.errorScale;\n\n    engine.setTiles3dStyle(id, error, opacity, pointSize, new Float32Array(color ? rgb(color) : []));\n  }\n\n  private applyFeatureColor(engine: Engine, id: number): void {\n    const { featureColor } = this.style;\n\n    engine.setTiles3dFeatureColors(id, featureColor ? featureColors(featureColor) : null);\n  }\n}\n"]}

package/dist/map/engines.d.ts

@@ -2,19 +2,23 @@
  * The engine a map runs, made asynchronously (its device asked for), and the workers decoding its 3D Tiles, started
  * with the first one.
  */
-import { type EngineClass } from '../engine-loader.ts';
+import { type EngineClass, type EngineKind } from '../engine-loader.ts';
 import type { Settings } from '../settings.ts';
 import type { GeoMapOptions } from '../types.ts';
 import type { Engine } from '../wasm/isard_webgpu.js';
 /** What making the engine and its workers needs */
-export type Tiles3dEngineOptions = Pick<GeoMapOptions, 'workers' | 'workerUrl' | 'decoders' | 'pointsWasmUrl' | 'tiles3dWasmUrl' | 'assetsUrl' | 'quality' | 'antialias'>;
+export type Tiles3dEngineOptions = Pick<GeoMapOptions, 'workers' | 'workerUrl' | 'decoders' | 'pointsWasmUrl' | 'tiles3dWasmUrl' | 'webgl2WasmUrl' | 'assetsUrl' | 'quality' | 'antialias'>;
 /** The engine class of a map (the engine on wgpu, through WebGPU or its WebGL2 fallback: one module, 3D Tiles
  * included) and the workers decoding its 3D Tiles, started with the first engine */
 export declare class MapEngines {
-    private readonly engineClass;
+    #private;
+    private engineClass;
     private loader;
     private readonly options;
-    constructor(engineClass: EngineClass, options: Tiles3dEngineOptions);
+    constructor(engineClass: EngineClass, renderer: EngineKind, options: Tiles3dEngineOptions);
+    get renderer(): EngineKind;
+    /** The next engines through WebGL2 (a device WebGPU keeps losing or no longer gives): its module loaded */
+    fallBack(): Promise<void>;
     /** A new engine drawing on `canvas` (its device asked for), with the settings and the decoding workers */
     create(canvas: HTMLCanvasElement, redraw: () => void, settings: Settings): Promise<Engine>;
     /** Height of the geoid above the ellipsoid at a position, in metres */

package/dist/map/engines.js

@@ -2,18 +2,32 @@
  * The engine a map runs, made asynchronously (its device asked for), and the workers decoding its 3D Tiles, started
  * with the first one.
  */
-import { startTileLoader } from "../engine-loader.js";
+import { engineUrl, loadEngine, startTileLoader } from "../engine-loader.js";
 import { applySettings } from "./engine-settings.js";
 /** The engine class of a map (the engine on wgpu, through WebGPU or its WebGL2 fallback: one module, 3D Tiles
  * included) and the workers decoding its 3D Tiles, started with the first engine */
 export class MapEngines {
     engineClass;
+    /** What the engine draws through: WebGPU, or its WebGL2 fallback (`fallBack`) */
+    #renderer;
     loader;
     options;
-    constructor(engineClass, options) {
+    constructor(engineClass, renderer, options) {
         this.engineClass = engineClass;
+        this.#renderer = renderer;
         this.options = { ...options };
     }
+    get renderer() {
+        return this.#renderer;
+    }
+    /** The next engines through WebGL2 (a device WebGPU keeps losing or no longer gives): its module loaded */
+    async fallBack() {
+        if (this.#renderer === 'webgl2')
+            return;
+        const bindings = await loadEngine('webgl2', engineUrl('webgl2', this.options));
+        this.engineClass = bindings.Engine;
+        this.#renderer = 'webgl2';
+    }
     /** A new engine drawing on `canvas` (its device asked for), with the settings and the decoding workers */
     async create(canvas, redraw, settings) {
         const engine = await this.engineClass.create(canvas, redraw, this.options.antialias);

package/dist/map/engines.js.map

@@ -1 +1 @@
-{"version":3,"file":"engines.js","sourceRoot":"","sources":["../../src/map/engines.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAoB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAIxE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQrD;oFACoF;AACpF,MAAM,OAAO,UAAU;IACJ,WAAW,CAAc;IAClC,MAAM,CAAyB;IACtB,OAAO,CAAuB;IAE/C,YAAY,WAAwB,EAAE,OAA6B;QACjE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,MAAM,CAAC,MAAyB,EAAE,MAAkB,EAAE,QAAkB;QAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAErF,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,KAAK,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uEAAuE;IACvE,WAAW,CAAC,GAAW,EAAE,GAAW;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,yDAAyD;IACzD,YAAY,CAAC,GAAW,EAAE,GAAW,EAAE,QAAgB;QACrD,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,iCAAiC;IACjC,OAAO;QACL,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IACzB,CAAC;CACF","sourcesContent":["/**\n * The engine a map runs, made asynchronously (its device asked for), and the workers decoding its 3D Tiles, started\n * with the first one.\n */\n\nimport type { TileLoader } from '../decoding/loader.ts';\nimport { type EngineClass, startTileLoader } from '../engine-loader.ts';\nimport type { Settings } from '../settings.ts';\nimport type { GeoMapOptions } from '../types.ts';\nimport type { Engine } from '../wasm/isard_webgpu.js';\nimport { applySettings } from './engine-settings.ts';\n\n/** What making the engine and its workers needs */\nexport type Tiles3dEngineOptions = Pick<\n  GeoMapOptions,\n  'workers' | 'workerUrl' | 'decoders' | 'pointsWasmUrl' | 'tiles3dWasmUrl' | 'assetsUrl' | 'quality' | 'antialias'\n>;\n\n/** The engine class of a map (the engine on wgpu, through WebGPU or its WebGL2 fallback: one module, 3D Tiles\n * included) and the workers decoding its 3D Tiles, started with the first engine */\nexport class MapEngines {\n  private readonly engineClass: EngineClass;\n  private loader: TileLoader | undefined;\n  private readonly options: Tiles3dEngineOptions;\n\n  constructor(engineClass: EngineClass, options: Tiles3dEngineOptions) {\n    this.engineClass = engineClass;\n    this.options = { ...options };\n  }\n\n  /** A new engine drawing on `canvas` (its device asked for), with the settings and the decoding workers */\n  async create(canvas: HTMLCanvasElement, redraw: () => void, settings: Settings): Promise<Engine> {\n    const engine = await this.engineClass.create(canvas, redraw, this.options.antialias);\n\n    applySettings(engine, settings);\n    this.loader ??= startTileLoader(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  /** Stops the decoding workers */\n  destroy(): void {\n    this.loader?.destroy();\n  }\n}\n"]}
+{"version":3,"file":"engines.js","sourceRoot":"","sources":["../../src/map/engines.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAqC,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAIhH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAgBrD;oFACoF;AACpF,MAAM,OAAO,UAAU;IACb,WAAW,CAAc;IACjC,iFAAiF;IACjF,SAAS,CAAa;IACd,MAAM,CAAyB;IACtB,OAAO,CAAuB;IAE/C,YAAY,WAAwB,EAAE,QAAoB,EAAE,OAA6B;QACvF,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,2GAA2G;IAC3G,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO;QAExC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAE/E,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,MAAM,CAAC,MAAyB,EAAE,MAAkB,EAAE,QAAkB;QAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAErF,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,KAAK,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uEAAuE;IACvE,WAAW,CAAC,GAAW,EAAE,GAAW;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,yDAAyD;IACzD,YAAY,CAAC,GAAW,EAAE,GAAW,EAAE,QAAgB;QACrD,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,iCAAiC;IACjC,OAAO;QACL,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IACzB,CAAC;CACF","sourcesContent":["/**\n * The engine a map runs, made asynchronously (its device asked for), and the workers decoding its 3D Tiles, started\n * with the first one.\n */\n\nimport type { TileLoader } from '../decoding/loader.ts';\nimport { type EngineClass, type EngineKind, engineUrl, loadEngine, startTileLoader } from '../engine-loader.ts';\nimport type { Settings } from '../settings.ts';\nimport type { GeoMapOptions } from '../types.ts';\nimport type { Engine } from '../wasm/isard_webgpu.js';\nimport { applySettings } from './engine-settings.ts';\n\n/** What making the engine and its workers needs */\nexport type Tiles3dEngineOptions = Pick<\n  GeoMapOptions,\n  | 'workers'\n  | 'workerUrl'\n  | 'decoders'\n  | 'pointsWasmUrl'\n  | 'tiles3dWasmUrl'\n  | 'webgl2WasmUrl'\n  | 'assetsUrl'\n  | 'quality'\n  | 'antialias'\n>;\n\n/** The engine class of a map (the engine on wgpu, through WebGPU or its WebGL2 fallback: one module, 3D Tiles\n * included) and the workers decoding its 3D Tiles, started with the first engine */\nexport class MapEngines {\n  private engineClass: EngineClass;\n  /** What the engine draws through: WebGPU, or its WebGL2 fallback (`fallBack`) */\n  #renderer: EngineKind;\n  private loader: TileLoader | undefined;\n  private readonly options: Tiles3dEngineOptions;\n\n  constructor(engineClass: EngineClass, renderer: EngineKind, options: Tiles3dEngineOptions) {\n    this.engineClass = engineClass;\n    this.#renderer = renderer;\n    this.options = { ...options };\n  }\n\n  get renderer(): EngineKind {\n    return this.#renderer;\n  }\n\n  /** The next engines through WebGL2 (a device WebGPU keeps losing or no longer gives): its module loaded */\n  async fallBack(): Promise<void> {\n    if (this.#renderer === 'webgl2') return;\n\n    const bindings = await loadEngine('webgl2', engineUrl('webgl2', this.options));\n\n    this.engineClass = bindings.Engine;\n    this.#renderer = 'webgl2';\n  }\n\n  /** A new engine drawing on `canvas` (its device asked for), with the settings and the decoding workers */\n  async create(canvas: HTMLCanvasElement, redraw: () => void, settings: Settings): Promise<Engine> {\n    const engine = await this.engineClass.create(canvas, redraw, this.options.antialias);\n\n    applySettings(engine, settings);\n    this.loader ??= startTileLoader(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  /** Stops the decoding workers */\n  destroy(): void {\n    this.loader?.destroy();\n  }\n}\n"]}

package/dist/map/events.js

@@ -12,6 +12,7 @@ export class MapListeners {
         click: new Set(),
         render: new Set(),
         quality: new Set(),
+        gpulost: new Set(),
         idle: new Set(),
         leave: new Set(),
         clipvolume: new Set(),

package/dist/map/events.js.map

@@ -1 +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,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,UAAU,EAAE,IAAI,GAAG,EAAE;KACtB,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    quality: new Set(),\n    idle: new Set(),\n    leave: new Set(),\n    clipvolume: 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"]}
+{"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,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,IAAI,EAAE,IAAI,GAAG,EAAE;QACf,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,UAAU,EAAE,IAAI,GAAG,EAAE;KACtB,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    quality: new Set(),\n    gpulost: new Set(),\n    idle: new Set(),\n    leave: new Set(),\n    clipvolume: 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.d.ts

@@ -26,7 +26,7 @@ import { Tiles3dLayer } from './layers/tiles3d.ts';
 import { type TreeOptions } from './layers/trees.ts';
 import { type HoverPicking } from './map/hover-pick.ts';
 import { type LayerSpec } from './map/layer-spec.ts';
-import type { AnimationOptions, AtmosphereOptions, Basemap, ClipVolume, FeatureHit, FirstPersonView, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, MapGpuTimings, MapMemory, NetworkOptions, PickOptions, Point, Projection, Quality, RasterOptions, SunOptions, SwipeOptions, TerrainModel, TerrainOptions, Tiles3dOptions, ViewshedOptions } from './types.ts';
+import type { AnimationOptions, AtmosphereOptions, Basemap, ClipVolume, FeatureHit, FirstPersonView, FitBoundsOptions, FitBox, FlyToOptions, GeoMapOptions, LoadingMode, LonLat, MapEvents, MapGpuTimings, MapMemory, NetworkOptions, PickOptions, Point, Projection, Quality, RasterOptions, SunOptions, SwipeOptions, TerrainModel, TerrainOptions, Tiles3dOptions, ViewshedOptions } from './types.ts';
 import { type Control, type ControlPosition } from './ui/controls.ts';
 import type { Camera, PickHit, RasterLayerStats } from './wasm/isard_webgpu.js';
 export type { LayerSpec } from './map/layer-spec.ts';
@@ -85,15 +85,25 @@ export declare class GeoMap {
     private get layers();
     /** Layers new layers go under */
     private get onTop();
+    /** What the map draws through: `'webgpu'`, or `'webgl2'` (the fallback of a browser without WebGPU, or of a device
+     * WebGPU kept losing) */
+    get renderer(): 'webgpu' | 'webgl2';
     /** The GPU is lost: nothing drawn, the engine dropped (`dropLostEngine`) */
     private gpuLost;
     /**
      * Follows the loss of `engine`'s WebGPU device (a phone taking its memory back, a driver reset, the GPU process
      * gone): while it is the map's, the map drops it and makes a new one at once, WebGPU having no event for the GPU
-     * given back. The device of an engine the map freed itself (replaced, the map destroyed) is lost too: not the map's
-     * any more, left be
+     * given back, lighter so as not to lose it again (`lighten`). The device of an engine the map freed itself
+     * (replaced, the map destroyed) is lost too: not the map's any more, left be
      */
     private watchDevice;
+    /**
+     * After a device lost, the next engine lighter, the same scene then holding less: at the first loss the low quality
+     * (one pixel a CSS pixel, no sun's shadows, one worker, fewer tiles far away) and half the GPU memory budget; at the
+     * next one, the WebGL2 fallback (a phone whose WebGPU keeps losing its device: Safari's GPU process taking its
+     * memory back) and half the budget again. What it did: `'lighter'` or `'webgl2'`
+     */
+    private lighten;
     /**
      * The context is lost: its engine freed at once, the map's calls going to one that does nothing until `restore`
      * builds the next. The old engine's GPU objects went with the context: deleted now, it is silent (on the context
@@ -148,6 +158,16 @@ export declare class GeoMap {
      * `flyTo`): long moves stay readable. Pitch and bearing follow the progress.
      */
     flyTo(camera: Partial<Camera>, options?: FlyToOptions): void;
+    /**
+     * Moves the camera to frame a box: a ground box (`[west, south, east, north]`), or a box in space (a building, a
+     * pipe underground: `{ bounds, bottom, top }`, altitudes in metres), all its corners within the canvas less the
+     * padding, at the pitch and bearing given (default the current ones); an ease, a flight with `fly`, a jump with
+     * `duration: 0`
+     */
+    fitBounds(box: FitBox | FitBox['bounds'], options?: FitBoundsOptions): void;
+    /** Height of the RAF20 geoid above the ellipsoid at a position (metres; 0 away from mainland France): what turns an
+     * altitude (NGF-IGN69: the BD TOPO's, the RGE ALTI's) into a height above the ellipsoid (`fitBounds`, `refine`) */
+    geoidHeight([lon, lat]: LonLat): number;
     /** Longitudes and latitudes the view covers on the ground: `[west, south, east, north]` */
     getBounds(): [west: number, south: number, east: number, north: number];
     /** Lowest zoom the camera accepts (the widest view) */

package/dist/map.js

@@ -61,6 +61,8 @@ const BODY_START = { center: [0, 0], zoom: 2, pitch: 0, bearing: 0 };
 const FIRST_PERSON_PITCH = [1, 179];
 /** The eye's field of view at street level (degrees): from a telephoto to a wide angle, the projection still sane */
 const FIRST_PERSON_FOV = [10, 140];
+/** The least GPU memory budget a lost device leaves the map (bytes, `lighten`) */
+const MIN_MEMORY = 64 * 2 ** 20;
 /** A network's defaults: the values past which it is unreached (half an hour of travel, in seconds), its halo's
  * opacity at the middle of a line (a glow, not a second line) */
 const NETWORK_MAX = 1800;
@@ -141,7 +143,7 @@ export class GeoMap {
         // The engine on wgpu (#146): WebGPU, else wgpu's WebGL2 fallback
         const kind = await rendererKind(options.renderer);
         const bindings = await loadEngine(kind, engineUrl(kind, options));
-        const map = new GeoMap(container, options, bindings.Engine);
+        const map = new GeoMap(container, options, bindings.Engine, kind);
         // Its device asked for: the map started on a placeholder meanwhile, its layers created on the engine once it is
         // there (as after a context loss)
         map.adopt(await map.engines.create(map.canvas, () => map.requestRender(), map.settings));
@@ -152,8 +154,8 @@ export class GeoMap {
         }
         return map;
     }
-    constructor(container, options, engineClass) {
-        this.engines = new MapEngines(engineClass, options);
+    constructor(container, options, engineClass, renderer) {
+        this.engines = new MapEngines(engineClass, renderer, options);
         const workerUrl = options.basemapWorkerUrl ?? defaultWorkerUrl(options.assetsUrl);
         this.tessUrl = tessUrl(options);
         this.gridUrl = gridUrl(options);
@@ -238,6 +240,13 @@ export class GeoMap {
     get onTop() {
         return this.stack.onTop;
     }
+    /** WebGPU devices lost so far: each one makes the next engine lighter (`lighten`) */
+    #losses = 0;
+    /** What the map draws through: `'webgpu'`, or `'webgl2'` (the fallback of a browser without WebGPU, or of a device
+     * WebGPU kept losing) */
+    get renderer() {
+        return this.engines.renderer;
+    }
     /** The GPU is lost: nothing drawn, the engine dropped (`dropLostEngine`) */
     gpuLost() {
         this.lost = true;
@@ -247,17 +256,40 @@ export class GeoMap {
     /**
      * Follows the loss of `engine`'s WebGPU device (a phone taking its memory back, a driver reset, the GPU process
      * gone): while it is the map's, the map drops it and makes a new one at once, WebGPU having no event for the GPU
-     * given back. The device of an engine the map freed itself (replaced, the map destroyed) is lost too: not the map's
-     * any more, left be
+     * given back, lighter so as not to lose it again (`lighten`). The device of an engine the map freed itself
+     * (replaced, the map destroyed) is lost too: not the map's any more, left be
      */
     watchDevice(engine) {
-        void engine.gpuDevice()?.lost.then((info) => {
+        void engine
+            .gpuDevice()
+            ?.lost.then(async (info) => {
             if (this.gone || this.#engine !== engine)
                 return;
-            console.warn(`isard: the GPU device was lost (${info.reason}: ${info.message}), the map made again`);
             this.gpuLost();
+            const recovery = await this.lighten();
+            console.warn(`isard: the GPU device was lost (${info.reason}: ${info.message}), the map made again (${recovery})`);
+            this.emit('gpulost', { reason: info.reason, message: info.message, losses: this.#losses, recovery });
             this.restore();
-        });
+        })
+            // The fallback's module not loaded: told, as a failed restore is
+            .catch(report);
+    }
+    /**
+     * After a device lost, the next engine lighter, the same scene then holding less: at the first loss the low quality
+     * (one pixel a CSS pixel, no sun's shadows, one worker, fewer tiles far away) and half the GPU memory budget; at the
+     * next one, the WebGL2 fallback (a phone whose WebGPU keeps losing its device: Safari's GPU process taking its
+     * memory back) and half the budget again. What it did: `'lighter'` or `'webgl2'`
+     */
+    async lighten() {
+        this.#losses += 1;
+        this.settings.memory = Math.max(MIN_MEMORY, this.settings.memory / 2);
+        if (this.#losses === 1 || this.engines.renderer === 'webgl2') {
+            this.qualityWatch = undefined;
+            this.applyQuality('low');
+            return 'lighter';
+        }
+        await this.engines.fallBack();
+        return 'webgl2';
     }
     /**
      * The context is lost: its engine freed at once, the map's calls going to one that does nothing until `restore`
@@ -278,8 +310,17 @@ export class GeoMap {
     restore() {
         if (this.gone)
             return;
-        this.engines
-            .create(this.canvas, () => this.requestRender(), this.settings)
+        const make = () => this.engines.create(this.canvas, () => this.requestRender(), this.settings);
+        make()
+            .catch(async (error) => {
+            // WebGPU giving no new device after a loss (an adapter refused): the WebGL2 fallback
+            if (this.engines.renderer === 'webgl2')
+                throw error;
+            console.warn(`isard: no new WebGPU device (${String(error)}), the map made again through WebGL2`);
+            await this.engines.fallBack();
+            this.emit('gpulost', { reason: 'unknown', message: String(error), losses: this.#losses, recovery: 'webgl2' });
+            return make();
+        })
             .then((engine) => this.adopt(engine))
             .catch(report);
     }
@@ -480,6 +521,35 @@ export class GeoMap {
         this.animate(flyTo(() => this.engine, from, to, viewport, options));
         this.engine.preload(to.center[0], to.center[1], to.zoom, to.pitch, to.bearing);
     }
+    /**
+     * Moves the camera to frame a box: a ground box (`[west, south, east, north]`), or a box in space (a building, a
+     * pipe underground: `{ bounds, bottom, top }`, altitudes in metres), all its corners within the canvas less the
+     * padding, at the pitch and bearing given (default the current ones); an ease, a flight with `fly`, a jump with
+     * `duration: 0`
+     */
+    fitBounds(box, options = {}) {
+        const { bounds, bottom = 0, top = bottom } = Array.isArray(box) ? { bounds: box } : box;
+        const current = this.getCamera();
+        const room = options.padding ?? 40;
+        const padding = typeof room === 'number'
+            ? [room, room, room, room]
+            : [room.top ?? 0, room.right ?? 0, room.bottom ?? 0, room.left ?? 0];
+        const camera = this.engine.fitCamera(Float64Array.from(bounds), bottom, top, Float64Array.from(padding), options.pitch ?? current.pitch, options.bearing ?? current.bearing);
+        if (!camera)
+            throw new Error('isard: fitBounds needs a box, west not past east nor south past north');
+        const to = { ...camera, zoom: Math.min(camera.zoom, options.maxZoom ?? Number.POSITIVE_INFINITY) };
+        if (options.duration === 0)
+            this.setCamera(to);
+        else if (options.fly)
+            this.flyTo(to, options);
+        else
+            this.easeTo(to, { duration: 600, ...options });
+    }
+    /** Height of the RAF20 geoid above the ellipsoid at a position (metres; 0 away from mainland France): what turns an
+     * altitude (NGF-IGN69: the BD TOPO's, the RGE ALTI's) into a height above the ellipsoid (`fitBounds`, `refine`) */
+    geoidHeight([lon, lat]) {
+        return this.engines.geoidHeight(lon, lat);
+    }
     /** Longitudes and latitudes the view covers on the ground: `[west, south, east, north]` */
     getBounds() {
         const [west = -180, south = -85, east = 180, north = 85] = this.engine.bounds();