isard 1.12.0 → 1.13.0

package/CHANGELOG.md

@@ -5,6 +5,50 @@ versions [Semantic Versioning](https://semver.org) (before 1.0.0, a minor versio
 
 ## [Unreleased]
 
+## [1.13.0] - 2026-10-28
+
+With `isard-react-native` 0.2.0 and `isard-map` 0.2.0 (Python).
+
+### Added
+
+- isard's whole API from Python: a method of the map in snake_case (`m.vector_tiles(…)`, `m.set_sun(…)`) runs in the
+  page and answers a handle whose methods are called the same way; `m.new(class, …)`, `m.module(entry)`, `ref()` for
+  isard's exports, `js()` for an expression run in the page, Python functions as callbacks, `then=` for an answer,
+  dates and bytes passed. The Python of every example the widget can draw, beside its TypeScript and React; the
+  documentation's Python introduction shows the basic example's map as its Python made it. In the page of
+  `isard-react-native`, the `invoke` message the widget sends.
+- isard in Jupyter: the Python package `isard-map` (`packages/python`, PyPI), a notebook widget (anywidget) running
+  the page of `isard-react-native`; `Map(center, zoom, …)` with GeoMap's options, `add_circles`, `add_lines`,
+  `add_fills`, `add_extrusions`, `add_tiles3d` or `add(type, data, …)`, GeoDataFrames as data (brought to WGS 84),
+  `prop(name, default)` for an option read from the properties, a ramp's `values` from a column, `fly_to`, `ease_to`,
+  `set_camera`, `m.camera`, `on_click`; `geoplateforme_wfs` for the Géoplateforme's WFS. The documentation's Python tab;
+  the Python of six examples beside their TypeScript and React.
+- `isard-react-native`: an option read from each feature's properties as plain data (`{ property, default }`), a
+  ramp's `values` set in place as the data are; `start` takes a container and returns what destroys the map.
+- The Space Shuttle Discovery example (TypeScript and React): the Smithsonian's scan (CC0, a Draco GLB of 150,000
+  triangles, 2048 px textures, kept next to the page) at full size beside the Udvar-Hazy Center's hangar that keeps it,
+  among OpenFreeMap's buildings as geometry, in the sun; also in the mobile app.
+- The My location example (React Native, in the documentation's Mobile tab): the phone's position from `expo-location`,
+  a dot within the circle of its accuracy, a button following it.
+
+### Changed
+
+- The documentation's home page: a wall of the examples' pictures, each opening its example, and the same map in
+  TypeScript, React, Python, React Native and QGIS, a tab each.
+- The licence's copyright: © 2026 Institut National de l'Information Géographique et Forestière, as the IGN's other
+  repositories have it (the code stays MIT); the README lists the data files kept in the repository under their own
+  licences (an OpenStreetMap extract, ODbL; a Smithsonian model, CC0).
+
+## [1.12.1] - 2026-10-28
+
+### Changed
+
+- A lower quality also runs fewer workers, keeping fewer decoded tiles: `'medium'` two of them (32 tiles), `'low'` one
+  (16), `'high'` up to four (96) as before. A phone's page grew with them as the map moved, each worker its own heap,
+  its decoded tiles and its modules: Paris tilted on a phone, twelve moves, 640 MB instead of over a gigabyte.
+- The examples' buildings without their glass windows by day (`facades` left off in the 3D vector map and Paris by
+  night, whose lit windows stay); the option stays.
+
 ## [1.12.0] - 2026-10-28
 
 ### Added

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Kevin Graff
+Copyright (c) 2026 Institut National de l'Information Géographique et Forestière
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -136,7 +136,10 @@ Local files on a map: `bun scripts/viewer.ts data.geojson lidar.copc.laz tiles.p
 ([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://ideal-adventure-zqn6y6p.pages.github.io/guide/qgis)).
+browser, the camera, layers and clicks in sync ([QGIS plugin](https://ideal-adventure-zqn6y6p.pages.github.io/guide/qgis)). In Jupyter:
+`pip install isard-map`, a notebook widget whose layers are your GeoDataFrames ([Python](https://ideal-adventure-zqn6y6p.pages.github.io/python/)). On a
+phone: `isard-react-native` puts the map in a React Native app, and an Expo app shows the examples
+([Mobile](https://ideal-adventure-zqn6y6p.pages.github.io/mobile/)).
 
 ## Fast by design
 
@@ -168,8 +171,10 @@ crates/engine/     the WebAssembly core: the engine, the ground, the layers, pic
 crates/tess/       the tessellation module: vector tiles made ready for the GPU in the basemap workers
 crates/grid/       the grid module: GRIB2 and NetCDF files read into grids, the wind through the streets  tested natively
 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
+packages/react-native/ the npm package isard-react-native: the map in a React Native app's WebView
+packages/python/   the Python package isard-map: the map as a Jupyter widget (anywidget)
+apps/              the demo, the viewer (local files, a bridge for other apps), the benchmark, the Expo app (mobile/)
+examples/          one page per example; in React (react/), React Native (react-native/), Python (python/)
 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/README.md: the bridge
@@ -181,8 +186,8 @@ More in [Develop and release](https://ideal-adventure-zqn6y6p.pages.github.io/gu
 
 By priority:
 
-- **P1**, next: areas and heights in the measure.
-- **P2**, then: rasters draped on the buildings; rasters draped within an area; a clipping volume; a performance report.
+- **P1**, next: rasters draped on the buildings.
+- **P2**, then: rasters draped within an area; a clipping volume; a performance report.
 - **P3**, later: objects moving along paths; video in the scene.
 - **P4**, when time allows: the whole MapLibre style drawn as vectors, a 3D vector map to walk through, Panoramax's
   street-level photos, fluids on the globe, several projections on the globe, smaller items.
@@ -191,5 +196,7 @@ See [Roadmap](https://ideal-adventure-zqn6y6p.pages.github.io/guide/roadmap).
 
 ## Licence
 
-MIT, © 2026 Kevin Graff. Basemap data: © OpenStreetMap contributors (OpenFreeMap, OpenMapTiles); IGN data: Licence
-Ouverte (Géoplateforme).
+The code: MIT, © 2026 Institut National de l'Information Géographique et Forestière (IGN). Basemap data: © OpenStreetMap
+contributors (OpenFreeMap, OpenMapTiles); IGN data: Licence Ouverte (Géoplateforme). Data files kept in the repository
+under their own licences: `examples/mall/les-4-temps.geojson` © OpenStreetMap contributors (ODbL),
+`examples/smithsonian/discovery.glb` the Smithsonian Institution (CC0).

package/dist/basemap/vectortiles.js

@@ -142,7 +142,16 @@ export class VectorTiles {
         const sprites = patterns && style.sprite ? await this.loadSprites(style.sprite) : [];
         if (this.destroyed)
             throw new DOMException('isard: vector tiles destroyed', 'AbortError');
-        this.pool.broadcast({ type: 'init', key, tiles, maxzoom, layers, rasters, ...(sprites.length ? { sprites } : {}) });
+        this.pool.broadcast({
+            type: 'init',
+            key,
+            tiles,
+            maxzoom,
+            layers,
+            rasters,
+            cached: this.map.quality.cachedTiles,
+            ...(sprites.length ? { sprites } : {}),
+        });
         if (!again)
             this.renderers.push(key);
         return { key, maxzoom, layers };

package/dist/basemap/vectortiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"vectortiles.js","sourceRoot":"","sources":["../../src/basemap/vectortiles.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Vector basemaps from a MapLibre style (OpenFreeMap's Positron by default): the fills, lines, circles and raster\n * layers drawn tile by tile in workers into the raster pool, so that they lie on the relief like any basemap and\n * composite with the hillshade in one pass; and the labels of the style's symbol layers in a symbol layer of their own,\n * kept above the application's layers (as MapLibre's `beforeId: firstSymbol` does), listed by the workers, shaped in\n * the page once per vector tile, placed by the engine.\n *\n * Any subset of the style can be drawn on its own raster layer (`raster({ layers })`), at its own place in the stack:\n * rivers from the basemap's data over a flood layer, for instance, restyled with `extraLayers`.\n *\n * The layers other than the raster ones are made in `vectortiles/` (one module each), from what they use of the\n * instance (`VectorTilesContext`); the style's loading is in `vectortiles/style.ts`.\n */\n\nimport type { ExtrusionLayer } from '../layers/extrusions.ts';\nimport { type LoadedSprite, loadSprites, readPixels, spriteSources } from '../layers/icons.ts';\nimport type { Layer } from '../layers/layers.ts';\nimport type { ModelLayer } from '../layers/models.ts';\nimport type { RasterLayer } from '../layers/raster.ts';\nimport type { SymbolLayer } from '../layers/symbols.ts';\nimport type { VectorLayer } from '../layers/vectors.ts';\nimport type { GeoMap } from '../map.ts';\nimport type { Placement } from '../types.ts';\nimport { clamp } from '../util/math.ts';\nimport type { BasemapWork, Sprite } from '../workers/basemap/protocol.ts';\nimport type { LabelCandidate, Style, StyleLayer } from './vectorstyle.ts';\nimport type { Renderer, VectorTilesContext } from './vectortiles/context.ts';\nimport { extrusions, type VectorExtrusionOptions } from './vectortiles/extrusions.ts';\nimport { type FurnitureOptions, furniture } from './vectortiles/furniture.ts';\nimport { type LabelsOptions, labels, size, tileLabels } from './vectortiles/labels.ts';\nimport { type LampsOptions, lamps } from './vectortiles/lamps.ts';\nimport type { TileRequests } from './vectortiles/requests.ts';\nimport { type StreetWindLayer, type StreetWindOptions, streetWind } from './vectortiles/street-wind.ts';\nimport {\n  type LoadedStyle,\n  loadStyle,\n  OPENFREEMAP_STYLES,\n  PLAN_STYLES,\n  styleAttribution,\n  VECTOR_BASEMAPS,\n} from './vectortiles/style.ts';\nimport { VECTOR_MOVE_REFRESH_MS } from './vectortiles/tiles.ts';\nimport { type TreesOptions, trees } from './vectortiles/trees.ts';\nimport { dashes, type VectorsOptions, vectors } from './vectortiles/vectors.ts';\nimport { type BasemapWorkers, rendererKey, tilePriority } from './workerpool.ts';\n\n// The names the package and its tests import from here, now made in `vectortiles/`\nexport { dashes, OPENFREEMAP_STYLES, PLAN_STYLES, size, styleAttribution, tileLabels, VECTOR_BASEMAPS };\n\n/** The options of `VectorTiles.raster` */\nexport interface VectorRasterOptions extends Placement {\n  /** The style layers drawn (default all but the symbols) */\n  layers?: (layer: StyleLayer) => boolean;\n  /** Style layers of the same source drawn after them */\n  extraLayers?: StyleLayer[];\n  /** Texture size of its tiles (512 by default: sharp lines) */\n  size?: number;\n  opacity?: number;\n  minZoom?: number;\n  maxZoom?: number;\n}\n\nexport interface VectorTilesOptions {\n  /** A style URL or object (default OpenFreeMap's Positron) */\n  style?: string | Style;\n  /** Workers drawing the tiles (default cores - 1, 1 to 4). The vector tiles of a map share its workers (and their\n   * decoded tiles); another count gives these tiles workers of their own */\n  workers?: number;\n  /** Where to load the worker from, when a bundler does not resolve the default URL (default the map's\n   * `basemapWorkerUrl`); another URL than the map's gives these tiles workers of their own */\n  workerUrl?: string | URL;\n  /** Credits of the tiles, shown while its raster layers are on the map (default: OpenFreeMap's for its styles, the\n   * IGN's for PLAN.IGN's) */\n  attribution?: string;\n}\n\nexport class VectorTiles {\n  private readonly pool: BasemapWorkers;\n  /** The pool is this instance's own (a worker count or URL other than the map's): stopped with it */\n  private readonly ownPool: boolean;\n  /** Prefix of its renderer keys in the pool's workers */\n  private readonly namespace: string;\n  private destroyed = false;\n  private keys = 0;\n  /** Renderers sent to the workers, dropped on destroy */\n  private readonly renderers: string[] = [];\n  private readonly cleanup: (() => void)[] = [];\n  /** Credits of its raster layers */\n  private readonly attribution: string | undefined;\n  /** Its raster and label layers, removed with it */\n  private readonly layers: Layer[] = [];\n  /** Its first raster layer: the ground its labels follow */\n  private ground: RasterLayer | undefined;\n  /** What its layers made in `vectortiles/` use of it */\n  private readonly context: VectorTilesContext;\n  /** The style once loaded, with its source resolved */\n  readonly ready: Promise<LoadedStyle>;\n\n  /**\n   * Its workers are the map's (shared by every `VectorTiles` of the map, a vector tile decoded once for all of them),\n   * unless `workers` or `workerUrl` asks for others than the map's: then it has workers of its own\n   */\n  constructor(\n    private readonly map: GeoMap,\n    options: VectorTilesOptions = {},\n  ) {\n    const { pool, own } = map.basemapWorkers(options.workers, options.workerUrl);\n\n    this.pool = pool;\n    this.ownPool = own;\n    this.namespace = pool.namespace();\n\n    const style = options.style ?? OPENFREEMAP_STYLES.positron;\n\n    this.attribution = options.attribution ?? styleAttribution(style);\n    this.ready = loadStyle(style);\n    // Reported once here; `ready`, the raster tiles and the labels fail with it\n    this.ready.catch((error: unknown) => {\n      if (!this.destroyed) console.warn('isard: vector tiles', error);\n    });\n    this.context = {\n      map,\n      ready: this.ready,\n      layers: this.layers,\n      cleanup: this.cleanup,\n      iconPrefix: this.iconPrefix,\n      destroyed: () => this.destroyed,\n      ground: () => this.ground,\n      broadcast: (message) => {\n        this.pool.broadcast(message);\n      },\n      request: (vz, vx, vy, work, signal) => this.request(vz, vx, vy, work, signal),\n      renderer: (select, extra, again) => this.renderer(select, extra, { again }),\n      loadSprites: (sprite) => this.loadSprites(sprite),\n      addSprites: () => this.addSprites(),\n      followView: (layer, update, requests, moving) => {\n        this.followView(layer, update, requests, moving);\n      },\n      stopWith: (layer, stop) => {\n        this.stopWith(layer, stop);\n      },\n    };\n  }\n\n  /** The style's sprites (their JSON and their images), loaded once, for the fill patterns and the icons */\n  private sprites: Promise<LoadedSprite[]> | undefined;\n\n  /** The style's sprites, kept once all of them came: one that failed is asked for again by the next layer */\n  private loadSprites(sprite: Style['sprite']): Promise<LoadedSprite[]> {\n    if (this.sprites) return this.sprites;\n\n    const wanted = spriteSources(sprite).length;\n    const loading: Promise<LoadedSprite[]> = loadSprites(sprite)\n      .catch(() => [])\n      .then((loaded) => {\n        if (loaded.length < wanted && this.sprites === loading) {\n          console.warn(\n            `isard: ${wanted - loaded.length} of the style's sprites not loaded, its icons and patterns missing`,\n          );\n          this.sprites = undefined;\n        }\n\n        return loaded;\n      });\n\n    this.sprites = loading;\n\n    return loading;\n  }\n\n  /** The style's sprites added to the map's icons, once */\n  private spritesAdded: Promise<void> | undefined;\n\n  /** The style's sprites among the map's icons (under `iconPrefix`), added once: the labels' icons, the fills'\n   * patterns */\n  private addSprites(): Promise<void> {\n    this.spritesAdded ??= this.ready.then(async ({ style }) => {\n      if (!style.sprite) return;\n      (await this.loadSprites(style.sprite)).forEach((sprite) => {\n        if (!this.destroyed) this.map.icons.addSprite(this.iconPrefix, sprite.icons, () => readPixels(sprite.image));\n      });\n    });\n\n    return this.spritesAdded;\n  }\n\n  /** Prefix of the names of its sprites' images among the map's icons */\n  private get iconPrefix(): string {\n    return `${this.namespace}/`;\n  }\n\n  private request(vz: number, vx: number, vy: number, work: BasemapWork, signal?: AbortSignal) {\n    if (this.destroyed) return Promise.reject(new DOMException('isard: vector tiles destroyed', 'AbortError'));\n\n    return this.map.track(this.pool.request(this.pool.worker(vz, vx, vy), work, this, signal));\n  }\n\n  /** Sends a renderer of these layers to every worker (`again`: under that key, restyled), with the style's sprites if\n   * it `draws` the tiles into images with patterns (the raster path: the others take their images in the page) */\n  private async renderer(\n    select: (layer: StyleLayer) => boolean,\n    extra: StyleLayer[],\n    { again, draws = false }: { again?: string | undefined; draws?: boolean } = {},\n  ): Promise<Renderer> {\n    const { style, tiles, maxzoom, rasters } = await this.ready;\n    const key = again ?? rendererKey(this.namespace, this.keys++);\n    const layers = [...style.layers.filter(select), ...extra];\n    const patterns = draws && layers.some((l) => l.paint?.['fill-pattern'] !== undefined);\n    // The images are downloaded once, copied to each worker\n    const sprites: Sprite[] = patterns && style.sprite ? await this.loadSprites(style.sprite) : [];\n\n    if (this.destroyed) throw new DOMException('isard: vector tiles destroyed', 'AbortError');\n    this.pool.broadcast({ type: 'init', key, tiles, maxzoom, layers, rasters, ...(sprites.length ? { sprites } : {}) });\n    if (!again) this.renderers.push(key);\n\n    return { key, maxzoom, layers };\n  }\n\n  /**\n   * A raster layer drawing the style's fills, lines and circles (or those `layers` keeps, then `extraLayers`, of the\n   * same source); `size`: texture size of its tiles (512 by default: sharp lines)\n   */\n  raster(options: VectorRasterOptions = {}): RasterLayer {\n    const { layers = () => true, extraLayers = [], size: texture = 512, opacity = 1, before } = options;\n    const drawn = (l: StyleLayer) => l.type !== 'symbol' && layers(l);\n    const renderer = this.renderer(drawn, extraLayers, { draws: true });\n\n    // Its failure is reported by `ready` and each tile\n    renderer.catch(() => undefined);\n\n    const loader = async (z: number, x: number, y: number, signal: AbortSignal) => {\n      const { key, maxzoom } = await renderer;\n      // The vector tile it is drawn from (see the worker)\n      const vz = clamp(z - 1, 0, maxzoom);\n      const shift = z - vz;\n      const priority = tilePriority(z, x, y, this.map.getCamera());\n      const response = await this.request(\n        vz,\n        x >> shift,\n        y >> shift,\n        { type: 'render', key, z, x, y, size: texture, priority },\n        signal,\n      );\n\n      return 'image' in response ? response.image : null;\n    };\n    const layer = this.map.addRaster({\n      url: '',\n      size: texture,\n      opacity,\n      minZoom: options.minZoom ?? 0,\n      maxZoom: options.maxZoom ?? 20,\n      loader,\n      ...(this.attribution ? { attribution: this.attribution } : {}),\n      ...(before ? { before } : {}),\n    });\n\n    this.layers.push(layer);\n    this.ground ??= layer;\n\n    return layer;\n  }\n\n  /**\n   * An extrusion layer of the polygons of the style's fill layers that `layers` keeps (by default its buildings: the\n   * fill or fill-extrusion layers of PLAN IGN's `bati_surf` or OpenMapTiles' `building`), raised by the style\n   * given (`height`, `base`, `color`, `ramp`…; the properties of the tiles' features). Its tiles follow the view: at\n   * the source's deepest level, the `maxTiles` nearest to the center, from `minZoom` on (15 by default); the tiles\n   * leaving the view are dropped.\n   */\n  extrusions<P = Record<string, unknown>>(options: VectorExtrusionOptions<P> = {}): ExtrusionLayer<P> {\n    return extrusions<P>(this.context, options);\n  }\n\n  /**\n   * The wind through the streets around the view, as particles at street level (`height`, default 3 metres) between\n   * the style's buildings (`layers`, default its `building` and `bati_surf` layers): their footprints laid on a grid of\n   * `cell` metres (default 4) over a square of `size` metres (default 1200) around the view's center, the flow of the\n   * air round them a potential flow (it goes round the blocks and faster through the narrow streets; no wake behind\n   * them), computed in a worker by the grid module from street level (`minZoom`, default 15) and again when the view\n   * leaves the square's middle. `wind` is the wind far away (east and north, m/s, default a light breeze from the\n   * south-west); `setWind` changes it at once (the flow is linear in it: nothing computed again), from a model's hour\n   * (`windAt`) for instance; `computed` resolves once the first square's flow is there. The other options are the flow\n   * layer's (`addFlow`)\n   */\n  streetWind(options: StreetWindOptions = {}): StreetWindLayer {\n    return streetWind(this.context, options);\n  }\n\n  /**\n   * Trees on the style's woods, forests and grass (or the fill layers `layers` keeps) as 3D models, from street level\n   * (`minZoom`, default 15): the workers scatter them over the polygons of the vector tiles around the view, `spacing`\n   * metres apart (by style layer: 9 in woods, 25 on grass, by default) on a jittered grid, the same trees whenever a\n   * tile comes back; the engine draws them all in one instanced draw, on the relief. A low-poly tree by default (its\n   * `colors`), or your own glTF (`url`, `data`, about 10 metres high, standing on its origin). Dense around the\n   * view's center, fewer and fewer away from it (as the camera moves too), at most `maxInstances` drawn (default\n   * 25000); at most `maxTiles` tiles (default 9) and `maxTrees` trees in each (default 30000). The models load the\n   * engine with 3D Tiles.\n   */\n  trees(options: TreesOptions = {}): ModelLayer {\n    return trees(this.context, options);\n  }\n\n  /**\n   * Street lamps along the style's streets (the road line layers, or those `layers` keeps) as 3D models, from street\n   * level (`minZoom`, default 16): the workers place them `spacing` metres apart (default 30) along each street, every\n   * other one on its other side, as far from its middle as its class says; their heads lit at night (`light`). All of\n   * them near the ground under the camera, fewer and fewer away from it, at most `maxInstances` drawn (default 15000).\n   * The models load the engine with 3D Tiles.\n   */\n  lamps(options: LampsOptions = {}): ModelLayer {\n    return lamps(this.context, options);\n  }\n\n  /**\n   * The street furniture as 3D models, from OpenMapTiles' points of interest of the street: bus shelters at the bus\n   * stops, waste baskets, post boxes, drinking fountains (Wallace's in Paris), bicycle racks, each facing its street;\n   * benches along the pedestrian streets and the paths of the parks and gardens. Placed by the workers, one instanced\n   * draw a kind, all of them near the camera and fewer away from it. The layer returned holds the other kinds' (its\n   * `companions`); removed with it\n   */\n  furniture(options: FurnitureOptions = {}): ModelLayer {\n    return furniture(this.context, options);\n  }\n\n  /**\n   * A layer drawing the style's fills, lines and buildings (or those `layers` keeps; backgrounds as fills, the\n   * `fill-extrusion` layers raised into buildings by their height and base height) as geometry instead of images: the\n   * workers cut the vector tiles in view into polygons and lines, which the engine draws on the globe and the relief,\n   * in the style's order, each style layer over its zoom range. Sharp at any zoom\n   * and pitch, picked by feature (`pick` gives its properties and style layer), restyled without cutting the tiles\n   * again (`setPaintProperty`, `setLayoutProperty`). Its tiles follow the view, while it moves too, coarser far away in a\n   * tilted view, and those leaving it stay until the ones replacing them are there; past the source's deepest level,\n   * cut again from its tiles down to level 18 (overzoom: their styles those of their level; a filter reading the zoom\n   * holds at the whole zoom under the camera's, as MapLibre evaluates it). The fills' outlines are drawn one\n   * pixel wide, the lines' ends as their `line-cap` says, their joins as their `line-join` says (and `line-miter-limit`),\n   * offset by `line-offset`; the colors follow the camera's zoom; the fills', lines' and buildings' patterns from the\n   * style's sprite (the fills' over the relief too; on the globe, their average color there), the circle layers' points\n   * as circles facing the screen, the lines' blur, the fills' and lines' translations. The buildings' roofs (`roofs`)\n   * as their data says (`roof:shape`, `roof:height`; flat without, the default), generated from their outline where\n   * they have none (`'generated'`), or all flat. `raster` stays the lighter path for heavy styles and small devices.\n   * At night (`setSun`) the line layers `streets` keeps glow (by default those whose id names\n   * a road, not its casing, a railway, a path or a tunnel).\n   */\n  vectors(options: VectorsOptions = {}): VectorLayer {\n    return vectors(this.context, options);\n  }\n\n  /**\n   * A symbol layer with the labels of the style's symbol layers (or those `layers` keeps), updated as the view\n   * moves: the labels of the vector tiles in view, the higher style layers placed first. With a raster layer of\n   * the style (`raster`), the tiles follow the levels the ground is drawn at: a tilted view takes coarser tiles far\n   * away, with the few labels of a lower zoom, as near the camera it takes the fine ones. Without, the tiles around\n   * the center at the zoom of the view. It stays above the layers added after it unless one is moved over it.\n   */\n  labels(options: LabelsOptions = {}): SymbolLayer<LabelCandidate> {\n    return labels(this.context, options);\n  }\n\n  /**\n   * Makes a layer's tiles follow the view: `update` now and where the camera stops (`moveend`), `moving` every\n   * `VECTOR_MOVE_REFRESH_MS` while it moves, and again after a pause when tiles failed; the `requests` aborted when\n   * destroyed or the layer removed\n   */\n  private followView(\n    layer: Layer,\n    update: () => Promise<unknown>,\n    requests: TileRequests,\n    moving: () => unknown,\n  ): void {\n    const refresh = () => {\n      update().catch(() => undefined);\n    };\n    const pace = { timer: 0 };\n    const follow = () => {\n      if (pace.timer) return;\n      pace.timer = window.setTimeout(() => {\n        pace.timer = 0;\n        Promise.resolve(moving()).catch(() => undefined);\n      }, VECTOR_MOVE_REFRESH_MS);\n    };\n    const [offMove, offEnd] = [this.map.on('move', follow), this.map.on('moveend', refresh)];\n\n    requests.retryWith(refresh);\n\n    this.stopWith(layer, () => {\n      offMove();\n      offEnd();\n      clearTimeout(pace.timer);\n      requests.abortAll();\n    });\n    refresh();\n  }\n\n  /** Calls `stop` when destroyed or once `layer` is removed, whichever comes first */\n  private stopWith(layer: Layer, stop: () => void): void {\n    const once = { done: false };\n    const run = () => {\n      if (once.done) return;\n      once.done = true;\n      stop();\n    };\n\n    this.cleanup.push(run);\n    layer.whenRemoved.push(run);\n  }\n\n  /** Removes its layers from the map (those still there) and stops its workers' work */\n  remove(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n    this.cleanup.forEach((off) => {\n      off();\n    });\n    this.cleanup.length = 0;\n    this.layers.forEach((layer) => {\n      if (this.map.hasLayer(layer)) layer.remove();\n    });\n    this.layers.length = 0;\n    this.map.dropVectorTiles(this);\n    // The page's copy of the sprites (the workers have theirs), and their icons\n    this.sprites\n      ?.then((sprites) => {\n        sprites.forEach((sprite) => {\n          sprite.image.close();\n        });\n        this.map.icons.remove(this.iconPrefix, true);\n      })\n      .catch(() => undefined);\n    if (this.ownPool) {\n      this.pool.terminate();\n    } else {\n      // Shared workers: only its requests stop and its renderers go\n      this.pool.cancel(this);\n      this.renderers.forEach((key) => {\n        this.pool.broadcast({ type: 'drop', key });\n      });\n    }\n    this.renderers.length = 0;\n  }\n}\n"]}
+{"version":3,"file":"vectortiles.js","sourceRoot":"","sources":["../../src/basemap/vectortiles.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Vector basemaps from a MapLibre style (OpenFreeMap's Positron by default): the fills, lines, circles and raster\n * layers drawn tile by tile in workers into the raster pool, so that they lie on the relief like any basemap and\n * composite with the hillshade in one pass; and the labels of the style's symbol layers in a symbol layer of their own,\n * kept above the application's layers (as MapLibre's `beforeId: firstSymbol` does), listed by the workers, shaped in\n * the page once per vector tile, placed by the engine.\n *\n * Any subset of the style can be drawn on its own raster layer (`raster({ layers })`), at its own place in the stack:\n * rivers from the basemap's data over a flood layer, for instance, restyled with `extraLayers`.\n *\n * The layers other than the raster ones are made in `vectortiles/` (one module each), from what they use of the\n * instance (`VectorTilesContext`); the style's loading is in `vectortiles/style.ts`.\n */\n\nimport type { ExtrusionLayer } from '../layers/extrusions.ts';\nimport { type LoadedSprite, loadSprites, readPixels, spriteSources } from '../layers/icons.ts';\nimport type { Layer } from '../layers/layers.ts';\nimport type { ModelLayer } from '../layers/models.ts';\nimport type { RasterLayer } from '../layers/raster.ts';\nimport type { SymbolLayer } from '../layers/symbols.ts';\nimport type { VectorLayer } from '../layers/vectors.ts';\nimport type { GeoMap } from '../map.ts';\nimport type { Placement } from '../types.ts';\nimport { clamp } from '../util/math.ts';\nimport type { BasemapWork, Sprite } from '../workers/basemap/protocol.ts';\nimport type { LabelCandidate, Style, StyleLayer } from './vectorstyle.ts';\nimport type { Renderer, VectorTilesContext } from './vectortiles/context.ts';\nimport { extrusions, type VectorExtrusionOptions } from './vectortiles/extrusions.ts';\nimport { type FurnitureOptions, furniture } from './vectortiles/furniture.ts';\nimport { type LabelsOptions, labels, size, tileLabels } from './vectortiles/labels.ts';\nimport { type LampsOptions, lamps } from './vectortiles/lamps.ts';\nimport type { TileRequests } from './vectortiles/requests.ts';\nimport { type StreetWindLayer, type StreetWindOptions, streetWind } from './vectortiles/street-wind.ts';\nimport {\n  type LoadedStyle,\n  loadStyle,\n  OPENFREEMAP_STYLES,\n  PLAN_STYLES,\n  styleAttribution,\n  VECTOR_BASEMAPS,\n} from './vectortiles/style.ts';\nimport { VECTOR_MOVE_REFRESH_MS } from './vectortiles/tiles.ts';\nimport { type TreesOptions, trees } from './vectortiles/trees.ts';\nimport { dashes, type VectorsOptions, vectors } from './vectortiles/vectors.ts';\nimport { type BasemapWorkers, rendererKey, tilePriority } from './workerpool.ts';\n\n// The names the package and its tests import from here, now made in `vectortiles/`\nexport { dashes, OPENFREEMAP_STYLES, PLAN_STYLES, size, styleAttribution, tileLabels, VECTOR_BASEMAPS };\n\n/** The options of `VectorTiles.raster` */\nexport interface VectorRasterOptions extends Placement {\n  /** The style layers drawn (default all but the symbols) */\n  layers?: (layer: StyleLayer) => boolean;\n  /** Style layers of the same source drawn after them */\n  extraLayers?: StyleLayer[];\n  /** Texture size of its tiles (512 by default: sharp lines) */\n  size?: number;\n  opacity?: number;\n  minZoom?: number;\n  maxZoom?: number;\n}\n\nexport interface VectorTilesOptions {\n  /** A style URL or object (default OpenFreeMap's Positron) */\n  style?: string | Style;\n  /** Workers drawing the tiles (default cores - 1, 1 to 4). The vector tiles of a map share its workers (and their\n   * decoded tiles); another count gives these tiles workers of their own */\n  workers?: number;\n  /** Where to load the worker from, when a bundler does not resolve the default URL (default the map's\n   * `basemapWorkerUrl`); another URL than the map's gives these tiles workers of their own */\n  workerUrl?: string | URL;\n  /** Credits of the tiles, shown while its raster layers are on the map (default: OpenFreeMap's for its styles, the\n   * IGN's for PLAN.IGN's) */\n  attribution?: string;\n}\n\nexport class VectorTiles {\n  private readonly pool: BasemapWorkers;\n  /** The pool is this instance's own (a worker count or URL other than the map's): stopped with it */\n  private readonly ownPool: boolean;\n  /** Prefix of its renderer keys in the pool's workers */\n  private readonly namespace: string;\n  private destroyed = false;\n  private keys = 0;\n  /** Renderers sent to the workers, dropped on destroy */\n  private readonly renderers: string[] = [];\n  private readonly cleanup: (() => void)[] = [];\n  /** Credits of its raster layers */\n  private readonly attribution: string | undefined;\n  /** Its raster and label layers, removed with it */\n  private readonly layers: Layer[] = [];\n  /** Its first raster layer: the ground its labels follow */\n  private ground: RasterLayer | undefined;\n  /** What its layers made in `vectortiles/` use of it */\n  private readonly context: VectorTilesContext;\n  /** The style once loaded, with its source resolved */\n  readonly ready: Promise<LoadedStyle>;\n\n  /**\n   * Its workers are the map's (shared by every `VectorTiles` of the map, a vector tile decoded once for all of them),\n   * unless `workers` or `workerUrl` asks for others than the map's: then it has workers of its own\n   */\n  constructor(\n    private readonly map: GeoMap,\n    options: VectorTilesOptions = {},\n  ) {\n    const { pool, own } = map.basemapWorkers(options.workers, options.workerUrl);\n\n    this.pool = pool;\n    this.ownPool = own;\n    this.namespace = pool.namespace();\n\n    const style = options.style ?? OPENFREEMAP_STYLES.positron;\n\n    this.attribution = options.attribution ?? styleAttribution(style);\n    this.ready = loadStyle(style);\n    // Reported once here; `ready`, the raster tiles and the labels fail with it\n    this.ready.catch((error: unknown) => {\n      if (!this.destroyed) console.warn('isard: vector tiles', error);\n    });\n    this.context = {\n      map,\n      ready: this.ready,\n      layers: this.layers,\n      cleanup: this.cleanup,\n      iconPrefix: this.iconPrefix,\n      destroyed: () => this.destroyed,\n      ground: () => this.ground,\n      broadcast: (message) => {\n        this.pool.broadcast(message);\n      },\n      request: (vz, vx, vy, work, signal) => this.request(vz, vx, vy, work, signal),\n      renderer: (select, extra, again) => this.renderer(select, extra, { again }),\n      loadSprites: (sprite) => this.loadSprites(sprite),\n      addSprites: () => this.addSprites(),\n      followView: (layer, update, requests, moving) => {\n        this.followView(layer, update, requests, moving);\n      },\n      stopWith: (layer, stop) => {\n        this.stopWith(layer, stop);\n      },\n    };\n  }\n\n  /** The style's sprites (their JSON and their images), loaded once, for the fill patterns and the icons */\n  private sprites: Promise<LoadedSprite[]> | undefined;\n\n  /** The style's sprites, kept once all of them came: one that failed is asked for again by the next layer */\n  private loadSprites(sprite: Style['sprite']): Promise<LoadedSprite[]> {\n    if (this.sprites) return this.sprites;\n\n    const wanted = spriteSources(sprite).length;\n    const loading: Promise<LoadedSprite[]> = loadSprites(sprite)\n      .catch(() => [])\n      .then((loaded) => {\n        if (loaded.length < wanted && this.sprites === loading) {\n          console.warn(\n            `isard: ${wanted - loaded.length} of the style's sprites not loaded, its icons and patterns missing`,\n          );\n          this.sprites = undefined;\n        }\n\n        return loaded;\n      });\n\n    this.sprites = loading;\n\n    return loading;\n  }\n\n  /** The style's sprites added to the map's icons, once */\n  private spritesAdded: Promise<void> | undefined;\n\n  /** The style's sprites among the map's icons (under `iconPrefix`), added once: the labels' icons, the fills'\n   * patterns */\n  private addSprites(): Promise<void> {\n    this.spritesAdded ??= this.ready.then(async ({ style }) => {\n      if (!style.sprite) return;\n      (await this.loadSprites(style.sprite)).forEach((sprite) => {\n        if (!this.destroyed) this.map.icons.addSprite(this.iconPrefix, sprite.icons, () => readPixels(sprite.image));\n      });\n    });\n\n    return this.spritesAdded;\n  }\n\n  /** Prefix of the names of its sprites' images among the map's icons */\n  private get iconPrefix(): string {\n    return `${this.namespace}/`;\n  }\n\n  private request(vz: number, vx: number, vy: number, work: BasemapWork, signal?: AbortSignal) {\n    if (this.destroyed) return Promise.reject(new DOMException('isard: vector tiles destroyed', 'AbortError'));\n\n    return this.map.track(this.pool.request(this.pool.worker(vz, vx, vy), work, this, signal));\n  }\n\n  /** Sends a renderer of these layers to every worker (`again`: under that key, restyled), with the style's sprites if\n   * it `draws` the tiles into images with patterns (the raster path: the others take their images in the page) */\n  private async renderer(\n    select: (layer: StyleLayer) => boolean,\n    extra: StyleLayer[],\n    { again, draws = false }: { again?: string | undefined; draws?: boolean } = {},\n  ): Promise<Renderer> {\n    const { style, tiles, maxzoom, rasters } = await this.ready;\n    const key = again ?? rendererKey(this.namespace, this.keys++);\n    const layers = [...style.layers.filter(select), ...extra];\n    const patterns = draws && layers.some((l) => l.paint?.['fill-pattern'] !== undefined);\n    // The images are downloaded once, copied to each worker\n    const sprites: Sprite[] = patterns && style.sprite ? await this.loadSprites(style.sprite) : [];\n\n    if (this.destroyed) throw new DOMException('isard: vector tiles destroyed', 'AbortError');\n    this.pool.broadcast({\n      type: 'init',\n      key,\n      tiles,\n      maxzoom,\n      layers,\n      rasters,\n      cached: this.map.quality.cachedTiles,\n      ...(sprites.length ? { sprites } : {}),\n    });\n    if (!again) this.renderers.push(key);\n\n    return { key, maxzoom, layers };\n  }\n\n  /**\n   * A raster layer drawing the style's fills, lines and circles (or those `layers` keeps, then `extraLayers`, of the\n   * same source); `size`: texture size of its tiles (512 by default: sharp lines)\n   */\n  raster(options: VectorRasterOptions = {}): RasterLayer {\n    const { layers = () => true, extraLayers = [], size: texture = 512, opacity = 1, before } = options;\n    const drawn = (l: StyleLayer) => l.type !== 'symbol' && layers(l);\n    const renderer = this.renderer(drawn, extraLayers, { draws: true });\n\n    // Its failure is reported by `ready` and each tile\n    renderer.catch(() => undefined);\n\n    const loader = async (z: number, x: number, y: number, signal: AbortSignal) => {\n      const { key, maxzoom } = await renderer;\n      // The vector tile it is drawn from (see the worker)\n      const vz = clamp(z - 1, 0, maxzoom);\n      const shift = z - vz;\n      const priority = tilePriority(z, x, y, this.map.getCamera());\n      const response = await this.request(\n        vz,\n        x >> shift,\n        y >> shift,\n        { type: 'render', key, z, x, y, size: texture, priority },\n        signal,\n      );\n\n      return 'image' in response ? response.image : null;\n    };\n    const layer = this.map.addRaster({\n      url: '',\n      size: texture,\n      opacity,\n      minZoom: options.minZoom ?? 0,\n      maxZoom: options.maxZoom ?? 20,\n      loader,\n      ...(this.attribution ? { attribution: this.attribution } : {}),\n      ...(before ? { before } : {}),\n    });\n\n    this.layers.push(layer);\n    this.ground ??= layer;\n\n    return layer;\n  }\n\n  /**\n   * An extrusion layer of the polygons of the style's fill layers that `layers` keeps (by default its buildings: the\n   * fill or fill-extrusion layers of PLAN IGN's `bati_surf` or OpenMapTiles' `building`), raised by the style\n   * given (`height`, `base`, `color`, `ramp`…; the properties of the tiles' features). Its tiles follow the view: at\n   * the source's deepest level, the `maxTiles` nearest to the center, from `minZoom` on (15 by default); the tiles\n   * leaving the view are dropped.\n   */\n  extrusions<P = Record<string, unknown>>(options: VectorExtrusionOptions<P> = {}): ExtrusionLayer<P> {\n    return extrusions<P>(this.context, options);\n  }\n\n  /**\n   * The wind through the streets around the view, as particles at street level (`height`, default 3 metres) between\n   * the style's buildings (`layers`, default its `building` and `bati_surf` layers): their footprints laid on a grid of\n   * `cell` metres (default 4) over a square of `size` metres (default 1200) around the view's center, the flow of the\n   * air round them a potential flow (it goes round the blocks and faster through the narrow streets; no wake behind\n   * them), computed in a worker by the grid module from street level (`minZoom`, default 15) and again when the view\n   * leaves the square's middle. `wind` is the wind far away (east and north, m/s, default a light breeze from the\n   * south-west); `setWind` changes it at once (the flow is linear in it: nothing computed again), from a model's hour\n   * (`windAt`) for instance; `computed` resolves once the first square's flow is there. The other options are the flow\n   * layer's (`addFlow`)\n   */\n  streetWind(options: StreetWindOptions = {}): StreetWindLayer {\n    return streetWind(this.context, options);\n  }\n\n  /**\n   * Trees on the style's woods, forests and grass (or the fill layers `layers` keeps) as 3D models, from street level\n   * (`minZoom`, default 15): the workers scatter them over the polygons of the vector tiles around the view, `spacing`\n   * metres apart (by style layer: 9 in woods, 25 on grass, by default) on a jittered grid, the same trees whenever a\n   * tile comes back; the engine draws them all in one instanced draw, on the relief. A low-poly tree by default (its\n   * `colors`), or your own glTF (`url`, `data`, about 10 metres high, standing on its origin). Dense around the\n   * view's center, fewer and fewer away from it (as the camera moves too), at most `maxInstances` drawn (default\n   * 25000); at most `maxTiles` tiles (default 9) and `maxTrees` trees in each (default 30000). The models load the\n   * engine with 3D Tiles.\n   */\n  trees(options: TreesOptions = {}): ModelLayer {\n    return trees(this.context, options);\n  }\n\n  /**\n   * Street lamps along the style's streets (the road line layers, or those `layers` keeps) as 3D models, from street\n   * level (`minZoom`, default 16): the workers place them `spacing` metres apart (default 30) along each street, every\n   * other one on its other side, as far from its middle as its class says; their heads lit at night (`light`). All of\n   * them near the ground under the camera, fewer and fewer away from it, at most `maxInstances` drawn (default 15000).\n   * The models load the engine with 3D Tiles.\n   */\n  lamps(options: LampsOptions = {}): ModelLayer {\n    return lamps(this.context, options);\n  }\n\n  /**\n   * The street furniture as 3D models, from OpenMapTiles' points of interest of the street: bus shelters at the bus\n   * stops, waste baskets, post boxes, drinking fountains (Wallace's in Paris), bicycle racks, each facing its street;\n   * benches along the pedestrian streets and the paths of the parks and gardens. Placed by the workers, one instanced\n   * draw a kind, all of them near the camera and fewer away from it. The layer returned holds the other kinds' (its\n   * `companions`); removed with it\n   */\n  furniture(options: FurnitureOptions = {}): ModelLayer {\n    return furniture(this.context, options);\n  }\n\n  /**\n   * A layer drawing the style's fills, lines and buildings (or those `layers` keeps; backgrounds as fills, the\n   * `fill-extrusion` layers raised into buildings by their height and base height) as geometry instead of images: the\n   * workers cut the vector tiles in view into polygons and lines, which the engine draws on the globe and the relief,\n   * in the style's order, each style layer over its zoom range. Sharp at any zoom\n   * and pitch, picked by feature (`pick` gives its properties and style layer), restyled without cutting the tiles\n   * again (`setPaintProperty`, `setLayoutProperty`). Its tiles follow the view, while it moves too, coarser far away in a\n   * tilted view, and those leaving it stay until the ones replacing them are there; past the source's deepest level,\n   * cut again from its tiles down to level 18 (overzoom: their styles those of their level; a filter reading the zoom\n   * holds at the whole zoom under the camera's, as MapLibre evaluates it). The fills' outlines are drawn one\n   * pixel wide, the lines' ends as their `line-cap` says, their joins as their `line-join` says (and `line-miter-limit`),\n   * offset by `line-offset`; the colors follow the camera's zoom; the fills', lines' and buildings' patterns from the\n   * style's sprite (the fills' over the relief too; on the globe, their average color there), the circle layers' points\n   * as circles facing the screen, the lines' blur, the fills' and lines' translations. The buildings' roofs (`roofs`)\n   * as their data says (`roof:shape`, `roof:height`; flat without, the default), generated from their outline where\n   * they have none (`'generated'`), or all flat. `raster` stays the lighter path for heavy styles and small devices.\n   * At night (`setSun`) the line layers `streets` keeps glow (by default those whose id names\n   * a road, not its casing, a railway, a path or a tunnel).\n   */\n  vectors(options: VectorsOptions = {}): VectorLayer {\n    return vectors(this.context, options);\n  }\n\n  /**\n   * A symbol layer with the labels of the style's symbol layers (or those `layers` keeps), updated as the view\n   * moves: the labels of the vector tiles in view, the higher style layers placed first. With a raster layer of\n   * the style (`raster`), the tiles follow the levels the ground is drawn at: a tilted view takes coarser tiles far\n   * away, with the few labels of a lower zoom, as near the camera it takes the fine ones. Without, the tiles around\n   * the center at the zoom of the view. It stays above the layers added after it unless one is moved over it.\n   */\n  labels(options: LabelsOptions = {}): SymbolLayer<LabelCandidate> {\n    return labels(this.context, options);\n  }\n\n  /**\n   * Makes a layer's tiles follow the view: `update` now and where the camera stops (`moveend`), `moving` every\n   * `VECTOR_MOVE_REFRESH_MS` while it moves, and again after a pause when tiles failed; the `requests` aborted when\n   * destroyed or the layer removed\n   */\n  private followView(\n    layer: Layer,\n    update: () => Promise<unknown>,\n    requests: TileRequests,\n    moving: () => unknown,\n  ): void {\n    const refresh = () => {\n      update().catch(() => undefined);\n    };\n    const pace = { timer: 0 };\n    const follow = () => {\n      if (pace.timer) return;\n      pace.timer = window.setTimeout(() => {\n        pace.timer = 0;\n        Promise.resolve(moving()).catch(() => undefined);\n      }, VECTOR_MOVE_REFRESH_MS);\n    };\n    const [offMove, offEnd] = [this.map.on('move', follow), this.map.on('moveend', refresh)];\n\n    requests.retryWith(refresh);\n\n    this.stopWith(layer, () => {\n      offMove();\n      offEnd();\n      clearTimeout(pace.timer);\n      requests.abortAll();\n    });\n    refresh();\n  }\n\n  /** Calls `stop` when destroyed or once `layer` is removed, whichever comes first */\n  private stopWith(layer: Layer, stop: () => void): void {\n    const once = { done: false };\n    const run = () => {\n      if (once.done) return;\n      once.done = true;\n      stop();\n    };\n\n    this.cleanup.push(run);\n    layer.whenRemoved.push(run);\n  }\n\n  /** Removes its layers from the map (those still there) and stops its workers' work */\n  remove(): void {\n    if (this.destroyed) return;\n    this.destroyed = true;\n    this.cleanup.forEach((off) => {\n      off();\n    });\n    this.cleanup.length = 0;\n    this.layers.forEach((layer) => {\n      if (this.map.hasLayer(layer)) layer.remove();\n    });\n    this.layers.length = 0;\n    this.map.dropVectorTiles(this);\n    // The page's copy of the sprites (the workers have theirs), and their icons\n    this.sprites\n      ?.then((sprites) => {\n        sprites.forEach((sprite) => {\n          sprite.image.close();\n        });\n        this.map.icons.remove(this.iconPrefix, true);\n      })\n      .catch(() => undefined);\n    if (this.ownPool) {\n      this.pool.terminate();\n    } else {\n      // Shared workers: only its requests stop and its renderers go\n      this.pool.cancel(this);\n      this.renderers.forEach((key) => {\n        this.pool.broadcast({ type: 'drop', key });\n      });\n    }\n    this.renderers.length = 0;\n  }\n}\n"]}

package/dist/basemap/workerpool.d.ts

@@ -2,8 +2,8 @@
  * kept there), the requests of an owner cancelled together, the renderers broadcast to every worker */
 import type { Camera } from '../wasm/isard.js';
 import type { Priority } from '../workers/basemap/protocol.ts';
-/** Default size of a basemap worker pool: cores - 1, 1 to 4 */
-export declare const defaultWorkerCount: () => number;
+/** Default size of a basemap worker pool: cores - 1, 1 to `most` (4 by default, fewer at a lower quality) */
+export declare const defaultWorkerCount: (most?: number) => number;
 /** Default URL of the basemap worker: in the page's assets folder (`isard/vite`), else next to the module */
 export declare const defaultWorkerUrl: (assetsUrl?: string | URL) => string | URL;
 /** Fetch priority of a raster tile drawn by the workers: 'high' near the center of the view, at the current zoom or

package/dist/basemap/workerpool.js

@@ -4,9 +4,9 @@ import { assetUrl } from "../engine-loader.js";
 import { mercatorX, mercatorY } from "../util/geo.js";
 import { headerRules, onHeaderRules } from "../util/requests.js";
 import { SOURCE_CACHE } from "./resample.js";
-/** Default size of a basemap worker pool: cores - 1, 1 to 4 */
-export const defaultWorkerCount = () => {
-    return Math.min(4, Math.max(1, (typeof navigator !== 'undefined' ? navigator.hardwareConcurrency || 2 : 2) - 1));
+/** Default size of a basemap worker pool: cores - 1, 1 to `most` (4 by default, fewer at a lower quality) */
+export const defaultWorkerCount = (most = 4) => {
+    return Math.min(most, Math.max(1, (typeof navigator !== 'undefined' ? navigator.hardwareConcurrency || 2 : 2) - 1));
 };
 /** Default URL of the basemap worker: in the page's assets folder (`isard/vite`), else next to the module */
 export const defaultWorkerUrl = (assetsUrl) => {

package/dist/basemap/workerpool.js.map

@@ -1 +1 @@
-{"version":3,"file":"workerpool.js","sourceRoot":"","sources":["../../src/basemap/workerpool.ts"],"names":[],"mappings":"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","sourcesContent":["/** The pool of basemap workers the vector tiles share: a vector tile always goes to the same worker (its decoded copy\n * kept there), the requests of an owner cancelled together, the renderers broadcast to every worker */\n\nimport { assetUrl } from '../engine-loader.ts';\nimport type { GridDescription } from '../grid-module.ts';\nimport { mercatorX, mercatorY } from '../util/geo.ts';\nimport { headerRules, onHeaderRules } from '../util/requests.ts';\nimport type { Camera } from '../wasm/isard.js';\nimport type { BasemapRequest, BasemapResponse, BasemapWork, Priority } from '../workers/basemap/protocol.ts';\nimport { type Job, SOURCE_CACHE } from './resample.ts';\nimport type { PngEncoding } from './terrain.ts';\n\n/** Default size of a basemap worker pool: cores - 1, 1 to 4 */\nexport const defaultWorkerCount = (): number => {\n  return Math.min(4, Math.max(1, (typeof navigator !== 'undefined' ? navigator.hardwareConcurrency || 2 : 2) - 1));\n};\n\n/** Default URL of the basemap worker: in the page's assets folder (`isard/vite`), else next to the module */\nexport const defaultWorkerUrl = (assetsUrl?: string | URL): string | URL => {\n  return assetUrl('basemap.worker.js', undefined, assetsUrl);\n};\n\n/** Fetch priority of a raster tile drawn by the workers: 'high' near the center of the view, at the current zoom or\n * coarser; 'low' far from it or finer (prefetch); 'auto' between */\nexport const tilePriority = (z: number, x: number, y: number, camera: Pick<Camera, 'center' | 'zoom'>): Priority => {\n  // A raster tile of level z covers the map at zoom z - 1\n  if (z - 1 > camera.zoom + 1) return 'low';\n\n  const n = 2 ** z;\n  const [lon, lat] = camera.center;\n  const cx = mercatorX(lon) * n;\n  const cy = mercatorY(lat) * n;\n  // Across the antimeridian, the short way\n  const along = Math.abs(x + 0.5 - cx) % n;\n  const dx = Math.min(along, n - along);\n  const d = Math.hypot(dx, y + 0.5 - cy);\n\n  if (d <= 1.5) return 'high';\n\n  return d >= 4 ? 'low' : 'auto';\n};\n\n/** The worker of a vector tile among `count`: always the same one */\nexport const workerIndex = (vz: number, vx: number, vy: number, count: number): number => {\n  // Unsigned: every worker gets its share\n  return ((Math.imul(vx, 73856093) ^ Math.imul(vy, 19349663) ^ vz) >>> 0) % Math.max(1, count);\n};\n\n/** The worker-side key of a renderer: unique across the `VectorTiles` sharing a pool */\nexport const rendererKey = (namespace: string, n: number): string => {\n  return `${namespace}:r${n}`;\n};\n\n/** What the pool needs of a worker (a `Worker`, or a stand-in in tests) */\nexport type PoolWorker = Pick<Worker, 'postMessage' | 'terminate' | 'onmessage' | 'onerror' | 'onmessageerror'>;\n\n/**\n * @internal Workers drawing vector tiles, shared by the `VectorTiles` of a map: each vector tile always goes to the\n * same worker, which keeps it decoded for every style drawn from it. Requests are tracked one by one, with their\n * owner, so that one `VectorTiles` going away cancels its own requests only.\n */\nexport class BasemapWorkers {\n  private readonly workers: [PoolWorker, ...PoolWorker[]];\n  private readonly pending = new Map<\n    number,\n    { resolve: (r: BasemapResponse) => void; reject: (e: Error) => void; worker: PoolWorker; owner: object }\n  >();\n  private next = 1;\n  /** The workers that answered once (they loaded), and those that failed before: dead, their error given at once to\n   * any request still sent their way */\n  private readonly answered = new WeakSet<PoolWorker>();\n  private readonly dead = new Map<PoolWorker, Error>();\n  /** The worker the next file of grids goes to, in turn */\n  private turn = 0;\n  private namespaces = 0;\n  private terminated = false;\n  /** Stops following the page's request headers */\n  private readonly unfollow: () => void;\n\n  constructor(\n    readonly count: number,\n    readonly url: string | URL,\n    create: (url: string | URL) => PoolWorker = (u) => new Worker(u, { type: 'module' }),\n  ) {\n    const start = (): PoolWorker => {\n      const worker = create(url);\n\n      worker.onmessage = ({ data }: MessageEvent<BasemapResponse>) => {\n        this.answered.add(worker);\n\n        const p = this.pending.get(data.id);\n\n        if (!p) return;\n        this.pending.delete(data.id);\n        if ('error' in data) p.reject(new Error(data.error));\n        else p.resolve(data);\n      };\n      // A worker that fails to load (a bundler serving it from elsewhere) or to read a message fails its requests; one\n      // that never answered is dead: its tiles go to the others, and with none left every request fails at once\n      worker.onerror = (event) => {\n        event.preventDefault();\n\n        const error = this.fail(\n          worker,\n          `the vector basemap worker ${url} failed${event.message ? `: ${event.message}` : ''}`,\n        );\n\n        if (!this.answered.has(worker)) this.dead.set(worker, error);\n      };\n      worker.onmessageerror = () => this.fail(worker, `the vector basemap worker ${url} sent an unreadable message`);\n\n      const rules = headerRules();\n\n      if (rules.length > 0) worker.postMessage({ type: 'headers', rules } satisfies BasemapRequest);\n\n      return worker;\n    };\n\n    this.workers = [start(), ...Array.from({ length: Math.max(1, count) - 1 }, start)];\n    this.unfollow = onHeaderRules((rules) => {\n      this.workers.forEach((w) => {\n        w.postMessage({ type: 'headers', rules } satisfies BasemapRequest);\n      });\n    });\n  }\n\n  /** A prefix for the renderer keys of one `VectorTiles` */\n  namespace(): string {\n    return `v${this.namespaces++}`;\n  }\n\n  /** Requests in progress */\n  get size(): number {\n    return this.pending.size;\n  }\n\n  /** Rejects the requests of a failed worker, with the error returned */\n  private fail(worker: PoolWorker, message: string): Error {\n    const error = new Error(\n      `isard: ${message}. If a bundler moves the worker, give its URL in the \\`basemapWorkerUrl\\` option (see \"With a bundler\" in the guide)`,\n    );\n\n    this.pending.forEach((p, id) => {\n      if (p.worker !== worker) return;\n      this.pending.delete(id);\n      p.reject(error);\n    });\n\n    return error;\n  }\n\n  /** The worker of a vector tile: always the same one, or the next living one if it died */\n  worker(vz: number, vx: number, vy: number): PoolWorker {\n    return this.living(workerIndex(vz, vx, vy, this.workers.length));\n  }\n\n  /** The worker at `index`, or the next one that has not died (the first one when all have) */\n  private living(index: number): PoolWorker {\n    const { workers } = this;\n    const at = (k: number) => workers[(index + k) % workers.length] ?? workers[0];\n    const k = workers.findIndex((_, k) => !this.dead.has(at(k)));\n\n    return at(Math.max(0, k));\n  }\n\n  /** Sends a message to every worker (a renderer, or its removal, or where the tessellation module is) */\n  broadcast(message: Extract<BasemapRequest, { type: 'init' } | { type: 'drop' } | { type: 'tess' }>): void {\n    if (this.terminated) return;\n\n    // A renderer tells the workers how many they are: they share the decoded tiles' budget\n    const sent = message.type === 'init' ? { ...message, workers: this.workers.length } : message;\n\n    // A sprite image is copied to each worker (structured clone)\n    this.workers.forEach((w) => {\n      w.postMessage(sent);\n    });\n  }\n\n  /** Asks a worker for a tile's image or labels, on behalf of `owner` */\n  request(worker: PoolWorker, work: BasemapWork, owner: object, signal?: AbortSignal): Promise<BasemapResponse> {\n    return new Promise<BasemapResponse>((resolve, reject) => {\n      if (this.terminated) return reject(new DOMException('isard: vector tiles destroyed', 'AbortError'));\n      if (signal?.aborted) return reject(new DOMException('isard: aborted', 'AbortError'));\n\n      const dead = this.dead.get(worker);\n\n      if (dead) return reject(dead);\n\n      const id = this.next++;\n      const abort = () => {\n        if (!this.pending.delete(id)) return;\n        worker.postMessage({ type: 'abort', id } satisfies BasemapRequest);\n        reject(new DOMException('isard: aborted', 'AbortError'));\n      };\n      // The listener goes once the request is settled\n      const settle = () => signal?.removeEventListener('abort', abort);\n\n      this.pending.set(id, {\n        resolve: (r) => {\n          settle();\n          resolve(r);\n        },\n        reject: (e) => {\n          settle();\n          reject(e);\n        },\n        worker,\n        owner,\n      });\n      signal?.addEventListener('abort', abort, { once: true });\n      worker.postMessage({ ...work, id } satisfies BasemapRequest);\n    });\n  }\n\n  /** The altitudes of a PNG relief tile `z`/`x`/`y` at `url`, decoded by a worker (see `fetchHeights`) */\n  heights(\n    url: string,\n    encoding: PngEncoding,\n    floor: number | undefined,\n    [z, x, y]: [number, number, number],\n    signal: AbortSignal,\n    owner: object,\n  ): Promise<Float32Array | null> {\n    const work: BasemapWork = { type: 'heights', url, encoding, ...(floor === undefined ? {} : { floor }) };\n\n    return this.request(this.worker(z, x, y), work, owner, signal).then((r) => ('heights' in r ? r.heights : null));\n  }\n\n  /** Mercator tile `z`/`x`/`y` reprojected by a worker from the source images of its plan (see `resampler`) */\n  reproject(\n    job: Job,\n    [z, x, y]: [number, number, number],\n    signal: AbortSignal,\n    owner: object,\n  ): Promise<ImageBitmap | null> {\n    // Blocks of 4 × 4 Mercator tiles go to the same worker: neighbours share source tiles, each worker keeps its share\n    const worker = this.worker(Math.max(0, z - 2), x >> 2, y >> 2);\n    const cached = Math.max(16, Math.ceil(SOURCE_CACHE / this.workers.length));\n    const work: BasemapWork = { type: 'reproject', job, cached };\n\n    return this.request(worker, work, owner, signal).then((r) => ('image' in r ? r.image : null));\n  }\n\n  /** A GRIB2 or NetCDF file (its URL, fetched by the worker, or its bytes, transferred) read into grids by the grid\n   * module (`module`), in the next worker */\n  grids(\n    source: { url: string } | { bytes: ArrayBuffer },\n    module: string,\n    signal: AbortSignal | undefined,\n    owner: object,\n  ): Promise<{ grids: GridDescription[]; values: Float32Array[] }> {\n    const work: BasemapWork = { type: 'grids', module, ...source };\n\n    this.turn = (this.turn + 1) % this.workers.length;\n\n    return this.request(this.living(this.turn), work, owner, signal).then((r) =>\n      'grids' in r ? { grids: r.grids, values: r.values } : { grids: [], values: [] },\n    );\n  }\n\n  /** Cancels the requests of an owner (the workers stop them) */\n  cancel(owner: object): void {\n    this.pending.forEach((p, id) => {\n      if (p.owner !== owner) return;\n      this.pending.delete(id);\n      p.worker.postMessage({ type: 'abort', id } satisfies BasemapRequest);\n      p.reject(new DOMException('isard: vector tiles destroyed', 'AbortError'));\n    });\n  }\n\n  /** Stops the workers; their requests fail */\n  terminate(): void {\n    if (this.terminated) return;\n    this.terminated = true;\n    this.unfollow();\n    this.workers.forEach((w) => {\n      w.terminate();\n    });\n\n    const pending = [...this.pending.values()];\n\n    this.pending.clear();\n    pending.forEach((p) => {\n      p.reject(new DOMException('isard: vector tiles destroyed', 'AbortError'));\n    });\n  }\n}\n"]}
+{"version":3,"file":"workerpool.js","sourceRoot":"","sources":["../../src/basemap/workerpool.ts"],"names":[],"mappings":"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","sourcesContent":["/** The pool of basemap workers the vector tiles share: a vector tile always goes to the same worker (its decoded copy\n * kept there), the requests of an owner cancelled together, the renderers broadcast to every worker */\n\nimport { assetUrl } from '../engine-loader.ts';\nimport type { GridDescription } from '../grid-module.ts';\nimport { mercatorX, mercatorY } from '../util/geo.ts';\nimport { headerRules, onHeaderRules } from '../util/requests.ts';\nimport type { Camera } from '../wasm/isard.js';\nimport type { BasemapRequest, BasemapResponse, BasemapWork, Priority } from '../workers/basemap/protocol.ts';\nimport { type Job, SOURCE_CACHE } from './resample.ts';\nimport type { PngEncoding } from './terrain.ts';\n\n/** Default size of a basemap worker pool: cores - 1, 1 to `most` (4 by default, fewer at a lower quality) */\nexport const defaultWorkerCount = (most = 4): number => {\n  return Math.min(most, Math.max(1, (typeof navigator !== 'undefined' ? navigator.hardwareConcurrency || 2 : 2) - 1));\n};\n\n/** Default URL of the basemap worker: in the page's assets folder (`isard/vite`), else next to the module */\nexport const defaultWorkerUrl = (assetsUrl?: string | URL): string | URL => {\n  return assetUrl('basemap.worker.js', undefined, assetsUrl);\n};\n\n/** Fetch priority of a raster tile drawn by the workers: 'high' near the center of the view, at the current zoom or\n * coarser; 'low' far from it or finer (prefetch); 'auto' between */\nexport const tilePriority = (z: number, x: number, y: number, camera: Pick<Camera, 'center' | 'zoom'>): Priority => {\n  // A raster tile of level z covers the map at zoom z - 1\n  if (z - 1 > camera.zoom + 1) return 'low';\n\n  const n = 2 ** z;\n  const [lon, lat] = camera.center;\n  const cx = mercatorX(lon) * n;\n  const cy = mercatorY(lat) * n;\n  // Across the antimeridian, the short way\n  const along = Math.abs(x + 0.5 - cx) % n;\n  const dx = Math.min(along, n - along);\n  const d = Math.hypot(dx, y + 0.5 - cy);\n\n  if (d <= 1.5) return 'high';\n\n  return d >= 4 ? 'low' : 'auto';\n};\n\n/** The worker of a vector tile among `count`: always the same one */\nexport const workerIndex = (vz: number, vx: number, vy: number, count: number): number => {\n  // Unsigned: every worker gets its share\n  return ((Math.imul(vx, 73856093) ^ Math.imul(vy, 19349663) ^ vz) >>> 0) % Math.max(1, count);\n};\n\n/** The worker-side key of a renderer: unique across the `VectorTiles` sharing a pool */\nexport const rendererKey = (namespace: string, n: number): string => {\n  return `${namespace}:r${n}`;\n};\n\n/** What the pool needs of a worker (a `Worker`, or a stand-in in tests) */\nexport type PoolWorker = Pick<Worker, 'postMessage' | 'terminate' | 'onmessage' | 'onerror' | 'onmessageerror'>;\n\n/**\n * @internal Workers drawing vector tiles, shared by the `VectorTiles` of a map: each vector tile always goes to the\n * same worker, which keeps it decoded for every style drawn from it. Requests are tracked one by one, with their\n * owner, so that one `VectorTiles` going away cancels its own requests only.\n */\nexport class BasemapWorkers {\n  private readonly workers: [PoolWorker, ...PoolWorker[]];\n  private readonly pending = new Map<\n    number,\n    { resolve: (r: BasemapResponse) => void; reject: (e: Error) => void; worker: PoolWorker; owner: object }\n  >();\n  private next = 1;\n  /** The workers that answered once (they loaded), and those that failed before: dead, their error given at once to\n   * any request still sent their way */\n  private readonly answered = new WeakSet<PoolWorker>();\n  private readonly dead = new Map<PoolWorker, Error>();\n  /** The worker the next file of grids goes to, in turn */\n  private turn = 0;\n  private namespaces = 0;\n  private terminated = false;\n  /** Stops following the page's request headers */\n  private readonly unfollow: () => void;\n\n  constructor(\n    readonly count: number,\n    readonly url: string | URL,\n    create: (url: string | URL) => PoolWorker = (u) => new Worker(u, { type: 'module' }),\n  ) {\n    const start = (): PoolWorker => {\n      const worker = create(url);\n\n      worker.onmessage = ({ data }: MessageEvent<BasemapResponse>) => {\n        this.answered.add(worker);\n\n        const p = this.pending.get(data.id);\n\n        if (!p) return;\n        this.pending.delete(data.id);\n        if ('error' in data) p.reject(new Error(data.error));\n        else p.resolve(data);\n      };\n      // A worker that fails to load (a bundler serving it from elsewhere) or to read a message fails its requests; one\n      // that never answered is dead: its tiles go to the others, and with none left every request fails at once\n      worker.onerror = (event) => {\n        event.preventDefault();\n\n        const error = this.fail(\n          worker,\n          `the vector basemap worker ${url} failed${event.message ? `: ${event.message}` : ''}`,\n        );\n\n        if (!this.answered.has(worker)) this.dead.set(worker, error);\n      };\n      worker.onmessageerror = () => this.fail(worker, `the vector basemap worker ${url} sent an unreadable message`);\n\n      const rules = headerRules();\n\n      if (rules.length > 0) worker.postMessage({ type: 'headers', rules } satisfies BasemapRequest);\n\n      return worker;\n    };\n\n    this.workers = [start(), ...Array.from({ length: Math.max(1, count) - 1 }, start)];\n    this.unfollow = onHeaderRules((rules) => {\n      this.workers.forEach((w) => {\n        w.postMessage({ type: 'headers', rules } satisfies BasemapRequest);\n      });\n    });\n  }\n\n  /** A prefix for the renderer keys of one `VectorTiles` */\n  namespace(): string {\n    return `v${this.namespaces++}`;\n  }\n\n  /** Requests in progress */\n  get size(): number {\n    return this.pending.size;\n  }\n\n  /** Rejects the requests of a failed worker, with the error returned */\n  private fail(worker: PoolWorker, message: string): Error {\n    const error = new Error(\n      `isard: ${message}. If a bundler moves the worker, give its URL in the \\`basemapWorkerUrl\\` option (see \"With a bundler\" in the guide)`,\n    );\n\n    this.pending.forEach((p, id) => {\n      if (p.worker !== worker) return;\n      this.pending.delete(id);\n      p.reject(error);\n    });\n\n    return error;\n  }\n\n  /** The worker of a vector tile: always the same one, or the next living one if it died */\n  worker(vz: number, vx: number, vy: number): PoolWorker {\n    return this.living(workerIndex(vz, vx, vy, this.workers.length));\n  }\n\n  /** The worker at `index`, or the next one that has not died (the first one when all have) */\n  private living(index: number): PoolWorker {\n    const { workers } = this;\n    const at = (k: number) => workers[(index + k) % workers.length] ?? workers[0];\n    const k = workers.findIndex((_, k) => !this.dead.has(at(k)));\n\n    return at(Math.max(0, k));\n  }\n\n  /** Sends a message to every worker (a renderer, or its removal, or where the tessellation module is) */\n  broadcast(message: Extract<BasemapRequest, { type: 'init' } | { type: 'drop' } | { type: 'tess' }>): void {\n    if (this.terminated) return;\n\n    // A renderer tells the workers how many they are: they share the decoded tiles' budget\n    const sent = message.type === 'init' ? { ...message, workers: this.workers.length } : message;\n\n    // A sprite image is copied to each worker (structured clone)\n    this.workers.forEach((w) => {\n      w.postMessage(sent);\n    });\n  }\n\n  /** Asks a worker for a tile's image or labels, on behalf of `owner` */\n  request(worker: PoolWorker, work: BasemapWork, owner: object, signal?: AbortSignal): Promise<BasemapResponse> {\n    return new Promise<BasemapResponse>((resolve, reject) => {\n      if (this.terminated) return reject(new DOMException('isard: vector tiles destroyed', 'AbortError'));\n      if (signal?.aborted) return reject(new DOMException('isard: aborted', 'AbortError'));\n\n      const dead = this.dead.get(worker);\n\n      if (dead) return reject(dead);\n\n      const id = this.next++;\n      const abort = () => {\n        if (!this.pending.delete(id)) return;\n        worker.postMessage({ type: 'abort', id } satisfies BasemapRequest);\n        reject(new DOMException('isard: aborted', 'AbortError'));\n      };\n      // The listener goes once the request is settled\n      const settle = () => signal?.removeEventListener('abort', abort);\n\n      this.pending.set(id, {\n        resolve: (r) => {\n          settle();\n          resolve(r);\n        },\n        reject: (e) => {\n          settle();\n          reject(e);\n        },\n        worker,\n        owner,\n      });\n      signal?.addEventListener('abort', abort, { once: true });\n      worker.postMessage({ ...work, id } satisfies BasemapRequest);\n    });\n  }\n\n  /** The altitudes of a PNG relief tile `z`/`x`/`y` at `url`, decoded by a worker (see `fetchHeights`) */\n  heights(\n    url: string,\n    encoding: PngEncoding,\n    floor: number | undefined,\n    [z, x, y]: [number, number, number],\n    signal: AbortSignal,\n    owner: object,\n  ): Promise<Float32Array | null> {\n    const work: BasemapWork = { type: 'heights', url, encoding, ...(floor === undefined ? {} : { floor }) };\n\n    return this.request(this.worker(z, x, y), work, owner, signal).then((r) => ('heights' in r ? r.heights : null));\n  }\n\n  /** Mercator tile `z`/`x`/`y` reprojected by a worker from the source images of its plan (see `resampler`) */\n  reproject(\n    job: Job,\n    [z, x, y]: [number, number, number],\n    signal: AbortSignal,\n    owner: object,\n  ): Promise<ImageBitmap | null> {\n    // Blocks of 4 × 4 Mercator tiles go to the same worker: neighbours share source tiles, each worker keeps its share\n    const worker = this.worker(Math.max(0, z - 2), x >> 2, y >> 2);\n    const cached = Math.max(16, Math.ceil(SOURCE_CACHE / this.workers.length));\n    const work: BasemapWork = { type: 'reproject', job, cached };\n\n    return this.request(worker, work, owner, signal).then((r) => ('image' in r ? r.image : null));\n  }\n\n  /** A GRIB2 or NetCDF file (its URL, fetched by the worker, or its bytes, transferred) read into grids by the grid\n   * module (`module`), in the next worker */\n  grids(\n    source: { url: string } | { bytes: ArrayBuffer },\n    module: string,\n    signal: AbortSignal | undefined,\n    owner: object,\n  ): Promise<{ grids: GridDescription[]; values: Float32Array[] }> {\n    const work: BasemapWork = { type: 'grids', module, ...source };\n\n    this.turn = (this.turn + 1) % this.workers.length;\n\n    return this.request(this.living(this.turn), work, owner, signal).then((r) =>\n      'grids' in r ? { grids: r.grids, values: r.values } : { grids: [], values: [] },\n    );\n  }\n\n  /** Cancels the requests of an owner (the workers stop them) */\n  cancel(owner: object): void {\n    this.pending.forEach((p, id) => {\n      if (p.owner !== owner) return;\n      this.pending.delete(id);\n      p.worker.postMessage({ type: 'abort', id } satisfies BasemapRequest);\n      p.reject(new DOMException('isard: vector tiles destroyed', 'AbortError'));\n    });\n  }\n\n  /** Stops the workers; their requests fail */\n  terminate(): void {\n    if (this.terminated) return;\n    this.terminated = true;\n    this.unfollow();\n    this.workers.forEach((w) => {\n      w.terminate();\n    });\n\n    const pending = [...this.pending.values()];\n\n    this.pending.clear();\n    pending.forEach((p) => {\n      p.reject(new DOMException('isard: vector tiles destroyed', 'AbortError'));\n    });\n  }\n}\n"]}