feat(web): 提供web页面使用

Author: x3zvawq

.github/scripts/sync_versions.mjs

@@ -17,6 +17,7 @@ const targetFiles = [
   { kind: "cargo", path: "packages/unluac-wasm/Cargo.toml" },
   { kind: "json", path: "packages/unluac-js/package.json" },
   { kind: "package-lock", path: "packages/unluac-js/package-lock.json" },
+  { kind: "json", path: "packages/unluac-web/package.json" },
 ];
 
 const rootManifest = await readFile(rootManifestPath, "utf8");

.github/workflows/deploy-web.yml

@@ -0,0 +1,87 @@
+name: Deploy Web
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'src/**'
+      - 'packages/unluac-wasm/**'
+      - 'packages/unluac-web/**'
+      - 'Cargo.toml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  NODE_VERSION: '24'
+  WASM_PACK_VERSION: '0.14.0'
+  WASM_BINDGEN_CLI_VERSION: '0.2.115'
+
+jobs:
+  deploy:
+    name: Deploy to Vercel
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Restore wasm tool cache
+        id: wasm-tool-cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/wasm-pack
+            ~/.cargo/bin/wasm-bindgen
+            ~/.cargo/bin/wasm-bindgen-test-runner
+            ~/.cargo/bin/wasm2es6js
+            ~/.cargo/.crates2.json
+            ~/.cargo/.crates.toml
+          key: ${{ runner.os }}-wasm-tools-wasm-pack-${{ env.WASM_PACK_VERSION }}-wasm-bindgen-${{ env.WASM_BINDGEN_CLI_VERSION }}
+
+      - name: Restore cargo build cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry/index
+            ~/.cargo/registry/cache
+            ~/.cargo/git/db
+            target/
+          key: ${{ runner.os }}-cargo-wasm-${{ hashFiles('Cargo.lock', 'src/**', 'packages/unluac-wasm/**') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-wasm-
+
+      - name: Install wasm-pack
+        if: steps.wasm-tool-cache.outputs.cache-hit != 'true'
+        run: cargo install wasm-pack --version ${{ env.WASM_PACK_VERSION }} --locked
+
+      - name: Install wasm-bindgen CLI
+        if: steps.wasm-tool-cache.outputs.cache-hit != 'true'
+        run: cargo install wasm-bindgen-cli --version ${{ env.WASM_BINDGEN_CLI_VERSION }} --locked
+
+      - name: Install dependencies
+        working-directory: packages/unluac-web
+        run: npm install
+
+      - name: Build
+        working-directory: packages/unluac-web
+        run: npm run build
+
+      - name: Deploy to Vercel
+        uses: amondnet/vercel-action@v42.2.0
+        with:
+          vercel-token: ${{ secrets.VERCEL_TOKEN }}
+          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
+          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
+          target: production
+          working-directory: ${{ github.workspace }}/packages/unluac-web

.gitignore

@@ -2,4 +2,8 @@
 /lua/.tmp
 /lua/build
 /lua/sources
-.DS_Store
+.DS_Store
+node_modules
+dist
+.vite
+*.tsbuildinfo

.vscode/settings.json

@@ -13,6 +13,7 @@
         "backedge",
         "backedges",
         "BANDK",
+        "bindgen",
         "BITRK",
         "BNOT",
         "Bxor",

README.md

@@ -9,6 +9,7 @@ A multi-dialect Lua decompiler written in Rust.
 
 Published entry points:
 
+- Web interface at [unluac.x3zvawq.com](https://unluac.x3zvawq.com)
 - Rust crate [`unluac`](https://crates.io/crates/unluac)
 - Standalone CLI binaries on [GitHub Releases](https://github.com/x3zvawq/unluac-rs/releases)
 - npm package [`unluac-js`](https://www.npmjs.com/package/unluac-js)
@@ -40,10 +41,21 @@ The repository is organized roughly like this:
 
 The project is currently distributed through these entry points:
 
-1. **CLI**: use the standalone binary from GitHub Releases, or run/build `unluac-cli` from this repository.
-2. **Rust library**: add the published crate `unluac` to a Rust project and call the decompilation pipeline directly.
-3. **npm package**: install `unluac-js` for Node.js or bundler-based browser environments.
-4. **WebAssembly**: use `packages/unluac-wasm` directly when you want to build your own runtime wrapper on top of the wasm layer.
+1. **Web interface**: visit [unluac.x3zvawq.com](https://unluac.x3zvawq.com) — upload and decompile directly in the browser with no installation required.
+2. **CLI**: use the standalone binary from GitHub Releases, or run/build `unluac-cli` from this repository.
+3. **Rust library**: add the published crate `unluac` to a Rust project and call the decompilation pipeline directly.
+4. **npm package**: install `unluac-js` for Node.js or bundler-based browser environments.
+5. **WebAssembly**: use `packages/unluac-wasm` directly when you want to build your own runtime wrapper on top of the wasm layer.
+
+### Web Interface
+
+Visit [unluac.x3zvawq.com](https://unluac.x3zvawq.com) to upload `.luac` / `.out` files and decompile them directly in the browser — no tooling required.
+
+The site is hosted on Vercel and may be inaccessible in some network environments (e.g. mainland China). If you run into connectivity issues, consider the alternatives below:
+
+- Use the standalone CLI binary — works fully offline
+- Use the npm package to run decompilation locally in a bundled browser environment
+- Self-host the web interface using `packages/unluac-wasm`
 
 ### CLI
 

README_cn.md

@@ -9,6 +9,7 @@
 
 当前已经发布的对外入口包括：
 
+- Web 页面 [unluac.x3zvawq.com](https://unluac.x3zvawq.com)
 - Rust crate [`unluac`](https://crates.io/crates/unluac)
 - GitHub Releases 上的独立 CLI 二进制
 - npm 包 [`unluac-js`](https://www.npmjs.com/package/unluac-js)
@@ -40,10 +41,21 @@
 
 项目当前主要通过以下几种入口分发：
 
-1. **命令行工具**：使用 GitHub Releases 提供的独立二进制，或者直接在本仓库中运行 / 构建 `unluac-cli`。
-2. **Rust 库**：在 Rust 项目中引入已发布的 `unluac` crate，直接调用反编译 pipeline。
-3. **npm 包**：安装 `unluac-js`，面向 Node.js 或基于打包器的浏览器环境。
-4. **WebAssembly**：直接使用 `packages/unluac-wasm`，适合继续为其他语言或运行时做封装。
+1. **Web 页面**：直接访问 [unluac.x3zvawq.com](https://unluac.x3zvawq.com)，无需安装，在浏览器中完成上传与反编译。
+2. **命令行工具**：使用 GitHub Releases 提供的独立二进制，或者直接在本仓库中运行 / 构建 `unluac-cli`。
+3. **Rust 库**：在 Rust 项目中引入已发布的 `unluac` crate，直接调用反编译 pipeline。
+4. **npm 包**：安装 `unluac-js`，面向 Node.js 或基于打包器的浏览器环境。
+5. **WebAssembly**：直接使用 `packages/unluac-wasm`，适合继续为其他语言或运行时做封装。
+
+### Web 页面
+
+访问 [unluac.x3zvawq.com](https://unluac.x3zvawq.com) 即可直接在浏览器中上传 `.luac` / `.out` 文件进行反编译，无需安装任何工具。
+
+站点部署在 Vercel 上，在部分网络环境（如中国大陆）可能存在访问限制。如遇无法访问的情况，可考虑以下替代方案：
+
+- 使用 CLI 二进制（离线，无需网络）
+- 使用 npm 包在本地浏览器环境中运行
+- 基于 `packages/unluac-wasm` 自建站点
 
 ### 命令行工具
 

luac.out

@@ -22,6 +22,7 @@ Requirements:
 
 - `init(input?)`: initialize the wasm module explicitly
 - `decompile(bytes, options?)`: decompile a compiled Lua chunk and return the final source string
+- `decompileRich(bytes, options?)`: decompile and return structured analysis result (source + proto metadata + CFGs)
 - `supportedOptionValues()`: inspect supported enum-like option values
 
 This package ships a slim wasm build for npm. In particular:
@@ -103,6 +104,28 @@ console.log(source);
 - the input must already be a compiled chunk; this package does not compile Lua source for you
 - the return value is always the final generated source string
 
+### `decompileRich(bytes, options?)`
+
+Returns a structured analysis result instead of a plain source string:
+
+```ts
+import { decompileRich } from "unluac-js";
+
+const result = await decompileRich(chunkBytes, { dialect: "lua5.1" });
+
+console.log(result.source);    // final Lua source
+console.log(result.warnings);  // generation warnings
+console.log(result.protos);    // proto metadata (DFS order)
+console.log(result.cfgs);      // per-proto CFG with blocks and edges
+```
+
+The result includes:
+
+- `source`: generated Lua source string
+- `warnings`: array of generation-stage warnings
+- `protos`: array of `UnluacProtoMeta` with function metadata (name, line range, params, upvalues, constants, instructions, children)
+- `cfgs`: array of `UnluacProtoCfg` with control flow graph data (blocks with Low-IR and raw bytecode instructions, edges with type labels)
+
 Supported top-level options:
 
 - `dialect`
@@ -134,7 +157,7 @@ Common `decompile()` options:
 
 - `dialect`: target chunk dialect such as `lua5.1`, `lua5.4`, `luajit`, or `luau`
 - `parse.mode`: parser mode, `strict` or `permissive`
-- `parse.stringEncoding`: string decoding encoding, `utf-8` or `gbk`
+- `parse.stringEncoding`: string decoding encoding; accepts any [Encoding Standard](https://encoding.spec.whatwg.org/) label (e.g. `utf-8`, `gbk`, `shift_jis`, `euc-kr`, `big5`)
 - `parse.stringDecodeMode`: string decode failure strategy, `strict` or `lossy`
 - `naming.mode`: naming strategy, `debug-like`, `simple`, or `heuristic`
 - `naming.debugLikeIncludeFunction`: whether debug-like naming should include function-shaped names

packages/unluac-js/README.md

@@ -8,7 +8,19 @@ export type UnluacDialect =
   | "luau";
 
 export type UnluacParseMode = "strict" | "permissive";
-export type UnluacStringEncoding = "utf-8" | "gbk";
+export type UnluacStringEncoding =
+  | "utf-8"
+  | "GBK"
+  | "gb18030"
+  | "Big5"
+  | "Shift_JIS"
+  | "EUC-JP"
+  | "EUC-KR"
+  | "windows-1252"
+  | "windows-1251"
+  | "KOI8-R"
+  | "windows-874"
+  | (string & {});
 export type UnluacStringDecodeMode = "strict" | "lossy";
 export type UnluacNamingMode = "debug-like" | "simple" | "heuristic";
 export type UnluacQuoteStyle = "prefer-double" | "prefer-single" | "min-escape";
@@ -53,6 +65,82 @@ export interface UnluacSupportedOptionValues {
   tableStyles: UnluacTableStyle[];
 }
 
+// ── 结构化反编译结果（decompileRich 返回） ──
+
+export type UnluacBlockKind = "normal" | "synthetic-exit";
+export type UnluacEdgeKind =
+  | "fallthrough"
+  | "jump"
+  | "branch-true"
+  | "branch-false"
+  | "loop-body"
+  | "loop-exit"
+  | "return"
+  | "tail-call";
+
+export interface UnluacRichResult {
+  /** 反编译生成的完整 Lua 源码 */
+  source: string;
+  /** 生成阶段的警告 */
+  warnings: string[];
+  /** proto 元数据（DFS 序展平） */
+  protos: UnluacProtoMeta[];
+  /** 每个 proto 的 CFG（与 protos 平行数组） */
+  cfgs: UnluacProtoCfg[];
+}
+
+export interface UnluacProtoMeta {
+  /** DFS 遍历序号（0 = 主 proto） */
+  id: number;
+  /** 源文件名（debug info） */
+  name: string | null;
+  lineStart: number;
+  lineEnd: number;
+  numParams: number;
+  isVararg: boolean;
+  numUpvalues: number;
+  numConstants: number;
+  numInstructions: number;
+  /** 常量池字面量列表 */
+  constants: UnluacConstant[];
+  /** 子 proto 的 DFS ID 列表 */
+  children: number[];
+}
+
+export interface UnluacConstant {
+  /** 常量在池中的索引（0-based） */
+  index: number;
+  /** 类型标签 */
+  type: "nil" | "boolean" | "integer" | "number" | "string" | "int64" | "uint64" | "complex";
+  /** 人类可读的值表示 */
+  display: string;
+}
+
+export interface UnluacProtoCfg {
+  protoId: number;
+  blocks: UnluacCfgBlock[];
+  edges: UnluacCfgEdge[];
+  entryBlock: number;
+  exitBlock: number;
+  /** 拓扑序 block ID 列表 */
+  blockOrder: number[];
+}
+
+export interface UnluacCfgBlock {
+  id: number;
+  kind: UnluacBlockKind;
+  /** 人类可读的 Low-IR 指令行 */
+  instructions: string[];
+  /** 对应的原始字节码指令行（通过 LoweringMap 映射） */
+  rawInstructions: string[];
+}
+
+export interface UnluacCfgEdge {
+  from: number;
+  to: number;
+  kind: UnluacEdgeKind;
+}
+
 type UnluacBytes = BufferSource | ArrayLike<number>;
 type UnluacInitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 type WasmInitArgument =
@@ -63,6 +151,7 @@ type WasmInitArgument =
 interface WasmBindings {
   default(input?: WasmInitArgument): Promise<unknown>;
   decompile(bytes: Uint8Array, options: UnluacDecompileOptions): string;
+  decompileRich(bytes: Uint8Array, options: UnluacDecompileOptions): UnluacRichResult;
   supportedOptionValues(): UnluacSupportedOptionValues;
 }
 
@@ -138,6 +227,15 @@ export async function decompile(
   return bindings.decompile(toUint8Array(bytes), options);
 }
 
+export async function decompileRich(
+  bytes: UnluacBytes,
+  options: UnluacDecompileOptions = {}
+): Promise<UnluacRichResult> {
+  await init();
+  const bindings = await loadBindings();
+  return bindings.decompileRich(toUint8Array(bytes), options);
+}
+
 export async function supportedOptionValues(): Promise<UnluacSupportedOptionValues> {
   await init();
   const bindings = await loadBindings();

packages/unluac-js/src/index.ts

@@ -17,6 +17,8 @@ use unluac::decompile::{
 };
 use unluac::parser::{ParseMode, StringDecodeMode, StringEncoding};
 
+mod rich;
+
 pub use unluac as core;
 
 #[derive(Debug, Default, Deserialize)]
@@ -111,6 +113,21 @@ pub fn decompile_wasm(bytes: &[u8], options: JsValue) -> Result<JsValue, JsValue
     to_js_value(&generated_source)
 }
 
+/// 返回结构化 JSON，包含 proto 树、CFG 和反编译源码。
+///
+/// 与 `decompile` 的区别：`decompile` 只返回源码字符串，而 `decompileRich`
+/// 额外返回 proto 元数据和 CFG 拓扑，供前端可视化使用。
+#[wasm_bindgen(js_name = decompileRich)]
+pub fn decompile_rich_wasm(bytes: &[u8], options: JsValue) -> Result<JsValue, JsValue> {
+    let options = parse_wasm_options(options).map_err(WasmBridgeError::into_js_value)?;
+    let result = run_decompile(bytes, options).map_err(|error| {
+        WasmBridgeError::new("decompile-failed", error.to_string(), None).into_js_value()
+    })?;
+
+    let rich = rich::project_rich_result(&result);
+    to_js_value(&rich)
+}
+
 #[wasm_bindgen(js_name = supportedOptionValues)]
 pub fn supported_option_values() -> Result<JsValue, JsValue> {
     to_js_value(&WasmSupportedOptionValues {