@punkestu/react-html 0.1.0 → 1.0.0

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-discovery.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Checks whether a given file path should be treated as a reactive island.
+ * Matches:
+ * - *.island.tsx, *.island.jsx, *.island.ts, *.island.js
+ * - Any component located in an `islands/` or `src/islands/` folder
+ */
+export declare function isIslandFile(filePath: string): boolean;
+/**
+ * Derives a clean PascalCase island identifier name from a file path.
+ * e.g. "Counter.island.tsx" -> "Counter"
+ * e.g. "dropdown-menu.island.jsx" -> "DropdownMenu"
+ */
+export declare function getIslandName(filePath: string): string;
+/**
+ * Transforms an island component source code to automatically wrap its default export
+ * with `island(...)` for server-side rendering, if not already wrapped.
+ */
+export declare function transformIslandSource(code: string, filePath: string): string;
+//# sourceMappingURL=island-discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"island-discovery.d.ts","sourceRoot":"","sources":["../../src/core/island-discovery.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAStD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA6E5E"}

package/dist/core/island-discovery.js

@@ -0,0 +1,92 @@
+import path from 'node:path';
+import { pathToFileURL, fileURLToPath } from 'node:url';
+/**
+ * Checks whether a given file path should be treated as a reactive island.
+ * Matches:
+ * - *.island.tsx, *.island.jsx, *.island.ts, *.island.js
+ * - Any component located in an `islands/` or `src/islands/` folder
+ */
+export function isIslandFile(filePath) {
+    if (filePath.includes('node_modules') || filePath.includes('.test.')) {
+        return false;
+    }
+    const isIslandExt = /\.island\.(tsx|ts|jsx|js)$/i.test(filePath);
+    const isInIslandsDir = /(?:^|[\\/])islands[\\/].*?\.(tsx|ts|jsx|js)$/i.test(filePath);
+    return isIslandExt || isInIslandsDir;
+}
+/**
+ * Derives a clean PascalCase island identifier name from a file path.
+ * e.g. "Counter.island.tsx" -> "Counter"
+ * e.g. "dropdown-menu.island.jsx" -> "DropdownMenu"
+ */
+export function getIslandName(filePath) {
+    const base = path.basename(filePath)
+        .replace(/\.island\.(tsx|ts|jsx|js)$/i, '')
+        .replace(/\.(tsx|ts|jsx|js)$/i, '');
+    // Convert kebab-case or snake_case to PascalCase
+    const pascal = base.replace(/(?:^|[-_])([a-z0-9])/gi, (_, char) => char.toUpperCase());
+    // Ensure it is a valid JavaScript identifier
+    return pascal.replace(/[^a-zA-Z0-9_$]/g, '') || 'AnonymousIsland';
+}
+/**
+ * Transforms an island component source code to automatically wrap its default export
+ * with `island(...)` for server-side rendering, if not already wrapped.
+ */
+export function transformIslandSource(code, filePath) {
+    // If the file already manually uses island() or createIsland(), preserve it as is
+    if (/\bisland\s*\(/i.test(code) || /\bcreateIsland\s*\(/i.test(code)) {
+        return code;
+    }
+    // Must have an export default to auto-wrap
+    if (!code.includes('export default')) {
+        return code;
+    }
+    const islandName = getIslandName(filePath);
+    const fileUrl = pathToFileURL(path.resolve(filePath)).href;
+    let transformed = code;
+    let targetIdentifier = '__react_html_island_target__';
+    // Case 1: export default function [Name](...) or export default function(...)
+    const fnMatch = transformed.match(/export\s+default\s+function(?:\s+([a-zA-Z0-9_$]+))?\s*\(/);
+    if (fnMatch) {
+        const existingName = fnMatch[1];
+        if (existingName) {
+            targetIdentifier = existingName;
+            transformed = transformed.replace(/export\s+default\s+function\s+([a-zA-Z0-9_$]+)/, 'function $1');
+        }
+        else {
+            transformed = transformed.replace(/export\s+default\s+function\s*\(/, `function ${targetIdentifier}(`);
+        }
+    }
+    // Case 2: export default class [Name]
+    else if (/export\s+default\s+class\s+([a-zA-Z0-9_$]+)/.test(transformed)) {
+        const classMatch = transformed.match(/export\s+default\s+class\s+([a-zA-Z0-9_$]+)/);
+        targetIdentifier = classMatch[1];
+        transformed = transformed.replace(/export\s+default\s+class\s+([a-zA-Z0-9_$]+)/, 'class $1');
+    }
+    // Case 3: export default Identifier;
+    else if (/export\s+default\s+([a-zA-Z0-9_$]+)\s*;?$/.test(transformed.trim())) {
+        const idMatch = transformed.trim().match(/export\s+default\s+([a-zA-Z0-9_$]+)\s*;?$/);
+        if (idMatch) {
+            targetIdentifier = idMatch[1];
+            transformed = transformed.replace(new RegExp(`export\\s+default\\s+${targetIdentifier}\\s*;?`), '');
+        }
+    }
+    // Case 4: export default <Expression> (e.g. arrow function or memo call)
+    else {
+        transformed = transformed.replace(/export\s+default\s+/, `const ${targetIdentifier} = `);
+    }
+    const islandHelperPath = fileURLToPath(new URL('./island.js', import.meta.url));
+    // Append island wrapping code
+    const wrapperCode = `
+import { island as __react_html_auto_island__ } from ${JSON.stringify(islandHelperPath)};
+const __react_html_wrapped_island__ = __react_html_auto_island__(
+  ${targetIdentifier},
+  ${JSON.stringify(fileUrl)},
+  ${JSON.stringify(islandName)}
+);
+export default __react_html_wrapped_island__;
+export { __react_html_wrapped_island__ as ${islandName} };
+`;
+    return `${transformed}\n${wrapperCode}`;
+}
+//# sourceMappingURL=island-discovery.js.map

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

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

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":"AAOA,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;AA2CD,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,87 @@
+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';
+import { isIslandFile, transformIslandSource } from './island-discovery.js';
+const CACHE_DIR = path.resolve(process.cwd(), '.react-html/cache');
+// Plugin to auto-wrap island components and preserve import.meta.url
+const islandAndMetaPlugin = {
+    name: 'island-auto-discovery-and-meta',
+    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');
+            let modified = false;
+            // 1. Auto-wrap island files if they match island conventions
+            if (isIslandFile(args.path)) {
+                const transformed = transformIslandSource(text, args.path);
+                if (transformed !== text) {
+                    text = transformed;
+                    modified = true;
+                }
+            }
+            // 2. Preserve real file URL for any import.meta.url
+            if (text.includes('import.meta.url')) {
+                const fileUrl = pathToFileURL(args.path).href;
+                text = text.replaceAll('import.meta.url', JSON.stringify(fileUrl));
+                modified = true;
+            }
+            if (modified) {
+                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: [islandAndMetaPlugin],
+        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,27 @@
+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 { isIslandFile, getIslandName, transformIslandSource } from './core/island-discovery.js';
+export { bundleIslands } from './core/bundler.js';
+export type { ClientRuntime, BundlerOptions } from './core/bundler.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;
+    clientRuntime?: 'react' | 'preact';
+}
+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,aAAa,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,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;IACjB,aAAa,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CACpC;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,CA6F1E"}

package/dist/index.js

@@ -0,0 +1,110 @@
+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 { isIslandFile, getIslandName, transformIslandSource } from './core/island-discovery.js';
+export { bundleIslands } from './core/bundler.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,
+            clientRuntime: config.clientRuntime
+        });
+    }
+    // Cleanup compile cache
+    await clearCache();
+    return {
+        pages: processedPages,
+        islands: bundledIslands,
+        outDir
+    };
+}
+//# sourceMappingURL=index.js.map