isard 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -3,6 +3,127 @@
 Every notable change of `isard` (published as `@ign-junn/isard` up to 0.1.1). The format follows [Keep a Changelog](https://keepachangelog.com), the
 versions [Semantic Versioning](https://semver.org) (before 1.0.0, a minor version may change an API).
 
+## [1.3.0] - 2026-10-23
+
+### Added
+
+- `vectorTiles().vectors()`: the fills and lines of a MapLibre style drawn as geometry on the globe and the relief,
+  tile by tile (cut in the basemap workers, `vectors` job), rather than into raster images: sharp at any zoom and
+  pitch, in the style's order with each layer's zoom range, dashes, widths following the zoom, restyled without
+  cutting the tiles again (`setPaintProperty`, `setLayoutProperty`), picked by feature with its style layer
+  (`VectorLayer`); `<VectorGeometry>` in React (`paint` by style layer or as a function of it, `visible`, `order`).
+  The tiles are made ready for the GPU in the basemap workers (their fills triangulated, their lines cut) by the
+  tessellation module, `isard_tess_bg.wasm` (37 KB gzipped, the engine's own code, loaded with the first tile; the
+  main thread does it without), the main thread only uploading them: on a scripted flight over Paris with the whole
+  Positron style, half the main thread's time of the engine doing it, about that of the raster path. They follow the
+  camera while it moves. Their geometry is the engine's only (the layer keeps what picking needs): an engine made
+  anew, after a context loss or with 3D Tiles, has them cut again by the workers, about 1 MB of JavaScript heap less per
+  tile of the whole Positron style. The example Vector basemaps draws the water so, in TypeScript and React. About 12 KB
+  gzipped more for the engine.
+- The swipe's `other` layers, shown on the other side of the line only (`setSwipe({ layers, other })`, `<SwipeOther>`
+  in React): two meshes of the same place, each on its side, never drawn over each other. The example Swipe on a mesh
+  (Strasbourg's photomeshes of 2018 and 2022), in TypeScript and React.
+- Controls: `ScaleControl`, `SearchControl` (the Géoplateforme's geocoding by default, `geoplateformeGeocode`) and
+  `MinimapControl`; the example Globe IGN (orthophotos, relief, PLAN IGN's vector tiles and labels over them, its buildings,
+  the four controls), in TypeScript and React.
+- `vectorTiles().extrusions()`: the buildings of vector tiles (PLAN IGN's `bati_surf`, OpenMapTiles' `building`)
+  raised by the style given, their tiles following the view (decoded in the basemap workers, handed over as typed
+  arrays); the Globe IGN example's buildings everywhere the map goes.
+- Without relief, the camera settles on the 3D Tiles mesh under its center rather than at sea level, on its lowest
+  surface around the center (the street, not a roof or a spire, nothing jumping as the map zooms): a mesh shown alone
+  (`basemap: 'none'`), as in the example Swipe on a mesh, which no longer loads relief nor imagery under its meshes.
+  The layers standing on the map's ground (blocks, models) leave the camera at sea level.
+- 3D Tiles in the legacy `CESIUM_RTC` glTF extension (ContextCapture's exports), its center applied as `RTC_CENTER`.
+
+- 3D trees: `vectorTiles().trees()` grows trees on the woods and grass of the vector tiles. The basemap workers
+  scatter them on a jittered grid, the same ones each time a tile is cut. They are one instanced draw, dense near the
+  view's center and thinned far away (`maxInstances`), with their colors as given (`TreeColors`, `treeModel`). Example:
+  Trees (the forest of Fontainebleau over the relief).
+- Buildings in `vectors()`: the style's `fill-extrusion` layers are raised to their height and base height in the same
+  tiles, lit by the side they face.
+- The sun's shadows: `map.setSun({ date } | { azimuth, altitude }, opacity, night)`, the `sun` option or
+  `<IsardMap sun>`, with `sunPosition(date, lonLat)`. The solid scene (buildings, trees, models, 3D Tiles, the relief) is
+  drawn from the sun into a 2048² depth map around the view, then a pass darkens what the sun does not reach, before
+  the labels.
+- The night: as the sun sets (from 6° above the horizon to 6° under it, or `night` set by hand), the frame is tinted
+  in the blue of the night and the shadows fade. The windows of the buildings of `vectors()` and `extrusions()` light
+  up, floor by floor and bay by bay, the same ones from frame to frame and wherever the view or the tile is. The
+  streets glow, with `vectors({ streets })` or `<VectorGeometry streets>` choosing which ones. The labels turn light on
+  dark.
+- `vectors()` drawn closer to MapLibre: the lines' ends as their `line-cap` says, the fills' outlines
+  (`fill-outline-color`) one pixel wide, and the colors following the camera's zoom across tiles of every level.
+- Overzoom in `vectors()`: past the source's deepest level, its tiles are cut again into deeper ones down to level 18,
+  with the filters and styles of their level. A building cut at a tile's edge rises no wall there.
+- Examples: A 3D vector map (Paris from OpenFreeMap's Liberty style, all of it as geometry, a summer evening), Paris
+  by night (a clock through the day), Inside a shopping mall (Westfield Les 4 Temps at La Défense floor by floor, from
+  OpenStreetMap's indoor data), in TypeScript and React; the examples grouped by subject, each on one page with its
+  TypeScript and React sources in tabs.
+- `bun run perf`: the frames, long tasks and heap of the 3D vector examples while dragged, to run before and after a
+  change of the drawing.
+
+### Fixed
+
+- With a sun, the labels are drawn after the shadows and the night: a layer stacked over a label layer is shaded and
+  lit too. The lights are drawn on both faces of the walls (whichever way their rings wind) and in their columns of
+  the swipe.
+- `vectors()`: a tile's colors are judged translucent by their last zoom too. A tile stretched far past its level
+  mixes its colors over its first zooms. An outline added or taken away (`fill-outline-color`, `fill-antialias`) cuts
+  the tiles again instead of dropping their restyles.
+- `trees()`: the cells are bounded per tile, so a small `spacing` no longer freezes a worker, and a ring of many
+  points no longer overflows the call stack.
+- At night, no glare toward the horizon: the windows fade out under two pixels a bay, and the streets' glow narrows
+  and fades far away.
+- `map.whenIdle()` on a map already idle, and the `ready` of a layer added to it that loads nothing (lines from
+  data, the geometry of vector tiles), resolved by the next frame: they waited for an 'idle' that no frame sent.
+- The examples' indexes of the docs: one row per example, the React ones listed again.
+
+### Changed
+
+- The large files are split by what they do: the basemap worker's jobs in `src/workers/basemap/`, the worker pool
+  and the PMTiles layers out of `vectortiles.ts`, a vector layer's tile and its JavaScript API out of `render/vectors.rs`.
+  `geo`'s modules are grouped (`view/`, `body/`, `mesh/`), the RAF20 geoid grid moved to `crates/geo/data/`, and each
+  crate has a README.
+- The models' relief altitudes are kept by position across instance sets. The tessellation's arrays are copied once.
+  `extrusions()` follows the view while it moves.
+- The docs: the React section written as a library's (installation, quick start, guide), the home page's features,
+  the roadmap and the architecture (an interactive diagram) brought up to date.
+- The repository that publishes and builds the docs chosen by its variables (`RELEASE`, `DOCS_BASE`); a contributing
+  guide, a security policy, a code of conduct and the templates of issues and pull requests; the PLAN IGN tiles of
+  two visual tests recorded, which no longer reach the network.
+
+## [1.2.0] - 2026-10-22
+
+### Added
+
+- `isard/react`: `<Layer>` typed by the properties of its features and its handle by its `type`, a `values` prop
+  (`setValues`) and its `filter` sent by `setFilter`; `<IsardMap hoverPicking>`; `<Control>` and `<CustomLayer>`. Each
+  component in its own file. The `HoverPicking` type exported.
+- Every example also in React (`examples/react/`), side by side in the docs (TypeScript and React groups); the live
+  example above the code in the React pages; the install commands for npm, bun, yarn and pnpm.
+
+### Changed
+
+- Arrow functions, array methods and `const` across the TypeScript sources (loops kept where they are hot); blank
+  lines around declarations and before returns, in TypeScript and Rust.
+- Type guards in place of type assertions: the data read from outside (MapLibre styles, TileJSON, sprite indexes,
+  panoramas' orientations and calibrations, WFS pages, TopoJSON, the viewer's messages) checked at run time, a clear
+  error when it is not what it should be; `GeoMap`'s internals in `src/map/`.
+- The Rust crates read by a newcomer: every public item documented (`missing_docs`), every `unsafe` justified
+  (`undocumented_unsafe_blocks`), the failures of the functions returning a `Result` (`# Errors`), the long functions
+  of a frame, a tile's arrival or a request split into named steps, the lint exceptions as `#[expect(…, reason)]`, one
+  module layout (no `mod.rs`), the crates' shared fields in `[workspace.package]`; an Architecture page in the guide
+  (the engines, the SDK, the workers, a frame, a tile).
+- The Rust files grouped and split by subject: `render/features/` (lines, circles, fills), `render/backdrop/` (globe,
+  sky), the camera, the shapes, the labels and the COPC point clouds in submodules, meshopt under `decode/`; the few
+  duplicated blocks as shared helpers (0.41 % of the lines duplicated to 0.03 %).
+- The crates' dependencies vetted by the checks (`cargo-deny`: known vulnerabilities, licences, sources); the
+  Architecture page of its own, its diagram played step by step (a frame, a raster tile, a vector basemap tile, 3D
+  Tiles), each part's role and files on click.
+
+### Fixed
+
+- A marker's popup opened before the marker is added to the map stays open (`Marker.addTo`).
+
 ## [1.1.0] - 2026-10-21
 
 ### Added

package/README.md

@@ -10,13 +10,13 @@ A WebGL2 map engine for large, interactive data layers, labels and 3D Tiles.<br
 Rust core in WebAssembly, a small TypeScript API.
 
 [![npm](https://img.shields.io/npm/v/isard?color=2f6fd1)](https://www.npmjs.com/package/isard)
-[![Documentation](https://img.shields.io/badge/docs-graffkevin.github.io%2Fisard-2f6fd1)](https://graffkevin.github.io/isard/)
-[![Checks](https://github.com/graffkevin/isard/actions/workflows/checks.yml/badge.svg)](https://github.com/graffkevin/isard/actions/workflows/checks.yml)
+[![Documentation](https://img.shields.io/badge/docs-IGNF%2Fisard-2f6fd1)](https://ideal-adventure-zqn6y6p.pages.github.io/)
+[![Checks](https://github.com/IGNF/isard/actions/workflows/checks.yml/badge.svg)](https://github.com/IGNF/isard/actions/workflows/checks.yml)
 [![Licence: MIT](https://img.shields.io/badge/licence-MIT-blue)](LICENSE)
 
-**[Documentation](https://graffkevin.github.io/isard/)** ·
-**[Examples](https://graffkevin.github.io/isard/examples/)** ·
-**[API](https://graffkevin.github.io/isard/api)** ·
+**[Documentation](https://ideal-adventure-zqn6y6p.pages.github.io/)** ·
+**[Examples](https://ideal-adventure-zqn6y6p.pages.github.io/examples/)** ·
+**[API](https://ideal-adventure-zqn6y6p.pages.github.io/api)** ·
 **[Changelog](CHANGELOG.md)**
 
 <img src="docs/public/screenshots/hero.jpg" alt="Isard: rings drawn by a shader over the relief of the Mont Blanc, buildings colored by height, communes colored by population, the globe" />
@@ -33,20 +33,24 @@ General-purpose map libraries spend their time on things these maps do not need.
 - 🗺️ **Basemaps and relief, worldwide.** OpenFreeMap's vector basemaps by default (OpenStreetMap data, no key), any
   MapLibre style drawn in workers with its labels above your data, raster tiles, a worldwide relief, on a globe that
   turns into Web Mercator. The Géoplateforme's data for France in one option or call: PLAN.IGN, orthophotos,
-  hillshade, the IGN relief, any WMTS, WMS or WFS layer ([Géoplateforme (IGN) data](https://graffkevin.github.io/isard/guide/geoplateforme)).
+  hillshade, the IGN relief, any WMTS, WMS or WFS layer ([Géoplateforme (IGN) data](https://ideal-adventure-zqn6y6p.pages.github.io/guide/geoplateforme)).
 - ⛰️ **Everything on the relief.** Lines, circles, labels and buildings stand on the ground; fills of any size are
   exact to the pixel over hills and valleys; your own GLSL is drawn over the ground like the basemap.
 - 🪐 **The Moon, Mars, any body.** `body: 'moon'`, `'mars'` or an ellipsoid of your own: the globe at its radius
   with its own atmosphere halo (or none), its metres in the camera, the relief and 3D Tiles, NASA's planetary mosaics
   reprojected in the page from longitudes and latitudes, and their relief: `terrain: true` raises Olympus Mons and
   digs Valles Marineris and the lunar craters from NASA's LOLA and MOLA models.
+- 🌃 **A 3D vector city.** Any MapLibre style as geometry (`vectors()`): its streets, water and buildings raised from
+  its `fill-extrusion` layers, sharp at any zoom (its tiles cut again past the source's deepest level), 3D trees in
+  its woods, the sun's shadows at any hour, the night with lit windows and glowing streets; indoor data floor by floor
+  (a shopping mall, its shops raised and named).
 - 🏙️ **Buildings and 3D Tiles.** Buildings colored by a value or by a network's travel times, photomeshes and city
   models in 3D Tiles (Draco, meshopt, KTX2).
 - ☁️ **Point clouds.** LiDAR in COPC read by range requests (the IGN's LiDAR HD, reprojected from Lambert-93 onto the
   relief), 3D Tiles points; colored by RGB, class, altitude or intensity, Eye-Dome Lighting, a point budget, picked.
 - 🧊 **Your own 3D.** glTF models at positions, instanced and picked; custom layers for your WebGL code or a three.js
   scene, in the map's frame and depth, with camera-relative matrices exact at any zoom.
-- 🦀 **Small and exact.** 225 KB of WebAssembly gzipped (385 KB once a 3D Tiles layer, a model or a point cloud is added), f64 on the CPU and f32 relative to the camera on the GPU
+- 🦀 **Small and exact.** 272 KB of WebAssembly gzipped (446 KB once a 3D Tiles layer, a model or a point cloud is added), f64 on the CPU and f32 relative to the camera on the GPU
   (centimetres at any zoom), frames on demand only, strict TypeScript types end to end.
 
 ## Quick start
@@ -64,32 +68,32 @@ map.on('hover', ({ lonLat }) => lonLat && network.setValues(travelTimes(lonLat))
 ```
 
 That is the whole integration: the map fills its container, follows its size, handles mouse and touch and loads the
-basemap. With a bundler, see [Getting started](https://graffkevin.github.io/isard/guide/getting-started#with-a-bundler).
+basemap. With a bundler, see [Getting started](https://ideal-adventure-zqn6y6p.pages.github.io/guide/getting-started#with-a-bundler).
 
 ## Examples
 
-Live in the [documentation](https://graffkevin.github.io/isard/examples/), sources in [`examples/`](examples/).
+Live in the [documentation](https://ideal-adventure-zqn6y6p.pages.github.io/examples/), sources in [`examples/`](examples/).
 
 <table>
   <tr>
-    <td width="50%"><a href="https://graffkevin.github.io/isard/examples/globe"><img src="docs/public/screenshots/globe.jpg" alt="" /></a><br /><b>The globe</b><br />turning in its atmosphere, a flight to a click</td>
-    <td width="50%"><a href="https://graffkevin.github.io/isard/examples/basic"><img src="docs/public/screenshots/basic.jpg" alt="" /></a><br /><b>A map</b><br />the vector basemap, a marker and its popup</td>
+    <td width="50%"><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/globe"><img src="docs/public/screenshots/globe.jpg" alt="" /></a><br /><b>The globe</b><br />turning in its atmosphere, a flight to a click</td>
+    <td width="50%"><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/basic"><img src="docs/public/screenshots/basic.jpg" alt="" /></a><br /><b>A map</b><br />the vector basemap, a marker and its popup</td>
   </tr>
   <tr>
-    <td><a href="https://graffkevin.github.io/isard/examples/geojson"><img src="docs/public/screenshots/geojson.jpg" alt="" /></a><br /><b>GeoJSON layers</b><br />fills by value, outlines, labels, picking</td>
-    <td><a href="https://graffkevin.github.io/isard/examples/buildings"><img src="docs/public/screenshots/buildings.jpg" alt="" /></a><br /><b>Buildings</b><br />raised to their height, colored by it</td>
+    <td><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/geojson"><img src="docs/public/screenshots/geojson.jpg" alt="" /></a><br /><b>GeoJSON layers</b><br />fills by value, outlines, labels, picking</td>
+    <td><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/buildings"><img src="docs/public/screenshots/buildings.jpg" alt="" /></a><br /><b>Buildings</b><br />raised to their height, colored by it</td>
   </tr>
   <tr>
-    <td><a href="https://graffkevin.github.io/isard/examples/relief"><img src="docs/public/screenshots/relief.jpg" alt="" /></a><br /><b>Relief and a ground shader</b><br />your GLSL over the mountains</td>
-    <td><a href="https://graffkevin.github.io/isard/examples/network"><img src="docs/public/screenshots/network.jpg" alt="" /></a><br /><b>Travel times on hover</b><br />a network recolored at every move</td>
+    <td><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/relief"><img src="docs/public/screenshots/relief.jpg" alt="" /></a><br /><b>Relief and a ground shader</b><br />your GLSL over the mountains</td>
+    <td><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/network"><img src="docs/public/screenshots/network.jpg" alt="" /></a><br /><b>Travel times on hover</b><br />a network recolored at every move</td>
   </tr>
   <tr>
-    <td><a href="https://graffkevin.github.io/isard/examples/vector"><img src="docs/public/screenshots/vector.jpg" alt="" /></a><br /><b>Vector basemaps</b><br />OpenFreeMap's styles, a restyled subset</td>
-    <td><a href="https://graffkevin.github.io/isard/examples/tiles3d"><img src="docs/public/screenshots/tiles3d.jpg" alt="" /></a><br /><b>3D Tiles</b><br />the Lille photomesh</td>
+    <td><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/vector"><img src="docs/public/screenshots/vector.jpg" alt="" /></a><br /><b>Vector basemaps</b><br />OpenFreeMap's styles, a restyled subset, the water drawn as geometry</td>
+    <td><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/tiles3d"><img src="docs/public/screenshots/tiles3d.jpg" alt="" /></a><br /><b>3D Tiles</b><br />the Lille photomesh</td>
   </tr>
   <tr>
-    <td><a href="https://graffkevin.github.io/isard/examples/moon"><img src="docs/public/screenshots/moon.jpg" alt="" /></a><br /><b>The Moon</b><br />another body, the LRO mosaic over LOLA's relief, the Apollo sites</td>
-    <td><a href="https://graffkevin.github.io/isard/examples/mars"><img src="docs/public/screenshots/mars.jpg" alt="" /></a><br /><b>Mars</b><br />its thin dusty halo, the Viking mosaic over MOLA's relief, famous sites</td>
+    <td><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/moon"><img src="docs/public/screenshots/moon.jpg" alt="" /></a><br /><b>The Moon</b><br />another body, the LRO mosaic over LOLA's relief, the Apollo sites</td>
+    <td><a href="https://ideal-adventure-zqn6y6p.pages.github.io/examples/mars"><img src="docs/public/screenshots/mars.jpg" alt="" /></a><br /><b>Mars</b><br />its thin dusty halo, the Viking mosaic over MOLA's relief, famous sites</td>
   </tr>
 </table>
 
@@ -97,32 +101,32 @@ Live in the [documentation](https://graffkevin.github.io/isard/examples/), sourc
 
 | Layer | | |
 |---|---|---|
-| [Networks](https://graffkevin.github.io/isard/layers/networks) | `addNetwork` | millions of edges colored by a value per node, worked out per pixel along the edges |
-| [Lines, circles, fills](https://graffkevin.github.io/isard/layers/features) | `addLines`, `addCircles`, `addFills` | GeoJSON styled per feature: zoom stops, functions, values through a ramp, filters; in any CRS, KML, GPX and TopoJSON parsed |
-| [Labels](https://graffkevin.github.io/isard/layers/labels) | `addSymbols` | SDF fonts (Noto Sans by default, any glyphs), halos, along lines, collisions shared by all layers |
-| [Buildings](https://graffkevin.github.io/isard/layers/buildings) | `addExtrusions` | tiles or one set, colored by values or by a network's times |
-| [Ground shaders](https://graffkevin.github.io/isard/layers/ground) | `addGround` | your fragment shader over the ground: water depth, heat maps |
-| [Rasters](https://graffkevin.github.io/isard/layers/rasters) | `addRaster`, `addPmtiles` | XYZ, WMTS, WMS, PMTiles; in Web Mercator, or reprojected from another grid (longitudes and latitudes, Lambert-93, UTM, any CRS through proj4); or tiles drawn by your code |
-| [3D Tiles](https://graffkevin.github.io/isard/layers/tiles3d) | `addTiles3d` | b3dm, pnts, glb, external tilesets, compressed or not |
-| [glTF models](https://graffkevin.github.io/isard/layers/models) | `addModels` | a glTF model at many positions, instanced, on the relief, picked |
-| [Point clouds](https://graffkevin.github.io/isard/layers/pointclouds) | `addPointCloud` | COPC (LiDAR HD) by range requests, pnts and glTF points; by class, altitude, intensity, EDL |
-| [Custom layers](https://graffkevin.github.io/isard/layers/custom) | `addCustomLayer` | your WebGL code or a three.js scene in the map's frame, sharing its depth |
+| [Networks](https://ideal-adventure-zqn6y6p.pages.github.io/layers/networks) | `addNetwork` | millions of edges colored by a value per node, worked out per pixel along the edges |
+| [Lines, circles, fills](https://ideal-adventure-zqn6y6p.pages.github.io/layers/features) | `addLines`, `addCircles`, `addFills` | GeoJSON styled per feature: zoom stops, functions, values through a ramp, filters; in any CRS, KML, GPX and TopoJSON parsed |
+| [Labels](https://ideal-adventure-zqn6y6p.pages.github.io/layers/labels) | `addSymbols` | SDF fonts (Noto Sans by default, any glyphs), halos, along lines, collisions shared by all layers |
+| [Buildings](https://ideal-adventure-zqn6y6p.pages.github.io/layers/buildings) | `addExtrusions` | tiles or one set, colored by values or by a network's times |
+| [Ground shaders](https://ideal-adventure-zqn6y6p.pages.github.io/layers/ground) | `addGround` | your fragment shader over the ground: water depth, heat maps |
+| [Rasters](https://ideal-adventure-zqn6y6p.pages.github.io/layers/rasters) | `addRaster`, `addPmtiles` | XYZ, WMTS, WMS, PMTiles; in Web Mercator, or reprojected from another grid (longitudes and latitudes, Lambert-93, UTM, any CRS through proj4); or tiles drawn by your code |
+| [3D Tiles](https://ideal-adventure-zqn6y6p.pages.github.io/layers/tiles3d) | `addTiles3d` | b3dm, pnts, glb, external tilesets, compressed or not |
+| [glTF models](https://ideal-adventure-zqn6y6p.pages.github.io/layers/models) | `addModels` | a glTF model at many positions, instanced, on the relief, picked |
+| [Point clouds](https://ideal-adventure-zqn6y6p.pages.github.io/layers/pointclouds) | `addPointCloud` | COPC (LiDAR HD) by range requests, pnts and glTF points; by class, altitude, intensity, EDL |
+| [Custom layers](https://ideal-adventure-zqn6y6p.pages.github.io/layers/custom) | `addCustomLayer` | your WebGL code or a three.js scene in the map's frame, sharing its depth |
 
 Plus markers, popups, controls, picking within a radius, `easeTo`, `flyTo`, a sky and fog for tilted views. All in
-the [API reference](https://graffkevin.github.io/isard/api).
+the [API reference](https://ideal-adventure-zqn6y6p.pages.github.io/api).
 
 Local files on a map: `bun scripts/viewer.ts data.geojson lidar.copc.laz tiles.pmtiles` serves the viewer
 (`apps/viewer`: files dropped or given, a layer list, a bridge any app can drive) on 127.0.0.1
-([The viewer](https://graffkevin.github.io/isard/guide/viewer)).
+([The viewer](https://ideal-adventure-zqn6y6p.pages.github.io/guide/viewer)).
 
 In QGIS (3.28 and 4): the **isard 3D view** plugin shows the map canvas and its layers in 3D, in a panel or the
-browser, the camera, layers and clicks in sync ([QGIS plugin](https://graffkevin.github.io/isard/guide/qgis)).
+browser, the camera, layers and clicks in sync ([QGIS plugin](https://ideal-adventure-zqn6y6p.pages.github.io/guide/qgis)).
 
 ## Fast by design
 
 Geometry uploaded once and only the view drawn, values in textures, the ground composited in one pass, frames on
 demand, decoding and vector tiles in workers. The details and the measures:
-[Performance](https://graffkevin.github.io/isard/guide/performance).
+[Performance](https://ideal-adventure-zqn6y6p.pages.github.io/guide/performance).
 
 ## Develop
 
@@ -138,28 +142,29 @@ bun run docs:dev   # the documentation, with the examples live
 ```
 
 The root holds two workspaces side by side: Rust (`Cargo.toml`) and TypeScript (`package.json`), and `bun run build`
-drives both.
+drives both. Each crate has its README; [crates/README.md](crates/README.md) guides through them.
 
 ```
 crates/geo/        camera, projections, geodesy and geoid, tile selection, label placement, polygons   tested natively
 crates/tiles3d/    3D Tiles tree, traversal and decoding                                                tested natively
 crates/pointcloud/ COPC point clouds: header, octree hierarchy, traversal, LAZ chunks                    tested natively
 crates/engine/     the WebAssembly core: the engine, the ground, the layers, picking
+crates/tess/       the tessellation module: vector tiles made ready for the GPU in the basemap workers
 packages/isard/    the npm package isard: GeoMap, layer handles, overlays, workers
 apps/              the demo, the viewer (local files, a bridge for other apps) and the benchmark
 examples/          one page per example
 docs/              the documentation site (VitePress)
 scripts/           build, dev server, docs, release
-integrations/qgis/ the QGIS plugin (Python), its server tested with python3 -m unittest
+integrations/qgis/ the QGIS plugin (Python), its server tested with python3 -m unittest; integrations/README.md: the bridge
 ```
 
-More in [Develop and release](https://graffkevin.github.io/isard/guide/develop).
+More in [Develop and release](https://ideal-adventure-zqn6y6p.pages.github.io/guide/develop).
 
 ## Roadmap
 
-- Flood maps over the relief (water depth as a ground shader) as a full example.
-- Text along curved lines, and repeated along long ones.
-- Labels fading in and out instead of popping.
+The whole MapLibre style drawn as vectors, a 3D vector map to walk through, fluids on the globe (wind through the
+streets, animated), several projections on the globe, and smaller items: see
+[Roadmap](https://ideal-adventure-zqn6y6p.pages.github.io/guide/roadmap).
 
 ## Licence
 

package/dist/basemap/basemaps.d.ts

@@ -37,7 +37,7 @@ export declare const IMAGE_SERVER: RegExp;
  * by its validity mask) of the box `{bbox}` in the Mercator of the body. On the Earth, Web Mercator (EPSG:3857);
  * elsewhere, a Mercator on the sphere of `radius` metres (Web Mercator's own formulas), given in WKT.
  */
-export declare function imageServerTerrain(url: string, earth: boolean, radius: number): string;
+export declare const imageServerTerrain: (url: string, earth: boolean, radius: number) => string;
 /** The Earth's relief for `terrain: true`: the Terrain Tiles of AWS's open data registry, worldwide (SRTM, EU-DEM,
  * GMTED… merged by Mapzen), Terrarium PNGs of 256 px to level 14, altitudes above the mean sea level */
 export declare const TERRAIN_TILES: {

package/dist/basemap/basemaps.js

@@ -52,7 +52,7 @@ export const IMAGE_SERVER = /\/ImageServer\/?$/;
  * by its validity mask) of the box `{bbox}` in the Mercator of the body. On the Earth, Web Mercator (EPSG:3857);
  * elsewhere, a Mercator on the sphere of `radius` metres (Web Mercator's own formulas), given in WKT.
  */
-export function imageServerTerrain(url, earth, radius) {
+export const imageServerTerrain = (url, earth, radius) => {
     const crs = earth
         ? '3857'
         : encodeURIComponent(JSON.stringify({
@@ -63,7 +63,7 @@ export function imageServerTerrain(url, earth, radius) {
         }));
     return (`${url.replace(/\/$/, '')}/exportImage?f=image&format=bsq&pixelType=F32&size=256,256` +
         `&bboxSR=${crs}&imageSR=${crs}&bbox={bbox}`);
-}
+};
 /** The Earth's relief for `terrain: true`: the Terrain Tiles of AWS's open data registry, worldwide (SRTM, EU-DEM,
  * GMTED… merged by Mapzen), Terrarium PNGs of 256 px to level 14, altitudes above the mean sea level */
 export const TERRAIN_TILES = {

package/dist/basemap/basemaps.js.map

@@ -1 +1 @@
-{"version":3,"file":"basemaps.js","sourceRoot":"","sources":["../../src/basemap/basemaps.ts"],"names":[],"mappings":"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","sourcesContent":["/** The basemaps by name: OpenFreeMap's vector styles (OpenStreetMap data, worldwide) and the Géoplateforme's (IGN,\n * France), the credits of the sources, and the relief of each body */\nimport { geoplateformeWmts, IGN_ATTRIBUTION } from '../geoplateforme.ts';\nimport type { BasemapName, RasterOptions } from '../types.ts';\n\nexport { IGN_ATTRIBUTION };\n\nconst PLAN = 'GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2';\n\n/** The raster basemaps of the Géoplateforme (WMTS, Web Mercator), crediting the IGN */\nexport const BASEMAPS: Record<'ign-plan' | 'ign-plan-grey' | 'ign-ortho', RasterOptions> = {\n  'ign-plan': geoplateformeWmts(PLAN),\n  'ign-plan-grey': geoplateformeWmts(PLAN, { saturation: 0 }),\n  'ign-ortho': geoplateformeWmts('ORTHOIMAGERY.ORTHOPHOTOS', { format: 'image/jpeg' }),\n};\n\n/** The former names of the Géoplateforme basemaps (before 0.5), and their names now: an error tells it */\nexport const RENAMED_BASEMAPS: Record<string, BasemapName> = {\n  plan: 'ign-plan',\n  'plan-grey': 'ign-plan-grey',\n  ortho: 'ign-ortho',\n  'plan-vector': 'ign-plan-vector',\n  'plan-grey-vector': 'ign-plan-grey-vector',\n};\n\n/** Credits of OpenFreeMap's basemaps, as its TileJSON gives them */\nexport const OPENFREEMAP_ATTRIBUTION =\n  '<a href=\"https://openfreemap.org\">OpenFreeMap</a> <a href=\"https://www.openmaptiles.org/\">© OpenMapTiles</a> ' +\n  'Data from <a href=\"https://www.openstreetmap.org/copyright\">OpenStreetMap</a>';\n\n/** Credits of the Terrain Tiles of AWS's open data registry (Mapzen's Terrarium tiles) and of their sources */\nexport const TERRAIN_TILES_ATTRIBUTION =\n  '<a href=\"https://github.com/tilezen/joerd/blob/master/docs/attribution.md\">Terrain Tiles</a> (Mapzen, AWS)';\n\n/** IGN hillshade, grey on transparent, zooms 6 to 17 */\nexport const HILLSHADE: RasterOptions = geoplateformeWmts('IGNF_ELEVATION.ELEVATIONGRIDCOVERAGE.SHADOW', {\n  minZoom: 6,\n  maxZoom: 17,\n});\n\n/** IGN terrain model (RGE ALTI and its fill-ins, France), raw altitudes in metres from the Géoplateforme WMS */\nexport const TERRAIN_URL =\n  'https://data.geopf.fr/wms-r/wms?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&LAYERS=ELEVATION.ELEVATIONGRIDCOVERAGE.HIGHRES' +\n  '&STYLES=&CRS=EPSG:3857&BBOX={bbox}&WIDTH=256&HEIGHT=256&FORMAT=image/x-bil;bits=32';\n\n/** The relief of the Moon and Mars by default: NASA's Trek image services (ArcGIS), raw 32-bit altitudes in metres\n * asked for in the body's Mercator, with their credits. The Moon: LOLA's global model, 128 pixels per degree (237 m);\n * Mars: MOLA's, 128 and 64 pixels per degree merged (463 m), above the areoid */\nexport const BODY_TERRAINS = {\n  moon: {\n    url: 'https://trek.nasa.gov/moon/trekarcgis/rest/services/LRO_LOLA_DEM_Global_128ppd_v04/ImageServer',\n    maxZoom: 8,\n    attribution: '<a href=\"https://trek.nasa.gov/moon/\">NASA Moon Trek</a>: LOLA terrain model, NASA/GSFC/MIT',\n  },\n  mars: {\n    url: 'https://trek.nasa.gov/mars/trekarcgis/rest/services/mola128_mola64_merge_90Nto90S_SimpleC_clon0/ImageServer',\n    maxZoom: 8,\n    attribution: '<a href=\"https://trek.nasa.gov/mars/\">NASA Mars Trek</a>: MOLA terrain model, NASA/JPL/GSFC',\n  },\n} as const;\n\n/** An ArcGIS image service (a URL ending in `/ImageServer`) */\nexport const IMAGE_SERVER = /\\/ImageServer\\/?$/;\n\n/**\n * The `exportImage` template of an ArcGIS image service for the relief: 256 × 256 raw 32-bit floats (`bsq`, followed\n * by its validity mask) of the box `{bbox}` in the Mercator of the body. On the Earth, Web Mercator (EPSG:3857);\n * elsewhere, a Mercator on the sphere of `radius` metres (Web Mercator's own formulas), given in WKT.\n */\nexport function imageServerTerrain(url: string, earth: boolean, radius: number): string {\n  const crs = earth\n    ? '3857'\n    : encodeURIComponent(\n        JSON.stringify({\n          wkt:\n            `PROJCS[\"Mercator\",GEOGCS[\"GCS\",DATUM[\"D\",SPHEROID[\"S\",${radius},0]],PRIMEM[\"Reference_Meridian\",0],` +\n            'UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Mercator\"],PARAMETER[\"False_Easting\",0],' +\n            'PARAMETER[\"False_Northing\",0],PARAMETER[\"Central_Meridian\",0],PARAMETER[\"Standard_Parallel_1\",0],' +\n            'UNIT[\"Meter\",1]]',\n        }),\n      );\n  return (\n    `${url.replace(/\\/$/, '')}/exportImage?f=image&format=bsq&pixelType=F32&size=256,256` +\n    `&bboxSR=${crs}&imageSR=${crs}&bbox={bbox}`\n  );\n}\n\n/** The Earth's relief for `terrain: true`: the Terrain Tiles of AWS's open data registry, worldwide (SRTM, EU-DEM,\n * GMTED… merged by Mapzen), Terrarium PNGs of 256 px to level 14, altitudes above the mean sea level */\nexport const TERRAIN_TILES = {\n  url: 'https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png',\n  maxZoom: 14,\n} as const;\n\n/** Sea color of each basemap, for the globe under the tiles (polar caps), RGB 0-1 */\nexport const SEA: Record<BasemapName, [r: number, g: number, b: number]> = {\n  'osm-positron': [0.761, 0.784, 0.792],\n  'osm-liberty': [0.62, 0.741, 1],\n  'osm-bright': [0.682, 0.812, 0.886],\n  'ign-plan': [0.667, 0.835, 0.914],\n  'ign-plan-grey': [0.792, 0.792, 0.792],\n  'ign-plan-vector': [0.667, 0.835, 0.914],\n  'ign-plan-grey-vector': [0.792, 0.792, 0.792],\n  'ign-ortho': [0.039, 0.231, 0.349],\n  none: [0.85, 0.85, 0.83],\n};\n"]}
+{"version":3,"file":"basemaps.js","sourceRoot":"","sources":["../../src/basemap/basemaps.ts"],"names":[],"mappings":"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","sourcesContent":["/** The basemaps by name: OpenFreeMap's vector styles (OpenStreetMap data, worldwide) and the Géoplateforme's (IGN,\n * France), the credits of the sources, and the relief of each body */\nimport { geoplateformeWmts, IGN_ATTRIBUTION } from '../geoplateforme.ts';\nimport type { BasemapName, RasterOptions } from '../types.ts';\n\nexport { IGN_ATTRIBUTION };\n\nconst PLAN = 'GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2';\n\n/** The raster basemaps of the Géoplateforme (WMTS, Web Mercator), crediting the IGN */\nexport const BASEMAPS: Record<'ign-plan' | 'ign-plan-grey' | 'ign-ortho', RasterOptions> = {\n  'ign-plan': geoplateformeWmts(PLAN),\n  'ign-plan-grey': geoplateformeWmts(PLAN, { saturation: 0 }),\n  'ign-ortho': geoplateformeWmts('ORTHOIMAGERY.ORTHOPHOTOS', { format: 'image/jpeg' }),\n};\n\n/** The former names of the Géoplateforme basemaps (before 0.5), and their names now: an error tells it */\nexport const RENAMED_BASEMAPS: Record<string, BasemapName> = {\n  plan: 'ign-plan',\n  'plan-grey': 'ign-plan-grey',\n  ortho: 'ign-ortho',\n  'plan-vector': 'ign-plan-vector',\n  'plan-grey-vector': 'ign-plan-grey-vector',\n};\n\n/** Credits of OpenFreeMap's basemaps, as its TileJSON gives them */\nexport const OPENFREEMAP_ATTRIBUTION =\n  '<a href=\"https://openfreemap.org\">OpenFreeMap</a> <a href=\"https://www.openmaptiles.org/\">© OpenMapTiles</a> ' +\n  'Data from <a href=\"https://www.openstreetmap.org/copyright\">OpenStreetMap</a>';\n\n/** Credits of the Terrain Tiles of AWS's open data registry (Mapzen's Terrarium tiles) and of their sources */\nexport const TERRAIN_TILES_ATTRIBUTION =\n  '<a href=\"https://github.com/tilezen/joerd/blob/master/docs/attribution.md\">Terrain Tiles</a> (Mapzen, AWS)';\n\n/** IGN hillshade, grey on transparent, zooms 6 to 17 */\nexport const HILLSHADE: RasterOptions = geoplateformeWmts('IGNF_ELEVATION.ELEVATIONGRIDCOVERAGE.SHADOW', {\n  minZoom: 6,\n  maxZoom: 17,\n});\n\n/** IGN terrain model (RGE ALTI and its fill-ins, France), raw altitudes in metres from the Géoplateforme WMS */\nexport const TERRAIN_URL =\n  'https://data.geopf.fr/wms-r/wms?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&LAYERS=ELEVATION.ELEVATIONGRIDCOVERAGE.HIGHRES' +\n  '&STYLES=&CRS=EPSG:3857&BBOX={bbox}&WIDTH=256&HEIGHT=256&FORMAT=image/x-bil;bits=32';\n\n/** The relief of the Moon and Mars by default: NASA's Trek image services (ArcGIS), raw 32-bit altitudes in metres\n * asked for in the body's Mercator, with their credits. The Moon: LOLA's global model, 128 pixels per degree (237 m);\n * Mars: MOLA's, 128 and 64 pixels per degree merged (463 m), above the areoid */\nexport const BODY_TERRAINS = {\n  moon: {\n    url: 'https://trek.nasa.gov/moon/trekarcgis/rest/services/LRO_LOLA_DEM_Global_128ppd_v04/ImageServer',\n    maxZoom: 8,\n    attribution: '<a href=\"https://trek.nasa.gov/moon/\">NASA Moon Trek</a>: LOLA terrain model, NASA/GSFC/MIT',\n  },\n  mars: {\n    url: 'https://trek.nasa.gov/mars/trekarcgis/rest/services/mola128_mola64_merge_90Nto90S_SimpleC_clon0/ImageServer',\n    maxZoom: 8,\n    attribution: '<a href=\"https://trek.nasa.gov/mars/\">NASA Mars Trek</a>: MOLA terrain model, NASA/JPL/GSFC',\n  },\n} as const;\n\n/** An ArcGIS image service (a URL ending in `/ImageServer`) */\nexport const IMAGE_SERVER = /\\/ImageServer\\/?$/;\n\n/**\n * The `exportImage` template of an ArcGIS image service for the relief: 256 × 256 raw 32-bit floats (`bsq`, followed\n * by its validity mask) of the box `{bbox}` in the Mercator of the body. On the Earth, Web Mercator (EPSG:3857);\n * elsewhere, a Mercator on the sphere of `radius` metres (Web Mercator's own formulas), given in WKT.\n */\nexport const imageServerTerrain = (url: string, earth: boolean, radius: number): string => {\n  const crs = earth\n    ? '3857'\n    : encodeURIComponent(\n        JSON.stringify({\n          wkt:\n            `PROJCS[\"Mercator\",GEOGCS[\"GCS\",DATUM[\"D\",SPHEROID[\"S\",${radius},0]],PRIMEM[\"Reference_Meridian\",0],` +\n            'UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Mercator\"],PARAMETER[\"False_Easting\",0],' +\n            'PARAMETER[\"False_Northing\",0],PARAMETER[\"Central_Meridian\",0],PARAMETER[\"Standard_Parallel_1\",0],' +\n            'UNIT[\"Meter\",1]]',\n        }),\n      );\n\n  return (\n    `${url.replace(/\\/$/, '')}/exportImage?f=image&format=bsq&pixelType=F32&size=256,256` +\n    `&bboxSR=${crs}&imageSR=${crs}&bbox={bbox}`\n  );\n};\n\n/** The Earth's relief for `terrain: true`: the Terrain Tiles of AWS's open data registry, worldwide (SRTM, EU-DEM,\n * GMTED… merged by Mapzen), Terrarium PNGs of 256 px to level 14, altitudes above the mean sea level */\nexport const TERRAIN_TILES = {\n  url: 'https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png',\n  maxZoom: 14,\n} as const;\n\n/** Sea color of each basemap, for the globe under the tiles (polar caps), RGB 0-1 */\nexport const SEA: Record<BasemapName, [r: number, g: number, b: number]> = {\n  'osm-positron': [0.761, 0.784, 0.792],\n  'osm-liberty': [0.62, 0.741, 1],\n  'osm-bright': [0.682, 0.812, 0.886],\n  'ign-plan': [0.667, 0.835, 0.914],\n  'ign-plan-grey': [0.792, 0.792, 0.792],\n  'ign-plan-vector': [0.667, 0.835, 0.914],\n  'ign-plan-grey-vector': [0.792, 0.792, 0.792],\n  'ign-ortho': [0.039, 0.231, 0.349],\n  none: [0.85, 0.85, 0.83],\n};\n"]}

package/dist/basemap/grid.d.ts

@@ -52,20 +52,20 @@ interface Resolved {
     extent: [number, number, number, number] | undefined;
 }
 /** A tile grid ready to plan tiles: its CRS found, its matrices completed, its bounds projected */
-export declare function resolveGrid(grid: TileGrid): Resolved;
+export declare const resolveGrid: (grid: TileGrid) => Resolved;
 /** The longitudes and latitudes of tiles in longitudes and latitudes, two 256 px tiles side by side at level 0, rows
  * from the north (NASA's Trek, WorldCRS84Quad), levels `minLevel` to `maxLevel` ({z} is the level) */
-export declare function equirectangularGrid(minLevel: number, maxLevel: number): TileGrid;
+export declare const equirectangularGrid: (minLevel: number, maxLevel: number) => TileGrid;
 /**
  * The plan of Mercator tile `z`/`x`/`y` (`size` pixels a side) from a source of URL template `url` in grid `g`; null
  * where the source has nothing
  */
-export declare function planTile(g: Resolved, url: string, z: number, x: number, y: number, size: number): Job | null;
+export declare const planTile: (g: Resolved, url: string, z: number, x: number, y: number, size: number) => Job | null;
 /**
  * The map zooms a grid's matrices span (the pixel size of the finest and of the coarsest, two levels coarser, where
  * the tiles still fit a mosaic), measured at the middle of its bounds, or of its coarsest matrix
  */
-export declare function gridZooms(g: Resolved): {
+export declare const gridZooms: (g: Resolved) => {
     minZoom: number;
     maxZoom: number;
 };
@@ -77,5 +77,5 @@ export type RemoteReprojection = (job: Job, tile: [z: number, x: number, y: numb
  * A raster loader drawing Web Mercator tiles of `size` pixels from a source of URL template `url` in tile grid `grid`:
  * planned here, drawn in a worker of the map through `remote` when it can, else in the page
  */
-export declare function gridLoader(url: string, grid: Resolved, size: number, remote?: RemoteReprojection): Draw;
+export declare const gridLoader: (url: string, grid: Resolved, size: number, remote?: RemoteReprojection) => Draw;
 export {};