@punkestu/react-html 0.1.0 → 0.1.1

package/dist/client/hydrate.js

@@ -0,0 +1,80 @@
+import React from 'react';
+import { hydrateRoot, createRoot } from 'react-dom/client';
+export function hydrateIsland(islandName, Component) {
+    if (typeof window === 'undefined')
+        return;
+    const mountElements = document.querySelectorAll(`[data-island="${islandName}"]`);
+    mountElements.forEach((el) => {
+        // Prevent double hydration
+        if (el.hasAttribute('data-hydrated'))
+            return;
+        const rawProps = el.getAttribute('data-props');
+        let props = {};
+        if (rawProps) {
+            try {
+                props = JSON.parse(rawProps);
+            }
+            catch (err) {
+                console.error(`[react-html] Failed to parse props for island "${islandName}":`, err);
+            }
+        }
+        const directive = (el.getAttribute('data-client') || 'load');
+        const doHydrate = () => {
+            if (el.hasAttribute('data-hydrated'))
+                return;
+            el.setAttribute('data-hydrated', 'true');
+            try {
+                hydrateRoot(el, React.createElement(Component, props), {
+                    onRecoverableError(error) {
+                        // Suppress non-breaking hydration difference warnings
+                        console.debug(`[react-html] Island "${islandName}" hydration note:`, error);
+                    }
+                });
+            }
+            catch (err) {
+                console.warn(`[react-html] Hydration error on island "${islandName}", recovering with client mount:`, err);
+                const root = createRoot(el);
+                root.render(React.createElement(Component, props));
+            }
+        };
+        switch (directive) {
+            case 'idle': {
+                if ('requestIdleCallback' in window) {
+                    window.requestIdleCallback(doHydrate);
+                }
+                else {
+                    setTimeout(doHydrate, 200);
+                }
+                break;
+            }
+            case 'visible': {
+                if ('IntersectionObserver' in window) {
+                    const observer = new IntersectionObserver((entries, obs) => {
+                        entries.forEach((entry) => {
+                            if (entry.isIntersecting) {
+                                obs.disconnect();
+                                doHydrate();
+                            }
+                        });
+                    });
+                    observer.observe(el);
+                }
+                else {
+                    doHydrate();
+                }
+                break;
+            }
+            case 'load':
+            default: {
+                if (document.readyState === 'loading') {
+                    window.addEventListener('DOMContentLoaded', doHydrate, { once: true });
+                }
+                else {
+                    doHydrate();
+                }
+                break;
+            }
+        }
+    });
+}
+//# sourceMappingURL=hydrate.js.map

package/dist/client/hydrate.js.map

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

package/dist/core/bundler.d.ts

@@ -0,0 +1,7 @@
+import { IslandInstance } from './island-registry.js';
+export interface BundlerOptions {
+    outDir: string;
+    minify?: boolean;
+}
+export declare function bundleIslands(islands: IslandInstance[], options: BundlerOptions): Promise<string[]>;
+//# sourceMappingURL=bundler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../src/core/bundler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CA0GnB"}

package/dist/core/bundler.js

@@ -0,0 +1,103 @@
+import * as esbuild from 'esbuild';
+import fs from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export async function bundleIslands(islands, options) {
+    const { outDir, minify = true } = options;
+    const islandsOutputDir = path.join(outDir, 'assets', 'islands');
+    await fs.mkdir(islandsOutputDir, { recursive: true });
+    const tempDir = path.resolve(process.cwd(), '.react-html/temp-islands');
+    await fs.mkdir(tempDir, { recursive: true });
+    const uniqueIslandsMap = new Map();
+    for (const island of islands) {
+        if (!uniqueIslandsMap.has(island.name)) {
+            uniqueIslandsMap.set(island.name, island);
+        }
+    }
+    const bundledFiles = [];
+    // Locate hydrate module
+    const currentDir = import.meta.dirname || path.dirname(fileURLToPath(import.meta.url));
+    let hydratePath = path.resolve(currentDir, '../client/hydrate.js');
+    if (!existsSync(hydratePath)) {
+        hydratePath = path.resolve(currentDir, '../client/hydrate.ts');
+    }
+    let islandClientPath = path.resolve(currentDir, './island-client.js');
+    if (!existsSync(islandClientPath)) {
+        islandClientPath = path.resolve(currentDir, './island-client.ts');
+    }
+    for (const [name, island] of uniqueIslandsMap.entries()) {
+        let resolvedEntry = island.entryPath;
+        if (resolvedEntry.startsWith('file://')) {
+            resolvedEntry = fileURLToPath(resolvedEntry);
+        }
+        else {
+            resolvedEntry = path.resolve(resolvedEntry);
+        }
+        try {
+            await fs.access(resolvedEntry);
+        }
+        catch {
+            console.warn(`[react-html] Warning: Island source file not found for "${name}" at "${resolvedEntry}". Skipping client bundle.`);
+            continue;
+        }
+        // Create a virtual client entrypoint for this island
+        const virtualEntryFile = path.join(tempDir, `${name}.entry.ts`);
+        const virtualEntryCode = `
+import React from 'react';
+import { hydrateIsland } from ${JSON.stringify(hydratePath)};
+import * as Module from ${JSON.stringify(resolvedEntry)};
+
+const raw = Module.default || Module[${JSON.stringify(name)}] || Module;
+const Component = (raw && raw.__rawComponent) ? raw.__rawComponent : raw;
+
+hydrateIsland(${JSON.stringify(name)}, Component);
+`;
+        await fs.writeFile(virtualEntryFile, virtualEntryCode, 'utf8');
+        const outfile = path.join(islandsOutputDir, `${name}.js`);
+        await esbuild.build({
+            entryPoints: [virtualEntryFile],
+            outfile,
+            bundle: true,
+            format: 'esm',
+            platform: 'browser',
+            target: ['es2022'],
+            minify,
+            treeShaking: true,
+            define: {
+                'process.env.NODE_ENV': '"production"'
+            },
+            alias: {
+                'react-html': islandClientPath
+            },
+            plugins: [
+                {
+                    name: 'redirect-react-html-imports',
+                    setup(build) {
+                        // Redirect any import of react-html or root index to island-client
+                        build.onResolve({ filter: /(react-html|(\/|\\)(src|dist)(\/|\\)index(\.js|\.mjs|\.ts)?)$/ }, () => {
+                            return { path: islandClientPath };
+                        });
+                    }
+                }
+            ],
+            loader: {
+                '.tsx': 'tsx',
+                '.ts': 'ts',
+                '.jsx': 'jsx',
+                '.js': 'js',
+                '.css': 'empty'
+            }
+        });
+        bundledFiles.push(outfile);
+    }
+    // Cleanup virtual entry files
+    try {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    }
+    catch {
+        // Ignore cleanup error
+    }
+    return bundledFiles;
+}
+//# sourceMappingURL=bundler.js.map

package/dist/core/bundler.js.map

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

package/dist/core/formatter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Robust HTML formatter to output clean, readable HTML
+ * Preserves exact inner markup inside reactive islands to ensure seamless React hydration.
+ */
+export declare function formatHtml(html: string): string;
+//# sourceMappingURL=formatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/core/formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuF/C"}

package/dist/core/formatter.js

@@ -0,0 +1,74 @@
+/**
+ * Robust HTML formatter to output clean, readable HTML
+ * Preserves exact inner markup inside reactive islands to ensure seamless React hydration.
+ */
+export function formatHtml(html) {
+    // Extract and preserve island contents verbatim
+    const preservedIslands = [];
+    let clean = html.replace(/<!--__ISLAND_START__-->([\s\S]*?)<!--__ISLAND_END__-->/g, (_, inner) => {
+        const idx = preservedIslands.length;
+        preservedIslands.push(inner);
+        return `%%REACT_HTML_ISLAND_${idx}%%`;
+    });
+    // Strip React comment artifacts outside islands if any
+    clean = clean.replace(/<!-- -->/g, '');
+    const tokens = clean.split(/(<[^>]+>)/g).filter((t) => t.trim().length > 0);
+    let formatted = '';
+    let indent = 0;
+    const indentStr = '  ';
+    // Void tags that don't need closing or indentation changes
+    const voidTags = new Set([
+        'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input',
+        'link', 'meta', 'param', 'source', 'track', 'wbr', '!doctype'
+    ]);
+    // Tags where content is typically kept on the same line if brief
+    const inlineTags = new Set([
+        'title', 'span', 'strong', 'em', 'b', 'i', 'code', 'small', 'sub', 'sup'
+    ]);
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i].trim();
+        if (token.startsWith('<!DOCTYPE') || token.startsWith('<!doctype')) {
+            formatted += token + '\n';
+            continue;
+        }
+        if (token.startsWith('</')) {
+            // Closing tag
+            const match = token.match(/<\/([a-zA-Z0-9\-]+)/);
+            const tagName = match ? match[1].toLowerCase() : '';
+            indent = Math.max(0, indent - 1);
+            formatted += indentStr.repeat(indent) + token + '\n';
+        }
+        else if (token.startsWith('<') && !token.startsWith('<!--')) {
+            // Opening or self-closing tag
+            const match = token.match(/<([a-zA-Z0-9\-]+)/);
+            const tagName = match ? match[1].toLowerCase() : '';
+            const isSelfClosing = token.endsWith('/>') || voidTags.has(tagName);
+            // Check if next token is text and next-next token is closing tag
+            if (inlineTags.has(tagName) &&
+                i + 2 < tokens.length &&
+                !tokens[i + 1].trim().startsWith('<') &&
+                tokens[i + 2].trim().toLowerCase() === `</${tagName}>`) {
+                const text = tokens[i + 1].trim();
+                const closeTag = tokens[i + 2].trim();
+                formatted += indentStr.repeat(indent) + `${token}${text}${closeTag}\n`;
+                i += 2;
+                continue;
+            }
+            formatted += indentStr.repeat(indent) + token + '\n';
+            if (!isSelfClosing) {
+                indent++;
+            }
+        }
+        else {
+            // Standalone text content
+            formatted += indentStr.repeat(indent) + token + '\n';
+        }
+    }
+    // Restore preserved island markup untouched
+    let finalHtml = formatted.replace(/%%REACT_HTML_ISLAND_(\d+)%%/g, (_, idxStr) => {
+        const idx = parseInt(idxStr, 10);
+        return preservedIslands[idx] ?? '';
+    });
+    return finalHtml.trim() + '\n';
+}
+//# sourceMappingURL=formatter.js.map

package/dist/core/formatter.js.map

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

package/dist/core/island-client.d.ts

@@ -0,0 +1,9 @@
+import React, { ComponentType, ReactNode } from 'react';
+export declare function Island<P extends Record<string, unknown>>({ component: Component, props, children }: {
+    component: ComponentType<P>;
+    props?: P;
+    children?: ReactNode;
+    [key: string]: unknown;
+}): React.ReactElement;
+export declare function island<P extends Record<string, unknown>>(Component: ComponentType<P>, _sourcePath?: string, _customName?: string): ComponentType<P>;
+//# sourceMappingURL=island-client.d.ts.map

package/dist/core/island-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"island-client.d.ts","sourceRoot":"","sources":["../../src/core/island-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAExD,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACxD,SAAS,EAAE,SAAS,EACpB,KAAe,EACf,QAAQ,EACT,EAAE;IACD,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GAAG,KAAK,CAAC,YAAY,CAErB;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAC3B,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CAAC,CAAC,CAAC,CAElB"}

package/dist/core/island-client.js

@@ -0,0 +1,8 @@
+import React from 'react';
+export function Island({ component: Component, props = {}, children }) {
+    return React.createElement(Component, props, children);
+}
+export function island(Component, _sourcePath, _customName) {
+    return Component;
+}
+//# sourceMappingURL=island-client.js.map

package/dist/core/island-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"island-client.js","sourceRoot":"","sources":["../../src/core/island-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAmC,MAAM,OAAO,CAAC;AAExD,MAAM,UAAU,MAAM,CAAoC,EACxD,SAAS,EAAE,SAAS,EACpB,KAAK,GAAG,EAAO,EACf,QAAQ,EAMT;IACC,OAAO,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,SAA2B,EAC3B,WAAoB,EACpB,WAAoB;IAEpB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/island-registry.d.ts

@@ -0,0 +1,15 @@
+export interface IslandInstance {
+    id: string;
+    name: string;
+    entryPath: string;
+    props: Record<string, unknown>;
+    clientDirective?: 'load' | 'idle' | 'visible';
+}
+export interface RenderContext {
+    pagePath: string;
+    islands: IslandInstance[];
+}
+export declare function runWithRenderContext<T>(context: RenderContext, fn: () => T): T;
+export declare function getCurrentRenderContext(): RenderContext | undefined;
+export declare function registerIslandInContext(island: IslandInstance): void;
+//# sourceMappingURL=island-registry.d.ts.map

package/dist/core/island-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"island-registry.d.ts","sourceRoot":"","sources":["../../src/core/island-registry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAQD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE9E;AAED,wBAAgB,uBAAuB,IAAI,aAAa,GAAG,SAAS,CAEnE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAKpE"}

package/dist/core/island-registry.js

@@ -0,0 +1,17 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const GLOBAL_STORAGE_KEY = Symbol.for('__react_html_render_context__');
+const storage = globalThis[GLOBAL_STORAGE_KEY] ||
+    (globalThis[GLOBAL_STORAGE_KEY] = new AsyncLocalStorage());
+export function runWithRenderContext(context, fn) {
+    return storage.run(context, fn);
+}
+export function getCurrentRenderContext() {
+    return storage.getStore();
+}
+export function registerIslandInContext(island) {
+    const ctx = storage.getStore();
+    if (ctx) {
+        ctx.islands.push(island);
+    }
+}
+//# sourceMappingURL=island-registry.js.map

package/dist/core/island-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"island-registry.js","sourceRoot":"","sources":["../../src/core/island-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAerD,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAEvE,MAAM,OAAO,GACV,UAAkB,CAAC,kBAAkB,CAAC;IACvC,CAAE,UAAkB,CAAC,kBAAkB,CAAC,GAAG,IAAI,iBAAiB,EAAiB,CAAC,CAAC;AAErF,MAAM,UAAU,oBAAoB,CAAI,OAAsB,EAAE,EAAW;IACzE,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAsB;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC/B,IAAI,GAAG,EAAE,CAAC;QACR,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/core/island.d.ts

@@ -0,0 +1,32 @@
+import React, { ComponentType, ReactNode } from 'react';
+export interface IslandProps<P = Record<string, unknown>> {
+    /** Explicit island name (optional) */
+    name?: string;
+    /** Path to the island component file (relative or absolute) */
+    src?: string;
+    /** The React component to render */
+    component: ComponentType<P>;
+    /** Props passed to the component */
+    props?: P;
+    /** Client hydration directive (default: 'load') */
+    client?: 'load' | 'idle' | 'visible';
+    /** Optional wrapper tag, default: 'div' */
+    as?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    children?: ReactNode;
+}
+export declare function Island<P extends Record<string, unknown>>({ name, src, component: Component, props, client, as: Tag, className, style, children }: IslandProps<P>): React.ReactElement;
+/**
+ * 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 declare function island<P extends Record<string, unknown>>(Component: ComponentType<P>, sourcePath: string, customName?: string): ComponentType<P & {
+    client?: 'load' | 'idle' | 'visible';
+    as?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}>;
+//# sourceMappingURL=island.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"island.d.ts","sourceRoot":"","sources":["../../src/core/island.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMxD,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC5B,oCAAoC;IACpC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,2CAA2C;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACxD,IAAI,EACJ,GAAG,EACH,SAAS,EAAE,SAAS,EACpB,KAAe,EACf,MAAe,EACf,EAAE,EAAE,GAAW,EACf,SAAS,EACT,KAAK,EACL,QAAQ,EACT,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAqCrC;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAC3B,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,aAAa,CAAC,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;CAAE,CAAC,CA0B3H"}

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