isard 1.1.0 → 1.3.0

package/dist/wasm/isard.d.ts

@@ -266,10 +266,19 @@ export interface PickResult {
 
 
 
+/**
+ * A map on one canvas: its WebGL2 context, camera, ground (raster layers over the relief) and the layers over it.
+ * Draws only when `render` is called (the JavaScript side calls it after `redraw` asks for a frame)
+ */
 export class Engine {
     free(): void;
     /**
      * Circle layer of `feature_count` features: points (Mercator [0, 1], interleaved) and the feature of each
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object cannot be created or a shader fails to compile (the error carries its
+     * info log), or when `feature_count` features need a table texture past the GPU's `MAX_TEXTURE_SIZE`
      */
     addCircles(points: Float64Array, feature: Uint32Array, feature_count: number): number;
     /**
@@ -280,29 +289,53 @@ export class Engine {
     addCustomLayer(render: () => void, depth: boolean): number;
     /**
      * An empty extrusion layer: its blocks come in batches (`setExtrusionBatch`)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object cannot be created or a shader fails to compile (the error carries its
+     * info log)
      */
     addExtrusions(): number;
     /**
      * Fill layer of `feature_count` features: polygons given by their points (Mercator [0, 1], interleaved), the first
      * point of each ring (`ring_start`, one more entry than rings), the first ring of each polygon (`polygon_start`,
      * one more entry than polygons; the first ring is the outer one, the others holes) and the feature of each polygon
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object cannot be created or a shader fails to compile (the error carries its
+     * info log), or when `feature_count` features need a table texture past the GPU's `MAX_TEXTURE_SIZE`
      */
     addFills(points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, feature: Uint32Array, feature_count: number): number;
     /**
      * Ground layer running `code` (GLSL ES 3.0 defining `vec4 ground(vec2 offset)`, see `render::ground`) over the
      * ground; `anchor`: Mercator point the offsets are taken from; bounds: Mercator box it shows in. Compilation errors
      * come back with the shader's info log (line numbers of `code`)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when `code` does not compile or link, with the shader's info log
      */
     addGround(code: string, anchor_x: number, anchor_y: number, min_x: number, min_y: number, max_x: number, max_y: number): number;
     /**
      * Line layer of `feature_count` features: polylines given by their points (Mercator [0, 1], interleaved), the
      * first point of each (`start`, one more entry than lines) and the feature each one belongs to
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object cannot be created or a shader fails to compile (the error carries its
+     * info log), or when the features or the lines need a table texture past the GPU's `MAX_TEXTURE_SIZE`
      */
     addLines(points: Float64Array, start: Uint32Array, feature: Uint32Array, feature_count: number): number;
     /**
      * A glTF / GLB model (its URL, a `blob:` one for data of the page) drawn at each instance of `instances`
      * (`INSTANCE_NUMBERS` numbers each: longitude, latitude, altitude, heading, pitch, roll in degrees, scale);
      * `ground`: altitudes above the relief, else above the ellipsoid
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object cannot be created or a shader fails to compile (the error carries its
+     * info log). A model that fails to load or decode does not throw: the layer stays empty
      */
     addModels(url: string, instances: Float64Array, ground: boolean): number;
     /**
@@ -311,40 +344,80 @@ export class Engine {
      * edges (node index pairs, interleaved). `line_start` and `line_points`: the line of each edge from A to B, points
      * `line_start[e] .. line_start[e + 1]` of `line_points` (Mercator, interleaved; straight if fewer than two). `costs`: per edge, the
      * cost of travelling it from A to B then from B to A; without, values are interpolated along the edges.
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when `style` is not 25 numbers, `edges` is not node pairs or names a node past
+     * those of `mercator`, the nodes or edges need a table texture past the GPU's `MAX_TEXTURE_SIZE`, or when
+     * a WebGL object cannot be created or a shader fails to compile (the error carries its info log)
      */
     addNetwork(mercator: Float64Array, edges: Uint32Array, line_start: Uint32Array | null | undefined, line_points: Float64Array | null | undefined, costs: Float32Array | null | undefined, style: Float32Array): number;
     /**
      * A COPC point cloud from its URL (HTTP range requests). `resolve(wkt)` gives the CRS of the file from its WKT
      * (undefined if it has none): its inverse projection, whether its altitudes are above the geoid, the metres of
      * a unit of z; it may throw (an unknown CRS), the layer then stays empty
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object cannot be created or a shader fails to compile (the error carries its
+     * info log). The file itself is read later: a bad file, or a `resolve` that throws, leaves the layer empty
      */
     addPointCloud(url: string, resolve: (wkt: string | undefined) => PointCloudCrs): number;
     /**
      * Raster tiles in Web Mercator; `url` holds {z}, {x} and {y}. `size`: side of the tiles' textures (256 by
      * default); `loader`: draws each tile instead of fetching `url`, `(z, x, y, signal) => Promise<ImageBitmap |
      * null>`, an image of `size` × `size` (null: nothing there)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when the texture holding the layer's tiles cannot be created
      */
     addRaster(url: string, min_z: number, max_z: number, opacity: number, saturation: number, size: number | null | undefined, loader: ((z: number, x: number, y: number, signal: AbortSignal) => Promise<ImageBitmap | null>) | undefined): number;
     /**
      * An empty symbol layer
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object cannot be created or a shader fails to compile (the error carries its
+     * info log)
      */
     addSymbols(): number;
     /**
      * 3D Tiles (b3dm / glb textured meshes, external tilesets) from the URL of a `tileset.json`. `max_error`:
      * screen-space error (CSS pixels) above which a tile is refined; 16 is the usual value, lower is finer.
      * `geoid`: its heights are altitudes (NGF-IGN69), each tile raised by the RAF20 geoid onto the relief.
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when one of the layer's programs fails to compile or link (the error carries
+     * its info log). The tileset itself is read later: a bad one leaves the layer empty, it does not throw
      */
     addTiles3d(url: string, max_error: number, geoid?: boolean | null): number;
+    /**
+     * An empty layer of vector tiles drawn as geometry: its style layers come with `setVectorSublayers`, its tiles
+     * with `setVectorTile`
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a shader fails to compile (the error carries its info log)
+     */
+    addVectorTiles(): number;
     /**
      * Longitudes and latitudes the view covers on the ground, `[west, south, east, north]` (degrees): the screen's
      * border cast on the ground, or on the far plane where it passes the horizon
      */
     bounds(): Float64Array;
+    /**
+     * The camera as set or moved: center (degrees), zoom, pitch and bearing (degrees)
+     */
     camera(): Camera;
     /**
      * Removes the panorama
      */
     clearPanorama(): void;
+    /**
+     * Stops loading the tiles of the flight's destination (`preload`)
+     */
     clearPreload(): void;
     /**
      * Removes the viewshed
@@ -392,6 +465,11 @@ export class Engine {
     networkStats(id: number): NetworkStats | undefined;
     /**
      * `redraw` is called when the engine needs a new frame (a tile arrived)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when the canvas gives no WebGL2 context ("WebGL2 is not available"), or when a WebGL
+     * object of the globe, the sky or the raster pass cannot be created or one of their shaders fails to compile
      */
     constructor(canvas: HTMLCanvasElement, redraw: () => void);
     /**
@@ -433,8 +511,22 @@ export class Engine {
      * Screen point (CSS pixels) of a ground position, or `height` metres above it, undefined behind the camera
      */
     project(lon: number, lat: number, height?: number | null): [x: number, y: number] | undefined;
+    /**
+     * Removes batch `key` of an extrusion layer (nothing if there is none)
+     */
     removeExtrusionBatch(id: number, key: number): void;
+    /**
+     * Removes a layer and frees its GPU objects; the other layers forget it (a layer that referred to it)
+     */
     removeLayer(id: number): void;
+    /**
+     * Removes tile `key` of a vector tile layer (nothing if there is none)
+     */
+    removeVectorTile(id: number, key: number): void;
+    /**
+     * Draws a frame: the backdrop, the ground and the layers over it bottom to top, then the panorama and the
+     * viewshed; returns true while tiles are still loading (a new frame will be asked through `redraw`)
+     */
     render(): boolean;
     /**
      * Asks what is under a screen point without waiting for the GPU (as `pick`, with the position there): the
@@ -455,6 +547,9 @@ export class Engine {
      * then the sky-horizon, horizon-fog and fog-ground blends; `undefined` for none (the background color shows)
      */
     setAtmosphere(settings?: Float32Array | null): void;
+    /**
+     * Color the canvas is cleared to (RGB 0-1), where neither ground nor sky is drawn
+     */
     setBackground(r: number, g: number, b: number): void;
     /**
      * The body the map is drawn on: its equatorial radius (metres) and flattening (0 for a sphere), the halo of its
@@ -464,6 +559,10 @@ export class Engine {
      * relief, whose shaders may take its size (`ISARD_CIRCUMFERENCE` of the ground layers)
      */
     setBody(radius: number, flattening: number, halo: Float32Array | null | undefined, lowest: number, highest: number): void;
+    /**
+     * Sets the camera (degrees, the conventions of `MapLibre`): leaves a street-level view, and the camera keeps this
+     * center as the relief comes in
+     */
     setCamera(lon: number, lat: number, zoom: number, pitch: number, bearing: number): void;
     /**
      * Circles lying on the ground (true) or facing the screen
@@ -475,11 +574,21 @@ export class Engine {
     setCircles(id: number, points: Float64Array, feature: Uint32Array): void;
     /**
      * Anchors of batch `key` on the linked network: per feature, node A, node B, cost from A, cost from B
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when the batch's features need an anchor texture past the GPU's
+     * `MAX_TEXTURE_SIZE`, or when it cannot be created
      */
     setExtrusionAnchors(id: number, key: number, anchors: Float32Array): void;
     /**
      * Adds or replaces batch `key` of an extrusion layer: polygons as for `addFills`, `feature_count` features (the
      * feature style gives each its height and base height as its two sizes, metres)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL buffer or vertex array of the batch cannot be created, or when
+     * `feature_count` features need a table texture past the GPU's `MAX_TEXTURE_SIZE`
      */
     setExtrusionBatch(id: number, key: number, points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, feature: Uint32Array, feature_count: number): void;
     /**
@@ -496,10 +605,10 @@ export class Engine {
      */
     setFeatureRamp(id: number, rgba: Uint8Array | null | undefined, min: number, max: number): void;
     /**
-     * Style of the features of a line, circle, fill or extrusion layer (batch `key` of the latter): 32 floats per
-     * feature, its color (RGBA 0-1), its second color (a circle's stroke), then two sizes as zoom stops (four zooms,
-     * four values each): a line's width; a circle's radius and stroke width, CSS pixels; a block's height and base
-     * height, metres
+     * Style of the features of a line, circle, fill, extrusion or vector tile layer (batch or tile `key` of the last
+     * two): 32 floats per feature, its color (RGBA 0-1), its second color (a circle's stroke), then two sizes as zoom
+     * stops (four zooms, four values each): a line's width; a circle's radius and stroke width, CSS pixels; a block's
+     * height and base height, metres
      */
     setFeatureStyle(id: number, style: Float32Array, key?: number | null): void;
     /**
@@ -527,29 +636,59 @@ export class Engine {
     /**
      * The glyph atlas shared by the symbol layers, one page: `width` × `height` bytes of signed distances
      * (allocated again, filled with `data` if given)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) as `setGlyphPages` does: a size that is not positive, or the texture not created
      */
     setGlyphAtlas(width: number, height: number, data?: Uint8Array | null): void;
     /**
      * The glyph atlas shared by the symbol layers, `pages` pages of `width` × `height` bytes of signed distances,
      * allocated again and empty (`updateGlyphPage` fills them). A glyph on page `p` at row `v` has the atlas
      * coordinate `v + p × height`
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when `width` or `height` is not positive (or their product overflows), `pages`
+     * is not 1 to 256, or the atlas texture cannot be created
      */
     setGlyphPages(width: number, height: number, pages: number): void;
+    /**
+     * Moves the Mercator box (0-1) a ground layer shows in
+     */
     setGroundBounds(id: number, min_x: number, min_y: number, max_x: number, max_y: number): void;
     /**
      * Creates the texture of sampler `name` (`format`: r8, r8ui, r16ui, r16i, r32ui, r32f, rg16ui, rg32f, rgba8,
      * rgba8ui, rgba16ui, rgba32f; `depth` 0 for 2D, else a 2D array of that many layers; `linear` filtering for the
      * non-integer formats); `data`: its texels as bytes, or undefined for an empty texture
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) on an unknown `format`, a size not positive (or overflowing), `data` shorter
+     * than the texels, more textures than the layer takes, or a texture WebGL cannot create
      */
     setGroundTexture(id: number, name: string, format: string, width: number, height: number, depth: number, linear: boolean, data?: Uint8Array | null): void;
     /**
      * A uniform of a ground layer's code, as numbers
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when the shader has no uniform `name` (one its code does not use is removed
+     * by the compiler)
      */
     setGroundUniform(id: number, name: string, values: Float64Array): void;
+    /**
+     * Shows or hides a ground layer (kept, with its uniforms and textures)
+     */
     setGroundVisible(id: number, visible: boolean): void;
     /**
      * The icon atlas shared by the symbol layers: `width` × `height` RGBA texels, premultiplied, allocated again
      * and empty (`updateIconAtlas` fills it)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when `width` or `height` is not positive (or their product overflows), or the
+     * atlas texture cannot be created
      */
     setIconAtlas(width: number, height: number): void;
     /**
@@ -563,6 +702,11 @@ export class Engine {
     setLineDash(id: number, dash: number, gap: number): void;
     /**
      * New lines for a line layer (same arguments as `addLines`, the same features)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when the lines need a table texture past the GPU's `MAX_TEXTURE_SIZE`, or
+     * when it cannot be created; the layer then keeps its lines
      */
     setLines(id: number, points: Float64Array, start: Uint32Array, feature: Uint32Array): void;
     /**
@@ -597,6 +741,10 @@ export class Engine {
     setNetworkValues(id: number, values: Float32Array): void;
     /**
      * The image of camera `index` of the panorama (the images sharing the size of the first)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when WebGL refuses the upload of `image` into the panorama's texture
      */
     setPanoramaImage(index: number, image: ImageBitmap): void;
     /**
@@ -605,6 +753,11 @@ export class Engine {
      * frame, row-major, 9; position in it, 3; focal x, y; center x, y; skew; image width, height; principal point of
      * the distortion x, y; its coefficients r³, r⁵, r⁷; its limit, pixels), a backdrop sphere of `radius` metres, at
      * `opacity`. Its images come after (`setPanoramaImage`)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when `rotation` holds fewer than 9 numbers, or when a WebGL object cannot be created or a
+     * shader fails to compile (the error carries its info log)
      */
     setPanorama(lon: number, lat: number, height: number, rotation: Float64Array, cameras: Float64Array, radius: number, opacity: number): void;
     /**
@@ -612,6 +765,9 @@ export class Engine {
      * alpha 0 hides a class) and the ramp of the altitudes (256 RGBA texels)
      */
     setPointCloudStyle(id: number, style: Float64Array, palette: Uint8Array, ramp: Uint8Array): void;
+    /**
+     * Opacity and saturation (0-1) of a raster layer; nothing for another id
+     */
     setRasterStyle(id: number, opacity: number, saturation: number): void;
     /**
      * The headers added to the engine's requests by URL prefix (`setRequestHeaders`, the same for every map of the
@@ -622,11 +778,22 @@ export class Engine {
      * Space behind the globe (stars, atmosphere halo), in the globe projection
      */
     setSky(enabled: boolean): void;
+    /**
+     * The sun casting shadows and the night: its azimuth (degrees clockwise from north) and altitude (degrees above
+     * the horizon), the shadows' opacity (0 to 1; none under the horizon or not a number), how dark the night is (0 to
+     * 1: the frame tinted, the lights of the layers on). Neither shadows nor night: nothing drawn
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object cannot be created or the pass fails to compile
+     */
+    setSun(azimuth: number, altitude: number, opacity: number, night: number): void;
     /**
      * Shows `layers` on one side of a vertical line only, the others beneath on the other side (comparing two states
-     * of a place): left of `x` (CSS pixels from the left of the canvas), or right of it; a non-finite `x` stops
+     * of a place): left of `x` (CSS pixels from the left of the canvas), or right of it; `others` on the other side
+     * only (two meshes of the same place, each on its side, never drawn over each other); a non-finite `x` stops
      */
-    setSwipe(x: number, right: boolean, layers: Uint32Array): void;
+    setSwipe(x: number, right: boolean, layers: Uint32Array, others: Uint32Array): void;
     /**
      * Layer-wide style of a symbol layer: size scale and opacity as zoom stops (four zooms then four values each),
      * zoom range, visibility
@@ -636,6 +803,11 @@ export class Engine {
      * Labels of a symbol layer, shaped by the page: anchors (Mercator, interleaved), their texts' boxes (min x, min y,
      * max x, max y, CSS pixels from the anchor), styles (36 floats each, see `LABEL_FLOATS`) and glyph and icon quads
      * (11 floats each, see `QUAD_FLOATS`)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when the labels need a table texture past the GPU's `MAX_TEXTURE_SIZE`, or
+     * when it cannot be created; the layer then keeps its labels
      */
     setSymbols(id: number, anchors: Float64Array, boxes: Float32Array, styles: Float32Array, quads: Float32Array): void;
     /**
@@ -647,6 +819,10 @@ export class Engine {
      * above the ellipsoid, those of 3D Tiles; over France, on the Earth only), else left as served (the default);
      * `loader`: gives the
      * altitudes of each tile instead of fetching `url` (an encoding decoded by the page: Terrarium, Terrain-RGB)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when the texture holding the relief's tiles cannot be created
      */
     setTerrain(url: string | null | undefined, exaggeration: number, max_z: number | null | undefined, geoid: boolean | null | undefined, loader: ((z: number, x: number, y: number, signal: AbortSignal) => Promise<Float32Array | null>) | undefined): void;
     /**
@@ -660,14 +836,60 @@ export class Engine {
      * for none: it tints the textures and colors the untextured meshes) of a 3D Tiles layer
      */
     setTiles3dStyle(id: number, max_error: number, opacity: number, point_size: number | null | undefined, color: Float32Array): void;
+    /**
+     * The style layers of a vector tile layer, in drawing order: per layer, its kind (0 fill, 1 line, 2 extrusion), its zoom range
+     * (two numbers: shown from the first, included, to the second, excluded), whether it shows (0 or 1), its dashes
+     * (four numbers: dash, gap, dash, gap, in line widths; 0: solid), its opacity as zoom stops (four zooms then four
+     * values; missing: opaque), the caps of its lines' ends (0 butt, 1 round, 2 square; missing: round), whether its
+     * lines glow at night (streets; 0 or 1)
+     */
+    setVectorSublayers(id: number, kinds: Uint8Array, zooms: Float64Array, visible: Uint8Array, dashes: Float32Array, opacities: Float32Array, caps: Uint8Array, lit: Uint8Array): void;
+    /**
+     * Adds or replaces tile `key` of a vector tile layer ready for the GPU, as the basemap workers make it (the
+     * tessellation module): its polygons as for `setVectorTile` (picked here; their prisms built here if drawn in
+     * relief while `prism` is false), the vertices of its fills (`shapes::Vertex` as bytes, each with its feature),
+     * their triangles, per sublayer its top cap and the rest of its prism (`fill_ranges`: four numbers, first and
+     * end of each), its line pieces (`pieces::Piece` as bytes), the line table (feature and length of each line),
+     * per sublayer its pieces (`line_ranges`: first, end), the blocks of its extrusion sublayers (`shapes::Block` as
+     * bytes), their triangles, per sublayer its blocks' triangles (`block_ranges`: first, end), the extent of its
+     * points (`bounds`: min x, min y, max x, max y), `feature_count` features
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when the vertices, pieces or blocks are cut short, when a WebGL object of the tile cannot be
+     * created, or when its features or lines need a table texture past the GPU's `MAX_TEXTURE_SIZE`
+     */
+    setVectorTileMesh(id: number, key: number, points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, polygon_feature: Uint32Array, fill_start: Uint32Array, vertices: Uint8Array, indices: Uint32Array, fill_ranges: Uint32Array, prism: boolean, pieces: Uint8Array, line_table: Float32Array, line_ranges: Uint32Array, blocks: Uint8Array, block_indices: Uint32Array, block_ranges: Uint32Array, bounds: Float64Array, feature_count: number): void;
+    /**
+     * Adds or replaces tile `key` of a vector tile layer: its polygons as for `addFills` (`fill_start`: the first
+     * polygon of each sublayer, and the end; those of an extrusion sublayer raised into blocks), its lines as for
+     * `addLines` (`line_start`: the first line of each sublayer, and the end), `feature_count` features, styled as an
+     * extrusion layer's (`setFeatureStyle` with the key: a color, then a line's width or a block's height and base);
+     * `tile`: the corners of the tile they are cut to (west, north, east, south; empty: none), along whose edges no
+     * wall of a block rises
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object of the tile cannot be created, or when its features or lines need a
+     * table texture past the GPU's `MAX_TEXTURE_SIZE`
+     */
+    setVectorTile(id: number, key: number, points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, polygon_feature: Uint32Array, fill_start: Uint32Array, line_points: Float64Array, line_first: Uint32Array, line_feature: Uint32Array, line_start: Uint32Array, feature_count: number, tile: Float64Array): void;
     /**
      * Shows what can be seen from points, each within its range: `observers` holds 8 numbers per observer
      * (16 at most): longitude, latitude (degrees), metres above the ground, range (metres), then to look one way
      * only heading, tilt, angles of view across and up (degrees), the heading NaN to look all around. What some
      * observer sees is tinted with `visible`, what is hidden from all those that reach it with `hidden` (RGB 0-1),
      * at `opacity`; `outline` (RGB 0-1, or empty) the color of the cones' edges drawn in 3D
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when, on the first call, a WebGL object cannot be created or a shader fails to compile
+     * (the error carries its info log)
      */
     setViewshed(observers: Float64Array, visible: Float32Array, hidden: Float32Array, opacity: number, outline: Float32Array): void;
+    /**
+     * Lowest and highest zoom levels the camera accepts
+     */
     setZoomRange(min: number, max: number): void;
     /**
      * Tile counters of the raster layers, for diagnostics
@@ -709,17 +931,31 @@ export class Engine {
     updateGlyphPage(page: number, x: number, y: number, width: number, height: number, data: Uint8Array): void;
     /**
      * Replaces a region of a ground layer's texture (one layer of a 2D array)
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when there is no texture `name`, or when the region is out of its bounds or
+     * `data` holds too few bytes
      */
     updateGroundTexture(id: number, name: string, x: number, y: number, layer: number, width: number, height: number, data: Uint8Array): void;
     /**
      * A region of the icon atlas: `width` × `height` RGBA texels (premultiplied) at (`x`, `y`)
      */
     updateIconAtlas(x: number, y: number, width: number, height: number, data: Uint8Array): void;
+    /**
+     * Vector tiles (512 CSS pixels across at their level, as `MapLibre`'s) for the view of the last frame (else the
+     * camera's), levels `min_z` to `max_z`, three numbers per tile (z, x, y), the nearest to the eye first: what a
+     * vector tile layer draws (`addVectorTiles`), coarser far away in a tilted view as the raster layers
+     */
+    vectorTilesInView(min_z: number, max_z: number): Uint32Array;
     /**
      * Tiles a raster layer wants for the view of the last frame, three numbers per tile (z, x, y), the nearest to
      * the eye first: the level each area of the ground is drawn at, for the labels of a vector style to follow it
      */
     wantedTiles(id: number): Uint32Array;
+    /**
+     * Zooms by `delta` levels around a screen point (CSS pixels), which keeps the same ground point under it
+     */
     zoomAt(delta: number, x: number, y: number): void;
 }
 
@@ -756,6 +992,7 @@ export interface InitOutput {
     readonly engine_addRaster: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];
     readonly engine_addSymbols: (a: number) => [number, number, number];
     readonly engine_addTiles3d: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly engine_addVectorTiles: (a: number) => [number, number, number];
     readonly engine_bounds: (a: number) => [number, number];
     readonly engine_camera: (a: number) => any;
     readonly engine_clearPanorama: (a: number) => void;
@@ -780,6 +1017,7 @@ export interface InitOutput {
     readonly engine_project: (a: number, b: number, c: number, d: number, e: number) => any;
     readonly engine_removeExtrusionBatch: (a: number, b: number, c: number) => void;
     readonly engine_removeLayer: (a: number, b: number) => void;
+    readonly engine_removeVectorTile: (a: number, b: number, c: number) => void;
     readonly engine_render: (a: number) => number;
     readonly engine_requestPick: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
     readonly engine_resize: (a: number, b: number, c: number, d: number) => void;
@@ -824,12 +1062,16 @@ export interface InitOutput {
     readonly engine_setRasterStyle: (a: number, b: number, c: number, d: number) => void;
     readonly engine_setRequestHeaders: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly engine_setSky: (a: number, b: number) => void;
-    readonly engine_setSwipe: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly engine_setSun: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly engine_setSwipe: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly engine_setSymbolLayer: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
     readonly engine_setSymbols: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
     readonly engine_setTerrain: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
     readonly engine_setTileLoader: (a: number, b: any) => void;
     readonly engine_setTiles3dStyle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly engine_setVectorSublayers: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number) => void;
+    readonly engine_setVectorTile: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number) => [number, number];
+    readonly engine_setVectorTileMesh: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number, c1: number, d1: number, e1: number, f1: number, g1: number, h1: number, i1: number) => [number, number];
     readonly engine_setViewshed: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
     readonly engine_setZoomRange: (a: number, b: number, c: number) => void;
     readonly engine_stats: (a: number) => any;
@@ -842,6 +1084,7 @@ export interface InitOutput {
     readonly engine_updateGlyphPage: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
     readonly engine_updateGroundTexture: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => [number, number];
     readonly engine_updateIconAtlas: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly engine_vectorTilesInView: (a: number, b: number, c: number) => [number, number];
     readonly engine_wantedTiles: (a: number, b: number) => [number, number];
     readonly engine_zoomAt: (a: number, b: number, c: number, d: number) => void;
     readonly wasm_bindgen_2e566c63402fe7fa___convert__closures_____invoke___js_sys_b1e1c29ba6b0e6b3___Function_fn_wasm_bindgen_2e566c63402fe7fa___JsValue_____wasm_bindgen_2e566c63402fe7fa___sys__Undefined___js_sys_b1e1c29ba6b0e6b3___Function_fn_wasm_bindgen_2e566c63402fe7fa___JsValue_____wasm_bindgen_2e566c63402fe7fa___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;