npm - almostnode - Versions diffs - 0.1.0 - Mend

almostnode 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (216) hide show

package/LICENSE +21 -0
package/README.md +731 -0
package/dist/__sw__.js +394 -0
package/dist/ai-chatbot-demo-entry.d.ts +6 -0
package/dist/ai-chatbot-demo-entry.d.ts.map +1 -0
package/dist/ai-chatbot-demo.d.ts +42 -0
package/dist/ai-chatbot-demo.d.ts.map +1 -0
package/dist/assets/runtime-worker-D9x_Ddwz.js +60543 -0
package/dist/assets/runtime-worker-D9x_Ddwz.js.map +1 -0
package/dist/convex-app-demo-entry.d.ts +6 -0
package/dist/convex-app-demo-entry.d.ts.map +1 -0
package/dist/convex-app-demo.d.ts +68 -0
package/dist/convex-app-demo.d.ts.map +1 -0
package/dist/cors-proxy.d.ts +46 -0
package/dist/cors-proxy.d.ts.map +1 -0
package/dist/create-runtime.d.ts +42 -0
package/dist/create-runtime.d.ts.map +1 -0
package/dist/demo.d.ts +6 -0
package/dist/demo.d.ts.map +1 -0
package/dist/dev-server.d.ts +97 -0
package/dist/dev-server.d.ts.map +1 -0
package/dist/frameworks/next-dev-server.d.ts +202 -0
package/dist/frameworks/next-dev-server.d.ts.map +1 -0
package/dist/frameworks/vite-dev-server.d.ts +85 -0
package/dist/frameworks/vite-dev-server.d.ts.map +1 -0
package/dist/index.cjs +14965 -0
package/dist/index.cjs.map +1 -0
package/dist/index.d.ts +71 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.mjs +14867 -0
package/dist/index.mjs.map +1 -0
package/dist/next-demo.d.ts +49 -0
package/dist/next-demo.d.ts.map +1 -0
package/dist/npm/index.d.ts +71 -0
package/dist/npm/index.d.ts.map +1 -0
package/dist/npm/registry.d.ts +66 -0
package/dist/npm/registry.d.ts.map +1 -0
package/dist/npm/resolver.d.ts +52 -0
package/dist/npm/resolver.d.ts.map +1 -0
package/dist/npm/tarball.d.ts +29 -0
package/dist/npm/tarball.d.ts.map +1 -0
package/dist/runtime-interface.d.ts +90 -0
package/dist/runtime-interface.d.ts.map +1 -0
package/dist/runtime.d.ts +103 -0
package/dist/runtime.d.ts.map +1 -0
package/dist/sandbox-helpers.d.ts +43 -0
package/dist/sandbox-helpers.d.ts.map +1 -0
package/dist/sandbox-runtime.d.ts +65 -0
package/dist/sandbox-runtime.d.ts.map +1 -0
package/dist/server-bridge.d.ts +89 -0
package/dist/server-bridge.d.ts.map +1 -0
package/dist/shims/assert.d.ts +51 -0
package/dist/shims/assert.d.ts.map +1 -0
package/dist/shims/async_hooks.d.ts +37 -0
package/dist/shims/async_hooks.d.ts.map +1 -0
package/dist/shims/buffer.d.ts +20 -0
package/dist/shims/buffer.d.ts.map +1 -0
package/dist/shims/child_process-browser.d.ts +92 -0
package/dist/shims/child_process-browser.d.ts.map +1 -0
package/dist/shims/child_process.d.ts +93 -0
package/dist/shims/child_process.d.ts.map +1 -0
package/dist/shims/chokidar.d.ts +55 -0
package/dist/shims/chokidar.d.ts.map +1 -0
package/dist/shims/cluster.d.ts +52 -0
package/dist/shims/cluster.d.ts.map +1 -0
package/dist/shims/crypto.d.ts +122 -0
package/dist/shims/crypto.d.ts.map +1 -0
package/dist/shims/dgram.d.ts +34 -0
package/dist/shims/dgram.d.ts.map +1 -0
package/dist/shims/diagnostics_channel.d.ts +80 -0
package/dist/shims/diagnostics_channel.d.ts.map +1 -0
package/dist/shims/dns.d.ts +87 -0
package/dist/shims/dns.d.ts.map +1 -0
package/dist/shims/domain.d.ts +25 -0
package/dist/shims/domain.d.ts.map +1 -0
package/dist/shims/esbuild.d.ts +105 -0
package/dist/shims/esbuild.d.ts.map +1 -0
package/dist/shims/events.d.ts +37 -0
package/dist/shims/events.d.ts.map +1 -0
package/dist/shims/fs.d.ts +115 -0
package/dist/shims/fs.d.ts.map +1 -0
package/dist/shims/fsevents.d.ts +67 -0
package/dist/shims/fsevents.d.ts.map +1 -0
package/dist/shims/http.d.ts +217 -0
package/dist/shims/http.d.ts.map +1 -0
package/dist/shims/http2.d.ts +81 -0
package/dist/shims/http2.d.ts.map +1 -0
package/dist/shims/https.d.ts +36 -0
package/dist/shims/https.d.ts.map +1 -0
package/dist/shims/inspector.d.ts +25 -0
package/dist/shims/inspector.d.ts.map +1 -0
package/dist/shims/module.d.ts +22 -0
package/dist/shims/module.d.ts.map +1 -0
package/dist/shims/net.d.ts +100 -0
package/dist/shims/net.d.ts.map +1 -0
package/dist/shims/os.d.ts +159 -0
package/dist/shims/os.d.ts.map +1 -0
package/dist/shims/path.d.ts +72 -0
package/dist/shims/path.d.ts.map +1 -0
package/dist/shims/perf_hooks.d.ts +50 -0
package/dist/shims/perf_hooks.d.ts.map +1 -0
package/dist/shims/process.d.ts +93 -0
package/dist/shims/process.d.ts.map +1 -0
package/dist/shims/querystring.d.ts +23 -0
package/dist/shims/querystring.d.ts.map +1 -0
package/dist/shims/readdirp.d.ts +52 -0
package/dist/shims/readdirp.d.ts.map +1 -0
package/dist/shims/readline.d.ts +62 -0
package/dist/shims/readline.d.ts.map +1 -0
package/dist/shims/rollup.d.ts +34 -0
package/dist/shims/rollup.d.ts.map +1 -0
package/dist/shims/sentry.d.ts +163 -0
package/dist/shims/sentry.d.ts.map +1 -0
package/dist/shims/stream.d.ts +181 -0
package/dist/shims/stream.d.ts.map +1 -0
package/dist/shims/tls.d.ts +53 -0
package/dist/shims/tls.d.ts.map +1 -0
package/dist/shims/tty.d.ts +30 -0
package/dist/shims/tty.d.ts.map +1 -0
package/dist/shims/url.d.ts +64 -0
package/dist/shims/url.d.ts.map +1 -0
package/dist/shims/util.d.ts +106 -0
package/dist/shims/util.d.ts.map +1 -0
package/dist/shims/v8.d.ts +73 -0
package/dist/shims/v8.d.ts.map +1 -0
package/dist/shims/vfs-adapter.d.ts +126 -0
package/dist/shims/vfs-adapter.d.ts.map +1 -0
package/dist/shims/vm.d.ts +45 -0
package/dist/shims/vm.d.ts.map +1 -0
package/dist/shims/worker_threads.d.ts +66 -0
package/dist/shims/worker_threads.d.ts.map +1 -0
package/dist/shims/ws.d.ts +66 -0
package/dist/shims/ws.d.ts.map +1 -0
package/dist/shims/zlib.d.ts +161 -0
package/dist/shims/zlib.d.ts.map +1 -0
package/dist/transform.d.ts +24 -0
package/dist/transform.d.ts.map +1 -0
package/dist/virtual-fs.d.ts +226 -0
package/dist/virtual-fs.d.ts.map +1 -0
package/dist/vite-demo.d.ts +35 -0
package/dist/vite-demo.d.ts.map +1 -0
package/dist/vite-sw.js +132 -0
package/dist/worker/runtime-worker.d.ts +8 -0
package/dist/worker/runtime-worker.d.ts.map +1 -0
package/dist/worker-runtime.d.ts +50 -0
package/dist/worker-runtime.d.ts.map +1 -0
package/package.json +85 -0
package/src/ai-chatbot-demo-entry.ts +244 -0
package/src/ai-chatbot-demo.ts +509 -0
package/src/convex-app-demo-entry.ts +1107 -0
package/src/convex-app-demo.ts +1316 -0
package/src/cors-proxy.ts +81 -0
package/src/create-runtime.ts +147 -0
package/src/demo.ts +304 -0
package/src/dev-server.ts +274 -0
package/src/frameworks/next-dev-server.ts +2224 -0
package/src/frameworks/vite-dev-server.ts +702 -0
package/src/index.ts +101 -0
package/src/next-demo.ts +1784 -0
package/src/npm/index.ts +347 -0
package/src/npm/registry.ts +152 -0
package/src/npm/resolver.ts +385 -0
package/src/npm/tarball.ts +209 -0
package/src/runtime-interface.ts +103 -0
package/src/runtime.ts +1046 -0
package/src/sandbox-helpers.ts +173 -0
package/src/sandbox-runtime.ts +252 -0
package/src/server-bridge.ts +426 -0
package/src/shims/assert.ts +664 -0
package/src/shims/async_hooks.ts +86 -0
package/src/shims/buffer.ts +75 -0
package/src/shims/child_process-browser.ts +217 -0
package/src/shims/child_process.ts +463 -0
package/src/shims/chokidar.ts +313 -0
package/src/shims/cluster.ts +67 -0
package/src/shims/crypto.ts +830 -0
package/src/shims/dgram.ts +47 -0
package/src/shims/diagnostics_channel.ts +196 -0
package/src/shims/dns.ts +172 -0
package/src/shims/domain.ts +58 -0
package/src/shims/esbuild.ts +805 -0
package/src/shims/events.ts +195 -0
package/src/shims/fs.ts +803 -0
package/src/shims/fsevents.ts +63 -0
package/src/shims/http.ts +904 -0
package/src/shims/http2.ts +96 -0
package/src/shims/https.ts +86 -0
package/src/shims/inspector.ts +30 -0
package/src/shims/module.ts +82 -0
package/src/shims/net.ts +359 -0
package/src/shims/os.ts +195 -0
package/src/shims/path.ts +199 -0
package/src/shims/perf_hooks.ts +92 -0
package/src/shims/process.ts +346 -0
package/src/shims/querystring.ts +97 -0
package/src/shims/readdirp.ts +228 -0
package/src/shims/readline.ts +110 -0
package/src/shims/rollup.ts +80 -0
package/src/shims/sentry.ts +133 -0
package/src/shims/stream.ts +1126 -0
package/src/shims/tls.ts +95 -0
package/src/shims/tty.ts +64 -0
package/src/shims/url.ts +171 -0
package/src/shims/util.ts +312 -0
package/src/shims/v8.ts +113 -0
package/src/shims/vfs-adapter.ts +402 -0
package/src/shims/vm.ts +83 -0
package/src/shims/worker_threads.ts +111 -0
package/src/shims/ws.ts +382 -0
package/src/shims/zlib.ts +289 -0
package/src/transform.ts +313 -0
package/src/types/external.d.ts +67 -0
package/src/virtual-fs.ts +903 -0
package/src/vite-demo.ts +577 -0
package/src/worker/runtime-worker.ts +128 -0
package/src/worker-runtime.ts +145 -0

package/src/vite-demo.ts ADDED Viewed

@@ -0,0 +1,577 @@
+/**
+ * Vite Demo - Running Vite in the browser using our Node.js shims
+ */
+import { VirtualFS } from './virtual-fs';
+import { Runtime } from './runtime';
+import { PackageManager } from './npm';
+import { ViteDevServer } from './frameworks/vite-dev-server';
+import { getServerBridge } from './server-bridge';
+import { Buffer } from './shims/stream';
+// Create a simple Vite project in the virtual filesystem
+export function createViteProject(vfs: VirtualFS): void {
+  // Create package.json
+  vfs.writeFileSync(
+    '/package.json',
+    JSON.stringify(
+      {
+        name: 'react-vite-browser-demo',
+        version: '1.0.0',
+        type: 'module',
+        scripts: {
+          dev: 'vite',
+          build: 'vite build',
+          preview: 'vite preview',
+        },
+        dependencies: {
+          react: '^18.2.0',
+          'react-dom': '^18.2.0',
+        },
+        devDependencies: {
+          vite: '^5.0.0',
+          '@vitejs/plugin-react': '^4.2.0',
+        },
+      },
+      null,
+      2
+    )
+  );
+  // Create vite.config.js with React plugin
+  vfs.writeFileSync(
+    '/vite.config.js',
+    `
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+export default defineConfig({
+  root: '/',
+  plugins: [react()],
+  server: {
+    port: 3000,
+    strictPort: true,
+  },
+  build: {
+    outDir: 'dist',
+  },
+});
+`
+  );
+  // Create index.html for React app
+  // Note: Use relative paths (./src/) so they work with /__virtual__/port/ URLs
+  // Import map resolves bare imports (react, react-dom) to CDN URLs
+  // IMPORTANT: Use ?dev to get development builds with DevTools/React Refresh support
+  vfs.writeFileSync(
+    '/index.html',
+    `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>React + Vite Browser Demo</title>
+  <script type="importmap">
+  {
+    "imports": {
+      "react": "https://esm.sh/react@18.2.0?dev",
+      "react/": "https://esm.sh/react@18.2.0&dev/",
+      "react-dom": "https://esm.sh/react-dom@18.2.0?dev",
+      "react-dom/": "https://esm.sh/react-dom@18.2.0&dev/"
+    }
+  }
+  </script>
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="./src/main.jsx"></script>
+</body>
+</html>
+`
+  );
+  // Create src directory and main.jsx
+  vfs.mkdirSync('/src', { recursive: true });
+  vfs.writeFileSync(
+    '/src/main.jsx',
+    `
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App.jsx';
+import './style.css';
+ReactDOM.createRoot(document.getElementById('root')).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);
+`
+  );
+  // Create App.jsx
+  vfs.writeFileSync(
+    '/src/App.jsx',
+    `
+import React, { useState } from 'react';
+import Counter from './Counter.jsx';
+function App() {
+  const [theme, setTheme] = useState('light');
+  const toggleTheme = () => {
+    setTheme(theme === 'light' ? 'dark' : 'light');
+  };
+  return (
+    <div className={\`app \${theme}\`}>
+      <header>
+        <h1>⚡ React + Vite in Browser</h1>
+        <p>Running with shimmed Node.js APIs</p>
+      </header>
+      <main>
+        <Counter />
+        <div className="theme-toggle">
+          <button onClick={toggleTheme}>
+            {theme === 'light' ? '🌙 Dark Mode' : '☀️ Light Mode'}
+          </button>
+        </div>
+        <div className="info-card">
+          <h3>How it works</h3>
+          <ul>
+            <li>VirtualFS stores all files in memory</li>
+            <li>Node.js APIs are shimmed for the browser</li>
+            <li>Edit files on the left to see HMR updates</li>
+          </ul>
+        </div>
+      </main>
+      <footer>
+        Made with 💜 WebContainers
+      </footer>
+    </div>
+  );
+}
+export default App;
+`
+  );
+  // Create Counter.jsx
+  vfs.writeFileSync(
+    '/src/Counter.jsx',
+    `
+import React, { useState } from 'react';
+function Counter() {
+  const [count, setCount] = useState(0);
+  return (
+    <div className="counter-card">
+      <h2>Interactive Counter</h2>
+      <div className="counter-display">{count}</div>
+      <div className="counter-buttons">
+        <button onClick={() => setCount(c => c - 1)}>➖</button>
+        <button onClick={() => setCount(0)}>Reset</button>
+        <button onClick={() => setCount(c => c + 1)}>➕</button>
+      </div>
+    </div>
+  );
+}
+export default Counter;
+`
+  );
+  // Create style.css for React app
+  vfs.writeFileSync(
+    '/src/style.css',
+    `
+* {
+  box-sizing: border-box;
+}
+:root {
+  font-family: Inter, system-ui, Avenir, Helvetica, Arial, sans-serif;
+  line-height: 1.5;
+}
+body {
+  margin: 0;
+  min-height: 100vh;
+}
+.app {
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  transition: all 0.3s ease;
+}
+.app.light {
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  color: white;
+}
+.app.dark {
+  background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+  color: #eee;
+}
+header {
+  text-align: center;
+  padding: 2rem;
+}
+header h1 {
+  font-size: 2.5rem;
+  margin: 0 0 0.5rem 0;
+}
+header p {
+  opacity: 0.8;
+  margin: 0;
+}
+main {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 1.5rem;
+  padding: 1rem;
+}
+.counter-card {
+  background: rgba(255, 255, 255, 0.15);
+  backdrop-filter: blur(10px);
+  border-radius: 16px;
+  padding: 2rem;
+  text-align: center;
+  min-width: 280px;
+}
+.counter-card h2 {
+  margin: 0 0 1rem 0;
+}
+.counter-display {
+  font-size: 4rem;
+  font-weight: bold;
+  margin: 1rem 0;
+}
+.counter-buttons {
+  display: flex;
+  gap: 0.5rem;
+  justify-content: center;
+}
+button {
+  padding: 0.75rem 1.5rem;
+  font-size: 1rem;
+  font-weight: 500;
+  border: none;
+  border-radius: 8px;
+  background: rgba(255, 255, 255, 0.2);
+  color: inherit;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+button:hover {
+  background: rgba(255, 255, 255, 0.3);
+  transform: translateY(-2px);
+}
+button:active {
+  transform: translateY(0);
+}
+.theme-toggle button {
+  background: rgba(0, 0, 0, 0.2);
+}
+.info-card {
+  background: rgba(255, 255, 255, 0.1);
+  border-radius: 12px;
+  padding: 1.5rem;
+  max-width: 400px;
+}
+.info-card h3 {
+  margin: 0 0 1rem 0;
+}
+.info-card ul {
+  margin: 0;
+  padding-left: 1.5rem;
+}
+.info-card li {
+  margin: 0.5rem 0;
+  opacity: 0.9;
+}
+footer {
+  text-align: center;
+  padding: 1.5rem;
+  opacity: 0.7;
+}
+`
+  );
+}
+// Initialize the demo
+export async function initViteDemo(
+  outputElement: HTMLElement,
+  iframeElement: HTMLIFrameElement | null
+): Promise<{ vfs: VirtualFS; runtime: Runtime; npm: PackageManager }> {
+  const log = (message: string) => {
+    const line = document.createElement('div');
+    line.textContent = `[${new Date().toLocaleTimeString()}] ${message}`;
+    outputElement.appendChild(line);
+    outputElement.scrollTop = outputElement.scrollHeight;
+  };
+  log('Creating virtual file system...');
+  const vfs = new VirtualFS();
+  log('Creating Vite project structure...');
+  createViteProject(vfs);
+  log('Initializing runtime...');
+  const runtime = new Runtime(vfs, {
+    cwd: '/',
+    env: {
+      NODE_ENV: 'development',
+    },
+    onConsole: (method, args) => {
+      const prefix = method === 'error' ? '[ERROR]' : method === 'warn' ? '[WARN]' : '';
+      log(`${prefix} ${args.map((a) => String(a)).join(' ')}`);
+    },
+  });
+  // Initialize package manager
+  const npm = new PackageManager(vfs, { cwd: '/' });
+  // Set up file watcher demo
+  log('Setting up file watcher...');
+  vfs.watch('/src', { recursive: true }, (eventType, filename) => {
+    log(`File ${eventType}: ${filename}`);
+  });
+  log('Vite demo initialized!');
+  log('');
+  log('Virtual FS contents:');
+  listFiles(vfs, '/', log, '  ');
+  return { vfs, runtime, npm };
+}
+/**
+ * Install Vite into the virtual file system
+ */
+export async function installVite(
+  npm: PackageManager,
+  log: (message: string) => void
+): Promise<void> {
+  log('');
+  log('=== Installing Vite ===');
+  log('This will download Vite and its dependencies from npm...');
+  try {
+    const result = await npm.install('vite@5.0.12', {
+      onProgress: (msg) => log(`  ${msg}`),
+    });
+    log(`Installed ${result.added.length} packages`);
+    log('Vite installation complete!');
+  } catch (error) {
+    log(`ERROR installing Vite: ${error}`);
+    throw error;
+  }
+}
+/**
+ * Try to run Vite's createServer
+ */
+export async function runVite(
+  runtime: Runtime,
+  log: (message: string) => void
+): Promise<unknown> {
+  log('');
+  log('=== Starting Vite ===');
+  try {
+    // ESM packages are pre-transformed to CJS during npm install
+    // Try to require vite
+    log('Loading Vite module...');
+    const code = `
+const vite = require('vite');
+console.log('Vite loaded:', typeof vite);
+console.log('Vite exports:', Object.keys(vite));
+// Try to call createServer
+async function start() {
+  try {
+    console.log('Creating Vite dev server...');
+    const server = await vite.createServer({
+      root: '/',
+      configFile: false,
+      server: {
+        port: 3000,
+        strictPort: true,
+        hmr: false, // Disable HMR for initial test
+      },
+      logLevel: 'info',
+    });
+    console.log('Vite server created!');
+    return server;
+  } catch (err) {
+    console.error('Failed to create Vite server:', err.message);
+    console.error(err.stack);
+    throw err;
+  }
+}
+module.exports = { start };
+`;
+    const { exports } = runtime.execute(code, '/run-vite.js');
+    const { start } = exports as { start: () => Promise<unknown> };
+    log('Executing Vite createServer...');
+    const server = await start();
+    log('Vite server started successfully!');
+    return server;
+  } catch (error) {
+    log(`ERROR running Vite: ${error}`);
+    if (error instanceof Error) {
+      log(`Stack: ${error.stack}`);
+    }
+    throw error;
+  }
+}
+function listFiles(
+  vfs: VirtualFS,
+  path: string,
+  log: (msg: string) => void,
+  indent: string
+): void {
+  try {
+    const entries = vfs.readdirSync(path);
+    for (const entry of entries) {
+      const fullPath = path === '/' ? '/' + entry : path + '/' + entry;
+      const stats = vfs.statSync(fullPath);
+      if (stats.isDirectory()) {
+        log(`${indent}📁 ${entry}/`);
+        listFiles(vfs, fullPath, log, indent + '  ');
+      } else {
+        log(`${indent}📄 ${entry}`);
+      }
+    }
+  } catch (e) {
+    log(`${indent}Error: ${e}`);
+  }
+}
+/**
+ * Start the dev server using Service Worker approach
+ * This is the recommended way to run the preview - no npm install required!
+ */
+export async function startDevServer(
+  vfs: VirtualFS,
+  options: {
+    port?: number;
+    log?: (message: string) => void;
+  } = {}
+): Promise<{
+  server: ViteDevServer;
+  url: string;
+  stop: () => void;
+}> {
+  const port = options.port || 3000;
+  const log = options.log || console.log;
+  log('Starting dev server...');
+  // Create ViteDevServer
+  const server = new ViteDevServer(vfs, { port, root: '/' });
+  // Get the server bridge
+  const bridge = getServerBridge();
+  // Initialize Service Worker
+  try {
+    log('Initializing Service Worker...');
+    await bridge.initServiceWorker();
+    log('Service Worker ready');
+  } catch (error) {
+    log(`Warning: Service Worker failed to initialize: ${error}`);
+    log('Falling back to direct request handling...');
+  }
+  // Register the server with the bridge
+  // The bridge will route /__virtual__/{port}/* requests to this server
+  bridge.on('server-ready', (p: unknown, u: unknown) => {
+    log(`Server ready at ${u}`);
+  });
+  // Wire up the ViteDevServer to handle requests through the bridge
+  // We need to make the server compatible with the bridge's http.Server interface
+  const httpServer = createHttpServerWrapper(server);
+  bridge.registerServer(httpServer, port);
+  // Start watching for file changes
+  server.start();
+  log('File watcher started');
+  // Set up HMR event forwarding
+  server.on('hmr-update', (update: unknown) => {
+    log(`HMR update: ${JSON.stringify(update)}`);
+  });
+  const url = bridge.getServerUrl(port);
+  log(`Dev server running at: ${url}/`);
+  return {
+    server,
+    url: url + '/',
+    stop: () => {
+      server.stop();
+      bridge.unregisterServer(port);
+    },
+  };
+}
+/**
+ * Create an http.Server-compatible wrapper around ViteDevServer
+ */
+function createHttpServerWrapper(devServer: ViteDevServer) {
+  return {
+    listening: true,
+    address: () => ({ port: devServer.getPort(), address: '0.0.0.0', family: 'IPv4' }),
+    async handleRequest(
+      method: string,
+      url: string,
+      headers: Record<string, string>,
+      body?: string | Buffer
+    ) {
+      const bodyBuffer = body
+        ? typeof body === 'string'
+          ? Buffer.from(body)
+          : body
+        : undefined;
+      return devServer.handleRequest(method, url, headers, bodyBuffer);
+    },
+  };
+}
+// Export for use in the demo page
+export { VirtualFS, Runtime, PackageManager, ViteDevServer };

package/src/worker/runtime-worker.ts ADDED Viewed

@@ -0,0 +1,128 @@
+/**
+ * Runtime Worker - Runs the Just Node runtime in a Web Worker
+ *
+ * This worker receives code execution requests from the main thread
+ * and runs them in isolation, preventing UI blocking.
+ */
+import { expose } from 'comlink';
+import { VirtualFS } from '../virtual-fs';
+import { Runtime } from '../runtime';
+import type { VFSSnapshot, IRuntimeOptions, IExecuteResult } from '../runtime-interface';
+let runtime: Runtime | null = null;
+let vfs: VirtualFS | null = null;
+let consoleCallback: ((method: string, args: unknown[]) => void) | null = null;
+/**
+ * Worker API exposed via Comlink
+ */
+const workerApi = {
+  /**
+   * Initialize the worker with a VFS snapshot and runtime options
+   */
+  init(vfsSnapshot: VFSSnapshot, options: IRuntimeOptions): void {
+    console.log('[Worker] Initializing with', vfsSnapshot.files.length, 'files');
+    // Restore VFS from snapshot
+    vfs = VirtualFS.fromSnapshot(vfsSnapshot);
+    // Create runtime with console forwarding
+    const runtimeOptions: IRuntimeOptions = {
+      ...options,
+      onConsole: (method, args) => {
+        // Forward console output to main thread
+        if (consoleCallback) {
+          consoleCallback(method, args);
+        }
+      },
+    };
+    runtime = new Runtime(vfs, runtimeOptions);
+    console.log('[Worker] Runtime initialized');
+  },
+  /**
+   * Set the console callback for forwarding output to main thread
+   */
+  setConsoleCallback(callback: ((method: string, args: unknown[]) => void) | null): void {
+    consoleCallback = callback;
+  },
+  /**
+   * Sync a file change from the main thread
+   */
+  syncFile(path: string, content: string | null): void {
+    if (!vfs) {
+      console.warn('[Worker] VFS not initialized, cannot sync file:', path);
+      return;
+    }
+    if (content === null) {
+      // File was deleted
+      try {
+        vfs.unlinkSync(path);
+        console.log('[Worker] Deleted file:', path);
+      } catch (err) {
+        // File might not exist, that's ok
+      }
+    } else {
+      // File was created or modified
+      vfs.writeFileSync(path, content);
+      console.log('[Worker] Synced file:', path);
+    }
+    // Clear module cache for this file to pick up changes
+    if (runtime) {
+      runtime.clearCache();
+    }
+  },
+  /**
+   * Execute code in the worker
+   */
+  async execute(code: string, filename?: string): Promise<IExecuteResult> {
+    if (!runtime) {
+      throw new Error('Worker runtime not initialized. Call init() first.');
+    }
+    console.log('[Worker] Executing code in file:', filename);
+    return runtime.execute(code, filename);
+  },
+  /**
+   * Run a file from the VFS
+   */
+  async runFile(filename: string): Promise<IExecuteResult> {
+    if (!runtime) {
+      throw new Error('Worker runtime not initialized. Call init() first.');
+    }
+    console.log('[Worker] Running file:', filename);
+    return runtime.runFile(filename);
+  },
+  /**
+   * Clear the module cache
+   */
+  clearCache(): void {
+    if (runtime) {
+      runtime.clearCache();
+      console.log('[Worker] Cache cleared');
+    }
+  },
+  /**
+   * Get current VFS state (for debugging)
+   */
+  getVFSSnapshot(): VFSSnapshot | null {
+    if (!vfs) return null;
+    return vfs.toSnapshot();
+  },
+};
+// Expose the API via Comlink
+expose(workerApi);
+// Log that worker is ready
+console.log('[Worker] Runtime worker loaded and ready');