ziex 0.1.0-dev.1259 → 0.1.0-dev.1360

package/README.md

@@ -8,37 +8,29 @@ Ziex combines the power and performance of Zig with the expressiveness and simpl
 
 **[Documentation →](https://ziex.dev/learn)**
 
-
 > **Note:** Most of the API and syntax are finalized and stable, and server-side rendering (SSR) features are production-ready, Ziex continues to evolve with ongoing improvements to client-side rendering and state management, see the [roadmap](#roadmap). You can start using the documented features today, as they are stable and unlikely to change. Areas still under development are not yet documented and will be added as they mature. See [versions](#versions) for Zig and Ziex versions compatibility.
 
-
 ## Getting Started
 
 ### 1. Installing CLI (optional)
 
-macOS/Linux
 ```bash
+# macOS/Linux
 curl -fsSL https://ziex.dev/install | bash
-```
-Windows
-```
+
+# Windows
 powershell -c "irm ziex.dev/install.ps1 | iex"
 ```
 
+
 ### 2. Initializing Project
+
 ```powershell
 zx init
 # or
 npm init ziex
 ```
 
-### 3. Running Project
-```powershell
-zx dev
-# or
-npm run dev
-```
-
 You will need [compatible](#versions) Zig version when using zx CLI or you can use the `Node` template from `npm init ziex`
 
 Read [Getting Started →](https://ziex.dev/learn) for more details.
@@ -159,6 +151,7 @@ const zx = @import("zx");
 </details>
 
 ## Features
+
 - **Declarative UI**: Declarative UI components using with full access to Zig's control flow.
 - **Full-Stack Capabilities**: Build both frontend and backend of web application.
 - **Fast**: Significantly faster at SSR than many other frameworks.
@@ -170,24 +163,27 @@ const zx = @import("zx");
 - **Developer Tooling**: CLI, hot reload, and editor extensions for the best DX.
 
 ## Versions
-| Zig         | Ziex                | Branch            | Status         |
-|-------------|---------------------|-------------------|----------------|
-| `0.17.x`    |                     | `zig-0.17`        | Development    |
-| `0.16.x`    | `0.1.0-dev.1068`-*  | `main`            | **Latest**     |
-| `0.15.x`    | `0.1.0-dev-1050`    | `zig-0.15`        | Latest (`Zig 0.15.x`)        |
 
+| Zig      | Ziex                                                                              | Branch     | Status      |
+| -------- | --------------------------------------------------------------------------------- | ---------- | ----------- |
+| `0.17.x` |                                                                                   | `main`     | Development |
+| `0.16.x` | [`0.1.0-dev.1259`](https://github.com/ziex-dev/ziex/releases/tag/v0.1.0-dev.1259) | `zig-0.16` | **Latest**  |
+| `0.15.x` | [`0.1.0-dev-1050`](https://github.com/ziex-dev/ziex/releases/tag/v0.1.0-dev.1050) | `zig-0.15` | Outdated    |
 
 ## Roadmap
-[Ziex 0.1.0](https://github.com/ziex-dev/ziex/milestone/2) is targeted after `Zig 0.17.0` release. You can see the [roadmap](https://github.com/ziex-dev/ziex/milestone) to learn more.
 
-`0.1.0` release will indicate that Ziex is production ready with all majore features fully baked and will receive patch releases for bug fixes.
+[Ziex 0.1.0](https://github.com/ziex-dev/ziex/milestone/2) is planned for release after `Zig 0.17.0` is available. You can view the [roadmap](https://github.com/ziex-dev/ziex/milestones) to learn more.
+
+The [`0.1.0`](https://github.com/ziex-dev/ziex/milestone/2) release will indicate that Ziex is production-ready, with all major features fully implemented, and will receive patch releases for bug fixes.
+
+The [`1.0.0`](https://github.com/ziex-dev/ziex/milestone/6) release will signify long-term support for that major version, receiving bug fixes and minor updates.
 
 ## Editor Support
 
-* [VSCode](https://marketplace.visualstudio.com/items?itemName=ziex.ziex)/[VSCode Forks](https://open-vsx.org/extension/ziex/ziex)
-* [Neovim](/ide/neovim/)
-* [Helix](/ide/helix/)
-* [Zed](/ide/zed/)
+- [VSCode](https://marketplace.visualstudio.com/items?itemName=ziex.ziex)/[VSCode Forks](https://open-vsx.org/extension/ziex/ziex)
+- [Neovim](/ide/neovim/)
+- [Helix](/ide/helix/)
+- [Zed](/ide/zed/)
 
 ## Community
 

package/cloudflare/index.js

@@ -193,6 +193,76 @@ class ZigJS {
     return decoder.decode(data);
   }
 }
+// src/fetch.ts
+function createFetchImports(getMemory) {
+  const encoder2 = new TextEncoder;
+  const decoder2 = new TextDecoder;
+  function readStr(ptr, len) {
+    return decoder2.decode(new Uint8Array(getMemory().buffer, ptr, len));
+  }
+  function writeBytes(buf_ptr, buf_max, data) {
+    if (data.length > buf_max)
+      return -2;
+    new Uint8Array(getMemory().buffer, buf_ptr, data.length).set(data);
+    return data.length;
+  }
+  function readBytes(ptr, len) {
+    return new Uint8Array(getMemory().buffer, ptr, len);
+  }
+  function parseHeaders(headersJson) {
+    let headers = {};
+    try {
+      headers = JSON.parse(headersJson);
+    } catch {
+      for (const line of headersJson.split(`
+`)) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx > 0) {
+          headers[line.slice(0, colonIdx)] = line.slice(colonIdx + 1);
+        }
+      }
+    }
+    return headers;
+  }
+  async function doFetch(url_ptr, url_len, method_ptr, method_len, headers_ptr, headers_len, body_ptr, body_len, timeout_ms, status_out, buf_ptr, buf_max) {
+    const url = readStr(url_ptr, url_len);
+    const method = method_len > 0 ? readStr(method_ptr, method_len) : "GET";
+    const headersJson = headers_len > 0 ? readStr(headers_ptr, headers_len) : "{}";
+    const body = body_len > 0 ? readBytes(body_ptr, body_len) : undefined;
+    const headers = parseHeaders(headersJson);
+    const controller = new AbortController;
+    const timeout = timeout_ms > 0 ? setTimeout(() => controller.abort(), timeout_ms) : null;
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: Object.keys(headers).length > 0 ? headers : undefined,
+        body: method !== "GET" && method !== "HEAD" ? body : undefined,
+        signal: controller.signal
+      });
+      if (timeout)
+        clearTimeout(timeout);
+      new DataView(getMemory().buffer).setUint16(status_out, response.status, true);
+      const bytes = new Uint8Array(await response.arrayBuffer());
+      return writeBytes(buf_ptr, buf_max, bytes);
+    } catch (err) {
+      if (timeout)
+        clearTimeout(timeout);
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`wasm fetch failed: ${url} (${msg})`);
+      return -1;
+    }
+  }
+  const Suspending = WebAssembly.Suspending;
+  if (typeof Suspending !== "function") {
+    return {
+      fetch: (_url_ptr, _url_len, _method_ptr, _method_len, _headers_ptr, _headers_len, _body_ptr, _body_len, _timeout_ms, _status_out, _buf_ptr, _buf_max) => -1
+    };
+  }
+  return {
+    fetch: new Suspending(doFetch)
+  };
+}
+
 // src/wasm/core.ts
 var CallbackType = {
   Event: 0,
@@ -291,7 +361,7 @@ class ZxBridgeCore {
     const url = readString(urlPtr, urlLen);
     const method = methodLen > 0 ? readString(methodPtr, methodLen) : "GET";
     const headersJson = headersLen > 0 ? readString(headersPtr, headersLen) : "{}";
-    const body = bodyLen > 0 ? readString(bodyPtr, bodyLen) : undefined;
+    const body = bodyLen > 0 ? getMemoryView().subarray(bodyPtr, bodyPtr + bodyLen) : undefined;
     let headers = {};
     try {
       headers = JSON.parse(headersJson);
@@ -315,8 +385,8 @@ class ZxBridgeCore {
     fetch(url, fetchOptions).then(async (response) => {
       if (timeout)
         clearTimeout(timeout);
-      const text = await response.text();
-      this._notifyFetchComplete(fetchId, response.status, text, false);
+      const bytes = new Uint8Array(await response.arrayBuffer());
+      this._notifyFetchComplete(fetchId, response.status, bytes, false);
     }).catch((error) => {
       if (timeout)
         clearTimeout(timeout);
@@ -327,7 +397,7 @@ class ZxBridgeCore {
   }
   _notifyFetchComplete(fetchId, statusCode, body, isError) {
     const handler = this.#fetchCompleteHandler;
-    const encoded = textEncoder.encode(body);
+    const encoded = typeof body === "string" ? textEncoder.encode(body) : body;
     const ptr = this._alloc(encoded.length);
     writeBytes(ptr, encoded);
     invokeWasmExport(handler, fetchId, statusCode, ptr, encoded.length, isError ? 1 : 0);
@@ -384,6 +454,11 @@ class ZxBridgeCore {
   static createImportObject(bridgeRef) {
     return {
       ...jsz.importObject(),
+      __zx_net: createFetchImports(() => {
+        if (!jsz.memory)
+          throw new Error("WASM memory is not ready");
+        return jsz.memory;
+      }),
       __zx: {
         _log: (level, ptr, len) => ZxBridgeCore.log(level, ptr, len),
         _fetchAsync: (urlPtr, urlLen, methodPtr, methodLen, headersPtr, headersLen, bodyPtr, bodyLen, timeoutMs, fetchId) => {
@@ -682,12 +757,12 @@ class ZxBridge extends ZxBridgeCore {
   clearEventHandlerModes(velementId) {
     eventHandlerModes.delete(velementId);
   }
-  submitFormActionAsync(form, statesJson, fetchId) {
+  submitFormActionAsync(form, actionId, statesJson, fetchId) {
     const formData = new FormData(form);
     formData.append("__$states", statesJson);
     fetch(window.location.href, {
       method: "POST",
-      headers: { "X-ZX-Action": "1" },
+      headers: { "x-action": String(actionId >>> 0) },
       body: formData
     }).then(async (response) => {
       const text = await response.text();
@@ -793,6 +868,11 @@ class ZxBridge extends ZxBridgeCore {
   static createImportObject(bridgeRef) {
     return {
       ...jsz.importObject(),
+      __zx_net: createFetchImports(() => {
+        if (!jsz.memory)
+          throw new Error("WASM memory is not ready");
+        return jsz.memory;
+      }),
       __zx: {
         _log: (level, ptr, len) => ZxBridgeCore.log(level, ptr, len),
         _setEventHandlerMode: (vnodeId, eventTypeId, maySuspend) => {
@@ -911,23 +991,23 @@ class ZxBridge extends ZxBridgeCore {
           writeBytes(bufPtr, bytes.subarray(0, len));
           return len;
         },
-        _submitFormAction: (vnodeId) => {
+        _submitFormAction: (vnodeId, actionId) => {
           const form = domNodes.get(vnodeId);
           if (!form || !(form instanceof HTMLFormElement))
             return;
           const formData = new FormData(form);
           fetch(window.location.href, {
             method: "POST",
-            headers: { "X-ZX-Action": "1" },
+            headers: { "x-action": String(actionId >>> 0) },
             body: formData
           }).catch(() => {});
         },
-        _submitFormActionAsync: (vnodeId, statesPtr, statesLen, fetchId) => {
+        _submitFormActionAsync: (vnodeId, actionId, statesPtr, statesLen, fetchId) => {
           const form = domNodes.get(vnodeId);
           if (!form || !(form instanceof HTMLFormElement))
             return;
           const statesJson = statesLen > 0 ? readString(statesPtr, statesLen) : "[]";
-          bridgeRef.current?.submitFormActionAsync(form, statesJson, fetchId);
+          bridgeRef.current?.submitFormActionAsync(form, actionId, statesJson, fetchId);
         }
       }
     };
@@ -1259,7 +1339,8 @@ async function init(options = {}) {
       domNodes.clear();
     }
   };
-  registerDevReinit(normalizedOptions);
+  if (true)
+    registerDevReinit(normalizedOptions);
   return { source, bridge };
 }
 
@@ -1324,7 +1405,7 @@ class ZxWasiBridge {
     const url = this.#readString(urlPtr, urlLen);
     const method = methodLen > 0 ? this.#readString(methodPtr, methodLen) : "GET";
     const headersJson = headersLen > 0 ? this.#readString(headersPtr, headersLen) : "{}";
-    const body = bodyLen > 0 ? this.#readString(bodyPtr, bodyLen) : undefined;
+    const body = bodyLen > 0 ? this.#view().subarray(bodyPtr, bodyPtr + bodyLen) : undefined;
     let headers = {};
     try {
       headers = JSON.parse(headersJson);
@@ -1346,7 +1427,8 @@ class ZxWasiBridge {
     }).then(async (res) => {
       if (timeout)
         clearTimeout(timeout);
-      this.#notifyFetchComplete(fetchId, res.status, await res.text(), false);
+      const bytes = new Uint8Array(await res.arrayBuffer());
+      this.#notifyFetchComplete(fetchId, res.status, bytes, false);
     }).catch((err) => {
       if (timeout)
         clearTimeout(timeout);
@@ -1355,7 +1437,7 @@ class ZxWasiBridge {
     });
   }
   #notifyFetchComplete(fetchId, status, body, isError) {
-    const encoded = encoder2.encode(body);
+    const encoded = typeof body === "string" ? encoder2.encode(body) : body;
     const ptr = this.#alloc(encoded.length);
     this.#writeBytes(ptr, encoded);
     this.#fetchCompleteHandler(fetchId, status, ptr, encoded.length, isError ? 1 : 0);
@@ -1562,7 +1644,9 @@ function createWasiImports({
     "--method",
     request.method,
     "--search",
-    url.search
+    url.search,
+    "--url",
+    url.href
   ];
   request.headers.forEach((value, name) => {
     if (value)
@@ -2015,6 +2099,7 @@ async function run({
     __zx_ws: buildWsImports(jspi ? Suspending : null, mem, new TextDecoder, wsState),
     __zx_kv: createKVImports(kvBindings ?? { default: createMemoryKV() }, mem),
     __zx_db: createD1Imports(dbBindings ?? {}, mem),
+    __zx_net: createFetchImports(mem),
     ...imports ? imports(mem) : {},
     ...ZxWasiBridge.createImportObject(bridgeRef)
   });
@@ -2189,6 +2274,7 @@ function createWebSocketDO(module, options) {
         __zx_ws: wsImports,
         __zx_kv: createKVImports(kvBindings ?? { default: createMemoryKV() }, mem),
         __zx_db: createD1Imports(dbBindings ?? {}, mem),
+        __zx_net: createFetchImports(mem),
         ...options?.imports ? options.imports(mem) : {},
         ...bridgeImports
       });

package/index.js

@@ -74,7 +74,7 @@ class ZxWasiBridge {
     const url = this.#readString(urlPtr, urlLen);
     const method = methodLen > 0 ? this.#readString(methodPtr, methodLen) : "GET";
     const headersJson = headersLen > 0 ? this.#readString(headersPtr, headersLen) : "{}";
-    const body = bodyLen > 0 ? this.#readString(bodyPtr, bodyLen) : undefined;
+    const body = bodyLen > 0 ? this.#view().subarray(bodyPtr, bodyPtr + bodyLen) : undefined;
     let headers = {};
     try {
       headers = JSON.parse(headersJson);
@@ -96,7 +96,8 @@ class ZxWasiBridge {
     }).then(async (res) => {
       if (timeout)
         clearTimeout(timeout);
-      this.#notifyFetchComplete(fetchId, res.status, await res.text(), false);
+      const bytes = new Uint8Array(await res.arrayBuffer());
+      this.#notifyFetchComplete(fetchId, res.status, bytes, false);
     }).catch((err) => {
       if (timeout)
         clearTimeout(timeout);
@@ -105,7 +106,7 @@ class ZxWasiBridge {
     });
   }
   #notifyFetchComplete(fetchId, status, body, isError) {
-    const encoded = encoder.encode(body);
+    const encoded = typeof body === "string" ? encoder.encode(body) : body;
     const ptr = this.#alloc(encoded.length);
     this.#writeBytes(ptr, encoded);
     this.#fetchCompleteHandler(fetchId, status, ptr, encoded.length, isError ? 1 : 0);
@@ -265,6 +266,76 @@ function createKVImports(bindings, getMemory) {
   };
 }
 
+// src/fetch.ts
+function createFetchImports(getMemory) {
+  const encoder2 = new TextEncoder;
+  const decoder2 = new TextDecoder;
+  function readStr(ptr, len) {
+    return decoder2.decode(new Uint8Array(getMemory().buffer, ptr, len));
+  }
+  function writeBytes(buf_ptr, buf_max, data) {
+    if (data.length > buf_max)
+      return -2;
+    new Uint8Array(getMemory().buffer, buf_ptr, data.length).set(data);
+    return data.length;
+  }
+  function readBytes(ptr, len) {
+    return new Uint8Array(getMemory().buffer, ptr, len);
+  }
+  function parseHeaders(headersJson) {
+    let headers = {};
+    try {
+      headers = JSON.parse(headersJson);
+    } catch {
+      for (const line of headersJson.split(`
+`)) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx > 0) {
+          headers[line.slice(0, colonIdx)] = line.slice(colonIdx + 1);
+        }
+      }
+    }
+    return headers;
+  }
+  async function doFetch(url_ptr, url_len, method_ptr, method_len, headers_ptr, headers_len, body_ptr, body_len, timeout_ms, status_out, buf_ptr, buf_max) {
+    const url = readStr(url_ptr, url_len);
+    const method = method_len > 0 ? readStr(method_ptr, method_len) : "GET";
+    const headersJson = headers_len > 0 ? readStr(headers_ptr, headers_len) : "{}";
+    const body = body_len > 0 ? readBytes(body_ptr, body_len) : undefined;
+    const headers = parseHeaders(headersJson);
+    const controller = new AbortController;
+    const timeout = timeout_ms > 0 ? setTimeout(() => controller.abort(), timeout_ms) : null;
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: Object.keys(headers).length > 0 ? headers : undefined,
+        body: method !== "GET" && method !== "HEAD" ? body : undefined,
+        signal: controller.signal
+      });
+      if (timeout)
+        clearTimeout(timeout);
+      new DataView(getMemory().buffer).setUint16(status_out, response.status, true);
+      const bytes = new Uint8Array(await response.arrayBuffer());
+      return writeBytes(buf_ptr, buf_max, bytes);
+    } catch (err) {
+      if (timeout)
+        clearTimeout(timeout);
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`wasm fetch failed: ${url} (${msg})`);
+      return -1;
+    }
+  }
+  const Suspending = WebAssembly.Suspending;
+  if (typeof Suspending !== "function") {
+    return {
+      fetch: (_url_ptr, _url_len, _method_ptr, _method_len, _headers_ptr, _headers_len, _body_ptr, _body_len, _timeout_ms, _status_out, _buf_ptr, _buf_max) => -1
+    };
+  }
+  return {
+    fetch: new Suspending(doFetch)
+  };
+}
+
 // src/db.ts
 function decodeBlob(base64) {
   const binary = atob(base64);
@@ -430,7 +501,9 @@ function createWasiImports({
     "--method",
     request.method,
     "--search",
-    url.search
+    url.search,
+    "--url",
+    url.href
   ];
   request.headers.forEach((value, name) => {
     if (value)
@@ -883,6 +956,7 @@ async function run({
     __zx_ws: buildWsImports(jspi ? Suspending : null, mem, new TextDecoder, wsState),
     __zx_kv: createKVImports(kvBindings ?? { default: createMemoryKV() }, mem),
     __zx_db: createD1Imports(dbBindings ?? {}, mem),
+    __zx_net: createFetchImports(mem),
     ...imports ? imports(mem) : {},
     ...ZxWasiBridge.createImportObject(bridgeRef)
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ziex",
-  "version": "0.1.0-dev.1259",
+  "version": "0.1.0-dev.1360",
   "description": "Ziex is a framework for building web applications with Zig.",
   "main": "index.js",
   "type": "module",
@@ -37,7 +37,7 @@
   "license": "MIT",
   "scripts": {},
   "dependencies": {
-    "@ziex/cli": "0.1.0-dev.1259"
+    "@ziex/cli": "0.1.0-dev.1360"
   },
   "peerDependenciesMeta": {
     "react": {

package/pkg/ziex/src/fetch.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Create a `fetch` import object for blocking WASM fetch via JSPI.
+ * When JSPI is unavailable the import always returns -1 (network error).
+ */
+export declare function createFetchImports(getMemory: () => WebAssembly.Memory): Record<string, unknown>;

package/{wasm → pkg/ziex/src/wasm}/core.d.ts

@@ -49,8 +49,8 @@ export declare class ZxBridgeCore {
      * Calls __zx_fetch_complete when done.
      */
     fetchAsync(urlPtr: number, urlLen: number, methodPtr: number, methodLen: number, headersPtr: number, headersLen: number, bodyPtr: number, bodyLen: number, timeoutMs: number, fetchId: bigint): void;
-    /** Notify WASM that a fetch completed */
-    protected _notifyFetchComplete(fetchId: bigint, statusCode: number, body: string, isError: boolean): void;
+    /** Notify WASM that a fetch completed. `body` is raw bytes on success, text on error. */
+    protected _notifyFetchComplete(fetchId: bigint, statusCode: number, body: string | Uint8Array, isError: boolean): void;
     /** Set a timeout and callback when it fires */
     setTimeout(callbackId: bigint, delayMs: number): void;
     /** Set an interval and callback each time it fires */

package/{wasm → pkg/ziex/src/wasm}/index.d.ts

@@ -14,7 +14,7 @@ export declare class ZxBridge extends ZxBridgeCore {
     setEventHandlerMode(velementId: bigint, eventTypeId: number, maySuspend: boolean): void;
     clearEventHandlerModes(velementId: bigint): void;
     /** Submit a form action with bound-state round-trip. */
-    submitFormActionAsync(form: HTMLFormElement, statesJson: string, fetchId: bigint): void;
+    submitFormActionAsync(form: HTMLFormElement, actionId: number, statesJson: string, fetchId: bigint): void;
     /**
      * Create and connect a WebSocket.
      * Calls __zx_ws_onopen, __zx_ws_onmessage, __zx_ws_onerror, __zx_ws_onclose.
@@ -58,6 +58,7 @@ export declare function init(options?: InitOptions): Promise<{
     bridge: ZxBridge;
 }>;
 declare global {
+    const __DEV__: boolean;
     interface HTMLElement {
         __zx_ref?: number;
     }

package/vendor/jsz/js/src/index.d.ts

@@ -0,0 +1 @@
+export * from './zigjs';

package/vendor/jsz/js/src/zigjs.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Predefined references.
+ * */
+export declare const predefined: {
+    nan: number;
+    null: number;
+    true: number;
+    false: number;
+    undefined: number;
+    globalThis: number;
+    runtime: number;
+};
+/**
+ * The main state.
+ * */
+export declare class ZigJS {
+    /**
+     * Set this to the memory of your WebAssembly instance prior to making
+     * any Wasm calls that might interface with JS.
+     *
+     * We have to use a Memory object directly (rather than an ArrayBuffer)
+     * so that we can always access memory even if it is resized. Otherwise,
+     * a resize could detach the array buffer.
+     * */
+    memory?: WebAssembly.Memory;
+    /**
+     * The values, indexed by ID (number). Duplicate values can be in this
+     * if they are loaded multiple times. That just acts as duplicate references.
+     * */
+    private values;
+    /**
+     * When a value is removed from the values array, its ID is put
+     * in the pool so that we can use it next. This avoids fragmentation in
+     * our array keys.
+     * */
+    private idPool;
+    /**
+     * Returns the import object that should be merged with your import
+     * object when instantiating your wasm instance. This injects the required
+     * functions into the wasm environment.
+     * */
+    importObject(): ImportObject;
+    /**
+     * Get a value from the JS environment.
+     * */
+    protected valueGet(out: number, id: number, ptr: number, len: number): void;
+    /**
+     * Set a value on an object.
+     * */
+    protected valueSet(id: number, ptr: number, len: number, refAddr: number): void;
+    /**
+     * Dereference a value, allowing the JS environment to potentially GC it.
+     * */
+    protected valueDeinit(id: number): void;
+    /**
+     * Create an empty object.
+     * */
+    protected valueObjectCreate(out: number): void;
+    /**
+     * Creates a string on the JS side from a UTF-8 encoded string in wasm memory.
+     * */
+    protected valueStringCreate(out: number, ptr: number, len: number): void;
+    /**
+     * Returns the length of the string given by id.
+     * */
+    protected valueStringLen(id: number): number;
+    /**
+     * Copy the string at id "id" into the shared memory at ptr.
+     * */
+    protected valueStringCopy(id: number, ptr: number, max: number): void;
+    /**
+     * Call a constructor given by id.
+     * */
+    protected valueNew(out: number, id: number, argsAddr: number, argsLen: number): void;
+    /**
+     * Call a function given by id.
+     * */
+    protected funcApply(out: number, id: number, thisRefAddr: number, argsAddr: number, argsLen: number): void;
+    /**
+     * This can be used to load a value given by an ID. A WASM function
+     * might return a value as an ID. This can be used to retrieve it.
+     * */
+    loadValue(id: number): any;
+    /**
+     * This removes the value from the values list and returns it. This
+     * will not remove predefined values but can still be used to retrieve
+     * them.
+     * */
+    deleteValue(id: number): any;
+    loadRef(refAddr: number): any;
+    loadRefId(refAddr: number): number;
+    storeValue(out: number, val: any): void;
+    loadString(ptr: number, len: number): string;
+}
+export interface ImportObject {
+    "zig-js": {
+        valueGet: (out: number, id: number, ptr: number, len: number) => void;
+        valueSet: (id: number, ptr: number, len: number, valueRef: number) => void;
+        valueObjectCreate: (out: number) => void;
+        valueStringCreate: (out: number, ptr: number, len: number) => void;
+        valueStringLen: (id: number) => number;
+        valueStringCopy: (id: number, ptr: number, max: number) => void;
+        valueDeinit: (id: number) => void;
+        valueNew: (out: number, funcId: number, argsPtr: number, argsLen: number) => void;
+        funcApply: (out: number, funcId: number, thisRef: number, argsPtr: number, argsLen: number) => void;
+    };
+}