@theaiplatform/miniapp-sdk 0.0.1 → 0.0.2

package/examples/wasm-ui/Cargo.lock

@@ -0,0 +1,248 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "bumpalo"
+version = "3.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72f5acc6cb2ba439de613abc23857ec3d78374d8ed5ac84e9d11336e87da8649"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "futures-core"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2cd50c473c80f6d7c3670a752354b8e569b1a7cbfdc0419ec88e5edad85e0dc7"
+
+[[package]]
+name = "futures-task"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b231ed28831efb4a61a08580c4bc233ec56bc009f4cd8f52da2c3cb97df0c109"
+
+[[package]]
+name = "futures-util"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a77a90a256fce34da66415271e30f94ee91c57b04b8a2c042d9cf3220179deaa"
+dependencies = [
+ "futures-core",
+ "futures-task",
+ "pin-project-lite",
+ "slab",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "js-sys"
+version = "0.3.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "53b44bfcdb3f8d5837a46dae1ca9660a837176eee74a28b229bc626816589102"
+dependencies = [
+ "cfg-if",
+ "futures-util",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "memchr"
+version = "2.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+
+[[package]]
+name = "miniapp-sdk-wasm-ui-example"
+version = "0.1.0"
+dependencies = [
+ "js-sys",
+ "serde",
+ "serde-wasm-bindgen",
+ "serde_json",
+ "wasm-bindgen",
+ "web-sys",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "pin-project-lite"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.46"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dfbc457d0c7a0759a614551b11a6409e5951f6c7537be1f1b7682b9ae9230368"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde-wasm-bindgen"
+version = "0.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8302e169f0eddcc139c70f139d19d6467353af16f9fce27e8c30158036a1e16b"
+dependencies = [
+ "js-sys",
+ "serde",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.150"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e8014e44b4736ed0538adeecded0fce2a272f22dc9578a7eb6b2d9993c74cfb9"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "slab"
+version = "0.4.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5"
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "wasm-bindgen"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4b067c0c11094aef6b7a801c1e34a26affafdf3d051dba08456b868789aaf9a4"
+dependencies = [
+ "cfg-if",
+ "once_cell",
+ "rustversion",
+ "wasm-bindgen-macro",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-macro"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "167ce5e579f6bcf889c4f7175a8a5a585de84e8ff93976ce393efa5f2837aab1"
+dependencies = [
+ "quote",
+ "wasm-bindgen-macro-support",
+]
+
+[[package]]
+name = "wasm-bindgen-macro-support"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f3997c7839262f4ef12cf90b818d6340c18e80f263f1a94bf157d0ec4420380e"
+dependencies = [
+ "bumpalo",
+ "proc-macro2",
+ "quote",
+ "syn",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-shared"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc1b4cb0cc549fcf58d7dfc081778139b3d283a081644e833e84682ad71cea24"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "web-sys"
+version = "0.3.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8622dcb61c0bcc9fffa6938bed81210af2da9a7e4a1a834b2e37a59b6dfb6141"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "zmij"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"

package/examples/wasm-ui/Cargo.toml

@@ -0,0 +1,18 @@
+[package]
+name = "miniapp-sdk-wasm-ui-example"
+version = "0.1.0"
+edition = "2024"
+publish = false
+
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[dependencies]
+js-sys = "0.3.98"
+serde = { version = "1.0.228", features = ["derive"] }
+serde-wasm-bindgen = "0.6.5"
+serde_json = "1.0.149"
+wasm-bindgen = "0.2.121"
+web-sys = { version = "0.3.98", features = ["Element"] }
+
+[workspace]

package/examples/wasm-ui/README.md

@@ -0,0 +1,19 @@
+# Rust/WASM UI example
+
+This crate is a clean wasm-bindgen consumer of
+`@theaiplatform/miniapp-sdk/ui/wasm`. It demonstrates the full lifecycle:
+mount, controlled revision updates, focus, action validation, replay/stale
+rejection, and idempotent teardown.
+
+Build it with:
+
+```bash
+cargo check --target wasm32-unknown-unknown
+```
+
+The JavaScript application that loads the generated wasm must import the SDK
+styles once:
+
+```ts
+import '@theaiplatform/miniapp-sdk/ui/styles.css';
+```

package/examples/wasm-ui/src/lib.rs

@@ -0,0 +1,190 @@
+//! Capability: miniapp-platform
+//!
+//! Clean wasm-bindgen consumer of `@theaiplatform/miniapp-sdk/ui/wasm`.
+
+use std::{
+    cell::{Cell, RefCell},
+    collections::HashSet,
+    rc::Rc,
+};
+
+use js_sys::Function;
+use serde::Deserialize;
+use serde_json::{Value, json};
+use wasm_bindgen::{JsCast, prelude::*};
+use web_sys::Element;
+
+#[wasm_bindgen(module = "@theaiplatform/miniapp-sdk/ui/wasm")]
+extern "C" {
+    type JsMiniAppUiRoot;
+
+    #[wasm_bindgen(js_name = createMiniAppUiRoot, catch)]
+    fn create_miniapp_ui_root(
+        container: &Element,
+        model: &JsValue,
+        dispatch: &Function,
+    ) -> Result<JsMiniAppUiRoot, JsValue>;
+
+    #[wasm_bindgen(method, catch)]
+    fn update(this: &JsMiniAppUiRoot, model: &JsValue) -> Result<(), JsValue>;
+
+    #[wasm_bindgen(method, catch)]
+    fn focus(this: &JsMiniAppUiRoot, control_id: &str) -> Result<(), JsValue>;
+
+    #[wasm_bindgen(method, catch)]
+    fn unmount(this: &JsMiniAppUiRoot) -> Result<(), JsValue>;
+}
+
+#[derive(Deserialize)]
+#[serde(rename_all = "camelCase")]
+struct UiAction {
+    event_id: String,
+    revision: u64,
+    control_id: String,
+    action: String,
+}
+
+fn js_error(message: impl AsRef<str>) -> JsValue {
+    js_sys::Error::new(message.as_ref()).into()
+}
+
+fn model(revision: u64, name: &str, busy: bool) -> Value {
+    json!({
+        "revision": revision,
+        "state": if busy { "loading" } else { "idle" },
+        "rootIds": ["layout"],
+        "nodes": [
+            {
+                "type": "stack",
+                "id": "layout",
+                "gap": "md",
+                "children": ["title", "name", "run", "status"]
+            },
+            {
+                "type": "heading",
+                "id": "title",
+                "level": 1,
+                "text": "Rust/WASM mini-app"
+            },
+            {
+                "type": "input",
+                "id": "name",
+                "label": "Name",
+                "value": name,
+                "action": "name.change",
+                "required": true,
+                "disabled": false,
+                "busy": false,
+                "inputType": "text"
+            },
+            {
+                "type": "button",
+                "id": "run",
+                "label": if busy { "Running…" } else { "Run" },
+                "action": "run",
+                "variant": "default",
+                "disabled": busy,
+                "busy": busy
+            },
+            {
+                "type": "status-bar",
+                "id": "status",
+                "tone": "neutral",
+                "text": "All UI state is controlled by Rust."
+            }
+        ]
+    })
+}
+
+/// Mounted SDK UI retained by Rust. The closure field keeps the JS dispatcher
+/// alive for exactly the lifetime of the imperative root.
+#[wasm_bindgen]
+pub struct MiniApp {
+    root: Option<JsMiniAppUiRoot>,
+    _dispatch: Closure<dyn FnMut(JsValue) -> Result<(), JsValue>>,
+    revision: Rc<Cell<u64>>,
+}
+
+#[wasm_bindgen]
+impl MiniApp {
+    /// Mounts the initial controlled model and installs replay/stale checks on
+    /// every action delivered back from JavaScript.
+    pub fn mount(container: Element) -> Result<MiniApp, JsValue> {
+        let revision = Rc::new(Cell::new(1_u64));
+        let dispatch_revision = Rc::clone(&revision);
+        let received_event_ids = Rc::new(RefCell::new(HashSet::<String>::new()));
+        let dispatch_event_ids = Rc::clone(&received_event_ids);
+        let dispatch =
+            Closure::<dyn FnMut(JsValue) -> Result<(), JsValue>>::new(move |value: JsValue| {
+                let action: UiAction = serde_wasm_bindgen::from_value(value)
+                    .map_err(|error| js_error(format!("Malformed SDK UI action: {error}")))?;
+                if action.revision != dispatch_revision.get() {
+                    return Err(js_error(format!(
+                        "Rejected stale action revision {} for current revision {}",
+                        action.revision,
+                        dispatch_revision.get()
+                    )));
+                }
+                if !dispatch_event_ids
+                    .borrow_mut()
+                    .insert(action.event_id.clone())
+                {
+                    return Err(js_error(format!("Rejected replayed action {}", action.event_id)));
+                }
+
+                // A real mini-app routes the validated action into its Rust
+                // reducer. Reading these fields demonstrates that no React
+                // callback or host object crosses the ABI.
+                let _action_target = (&action.control_id, &action.action);
+                Ok(())
+            });
+        let initial_model = serde_wasm_bindgen::to_value(&model(1, "Ada", false))
+            .map_err(|error| js_error(format!("Could not serialize initial model: {error}")))?;
+        let root =
+            create_miniapp_ui_root(&container, &initial_model, dispatch.as_ref().unchecked_ref())?;
+
+        Ok(MiniApp {
+            root: Some(root),
+            _dispatch: dispatch,
+            revision,
+        })
+    }
+
+    /// Replaces controlled state with a newer model revision.
+    pub fn update(&self, revision: u64, name: &str, busy: bool) -> Result<(), JsValue> {
+        let root = self
+            .root
+            .as_ref()
+            .ok_or_else(|| js_error("The mini-app UI is unmounted"))?;
+        let next_model = serde_wasm_bindgen::to_value(&model(revision, name, busy))
+            .map_err(|error| js_error(format!("Could not serialize updated model: {error}")))?;
+        root.update(&next_model)?;
+        self.revision.set(revision);
+        Ok(())
+    }
+
+    /// Focuses a stable control identifier and maps JavaScript exceptions into
+    /// a normal Rust `Result`.
+    pub fn focus(&self, control_id: &str) -> Result<(), JsValue> {
+        self.root
+            .as_ref()
+            .ok_or_else(|| js_error("The mini-app UI is unmounted"))?
+            .focus(control_id)
+    }
+
+    /// Releases the UI root. Repeated calls are intentionally harmless.
+    pub fn unmount(&mut self) -> Result<(), JsValue> {
+        if let Some(root) = self.root.take() {
+            root.unmount()?;
+        }
+        Ok(())
+    }
+}
+
+impl Drop for MiniApp {
+    fn drop(&mut self) {
+        if let Some(root) = self.root.take() {
+            let _ = root.unmount();
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theaiplatform/miniapp-sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Public SDK for building portable miniapps that run in The AI Platform.",
   "type": "module",
   "engines": {
@@ -23,6 +23,10 @@
       "types": "./dist/sdk.d.ts",
       "import": "./dist/sdk.js"
     },
+    "./mcp": {
+      "types": "./dist/mcp.d.ts",
+      "import": "./dist/mcp.js"
+    },
     "./web": {
       "types": "./dist/web.d.ts",
       "import": "./dist/web.js"
@@ -31,6 +35,10 @@
       "types": "./dist/ui.d.ts",
       "import": "./dist/ui.js"
     },
+    "./ui/wasm": {
+      "types": "./dist/ui/wasm.d.ts",
+      "import": "./dist/ui/wasm.js"
+    },
     "./ui/styles.css": "./dist/ui/styles.css",
     "./ui/tailwind.css": "./dist/ui/tailwind.css",
     "./ui-components.json": "./ui-components.json",
@@ -52,6 +60,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "examples",
     "config-schema.json",
     "ui-components.json",
     "README.md",
@@ -106,7 +115,11 @@
     "@rslib/core": "^0.23.2",
     "@rstest/core": "^0.9.10",
     "@tailwindcss/postcss": "^4.3.0",
+    "@types/jsdom": "^28.0.3",
     "@types/node": "^25.7.0",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "jsdom": "^29.1.1",
     "postcss": "^8.5.6",
     "tailwindcss": "^4.3.0",
     "tw-animate-css": "^1.4.0",
@@ -114,6 +127,7 @@
   },
   "dependencies": {
     "@radix-ui/react-alert-dialog": "^1.1.15",
+    "@radix-ui/react-avatar": "1.1.11",
     "@radix-ui/react-checkbox": "^1.3.3",
     "@radix-ui/react-compose-refs": "^1.1.2",
     "@radix-ui/react-dialog": "^1.1.15",
@@ -136,7 +150,8 @@
     "prism-react-renderer": "^2.4.1",
     "react-resizable-panels": "^4.11.1",
     "saxes": "^6.0.0",
-    "tailwind-merge": "^3.6.0"
+    "tailwind-merge": "^3.6.0",
+    "zod": "^4.4.3"
   },
   "scripts": {
     "build": "rm -rf dist && rslib build && node scripts/copy-rspack-loaders.mjs && node scripts/build-ui-styles.mjs",

package/ui-components.json

@@ -8,6 +8,7 @@
   },
   "groups": {
     "foundations": [
+      "Avatar",
       "Badge",
       "Button",
       "ButtonGroup",
@@ -20,7 +21,8 @@
       "Icon",
       "Progress",
       "Separator",
-      "Skeleton"
+      "Skeleton",
+      "StatusIndicator"
     ],
     "layout": [
       "Alert",
@@ -51,6 +53,9 @@
     "miniapp": [
       "CodeBlock",
       "MiniAppIconButton",
+      "MiniAppMetric",
+      "MiniAppPageHeader",
+      "MiniAppSectionHeader",
       "MiniAppStatusBar",
       "MiniAppToolbar"
     ],