@reearth/ezu 0.3.0 → 0.4.0

package/bundler/ezu.d.ts

@@ -38,6 +38,10 @@ export class LogSink {
     /**
      * Set (or clear with `null` / `undefined`) the per-event JS
      * callback. The callback receives a structured record object.
+     *
+     * No-op in multithreaded (`threads`) builds — events can originate
+     * on rayon worker threads, so live forwarding to a main-thread JS
+     * callback isn't available. Use `drain` / `drainLines` instead.
      */
     onEvent(callback?: Function | null): void;
     /**
@@ -61,11 +65,16 @@ export class Renderer {
      * Bind raw tile bytes under a `sources.<name>` entry from the style.
      * The renderer dispatches on the source's declared `type`:
      *
-     * - `mvt` / `pmtiles` → decode MVT layers eagerly; layers are bound
-     *   as `tile.<layer>` when [`render_tile`] runs.
-     * - `dem` → store the raw raster-DEM bytes per `(dx, dy)` neighbour
+     * - `mvt` / `pmtiles` → store raw MVT bytes per `(dx, dy)` neighbour
+     *   offset (centre `coord: [0, 0]`, the default). Layers are bound as
+     *   `<source>.<layer>` (centre) or `<source>.<layer>@dx,dy`
+     *   (neighbours) when [`render_tile`] runs. Binding only the centre
+     *   degrades cross-tile label collision to centre-only at borders.
+     * - `dem` / `raster` → store the raw bytes per `(dx, dy)` neighbour
      *   offset. The centre tile is `coord: [0, 0]` (default). Decoding
      *   and 3×3 stitching happen at render time once the tile id is known.
+     * - `geojson` (remote) → store raw bytes per `(dx, dy)` offset;
+     *   projected per tile (and neighbour) at render time.
      *
      * `opts` is a JS object: `{ coord?: [dx, dy] }`. Throws
      * `UnknownSource` if `name` doesn't match any entry in the style's
@@ -102,6 +111,12 @@ export class Renderer {
      * the intermediate cache and drops any pending source bindings.
      */
     setStyle(style_json: string): number;
+    /**
+     * Effective attribution declared by the style (document +
+     * sources), joined with ` | `. Upstream TileJSON / PMTiles
+     * metadata is the JS host's concern — merge it on that side.
+     */
+    readonly attribution: string | undefined;
     /**
      * `tile-size` declared by the current style.
      */
@@ -113,3 +128,11 @@ export class Renderer {
  * page label the renderer build accurately.
  */
 export function simdEnabled(): boolean;
+
+/**
+ * Whether this build supports multithreaded rendering (compiled with
+ * the `threads` feature). When `false`, `initThreadPool` is absent and
+ * `renderTile`'s `parallel` option is a no-op. Mirrors `simdEnabled` so
+ * the host can label the build.
+ */
+export function threadsEnabled(): boolean;

package/bundler/ezu.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./ezu_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    LogSink, Renderer, simdEnabled
+    LogSink, Renderer, simdEnabled, threadsEnabled
 } from "./ezu_bg.js";

package/bundler/ezu_bg.js

@@ -78,6 +78,10 @@ export class LogSink {
     /**
      * Set (or clear with `null` / `undefined`) the per-event JS
      * callback. The callback receives a structured record object.
+     *
+     * No-op in multithreaded (`threads`) builds — events can originate
+     * on rayon worker threads, so live forwarding to a main-thread JS
+     * callback isn't available. Use `drain` / `drainLines` instead.
      * @param {Function | null} [callback]
      */
     onEvent(callback) {
@@ -108,15 +112,35 @@ export class Renderer {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_renderer_free(ptr, 0);
     }
+    /**
+     * Effective attribution declared by the style (document +
+     * sources), joined with ` | `. Upstream TileJSON / PMTiles
+     * metadata is the JS host's concern — merge it on that side.
+     * @returns {string | undefined}
+     */
+    get attribution() {
+        const ret = wasm.renderer_attribution(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]).slice();
+            wasm.__wbindgen_free_command_export(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
     /**
      * Bind raw tile bytes under a `sources.<name>` entry from the style.
      * The renderer dispatches on the source's declared `type`:
      *
-     * - `mvt` / `pmtiles` → decode MVT layers eagerly; layers are bound
-     *   as `tile.<layer>` when [`render_tile`] runs.
-     * - `dem` → store the raw raster-DEM bytes per `(dx, dy)` neighbour
+     * - `mvt` / `pmtiles` → store raw MVT bytes per `(dx, dy)` neighbour
+     *   offset (centre `coord: [0, 0]`, the default). Layers are bound as
+     *   `<source>.<layer>` (centre) or `<source>.<layer>@dx,dy`
+     *   (neighbours) when [`render_tile`] runs. Binding only the centre
+     *   degrades cross-tile label collision to centre-only at borders.
+     * - `dem` / `raster` → store the raw bytes per `(dx, dy)` neighbour
      *   offset. The centre tile is `coord: [0, 0]` (default). Decoding
      *   and 3×3 stitching happen at render time once the tile id is known.
+     * - `geojson` (remote) → store raw bytes per `(dx, dy)` offset;
+     *   projected per tile (and neighbour) at render time.
      *
      * `opts` is a JS object: `{ coord?: [dx, dy] }`. Throws
      * `UnknownSource` if `name` doesn't match any entry in the style's
@@ -227,6 +251,23 @@ export function simdEnabled() {
     const ret = wasm.simdEnabled();
     return ret !== 0;
 }
+
+/**
+ * Whether this build supports multithreaded rendering (compiled with
+ * the `threads` feature). When `false`, `initThreadPool` is absent and
+ * `renderTile`'s `parallel` option is a no-op. Mirrors `simdEnabled` so
+ * the host can label the build.
+ * @returns {boolean}
+ */
+export function threadsEnabled() {
+    const ret = wasm.threadsEnabled();
+    return ret !== 0;
+}
+export function __wbg___wbindgen_boolean_get_2304fb8c853028c8(arg0) {
+    const v = arg0;
+    const ret = typeof(v) === 'boolean' ? v : undefined;
+    return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
+}
 export function __wbg___wbindgen_is_null_2042690d351e14f0(arg0) {
     const ret = arg0 === null;
     return ret;

package/bundler/ezu_bg.wasm.d.ts

@@ -11,6 +11,7 @@ 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;
@@ -19,6 +20,7 @@ export const renderer_renderTile: (a: number, b: number, c: number, d: number, e
 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;

package/nodejs/ezu.d.ts

@@ -38,6 +38,10 @@ export class LogSink {
     /**
      * Set (or clear with `null` / `undefined`) the per-event JS
      * callback. The callback receives a structured record object.
+     *
+     * No-op in multithreaded (`threads`) builds — events can originate
+     * on rayon worker threads, so live forwarding to a main-thread JS
+     * callback isn't available. Use `drain` / `drainLines` instead.
      */
     onEvent(callback?: Function | null): void;
     /**
@@ -61,11 +65,16 @@ export class Renderer {
      * Bind raw tile bytes under a `sources.<name>` entry from the style.
      * The renderer dispatches on the source's declared `type`:
      *
-     * - `mvt` / `pmtiles` → decode MVT layers eagerly; layers are bound
-     *   as `tile.<layer>` when [`render_tile`] runs.
-     * - `dem` → store the raw raster-DEM bytes per `(dx, dy)` neighbour
+     * - `mvt` / `pmtiles` → store raw MVT bytes per `(dx, dy)` neighbour
+     *   offset (centre `coord: [0, 0]`, the default). Layers are bound as
+     *   `<source>.<layer>` (centre) or `<source>.<layer>@dx,dy`
+     *   (neighbours) when [`render_tile`] runs. Binding only the centre
+     *   degrades cross-tile label collision to centre-only at borders.
+     * - `dem` / `raster` → store the raw bytes per `(dx, dy)` neighbour
      *   offset. The centre tile is `coord: [0, 0]` (default). Decoding
      *   and 3×3 stitching happen at render time once the tile id is known.
+     * - `geojson` (remote) → store raw bytes per `(dx, dy)` offset;
+     *   projected per tile (and neighbour) at render time.
      *
      * `opts` is a JS object: `{ coord?: [dx, dy] }`. Throws
      * `UnknownSource` if `name` doesn't match any entry in the style's
@@ -102,6 +111,12 @@ export class Renderer {
      * the intermediate cache and drops any pending source bindings.
      */
     setStyle(style_json: string): number;
+    /**
+     * Effective attribution declared by the style (document +
+     * sources), joined with ` | `. Upstream TileJSON / PMTiles
+     * metadata is the JS host's concern — merge it on that side.
+     */
+    readonly attribution: string | undefined;
     /**
      * `tile-size` declared by the current style.
      */
@@ -113,3 +128,11 @@ export class Renderer {
  * page label the renderer build accurately.
  */
 export function simdEnabled(): boolean;
+
+/**
+ * Whether this build supports multithreaded rendering (compiled with
+ * the `threads` feature). When `false`, `initThreadPool` is absent and
+ * `renderTile`'s `parallel` option is a no-op. Mirrors `simdEnabled` so
+ * the host can label the build.
+ */
+export function threadsEnabled(): boolean;

package/nodejs/ezu.js

@@ -80,6 +80,10 @@ class LogSink {
     /**
      * Set (or clear with `null` / `undefined`) the per-event JS
      * callback. The callback receives a structured record object.
+     *
+     * No-op in multithreaded (`threads`) builds — events can originate
+     * on rayon worker threads, so live forwarding to a main-thread JS
+     * callback isn't available. Use `drain` / `drainLines` instead.
      * @param {Function | null} [callback]
      */
     onEvent(callback) {
@@ -111,15 +115,35 @@ class Renderer {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_renderer_free(ptr, 0);
     }
+    /**
+     * Effective attribution declared by the style (document +
+     * sources), joined with ` | `. Upstream TileJSON / PMTiles
+     * metadata is the JS host's concern — merge it on that side.
+     * @returns {string | undefined}
+     */
+    get attribution() {
+        const ret = wasm.renderer_attribution(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]).slice();
+            wasm.__wbindgen_free_command_export(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
     /**
      * Bind raw tile bytes under a `sources.<name>` entry from the style.
      * The renderer dispatches on the source's declared `type`:
      *
-     * - `mvt` / `pmtiles` → decode MVT layers eagerly; layers are bound
-     *   as `tile.<layer>` when [`render_tile`] runs.
-     * - `dem` → store the raw raster-DEM bytes per `(dx, dy)` neighbour
+     * - `mvt` / `pmtiles` → store raw MVT bytes per `(dx, dy)` neighbour
+     *   offset (centre `coord: [0, 0]`, the default). Layers are bound as
+     *   `<source>.<layer>` (centre) or `<source>.<layer>@dx,dy`
+     *   (neighbours) when [`render_tile`] runs. Binding only the centre
+     *   degrades cross-tile label collision to centre-only at borders.
+     * - `dem` / `raster` → store the raw bytes per `(dx, dy)` neighbour
      *   offset. The centre tile is `coord: [0, 0]` (default). Decoding
      *   and 3×3 stitching happen at render time once the tile id is known.
+     * - `geojson` (remote) → store raw bytes per `(dx, dy)` offset;
+     *   projected per tile (and neighbour) at render time.
      *
      * `opts` is a JS object: `{ coord?: [dx, dy] }`. Throws
      * `UnknownSource` if `name` doesn't match any entry in the style's
@@ -232,9 +256,27 @@ function simdEnabled() {
     return ret !== 0;
 }
 exports.simdEnabled = simdEnabled;
+
+/**
+ * Whether this build supports multithreaded rendering (compiled with
+ * the `threads` feature). When `false`, `initThreadPool` is absent and
+ * `renderTile`'s `parallel` option is a no-op. Mirrors `simdEnabled` so
+ * the host can label the build.
+ * @returns {boolean}
+ */
+function threadsEnabled() {
+    const ret = wasm.threadsEnabled();
+    return ret !== 0;
+}
+exports.threadsEnabled = threadsEnabled;
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg___wbindgen_boolean_get_2304fb8c853028c8: function(arg0) {
+            const v = arg0;
+            const ret = typeof(v) === 'boolean' ? v : undefined;
+            return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
+        },
         __wbg___wbindgen_is_null_2042690d351e14f0: function(arg0) {
             const ret = arg0 === null;
             return ret;

package/nodejs/ezu_bg.wasm.d.ts

@@ -11,6 +11,7 @@ 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;
@@ -19,6 +20,7 @@ export const renderer_renderTile: (a: number, b: number, c: number, d: number, e
 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;

package/package.json

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

package/web/ezu.d.ts

@@ -38,6 +38,10 @@ export class LogSink {
     /**
      * Set (or clear with `null` / `undefined`) the per-event JS
      * callback. The callback receives a structured record object.
+     *
+     * No-op in multithreaded (`threads`) builds — events can originate
+     * on rayon worker threads, so live forwarding to a main-thread JS
+     * callback isn't available. Use `drain` / `drainLines` instead.
      */
     onEvent(callback?: Function | null): void;
     /**
@@ -61,11 +65,16 @@ export class Renderer {
      * Bind raw tile bytes under a `sources.<name>` entry from the style.
      * The renderer dispatches on the source's declared `type`:
      *
-     * - `mvt` / `pmtiles` → decode MVT layers eagerly; layers are bound
-     *   as `tile.<layer>` when [`render_tile`] runs.
-     * - `dem` → store the raw raster-DEM bytes per `(dx, dy)` neighbour
+     * - `mvt` / `pmtiles` → store raw MVT bytes per `(dx, dy)` neighbour
+     *   offset (centre `coord: [0, 0]`, the default). Layers are bound as
+     *   `<source>.<layer>` (centre) or `<source>.<layer>@dx,dy`
+     *   (neighbours) when [`render_tile`] runs. Binding only the centre
+     *   degrades cross-tile label collision to centre-only at borders.
+     * - `dem` / `raster` → store the raw bytes per `(dx, dy)` neighbour
      *   offset. The centre tile is `coord: [0, 0]` (default). Decoding
      *   and 3×3 stitching happen at render time once the tile id is known.
+     * - `geojson` (remote) → store raw bytes per `(dx, dy)` offset;
+     *   projected per tile (and neighbour) at render time.
      *
      * `opts` is a JS object: `{ coord?: [dx, dy] }`. Throws
      * `UnknownSource` if `name` doesn't match any entry in the style's
@@ -102,6 +111,12 @@ export class Renderer {
      * the intermediate cache and drops any pending source bindings.
      */
     setStyle(style_json: string): number;
+    /**
+     * Effective attribution declared by the style (document +
+     * sources), joined with ` | `. Upstream TileJSON / PMTiles
+     * metadata is the JS host's concern — merge it on that side.
+     */
+    readonly attribution: string | undefined;
     /**
      * `tile-size` declared by the current style.
      */
@@ -114,6 +129,14 @@ export class Renderer {
  */
 export function simdEnabled(): boolean;
 
+/**
+ * Whether this build supports multithreaded rendering (compiled with
+ * the `threads` feature). When `false`, `initThreadPool` is absent and
+ * `renderTile`'s `parallel` option is a no-op. Mirrors `simdEnabled` so
+ * the host can label the build.
+ */
+export function threadsEnabled(): boolean;
+
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
@@ -128,6 +151,7 @@ export interface InitOutput {
     readonly logsink_new: (a: number, b: number) => [number, number, number];
     readonly logsink_onEvent: (a: number, b: number) => void;
     readonly logsink_setCapacity: (a: number, b: number) => void;
+    readonly renderer_attribution: (a: number) => [number, number];
     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;
@@ -136,6 +160,7 @@ export interface InitOutput {
     readonly renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
     readonly renderer_tileSize: (a: number) => number;
     readonly simdEnabled: () => number;
+    readonly threadsEnabled: () => number;
     readonly __wbindgen_malloc_command_export: (a: number, b: number) => number;
     readonly __wbindgen_realloc_command_export: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_exn_store_command_export: (a: number) => void;

package/web/ezu.js

@@ -80,6 +80,10 @@ export class LogSink {
     /**
      * Set (or clear with `null` / `undefined`) the per-event JS
      * callback. The callback receives a structured record object.
+     *
+     * No-op in multithreaded (`threads`) builds — events can originate
+     * on rayon worker threads, so live forwarding to a main-thread JS
+     * callback isn't available. Use `drain` / `drainLines` instead.
      * @param {Function | null} [callback]
      */
     onEvent(callback) {
@@ -110,15 +114,35 @@ export class Renderer {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_renderer_free(ptr, 0);
     }
+    /**
+     * Effective attribution declared by the style (document +
+     * sources), joined with ` | `. Upstream TileJSON / PMTiles
+     * metadata is the JS host's concern — merge it on that side.
+     * @returns {string | undefined}
+     */
+    get attribution() {
+        const ret = wasm.renderer_attribution(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]).slice();
+            wasm.__wbindgen_free_command_export(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
     /**
      * Bind raw tile bytes under a `sources.<name>` entry from the style.
      * The renderer dispatches on the source's declared `type`:
      *
-     * - `mvt` / `pmtiles` → decode MVT layers eagerly; layers are bound
-     *   as `tile.<layer>` when [`render_tile`] runs.
-     * - `dem` → store the raw raster-DEM bytes per `(dx, dy)` neighbour
+     * - `mvt` / `pmtiles` → store raw MVT bytes per `(dx, dy)` neighbour
+     *   offset (centre `coord: [0, 0]`, the default). Layers are bound as
+     *   `<source>.<layer>` (centre) or `<source>.<layer>@dx,dy`
+     *   (neighbours) when [`render_tile`] runs. Binding only the centre
+     *   degrades cross-tile label collision to centre-only at borders.
+     * - `dem` / `raster` → store the raw bytes per `(dx, dy)` neighbour
      *   offset. The centre tile is `coord: [0, 0]` (default). Decoding
      *   and 3×3 stitching happen at render time once the tile id is known.
+     * - `geojson` (remote) → store raw bytes per `(dx, dy)` offset;
+     *   projected per tile (and neighbour) at render time.
      *
      * `opts` is a JS object: `{ coord?: [dx, dy] }`. Throws
      * `UnknownSource` if `name` doesn't match any entry in the style's
@@ -229,9 +253,26 @@ export function simdEnabled() {
     const ret = wasm.simdEnabled();
     return ret !== 0;
 }
+
+/**
+ * Whether this build supports multithreaded rendering (compiled with
+ * the `threads` feature). When `false`, `initThreadPool` is absent and
+ * `renderTile`'s `parallel` option is a no-op. Mirrors `simdEnabled` so
+ * the host can label the build.
+ * @returns {boolean}
+ */
+export function threadsEnabled() {
+    const ret = wasm.threadsEnabled();
+    return ret !== 0;
+}
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg___wbindgen_boolean_get_2304fb8c853028c8: function(arg0) {
+            const v = arg0;
+            const ret = typeof(v) === 'boolean' ? v : undefined;
+            return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
+        },
         __wbg___wbindgen_is_null_2042690d351e14f0: function(arg0) {
             const ret = arg0 === null;
             return ret;

package/web/ezu_bg.wasm.d.ts

@@ -11,6 +11,7 @@ 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;
@@ -19,6 +20,7 @@ export const renderer_renderTile: (a: number, b: number, c: number, d: number, e
 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;