@reearth/ezu 0.7.0 → 0.8.0

package/bundler/ezu.d.ts

@@ -111,6 +111,16 @@ export class Renderer {
      * Drop every pending source binding. Call between tile renders.
      */
     clearSources(): void;
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     */
+    legend(zoom?: number | null): any;
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -220,6 +230,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      */
     requestedNeighborOffsets(name: string): Array<any>;
@@ -253,6 +268,23 @@ export class Renderer {
      * the intermediate cache and drops any pending source bindings.
      */
     setStyle(style_json: string): number;
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     */
+    sourceTile(name: string, z: number, x: number, y: number): any;
     /**
      * Effective attribution declared by the style (document +
      * sources), joined with ` | `. Upstream TileJSON / PMTiles

package/bundler/ezu_bg.js

@@ -197,6 +197,24 @@ export class Renderer {
     clearSources() {
         wasm.renderer_clearSources(this.__wbg_ptr);
     }
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     * @param {number | null} [zoom]
+     * @returns {any}
+     */
+    legend(zoom) {
+        const ret = wasm.renderer_legend(this.__wbg_ptr, isLikeNone(zoom) ? 0xFFFFFF : zoom);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -367,6 +385,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      * @param {string} name
      * @returns {Array<any>}
@@ -423,6 +446,36 @@ export class Renderer {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     * @param {string} name
+     * @param {number} z
+     * @param {number} x
+     * @param {number} y
+     * @returns {any}
+     */
+    sourceTile(name, z, x, y) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.renderer_sourceTile(this.__wbg_ptr, ptr0, len0, z, x, y);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * `tile-size` declared by the current style.
      * @returns {number}

package/bundler/ezu_bg.wasm.d.ts

@@ -16,6 +16,7 @@ export const renderer_attribution: (a: number) => [number, number];
 export const renderer_bindSource: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
 export const renderer_boundSources: (a: number) => [number, number];
 export const renderer_clearSources: (a: number) => void;
+export const renderer_legend: (a: number, b: number) => [number, number, number];
 export const renderer_memoryUsage: (a: number) => [number, number, number];
 export const renderer_neededCodepoints: (a: number) => [number, number, number];
 export const renderer_neededGlyphRanges: (a: number) => [number, number, number];
@@ -25,6 +26,7 @@ export const renderer_renderTile: (a: number, b: number, c: number, d: number, e
 export const renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
 export const renderer_setGlyphBudget: (a: number, b: number) => void;
 export const renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+export const renderer_sourceTile: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
 export const renderer_tileSize: (a: number) => number;
 export const simdEnabled: () => number;
 export const threadsEnabled: () => number;

package/nodejs/ezu.d.ts

@@ -111,6 +111,16 @@ export class Renderer {
      * Drop every pending source binding. Call between tile renders.
      */
     clearSources(): void;
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     */
+    legend(zoom?: number | null): any;
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -220,6 +230,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      */
     requestedNeighborOffsets(name: string): Array<any>;
@@ -253,6 +268,23 @@ export class Renderer {
      * the intermediate cache and drops any pending source bindings.
      */
     setStyle(style_json: string): number;
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     */
+    sourceTile(name: string, z: number, x: number, y: number): any;
     /**
      * Effective attribution declared by the style (document +
      * sources), joined with ` | `. Upstream TileJSON / PMTiles

package/nodejs/ezu.js

@@ -200,6 +200,24 @@ class Renderer {
     clearSources() {
         wasm.renderer_clearSources(this.__wbg_ptr);
     }
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     * @param {number | null} [zoom]
+     * @returns {any}
+     */
+    legend(zoom) {
+        const ret = wasm.renderer_legend(this.__wbg_ptr, isLikeNone(zoom) ? 0xFFFFFF : zoom);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -370,6 +388,11 @@ class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      * @param {string} name
      * @returns {Array<any>}
@@ -426,6 +449,36 @@ class Renderer {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     * @param {string} name
+     * @param {number} z
+     * @param {number} x
+     * @param {number} y
+     * @returns {any}
+     */
+    sourceTile(name, z, x, y) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.renderer_sourceTile(this.__wbg_ptr, ptr0, len0, z, x, y);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * `tile-size` declared by the current style.
      * @returns {number}

package/nodejs/ezu_bg.wasm.d.ts

@@ -16,6 +16,7 @@ export const renderer_attribution: (a: number) => [number, number];
 export const renderer_bindSource: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
 export const renderer_boundSources: (a: number) => [number, number];
 export const renderer_clearSources: (a: number) => void;
+export const renderer_legend: (a: number, b: number) => [number, number, number];
 export const renderer_memoryUsage: (a: number) => [number, number, number];
 export const renderer_neededCodepoints: (a: number) => [number, number, number];
 export const renderer_neededGlyphRanges: (a: number) => [number, number, number];
@@ -25,6 +26,7 @@ export const renderer_renderTile: (a: number, b: number, c: number, d: number, e
 export const renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
 export const renderer_setGlyphBudget: (a: number, b: number) => void;
 export const renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+export const renderer_sourceTile: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
 export const renderer_tileSize: (a: number) => number;
 export const simdEnabled: () => number;
 export const threadsEnabled: () => number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reearth/ezu",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Painterly map renderer — WebAssembly bindings",
   "license": "MIT OR Apache-2.0",
   "repository": {

package/simd/bundler/ezu.d.ts

@@ -111,6 +111,16 @@ export class Renderer {
      * Drop every pending source binding. Call between tile renders.
      */
     clearSources(): void;
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     */
+    legend(zoom?: number | null): any;
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -220,6 +230,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      */
     requestedNeighborOffsets(name: string): Array<any>;
@@ -253,6 +268,23 @@ export class Renderer {
      * the intermediate cache and drops any pending source bindings.
      */
     setStyle(style_json: string): number;
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     */
+    sourceTile(name: string, z: number, x: number, y: number): any;
     /**
      * Effective attribution declared by the style (document +
      * sources), joined with ` | `. Upstream TileJSON / PMTiles

package/simd/bundler/ezu_bg.js

@@ -197,6 +197,24 @@ export class Renderer {
     clearSources() {
         wasm.renderer_clearSources(this.__wbg_ptr);
     }
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     * @param {number | null} [zoom]
+     * @returns {any}
+     */
+    legend(zoom) {
+        const ret = wasm.renderer_legend(this.__wbg_ptr, isLikeNone(zoom) ? 0xFFFFFF : zoom);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -367,6 +385,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      * @param {string} name
      * @returns {Array<any>}
@@ -423,6 +446,36 @@ export class Renderer {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     * @param {string} name
+     * @param {number} z
+     * @param {number} x
+     * @param {number} y
+     * @returns {any}
+     */
+    sourceTile(name, z, x, y) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.renderer_sourceTile(this.__wbg_ptr, ptr0, len0, z, x, y);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * `tile-size` declared by the current style.
      * @returns {number}

package/simd/bundler/ezu_bg.wasm.d.ts

@@ -16,6 +16,7 @@ export const renderer_attribution: (a: number) => [number, number];
 export const renderer_bindSource: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
 export const renderer_boundSources: (a: number) => [number, number];
 export const renderer_clearSources: (a: number) => void;
+export const renderer_legend: (a: number, b: number) => [number, number, number];
 export const renderer_memoryUsage: (a: number) => [number, number, number];
 export const renderer_neededCodepoints: (a: number) => [number, number, number];
 export const renderer_neededGlyphRanges: (a: number) => [number, number, number];
@@ -25,6 +26,7 @@ export const renderer_renderTile: (a: number, b: number, c: number, d: number, e
 export const renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
 export const renderer_setGlyphBudget: (a: number, b: number) => void;
 export const renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+export const renderer_sourceTile: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
 export const renderer_tileSize: (a: number) => number;
 export const simdEnabled: () => number;
 export const threadsEnabled: () => number;

package/simd/nodejs/ezu.d.ts

@@ -111,6 +111,16 @@ export class Renderer {
      * Drop every pending source binding. Call between tile renders.
      */
     clearSources(): void;
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     */
+    legend(zoom?: number | null): any;
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -220,6 +230,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      */
     requestedNeighborOffsets(name: string): Array<any>;
@@ -253,6 +268,23 @@ export class Renderer {
      * the intermediate cache and drops any pending source bindings.
      */
     setStyle(style_json: string): number;
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     */
+    sourceTile(name: string, z: number, x: number, y: number): any;
     /**
      * Effective attribution declared by the style (document +
      * sources), joined with ` | `. Upstream TileJSON / PMTiles

package/simd/nodejs/ezu.js

@@ -200,6 +200,24 @@ class Renderer {
     clearSources() {
         wasm.renderer_clearSources(this.__wbg_ptr);
     }
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     * @param {number | null} [zoom]
+     * @returns {any}
+     */
+    legend(zoom) {
+        const ret = wasm.renderer_legend(this.__wbg_ptr, isLikeNone(zoom) ? 0xFFFFFF : zoom);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -370,6 +388,11 @@ class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      * @param {string} name
      * @returns {Array<any>}
@@ -426,6 +449,36 @@ class Renderer {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     * @param {string} name
+     * @param {number} z
+     * @param {number} x
+     * @param {number} y
+     * @returns {any}
+     */
+    sourceTile(name, z, x, y) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.renderer_sourceTile(this.__wbg_ptr, ptr0, len0, z, x, y);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * `tile-size` declared by the current style.
      * @returns {number}

package/simd/nodejs/ezu_bg.wasm.d.ts

@@ -16,6 +16,7 @@ export const renderer_attribution: (a: number) => [number, number];
 export const renderer_bindSource: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
 export const renderer_boundSources: (a: number) => [number, number];
 export const renderer_clearSources: (a: number) => void;
+export const renderer_legend: (a: number, b: number) => [number, number, number];
 export const renderer_memoryUsage: (a: number) => [number, number, number];
 export const renderer_neededCodepoints: (a: number) => [number, number, number];
 export const renderer_neededGlyphRanges: (a: number) => [number, number, number];
@@ -25,6 +26,7 @@ export const renderer_renderTile: (a: number, b: number, c: number, d: number, e
 export const renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
 export const renderer_setGlyphBudget: (a: number, b: number) => void;
 export const renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+export const renderer_sourceTile: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
 export const renderer_tileSize: (a: number) => number;
 export const simdEnabled: () => number;
 export const threadsEnabled: () => number;

package/simd/web/ezu.d.ts

@@ -111,6 +111,16 @@ export class Renderer {
      * Drop every pending source binding. Call between tile renders.
      */
     clearSources(): void;
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     */
+    legend(zoom?: number | null): any;
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -220,6 +230,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      */
     requestedNeighborOffsets(name: string): Array<any>;
@@ -253,6 +268,23 @@ export class Renderer {
      * the intermediate cache and drops any pending source bindings.
      */
     setStyle(style_json: string): number;
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     */
+    sourceTile(name: string, z: number, x: number, y: number): any;
     /**
      * Effective attribution declared by the style (document +
      * sources), joined with ` | `. Upstream TileJSON / PMTiles
@@ -323,6 +355,7 @@ export interface InitOutput {
     readonly renderer_bindSource: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly renderer_boundSources: (a: number) => [number, number];
     readonly renderer_clearSources: (a: number) => void;
+    readonly renderer_legend: (a: number, b: number) => [number, number, number];
     readonly renderer_memoryUsage: (a: number) => [number, number, number];
     readonly renderer_neededCodepoints: (a: number) => [number, number, number];
     readonly renderer_neededGlyphRanges: (a: number) => [number, number, number];
@@ -332,6 +365,7 @@ export interface InitOutput {
     readonly renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
     readonly renderer_setGlyphBudget: (a: number, b: number) => void;
     readonly renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+    readonly renderer_sourceTile: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
     readonly renderer_tileSize: (a: number) => number;
     readonly simdEnabled: () => number;
     readonly threadsEnabled: () => number;

package/simd/web/ezu.js

@@ -199,6 +199,24 @@ export class Renderer {
     clearSources() {
         wasm.renderer_clearSources(this.__wbg_ptr);
     }
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     * @param {number | null} [zoom]
+     * @returns {any}
+     */
+    legend(zoom) {
+        const ret = wasm.renderer_legend(this.__wbg_ptr, isLikeNone(zoom) ? 0xFFFFFF : zoom);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -369,6 +387,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      * @param {string} name
      * @returns {Array<any>}
@@ -425,6 +448,36 @@ export class Renderer {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     * @param {string} name
+     * @param {number} z
+     * @param {number} x
+     * @param {number} y
+     * @returns {any}
+     */
+    sourceTile(name, z, x, y) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.renderer_sourceTile(this.__wbg_ptr, ptr0, len0, z, x, y);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * `tile-size` declared by the current style.
      * @returns {number}

package/simd/web/ezu_bg.wasm.d.ts

@@ -16,6 +16,7 @@ export const renderer_attribution: (a: number) => [number, number];
 export const renderer_bindSource: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
 export const renderer_boundSources: (a: number) => [number, number];
 export const renderer_clearSources: (a: number) => void;
+export const renderer_legend: (a: number, b: number) => [number, number, number];
 export const renderer_memoryUsage: (a: number) => [number, number, number];
 export const renderer_neededCodepoints: (a: number) => [number, number, number];
 export const renderer_neededGlyphRanges: (a: number) => [number, number, number];
@@ -25,6 +26,7 @@ export const renderer_renderTile: (a: number, b: number, c: number, d: number, e
 export const renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
 export const renderer_setGlyphBudget: (a: number, b: number) => void;
 export const renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+export const renderer_sourceTile: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
 export const renderer_tileSize: (a: number) => number;
 export const simdEnabled: () => number;
 export const threadsEnabled: () => number;

package/web/ezu.d.ts

@@ -111,6 +111,16 @@ export class Renderer {
      * Drop every pending source binding. Call between tile renders.
      */
     clearSources(): void;
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     */
+    legend(zoom?: number | null): any;
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -220,6 +230,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      */
     requestedNeighborOffsets(name: string): Array<any>;
@@ -253,6 +268,23 @@ export class Renderer {
      * the intermediate cache and drops any pending source bindings.
      */
     setStyle(style_json: string): number;
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     */
+    sourceTile(name: string, z: number, x: number, y: number): any;
     /**
      * Effective attribution declared by the style (document +
      * sources), joined with ` | `. Upstream TileJSON / PMTiles
@@ -323,6 +355,7 @@ export interface InitOutput {
     readonly renderer_bindSource: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly renderer_boundSources: (a: number) => [number, number];
     readonly renderer_clearSources: (a: number) => void;
+    readonly renderer_legend: (a: number, b: number) => [number, number, number];
     readonly renderer_memoryUsage: (a: number) => [number, number, number];
     readonly renderer_neededCodepoints: (a: number) => [number, number, number];
     readonly renderer_neededGlyphRanges: (a: number) => [number, number, number];
@@ -332,6 +365,7 @@ export interface InitOutput {
     readonly renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
     readonly renderer_setGlyphBudget: (a: number, b: number) => void;
     readonly renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+    readonly renderer_sourceTile: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
     readonly renderer_tileSize: (a: number) => number;
     readonly simdEnabled: () => number;
     readonly threadsEnabled: () => number;

package/web/ezu.js

@@ -199,6 +199,24 @@ export class Renderer {
     clearSources() {
         wasm.renderer_clearSources(this.__wbg_ptr);
     }
+    /**
+     * The style's declared `legend`, or `undefined` when it declares
+     * none. Pass a zoom to keep only the entries that apply there.
+     *
+     * Entries name the node that draws the symbol rather than restating
+     * a colour, so a host lays out the labels and asks the map itself
+     * for the swatches. The CLI's `ezu legend` renders those swatches;
+     * in a browser, render the named node.
+     * @param {number | null} [zoom]
+     * @returns {any}
+     */
+    legend(zoom) {
+        const ret = wasm.renderer_legend(this.__wbg_ptr, isLikeNone(zoom) ? 0xFFFFFF : zoom);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * What this renderer is holding, in bytes, so a host can shed load
      * *before* an allocation fails rather than after.
@@ -369,6 +387,11 @@ export class Renderer {
      * fetches exactly what the recipe needs. An empty array means the
      * centre tile is enough.
      *
+     * A `dem` or `raster` source that declares `neighbor-fetch: false`
+     * reports no offsets whatever the graph asks for: the style has said
+     * not to stitch a neighbourhood for it, and this list is what a host
+     * fetches from.
+     *
      * Throws `UnknownSource` if `name` is not declared in the style.
      * @param {string} name
      * @returns {Array<any>}
@@ -425,6 +448,36 @@ export class Renderer {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * The tile a host should actually fetch from `name` in order to draw
+     * `z/x/y`, as `{ z, x, y }`.
+     *
+     * For a source that declares `max-zoom`, a request past the ceiling
+     * answers with the covering ancestor — bind those bytes with
+     * `{ sourceZoom: <returned z> }` and the renderer resamples or
+     * reprojects them into the requested tile. Below the ceiling, and for
+     * a source that declares no ceiling, the answer is the tile itself.
+     *
+     * This exists so the ceiling lives in one place. A host that hard-codes
+     * the maxzoom of each source keeps a second copy of something the style
+     * already states, and the two drift.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     * @param {string} name
+     * @param {number} z
+     * @param {number} x
+     * @param {number} y
+     * @returns {any}
+     */
+    sourceTile(name, z, x, y) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.renderer_sourceTile(this.__wbg_ptr, ptr0, len0, z, x, y);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * `tile-size` declared by the current style.
      * @returns {number}

package/web/ezu_bg.wasm.d.ts

@@ -16,6 +16,7 @@ export const renderer_attribution: (a: number) => [number, number];
 export const renderer_bindSource: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
 export const renderer_boundSources: (a: number) => [number, number];
 export const renderer_clearSources: (a: number) => void;
+export const renderer_legend: (a: number, b: number) => [number, number, number];
 export const renderer_memoryUsage: (a: number) => [number, number, number];
 export const renderer_neededCodepoints: (a: number) => [number, number, number];
 export const renderer_neededGlyphRanges: (a: number) => [number, number, number];
@@ -25,6 +26,7 @@ export const renderer_renderTile: (a: number, b: number, c: number, d: number, e
 export const renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
 export const renderer_setGlyphBudget: (a: number, b: number) => void;
 export const renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+export const renderer_sourceTile: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
 export const renderer_tileSize: (a: number) => number;
 export const simdEnabled: () => number;
 export const threadsEnabled: () => number;