feat: expose unwasm/examples

Author: pi0

.eslintignore

@@ -1,3 +1,4 @@
 node_modules
 coverage
 dist
+examples

README.md

@@ -34,30 +34,40 @@ WebAssembly modules that don't require any imports, can be imported simply like
 **Using static import:**
 
 ```js
-import { func } from "lib/module.wasm";
+import { sum } from "unwasm/examples/sum.wasm";
 ```
 
 **Using dynamic import:**
 
 ```js
-const { func } = await import("lib/module.wasm").then((mod) => mod.default);
+const { sum } = await import("unwasm/examples/sum.wasm").then(
+  (mod) => mod.default,
+);
 ```
 
 In case your WebAssembly module requires an import object (which is likely!), the usage syntax would be slightly different as we need to initate the module with an import object first.
 
 **Using static import with imports object:**
 
 ```js
-import { func, $init } from "lib/module.wasm";
+import { rand, $init } from "unwasm/examples/rand.wasm";
 
-await $init({ env: {} });
+await $init({
+  env: {
+    seed: () => () => Math.random() * Date.now(),
+  },
+});
 ```
 
 **Using dynamic import with imports object:**
 
 ```js
-const { func } = await import("lib/module.wasm").then((mod) =>
-  mod.$init({ env: {} }),
+const { rand } = await import("unwasm/examples/rand.wasm").then((mod) =>
+  mod.$init({
+    env: {
+      seed: () => () => Math.random() * Date.now(),
+    },
+  }),
 );
 ```
 

examples/.gitignore

@@ -0,0 +1,2 @@
+*.d.ts
+*.js

examples/build.mjs

@@ -0,0 +1,20 @@
+import { fileURLToPath } from "node:url";
+import { main as asc } from "assemblyscript/asc";
+
+async function compile(name) {
+  // https://www.assemblyscript.org/compiler.html#programmatic-usage
+  const res = await asc([`${name}.asc.ts`, "-o", `${name}.wasm`], {});
+
+  if (res.error) {
+    console.log(`Compilation failed for ${name}:`, res.error);
+    console.log(res.stderr.toString());
+  } else {
+    console.log(`Compiled: ${name}.wasm`);
+    console.log(res.stdout.toString());
+  }
+}
+
+process.chdir(fileURLToPath(new URL(".", import.meta.url)));
+
+await compile("sum");
+await compile("rand");

examples/rand.asc.ts

@@ -0,0 +1,5 @@
+// @ts-nocheck https://www.assemblyscript.org
+
+export function rand(min: f64, max: f64): f64 {
+  return Math.floor(Math.random() * (max - min + 1));
+}

test/node_modules/@fixture/wasm/dist/index.wasm renamed to examples/rand.wasm

@@ -0,0 +1,5 @@
+// @ts-nocheck https://www.assemblyscript.org
+
+export function sum(a: f64, b: f64): f64 {
+  return a + b;
+}

examples/sum.asc.ts

@@ -7,17 +7,20 @@
   "sideEffects": false,
   "type": "module",
   "exports": {
+    "./examples/*": "./examples/*",
     "./plugin": {
       "types": "./dist/plugin/index.d.mts",
       "import": "./dist/plugin/index.mjs"
     }
   },
   "files": [
     "dist",
-    "*.d.ts"
+    "*.d.ts",
+    "examples/*.wasm"
   ],
   "scripts": {
-    "build": "unbuild",
+    "build": "unbuild && pnpm build:examples",
+    "build:examples": "node ./examples/build.mjs",
     "dev": "vitest dev",
     "lint": "eslint --cache --ext .ts,.js,.mjs,.cjs . && prettier -c src test",
     "lint:fix": "eslint --cache --ext .ts,.js,.mjs,.cjs . --fix && prettier -c src test -w",
@@ -36,6 +39,7 @@
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@types/node": "^20.10.5",
     "@vitest/coverage-v8": "^1.1.0",
+    "assemblyscript": "^0.27.22",
     "changelogen": "^0.5.5",
     "eslint": "^8.56.0",
     "eslint-config-unjs": "^0.2.1",