quickwin 1.1.2 → 1.1.3

package/README.en.md

@@ -1,33 +1,37 @@
-> [中文文档](README.md) · **English**
+> [中文文档](README.md) · **English**
 
 # QuickWin
 
 QuickJS runtime for Windows, with native GUI, networking, WASM, FFI and more.
 
-Goal: compatibility with Windows XP+ (32/64-bit) and a minimal binary size.
-
-Currently: supports Windows 7+ (64-bit), ~1.5MB binary.
+Supports Windows XP+ (32/64-bit) with a minimal binary size (~1.5MB). The 32-bit build is CI-tested in a QEMU Windows XP VM.
 
 Early-stage project with known bugs.
 
-Download directly from the GitHub Release:
+Install:
+
+```bash
+# Option 1: npm local install (recommended)
+npm install quickwin
+npx quickwin script.js
 
-```powershell
+# Option 2: download directly from GitHub Release
 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
 ```
 
+The npm package ships 4 executables: `qwin.exe` (64-bit) / `qwin-x86.exe` (32-bit, XP-compatible) plus their no-WASM variants `qwin-nowasm.exe` / `qwin-nowasm-x86.exe`.
+
 ## 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
-- **Polyfills** — `TextEncoder`, `URL`, `URLSearchParams`, `btoa`/`atob`, `crypto.subtle`, `setTimeout`
-- **Dynamic import** — `import('https://esm.sh/...')`, no dependency installation 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
 
@@ -50,12 +54,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)
 
@@ -97,7 +101,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
@@ -152,9 +156,9 @@ Both sides must set `onmessage = null` when communication is complete. This rele
 ## Examples
 
 ```bash
-.\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
+.\qwin.exe examples/pdf_preview2.js  # PDF reader with mupdf
+.\qwin.exe examples/test_tab.js      # tabbed GUI with JSX
 ```
 
 ## Build from Source
@@ -168,11 +172,11 @@ Both sides must set `onmessage = null` when communication is complete. This rele
 ### Build
 
 ```bash
-git clone --recursive https://github.com/anomalyco/quickwin.git
+git clone --recursive https://github.com/xna00/quickwin.git
 cd quickwin
 
 .\run.ps1 "make wamr"       # build WAMR library (first time only)
-.\run.ps1 "make minimal"    # build qwin.exe (-Os + LTO + UPX)
+.\run.ps1 "make small"      # build qwin.exe (-Os + LTO, ~1.5MB)
 .\run.ps1 "make js"         # compile TypeScript
 .\run.ps1 "make test"       # run all tests
 ```
@@ -185,12 +189,15 @@ cd quickwin
 | Target | Description |
 |--------|-------------|
 | `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, ~1.5MB |
+| `make small` | `-Os` + LTO + strip, ~1.5MB (recommended) |
+| `make minimal` | `small` + UPX compression |
+| `make release` | `-O2` + LTO + strip (not `-Os` optimized) |
 | `make debug` | debug build with bridge logs |
+| `make nowasm` | no WASM/WAMR build → `_build/qwin-nowasm.exe` (~1.2MB, no `WebAssembly` global) |
+| `make cc64-small` | cross-compile x86_64 `_build/qwin.exe` (`-Os`, used by CI) |
+| `make cc32-small` | cross-compile i686 `_build/qwin-x86.exe` (`-Os`, XP-compatible, used by CI) |
 | `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

@@ -4,20 +4,24 @@
 
 Windows 平台上的 QuickJS 运行时，支持原生 GUI、网络、WASM、FFI 等能力。
 
-目标：兼容 Windows XP+（32/64 位），保持最小二进制体积。
-
-现状：当前支持 Windows 7+（64 位），体积约 1.5MB。
+支持 Windows XP+（32/64 位），保持最小二进制体积（约 1.5MB）。32 位构建已在 QEMU Windows XP 虚拟机中通过 CI 测试。
 
 项目处于早期，功能待完善，包含已知 bug。
 
-直接从 GitHub Release 下载运行：
+安装方式：
+
+```bash
+# 方式一：npm 本地安装（推荐）
+npm install quickwin
+npx quickwin script.js
 
-```powershell
+# 方式二：直接从 GitHub Release 下载
 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
 ```
 
+npm 包自带 4 个可执行文件：`qwin.exe`（64 位）/ `qwin-x86.exe`（32 位，兼容 XP）及其无 WASM 版本 `qwin-nowasm.exe` / `qwin-nowasm-x86.exe`。
+
 ## 特性
 
 - **Win32 原生 GUI** —— 原生窗口、按钮、编辑框、列表框、托盘图标、弹出菜单
@@ -151,9 +155,9 @@ parent.onmessage = (e) => {
 ## 示例
 
 ```bash
-.\qwin.exe examples/preact_demo.js   # JSX + hooks 的计数器 GUI
 .\qwin.exe examples/tray_demo.js     # 系统托盘应用
-.\qwin.exe examples/pdf_preview.js   # 基于 mupdf 的 PDF 阅读器
+.\qwin.exe examples/pdf_preview2.js  # 基于 mupdf 的 PDF 阅读器
+.\qwin.exe examples/test_tab.js      # 基于 JSX 的标签页 GUI
 ```
 
 ## 从源码构建
@@ -167,11 +171,11 @@ parent.onmessage = (e) => {
 ### 构建
 
 ```bash
-git clone --recursive https://github.com/anomalyco/quickwin.git
+git clone --recursive https://github.com/xna00/quickwin.git
 cd quickwin
 
 .\run.ps1 "make wamr"       # 构建 WAMR 库（仅首次）
-.\run.ps1 "make minimal"    # 构建 qwin.exe（-Os + LTO + UPX）
+.\run.ps1 "make small"      # 构建 qwin.exe（-Os + LTO，约 1.5MB）
 .\run.ps1 "make js"         # 编译 TypeScript
 .\run.ps1 "make test"       # 运行全部测试
 ```
@@ -184,10 +188,13 @@ cd quickwin
 | Target | Description |
 |--------|-------------|
 | `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，约 1.5MB |
+| `make small` | `-Os` + LTO + strip，约 1.5MB（推荐） |
+| `make minimal` | `small` + UPX 压缩 |
+| `make release` | `-O2` + LTO + strip（未做 `-Os` 优化） |
 | `make debug` | 带 bridge 日志的调试构建 |
+| `make nowasm` | 无 WASM/WAMR 构建 → `_build/qwin-nowasm.exe`（约 1.2MB，无 `WebAssembly` 全局） |
+| `make cc64-small` | 交叉编译 x86_64 `_build/qwin.exe`（`-Os`，CI 用） |
+| `make cc32-small` | 交叉编译 i686 `_build/qwin-x86.exe`（`-Os`，兼容 XP，CI 用） |
 | `make js` | 通过 tsc 编译 TypeScript |
 | `make wasm` | 编译 WAT → WASM fixtures |
 | `make test` | 运行全部测试 |

package/package.json

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