feat(cli): add wasm.browser.asyncInit for large wasm file (#2514)

Author: hi-ogawa

cli/src/api/build.ts

@@ -963,6 +963,7 @@ class Builder {
           this.config.wasm?.initialMemory,
           this.config.wasm?.maximumMemory,
           this.config.wasm?.browser?.fs,
+          this.config.wasm?.browser?.asyncInit,
         ) +
           idents
             .map(

cli/src/api/templates/load-wasi-template.ts

@@ -3,6 +3,7 @@ export const createWasiBrowserBinding = (
   initialMemory = 4000,
   maximumMemory = 65536,
   fs = false,
+  asyncInit = false,
 ) => {
   const fsImport = fs ? `import { memfs } from '@napi-rs/wasm-runtime/fs'` : ''
   const wasiCreation = fs
@@ -25,8 +26,15 @@ const __wasi = new __WASI({
     ? `    worker.addEventListener('message', __wasmCreateOnMessageForFsProxy(__fs))\n`
     : ''
 
+  const emnapiInstantiateImport = asyncInit
+    ? `instantiateNapiModule as __emnapiInstantiateNapiModule`
+    : `instantiateNapiModuleSync as __emnapiInstantiateNapiModuleSync`
+  const emnapiInstantiateCall = asyncInit
+    ? `await __emnapiInstantiateNapiModule`
+    : `__emnapiInstantiateNapiModuleSync`
+
   return `import {
-  instantiateNapiModuleSync as __emnapiInstantiateNapiModuleSync,
+  ${emnapiInstantiateImport},
   getDefaultContext as __emnapiGetDefaultContext,
   WASI as __WASI,
   createOnMessage as __wasmCreateOnMessageForFsProxy,
@@ -49,7 +57,7 @@ const {
   instance: __napiInstance,
   module: __wasiModule,
   napiModule: __napiModule,
-} = __emnapiInstantiateNapiModuleSync(__wasmFile, {
+} = ${emnapiInstantiateCall}(__wasmFile, {
   context: __emnapiContext,
   asyncWorkPoolSize: 4,
   wasi: __wasi,

cli/src/utils/config.ts

@@ -75,6 +75,10 @@ export interface UserNapiConfig {
        * Whether to use fs module in browser
        */
       fs?: boolean
+      /**
+       * Whether to initialize wasm asynchronously
+       */
+      asyncInit?: boolean
     }
   }