@wu-framework/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Wu Framework
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,162 @@
+# wu-cli
+
+**One binary. One port. All your micro-apps.**
+
+Native Zig dev server and CLI toolkit for wu-framework microfrontend applications. Replaces N Vite dev servers with a single process -- one binary that discovers, compiles, and serves every micro-app through a unified HTTP server.
+
+---
+
+## Features
+
+- Native HTTP dev server with SIMD-accelerated request parsing (16 bytes/cycle)
+- Three-tier compilation: Native Zig JSX (0-2ms) -> Compiler Daemon (10-50ms) -> Node fallback (200-400ms)
+- Two-level cache: in-memory (256 entries, mutex-protected) + persistent disk (`.wu-cache/`), 73-138x speedup on warm restart
+- NPM module resolution in pure Zig (package.json `exports`, `module`, `main` fields with conditions)
+- TypeScript stripping and bare-specifier import rewriting (`react` -> `/@modules/react`)
+- CSS-as-module imports (`import './style.css'` injects into DOM at runtime)
+- WebSocket (RFC 6455) + SSE-based HMR with 300ms file-watcher polling
+- HTTP keep-alive for connection reuse across requests
+- Interactive project scaffolding (`wu create`)
+- Auto-discovery of micro-apps from directory structure (no config required)
+- Framework support: React, Preact, Vue, Svelte, Solid, Lit, Angular, Vanilla JS
+
+## Install
+
+```bash
+npm install -g @wu-framework/cli
+```
+
+Then use it anywhere:
+
+```bash
+wu create my-project
+cd my-project
+wu dev
+```
+
+### Build from source
+
+If you prefer to build from source (requires [Zig 0.15.2+](https://ziglang.org/download/)):
+
+```bash
+git clone https://github.com/LuisPadre25/wu-cli.git
+cd wu-cli
+zig build
+./zig-out/bin/wu create my-project
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `wu dev` | Start native dev server (default) or Vite processes (`--vite`) |
+| `wu build` | Build all micro-apps in parallel |
+| `wu create` | Interactive project scaffolding (name, frameworks, install) |
+| `wu add <framework> <name>` | Add a new micro-app to an existing project |
+| `wu info` | Show project configuration and status |
+| `wu serve` | Production server (coming soon) |
+
+## Configuration
+
+wu-cli reads a `wu.config.json` file at the project root. Example:
+
+```json
+{
+  "shell": {
+    "dir": "shell",
+    "port": 4321,
+    "framework": "astro"
+  },
+  "apps": [
+    {
+      "name": "dashboard",
+      "dir": "mf-hero",
+      "framework": "svelte",
+      "port": 5002
+    },
+    {
+      "name": "orders",
+      "dir": "mf-eventlab",
+      "framework": "react",
+      "port": 5005
+    }
+  ]
+}
+```
+
+Alternatively, wu-cli auto-discovers micro-apps by scanning subdirectories for the presence of both `vite.config.js` and `package.json`. No configuration file is required for basic usage.
+
+## Architecture
+
+```
+src/
+  commands/          CLI command handlers (dev, build, create, add, info, serve)
+  runtime/           Dev server core
+  config/            Configuration loading and validation
+```
+
+### Runtime modules
+
+| Module | Purpose |
+|--------|---------|
+| **dev_server.zig** | Thread-per-connection HTTP server with keep-alive and static file serving |
+| **http_parser.zig** | SIMD HTTP/1.1 request parser (16 bytes/cycle vectorized header scanning) |
+| **resolve.zig** | NPM module resolution in pure Zig (zero Node.js dependency) |
+| **transform.zig** | TypeScript erasure + bare-specifier import rewriting (line-preserving) |
+| **jsx_transform.zig** | Native JSX to createElement transformation (React/Preact, ~0-2ms) |
+| **compile.zig** | Three-tier framework compilation with persistent daemon process |
+| **cache.zig** | Two-level mtime-based cache (in-memory 256 entries + disk `.wu-cache/`) |
+| **ws_protocol.zig** | WebSocket RFC 6455 implementation (frame parsing, masking, handshake) |
+| **mime.zig** | MIME type detection by file extension |
+
+## Compilation Pipeline
+
+```
+.jsx/.tsx (React/Preact) ----> Native Zig JSX ----> JS  (~0-2ms)
+.jsx/.tsx (Solid)        ----> Compiler Daemon ----> JS  (~10-50ms)
+.svelte                  ----> Compiler Daemon ----> JS  (~10-50ms)
+.vue                     ----> Compiler Daemon ----> JS  (~10-50ms)
+.ts                      ----> TS Strip        ----> JS  (~0-1ms)
+```
+
+The three tiers are tried in order. Native Zig handles React and Preact JSX with zero external processes. The Compiler Daemon keeps a long-running Node.js process for frameworks that require their own compilers (Svelte, Vue, Solid). If the daemon is unavailable, a one-shot `node -e` fallback is used.
+
+Cache hits bypass all tiers entirely: the mtime of the source file is compared against the cached entry, and the cached output is served directly (~3ms).
+
+## Supported Frameworks
+
+| Framework | Extensions | Compile Tier | Native JSX |
+|-----------|-----------|-------------|------------|
+| React | .jsx, .tsx | Native Zig | Yes |
+| Preact | .jsx, .tsx | Native Zig | Yes |
+| Vue | .vue | Daemon / Node | -- |
+| Svelte | .svelte | Daemon / Node | -- |
+| Solid.js | .jsx, .tsx | Daemon / Node | -- |
+| Lit | .ts, .js | TS strip only | -- |
+| Vanilla | .js, .ts | TS strip only | -- |
+| Angular | .ts | TS strip only | -- |
+
+## Requirements
+
+- **Node.js 16+** -- for installing via npm (`npm install -g @wu-framework/cli`)
+- **Node.js 18+** -- needed at runtime for Svelte, Vue, and Solid compilation (React/Preact use native Zig JSX)
+- **Zig 0.15.2+** -- only needed if building from source
+
+## Project Stats
+
+- 22 Zig source files, ~2800 lines of runtime code
+- ~250-460KB release binary per platform (Windows, Linux, macOS x64/arm64), zero external Zig dependencies
+- Single-process architecture replaces 8+ simultaneous Vite dev servers
+- Part of the wu-framework microfrontend platform
+
+## License
+
+MIT
+
+## Author
+
+Luis Garcia -- Creator of wu-framework
+
+---
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development workflow and guidelines.

package/bin/wu.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+const PLATFORM_MAP = {
+  'win32-x64':   'wu-win32-x64.exe',
+  'linux-x64':   'wu-linux-x64',
+  'darwin-x64':  'wu-darwin-x64',
+  'darwin-arm64': 'wu-darwin-arm64',
+};
+
+const platform = os.platform();
+const arch = os.arch();
+const key = `${platform}-${arch}`;
+const binaryName = PLATFORM_MAP[key];
+
+if (!binaryName) {
+  console.error(`wu-cli: unsupported platform ${platform}-${arch}`);
+  console.error(`Supported: ${Object.keys(PLATFORM_MAP).join(', ')}`);
+  process.exit(1);
+}
+
+const binaryPath = path.join(__dirname, binaryName);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(`wu-cli: binary not found at ${binaryPath}`);
+  console.error('This may mean the package was not built for your platform.');
+  console.error('Try reinstalling: npm install -g wu-cli');
+  process.exit(1);
+}
+
+const args = process.argv.slice(2);
+
+let result = spawnSync(binaryPath, args, {
+  stdio: 'inherit',
+  env: process.env,
+});
+
+// Handle EACCES — try chmod +x and retry (Linux/macOS)
+if (result.error && result.error.code === 'EACCES') {
+  try {
+    fs.chmodSync(binaryPath, 0o755);
+    result = spawnSync(binaryPath, args, {
+      stdio: 'inherit',
+      env: process.env,
+    });
+  } catch (chmodErr) {
+    console.error(`wu-cli: permission denied and could not chmod: ${chmodErr.message}`);
+    process.exit(1);
+  }
+}
+
+if (result.error) {
+  console.error(`wu-cli: failed to execute binary: ${result.error.message}`);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@wu-framework/cli",
+  "version": "0.1.0",
+  "description": "Lightning-fast micro-frontend CLI — scaffold, develop, and build multi-framework apps",
+  "license": "MIT",
+  "bin": {
+    "wu": "bin/wu.js"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prepublishOnly": "bash scripts/build-all.sh"
+  },
+  "keywords": [
+    "micro-frontend",
+    "microfrontend",
+    "cli",
+    "scaffold",
+    "dev-server",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "preact",
+    "lit",
+    "angular",
+    "astro"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LuisPadre25/wu-cli"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}