@reearth/ezu 0.2.0

package/nodejs/ezu.d.ts

@@ -0,0 +1,129 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * Buffered log sink that captures `tracing` events from the renderer.
+ *
+ * Construct once near the top of your bootstrap, then either set a
+ * callback for live forwarding (`onEvent(e => console.log(e))`) or
+ * `drainLines()` periodically to flush into a UI panel.
+ */
+export class LogSink {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Drop all buffered records without returning them.
+     */
+    clear(): void;
+    /**
+     * Drain every buffered record. Returns a JS array of structured
+     * objects `{ level, target, message, fields, timestampMs }`.
+     */
+    drain(): Array<any>;
+    /**
+     * Drain buffered records and return pre-formatted strings — the
+     * same shape the CLI prints. Convenient for `console.log(lines.join('\n'))`.
+     */
+    drainLines(): string[];
+    /**
+     * `true` if no records are buffered.
+     */
+    isEmpty(): boolean;
+    /**
+     * Install (idempotently) the global tracing subscriber. `level` is
+     * an `EnvFilter` string — e.g. `"info"`, `"debug"`,
+     * `"info,ezu_graph::eval=debug"`. Honoured on first call only.
+     */
+    constructor(level: string);
+    /**
+     * Set (or clear with `null` / `undefined`) the per-event JS
+     * callback. The callback receives a structured record object.
+     */
+    onEvent(callback?: Function | null): void;
+    /**
+     * Resize the ring-buffer cap. Older entries are evicted FIFO once
+     * the buffer reaches the new cap. Default is 4096.
+     */
+    setCapacity(cap: number): void;
+    /**
+     * Number of records currently buffered.
+     */
+    readonly len: number;
+}
+
+/**
+ * Stateful WASM renderer.
+ */
+export class Renderer {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Number of brushes currently registered.
+     */
+    brushCount(): number;
+    /**
+     * Drop every registered brush.
+     */
+    clearBrushes(): void;
+    /**
+     * Build a renderer from a style JSON document.
+     */
+    constructor(style_json: string);
+    /**
+     * Register a `.myb` brush under `name` so a `brush-file` node with
+     * `src: "@name"` (via the style's `assets` map) resolves to it.
+     * Re-registering the same name replaces the previous entry.
+     */
+    registerBrush(name: string, myb_json: string): void;
+    /**
+     * Render a single tile to PNG bytes using the style's `tile-size` / `pad`.
+     * Pass `null` for `mvtBytes` to get a paper-only tile.
+     *
+     * Optional `options`: `{ png: { compression: 'fast' | 'default' | 'best' } }`.
+     */
+    render(mvt_bytes: Uint8Array | null | undefined, z: number, x: number, y: number, options?: object | null): Uint8Array;
+    /**
+     * Like `render` but with `tile_size` / `pad` overridden — useful for
+     * hi-DPI / preview rendering without mutating the style.
+     */
+    renderAt(mvt_bytes: Uint8Array | null | undefined, z: number, x: number, y: number, tile_size: number, pad: number, options?: object | null): Uint8Array;
+    /**
+     * Render a single tile to straight RGBA8 bytes (`tile_w * tile_h * 4`).
+     */
+    renderRgba(mvt_bytes: Uint8Array | null | undefined, z: number, x: number, y: number): Uint8Array;
+    /**
+     * Like `renderRgba` but with `tile_size` / `pad` overridden.
+     */
+    renderRgbaAt(mvt_bytes: Uint8Array | null | undefined, z: number, x: number, y: number, tile_size: number, pad: number): Uint8Array;
+    /**
+     * Render a single tile to lossless WebP bytes. Smaller than PNG
+     * for the same painterly content and decoded natively by every
+     * modern browser. WebP is lossless-only via the pure-Rust
+     * `image-webp` codec; for lossy WebP, see the
+     * `OffscreenCanvas.convertToBlob` recipe in the crate README.
+     */
+    renderWebp(mvt_bytes: Uint8Array | null | undefined, z: number, x: number, y: number, options?: object | null): Uint8Array;
+    /**
+     * Like `renderWebp` but with `tile_size` / `pad` overridden.
+     */
+    renderWebpAt(mvt_bytes: Uint8Array | null | undefined, z: number, x: number, y: number, tile_size: number, pad: number, options?: object | null): Uint8Array;
+    /**
+     * Replace the active style. Returns the new node count. Invalidates
+     * the intermediate cache.
+     */
+    setStyle(style_json: string): number;
+    /**
+     * Remove a brush by name. Returns `true` if the brush existed.
+     */
+    unregisterBrush(name: string): boolean;
+    /**
+     * `tile-size` declared by the current style.
+     */
+    readonly tileSize: number;
+}
+
+/**
+ * Whether the wasm binary was compiled with `+simd128`. Lets the demo
+ * page label the renderer build accurately.
+ */
+export function simdEnabled(): boolean;