@punkestu/react-html 0.0.0-stage → 0.1.1

package/dist/core/island.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { renderToString } from 'react-dom/server';
+import { registerIslandInContext } from './island-registry.js';
+let islandCounter = 0;
+export function Island({ name, src, component: Component, props = {}, client = 'load', as: Tag = 'div', className, style, children }) {
+    const componentName = name ||
+        Component.__islandName ||
+        Component.displayName ||
+        Component.name ||
+        'AnonymousIsland';
+    const islandId = `island-${++islandCounter}`;
+    // If src is specified or attached to component
+    const entryPath = src || Component.__islandPath || '';
+    registerIslandInContext({
+        id: islandId,
+        name: componentName,
+        entryPath,
+        props,
+        clientDirective: client
+    });
+    const Wrapper = Tag;
+    // Use renderToString for the island's inner tree to produce hydration-compatible SSR markup
+    const innerHtml = renderToString(React.createElement(Component, props, children));
+    return (_jsx(Wrapper, { "data-island": componentName, "data-island-id": islandId, "data-props": JSON.stringify(props), "data-client": client, className: className, style: style, dangerouslySetInnerHTML: { __html: `<!--__ISLAND_START__-->${innerHtml}<!--__ISLAND_END__-->` } }));
+}
+/**
+ * Helper to wrap any React component into a ready-to-use Island component
+ * Example:
+ *   export const Counter = island(CounterComponent, import.meta.url, 'Counter');
+ *   // In page: <Counter initialCount={5} />
+ */
+export function island(Component, sourcePath, customName) {
+    const resolvedName = customName || Component.displayName || Component.name || 'AnonymousIsland';
+    Component.__islandPath = sourcePath;
+    Component.__islandName = resolvedName;
+    const IslandWrapper = (props) => {
+        const { client, as, className, style, ...componentProps } = props;
+        return (_jsx(Island, { name: resolvedName, src: sourcePath, component: Component, props: componentProps, client: client, as: as, className: className, style: style }));
+    };
+    IslandWrapper.displayName = `Island(${resolvedName})`;
+    IslandWrapper.__islandPath = sourcePath;
+    IslandWrapper.__islandName = resolvedName;
+    IslandWrapper.__rawComponent = Component;
+    return IslandWrapper;
+}
+//# sourceMappingURL=island.js.map

package/dist/core/island.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"island.js","sourceRoot":"","sources":["../../src/core/island.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAmC,MAAM,OAAO,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,IAAI,aAAa,GAAG,CAAC,CAAC;AAoBtB,MAAM,UAAU,MAAM,CAAoC,EACxD,IAAI,EACJ,GAAG,EACH,SAAS,EAAE,SAAS,EACpB,KAAK,GAAG,EAAO,EACf,MAAM,GAAG,MAAM,EACf,EAAE,EAAE,GAAG,GAAG,KAAK,EACf,SAAS,EACT,KAAK,EACL,QAAQ,EACO;IACf,MAAM,aAAa,GACjB,IAAI;QACH,SAAiB,CAAC,YAAY;QAC/B,SAAS,CAAC,WAAW;QACrB,SAAS,CAAC,IAAI;QACd,iBAAiB,CAAC;IAEpB,MAAM,QAAQ,GAAG,UAAU,EAAE,aAAa,EAAE,CAAC;IAE7C,+CAA+C;IAC/C,MAAM,SAAS,GAAG,GAAG,IAAK,SAAiB,CAAC,YAAY,IAAI,EAAE,CAAC;IAE/D,uBAAuB,CAAC;QACtB,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,aAAa;QACnB,SAAS;QACT,KAAK;QACL,eAAe,EAAE,MAAM;KACxB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,GAAU,CAAC;IAE3B,4FAA4F;IAC5F,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElF,OAAO,CACL,KAAC,OAAO,mBACO,aAAa,oBACV,QAAQ,gBACZ,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,iBACpB,MAAM,EACnB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,uBAAuB,EAAE,EAAE,MAAM,EAAE,0BAA0B,SAAS,uBAAuB,EAAE,GAC/F,CACH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CACpB,SAA2B,EAC3B,UAAkB,EAClB,UAAmB;IAEnB,MAAM,YAAY,GAAG,UAAU,IAAI,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI,IAAI,iBAAiB,CAAC;IAC/F,SAAiB,CAAC,YAAY,GAAG,UAAU,CAAC;IAC5C,SAAiB,CAAC,YAAY,GAAG,YAAY,CAAC;IAE/C,MAAM,aAAa,GAAG,CAAC,KAAiH,EAAE,EAAE;QAC1I,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC;QAClE,OAAO,CACL,KAAC,MAAM,IACL,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,cAAmB,EAC1B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,GACZ,CACH,CAAC;IACJ,CAAC,CAAC;IAEF,aAAa,CAAC,WAAW,GAAG,UAAU,YAAY,GAAG,CAAC;IACrD,aAAqB,CAAC,YAAY,GAAG,UAAU,CAAC;IAChD,aAAqB,CAAC,YAAY,GAAG,YAAY,CAAC;IAClD,aAAqB,CAAC,cAAc,GAAG,SAAS,CAAC;IAClD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/core/loader.d.ts

@@ -0,0 +1,11 @@
+export interface LoadedPage {
+    Component: React.ComponentType<any>;
+    metadata?: {
+        title?: string;
+        description?: string;
+        [key: string]: unknown;
+    };
+}
+export declare function loadPageModule(pageFilePath: string): Promise<LoadedPage>;
+export declare function clearCache(): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/core/loader.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAyBD,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA0C9E;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAMhD"}

package/dist/core/loader.js

@@ -0,0 +1,73 @@
+import * as esbuild from 'esbuild';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { pathToFileURL } from 'node:url';
+const CACHE_DIR = path.resolve(process.cwd(), '.react-html/cache');
+// Plugin to replace import.meta.url with the real source file URL
+const importMetaUrlPlugin = {
+    name: 'preserve-import-meta-url',
+    setup(build) {
+        build.onLoad({ filter: /\.(tsx|ts|jsx|js)$/ }, async (args) => {
+            if (args.path.includes('node_modules'))
+                return null;
+            let text = await fs.readFile(args.path, 'utf8');
+            if (text.includes('import.meta.url')) {
+                const fileUrl = pathToFileURL(args.path).href;
+                text = text.replaceAll('import.meta.url', JSON.stringify(fileUrl));
+                const ext = path.extname(args.path).slice(1);
+                return {
+                    contents: text,
+                    loader: (ext === 'js' || ext === 'jsx' || ext === 'ts' || ext === 'tsx') ? ext : 'tsx'
+                };
+            }
+            return null;
+        });
+    }
+};
+export async function loadPageModule(pageFilePath) {
+    await fs.mkdir(CACHE_DIR, { recursive: true });
+    const resolvedPath = path.resolve(pageFilePath);
+    const hash = crypto.createHash('sha256').update(resolvedPath).digest('hex').slice(0, 12);
+    const cacheFilePath = path.join(CACHE_DIR, `page-${hash}.mjs`);
+    // Build the page bundle for Node.js execution
+    await esbuild.build({
+        entryPoints: [resolvedPath],
+        outfile: cacheFilePath,
+        bundle: true,
+        format: 'esm',
+        platform: 'node',
+        target: 'node22',
+        packages: 'external',
+        sourcemap: 'inline',
+        plugins: [importMetaUrlPlugin],
+        loader: {
+            '.tsx': 'tsx',
+            '.ts': 'ts',
+            '.jsx': 'jsx',
+            '.js': 'js',
+            '.css': 'empty'
+        }
+    });
+    // Dynamic import with timestamp cache buster
+    const fileUrl = `${pathToFileURL(cacheFilePath).href}?t=${Date.now()}`;
+    const importedModule = await import(fileUrl);
+    const Component = importedModule.default;
+    if (!Component) {
+        throw new Error(`Page "${pageFilePath}" does not have a default export. Please provide "export default function Page()".`);
+    }
+    const { default: _, ...metadata } = importedModule;
+    return {
+        Component,
+        metadata
+    };
+}
+export async function clearCache() {
+    try {
+        await fs.rm(CACHE_DIR, { recursive: true, force: true });
+    }
+    catch {
+        // Ignore cache cleanup errors
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/loader.js.map

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

package/dist/core/renderer.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { IslandInstance } from './island-registry.js';
+export interface RenderResult {
+    html: string;
+    islands: IslandInstance[];
+}
+export interface RenderOptions {
+    pagePath: string;
+    Component: React.ComponentType<any>;
+    props?: Record<string, unknown>;
+    metadata?: {
+        title?: string;
+        description?: string;
+        lang?: string;
+        [key: string]: unknown;
+    };
+    basePath?: string;
+}
+export declare function renderPageToHtml(options: RenderOptions): RenderResult;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/core/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/core/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAwB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAuDrE"}

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"}