almostnode 0.1.0

package/dist/convex-app-demo-entry.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Entry point for Convex App Demo
+ * This file is loaded by the HTML and bootstraps the demo
+ */
+export {};
+//# sourceMappingURL=convex-app-demo-entry.d.ts.map

package/dist/convex-app-demo-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex-app-demo-entry.d.ts","sourceRoot":"","sources":["../src/convex-app-demo-entry.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/convex-app-demo.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Realistic Next.js + Convex App Demo
+ *
+ * This demo creates a more realistic Next.js application structure
+ * with Radix UI components, Tailwind CSS, and a mocked Convex backend.
+ */
+import { VirtualFS } from './virtual-fs';
+import { Runtime } from './runtime';
+import { NextDevServer } from './frameworks/next-dev-server';
+/**
+ * Package.json for a realistic Next.js + Convex app
+ */
+declare const PACKAGE_JSON: {
+    name: string;
+    version: string;
+    private: boolean;
+    scripts: {
+        dev: string;
+        build: string;
+        start: string;
+    };
+    dependencies: {
+        next: string;
+        react: string;
+        "react-dom": string;
+        clsx: string;
+        "tailwind-merge": string;
+        "lucide-react": string;
+        zod: string;
+        "date-fns": string;
+    };
+    devDependencies: {
+        "@types/node": string;
+        "@types/react": string;
+        "@types/react-dom": string;
+        typescript: string;
+    };
+};
+/**
+ * Minimal packages to install for demo (others loaded from CDN)
+ */
+declare const DEMO_PACKAGES: string[];
+/**
+ * Create the project structure in the virtual filesystem
+ */
+export declare function createConvexAppProject(vfs: VirtualFS): void;
+/**
+ * Initialize the Convex App demo
+ */
+export declare function initConvexAppDemo(outputElement: HTMLElement, options?: {
+    installPackages?: boolean;
+}): Promise<{
+    vfs: VirtualFS;
+    runtime: Runtime;
+}>;
+/**
+ * Start the dev server for Convex App demo
+ */
+export declare function startConvexAppDevServer(vfs: VirtualFS, options?: {
+    port?: number;
+    log?: (message: string) => void;
+}): Promise<{
+    server: NextDevServer;
+    url: string;
+    stop: () => void;
+}>;
+export { PACKAGE_JSON, DEMO_PACKAGES };
+//# sourceMappingURL=convex-app-demo.d.ts.map

package/dist/convex-app-demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex-app-demo.d.ts","sourceRoot":"","sources":["../src/convex-app-demo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAK7D;;GAEG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;CA6BjB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,aAAa,UAKlB,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAuiC3D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,WAAW,EAC1B,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,OAAO,CAAC;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAsD/C;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,SAAS,EACd,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B,GACL,OAAO,CAAC;IACT,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC,CAuDD;AAyDD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/cors-proxy.d.ts

@@ -0,0 +1,46 @@
+/**
+ * CORS Proxy Utility
+ *
+ * Provides optional CORS proxy support for fetching external APIs
+ * that don't allow browser origins.
+ *
+ * No default proxy is configured for security reasons.
+ * Users must explicitly set a proxy URL if needed.
+ *
+ * Example usage:
+ *   setCorsProxy('https://corsproxy.io/?');
+ *   const response = await proxyFetch('https://api.example.com/data');
+ */
+/**
+ * Set the CORS proxy URL
+ * @param url - Proxy URL (e.g., 'https://corsproxy.io/?')
+ *              The target URL will be appended as an encoded parameter.
+ *              Set to null to disable proxy and use direct fetch.
+ */
+export declare function setCorsProxy(url: string | null): void;
+/**
+ * Get the current CORS proxy URL
+ * @returns The configured proxy URL, or null if not set
+ */
+export declare function getCorsProxy(): string | null;
+/**
+ * Check if a proxy is configured
+ */
+export declare function hasProxy(): boolean;
+/**
+ * Fetch with optional CORS proxy
+ *
+ * If a proxy is configured, the request goes through the proxy.
+ * Otherwise, a direct fetch is performed (may hit CORS issues).
+ *
+ * @param url - The target URL to fetch
+ * @param options - Standard fetch options
+ * @returns Promise<Response>
+ */
+export declare function proxyFetch(url: string, options?: RequestInit): Promise<Response>;
+/**
+ * Build a proxied URL without fetching
+ * Useful for displaying the URL or using with other fetch mechanisms
+ */
+export declare function buildProxyUrl(url: string): string;
+//# sourceMappingURL=cors-proxy.d.ts.map

package/dist/cors-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors-proxy.d.ts","sourceRoot":"","sources":["../src/cors-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAOrD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,QAAQ,CAAC,CASnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/create-runtime.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Runtime Factory - Create sandboxed, worker, or main-thread runtime
+ *
+ * SECURITY: By default, createRuntime requires either:
+ *   1. A sandbox URL for cross-origin isolation (recommended)
+ *   2. Explicit opt-in via dangerouslyAllowSameOrigin for trusted code
+ *
+ * Usage:
+ *   // Secure: Cross-origin sandbox (recommended for untrusted code)
+ *   const runtime = await createRuntime(vfs, {
+ *     sandbox: 'https://myapp-sandbox.vercel.app'
+ *   });
+ *
+ *   // Same-origin with Worker (for demos/trusted code)
+ *   const runtime = await createRuntime(vfs, {
+ *     dangerouslyAllowSameOrigin: true,
+ *     useWorker: true
+ *   });
+ *
+ *   // Same-origin main thread (least secure, trusted code only)
+ *   const runtime = await createRuntime(vfs, {
+ *     dangerouslyAllowSameOrigin: true
+ *   });
+ */
+import type { VirtualFS } from './virtual-fs';
+import type { IRuntime, CreateRuntimeOptions } from './runtime-interface';
+/**
+ * Create a runtime instance based on configuration
+ *
+ * SECURITY: Requires either sandbox URL or explicit dangerouslyAllowSameOrigin.
+ *
+ * @param vfs - Virtual file system instance
+ * @param options - Runtime options including sandbox/security settings
+ * @returns Promise resolving to IRuntime instance
+ * @throws Error if neither sandbox nor dangerouslyAllowSameOrigin is specified
+ */
+export declare function createRuntime(vfs: VirtualFS, options?: CreateRuntimeOptions): Promise<IRuntime>;
+export { Runtime } from './runtime';
+export { WorkerRuntime } from './worker-runtime';
+export { SandboxRuntime } from './sandbox-runtime';
+export type { IRuntime, IExecuteResult, IRuntimeOptions, CreateRuntimeOptions, VFSSnapshot, } from './runtime-interface';
+//# sourceMappingURL=create-runtime.d.ts.map

package/dist/create-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-runtime.d.ts","sourceRoot":"","sources":["../src/create-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAkB,oBAAoB,EAAmB,MAAM,qBAAqB,CAAC;AA2C3G;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,QAAQ,CAAC,CAiDnB;AAGD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACV,QAAQ,EACR,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/demo.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mini WebContainer Demo
+ * Demonstrates running an HTTP server in the browser
+ */
+export {};
+//# sourceMappingURL=demo.d.ts.map

package/dist/demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../src/demo.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/dev-server.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Base DevServer class for framework-specific dev servers
+ * This is a framework-agnostic base that can be extended for Vite, Next.js, etc.
+ */
+import { EventEmitter } from './shims/events';
+import { VirtualFS } from './virtual-fs';
+import { Buffer } from './shims/stream';
+export interface DevServerOptions {
+    port: number;
+    root?: string;
+}
+export interface ResponseData {
+    statusCode: number;
+    statusMessage: string;
+    headers: Record<string, string>;
+    body: Buffer;
+}
+export interface HMRUpdate {
+    type: 'update' | 'full-reload';
+    path: string;
+    timestamp?: number;
+}
+/**
+ * Base class for framework-specific dev servers.
+ * Extend this to create Vite, Next.js, etc. implementations.
+ */
+export declare abstract class DevServer extends EventEmitter {
+    protected vfs: VirtualFS;
+    protected port: number;
+    protected root: string;
+    protected running: boolean;
+    constructor(vfs: VirtualFS, options: DevServerOptions);
+    /**
+     * Handle an incoming HTTP request
+     * Must be implemented by framework-specific subclass
+     */
+    abstract handleRequest(method: string, url: string, headers: Record<string, string>, body?: Buffer): Promise<ResponseData>;
+    /**
+     * Start file watching for HMR
+     * Must be implemented by framework-specific subclass
+     */
+    abstract startWatching(): void;
+    /**
+     * Stop the server and cleanup
+     */
+    stop(): void;
+    /**
+     * Start the server
+     */
+    start(): void;
+    /**
+     * Check if server is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get the server's port
+     */
+    getPort(): number;
+    /**
+     * Serve a static file from the virtual filesystem
+     */
+    protected serveFile(filePath: string): ResponseData;
+    /**
+     * Resolve a URL path to a filesystem path
+     */
+    protected resolvePath(urlPath: string): string;
+    /**
+     * Create a 404 Not Found response
+     */
+    protected notFound(path: string): ResponseData;
+    /**
+     * Create a 500 Server Error response
+     */
+    protected serverError(error: unknown): ResponseData;
+    /**
+     * Create a redirect response
+     */
+    protected redirect(location: string, status?: 301 | 302 | 307 | 308): ResponseData;
+    /**
+     * Get MIME type for a file path
+     */
+    protected getMimeType(path: string): string;
+    /**
+     * Check if a path exists in the virtual filesystem
+     */
+    protected exists(path: string): boolean;
+    /**
+     * Check if a path is a directory
+     */
+    protected isDirectory(path: string): boolean;
+    /**
+     * Emit an HMR update event
+     */
+    protected emitHMRUpdate(update: HMRUpdate): void;
+}
+export default DevServer;
+//# sourceMappingURL=dev-server.d.ts.map

package/dist/dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyCD;;;GAGG;AACH,8BAAsB,SAAU,SAAQ,YAAY;IAClD,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAS;gBAEvB,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB;IAOrD;;;OAGG;IACH,QAAQ,CAAC,aAAa,CACpB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,aAAa,IAAI,IAAI;IAE9B;;OAEG;IACH,IAAI,IAAI,IAAI;IAKZ;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IA4BnD;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAiB9C;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAa9C;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY;IAcnD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAS,GAAG,YAAY;IAavF;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK3C;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASvC;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ5C;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAMjD;AAED,eAAe,SAAS,CAAC"}

package/dist/frameworks/next-dev-server.d.ts

@@ -0,0 +1,202 @@
+/**
+ * NextDevServer - Next.js-compatible dev server for browser environment
+ * Implements file-based routing, API routes, and HMR
+ */
+import { DevServer, DevServerOptions, ResponseData } from '../dev-server';
+import { VirtualFS } from '../virtual-fs';
+import { Buffer } from '../shims/stream';
+export interface NextDevServerOptions extends DevServerOptions {
+    /** Pages directory (default: '/pages') */
+    pagesDir?: string;
+    /** App directory for App Router (default: '/app') */
+    appDir?: string;
+    /** Public directory for static assets (default: '/public') */
+    publicDir?: string;
+    /** Prefer App Router over Pages Router (default: auto-detect) */
+    preferAppRouter?: boolean;
+    /** Environment variables (NEXT_PUBLIC_* are available in browser code via process.env) */
+    env?: Record<string, string>;
+}
+/**
+ * NextDevServer - A lightweight Next.js-compatible development server
+ *
+ * Supports both routing paradigms:
+ *
+ * 1. PAGES ROUTER (legacy, /pages directory):
+ *    - /pages/index.jsx        -> /
+ *    - /pages/about.jsx        -> /about
+ *    - /pages/users/[id].jsx   -> /users/:id (dynamic)
+ *    - /pages/api/hello.js     -> /api/hello (API route)
+ *    - Uses next/router for navigation
+ *
+ * 2. APP ROUTER (new, /app directory):
+ *    - /app/page.jsx           -> /
+ *    - /app/about/page.jsx     -> /about
+ *    - /app/users/[id]/page.jsx -> /users/:id (dynamic)
+ *    - /app/layout.jsx         -> Root layout (wraps all pages)
+ *    - /app/about/layout.jsx   -> Nested layout (wraps /about/*)
+ *    - Uses next/navigation for navigation
+ *
+ * The server auto-detects which router to use based on directory existence,
+ * preferring App Router if both exist. Can be overridden via options.
+ */
+export declare class NextDevServer extends DevServer {
+    /** Pages Router directory (default: '/pages') */
+    private pagesDir;
+    /** App Router directory (default: '/app') */
+    private appDir;
+    /** Static assets directory (default: '/public') */
+    private publicDir;
+    /** Whether to use App Router (true) or Pages Router (false) */
+    private useAppRouter;
+    /** Cleanup function for file watchers */
+    private watcherCleanup;
+    /** Target window for HMR updates (iframe contentWindow) */
+    private hmrTargetWindow;
+    /** Store options for later access (e.g., env vars) */
+    private options;
+    constructor(vfs: VirtualFS, options: NextDevServerOptions);
+    /**
+     * Set an environment variable at runtime
+     * NEXT_PUBLIC_* variables will be available via process.env in browser code
+     */
+    setEnv(key: string, value: string): void;
+    /**
+     * Get current environment variables
+     */
+    getEnv(): Record<string, string>;
+    /**
+     * Set the target window for HMR updates (typically iframe.contentWindow)
+     * This enables HMR to work with sandboxed iframes via postMessage
+     */
+    setHMRTarget(targetWindow: Window): void;
+    /**
+     * Generate a script tag that defines process.env with NEXT_PUBLIC_* variables
+     * This makes environment variables available to browser code via process.env.NEXT_PUBLIC_*
+     */
+    private generateEnvScript;
+    /**
+     * Check if App Router is available
+     */
+    private hasAppRouter;
+    /**
+     * Handle an incoming HTTP request
+     */
+    handleRequest(method: string, url: string, headers: Record<string, string>, body?: Buffer): Promise<ResponseData>;
+    /**
+     * Serve Next.js shims (link, router, head, navigation)
+     */
+    private serveNextShim;
+    /**
+     * Serve static assets from /_next/static/
+     */
+    private serveStaticAsset;
+    /**
+     * Handle API route requests
+     */
+    private handleApiRoute;
+    /**
+     * Handle streaming API route requests
+     * This is called by the server bridge for requests that need streaming support
+     */
+    handleStreamingRequest(method: string, url: string, headers: Record<string, string>, body: Buffer | undefined, onStart: (statusCode: number, statusMessage: string, headers: Record<string, string>) => void, onChunk: (chunk: string | Uint8Array) => void, onEnd: () => void): Promise<void>;
+    /**
+     * Create a streaming mock response that calls callbacks as data is written
+     */
+    private createStreamingMockResponse;
+    /**
+     * Resolve API route to file path
+     */
+    private resolveApiFile;
+    /**
+     * Create mock Next.js request object
+     */
+    private createMockRequest;
+    /**
+     * Parse cookie header
+     */
+    private parseCookies;
+    /**
+     * Create mock Next.js response object with streaming support
+     */
+    private createMockResponse;
+    /**
+     * Execute API handler code
+     */
+    private executeApiHandler;
+    /**
+     * Handle page route requests
+     */
+    private handlePageRoute;
+    /**
+     * Handle App Router page requests
+     */
+    private handleAppRouterPage;
+    /**
+     * Resolve App Router route to page and layout files
+     */
+    private resolveAppRoute;
+    /**
+     * Resolve dynamic App Router routes like /app/[id]/page.jsx
+     */
+    private resolveAppDynamicRoute;
+    /**
+     * Generate HTML for App Router with nested layouts
+     */
+    private generateAppRouterHtml;
+    /**
+     * Resolve URL pathname to page file
+     */
+    private resolvePageFile;
+    /**
+     * Resolve dynamic routes like /users/[id]
+     */
+    private resolveDynamicRoute;
+    /**
+     * Generate HTML shell for a page
+     */
+    private generatePageHtml;
+    /**
+     * Serve a basic 404 page
+     */
+    private serve404Page;
+    /**
+     * Check if a file needs transformation
+     */
+    private needsTransform;
+    /**
+     * Transform and serve a JSX/TS file
+     */
+    private transformAndServe;
+    /**
+     * Transform JSX/TS code to browser-compatible JavaScript (ESM for browser)
+     */
+    private transformCode;
+    /**
+     * Strip CSS imports from code (they are loaded via <link> tags instead)
+     * Handles: import './styles.css', import '../globals.css', etc.
+     */
+    private stripCssImports;
+    /**
+     * Transform API handler code to CommonJS for eval execution
+     */
+    private transformApiHandler;
+    /**
+     * Add React Refresh registration to transformed code
+     */
+    private addReactRefresh;
+    /**
+     * Start file watching for HMR
+     */
+    startWatching(): void;
+    /**
+     * Handle file change event
+     */
+    private handleFileChange;
+    /**
+     * Stop the server
+     */
+    stop(): void;
+}
+export default NextDevServer;
+//# sourceMappingURL=next-dev-server.d.ts.map

package/dist/frameworks/next-dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-dev-server.d.ts","sourceRoot":"","sources":["../../src/frameworks/next-dev-server.ts"],"names":[],"mappings":"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"}

package/dist/frameworks/vite-dev-server.d.ts

@@ -0,0 +1,85 @@
+/**
+ * ViteDevServer - Vite-compatible dev server for browser environment
+ * Serves files from VirtualFS with JSX/TypeScript transformation
+ */
+import { DevServer, DevServerOptions, ResponseData } from '../dev-server';
+import { VirtualFS } from '../virtual-fs';
+import { Buffer } from '../shims/stream';
+export interface ViteDevServerOptions extends DevServerOptions {
+    /**
+     * Enable JSX transformation (default: true)
+     */
+    jsx?: boolean;
+    /**
+     * JSX factory function (default: 'React.createElement')
+     */
+    jsxFactory?: string;
+    /**
+     * JSX fragment function (default: 'React.Fragment')
+     */
+    jsxFragment?: string;
+    /**
+     * Auto-inject React import for JSX files (default: true)
+     */
+    jsxAutoImport?: boolean;
+}
+export declare class ViteDevServer extends DevServer {
+    private watcherCleanup;
+    private options;
+    private hmrTargetWindow;
+    constructor(vfs: VirtualFS, options: ViteDevServerOptions);
+    /**
+     * Set the target window for HMR updates (typically iframe.contentWindow)
+     * This enables HMR to work with sandboxed iframes via postMessage
+     */
+    setHMRTarget(targetWindow: Window): void;
+    /**
+     * Handle an incoming HTTP request
+     */
+    handleRequest(method: string, url: string, headers: Record<string, string>, body?: Buffer): Promise<ResponseData>;
+    /**
+     * Start file watching for HMR
+     */
+    startWatching(): void;
+    /**
+     * Handle file change event
+     */
+    private handleFileChange;
+    /**
+     * Stop the server
+     */
+    stop(): void;
+    /**
+     * Check if a file needs transformation
+     */
+    private needsTransform;
+    /**
+     * Transform and serve a JSX/TS file
+     */
+    private transformAndServe;
+    /**
+     * Transform JSX/TS code to browser-compatible JavaScript
+     */
+    private transformCode;
+    /**
+     * Add React Refresh registration to transformed code
+     * This enables true HMR (state-preserving) for React components
+     */
+    private addReactRefresh;
+    /**
+     * Serve CSS file as a JavaScript module that injects styles
+     * This is needed because ES module imports of CSS files need to return JS
+     */
+    private serveCssAsModule;
+    /**
+     * Serve HTML file with HMR client script injected
+     *
+     * IMPORTANT: React Refresh preamble MUST be injected before any module scripts.
+     * The preamble uses top-level await to block until React Refresh is loaded
+     * and injectIntoGlobalHook is called. This ensures React Refresh hooks into
+     * React BEFORE React is imported by any module.
+     */
+    private serveHtmlWithHMR;
+}
+export default ViteDevServer;
+//# sourceMappingURL=vite-dev-server.d.ts.map

package/dist/frameworks/vite-dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-dev-server.d.ts","sourceRoot":"","sources":["../../src/frameworks/vite-dev-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAa,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAqEzC,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAqLD,qBAAa,aAAc,SAAQ,SAAS;IAC1C,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,eAAe,CAAuB;gBAElC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB;IAWzD;;;OAGG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IA0ExB;;OAEG;IACH,aAAa,IAAI,IAAI;IAqCrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;YACW,iBAAiB;IAiC/B;;OAEG;YACW,aAAa;IAsC3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IA4DvB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;CAyCzB;AAED,eAAe,aAAa,CAAC"}