feat: add wasm playground (#8)

* feat: add wasm playground

* fix

* fix: track wasm artifacts with lfs

* fix: include wasm package glue for pages

* fix: include wasm package js in tsconfig

Author: lollipopkit

.gitattributes

@@ -0,0 +1 @@
+*.wasm filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -11,6 +11,7 @@ vsc-ext/*/node_modules/
 vsc-ext/*/*.vsix
 website/node_modules/
 website/dist/
+website/src/wasm/pkg/.gitignore
 
 lk-lsp-debug.log
 main

Cargo.lock

@@ -5,6 +5,7 @@ members = [
     "completion",
     "stdlib",
     "stdlib/common",
+    "stdlib/web",
     "stdlib/crates/bytes",
     "stdlib/crates/chan",
     "stdlib/crates/datetime",
@@ -31,6 +32,7 @@ members = [
     "lkrt",
     "lsp",
     "tree-sitter-lk",
+    "wasm",
 ]
 resolver = "2"
 
@@ -75,6 +77,9 @@ arcstr = { version = "1", features = ["serde"] }
 ureq = "2"
 url = "2"
 uuid = { version = "1", features = ["v4"] }
+wasm-bindgen = "0.2"
+serde-wasm-bindgen = "0.6"
+js-sys = "0.3"
 
 [profile.release]
 panic = "abort"

Cargo.toml

@@ -46,6 +46,7 @@ Run any example: `lk examples/syntax/closure.lk`
 
 - Rust-inspired syntax with first-class named parameters
 - Deterministic bytecode VM with optional concurrency runtime
+- Browser-playground wasm facade with a safe stdlib subset
 - Batteries-included standard library and LSP-backed tooling
 - Project website source lives in `website/` and powers [lang.lollipopkit.com](https://lang.lollipopkit.com).
 
@@ -87,6 +88,19 @@ assert_eq!(result.display_first_return(), "true");
 
 Note: command-line paths must be relative and sanitized.
 
+#### Website and wasm playground
+
+The website lives in `website/` and includes a `/try` route that lazy-loads the LK wasm runtime.
+
+```bash
+cd website
+bun run build
+```
+
+For local development, `bun run build` runs `website/scripts/build-wasm.mjs`, which invokes `wasm-pack build ../wasm --target web --out-dir ../website/src/wasm/pkg --release`, then regenerates i18n types and builds the Vite app. In that workflow, `website/src/wasm/pkg/` is generated output, is typically ignored, and should not be committed. Cloudflare prebuilt/deployment branches use the checked-in wasm package instead (see `website/scripts/build-wasm.mjs`), so the checked-in `website/src/wasm/pkg/` artifacts must be retained on those branches. Workflow summary: local development regenerates and ignores `pkg/`; deployment/Cloudflare prebuild uses retained or CI-produced wasm artifacts.
+
+The browser playground supports single-file execution with stdout capture, return-value display, parse/runtime diagnostics, and an instruction step limit. It intentionally exposes only the browser-safe stdlib subset; native modules such as `fs`, `io`, `net`, `process`, `env`, `os`, `task`, and `chan` are reported as unavailable in the browser.
+
 #### VS Code
 
 The VS Code support is a single merged extension under `vsc-ext/lsp`. It includes `.lk` language registration, TextMate highlighting, snippets, and the LK LSP client with smart completion for stdlib modules, imported aliases, local symbols, named arguments, and common receiver methods. Use `make debug-lsp-ext` for a local Extension Development Host, or `make vsix` to build the VSIX.

README.md

@@ -38,6 +38,11 @@ examples/
 
 ## 特性
 
+- 类 Rust 语法，支持一等 named parameters
+- 确定性的 bytecode VM，并可选启用并发运行时
+- 可编译到浏览器 wasm 的 playground facade，内置安全标准库子集
+- 标准库、CLI、LSP 与官网源码都在同一仓库内维护
+
 ### 用法
 
 #### 集成（库）
@@ -74,6 +79,19 @@ assert_eq!(result.display_first_return(), "true");
 
 注意：命令行参数路径必须为经净化的相对路径。
 
+#### Website 与 wasm playground
+
+官网位于 `website/`，新增 `/try` 路由会按需加载 LK wasm runtime。
+
+```bash
+cd website
+bun run build
+```
+
+本地开发时，`bun run build` 会执行 `website/scripts/build-wasm.mjs`，由它调用 `wasm-pack build ../wasm --target web --out-dir ../website/src/wasm/pkg --release`，再生成 i18n 类型并构建 Vite 应用；此时 `website/src/wasm/pkg/` 属于生成产物，通常被 git 忽略，开发者不应提交。Cloudflare 预构建/部署分支会从仓库读取已构建 wasm package（见 `website/scripts/build-wasm.mjs`），因此这些分支上的 `website/src/wasm/pkg/` 需要存在并提交，或由 CI/CD 构建流程产出。示例：本地开发：忽略并不提交；部署/Cloudflare 预构建分支：需包含或由构建流程产出。
+
+浏览器 playground 支持单文件运行、stdout 捕获、返回值展示、parse/runtime 诊断和指令步数上限。它只暴露浏览器安全标准库子集；`fs`、`io`、`net`、`process`、`env`、`os`、`task`、`chan` 等 native 模块会明确报告为浏览器不可用。
+
 #### VS Code
 
 VS Code 支持已合并为 `vsc-ext/lsp` 下的单个扩展，包含 `.lk` 语言注册、TextMate 高亮、代码片段，以及带智能补全的 LK LSP 客户端；补全覆盖 stdlib 模块、导入别名、本地符号、named arguments 和常见 receiver 方法。使用 `make debug-lsp-ext` 启动本地 Extension Development Host，或使用 `make vsix` 构建 VSIX。

README.zh-CN.md

@@ -11,7 +11,8 @@ name = "lk_core"
 crate-type = ["rlib", "staticlib"]
 
 [features]
-default = ["llvm"]
+default = ["llvm", "async-runtime"]
+async-runtime = ["dep:futures", "dep:tokio"]
 llvm = ["dep:llvm-tools"]
 vm-profile = []
 
@@ -22,8 +23,8 @@ serde_json = { workspace = true }
 serde_yaml = { workspace = true }
 toml = { workspace = true }
 once_cell = { workspace = true }
-tokio = { workspace = true }
-futures = { workspace = true }
+tokio = { workspace = true, optional = true }
+futures = { workspace = true, optional = true }
 dashmap = { workspace = true }
 tracing = { workspace = true }
 chrono = { workspace = true }

core/Cargo.toml

@@ -1,3 +1,9 @@
+#[cfg(feature = "async-runtime")]
 mod runtime;
+#[cfg(not(feature = "async-runtime"))]
+mod unsupported;
 
+#[cfg(feature = "async-runtime")]
 pub use runtime::*;
+#[cfg(not(feature = "async-runtime"))]
+pub use unsupported::*;

core/src/rt.rs

@@ -0,0 +1,55 @@
+use anyhow::{Result, anyhow};
+
+use crate::{
+    val::{HeapStore, RuntimeVal},
+    vm::copy_runtime_value,
+};
+
+#[derive(Clone, Debug)]
+pub struct RuntimePayload {
+    pub value: RuntimeVal,
+    pub heap: HeapStore,
+}
+
+impl RuntimePayload {
+    pub fn new(value: RuntimeVal, heap: HeapStore) -> Self {
+        Self { value, heap }
+    }
+
+    pub fn copy_from_value(value: &RuntimeVal, heap: &HeapStore) -> Result<Self> {
+        let mut payload_heap = HeapStore::new();
+        let value = copy_runtime_value(value, heap, &mut payload_heap)?;
+        Ok(Self::new(value, payload_heap))
+    }
+
+    pub fn into_value(self, heap: &mut HeapStore) -> Result<RuntimeVal> {
+        copy_runtime_value(&self.value, &self.heap, heap)
+    }
+
+    pub fn clone_value_into(&self, heap: &mut HeapStore) -> Result<RuntimeVal> {
+        copy_runtime_value(&self.value, &self.heap, heap)
+    }
+
+    pub fn nil() -> Self {
+        Self {
+            value: RuntimeVal::Nil,
+            heap: HeapStore::new(),
+        }
+    }
+}
+
+pub fn init_runtime() -> Result<()> {
+    Ok(())
+}
+
+pub fn shutdown_runtime() {}
+
+pub fn with_runtime<F, R>(_f: F) -> Result<R>
+where
+    F: FnOnce(&Runtime) -> Result<R>,
+{
+    Err(anyhow!("LK async runtime is not available in this build"))
+}
+
+#[derive(Debug)]
+pub struct Runtime;

core/src/rt/unsupported.rs

@@ -151,8 +151,9 @@ impl ModuleResolver {
     }
 
     pub fn resolve_runtime_module(&self, name: &str) -> Result<RuntimeExport> {
-        if let Ok(module) = self.stdlib_registry.get_runtime_module(name) {
-            return Ok(module);
+        match self.stdlib_registry.get_module(name) {
+            Ok(module) => return module.runtime_exports(),
+            Err(_) => {}
         }
         let Some(root) = self.package_modules.get(name) else {
             return Err(anyhow!("Module '{}' not found", name));