@runmu.sh/ext-wasm-add 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 1.0.0
+
+- Its own repository, [runmu-sh/ext-wasm-add](https://github.com/runmu-sh/ext-wasm-add), made with `npm create @runmu.sh/extension` and published to the marketplace from its version tags. The package is `@runmu.sh/ext-wasm-add`, built against `@runmu.sh/sdk` from npm. Nothing changes in the extension itself.
+
+## 0.1.0
+
+- First version.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 runmu.sh
+
+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,31 @@
+# WASM Add (`@runmu.sh/ext-wasm-add`)
+
+The example for `mu.wasm.load` (SDK 1.3, <https://runmu.sh/docs/extensions/wasm>). Install it from
+**☰ → Extensions → Discover** ([marketplace listing](https://runmu.sh/marketplace/x/wasm-add)).
+
+- `wasm/add.wat` is the source of `wasm/add.wasm` (41 bytes, one exported `add(i32, i32) → i32`). The binary
+  is committed, so the build needs no `wat2wasm` or Rust toolchain.
+- `package.json` lists it in `muclient.wasm` with its sha256, and `files` includes `wasm/`, so it ships in the
+  package. μClient refuses bytes that do not match that hash, pins it at install and re-checks it on every load.
+- `activate` awaits `mu.wasm.load('wasm/add.wasm')`, then registers a panel that calls `add`.
+
+## Commands
+```sh
+npm install
+npm run build        # dist/index.js + manifest check
+npm run typecheck    # tsc --noEmit against the SDK types
+npm run dev          # dev server on http://localhost:5199/ with hot reload
+```
+
+After editing `add.wat`, rebuild the binary (`wat2wasm wasm/add.wat -o wasm/add.wasm`) and put its new sha256
+in `muclient.wasm`.
+
+## Publish
+This repository is linked to the marketplace listing [wasm-add](https://runmu.sh/marketplace/x/wasm-add): a
+version tag is imported within seconds (webhook), or within 30 minutes (poll).
+
+```sh
+npm run build && git commit -am "WASM Add x.y.z" && git tag vx.y.z && git push origin main vx.y.z
+```
+
+Versions are immutable.

package/dist/index.js

@@ -0,0 +1,43 @@
+// src/index.ts
+import { defineExtension } from "@muclient/sdk";
+var index_default = defineExtension({
+  async activate(ctx) {
+    const mu = ctx.mu;
+    const { exports } = await mu.wasm.load("wasm/add.wasm");
+    const add = exports.add;
+    const c = mu.ui.css;
+    mu.panels.register({
+      id: "wasm-add",
+      title: "WASM add",
+      defaultPosition: "right-bottom",
+      mount(el) {
+        el.style.cssText = "display:flex;flex-direction:column;gap:6px;padding:8px 10px;font-size:var(--t-body, .8rem)";
+        el.innerHTML = `
+          <div class="${c.secHead}">add(a, b) in WebAssembly</div>
+          <form data-testid="wa-form" style="display:flex;gap:6px;align-items:center">
+            <input class="${c.inp}" name="a" value="2" inputmode="numeric" aria-label="a" style="width:5em" />
+            <span>+</span>
+            <input class="${c.inp}" name="b" value="40" inputmode="numeric" aria-label="b" style="width:5em" />
+            <button class="${c.tool}" type="submit">=</button>
+            <output data-testid="wa-result" class="${c.glow}"></output>
+          </form>`;
+        const form = el.querySelector("form");
+        const out = el.querySelector("[data-testid=wa-result]");
+        const run = () => {
+          const v = (n) => Number(form.elements.namedItem(n).value) | 0;
+          out.textContent = String(add(v("a"), v("b")));
+        };
+        form.onsubmit = (e) => {
+          e.preventDefault();
+          run();
+        };
+        run();
+      }
+    });
+    mu.log.info("add(2, 40) =", add(2, 40));
+    return { add };
+  }
+});
+export {
+  index_default as default
+};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@runmu.sh/ext-wasm-add",
+  "version": "1.0.0",
+  "description": "The mu.wasm.load example: a panel that calls add(a, b) in a 41-byte hand-written WebAssembly module (wasm/add.wat), pinned by sha256 in muclient.wasm.",
+  "keywords": [
+    "muclient-extension"
+  ],
+  "license": "MIT",
+  "homepage": "https://runmu.sh/marketplace/x/wasm-add",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/runmu-sh/ext-wasm-add.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runmu-sh/ext-wasm-add/issues"
+  },
+  "type": "module",
+  "exports": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "wasm"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "dev": "node scripts/dev.mjs",
+    "typecheck": "tsc --noEmit",
+    "check": "node scripts/build.mjs --check"
+  },
+  "devDependencies": {
+    "@muclient/sdk": "npm:@runmu.sh/sdk@^1.6.0",
+    "@runmu.sh/dev": "^0.1.0",
+    "esbuild": "^0.28.2",
+    "typescript": "^5.9.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "muclient": {
+    "id": "wasm-add",
+    "api": "^1.3",
+    "source": "src/index.ts",
+    "displayName": "WASM Add",
+    "description": "The mu.wasm.load example: a panel that calls add(a, b) in a 41-byte hand-written WebAssembly module (wasm/add.wat), pinned by sha256 in muclient.wasm.",
+    "contributes": {
+      "panels": [
+        {
+          "id": "wasm-add",
+          "title": "WASM add"
+        }
+      ]
+    },
+    "capabilities": [],
+    "wasm": {
+      "wasm/add.wasm": "f61fd62f57c41269c3c23f360eeaf1090b1db9c38651106674d48bc65dba88ba"
+    },
+    "publisher": "bitmuse"
+  }
+}

package/wasm/add.wat

@@ -0,0 +1,8 @@
+;; The source of add.wasm (41 bytes, committed as a binary: the host has no wat2wasm/Rust toolchain).
+;; Rebuild with `wat2wasm add.wat -o add.wasm`, then update the sha256 in ../package.json (the build
+;; refuses a mismatch).
+(module
+  (func (export "add") (param i32 i32) (result i32)
+    local.get 0
+    local.get 1
+    i32.add))