@punkestu/react-html 0.0.0-stage → 0.1.1

package/dist/cli/tui-docs.js

@@ -0,0 +1,191 @@
+import readline from 'node:readline';
+import { DOC_SECTIONS } from './docs-content.js';
+// ANSI escape sequences
+const CLEAR = '\x1b[2J\x1b[H';
+const HIDE_CURSOR = '\x1b[?25l';
+const SHOW_CURSOR = '\x1b[?25h';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+const CYAN = '\x1b[36m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const BLUE = '\x1b[34m';
+const MAGENTA = '\x1b[35m';
+const INVERT = '\x1b[7m';
+function formatLine(line) {
+    if (line.startsWith('# ')) {
+        return `${BOLD}${CYAN}${line}${RESET}`;
+    }
+    if (line.startsWith('* ')) {
+        return `${BOLD}${GREEN}${line}${RESET}`;
+    }
+    if (line.startsWith('//') || line.startsWith('  $ ')) {
+        return `${YELLOW}${line}${RESET}`;
+    }
+    if (line.includes('├──') || line.includes('└──') || line.includes('│')) {
+        return `${DIM}${line}${RESET}`;
+    }
+    return line;
+}
+export function printSectionDirect(section) {
+    console.log(`\n${BOLD}${CYAN}=== ${section.title} ===${RESET}\n`);
+    for (const line of section.content) {
+        console.log(formatLine(line));
+    }
+    console.log('');
+}
+export function printAllDocs() {
+    console.log(`\n${BOLD}${CYAN}====================================================${RESET}`);
+    console.log(`${BOLD}${CYAN}          ⚛️  REACT-HTML COMPLETE MANUAL           ${RESET}`);
+    console.log(`${BOLD}${CYAN}====================================================${RESET}\n`);
+    for (const sec of DOC_SECTIONS) {
+        printSectionDirect(sec);
+        console.log(`${DIM}${'─'.repeat(60)}${RESET}\n`);
+    }
+}
+export async function launchDocsTui(initialArg) {
+    // If specific section or --all requested non-interactively
+    if (initialArg === '--all' || initialArg === '-a') {
+        printAllDocs();
+        return;
+    }
+    if (initialArg) {
+        const match = DOC_SECTIONS.find((s, idx) => s.id.toLowerCase() === initialArg.toLowerCase() ||
+            String(idx + 1) === initialArg ||
+            s.title.toLowerCase().includes(initialArg.toLowerCase()));
+        if (match) {
+            printSectionDirect(match);
+            return;
+        }
+    }
+    // Non-TTY fallback
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        printAllDocs();
+        return;
+    }
+    let selectedIndex = 0;
+    let viewMode = 'menu';
+    let scrollOffset = 0;
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.setRawMode(true);
+    process.stdout.write(HIDE_CURSOR);
+    function cleanup() {
+        process.stdout.write(SHOW_CURSOR);
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(false);
+        }
+        process.stdin.pause();
+        console.clear();
+    }
+    function renderMenu() {
+        const termWidth = Math.max(process.stdout.columns || 80, 60);
+        const border = '═'.repeat(Math.min(termWidth - 2, 70));
+        let out = CLEAR;
+        out += `${CYAN}╔${border}╗${RESET}\n`;
+        out += `${CYAN}║${BOLD}          ⚛️  REACT-HTML TERMINAL DOCUMENTATION (TUI)           ${RESET}${CYAN}║${RESET}\n`;
+        out += `${CYAN}║${DIM}   Modular pure HTML with selective reactive islands compilation   ${RESET}${CYAN}║${RESET}\n`;
+        out += `${CYAN}╚${border}╝${RESET}\n\n`;
+        out += `${BOLD}Select a topic using arrow keys and press [Enter]:${RESET}\n\n`;
+        DOC_SECTIONS.forEach((sec, idx) => {
+            const isSelected = idx === selectedIndex;
+            if (isSelected) {
+                out += `  ${BOLD}${CYAN}▶ ${INVERT} ${sec.title} ${RESET}\n`;
+                out += `    ${DIM}${sec.summary}${RESET}\n\n`;
+            }
+            else {
+                out += `    ${BOLD}${sec.title}${RESET}\n`;
+                out += `    ${DIM}${sec.summary}${RESET}\n\n`;
+            }
+        });
+        out += `\n${DIM}${'─'.repeat(Math.min(termWidth - 2, 70))}${RESET}\n`;
+        out += `${BOLD}[↑/↓ or j/k]${RESET} Navigate   ${BOLD}[Enter]${RESET} Read   ${BOLD}[q / Ctrl+C]${RESET} Exit\n`;
+        process.stdout.write(out);
+    }
+    function renderReader() {
+        const sec = DOC_SECTIONS[selectedIndex];
+        const termHeight = Math.max(process.stdout.rows || 24, 15);
+        const termWidth = Math.max(process.stdout.columns || 80, 60);
+        const contentRows = termHeight - 8;
+        const visibleLines = sec.content.slice(scrollOffset, scrollOffset + contentRows);
+        let out = CLEAR;
+        out += `${CYAN}${BOLD}⚛️  react-html :: ${sec.title}${RESET}\n`;
+        out += `${DIM}${'═'.repeat(Math.min(termWidth - 2, 70))}${RESET}\n\n`;
+        for (const line of visibleLines) {
+            out += formatLine(line) + '\n';
+        }
+        // Fill blank lines if content is short
+        for (let i = visibleLines.length; i < contentRows; i++) {
+            out += '\n';
+        }
+        const maxScroll = Math.max(0, sec.content.length - contentRows);
+        const scrollInfo = maxScroll > 0 ? ` [Line ${scrollOffset + 1}/${sec.content.length}]` : '';
+        out += `\n${DIM}${'─'.repeat(Math.min(termWidth - 2, 70))}${RESET}\n`;
+        out += `${BOLD}[↑/↓ or j/k]${RESET} Scroll${scrollInfo}   ${BOLD}[b / Esc]${RESET} Back to Menu   ${BOLD}[q]${RESET} Quit\n`;
+        process.stdout.write(out);
+    }
+    function draw() {
+        if (viewMode === 'menu') {
+            renderMenu();
+        }
+        else {
+            renderReader();
+        }
+    }
+    draw();
+    return new Promise((resolve) => {
+        process.stdin.on('keypress', (str, key) => {
+            if ((key.ctrl && key.name === 'c') || key.name === 'q') {
+                cleanup();
+                resolve();
+                return;
+            }
+            if (viewMode === 'menu') {
+                if (key.name === 'up' || key.name === 'k') {
+                    selectedIndex = (selectedIndex - 1 + DOC_SECTIONS.length) % DOC_SECTIONS.length;
+                    draw();
+                }
+                else if (key.name === 'down' || key.name === 'j') {
+                    selectedIndex = (selectedIndex + 1) % DOC_SECTIONS.length;
+                    draw();
+                }
+                else if (key.name === 'return' || key.name === 'space') {
+                    viewMode = 'reader';
+                    scrollOffset = 0;
+                    draw();
+                }
+            }
+            else if (viewMode === 'reader') {
+                const sec = DOC_SECTIONS[selectedIndex];
+                const termHeight = Math.max(process.stdout.rows || 24, 15);
+                const contentRows = termHeight - 8;
+                const maxScroll = Math.max(0, sec.content.length - contentRows);
+                if (key.name === 'escape' || key.name === 'b' || key.name === 'backspace') {
+                    viewMode = 'menu';
+                    draw();
+                }
+                else if (key.name === 'up' || key.name === 'k') {
+                    if (scrollOffset > 0) {
+                        scrollOffset--;
+                        draw();
+                    }
+                }
+                else if (key.name === 'down' || key.name === 'j') {
+                    if (scrollOffset < maxScroll) {
+                        scrollOffset++;
+                        draw();
+                    }
+                }
+                else if (key.name === 'pageup') {
+                    scrollOffset = Math.max(0, scrollOffset - 5);
+                    draw();
+                }
+                else if (key.name === 'pagedown') {
+                    scrollOffset = Math.min(maxScroll, scrollOffset + 5);
+                    draw();
+                }
+            }
+        });
+    });
+}
+//# sourceMappingURL=tui-docs.js.map

package/dist/cli/tui-docs.js.map

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

package/dist/client/hydrate.d.ts

@@ -0,0 +1,4 @@
+import { ComponentType } from 'react';
+export type ClientDirective = 'load' | 'idle' | 'visible';
+export declare function hydrateIsland(islandName: string, Component: ComponentType<any>): void;
+//# sourceMappingURL=hydrate.d.ts.map

package/dist/client/hydrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../src/client/hydrate.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG7C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1D,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,GAC5B,IAAI,CA2EN"}

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