isard 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -3,6 +3,94 @@
 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

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/pmtileslayer.d.ts

@@ -0,0 +1,33 @@
+/** PMTiles archives on the map (`GeoMap.addPmtiles`): their images as a raster layer, or their vector tiles drawn with
+ * the style given or a plain one made from their layers' names */
+import type { Layer } from '../layers/layers.ts';
+import type { RasterOptions } from '../types.ts';
+import type { Style } from './vectorstyle.ts';
+/**
+ * A plain style for vector tiles known only by their layers' names (a PMTiles archive's `vector_layers`, an MBTiles'
+ * metadata): each layer's polygons filled, its lines and outlines stroked and its points as circles, a color per
+ * layer, the `name` of points as labels. `source` is the style's vector source (`url`: TileJSON or `pmtiles://…`, or
+ * `tiles`)
+ */
+export declare const basicStyle: (source: {
+    url?: string;
+    tiles?: string[];
+    minzoom?: number;
+    maxzoom?: number;
+}, layers: readonly string[]) => Style;
+/** Options of `GeoMap.addPmtiles` */
+export interface PmtilesOptions {
+    /** What the archive holds (default from its header: raster images or vector tiles) */
+    kind?: 'raster' | 'vector';
+    /** A MapLibre style for vector tiles (its vector source `pmtiles://…`); default `basicStyle` of the archive's layers */
+    style?: Style;
+    opacity?: number;
+    /** Texture size of raster tiles (default 256; 512 for the sharper tiles of a 512 px archive) */
+    size?: number;
+    /** Credits, HTML (default the archive's `attribution` metadata, as text) */
+    attribution?: string;
+    before?: Layer;
+}
+/** A raster loader reading the tiles of a `pmtiles://` archive URL (images of any size, drawn at `size`); undefined
+ * for another URL */
+export declare const pmtilesRasterLoader: (url: string, size: number) => RasterOptions["loader"];

package/dist/basemap/pmtileslayer.js

@@ -0,0 +1,97 @@
+/** PMTiles archives on the map (`GeoMap.addPmtiles`): their images as a raster layer, or their vector tiles drawn with
+ * the style given or a plain one made from their layers' names */
+import { isRecord } from "../util/guards.js";
+import { pmtiles, pmtilesUrl } from "./pmtiles.js";
+/** Colors of the layers of `basicStyle`, in turn */
+const BASIC_COLORS = ['#2f6fd1', '#d1495b', '#2a9d8f', '#e9a03b', '#7b5ea7', '#5c7a29', '#c8553d', '#3d8eb9'];
+/**
+ * A plain style for vector tiles known only by their layers' names (a PMTiles archive's `vector_layers`, an MBTiles'
+ * metadata): each layer's polygons filled, its lines and outlines stroked and its points as circles, a color per
+ * layer, the `name` of points as labels. `source` is the style's vector source (`url`: TileJSON or `pmtiles://…`, or
+ * `tiles`)
+ */
+export const basicStyle = (source, layers) => {
+    const out = [];
+    layers.forEach((name, i) => {
+        const color = BASIC_COLORS[i % BASIC_COLORS.length] ?? '#2f6fd1';
+        const base = { source: 'data', 'source-layer': name };
+        out.push({ id: `${name}-fill`, type: 'fill', ...base, paint: { 'fill-color': color, 'fill-opacity': 0.18 } }, { id: `${name}-line`, type: 'line', ...base, paint: { 'line-color': color, 'line-width': 1.2 } }, {
+            id: `${name}-circle`,
+            type: 'circle',
+            ...base,
+            paint: { 'circle-color': color, 'circle-radius': 3.5, 'circle-stroke-color': '#fff', 'circle-stroke-width': 1 },
+        });
+    });
+    layers.forEach((name) => {
+        out.push({
+            id: `${name}-label`,
+            type: 'symbol',
+            source: 'data',
+            'source-layer': name,
+            filter: ['all', ['==', ['geometry-type'], 'Point'], ['has', 'name']],
+            layout: { 'text-field': ['get', 'name'], 'text-size': 12, 'text-offset': [0, 0.9], 'text-anchor': 'top' },
+            paint: { 'text-color': '#1d2433', 'text-halo-color': '#fff', 'text-halo-width': 1.5 },
+        });
+    });
+    return { version: 8, sources: { data: { type: 'vector', ...source } }, layers: out };
+};
+/** HTML of a file reduced to its text, escaped: credits from an archive's metadata cannot run in the page */
+const plainText = (html) => {
+    return html
+        .replace(/<[^>]*>/g, '')
+        .replace(/&(?!(amp|lt|gt|quot|copy|#\d+);)/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+};
+/** @internal `GeoMap.addPmtiles`: a raster layer of the archive's images, or vector tiles with their raster layer and
+ * labels */
+export const pmtilesLayer = async (map, url, options) => {
+    const archiveUrl = pmtilesUrl(url.startsWith('pmtiles://') ? url : `pmtiles://${url}`) ?? url;
+    const archive = pmtiles(archiveUrl);
+    const [header, metadata] = await Promise.all([
+        archive.header(),
+        archive.metadata().catch(() => ({})),
+    ]);
+    const credit = metadata.attribution;
+    const attribution = options.attribution ?? (typeof credit === 'string' && credit ? plainText(credit) : undefined);
+    const kind = options.kind ?? (header.tileType === 'mvt' ? 'vector' : 'raster');
+    const credits = attribution ? { attribution } : {};
+    if (kind === 'raster') {
+        return map.addRaster({
+            url: `pmtiles://${archiveUrl}`,
+            minZoom: header.minZoom,
+            maxZoom: Math.max(header.maxZoom, 19),
+            ...(options.opacity === undefined ? {} : { opacity: options.opacity }),
+            ...(options.size === undefined ? {} : { size: options.size }),
+            ...(options.before ? { before: options.before } : {}),
+            ...credits,
+        });
+    }
+    const layers = metadata.vector_layers;
+    const names = Array.isArray(layers)
+        ? layers.map((l) => (isRecord(l) ? l.id : undefined)).filter((id) => typeof id === 'string')
+        : [];
+    const style = options.style ?? basicStyle({ url: `pmtiles://${archiveUrl}` }, names);
+    const tiles = map.vectorTiles({ style, ...credits });
+    tiles.raster({
+        ...(options.opacity === undefined ? {} : { opacity: options.opacity }),
+        ...(options.before ? { before: options.before } : {}),
+    });
+    tiles.labels();
+    return tiles;
+};
+/** A raster loader reading the tiles of a `pmtiles://` archive URL (images of any size, drawn at `size`); undefined
+ * for another URL */
+export const pmtilesRasterLoader = (url, size) => {
+    const archiveUrl = pmtilesUrl(url);
+    if (!archiveUrl)
+        return undefined;
+    const archive = pmtiles(archiveUrl);
+    return async (z, x, y, signal) => {
+        const bytes = await archive.tile(z, x, y, signal);
+        if (!bytes)
+            return null;
+        return createImageBitmap(new Blob([bytes]), { resizeWidth: size, resizeHeight: size });
+    };
+};
+//# sourceMappingURL=pmtileslayer.js.map

package/dist/basemap/pmtileslayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmtileslayer.js","sourceRoot":"","sources":["../../src/basemap/pmtileslayer.ts"],"names":[],"mappings":"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","sourcesContent":["/** PMTiles archives on the map (`GeoMap.addPmtiles`): their images as a raster layer, or their vector tiles drawn with\n * the style given or a plain one made from their layers' names */\n\nimport type { Layer, RasterLayer } from '../layers/layers.ts';\nimport type { GeoMap } from '../map.ts';\nimport type { RasterOptions } from '../types.ts';\nimport { isRecord } from '../util/guards.ts';\nimport { pmtiles, pmtilesUrl } from './pmtiles.ts';\nimport type { Style, StyleLayer } from './vectorstyle.ts';\nimport type { VectorTiles } from './vectortiles.ts';\n\n/** Colors of the layers of `basicStyle`, in turn */\nconst BASIC_COLORS = ['#2f6fd1', '#d1495b', '#2a9d8f', '#e9a03b', '#7b5ea7', '#5c7a29', '#c8553d', '#3d8eb9'];\n\n/**\n * A plain style for vector tiles known only by their layers' names (a PMTiles archive's `vector_layers`, an MBTiles'\n * metadata): each layer's polygons filled, its lines and outlines stroked and its points as circles, a color per\n * layer, the `name` of points as labels. `source` is the style's vector source (`url`: TileJSON or `pmtiles://…`, or\n * `tiles`)\n */\nexport const basicStyle = (\n  source: { url?: string; tiles?: string[]; minzoom?: number; maxzoom?: number },\n  layers: readonly string[],\n): Style => {\n  const out: StyleLayer[] = [];\n\n  layers.forEach((name, i) => {\n    const color = BASIC_COLORS[i % BASIC_COLORS.length] ?? '#2f6fd1';\n    const base = { source: 'data', 'source-layer': name };\n\n    out.push(\n      { id: `${name}-fill`, type: 'fill', ...base, paint: { 'fill-color': color, 'fill-opacity': 0.18 } },\n      { id: `${name}-line`, type: 'line', ...base, paint: { 'line-color': color, 'line-width': 1.2 } },\n      {\n        id: `${name}-circle`,\n        type: 'circle',\n        ...base,\n        paint: { 'circle-color': color, 'circle-radius': 3.5, 'circle-stroke-color': '#fff', 'circle-stroke-width': 1 },\n      },\n    );\n  });\n  layers.forEach((name) => {\n    out.push({\n      id: `${name}-label`,\n      type: 'symbol',\n      source: 'data',\n      'source-layer': name,\n      filter: ['all', ['==', ['geometry-type'], 'Point'], ['has', 'name']],\n      layout: { 'text-field': ['get', 'name'], 'text-size': 12, 'text-offset': [0, 0.9], 'text-anchor': 'top' },\n      paint: { 'text-color': '#1d2433', 'text-halo-color': '#fff', 'text-halo-width': 1.5 },\n    });\n  });\n\n  return { version: 8, sources: { data: { type: 'vector', ...source } }, layers: out };\n};\n\n/** Options of `GeoMap.addPmtiles` */\nexport interface PmtilesOptions {\n  /** What the archive holds (default from its header: raster images or vector tiles) */\n  kind?: 'raster' | 'vector';\n  /** A MapLibre style for vector tiles (its vector source `pmtiles://…`); default `basicStyle` of the archive's layers */\n  style?: Style;\n  opacity?: number;\n  /** Texture size of raster tiles (default 256; 512 for the sharper tiles of a 512 px archive) */\n  size?: number;\n  /** Credits, HTML (default the archive's `attribution` metadata, as text) */\n  attribution?: string;\n  before?: Layer;\n}\n\n/** HTML of a file reduced to its text, escaped: credits from an archive's metadata cannot run in the page */\nconst plainText = (html: string): string => {\n  return html\n    .replace(/<[^>]*>/g, '')\n    .replace(/&(?!(amp|lt|gt|quot|copy|#\\d+);)/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;');\n};\n\n/** @internal `GeoMap.addPmtiles`: a raster layer of the archive's images, or vector tiles with their raster layer and\n * labels */\nexport const pmtilesLayer = async (\n  map: GeoMap,\n  url: string,\n  options: PmtilesOptions,\n): Promise<RasterLayer | VectorTiles> => {\n  const archiveUrl = pmtilesUrl(url.startsWith('pmtiles://') ? url : `pmtiles://${url}`) ?? url;\n  const archive = pmtiles(archiveUrl);\n  const [header, metadata] = await Promise.all([\n    archive.header(),\n    archive.metadata().catch((): Record<string, unknown> => ({})),\n  ]);\n  const credit = metadata.attribution;\n  const attribution = options.attribution ?? (typeof credit === 'string' && credit ? plainText(credit) : undefined);\n  const kind = options.kind ?? (header.tileType === 'mvt' ? 'vector' : 'raster');\n  const credits = attribution ? { attribution } : {};\n\n  if (kind === 'raster') {\n    return map.addRaster({\n      url: `pmtiles://${archiveUrl}`,\n      minZoom: header.minZoom,\n      maxZoom: Math.max(header.maxZoom, 19),\n      ...(options.opacity === undefined ? {} : { opacity: options.opacity }),\n      ...(options.size === undefined ? {} : { size: options.size }),\n      ...(options.before ? { before: options.before } : {}),\n      ...credits,\n    });\n  }\n\n  const layers = metadata.vector_layers;\n  const names = Array.isArray(layers)\n    ? layers.map((l) => (isRecord(l) ? l.id : undefined)).filter((id) => typeof id === 'string')\n    : [];\n  const style = options.style ?? basicStyle({ url: `pmtiles://${archiveUrl}` }, names);\n  const tiles = map.vectorTiles({ style, ...credits });\n\n  tiles.raster({\n    ...(options.opacity === undefined ? {} : { opacity: options.opacity }),\n    ...(options.before ? { before: options.before } : {}),\n  });\n  tiles.labels();\n\n  return tiles;\n};\n\n/** A raster loader reading the tiles of a `pmtiles://` archive URL (images of any size, drawn at `size`); undefined\n * for another URL */\nexport const pmtilesRasterLoader = (url: string, size: number): RasterOptions['loader'] => {\n  const archiveUrl = pmtilesUrl(url);\n\n  if (!archiveUrl) return undefined;\n\n  const archive = pmtiles(archiveUrl);\n\n  return async (z, x, y, signal) => {\n    const bytes = await archive.tile(z, x, y, signal);\n\n    if (!bytes) return null;\n\n    return createImageBitmap(new Blob([bytes]), { resizeWidth: size, resizeHeight: size });\n  };\n};\n"]}

package/dist/basemap/trees.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The trees of a vector map (`VectorTiles.trees`): a low-poly tree made here as a glTF binary (no file to download),
+ * its trunk and its crown flat-shaded in their colors, and the style layers they grow on by default.
+ */
+import type { StyleLayer } from './vectorstyle.ts';
+/** Numbers of a tree in the workers' answer: longitude, latitude, scale, heading, rank */
+export declare const TREE_NUMBERS = 5;
+/** Colors of the trunk and of the crown (linear RGBA, as glTF's `baseColorFactor`) */
+export interface TreeColors {
+    trunk: [number, number, number, number];
+    crown: [number, number, number, number];
+}
+/**
+ * A tree as a glTF binary, about 10 metres high: a trunk and a rounded crown in `colors`, one mesh of two primitives,
+ * its front +Z (`ModelInstance.heading` turns it), standing on its origin
+ */
+export declare const treeModel: (colors?: Partial<TreeColors>) => Uint8Array<ArrayBuffer>;
+/**
+ * Whether trees grow on a style layer by default: the woods and forests of the style's fills (OpenMapTiles'
+ * `landcover` wood, PLAN IGN's forests) and the grass of its parks and gardens; not the wooded relief of PLAN IGN,
+ * which repeats its forests, nor OpenMapTiles' `park` layer (protected areas and historic sites: a river's banks
+ * among them)
+ */
+export declare const isWoodland: (layer: StyleLayer) => boolean;
+/** Default spacing of the trees of a layer (metres): close in woods and forests, apart on grass */
+export declare const treeSpacing: (layer: StyleLayer) => number;

package/dist/basemap/trees.js

@@ -0,0 +1,141 @@
+/**
+ * The trees of a vector map (`VectorTiles.trees`): a low-poly tree made here as a glTF binary (no file to download),
+ * its trunk and its crown flat-shaded in their colors, and the style layers they grow on by default.
+ */
+/** Numbers of a tree in the workers' answer: longitude, latitude, scale, heading, rank */
+export const TREE_NUMBERS = 5;
+/** Sides of the trunk and of the crown */
+const SIDES = 7;
+const DEFAULT_COLORS = {
+    trunk: [0.2, 0.12, 0.07, 1],
+    crown: [0.12, 0.27, 0.08, 1],
+};
+/** A solid of revolution around the vertical (glTF +Y up), flat-shaded: rings of (height, radius), a point at the
+ * top when its radius is 0; the triangles' positions and normals, one normal per face */
+const revolve = (rings) => {
+    const at = (k, [h, r]) => {
+        const a = (k / SIDES) * Math.PI * 2;
+        return [Math.cos(a) * r, h, Math.sin(a) * r];
+    };
+    const positions = [];
+    const normals = [];
+    const face = (a, b, c) => {
+        const u = [b[0] - a[0], b[1] - a[1], b[2] - a[2]];
+        const v = [c[0] - a[0], c[1] - a[1], c[2] - a[2]];
+        const n = [u[1] * v[2] - u[2] * v[1], u[2] * v[0] - u[0] * v[2], u[0] * v[1] - u[1] * v[0]];
+        const length = Math.hypot(...n);
+        // A degenerate face (two points at the apex) is left out
+        if (length === 0)
+            return;
+        positions.push(...a, ...b, ...c);
+        [0, 1, 2].forEach(() => {
+            normals.push(n[0] / length, n[1] / length, n[2] / length);
+        });
+    };
+    rings.slice(1).forEach((ring, i) => {
+        const below = rings[i] ?? ring;
+        Array.from({ length: SIDES }, (_, k) => k).forEach((k) => {
+            const [a, b] = [at(k, below), at(k + 1, below)];
+            const [c, d] = [at(k, ring), at(k + 1, ring)];
+            // Counter-clockwise seen from outside
+            face(a, c, b);
+            face(b, c, d);
+        });
+    });
+    // The bottom closed: seen from below
+    const base = rings[0];
+    if (base && base[1] > 0) {
+        Array.from({ length: SIDES }, (_, k) => k).forEach((k) => {
+            face([0, base[0], 0], at(k, base), at(k + 1, base));
+        });
+    }
+    return { positions, normals };
+};
+/** Lowest and highest of interleaved x, y, z (glTF needs them on positions) */
+const bounds = (xyz) => {
+    const axes = [0, 1, 2].map((a) => xyz.filter((_, i) => i % 3 === a));
+    return { min: axes.map((v) => Math.min(...v)), max: axes.map((v) => Math.max(...v)) };
+};
+/**
+ * A tree as a glTF binary, about 10 metres high: a trunk and a rounded crown in `colors`, one mesh of two primitives,
+ * its front +Z (`ModelInstance.heading` turns it), standing on its origin
+ */
+export const treeModel = (colors = {}) => {
+    const { trunk, crown } = { ...DEFAULT_COLORS, ...colors };
+    const parts = [
+        revolve([
+            [0, 0.28],
+            [3.2, 0.2],
+        ]),
+        revolve([
+            [2.4, 0.6],
+            [3.6, 2.4],
+            [5.6, 2.9],
+            [7.8, 2.3],
+            [9.4, 1.1],
+            [10.2, 0],
+        ]),
+    ];
+    // The buffer: each part's positions then normals, 4-byte floats
+    const floats = parts.flatMap((p) => [...p.positions, ...p.normals]);
+    const bin = new Float32Array(floats);
+    const views = parts.flatMap((p, i) => {
+        const before = parts.slice(0, i).reduce((n, q) => n + (q.positions.length + q.normals.length) * 4, 0);
+        return [
+            { buffer: 0, byteOffset: before, byteLength: p.positions.length * 4, target: 34962 },
+            { buffer: 0, byteOffset: before + p.positions.length * 4, byteLength: p.normals.length * 4, target: 34962 },
+        ];
+    });
+    const accessors = parts.flatMap((p, i) => [
+        { bufferView: i * 2, componentType: 5126, count: p.positions.length / 3, type: 'VEC3', ...bounds(p.positions) },
+        { bufferView: i * 2 + 1, componentType: 5126, count: p.normals.length / 3, type: 'VEC3' },
+    ]);
+    const gltf = {
+        asset: { version: '2.0', generator: 'isard' },
+        scene: 0,
+        scenes: [{ nodes: [0] }],
+        nodes: [{ mesh: 0 }],
+        meshes: [
+            {
+                primitives: parts.map((_, i) => ({ attributes: { POSITION: i * 2, NORMAL: i * 2 + 1 }, material: i })),
+            },
+        ],
+        materials: [trunk, crown].map((color) => ({
+            pbrMetallicRoughness: { baseColorFactor: color, metallicFactor: 0, roughnessFactor: 1 },
+        })),
+        accessors,
+        bufferViews: views,
+        buffers: [{ byteLength: bin.byteLength }],
+    };
+    // The chunks padded to 4 bytes: the JSON with spaces, the binary with zeros
+    const json = new TextEncoder().encode(JSON.stringify(gltf));
+    const jsonLength = Math.ceil(json.length / 4) * 4;
+    const binLength = Math.ceil(bin.byteLength / 4) * 4;
+    const out = new Uint8Array(12 + 8 + jsonLength + 8 + binLength);
+    const view = new DataView(out.buffer);
+    view.setUint32(0, 0x46546c67, true);
+    view.setUint32(4, 2, true);
+    view.setUint32(8, out.length, true);
+    view.setUint32(12, jsonLength, true);
+    view.setUint32(16, 0x4e4f534a, true);
+    out.fill(0x20, 20, 20 + jsonLength);
+    out.set(json, 20);
+    view.setUint32(20 + jsonLength, binLength, true);
+    view.setUint32(24 + jsonLength, 0x004e4942, true);
+    out.set(new Uint8Array(bin.buffer), 28 + jsonLength);
+    return out;
+};
+/** Whether a style layer is OpenMapTiles' grass (the lawns of parks and gardens among it) */
+const isGrass = (layer) => layer['source-layer'] === 'landcover' && /grass/i.test(layer.id);
+/**
+ * Whether trees grow on a style layer by default: the woods and forests of the style's fills (OpenMapTiles'
+ * `landcover` wood, PLAN IGN's forests) and the grass of its parks and gardens; not the wooded relief of PLAN IGN,
+ * which repeats its forests, nor OpenMapTiles' `park` layer (protected areas and historic sites: a river's banks
+ * among them)
+ */
+export const isWoodland = (layer) => layer.type === 'fill' &&
+    layer['source-layer'] !== 'oro_relief' &&
+    (/wood|forest|for[eê]t/i.test(layer.id) || isGrass(layer));
+/** Default spacing of the trees of a layer (metres): close in woods and forests, apart on grass */
+export const treeSpacing = (layer) => (isGrass(layer) ? 25 : 9);
+//# sourceMappingURL=trees.js.map