@punkestu/react-html 0.1.0 → 0.1.1

package/dist/core/renderer.js

@@ -0,0 +1,53 @@
+import React from 'react';
+import { renderToStaticMarkup } from 'react-dom/server';
+import { runWithRenderContext } from './island-registry.js';
+import { formatHtml } from './formatter.js';
+export function renderPageToHtml(options) {
+    const { pagePath, Component, props = {}, metadata = {}, basePath = '' } = options;
+    const islands = [];
+    const rawMarkup = runWithRenderContext({ pagePath, islands }, () => renderToStaticMarkup(React.createElement(Component, props)));
+    let finalHtml = rawMarkup;
+    const hasHtmlTag = /<html[^>]*>/i.test(finalHtml);
+    const hasDoctype = /<!DOCTYPE html>/i.test(finalHtml);
+    // If component returned only body contents / fragments, wrap in standard HTML shell
+    if (!hasHtmlTag) {
+        const lang = metadata.lang || 'en';
+        const titleTag = metadata.title ? `<title>${metadata.title}</title>` : '';
+        const descTag = metadata.description ? `<meta name="description" content="${metadata.description}">` : '';
+        finalHtml = `<!DOCTYPE html>
+<html lang="${lang}">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  ${titleTag}
+  ${descTag}
+</head>
+<body>
+  ${finalHtml}
+</body>
+</html>`;
+    }
+    else if (!hasDoctype) {
+        finalHtml = `<!DOCTYPE html>\n${finalHtml}`;
+    }
+    // If there are islands, inject script tags before </body> or at the end of the file
+    if (islands.length > 0) {
+        // Collect unique island names
+        const uniqueIslands = Array.from(new Set(islands.map(i => i.name)));
+        const assetPrefix = basePath ? (basePath.endsWith('/') ? basePath : `${basePath}/`) : '/';
+        const scriptTags = uniqueIslands
+            .map(name => `<script type="module" src="${assetPrefix}assets/islands/${name}.js"></script>`)
+            .join('\n');
+        if (/<\/body>/i.test(finalHtml)) {
+            finalHtml = finalHtml.replace(/<\/body>/i, `${scriptTags}\n</body>`);
+        }
+        else {
+            finalHtml = `${finalHtml}\n${scriptTags}`;
+        }
+    }
+    return {
+        html: formatHtml(finalHtml),
+        islands
+    };
+}
+//# sourceMappingURL=renderer.js.map

package/dist/core/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/core/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAkB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAoB5C,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAClF,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,MAAM,SAAS,GAAG,oBAAoB,CACpC,EAAE,QAAQ,EAAE,OAAO,EAAE,EACrB,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAClE,CAAC;IAEF,IAAI,SAAS,GAAG,SAAS,CAAC;IAC1B,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtD,oFAAoF;IACpF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC;QACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,QAAQ,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,qCAAqC,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAE1G,SAAS,GAAG;cACF,IAAI;;;;IAId,QAAQ;IACR,OAAO;;;IAGP,SAAS;;QAEL,CAAC;IACP,CAAC;SAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,SAAS,GAAG,oBAAoB,SAAS,EAAE,CAAC;IAC9C,CAAC;IAED,oFAAoF;IACpF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,8BAA8B;QAC9B,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1F,MAAM,UAAU,GAAG,aAAa;aAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,8BAA8B,WAAW,kBAAkB,IAAI,gBAAgB,CAAC;aAC5F,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,UAAU,WAAW,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,SAAS,GAAG,GAAG,SAAS,KAAK,UAAU,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC;QAC3B,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export { Island, island } from './core/island.js';
+export type { IslandProps } from './core/island.js';
+export { hydrateIsland } from './client/hydrate.js';
+export { renderPageToHtml } from './core/renderer.js';
+export { createEngine, ReactHtmlEngine } from './server/engine.js';
+export type { EngineOptions } from './server/engine.js';
+export interface BuildConfig {
+    root?: string;
+    pagesDir?: string;
+    outDir?: string;
+    publicDir?: string;
+    minify?: boolean;
+}
+export interface BuildResult {
+    pages: {
+        input: string;
+        output: string;
+    }[];
+    islands: string[];
+    outDir: string;
+}
+export declare function build(config?: BuildConfig): Promise<BuildResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAqBD,wBAAsB,KAAK,CAAC,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAyF1E"}

package/dist/index.js

@@ -0,0 +1,104 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { loadPageModule, clearCache } from './core/loader.js';
+import { renderPageToHtml } from './core/renderer.js';
+import { bundleIslands } from './core/bundler.js';
+export { Island, island } from './core/island.js';
+export { hydrateIsland } from './client/hydrate.js';
+export { renderPageToHtml } from './core/renderer.js';
+export { createEngine, ReactHtmlEngine } from './server/engine.js';
+async function findFilesRecursively(dir, extensions) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await findFilesRecursively(fullPath, extensions)));
+        }
+        else if (entry.isFile()) {
+            const ext = path.extname(entry.name);
+            if (extensions.includes(ext) && !entry.name.startsWith('_') && !entry.name.includes('.test.')) {
+                files.push(fullPath);
+            }
+        }
+    }
+    return files;
+}
+export async function build(config = {}) {
+    const root = path.resolve(config.root || process.cwd());
+    const outDir = path.resolve(root, config.outDir || 'dist');
+    const minify = config.minify ?? true;
+    // Locate pages directory
+    let pagesDir = config.pagesDir ? path.resolve(root, config.pagesDir) : '';
+    if (!pagesDir) {
+        const candidateDirs = ['src/pages', 'pages'];
+        for (const cand of candidateDirs) {
+            const p = path.join(root, cand);
+            try {
+                const stat = await fs.stat(p);
+                if (stat.isDirectory()) {
+                    pagesDir = p;
+                    break;
+                }
+            }
+            catch {
+                // Continue checking
+            }
+        }
+    }
+    if (!pagesDir) {
+        throw new Error(`Pages directory not found. Please create 'src/pages' or specify 'pagesDir'.`);
+    }
+    // Ensure output directory exists and is clean
+    await fs.mkdir(outDir, { recursive: true });
+    // Copy public static directory if present
+    const publicDir = path.resolve(root, config.publicDir || 'public');
+    try {
+        const publicStat = await fs.stat(publicDir);
+        if (publicStat.isDirectory()) {
+            await fs.cp(publicDir, outDir, { recursive: true });
+        }
+    }
+    catch {
+        // Public directory optional
+    }
+    const pageFiles = await findFilesRecursively(pagesDir, ['.tsx', '.jsx', '.ts', '.js']);
+    if (pageFiles.length === 0) {
+        console.warn(`[react-html] No pages found in ${pagesDir}`);
+    }
+    const allDiscoveredIslands = [];
+    const processedPages = [];
+    for (const pageFile of pageFiles) {
+        const relativePage = path.relative(pagesDir, pageFile);
+        const parsed = path.parse(relativePage);
+        // Compute destination path: index.tsx -> index.html, about.tsx -> about.html
+        const outHtmlFile = path.join(outDir, parsed.dir, `${parsed.name}.html`);
+        await fs.mkdir(path.dirname(outHtmlFile), { recursive: true });
+        // Load page module
+        const { Component, metadata } = await loadPageModule(pageFile);
+        // Render to pure HTML and extract islands
+        const { html, islands } = renderPageToHtml({
+            pagePath: pageFile,
+            Component,
+            metadata
+        });
+        await fs.writeFile(outHtmlFile, html, 'utf8');
+        processedPages.push({ input: pageFile, output: outHtmlFile });
+        if (islands.length > 0) {
+            allDiscoveredIslands.push(...islands);
+        }
+    }
+    // Bundle reactive islands
+    let bundledIslands = [];
+    if (allDiscoveredIslands.length > 0) {
+        bundledIslands = await bundleIslands(allDiscoveredIslands, { outDir, minify });
+    }
+    // Cleanup compile cache
+    await clearCache();
+    return {
+        pages: processedPages,
+        islands: bundledIslands,
+        outDir
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1,8 @@
+import http from 'node:http';
+import { BuildConfig } from '../index.js';
+export interface DevServerOptions extends BuildConfig {
+    port?: number;
+    host?: string;
+}
+export declare function createDevServer(options?: DevServerOptions): Promise<http.Server>;
+//# sourceMappingURL=dev-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/server/dev-server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAS,WAAW,EAAE,MAAM,aAAa,CAAC;AAiBjD,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAiG1F"}

package/dist/server/dev-server.js

@@ -0,0 +1,112 @@
+import http from 'node:http';
+import fs from 'node:fs/promises';
+import { existsSync, watch } from 'node:fs';
+import path from 'node:path';
+import { build } from '../index.js';
+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',
+    '.woff2': 'font/woff2'
+};
+export async function createDevServer(options = {}) {
+    const port = options.port || 3000;
+    const host = options.host || 'localhost';
+    const root = path.resolve(options.root || process.cwd());
+    const outDir = path.resolve(root, options.outDir || 'dist');
+    console.log(`[react-html] Performing initial build...`);
+    await build({ ...options, minify: false });
+    console.log(`[react-html] Build completed.`);
+    // Setup file watcher with debounce
+    let isRebuilding = false;
+    let rebuildTimeout = null;
+    const triggerRebuild = () => {
+        if (rebuildTimeout)
+            clearTimeout(rebuildTimeout);
+        rebuildTimeout = setTimeout(async () => {
+            if (isRebuilding)
+                return;
+            isRebuilding = true;
+            try {
+                console.log(`[react-html] Change detected, rebuilding...`);
+                const startTime = Date.now();
+                await build({ ...options, minify: false });
+                console.log(`[react-html] Rebuild finished in ${Date.now() - startTime}ms`);
+            }
+            catch (err) {
+                console.error(`[react-html] Rebuild error:`, err);
+            }
+            finally {
+                isRebuilding = false;
+            }
+        }, 100);
+    };
+    const watchDirs = ['src', 'pages', 'public'].map(d => path.join(root, d)).filter(existsSync);
+    for (const dir of watchDirs) {
+        try {
+            watch(dir, { recursive: true }, (event, filename) => {
+                if (filename && !filename.includes('.react-html') && !filename.includes('dist')) {
+                    triggerRebuild();
+                }
+            });
+        }
+        catch {
+            // Fallback
+        }
+    }
+    const server = http.createServer(async (req, res) => {
+        try {
+            const url = new URL(req.url || '/', `http://${host}:${port}`);
+            let pathname = decodeURIComponent(url.pathname);
+            if (pathname.endsWith('/')) {
+                pathname += 'index.html';
+            }
+            let filePath = path.join(outDir, pathname);
+            // If no extension, check if an .html file exists
+            if (!path.extname(filePath)) {
+                if (existsSync(`${filePath}.html`)) {
+                    filePath = `${filePath}.html`;
+                }
+                else if (existsSync(path.join(filePath, 'index.html'))) {
+                    filePath = path.join(filePath, 'index.html');
+                }
+            }
+            if (!existsSync(filePath)) {
+                res.writeHead(404, { 'Content-Type': 'text/html' });
+                res.end(`<h1>404 Not Found</h1><p>File not found: ${pathname}</p>`);
+                return;
+            }
+            const stat = await fs.stat(filePath);
+            if (stat.isDirectory()) {
+                filePath = path.join(filePath, 'index.html');
+            }
+            const ext = path.extname(filePath).toLowerCase();
+            const contentType = MIME_TYPES[ext] || 'application/octet-stream';
+            const content = await fs.readFile(filePath);
+            res.writeHead(200, {
+                'Content-Type': contentType,
+                'Content-Length': content.length
+            });
+            res.end(content);
+        }
+        catch (err) {
+            res.writeHead(500, { 'Content-Type': 'text/plain' });
+            res.end(`500 Internal Server Error: ${err?.message || err}`);
+        }
+    });
+    return new Promise((resolve) => {
+        server.listen(port, host, () => {
+            console.log(`[react-html] Dev server running at http://${host}:${port}/`);
+            resolve(server);
+        });
+    });
+}
+//# sourceMappingURL=dev-server.js.map

package/dist/server/dev-server.js.map

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

package/dist/server/engine.d.ts

@@ -0,0 +1,46 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export interface EngineOptions {
+    /** Project root directory (default: process.cwd()) */
+    root?: string;
+    /** Source pages directory (default: 'src/pages' or 'pages') */
+    pagesDir?: string;
+    /** Production build output directory (default: 'dist') */
+    distDir?: string;
+    /** Static public directory (default: 'public') */
+    publicDir?: string;
+    /** Force production mode. If omitted, checks process.env.NODE_ENV === 'production' */
+    isProduction?: boolean;
+    /** Base asset URL prefix (default: '/') */
+    basePath?: string;
+}
+export declare class ReactHtmlEngine {
+    readonly root: string;
+    readonly pagesDir: string;
+    readonly distDir: string;
+    readonly publicDir: string;
+    readonly isProduction: boolean;
+    readonly basePath: string;
+    constructor(options?: EngineOptions);
+    /**
+     * Render a page by name or route.
+     * - In production: checks for pre-built static HTML in dist/ first.
+     * - In development: recompiles the TSX page on the fly and bundles any needed reactive islands.
+     */
+    render(pageRoute: string, props?: Record<string, unknown>, metadata?: Record<string, unknown>): Promise<string>;
+    /**
+     * Universal Connect / Express / Node.js HTTP middleware.
+     * Handles page routes and static assets according to environment mode.
+     */
+    middleware: (req: IncomingMessage, res: ServerResponse, next?: () => void) => Promise<void>;
+    /**
+     * Standalone HTTP request handler suitable for http.createServer(engine.handle)
+     */
+    handle: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    private resolveSourcePage;
+    private tryServeStaticAsset;
+}
+/**
+ * Factory function to create a new ReactHtmlEngine instance
+ */
+export declare function createEngine(options?: EngineOptions): ReactHtmlEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/server/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/server/engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAMjE,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAiBD,qBAAa,eAAe;IAC1B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,YAAY,EAAE,OAAO,CAAC;IACtC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,OAAO,GAAE,aAAkB;IA6BvC;;;;OAIG;IACU,MAAM,CACjB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACnC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,MAAM,CAAC;IAgDlB;;;OAGG;IACI,UAAU,GACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,OAAO,MAAM,IAAI,KAChB,OAAO,CAAC,IAAI,CAAC,CAoEd;IAEF;;OAEG;IACI,MAAM,GAAI,KAAK,eAAe,EAAE,KAAK,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC,CAExE;YAEY,iBAAiB;YAejB,mBAAmB;CA4BlC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,eAAe,CAEzE"}

package/dist/server/engine.js

@@ -0,0 +1,222 @@
+import fs from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { loadPageModule } from '../core/loader.js';
+import { renderPageToHtml } from '../core/renderer.js';
+import { bundleIslands } from '../core/bundler.js';
+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',
+    '.woff2': 'font/woff2'
+};
+export class ReactHtmlEngine {
+    root;
+    pagesDir;
+    distDir;
+    publicDir;
+    isProduction;
+    basePath;
+    constructor(options = {}) {
+        this.root = path.resolve(options.root || process.cwd());
+        this.isProduction =
+            options.isProduction !== undefined
+                ? options.isProduction
+                : process.env.NODE_ENV === 'production';
+        this.basePath = options.basePath || '/';
+        // Resolve distDir
+        this.distDir = path.resolve(this.root, options.distDir || 'dist');
+        this.publicDir = path.resolve(this.root, options.publicDir || 'public');
+        // Resolve pagesDir
+        if (options.pagesDir) {
+            this.pagesDir = path.resolve(this.root, options.pagesDir);
+        }
+        else {
+            const candidates = ['src/pages', 'pages'];
+            let found = path.join(this.root, 'src/pages');
+            for (const cand of candidates) {
+                const p = path.join(this.root, cand);
+                if (existsSync(p)) {
+                    found = p;
+                    break;
+                }
+            }
+            this.pagesDir = found;
+        }
+    }
+    /**
+     * Render a page by name or route.
+     * - In production: checks for pre-built static HTML in dist/ first.
+     * - In development: recompiles the TSX page on the fly and bundles any needed reactive islands.
+     */
+    async render(pageRoute, props = {}, metadata = {}) {
+        const cleanRoute = pageRoute.replace(/^\/+/, '').replace(/\.html$/, '');
+        const normalizedName = cleanRoute === '' ? 'index' : cleanRoute;
+        // In production, check for pre-built static HTML
+        if (this.isProduction) {
+            const candidatePaths = [
+                path.join(this.distDir, `${normalizedName}.html`),
+                path.join(this.distDir, normalizedName, 'index.html')
+            ];
+            for (const candidate of candidatePaths) {
+                if (existsSync(candidate)) {
+                    return await fs.readFile(candidate, 'utf8');
+                }
+            }
+        }
+        // In development (or if production pre-build not found), compile on-the-fly
+        const sourceFilePath = await this.resolveSourcePage(normalizedName);
+        if (!sourceFilePath) {
+            throw new Error(`[react-html] Page "${pageRoute}" not found in "${this.pagesDir}".`);
+        }
+        const { Component, metadata: pageMeta } = await loadPageModule(sourceFilePath);
+        const mergedMetadata = { ...pageMeta, ...metadata };
+        const { html, islands } = renderPageToHtml({
+            pagePath: sourceFilePath,
+            Component,
+            props,
+            metadata: mergedMetadata,
+            basePath: this.basePath
+        });
+        // In development, bundle reactive islands on-the-fly into distDir/assets/islands
+        if (islands.length > 0) {
+            await bundleIslands(islands, {
+                outDir: this.distDir,
+                minify: this.isProduction
+            });
+        }
+        return html;
+    }
+    /**
+     * Universal Connect / Express / Node.js HTTP middleware.
+     * Handles page routes and static assets according to environment mode.
+     */
+    middleware = async (req, res, next) => {
+        const url = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`);
+        let pathname = decodeURIComponent(url.pathname);
+        // 1. Check if request matches an asset in dist/ or public/
+        const assetResponse = await this.tryServeStaticAsset(pathname);
+        if (assetResponse) {
+            res.writeHead(200, {
+                'Content-Type': assetResponse.contentType,
+                'Content-Length': assetResponse.content.length
+            });
+            res.end(assetResponse.content);
+            return;
+        }
+        // 2. Normalize page route
+        let route = pathname.replace(/^\/+/, '').replace(/\/+$/, '');
+        if (route === '' || route.endsWith('.html')) {
+            route = route.replace(/\.html$/, '') || 'index';
+        }
+        // 3. Try rendering the page
+        try {
+            // In production: check if dist HTML exists
+            if (this.isProduction) {
+                const candidatePaths = [
+                    path.join(this.distDir, `${route}.html`),
+                    path.join(this.distDir, route, 'index.html')
+                ];
+                for (const candidate of candidatePaths) {
+                    if (existsSync(candidate)) {
+                        const content = await fs.readFile(candidate);
+                        res.writeHead(200, {
+                            'Content-Type': 'text/html; charset=utf-8',
+                            'Content-Length': content.length
+                        });
+                        res.end(content);
+                        return;
+                    }
+                }
+            }
+            else {
+                // In development: check if source page exists
+                const sourcePath = await this.resolveSourcePage(route);
+                if (sourcePath) {
+                    const html = await this.render(route);
+                    const buffer = Buffer.from(html, 'utf8');
+                    res.writeHead(200, {
+                        'Content-Type': 'text/html; charset=utf-8',
+                        'Content-Length': buffer.length
+                    });
+                    res.end(buffer);
+                    return;
+                }
+            }
+        }
+        catch (err) {
+            console.error(`[react-html] Engine rendering error for route "${pathname}":`, err);
+            res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
+            res.end(`500 Internal Server Error: ${err?.message || err}`);
+            return;
+        }
+        // If not handled, pass to next middleware if available
+        if (typeof next === 'function') {
+            next();
+        }
+        else {
+            res.writeHead(404, { 'Content-Type': 'text/html; charset=utf-8' });
+            res.end(`<h1>404 Not Found</h1><p>Route "${pathname}" not found.</p>`);
+        }
+    };
+    /**
+     * Standalone HTTP request handler suitable for http.createServer(engine.handle)
+     */
+    handle = (req, res) => {
+        return this.middleware(req, res);
+    };
+    async resolveSourcePage(normalizedName) {
+        const extensions = ['.tsx', '.jsx', '.ts', '.js'];
+        const candidates = [
+            ...extensions.map(ext => path.join(this.pagesDir, `${normalizedName}${ext}`)),
+            ...extensions.map(ext => path.join(this.pagesDir, normalizedName, `index${ext}`))
+        ];
+        for (const cand of candidates) {
+            if (existsSync(cand)) {
+                return cand;
+            }
+        }
+        return null;
+    }
+    async tryServeStaticAsset(pathname) {
+        const ext = path.extname(pathname).toLowerCase();
+        if (!ext || ext === '.html')
+            return null;
+        const cleanPath = pathname.replace(/^\/+/, '');
+        const candidateFiles = [
+            path.join(this.distDir, cleanPath),
+            path.join(this.publicDir, cleanPath)
+        ];
+        for (const filePath of candidateFiles) {
+            if (existsSync(filePath)) {
+                try {
+                    const stat = await fs.stat(filePath);
+                    if (stat.isFile()) {
+                        const content = await fs.readFile(filePath);
+                        const contentType = MIME_TYPES[ext] || 'application/octet-stream';
+                        return { content, contentType };
+                    }
+                }
+                catch {
+                    // Continue searching
+                }
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Factory function to create a new ReactHtmlEngine instance
+ */
+export function createEngine(options = {}) {
+    return new ReactHtmlEngine(options);
+}
+//# sourceMappingURL=engine.js.map

package/dist/server/engine.js.map

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

package/{src/server/index.ts → dist/server/index.d.ts}

@@ -2,4 +2,4 @@ export { ReactHtmlEngine, createEngine } from './engine.js';
 export type { EngineOptions } from './engine.js';
 export { createDevServer } from './dev-server.js';
 export type { DevServerOptions } from './dev-server.js';
-
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,3 @@
+export { ReactHtmlEngine, createEngine } from './engine.js';
+export { createDevServer } from './dev-server.js';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}