isard 2.4.2 → 2.5.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.

package/README.md

@@ -187,9 +187,8 @@ 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: a feature found by its attributes and framed (#176); 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.
+- **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

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.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';
@@ -158,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

@@ -521,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();