vite-plugin-wat2wasm 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 osoclos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# vite-plugin-wat2wasm
+
+Enable `.wat` compilation and integrate generated WebAssembly modules into your codebase with type support
+
+## Installation
+
+``` bash
+$ <your-preferred-package-manager> install -D vite-plugin-wat2wasm
+```
+
+## Usage
+
+### Adding into your Vite configuration
+
+``` ts
+import { defineConfig } from "vite";
+import watVitePlugin from "vite-plugin-wat2wasm";
+
+export default defineConfig({
+    plugins: [
+        watVitePlugins(
+            { /* ...wasm features to include */ },
+            { /* ...wasm generation settings */ }
+        ),
+        /* ...other plugins */
+    ],
+
+    // ... other configuration settings
+});
+```
+
+### Adding types for import statements
+
+Reference it as a comment...
+
+``` ts
+/// <reference types="vite-plugin-wat2wasm/module-types" />
+```
+
+or include it in your `tsconfig.json` file
+
+``` json
+{
+    "include": ["src"],
+    "compilerOptions": {
+        "types": ["vite-plugin-wat2wasm/module-types", /* ... other type files/packages */]
+        // ... other options for Typescript
+    }
+}
+```
+
+### Using it in your application/library
+
+``` ts
+import initFoo from "./foo.wat"
+
+const bar = new WebAssembly.Global("i32");
+
+const foo = await initFoo<FooExports, FooImports>({
+    bar: { val: bar },
+
+    console: {
+        log(a: number) {
+            console.log(a);
+        }
+    }
+});
+
+console.log(foo.add(21, 46)); // returns 67
+foo.logBar();
+
+// In Typescript, you can also specify the types of your .wat file module.
+interface FooExports {
+    add(a: number, b: number): number;
+    logBar(): void;
+}
+
+interface FooImports {
+    bar: { val: WebAssembly.Global<"i32">; };
+    console: { log(a: number): void; };
+}
+```

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import initWabt from "wabt";
+import { Plugin } from "vite";
+
+//#region src/index.d.ts
+type WabtParserFunc = Awaited<ReturnType<typeof initWabt>>["parseWat"];
+type WasmParserOptions = Parameters<WabtParserFunc>[2];
+type WasmGeneratorOptions = Parameters<ReturnType<WabtParserFunc>["toBinary"]>[0];
+declare const watCompilerPlugin: (parserOptions?: WasmParserOptions, generatorOptions?: WasmGeneratorOptions) => Plugin;
+//#endregion
+export { watCompilerPlugin as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,11 @@
+import e from"fs";import t from"path";import n from"crypto";import r from"wabt";const i=/(^|\s)import\s+([A-Za-z_$][\w$]*)\s+from\s*['"]([^'"\n]*\.wat)['"](\s*;|$)/m,a=/(^|\s)import\s*\*\s*as\s+([A-Za-z_$][\w$]*)\s+from\s*['"]([^'"\n]*\.wat)[;"](\s*;|$)/m,o=/\.([mc]?[jt]sx?)$/i,s=await r();var c=(r={},c={})=>{let l=new Map,u=n=>{let i=t.basename(n,`.wat`),a=e.readFileSync(n,{encoding:`utf-8`});return s.parseWat(i,a,r).toBinary(c).buffer},d=async(e,r,i,a,o)=>{for(let s=r.match(a);s!==null;s=r.match(a)){s.index??=0;let a=s[3],c=(await e.resolve(a,i))?.id??null;if(c===null)continue;let d=u(c),f=n.createHash(`sha-256`);f.update(d);let p=f.digest(`base64url`).slice(0,8),m=t.basename(a,`.wat`)+`-`+p,h=t.dirname(a),g=t.posix.join(h,m+`.wasm`);l.has(g)||l.set(g,d);let _=s[2],v=s[1],y=s[4],b=s.index??0,x=b+s[0].length;r=r.slice(0,b)+v+o(g,_)+y+r.slice(x)}return r};return{name:`wat-compiler`,enforce:`post`,load(e){if(!e.endsWith(`.wat`))return null;let n=u(e),r=new TextDecoder(`utf-8`).decode(n).replaceAll("`","\\`").replaceAll(`
+`,`\\n`).replaceAll(`\r`,`\\r`);return`let hasInitialized = false;
+
+export default async function init(imports = {}) {
+    if (hasInitialized) throw new Error("Module at \\"${t.resolve(this.environment.config.base,e)}\\" has already been initialized!");
+    hasInitialized = true;
+
+    return WebAssembly.instantiate(new TextEncoder().encode(\`${r}\`), imports).then(({ instance: { exports } }) => exports);
+}
+`},async transform(e,t){return this.environment.mode!==`build`||!o.test(t)?null:(e=await d(this,e,t,i,(e,t)=>`const ${t} = async (imports) => WebAssembly.instantiateStreaming(fetch("${e}"), imports).then(({ instance: { exports } }) => exports);`),e=await d(this,e,t,a,(e,t)=>`const ${t} = { default: async (imports) => WebAssembly.instantiateStreaming(fetch("${e}"), imports).then(({ instance: { exports } }) => exports) };`),e)},generateBundle(){for(let[e,t]of l)this.emitFile({type:`asset`,fileName:e,source:t})}}};export{c as default};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["path"],"sources":["../src/index.ts"],"sourcesContent":["import fs from \"fs\";\r\nimport path from \"path\";\r\n\r\nimport crypto from \"crypto\";\r\n\r\nimport type { Plugin } from \"vite\";\r\nimport type { TransformPluginContext } from \"rolldown\";\r\n\r\nimport initWabt from \"wabt\";\r\n\r\nconst IMPORT_DEFAULT_REG = /(^|\\s)import\\s+([A-Za-z_$][\\w$]*)\\s+from\\s*['\"]([^'\"\\n]*\\.wat)['\"](\\s*;|$)/m;\r\nconst IMPORT_STAR_REG    = /(^|\\s)import\\s*\\*\\s*as\\s+([A-Za-z_$][\\w$]*)\\s+from\\s*['\"]([^'\"\\n]*\\.wat)[;\"](\\s*;|$)/m;\r\n\r\nconst JS_FILE_EXT_REG = /\\.([mc]?[jt]sx?)$/i;\r\n\r\nconst wabt = await initWabt();\r\n\r\ntype WabtParserFunc = Awaited<ReturnType<typeof initWabt>>[\"parseWat\"];\r\n\r\ntype WasmParserOptions = Parameters<WabtParserFunc>[2];\r\ntype WasmGeneratorOptions = Parameters<ReturnType<WabtParserFunc>[\"toBinary\"]>[0];\r\n\r\nconst watCompilerPlugin = (parserOptions: WasmParserOptions = {}, generatorOptions: WasmGeneratorOptions = {}): Plugin => {\r\n    const importedWatFiles = new Map<string, Uint8Array>();\r\n\r\n    const compileWat = (watPath: string): Uint8Array => {\r\n        const name = path.basename(watPath, \".wat\");\r\n        const textBfr = fs.readFileSync(watPath, { encoding: \"utf-8\" });\r\n\r\n        const module = wabt.parseWat(name, textBfr, parserOptions);\r\n        const bfr = module.toBinary(generatorOptions).buffer;\r\n\r\n        return bfr;\r\n    };\r\n\r\n    const transformImports = async (ctx: TransformPluginContext, code: string, codePath: string, statementReg: RegExp, replacement: (importPath: string, name: string) => string): Promise<string> => {\r\n        for (let match = code.match(statementReg); match !== null; match = code.match(statementReg)) {\r\n            match.index ??= 0;\r\n\r\n            const watRelPath = match[3];\r\n\r\n            const watAbsPath = (await ctx.resolve(watRelPath, codePath))?.id ?? null;\r\n            if (watAbsPath === null) continue;\r\n\r\n            const bfr = compileWat(watAbsPath);\r\n\r\n            const hasher = crypto.createHash(\"sha-256\");\r\n            hasher.update(bfr);\r\n\r\n            const hash = hasher.digest(\"base64url\").slice(0, 8);\r\n\r\n            const watName   = path.basename(watRelPath, \".wat\") + \"-\" + hash;\r\n            const watParent = path.dirname(watRelPath);\r\n\r\n            const wasmFilePath = path.posix.join(watParent, watName + \".wasm\");\r\n            if (!importedWatFiles.has(wasmFilePath)) importedWatFiles.set(wasmFilePath, bfr);\r\n\r\n            const importName = match[2];\r\n\r\n            const preSpacing = match[1];\r\n            const postSpacing = match[4];\r\n\r\n            const statementStart = match.index ?? 0;\r\n            const statementEnd = statementStart + match[0].length;\r\n\r\n            code = code.slice(0, statementStart) + preSpacing + replacement(wasmFilePath, importName) + postSpacing + code.slice(statementEnd);\r\n        }\r\n\r\n        return code;\r\n    };\r\n\r\n    return {\r\n        name: \"wat-compiler\",\r\n        enforce: \"post\",\r\n\r\n        load(id: string) {\r\n            if (!id.endsWith(\".wat\")) return null;\r\n\r\n            const bfr = compileWat(id);\r\n            const str = new TextDecoder(\"utf-8\").decode(bfr).replaceAll(\"`\", \"\\\\`\").replaceAll(\"\\n\", \"\\\\n\").replaceAll(\"\\r\", \"\\\\r\");\r\n\r\n            return (\r\n                \"let hasInitialized = false;\" + \"\\n\" +\r\n                \"\" + \"\\n\" +\r\n                \"export default async function init(imports = {}) {\" + \"\\n\" +\r\n                `    if (hasInitialized) throw new Error(\"Module at \\\\\"${path.resolve(this.environment.config.base, id)}\\\\\" has already been initialized!\");` + \"\\n\" +\r\n                \"    hasInitialized = true;\" + \"\\n\" +\r\n                \"\" + \"\\n\" +\r\n                `    return WebAssembly.instantiate(new TextEncoder().encode(\\`${str}\\`), imports).then(({ instance: { exports } }) => exports);` + \"\\n\" +\r\n                \"}\" + \"\\n\"\r\n            );\r\n        },\r\n\r\n        async transform(code: string, id: string) {\r\n            if (this.environment.mode !== \"build\" || !JS_FILE_EXT_REG.test(id)) return null;\r\n\r\n            code = await transformImports(this as any, code, id, IMPORT_DEFAULT_REG, (path, name) => `const ${name} = async (imports) => WebAssembly.instantiateStreaming(fetch(\"${path}\"), imports).then(({ instance: { exports } }) => exports);`);\r\n            code = await transformImports(this as any, code, id, IMPORT_STAR_REG   , (path, name) => `const ${name} = { default: async (imports) => WebAssembly.instantiateStreaming(fetch(\"${path}\"), imports).then(({ instance: { exports } }) => exports) };`);\r\n\r\n            return code;\r\n        },\r\n\r\n        generateBundle() {\r\n            for (const [distPath, bfr] of importedWatFiles)\r\n                this.emitFile({\r\n                    type: \"asset\",\r\n\r\n                    fileName: distPath,\r\n                    source: bfr\r\n                });\r\n        }\r\n    };\r\n};\r\n\r\nexport default watCompilerPlugin;\r\n"],"mappings":"gFAUA,MAAM,EAAqB,8EACrB,EAAqB,wFAErB,EAAkB,qBAElB,EAAO,MAAM,GAAU,CAmG7B,IAAA,GA5F2B,EAAmC,EAAE,CAAE,EAAyC,EAAE,GAAa,CACtH,IAAM,EAAmB,IAAI,IAEvB,EAAc,GAAgC,CAChD,IAAM,EAAO,EAAK,SAAS,EAAS,OAAO,CACrC,EAAU,EAAG,aAAa,EAAS,CAAE,SAAU,QAAS,CAAC,CAK/D,OAHe,EAAK,SAAS,EAAM,EAAS,EAAc,CACvC,SAAS,EAAiB,CAAC,QAK5C,EAAmB,MAAO,EAA6B,EAAc,EAAkB,EAAsB,IAA+E,CAC9L,IAAK,IAAI,EAAQ,EAAK,MAAM,EAAa,CAAE,IAAU,KAAM,EAAQ,EAAK,MAAM,EAAa,CAAE,CACzF,EAAM,QAAU,EAEhB,IAAM,EAAa,EAAM,GAEnB,GAAc,MAAM,EAAI,QAAQ,EAAY,EAAS,GAAG,IAAM,KACpE,GAAI,IAAe,KAAM,SAEzB,IAAM,EAAM,EAAW,EAAW,CAE5B,EAAS,EAAO,WAAW,UAAU,CAC3C,EAAO,OAAO,EAAI,CAElB,IAAM,EAAO,EAAO,OAAO,YAAY,CAAC,MAAM,EAAG,EAAE,CAE7C,EAAY,EAAK,SAAS,EAAY,OAAO,CAAG,IAAM,EACtD,EAAY,EAAK,QAAQ,EAAW,CAEpC,EAAe,EAAK,MAAM,KAAK,EAAW,EAAU,QAAQ,CAC7D,EAAiB,IAAI,EAAa,EAAE,EAAiB,IAAI,EAAc,EAAI,CAEhF,IAAM,EAAa,EAAM,GAEnB,EAAa,EAAM,GACnB,EAAc,EAAM,GAEpB,EAAiB,EAAM,OAAS,EAChC,EAAe,EAAiB,EAAM,GAAG,OAE/C,EAAO,EAAK,MAAM,EAAG,EAAe,CAAG,EAAa,EAAY,EAAc,EAAW,CAAG,EAAc,EAAK,MAAM,EAAa,CAGtI,OAAO,GAGX,MAAO,CACH,KAAM,eACN,QAAS,OAET,KAAK,EAAY,CACb,GAAI,CAAC,EAAG,SAAS,OAAO,CAAE,OAAO,KAEjC,IAAM,EAAM,EAAW,EAAG,CACpB,EAAM,IAAI,YAAY,QAAQ,CAAC,OAAO,EAAI,CAAC,WAAW,IAAK,MAAM,CAAC,WAAW;EAAM,MAAM,CAAC,WAAW,KAAM,MAAM,CAEvH,MACI;;;wDAGyD,EAAK,QAAQ,KAAK,YAAY,OAAO,KAAM,EAAG,CAAC;;;gEAGvC,EAAI;;GAK7E,MAAM,UAAU,EAAc,EAAY,CAMtC,OALI,KAAK,YAAY,OAAS,SAAW,CAAC,EAAgB,KAAK,EAAG,CAAS,MAE3E,EAAO,MAAM,EAAiB,KAAa,EAAM,EAAI,GAAqB,EAAM,IAAS,SAAS,EAAK,gEAAgEA,EAAK,4DAA4D,CACxO,EAAO,MAAM,EAAiB,KAAa,EAAM,EAAI,GAAqB,EAAM,IAAS,SAAS,EAAK,2EAA2EA,EAAK,8DAA8D,CAE9O,IAGX,gBAAiB,CACb,IAAK,GAAM,CAAC,EAAU,KAAQ,EAC1B,KAAK,SAAS,CACV,KAAM,QAEN,SAAU,EACV,OAAQ,EACX,CAAC,EAEb"}

package/dist/modules.d.ts

@@ -0,0 +1,6 @@
+declare module "*.wat" {
+    type ModuleObject = Record<string, any>;
+
+    export default function init<T extends ModuleObject = ModuleObject                             >(           ): Promise<T>;
+    export default function init<T extends ModuleObject = ModuleObject, I extends ModuleObject = {}>(imports : I): Promise<T>;
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+    "name": "vite-plugin-wat2wasm",
+    "type": "module",
+    "version": "1.0.0",
+    "description": "Enable .wat compilation and integrate generated WebAssembly modules into your codebase with type support",
+    "author": "osoclos",
+    "license": "MIT",
+    "homepage": "https://github.com/osoclos/vite-plugin-wat2wasm#readme",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/osoclos/vite-plugin-wat2wasm.git"
+    },
+    "bugs": {
+    "url": "https://github.com/osoclos/vite-plugin-wat2wasm/issues"
+},
+"main": "./dist/index.js",
+"module": "./dist/index.js",
+"types": "./dist/index.d.ts",
+"files": ["dist"],
+"exports": {
+    ".": "./dist/index.js",
+    "./module-types": "./dist/modules.d.ts",
+    "./package.json": "./package.json"
+},
+"scripts": {
+    "dev": "tsdown --watch && bun run scripts/post-build.ts",
+    "test": "vitest",
+    "build": "tsdown && bun run scripts/post-build.ts",
+    "prepublishOnly": "bun run build",
+    "check-types": "tsc --noEmit"
+},
+"dependencies": {
+"wabt": "^1.0.39"
+},
+"devDependencies": {
+    "@types/node": "^25.0.3",
+    "@vitest/browser-preview": "^4.0.17",
+    "bumpp": "^10.3.2",
+    "rolldown": "^1.0.0-beta.60",
+    "tsdown": "^0.18.3",
+    "typescript": "~5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.16"
+}
+}