webtau 0.5.0-alpha.1 → 0.5.0

package/dist/adapters/electrobun.d.ts

@@ -0,0 +1,52 @@
+/**
+ * webtau/adapters/electrobun — Electrobun runtime adapter.
+ *
+ * Implements WindowAdapter, EventAdapter, FsAdapter, and DialogAdapter
+ * by delegating each operation to the Electrobun backend via `invoke()`.
+ *
+ * Usage:
+ * ```ts
+ * import { bootstrapElectrobun } from "webtau/adapters/electrobun";
+ *
+ * bootstrapElectrobun();
+ * ```
+ */
+import type { CoreProvider, DialogAdapter, EventAdapter, FsAdapter, WindowAdapter } from "../provider";
+export declare function createElectrobunWindowAdapter(): WindowAdapter;
+export declare function createElectrobunEventAdapter(): EventAdapter;
+/**
+ * Dispatch an event from the Electrobun backend to a registered handler.
+ * Called by the IPC bridge when the backend pushes an event.
+ */
+export declare function dispatchElectrobunEvent(listenerId: number, event: string, payload: unknown): void;
+export declare function createElectrobunFsAdapter(): FsAdapter;
+export declare function createElectrobunDialogAdapter(): DialogAdapter;
+/**
+ * Core provider for the Electrobun runtime.
+ *
+ * Provides the `invoke` and `convertFileSrc` implementations that all
+ * adapters delegate through.
+ */
+export declare function createElectrobunCoreProvider(): CoreProvider;
+/**
+ * Bootstrap all Electrobun adapters at once.
+ *
+ * Registers the core provider and sets adapters for window, event,
+ * filesystem, and dialog modules. After calling this function, all
+ * webtau module-level functions will delegate through Electrobun.
+ *
+ * An optional `coreProvider` can be passed to supply a custom IPC
+ * bridge (e.g. one that delegates to `electrobun.ipc.invoke()`).
+ *
+ * ```ts
+ * import { bootstrapElectrobun } from "webtau/adapters/electrobun";
+ *
+ * bootstrapElectrobun({
+ *   id: "electrobun",
+ *   invoke: (cmd, args) => electrobun.ipc.invoke(cmd, args),
+ *   convertFileSrc: (path) => `electrobun://asset/${path}`,
+ * });
+ * ```
+ */
+export declare function bootstrapElectrobun(coreProvider?: CoreProvider): void;
+//# sourceMappingURL=electrobun.d.ts.map

package/dist/adapters/electrobun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electrobun.d.ts","sourceRoot":"","sources":["../../src/adapters/electrobun.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,SAAS,EACT,aAAa,EACd,MAAM,aAAa,CAAC;AAWrB,wBAAgB,6BAA6B,IAAI,aAAa,CA8F7D;AAWD,wBAAgB,4BAA4B,IAAI,YAAY,CAyB3D;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,IAAI,CAKN;AAYD,wBAAgB,yBAAyB,IAAI,SAAS,CAkErD;AAUD,wBAAgB,6BAA6B,IAAI,aAAa,CAmC7D;AAID;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,YAAY,CAuB3D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAMrE"}

package/dist/adapters/electrobun.js

@@ -0,0 +1,290 @@
+/**
+ * webtau/adapters/electrobun — Electrobun runtime adapter.
+ *
+ * Implements WindowAdapter, EventAdapter, FsAdapter, and DialogAdapter
+ * by delegating each operation to the Electrobun backend via `invoke()`.
+ *
+ * Usage:
+ * ```ts
+ * import { bootstrapElectrobun } from "webtau/adapters/electrobun";
+ *
+ * bootstrapElectrobun();
+ * ```
+ */
+import { invoke, registerProvider } from "../core";
+import { setDialogAdapter } from "../dialog";
+import { setEventAdapter } from "../event";
+import { setFsAdapter } from "../fs";
+import { setWindowAdapter } from "../window";
+// ── Window Adapter ──────────────────────────────────────────────────────────
+// Supported: isFullscreen, setFullscreen, innerSize, outerSize, setSize,
+//            title, setTitle, close, minimize, unminimize, maximize,
+//            isMaximized, show, hide, setDecorations, scaleFactor,
+//            currentMonitor
+// Partial:   center (depends on backend window manager support)
+// Unsupported: none currently
+export function createElectrobunWindowAdapter() {
+    return {
+        async isFullscreen() {
+            return invoke("plugin:electrobun|window_is_fullscreen");
+        },
+        async setFullscreen(fullscreen) {
+            await invoke("plugin:electrobun|window_set_fullscreen", { fullscreen });
+        },
+        async innerSize() {
+            return invoke("plugin:electrobun|window_inner_size");
+        },
+        async outerSize() {
+            return invoke("plugin:electrobun|window_outer_size");
+        },
+        async setSize(size) {
+            await invoke("plugin:electrobun|window_set_size", {
+                width: size.width,
+                height: size.height,
+                type: size.type,
+            });
+        },
+        async maximize() {
+            await invoke("plugin:electrobun|window_maximize");
+        },
+        async isMaximized() {
+            return invoke("plugin:electrobun|window_is_maximized");
+        },
+        async title() {
+            return invoke("plugin:electrobun|window_title");
+        },
+        async setTitle(title) {
+            await invoke("plugin:electrobun|window_set_title", { title });
+        },
+        async close() {
+            await invoke("plugin:electrobun|window_close");
+        },
+        async minimize() {
+            await invoke("plugin:electrobun|window_minimize");
+        },
+        async unminimize() {
+            await invoke("plugin:electrobun|window_unminimize");
+        },
+        async show() {
+            await invoke("plugin:electrobun|window_show");
+        },
+        async hide() {
+            await invoke("plugin:electrobun|window_hide");
+        },
+        async setDecorations(decorations) {
+            await invoke("plugin:electrobun|window_set_decorations", { decorations });
+        },
+        // Partial: centering depends on the Electrobun backend's window
+        // manager integration. May be a no-op on some platforms.
+        async center() {
+            await invoke("plugin:electrobun|window_center");
+        },
+        async currentMonitor() {
+            return invoke("plugin:electrobun|window_current_monitor");
+        },
+        async scaleFactor() {
+            return invoke("plugin:electrobun|window_scale_factor");
+        },
+    };
+}
+// ── Event Adapter ───────────────────────────────────────────────────────────
+// Supported: listen, emit
+// Partial:   none
+// Unsupported: none currently
+//
+// Note: The event system relies on the Electrobun backend to manage event
+// subscriptions. The `listen` call returns an unlisten ID that is used to
+// remove the subscription on the backend when `unlisten()` is called.
+export function createElectrobunEventAdapter() {
+    return {
+        async listen(event, handler) {
+            const listenerId = await invoke("plugin:electrobun|event_listen", { event });
+            // Register a callback bridge — in a real Electrobun integration this
+            // would wire into the IPC message channel. Here we store the handler
+            // so the backend can dispatch events to it.
+            electrobunEventHandlers.set(listenerId, { event, handler: handler });
+            return () => {
+                electrobunEventHandlers.delete(listenerId);
+                invoke("plugin:electrobun|event_unlisten", { listenerId }).catch(() => {
+                    // Best-effort cleanup — ignore errors during unlisten.
+                });
+            };
+        },
+        async emit(event, payload) {
+            await invoke("plugin:electrobun|event_emit", { event, payload });
+        },
+    };
+}
+/** Internal registry for event handlers keyed by listener ID. */
+const electrobunEventHandlers = new Map();
+/**
+ * Dispatch an event from the Electrobun backend to a registered handler.
+ * Called by the IPC bridge when the backend pushes an event.
+ */
+export function dispatchElectrobunEvent(listenerId, event, payload) {
+    const entry = electrobunEventHandlers.get(listenerId);
+    if (entry) {
+        entry.handler({ event, id: listenerId, payload });
+    }
+}
+// ── Filesystem Adapter ──────────────────────────────────────────────────────
+// Supported: writeTextFile, readTextFile, writeFile, readFile, exists,
+//            mkdir, readDir, remove, copyFile, rename
+// Partial:   none
+// Unsupported: none currently
+//
+// Note: Binary data (Uint8Array/ArrayBuffer) is serialized as a number[]
+// for JSON transport over IPC. The backend is responsible for converting
+// back to native byte buffers.
+export function createElectrobunFsAdapter() {
+    return {
+        async writeTextFile(path, contents) {
+            await invoke("plugin:electrobun|fs_write_text_file", { path, contents });
+        },
+        async readTextFile(path) {
+            return invoke("plugin:electrobun|fs_read_text_file", { path });
+        },
+        async writeFile(path, contents) {
+            // Serialize binary data as number[] for JSON IPC transport.
+            let data;
+            if (contents instanceof Uint8Array) {
+                data = Array.from(contents);
+            }
+            else if (contents instanceof ArrayBuffer) {
+                data = Array.from(new Uint8Array(contents));
+            }
+            else if (Array.isArray(contents)) {
+                data = contents;
+            }
+            else {
+                data = Array.from(new TextEncoder().encode(contents));
+            }
+            await invoke("plugin:electrobun|fs_write_file", { path, data });
+        },
+        async readFile(path) {
+            const data = await invoke("plugin:electrobun|fs_read_file", { path });
+            return new Uint8Array(data);
+        },
+        async exists(path) {
+            return invoke("plugin:electrobun|fs_exists", { path });
+        },
+        async mkdir(path, options) {
+            await invoke("plugin:electrobun|fs_mkdir", {
+                path,
+                recursive: options?.recursive ?? false,
+            });
+        },
+        async readDir(path, options) {
+            return invoke("plugin:electrobun|fs_read_dir", {
+                path,
+                recursive: options?.recursive ?? false,
+            });
+        },
+        async remove(path, options) {
+            await invoke("plugin:electrobun|fs_remove", {
+                path,
+                recursive: options?.recursive ?? false,
+            });
+        },
+        async copyFile(fromPath, toPath) {
+            await invoke("plugin:electrobun|fs_copy_file", { fromPath, toPath });
+        },
+        async rename(oldPath, newPath) {
+            await invoke("plugin:electrobun|fs_rename", { oldPath, newPath });
+        },
+    };
+}
+// ── Dialog Adapter ──────────────────────────────────────────────────────────
+// Supported: message, ask, open, save
+// Partial:   none
+// Unsupported: none currently
+//
+// Note: Dialog appearance and behavior depend on the Electrobun backend's
+// native dialog implementation. Options are forwarded as-is.
+export function createElectrobunDialogAdapter() {
+    return {
+        async message(text, options) {
+            await invoke("plugin:electrobun|dialog_message", {
+                text,
+                title: options?.title,
+                okLabel: options?.okLabel,
+            });
+        },
+        async ask(text, options) {
+            return invoke("plugin:electrobun|dialog_ask", {
+                text,
+                title: options?.title,
+                okLabel: options?.okLabel,
+                cancelLabel: options?.cancelLabel,
+            });
+        },
+        async open(options) {
+            return invoke("plugin:electrobun|dialog_open", {
+                title: options?.title,
+                multiple: options?.multiple ?? false,
+                directory: options?.directory ?? false,
+                filters: options?.filters,
+            });
+        },
+        async save(options) {
+            return invoke("plugin:electrobun|dialog_save", {
+                title: options?.title,
+                defaultPath: options?.defaultPath,
+            });
+        },
+    };
+}
+// ── Bootstrap ───────────────────────────────────────────────────────────────
+/**
+ * Core provider for the Electrobun runtime.
+ *
+ * Provides the `invoke` and `convertFileSrc` implementations that all
+ * adapters delegate through.
+ */
+export function createElectrobunCoreProvider() {
+    return {
+        id: "electrobun",
+        invoke: async (command, _args) => {
+            // In a real Electrobun integration, this would delegate to
+            // electrobun.ipc.invoke(). For now, we throw to indicate
+            // that the actual IPC bridge must be provided at integration time.
+            //
+            // When integrating, replace this with:
+            //   return electrobun.ipc.invoke(command, args) as Promise<T>;
+            throw new Error(`[webtau/electrobun] No IPC bridge configured. ` +
+                `Cannot invoke "${command}". Wire electrobun.ipc.invoke() ` +
+                `into the core provider before calling bootstrapElectrobun().`);
+        },
+        convertFileSrc: (filePath, _protocol) => {
+            return `electrobun://asset/${filePath.replace(/^\/+/, "")}`;
+        },
+    };
+}
+/**
+ * Bootstrap all Electrobun adapters at once.
+ *
+ * Registers the core provider and sets adapters for window, event,
+ * filesystem, and dialog modules. After calling this function, all
+ * webtau module-level functions will delegate through Electrobun.
+ *
+ * An optional `coreProvider` can be passed to supply a custom IPC
+ * bridge (e.g. one that delegates to `electrobun.ipc.invoke()`).
+ *
+ * ```ts
+ * import { bootstrapElectrobun } from "webtau/adapters/electrobun";
+ *
+ * bootstrapElectrobun({
+ *   id: "electrobun",
+ *   invoke: (cmd, args) => electrobun.ipc.invoke(cmd, args),
+ *   convertFileSrc: (path) => `electrobun://asset/${path}`,
+ * });
+ * ```
+ */
+export function bootstrapElectrobun(coreProvider) {
+    registerProvider(coreProvider ?? createElectrobunCoreProvider());
+    setWindowAdapter(createElectrobunWindowAdapter());
+    setEventAdapter(createElectrobunEventAdapter());
+    setFsAdapter(createElectrobunFsAdapter());
+    setDialogAdapter(createElectrobunDialogAdapter());
+}
+//# sourceMappingURL=electrobun.js.map

package/dist/adapters/electrobun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electrobun.js","sourceRoot":"","sources":["../../src/adapters/electrobun.ts"],"names":[],"mappings":"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"}

package/dist/adapters/tauri.d.ts

@@ -0,0 +1,32 @@
+/**
+ * webtau/adapters/tauri — Tauri runtime adapter.
+ *
+ * Implements EventAdapter by delegating to @tauri-apps/api/event, giving
+ * Tauri the same deterministic listen/unlisten semantics as other runtimes.
+ *
+ * Usage:
+ * ```ts
+ * import { bootstrapTauri } from "webtau/adapters/tauri";
+ * bootstrapTauri();
+ * ```
+ */
+import type { CoreProvider, EventAdapter } from "../provider";
+export declare function createTauriEventAdapter(): EventAdapter;
+export declare function createTauriCoreProvider(): CoreProvider;
+/**
+ * Bootstrap all Tauri adapters at once.
+ *
+ * Registers the event adapter so that webtau's listen/emit route through
+ * Tauri's native IPC event system, ensuring backend-origin events are
+ * received by frontend listeners.
+ *
+ * An optional coreProvider can be passed to override the default Tauri
+ * core provider (useful for testing).
+ *
+ * ```ts
+ * import { bootstrapTauri } from "webtau/adapters/tauri";
+ * bootstrapTauri();
+ * ```
+ */
+export declare function bootstrapTauri(coreProvider?: CoreProvider): void;
+//# sourceMappingURL=tauri.d.ts.map

package/dist/adapters/tauri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tauri.d.ts","sourceRoot":"","sources":["../../src/adapters/tauri.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAwB9D,wBAAgB,uBAAuB,IAAI,YAAY,CAmBtD;AAOD,wBAAgB,uBAAuB,IAAI,YAAY,CAYtD;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAGhE"}

package/dist/adapters/tauri.js

@@ -0,0 +1,72 @@
+/**
+ * webtau/adapters/tauri — Tauri runtime adapter.
+ *
+ * Implements EventAdapter by delegating to @tauri-apps/api/event, giving
+ * Tauri the same deterministic listen/unlisten semantics as other runtimes.
+ *
+ * Usage:
+ * ```ts
+ * import { bootstrapTauri } from "webtau/adapters/tauri";
+ * bootstrapTauri();
+ * ```
+ */
+import { registerProvider } from "../core";
+import { setEventAdapter } from "../event";
+// ── Event Adapter ───────────────────────────────────────────────────────────
+// Wraps @tauri-apps/api/event listen/emit for use as webtau EventAdapter.
+// The id field on each dispatched event is the numeric listener id assigned
+// by Tauri's own IPC layer (tauriEvent.id).
+export function createTauriEventAdapter() {
+    return {
+        async listen(event, handler) {
+            // Dynamic import so @tauri-apps/api is only loaded at runtime in Tauri.
+            const mod = await import("@tauri-apps/api/event");
+            const unlisten = await mod.listen(event, (tauriEvent) => {
+                handler({ event: tauriEvent.event, id: tauriEvent.id, payload: tauriEvent.payload });
+            });
+            return unlisten;
+        },
+        async emit(event, payload) {
+            const mod = await import("@tauri-apps/api/event");
+            await mod.emit(event, payload);
+        },
+    };
+}
+// ── Core Provider ─────────────────────────────────────────────────────────────
+// Wraps @tauri-apps/api/core for explicit provider registration.
+// Prefer auto-detection (isTauri() path in invoke()) over explicit registration
+// unless you need to force Tauri mode or test with a mock provider.
+export function createTauriCoreProvider() {
+    return {
+        id: "tauri",
+        invoke: async (command, args) => {
+            const mod = await import("@tauri-apps/api/core");
+            return mod.invoke(command, args);
+        },
+        convertFileSrc: (filePath, protocol) => {
+            const proto = protocol ?? "asset";
+            return `${proto}://localhost${filePath.startsWith("/") ? filePath : `/${filePath}`}`;
+        },
+    };
+}
+// ── Bootstrap ─────────────────────────────────────────────────────────────────
+/**
+ * Bootstrap all Tauri adapters at once.
+ *
+ * Registers the event adapter so that webtau's listen/emit route through
+ * Tauri's native IPC event system, ensuring backend-origin events are
+ * received by frontend listeners.
+ *
+ * An optional coreProvider can be passed to override the default Tauri
+ * core provider (useful for testing).
+ *
+ * ```ts
+ * import { bootstrapTauri } from "webtau/adapters/tauri";
+ * bootstrapTauri();
+ * ```
+ */
+export function bootstrapTauri(coreProvider) {
+    registerProvider(coreProvider ?? createTauriCoreProvider());
+    setEventAdapter(createTauriEventAdapter());
+}
+//# sourceMappingURL=tauri.js.map

package/dist/adapters/tauri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tauri.js","sourceRoot":"","sources":["../../src/adapters/tauri.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAoB3C,+EAA+E;AAC/E,0EAA0E;AAC1E,4EAA4E;AAC5E,4CAA4C;AAE5C,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,KAAK,CAAC,MAAM,CAAI,KAAa,EAAE,OAAyB;YACtD,wEAAwE;YACxE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,uBAAiC,CAAqB,CAAC;YAChF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,CAC/B,KAAK,EACL,CAAC,UAAU,EAAE,EAAE;gBACb,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YACvF,CAAC,CACF,CAAC;YACF,OAAO,QAAsB,CAAC;QAChC,CAAC;QAED,KAAK,CAAC,IAAI,CAAI,KAAa,EAAE,OAAW;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,uBAAiC,CAAqB,CAAC;YAChF,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,iEAAiE;AACjE,gFAAgF;AAChF,oEAAoE;AAEpE,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,EAAE,EAAE,OAAO;QACX,MAAM,EAAE,KAAK,EAAe,OAAe,EAAE,IAA8B,EAAc,EAAE;YACzF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,sBAAgC,CAAoB,CAAC;YAC9E,OAAO,GAAG,CAAC,MAAM,CAAI,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,cAAc,EAAE,CAAC,QAAgB,EAAE,QAAiB,EAAU,EAAE;YAC9D,MAAM,KAAK,GAAG,QAAQ,IAAI,OAAO,CAAC;YAClC,OAAO,GAAG,KAAK,eAAe,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC;QACvF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,YAA2B;IACxD,gBAAgB,CAAC,YAAY,IAAI,uBAAuB,EAAE,CAAC,CAAC;IAC5D,eAAe,CAAC,uBAAuB,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/core.d.ts

@@ -13,6 +13,8 @@
  */
 import type { CoreProvider } from "./provider";
 export type { CoreProvider };
+export type { DiagnosticCode, DiagnosticEnvelope } from "./diagnostics";
+export { WebtauError } from "./diagnostics";
 type WasmModule = Record<string, (...args: any[]) => any>;
 export interface WebtauConfig {
     /**

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,YAAY,EAAE,YAAY,EAAE,CAAC;AAG7B,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;AAO1D,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAEpC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAOpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAE7D;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,IAAI,YAAY,GAAG,IAAI,CAEjD;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAKjC;AAyCD;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,OAAO,EACtC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAqCZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1E"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;AAO1D,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAEpC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAOpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAE7D;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,IAAI,YAAY,GAAG,IAAI,CAEjD;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAKjC;AAkDD;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,OAAO,EACtC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CA8EZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1E"}

package/dist/core.js

@@ -11,6 +11,8 @@
  * (e.g. Electrobun). When no provider is registered and `isTauri()`
  * is true, Tauri auto-registers itself on first invoke().
  */
+import { WebtauError } from "./diagnostics";
+export { WebtauError } from "./diagnostics";
 let registeredProvider = null;
 let wasmModule = null;
 let wasmLoader = null;
@@ -87,8 +89,13 @@ async function getWasmModule() {
     if (wasmLoadPromise)
         return wasmLoadPromise;
     if (!wasmLoader) {
-        throw new Error("[webtau] No WASM module configured. " +
-            'Call configure({ loadWasm: () => import("./wasm") }) before invoke().');
+        throw new WebtauError({
+            code: "NO_WASM_CONFIGURED",
+            runtime: "wasm",
+            command: "",
+            message: "[webtau] No WASM module configured.",
+            hint: 'Call configure({ loadWasm: () => import("./wasm") }) before invoke().',
+        });
     }
     wasmLoadPromise = wasmLoader().then((mod) => {
         wasmModule = mod;
@@ -98,7 +105,13 @@ async function getWasmModule() {
         // user fixes the issue (e.g. reconfigures with a valid loader).
         wasmLoadPromise = null;
         onLoadError(err);
-        throw err;
+        throw new WebtauError({
+            code: "LOAD_FAILED",
+            runtime: "wasm",
+            command: "",
+            message: `[webtau] Failed to load WASM module: ${err instanceof Error ? err.message : String(err)}`,
+            hint: "Check that loadWasm returns a valid WASM module and network is available.",
+        });
     });
     return wasmLoadPromise;
 }
@@ -117,7 +130,20 @@ async function getWasmModule() {
 export async function invoke(command, args) {
     // 1. Explicit provider — delegate immediately.
     if (registeredProvider) {
-        return registeredProvider.invoke(command, args);
+        try {
+            return await registeredProvider.invoke(command, args);
+        }
+        catch (err) {
+            if (err instanceof WebtauError)
+                throw err;
+            throw new WebtauError({
+                code: "PROVIDER_ERROR",
+                runtime: registeredProvider.id,
+                command,
+                message: err instanceof Error ? err.message : String(err),
+                hint: `Provider "${registeredProvider.id}" threw while invoking "${command}". Check the provider implementation.`,
+            });
+        }
     }
     // 2. Auto-detect Tauri — lazily register a Tauri provider, then delegate.
     if (isTauri()) {
@@ -136,12 +162,47 @@ export async function invoke(command, args) {
     const wasm = await getWasmModule();
     const fn = wasm[command];
     if (typeof fn !== "function") {
-        throw new Error(`[webtau] WASM module has no export named "${command}". ` +
-            `Available: ${Object.keys(wasm).filter((k) => typeof wasm[k] === "function").join(", ")}`);
+        const available = Object.keys(wasm).filter((k) => typeof wasm[k] === "function").join(", ");
+        throw new WebtauError({
+            code: "UNKNOWN_COMMAND",
+            runtime: "wasm",
+            command,
+            message: `[webtau] WASM module has no export named "${command}". Available: ${available}`,
+            hint: `Export "${command}" is not defined. Available exports: ${available}`,
+        });
+    }
+    try {
+        const result = args ? fn(args) : fn();
+        // wasm_bindgen can return plain values or promises
+        if (result instanceof Promise) {
+            try {
+                return await result;
+            }
+            catch (asyncErr) {
+                if (asyncErr instanceof WebtauError)
+                    throw asyncErr;
+                throw new WebtauError({
+                    code: "PROVIDER_ERROR",
+                    runtime: "wasm",
+                    command,
+                    message: asyncErr instanceof Error ? asyncErr.message : String(asyncErr),
+                    hint: `WASM command "${command}" rejected. Check the Rust implementation for errors.`,
+                });
+            }
+        }
+        return result;
+    }
+    catch (execErr) {
+        if (execErr instanceof WebtauError)
+            throw execErr;
+        throw new WebtauError({
+            code: "PROVIDER_ERROR",
+            runtime: "wasm",
+            command,
+            message: execErr instanceof Error ? execErr.message : String(execErr),
+            hint: `WASM command "${command}" threw an error. Check the Rust implementation.`,
+        });
     }
-    const result = args ? fn(args) : fn();
-    // wasm_bindgen can return plain values or promises
-    return result instanceof Promise ? result : result;
 }
 /**
  * Converts a file path to a URL that can be used to load assets.

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,28 @@
+/**
+ * webtau/diagnostics — Structured error envelope for all webtau failures.
+ *
+ * Every failure surface from invoke(), configure(), and provider paths
+ * throws a WebtauError instead of a plain Error, enabling callers to
+ * programmatically inspect and handle failure categories.
+ */
+export type DiagnosticCode = "NO_WASM_CONFIGURED" | "UNKNOWN_COMMAND" | "LOAD_FAILED" | "PROVIDER_ERROR" | "PROVIDER_MISSING";
+export interface DiagnosticEnvelope {
+    /** Machine-readable failure category. */
+    code: DiagnosticCode;
+    /** Which runtime path produced this error: "wasm", "tauri", "provider", or "unknown". */
+    runtime: string;
+    /** The command name that was invoked when the error occurred, if any. */
+    command: string;
+    /** Human-readable description of the failure. */
+    message: string;
+    /** Remediation hint for the developer. */
+    hint: string;
+}
+export declare class WebtauError extends Error implements DiagnosticEnvelope {
+    readonly code: DiagnosticCode;
+    readonly runtime: string;
+    readonly command: string;
+    readonly hint: string;
+    constructor(envelope: DiagnosticEnvelope);
+}
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,iBAAiB,GACjB,aAAa,GACb,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,IAAI,EAAE,cAAc,CAAC;IACrB,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,WAAY,SAAQ,KAAM,YAAW,kBAAkB;IAClE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,QAAQ,EAAE,kBAAkB;CAQzC"}

package/dist/diagnostics.js

@@ -0,0 +1,22 @@
+/**
+ * webtau/diagnostics — Structured error envelope for all webtau failures.
+ *
+ * Every failure surface from invoke(), configure(), and provider paths
+ * throws a WebtauError instead of a plain Error, enabling callers to
+ * programmatically inspect and handle failure categories.
+ */
+export class WebtauError extends Error {
+    code;
+    runtime;
+    command;
+    hint;
+    constructor(envelope) {
+        super(envelope.message);
+        this.name = "WebtauError";
+        this.code = envelope.code;
+        this.runtime = envelope.runtime;
+        this.command = envelope.command;
+        this.hint = envelope.hint;
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAiB;IACrB,OAAO,CAAS;IAChB,OAAO,CAAS;IAChB,IAAI,CAAS;IAEtB,YAAY,QAA4B;QACtC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/dist/task.d.ts

@@ -0,0 +1,89 @@
+/**
+ * webtau/task — Long-running task lifecycle API.
+ *
+ * Provides startTask/pollTask/cancelTask for non-blocking backend operations.
+ * Tasks are tracked internally; progress/completion are driven by invoke()
+ * resolution and the structured diagnostic envelope from diagnostics.ts.
+ *
+ * ```ts
+ * import { startTask, pollTask, cancelTask } from "webtau/task";
+ *
+ * const taskId = await startTask("process_save_data", { slot: 1 });
+ * const status = await pollTask(taskId);
+ * if (status.state === "completed") console.log(status.result);
+ * ```
+ */
+import { WebtauError } from "./diagnostics";
+export interface TaskProgress {
+    /** Completion percentage (0–100). Should be monotonically non-decreasing. */
+    percent: number;
+    /** Optional human-readable status message. */
+    message?: string;
+}
+export type TaskState<T> = {
+    state: "running";
+    progress?: TaskProgress;
+} | {
+    state: "completed";
+    result: T;
+} | {
+    state: "cancelled";
+} | {
+    state: "failed";
+    error: WebtauError;
+};
+export interface StartTaskOptions {
+    /**
+     * Called when cancelTask() is invoked for this task.
+     * Use this to propagate cancellation to the backend, e.g. by invoking
+     * a cancel command or aborting an in-flight request.
+     *
+     * ```ts
+     * const taskId = await startTask("heavy_op", { slot: 1 }, {
+     *   onCancel: () => invoke("cancel_heavy_op", { taskId }),
+     * });
+     * ```
+     */
+    onCancel?: () => void | Promise<void>;
+}
+/**
+ * Start a long-running backend task without blocking the caller.
+ *
+ * Launches `command` via invoke() and returns a taskId immediately.
+ * Use pollTask(taskId) to query current state and cancelTask(taskId) to
+ * signal cancellation before the task completes.
+ *
+ * The optional `options.onCancel` callback is invoked when cancelTask()
+ * is called, allowing the consumer to propagate cancellation to the
+ * backend (e.g. by invoking a cancel command).
+ */
+export declare function startTask<T>(command: string, args?: Record<string, unknown>, options?: StartTaskOptions): Promise<string>;
+/**
+ * Poll the current state of a task without blocking.
+ *
+ * Returns a Promise that resolves immediately with the current TaskState.
+ * Terminal states (completed, cancelled, failed) are permanent.
+ */
+export declare function pollTask<T>(taskId: string): Promise<TaskState<T>>;
+/**
+ * Signal cancellation for a running task.
+ *
+ * Idempotent: calling multiple times on the same taskId is safe.
+ * If the task has already completed, this is a no-op.
+ * If the task has not yet completed, the status transitions to "cancelled"
+ * and any future invoke() resolution is ignored.
+ *
+ * If `onCancel` was provided in startTask options, it is called to
+ * propagate cancellation to the backend. This ensures the backend
+ * can stop ongoing work rather than continuing to mutate state.
+ */
+export declare function cancelTask(taskId: string): Promise<void>;
+/**
+ * Update the progress of a running task.
+ * Useful for providers or test helpers that push intermediate progress.
+ * No-ops if the task is not in "running" state.
+ */
+export declare function updateTaskProgress(taskId: string, progress: TaskProgress): void;
+/** Clears all tracked tasks. Intended for test isolation. */
+export declare function resetTasks(): void;
+//# sourceMappingURL=task.d.ts.map

package/dist/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,IACnB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAE,GAC7C;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACjC;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,GACtB;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAeD;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAYvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa9D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAI/E;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

package/dist/task.js

@@ -0,0 +1,128 @@
+/**
+ * webtau/task — Long-running task lifecycle API.
+ *
+ * Provides startTask/pollTask/cancelTask for non-blocking backend operations.
+ * Tasks are tracked internally; progress/completion are driven by invoke()
+ * resolution and the structured diagnostic envelope from diagnostics.ts.
+ *
+ * ```ts
+ * import { startTask, pollTask, cancelTask } from "webtau/task";
+ *
+ * const taskId = await startTask("process_save_data", { slot: 1 });
+ * const status = await pollTask(taskId);
+ * if (status.state === "completed") console.log(status.result);
+ * ```
+ */
+import { invoke } from "./core";
+import { WebtauError } from "./diagnostics";
+const taskRegistry = new Map();
+let nextTaskId = 1;
+// ── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Start a long-running backend task without blocking the caller.
+ *
+ * Launches `command` via invoke() and returns a taskId immediately.
+ * Use pollTask(taskId) to query current state and cancelTask(taskId) to
+ * signal cancellation before the task completes.
+ *
+ * The optional `options.onCancel` callback is invoked when cancelTask()
+ * is called, allowing the consumer to propagate cancellation to the
+ * backend (e.g. by invoking a cancel command).
+ */
+export async function startTask(command, args, options) {
+    const taskId = `task-${nextTaskId++}`;
+    const entry = {
+        status: { state: "running" },
+        cancelled: false,
+        onCancel: options?.onCancel,
+    };
+    taskRegistry.set(taskId, entry);
+    invoke(command, args).then((result) => {
+        const current = taskRegistry.get(taskId);
+        if (current && !current.cancelled) {
+            current.status = { state: "completed", result };
+        }
+    }, (err) => {
+        const current = taskRegistry.get(taskId);
+        if (!current)
+            return;
+        if (current.cancelled) {
+            current.status = { state: "cancelled" };
+        }
+        else {
+            const webtauErr = err instanceof WebtauError
+                ? err
+                : new WebtauError({
+                    code: "PROVIDER_ERROR",
+                    runtime: "unknown",
+                    command,
+                    message: err instanceof Error ? err.message : String(err),
+                    hint: "Check the command implementation for errors.",
+                });
+            current.status = { state: "failed", error: webtauErr };
+        }
+    });
+    return taskId;
+}
+/**
+ * Poll the current state of a task without blocking.
+ *
+ * Returns a Promise that resolves immediately with the current TaskState.
+ * Terminal states (completed, cancelled, failed) are permanent.
+ */
+export async function pollTask(taskId) {
+    const entry = taskRegistry.get(taskId);
+    if (!entry) {
+        throw new WebtauError({
+            code: "UNKNOWN_COMMAND",
+            runtime: "unknown",
+            command: taskId,
+            message: `[webtau] No task with id "${taskId}".`,
+            hint: "Ensure startTask() was called and the taskId is correct.",
+        });
+    }
+    return entry.status;
+}
+/**
+ * Signal cancellation for a running task.
+ *
+ * Idempotent: calling multiple times on the same taskId is safe.
+ * If the task has already completed, this is a no-op.
+ * If the task has not yet completed, the status transitions to "cancelled"
+ * and any future invoke() resolution is ignored.
+ *
+ * If `onCancel` was provided in startTask options, it is called to
+ * propagate cancellation to the backend. This ensures the backend
+ * can stop ongoing work rather than continuing to mutate state.
+ */
+export async function cancelTask(taskId) {
+    const entry = taskRegistry.get(taskId);
+    if (!entry)
+        return;
+    if (entry.cancelled)
+        return;
+    entry.cancelled = true;
+    if (entry.status.state === "running") {
+        entry.status = { state: "cancelled" };
+    }
+    if (entry.onCancel) {
+        await entry.onCancel();
+    }
+}
+/**
+ * Update the progress of a running task.
+ * Useful for providers or test helpers that push intermediate progress.
+ * No-ops if the task is not in "running" state.
+ */
+export function updateTaskProgress(taskId, progress) {
+    const entry = taskRegistry.get(taskId);
+    if (!entry || entry.status.state !== "running")
+        return;
+    entry.status = { state: "running", progress };
+}
+/** Clears all tracked tasks. Intended for test isolation. */
+export function resetTasks() {
+    taskRegistry.clear();
+    nextTaskId = 1;
+}
+//# sourceMappingURL=task.js.map

package/dist/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webtau",
-  "version": "0.5.0-alpha.1",
+  "version": "0.5.0",
   "description": "Deploy Tauri games to web + desktop from one codebase",
   "license": "Apache-2.0",
   "repository": {
@@ -61,6 +61,18 @@
     "./provider": {
       "types": "./dist/provider.d.ts",
       "import": "./dist/provider.js"
+    },
+    "./adapters/electrobun": {
+      "types": "./dist/adapters/electrobun.d.ts",
+      "import": "./dist/adapters/electrobun.js"
+    },
+    "./adapters/tauri": {
+      "types": "./dist/adapters/tauri.d.ts",
+      "import": "./dist/adapters/tauri.js"
+    },
+    "./task": {
+      "types": "./dist/task.d.ts",
+      "import": "./dist/task.js"
     }
   },
   "files": [