@reearth/ezu 0.4.0 → 0.4.2

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

@@ -0,0 +1,34 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __wbg_logsink_free: (a: number, b: number) => void;
+export const __wbg_renderer_free: (a: number, b: number) => void;
+export const logsink_clear: (a: number) => void;
+export const logsink_drain: (a: number) => any;
+export const logsink_drainLines: (a: number) => [number, number];
+export const logsink_isEmpty: (a: number) => number;
+export const logsink_len: (a: number) => number;
+export const logsink_new: (a: number, b: number) => [number, number, number];
+export const logsink_onEvent: (a: number, b: number) => void;
+export const logsink_setCapacity: (a: number, b: number) => void;
+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_neededGlyphRanges: (a: number) => [number, number, number];
+export const renderer_new: (a: number, b: number) => [number, number, number];
+export const renderer_renderTile: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+export const renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
+export const renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+export const renderer_tileSize: (a: number) => number;
+export const simdEnabled: () => number;
+export const threadsEnabled: () => number;
+export const __wbindgen_malloc_command_export: (a: number, b: number) => number;
+export const __wbindgen_realloc_command_export: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_exn_store_command_export: (a: number) => void;
+export const __externref_table_alloc_command_export: () => number;
+export const __wbindgen_externrefs: WebAssembly.Table;
+export const __wbindgen_free_command_export: (a: number, b: number, c: number) => void;
+export const __externref_drop_slice_command_export: (a: number, b: number) => void;
+export const __externref_table_dealloc_command_export: (a: number) => void;
+export const __wbindgen_start: () => void;

package/simd/workerd/ezu.d.ts

@@ -0,0 +1,3 @@
+/* tslint:disable */
+/* eslint-disable */
+export * from "../bundler/ezu.js";

package/simd/workerd/ezu.js

@@ -0,0 +1,13 @@
+/* @ts-self-types="./ezu.d.ts" */
+import * as glue from "../bundler/ezu_bg.js";
+import wasmModule from "../bundler/ezu_bg.wasm";
+
+// Synchronous instantiation is allowed at module scope on workerd; it
+// would be rejected inside a request handler.
+const instance = new WebAssembly.Instance(wasmModule, { "./ezu_bg.js": glue });
+glue.__wbg_set_wasm(instance.exports);
+instance.exports.__wbindgen_start();
+
+export {
+    LogSink, Renderer, simdEnabled, threadsEnabled
+} from "../bundler/ezu_bg.js";

package/web/ezu.d.ts

@@ -92,6 +92,28 @@ export class Renderer {
      * Drop every pending source binding. Call between tile renders.
      */
     clearSources(): void;
+    /**
+     * Glyph ranges the currently bound features can require, as
+     * `{ [glyphsSourceName]: number[] }` where each number is a range
+     * start (`0`, `256`, `512`, …) — i.e. the `{range}` in a
+     * `…/{fontstack}/{range}.pbf` URL is `<start>-<start + 255>`.
+     *
+     * This host cannot fetch glyph ranges lazily, so every range a
+     * tile's labels touch must be bound before `renderTile`. Rather than
+     * scraping every string in the MVT, call this after binding the
+     * vector sources and bind exactly the listed ranges.
+     *
+     * It is an over-approximation, deliberately: a range is listed if
+     * *any* feature in a text layer carries the codepoint in a property
+     * the layer's `text` expression reads, without evaluating filters,
+     * zoom ranges, or the expression itself, and it is listed for every
+     * fontstack in that layer's fallback chain. So it never omits a
+     * range a label needs, and it may name a few that go unused. Text
+     * layers that build their string from something other than a `get`
+     * of a feature property (a literal, a `concat` of formatted values)
+     * contribute their literal text where it is a plain string.
+     */
+    neededGlyphRanges(): object;
     /**
      * Build a renderer from a style JSON document.
      */
@@ -106,6 +128,22 @@ export class Renderer {
      * - `png`: `{ compression?: "fast" | "default" | "best" }`
      */
     renderTile(z: number, x: number, y: number, opts?: object | null): Uint8Array;
+    /**
+     * Neighbour tile offsets the active style actually asks for from
+     * `source`, as an array of `[dx, dy]` pairs (never including the
+     * centre `[0, 0]`).
+     *
+     * Cross-tile label collision and edge-continuous DEM shading are the
+     * only things that read neighbours, and only for the sources they
+     * name. A host that fetches the full 3×3 window unconditionally
+     * therefore pays for up to eight tiles it will not look at; passing
+     * each offset from this list to `bindSource(name, bytes, { coord })`
+     * fetches exactly what the recipe needs. An empty array means the
+     * centre tile is enough.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     */
+    requestedNeighborOffsets(name: string): Array<any>;
     /**
      * Replace the active style. Returns the new node count. Invalidates
      * the intermediate cache and drops any pending source bindings.
@@ -155,8 +193,10 @@ 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_neededGlyphRanges: (a: number) => [number, number, number];
     readonly renderer_new: (a: number, b: number) => [number, number, number];
     readonly renderer_renderTile: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
     readonly renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
     readonly renderer_tileSize: (a: number) => number;
     readonly simdEnabled: () => number;

package/web/ezu.js

@@ -180,6 +180,35 @@ export class Renderer {
     clearSources() {
         wasm.renderer_clearSources(this.__wbg_ptr);
     }
+    /**
+     * Glyph ranges the currently bound features can require, as
+     * `{ [glyphsSourceName]: number[] }` where each number is a range
+     * start (`0`, `256`, `512`, …) — i.e. the `{range}` in a
+     * `…/{fontstack}/{range}.pbf` URL is `<start>-<start + 255>`.
+     *
+     * This host cannot fetch glyph ranges lazily, so every range a
+     * tile's labels touch must be bound before `renderTile`. Rather than
+     * scraping every string in the MVT, call this after binding the
+     * vector sources and bind exactly the listed ranges.
+     *
+     * It is an over-approximation, deliberately: a range is listed if
+     * *any* feature in a text layer carries the codepoint in a property
+     * the layer's `text` expression reads, without evaluating filters,
+     * zoom ranges, or the expression itself, and it is listed for every
+     * fontstack in that layer's fallback chain. So it never omits a
+     * range a label needs, and it may name a few that go unused. Text
+     * layers that build their string from something other than a `get`
+     * of a feature property (a literal, a `concat` of formatted values)
+     * contribute their literal text where it is a plain string.
+     * @returns {object}
+     */
+    neededGlyphRanges() {
+        const ret = wasm.renderer_neededGlyphRanges(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * Build a renderer from a style JSON document.
      * @param {string} style_json
@@ -218,6 +247,32 @@ export class Renderer {
         wasm.__wbindgen_free_command_export(ret[0], ret[1] * 1, 1);
         return v1;
     }
+    /**
+     * Neighbour tile offsets the active style actually asks for from
+     * `source`, as an array of `[dx, dy]` pairs (never including the
+     * centre `[0, 0]`).
+     *
+     * Cross-tile label collision and edge-continuous DEM shading are the
+     * only things that read neighbours, and only for the sources they
+     * name. A host that fetches the full 3×3 window unconditionally
+     * therefore pays for up to eight tiles it will not look at; passing
+     * each offset from this list to `bindSource(name, bytes, { coord })`
+     * fetches exactly what the recipe needs. An empty array means the
+     * centre tile is enough.
+     *
+     * Throws `UnknownSource` if `name` is not declared in the style.
+     * @param {string} name
+     * @returns {Array<any>}
+     */
+    requestedNeighborOffsets(name) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.renderer_requestedNeighborOffsets(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * Replace the active style. Returns the new node count. Invalidates
      * the intermediate cache and drops any pending source bindings.
@@ -287,6 +342,9 @@ function __wbg_get_imports() {
             getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
+        __wbg___wbindgen_rethrow_2b7cc655458909c2: function(arg0) {
+            throw arg0;
+        },
         __wbg___wbindgen_string_get_d109740c0d18f4d7: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'string' ? obj : undefined;

package/web/ezu_bg.wasm.d.ts

@@ -15,8 +15,10 @@ 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_neededGlyphRanges: (a: number) => [number, number, number];
 export const renderer_new: (a: number, b: number) => [number, number, number];
 export const renderer_renderTile: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+export const renderer_requestedNeighborOffsets: (a: number, b: number, c: number) => [number, number, number];
 export const renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
 export const renderer_tileSize: (a: number) => number;
 export const simdEnabled: () => number;

package/workerd/ezu.d.ts

@@ -0,0 +1,3 @@
+/* tslint:disable */
+/* eslint-disable */
+export * from "../bundler/ezu.js";

package/workerd/ezu.js

@@ -0,0 +1,13 @@
+/* @ts-self-types="./ezu.d.ts" */
+import * as glue from "../bundler/ezu_bg.js";
+import wasmModule from "../bundler/ezu_bg.wasm";
+
+// Synchronous instantiation is allowed at module scope on workerd; it
+// would be rejected inside a request handler.
+const instance = new WebAssembly.Instance(wasmModule, { "./ezu_bg.js": glue });
+glue.__wbg_set_wasm(instance.exports);
+instance.exports.__wbindgen_start();
+
+export {
+    LogSink, Renderer, simdEnabled, threadsEnabled
+} from "../bundler/ezu_bg.js";