nova64 0.2.5 → 0.2.6

package/README.md

@@ -124,20 +124,36 @@
 
 ## 🚀 Quick Start Guide
 
-### 🏁 **Launch Your 3D Fantasy Console**
+### � **Install & Play (Recommended)**
 
 ```bash
-# Method 1: Development Server (Recommended)
+# Install globally
+pnpm add -g nova64
+
+# Launch the console with 20+ playable demos
+nova64 --start-demo
+```
+
+That's it! Your browser opens to the Nova64 console at `http://localhost:3000/console.html` with all demos ready to play.
+
+### 🏁 **Development Setup**
+
+```bash
+# Clone and set up for development
+git clone https://github.com/seacloud9/nova64.git
+cd nova64
 pnpm install
 pnpm dev
-# Visit the printed URL (typically http://localhost:5173)
+# Visit http://localhost:5173
+```
 
-# Method 2: Direct Browser Launch
-open index.html
+### 🔧 **CLI Options**
 
-# Method 3: Simple HTTP Server
-python -m http.server 8000
-# Visit: http://localhost:8000
+```bash
+nova64 --start-demo              # Launch console with demos
+nova64 --start-demo -p 8080      # Use a custom port
+nova64 --start-demo --no-open    # Don't auto-open browser
+nova64 --help                    # Show all options
 ```
 
 🎉 **You should see spectacular 3D demos running instantly!**
@@ -148,6 +164,7 @@ python -m http.server 8000
 nova64/                          # 🏰 Ultimate 3D Fantasy Console
 ├── 📄 index.html               # Main console launcher
 ├── 📦 package.json             # Dependencies & scripts
+├── 🎮 bin/nova64.js            # CLI entry point (nova64 --start-demo)
 ├── 🔧 src/main.js              # Core engine bootstrap
 ├── ⚡ runtime/                 # 💎 Advanced 3D Engine
 │   ├── 🎨 gpu-threejs.js       # Three.js GPU backend with advanced materials

package/bin/nova64.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+
+import { createServer } from 'http';
+import { readFile, stat } from 'fs/promises';
+import { resolve, join, extname } from 'path';
+import { fileURLToPath } from 'url';
+import { exec } from 'child_process';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const distDir = resolve(__dirname, '..', 'dist');
+
+const MIME_TYPES = {
+  '.html': 'text/html; charset=utf-8',
+  '.js': 'application/javascript; charset=utf-8',
+  '.mjs': 'application/javascript; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon',
+  '.webp': 'image/webp',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+  '.ttf': 'font/ttf',
+  '.otf': 'font/otf',
+  '.mp3': 'audio/mpeg',
+  '.wav': 'audio/wav',
+  '.ogg': 'audio/ogg',
+  '.glb': 'model/gltf-binary',
+  '.gltf': 'application/json',
+  '.wasm': 'application/wasm',
+  '.map': 'application/json',
+};
+
+function parseArgs(args) {
+  const opts = { port: 3000, open: true, help: false, startDemo: false };
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--help' || arg === '-h') opts.help = true;
+    else if (arg === '--start-demo') opts.startDemo = true;
+    else if (arg === '--no-open') opts.open = false;
+    else if (arg === '--port' || arg === '-p') {
+      const port = parseInt(args[++i], 10);
+      if (Number.isFinite(port) && port > 0 && port < 65536) opts.port = port;
+    }
+  }
+  return opts;
+}
+
+function openBrowser(url) {
+  const platform = process.platform;
+  const cmd = platform === 'darwin' ? 'open' : platform === 'win32' ? 'start' : 'xdg-open';
+  exec(`${cmd} "${url}"`);
+}
+
+function printHelp() {
+  console.log(`
+  \x1b[1m\x1b[35m🎮 Nova64\x1b[0m — Ultimate 3D Fantasy Console
+
+  \x1b[1mUsage:\x1b[0m
+    nova64 --start-demo          Launch the console with demos
+    nova64 --start-demo -p 8080  Use a custom port
+
+  \x1b[1mOptions:\x1b[0m
+    --start-demo     Start local server and open the console
+    -p, --port NUM   Port to listen on (default: 3000)
+    --no-open        Don't auto-open the browser
+    -h, --help       Show this help message
+`);
+}
+
+async function servePath(filePath) {
+  try {
+    const s = await stat(filePath);
+    if (s.isDirectory()) {
+      filePath = join(filePath, 'index.html');
+    }
+    const data = await readFile(filePath);
+    const ext = extname(filePath).toLowerCase();
+    const mime = MIME_TYPES[ext] || 'application/octet-stream';
+    return { data, mime, status: 200 };
+  } catch {
+    return null;
+  }
+}
+
+async function startServer(opts) {
+  const server = createServer(async (req, res) => {
+    // Sanitize URL path to prevent directory traversal
+    const url = new URL(req.url, `http://localhost:${opts.port}`);
+    const pathname = decodeURIComponent(url.pathname);
+    const safePath = resolve(distDir, '.' + pathname);
+
+    // Ensure resolved path is within distDir
+    if (!safePath.startsWith(distDir)) {
+      res.writeHead(403);
+      res.end('Forbidden');
+      return;
+    }
+
+    const result = await servePath(safePath);
+    if (result) {
+      res.writeHead(result.status, {
+        'Content-Type': result.mime,
+        'Cache-Control': 'no-cache',
+        'Access-Control-Allow-Origin': '*',
+      });
+      res.end(result.data);
+    } else {
+      res.writeHead(404, { 'Content-Type': 'text/plain' });
+      res.end('Not Found');
+    }
+  });
+
+  server.listen(opts.port, () => {
+    const consoleUrl = `http://localhost:${opts.port}/console.html`;
+    console.log(`
+  \x1b[1m\x1b[35m🎮 Nova64\x1b[0m Fantasy Console
+
+  \x1b[32m➜\x1b[0m  Console:  \x1b[36m${consoleUrl}\x1b[0m
+  \x1b[32m➜\x1b[0m  Home:     \x1b[36mhttp://localhost:${opts.port}/\x1b[0m
+  \x1b[32m➜\x1b[0m  NovaOS:   \x1b[36mhttp://localhost:${opts.port}/os9-shell/\x1b[0m
+
+  Press \x1b[1mCtrl+C\x1b[0m to stop
+`);
+
+    if (opts.open) {
+      openBrowser(consoleUrl);
+    }
+  });
+
+  server.on('error', err => {
+    if (err.code === 'EADDRINUSE') {
+      console.error(`\x1b[31mError: Port ${opts.port} is already in use.\x1b[0m`);
+      console.error(`Try: nova64 --start-demo --port ${opts.port + 1}`);
+      process.exit(1);
+    }
+    throw err;
+  });
+}
+
+// Main
+const opts = parseArgs(process.argv.slice(2));
+
+if (opts.help) {
+  printHelp();
+  process.exit(0);
+}
+
+if (opts.startDemo) {
+  // Verify dist/ exists
+  try {
+    await stat(distDir);
+  } catch {
+    console.error('\x1b[31mError: dist/ directory not found.\x1b[0m');
+    console.error('Run `pnpm build` first, or reinstall the package.');
+    process.exit(1);
+  }
+  startServer(opts);
+} else {
+  printHelp();
+}