@reearth/ezu 0.2.0

package/web/ezu.d.ts

@@ -0,0 +1,190 @@
+/* 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;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_logsink_free: (a: number, b: number) => void;
+    readonly __wbg_renderer_free: (a: number, b: number) => void;
+    readonly logsink_clear: (a: number) => void;
+    readonly logsink_drain: (a: number) => any;
+    readonly logsink_drainLines: (a: number) => [number, number];
+    readonly logsink_isEmpty: (a: number) => number;
+    readonly logsink_len: (a: number) => number;
+    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_brushCount: (a: number) => number;
+    readonly renderer_clearBrushes: (a: number) => void;
+    readonly renderer_new: (a: number, b: number) => [number, number, number];
+    readonly renderer_registerBrush: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly renderer_render: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+    readonly renderer_renderAt: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly renderer_renderRgba: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly renderer_renderRgbaAt: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
+    readonly renderer_renderWebp: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+    readonly renderer_renderWebpAt: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly renderer_setStyle: (a: number, b: number, c: number) => [number, number, number];
+    readonly renderer_tileSize: (a: number) => number;
+    readonly renderer_unregisterBrush: (a: number, b: number, c: number) => number;
+    readonly simdEnabled: () => 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;
+    readonly __externref_table_alloc_command_export: () => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __wbindgen_free_command_export: (a: number, b: number, c: number) => void;
+    readonly __externref_drop_slice_command_export: (a: number, b: number) => void;
+    readonly __externref_table_dealloc_command_export: (a: number) => void;
+    readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;