quickwin 1.0.0 → 1.0.2

package/README.en.md

@@ -1,25 +1,33 @@
-> [中文文档](README.md) · **English**
+> [中文文档](README.md) · **English**
 
 # QuickWin
 
-QuickJS Win32 runtime — run JavaScript with native Windows GUI, networking, WASM, FFI, and more.
+QuickJS runtime for Windows, with native GUI, networking, WASM, FFI and more.
 
-```bash
-npm i -g quickwin
-quickwin script.js
+Goal: compatibility with Windows XP+ (32/64-bit) and a minimal binary size.
+
+Currently: supports Windows 7+ (64-bit), ~1.5MB binary.
+
+Early-stage project with known bugs.
+
+Download directly from the GitHub Release:
+
+```powershell
+iwr https://github.com/xna00/quickwin/releases/latest/download/qwin.exe -OutFile qwin.exe
+iwr https://github.com/xna00/quickwin/releases/latest/download/main.js -OutFile main.js
+.\qwin.exe main.js
 ```
 
 ## Features
 
-- **Win32 GUI** — native windows, buttons, edit boxes, list boxes, tray icons, popup menus
-- **React renderer** — declarative GUI in JSX with `useState`/`useEffect`, diff updates ([react-qw](lib/react-qw/))
-- **HTTP/HTTPS** — `fetch()` API, Brotli decompression, chunked transfer, conditional caching
-- **WebSocket** — full RFC 6455 implementation, ws:// + wss://
-- **WebAssembly** — WAMR-based, supports `WebAssembly.*` standard API
-- **FFI** — call any DLL function via libffi
-- **mupdf** — embedded PDF rendering
-- **Polyfills** — `TextEncoder`, `URL`, `URLSearchParams`, `btoa`/`atob`, `crypto.subtle`, `setTimeout`
-- **Dynamic import** — `import('https://esm.sh/...')`, no npm install needed
+- **Win32 GUI** — native windows, buttons, edit boxes, list boxes, tray icons, popup menus
+- **React renderer** — declarative GUI in JSX with `useState`/`useEffect`, diff updates ([react-qw](lib/react-qw/))
+- **HTTP/HTTPS** — `fetch()` API, Brotli decompression, chunked transfer, conditional caching
+- **WebSocket** — full RFC 6455 implementation, ws:// + wss://
+- **WebAssembly** — WAMR-based, supports `WebAssembly.*` standard API
+- **FFI** — call any DLL function via libffi
+- **Polyfills** — `TextEncoder`, `URL`, `URLSearchParams`, `btoa`/`atob`, `crypto.subtle`, `setTimeout`
+- **Dynamic import** — `import('https://esm.sh/...')`, no dependency installation needed
 
 ## CLI
 
@@ -42,12 +50,12 @@ quickwin -- script.js --flag        # -- stops option parsing
 | `-d` | Enable HTTP debug logging |
 | `--` | Stop option parsing, remaining args passed to script |
 
-All unknown flags are transparently forwarded to `scriptArgs` — no error,
+All unknown flags are transparently forwarded to `scriptArgs` — no error,
 no consumption. Script file is the first non-flag argument after option parsing.
 
 ## Embedded Script
 
-You can embed a JS script directly into the `qwin.exe` binary — no recompilation needed.
+You can embed a JS script directly into the `qwin.exe` binary — no recompilation needed.
 
 ### Format (appended to exe)
 
@@ -89,7 +97,7 @@ When run without a script file argument, `qwin.exe` checks for embedded JS at th
 | `fetch` | `import './lib/fetch.js'` | adds `fetch()`, `Response`, `Headers` to globalThis |
 | `websocket` | `import './lib/websocket.js'` | adds `WebSocket` to globalThis |
 | `polyfill` | `import './lib/polyfill.js'` | adds `TextEncoder`, `URL`, `btoa`/`atob`, `setTimeout` to globalThis |
-| `preact` | `lib/preact/...` | JSX → Win32 renderer (`render`, `useState`, `useEffect`) |
+| `preact` | `lib/preact/...` | JSX → Win32 renderer (`render`, `useState`, `useEffect`) |
 | `react-qw` | `lib/react-qw/` | React Custom Renderer for Win32 GUI ([docs](lib/react-qw/)) |
 
 ## Worker
@@ -144,9 +152,9 @@ Both sides must set `onmessage = null` when communication is complete. This rele
 ## Examples
 
 ```bash
-npx quickwin examples/preact_demo.js   # counter GUI with JSX + hooks
-npx quickwin examples/tray_demo.js     # system tray app
-npx quickwin examples/pdf_preview.js   # PDF reader with mupdf
+.\qwin.exe examples/preact_demo.js   # counter GUI with JSX + hooks
+.\qwin.exe examples/tray_demo.js     # system tray app
+.\qwin.exe examples/pdf_preview.js   # PDF reader with mupdf
 ```
 
 ## Build from Source
@@ -178,11 +186,11 @@ cd quickwin
 |--------|-------------|
 | `make` / `make nodebug` | fast build |
 | `make minimal` | `-Os` + LTO + `-mwindows` + UPX, no console, add `-o CON` for console |
-| `make nowasm` | no WASM/WAMR build → `_build/qwin-nowasm.exe` (~1.2MB, no `WebAssembly` global) |
-| `make release` | `-O2` + LTO + strip, ~2.5MB |
+| `make nowasm` | no WASM/WAMR build → `_build/qwin-nowasm.exe` (~1.2MB, no `WebAssembly` global) |
+| `make release` | `-O2` + LTO + strip, ~1.5MB |
 | `make debug` | debug build with bridge logs |
 | `make js` | compile TypeScript via tsc |
-| `make wasm` | compile WAT → WASM fixtures |
+| `make wasm` | compile WAT → WASM fixtures |
 | `make test` | run all tests |
 | `make test TEST=-net` | skip network tests (fast) |
 | `make test TEST=wasm` | run WASM tests only |

package/README.md

@@ -2,11 +2,20 @@
 
 # QuickWin
 
-QuickJS Win32 运行时 —— 用原生 Windows GUI、网络、WASM、FFI 等运行 JavaScript。
+Windows 平台上的 QuickJS 运行时，支持原生 GUI、网络、WASM、FFI 等能力。
 
-```bash
-npm i -g quickwin
-quickwin script.js
+目标：兼容 Windows XP+（32/64 位），保持最小二进制体积。
+
+现状：当前支持 Windows 7+（64 位），体积约 1.5MB。
+
+项目处于早期，功能待完善，包含已知 bug。
+
+直接从 GitHub Release 下载运行：
+
+```powershell
+iwr https://github.com/xna00/quickwin/releases/latest/download/qwin.exe -OutFile qwin.exe
+iwr https://github.com/xna00/quickwin/releases/latest/download/main.js -OutFile main.js
+.\qwin.exe main.js
 ```
 
 ## 特性
@@ -17,9 +26,8 @@ quickwin script.js
 - **WebSocket** —— 完整的 RFC 6455 实现，支持 ws:// 与 wss://
 - **WebAssembly** —— 基于 WAMR，支持标准 `WebAssembly.*` API
 - **FFI** —— 通过 libffi 调用任意 DLL 函数
-- **mupdf** —— 内嵌 PDF 渲染
 - **Polyfills** —— `TextEncoder`、`URL`、`URLSearchParams`、`btoa`/`atob`、`crypto.subtle`、`setTimeout`
-- **动态导入** —— `import('https://esm.sh/...')`，无需 npm install
+- **动态导入** —— `import('https://esm.sh/...')`，无需安装任何依赖
 
 ## CLI
 
@@ -143,9 +151,9 @@ parent.onmessage = (e) => {
 ## 示例
 
 ```bash
-npx quickwin examples/preact_demo.js   # JSX + hooks 的计数器 GUI
-npx quickwin examples/tray_demo.js     # 系统托盘应用
-npx quickwin examples/pdf_preview.js   # 基于 mupdf 的 PDF 阅读器
+.\qwin.exe examples/preact_demo.js   # JSX + hooks 的计数器 GUI
+.\qwin.exe examples/tray_demo.js     # 系统托盘应用
+.\qwin.exe examples/pdf_preview.js   # 基于 mupdf 的 PDF 阅读器
 ```
 
 ## 从源码构建
@@ -178,7 +186,7 @@ cd quickwin
 | `make` / `make nodebug` | 快速构建 |
 | `make minimal` | `-Os` + LTO + `-mwindows` + UPX，无控制台，需要控制台时加 `-o CON` |
 | `make nowasm` | 无 WASM/WAMR 构建 → `_build/qwin-nowasm.exe`（约 1.2MB，无 `WebAssembly` 全局） |
-| `make release` | `-O2` + LTO + strip，约 2.5MB |
+| `make release` | `-O2` + LTO + strip，约 1.5MB |
 | `make debug` | 带 bridge 日志的调试构建 |
 | `make js` | 通过 tsc 编译 TypeScript |
 | `make wasm` | 编译 WAT → WASM fixtures |

package/examples/exec_server.js

@@ -0,0 +1,38 @@
+import { createServer } from '../lib/http-server.js';
+import * as std from 'std';
+function readAll(file) {
+    const chunks = [];
+    const buf = new Uint8Array(4096);
+    while (true) {
+        const n = file.read(buf.buffer, 0, 4096);
+        if (n <= 0)
+            break;
+        chunks.push(buf.slice(0, n));
+    }
+    let total = 0;
+    for (const c of chunks)
+        total += c.length;
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const c of chunks) {
+        out.set(c, offset);
+        offset += c.length;
+    }
+    return new TextDecoder().decode(out);
+}
+const server = createServer(async (req) => {
+    if (req.method === 'POST' && new URL(req.url).pathname === '/exec') {
+        const body = await req.json();
+        const file = std.popen(body.cmd, 'r');
+        if (!file)
+            return new Response('popen failed', { status: 500 });
+        const output = readAll(file);
+        file.close();
+        return new Response(output, {
+            headers: { 'Content-Type': 'application/octet-stream' }
+        });
+    }
+    return new Response('Not Found', { status: 404 });
+});
+server.listen(8080);
+console.log('listening on http://localhost:8080');

package/examples/exec_server.ts

@@ -0,0 +1,35 @@
+import { createServer } from '../lib/http-server.js'
+import * as std from 'std'
+
+function readAll(file: std.FILE): string {
+    const chunks: Uint8Array[] = []
+    const buf = new Uint8Array(4096)
+    while (true) {
+        const n = file.read(buf.buffer, 0, 4096)
+        if (n <= 0) break
+        chunks.push(buf.slice(0, n))
+    }
+    let total = 0
+    for (const c of chunks) total += c.length
+    const out = new Uint8Array(total)
+    let offset = 0
+    for (const c of chunks) { out.set(c, offset); offset += c.length }
+    return new TextDecoder().decode(out)
+}
+
+const server = createServer(async (req) => {
+    if (req.method === 'POST' && new URL(req.url).pathname === '/exec') {
+        const body = await req.json() as { cmd: string }
+        const file = std.popen(body.cmd, 'r')
+        if (!file) return new Response('popen failed', { status: 500 })
+        const output = readAll(file)
+        file.close()
+        return new Response(output, {
+            headers: { 'Content-Type': 'application/octet-stream' }
+        })
+    }
+    return new Response('Not Found', { status: 404 })
+})
+
+server.listen(8080)
+console.log('listening on http://localhost:8080')

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "quickwin",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "QuickJS Win32 runtime — GUI, networking, WASM, FFI, and more",
   "bin": {
     "quickwin": "qwin.exe",