@perspective-dev/client 4.4.0 → 4.5.0

package/dist/esm/perspective.browser.d.ts

@@ -7,6 +7,24 @@ export declare function createMessageHandler(handler: psp_virtual.VirtualServerH
 export declare function init_server(wasm: Uint8Array | Promise<ArrayBuffer | Response | WebAssembly.Module> | ArrayBuffer | Response | WebAssembly.Module, disable_stage_0?: boolean): void;
 export type PerspectiveWasm = ArrayBuffer | Response | typeof psp | Promise<ArrayBuffer | Response | Object>;
 export declare function init_client(wasm: PerspectiveWasm, disable_stage_0?: boolean): void;
+/**
+ * Returns the compiled `WebAssembly.Module` for the perspective-js client
+ * runtime. The module is structured-cloneable, so it can be sent via
+ * `postMessage` to a Worker which can instantiate its own `Client` without
+ * re-fetching or re-compiling the wasm binary.
+ *
+ * Requires that the client wasm has been initialized — typically by a prior
+ * call to `init_client(...)`, or implicitly by mounting a `<perspective-viewer>`
+ * element. Throws otherwise.
+ *
+ * # Examples
+ *
+ * ```javascript
+ * const mod = await perspective.getCompiledClientWasm();
+ * worker.postMessage({ kind: "init", clientWasm: mod }, [port]);
+ * ```
+ */
+export declare function getCompiledClientWasm(): Promise<WebAssembly.Module>;
 export declare function websocket(url: string | URL): Promise<psp.Client>;
 export declare function worker(worker?: Promise<SharedWorker | ServiceWorker | Worker | MessagePort>): Promise<psp.Client>;
 declare const _default: {
@@ -15,6 +33,7 @@ declare const _default: {
     init_client: typeof init_client;
     init_server: typeof init_server;
     createMessageHandler: typeof createMessageHandler;
+    getCompiledClientWasm: typeof getCompiledClientWasm;
     GenericSQLVirtualServerModel: typeof psp.GenericSQLVirtualServerModel;
     VirtualDataSlice: typeof psp.VirtualDataSlice;
     VirtualServer: typeof psp.VirtualServer;