@punkestu/react-html 0.1.0 → 1.0.0

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,9 @@
+import { IslandInstance } from './island-registry.js';
+export type ClientRuntime = 'react' | 'preact';
+export interface BundlerOptions {
+    outDir: string;
+    minify?: boolean;
+    clientRuntime?: ClientRuntime;
+}
+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,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAgQnB"}

package/dist/core/bundler.js

@@ -0,0 +1,245 @@
+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, clientRuntime = 'react' } = 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);
+        }
+    }
+    if (uniqueIslandsMap.size === 0) {
+        return [];
+    }
+    // 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');
+    }
+    const vanillaEntries = {};
+    const reactEntries = {};
+    for (const [name, island] of uniqueIslandsMap.entries()) {
+        let resolvedEntry = island.entryPath;
+        if (resolvedEntry.startsWith('file://')) {
+            resolvedEntry = fileURLToPath(resolvedEntry);
+        }
+        else {
+            resolvedEntry = path.resolve(resolvedEntry);
+        }
+        let fileContent = '';
+        try {
+            fileContent = await fs.readFile(resolvedEntry, 'utf8');
+        }
+        catch {
+            console.warn(`[react-html] Warning: Island source file not found for "${name}" at "${resolvedEntry}". Skipping client bundle.`);
+            continue;
+        }
+        // Check if the island exports a vanilla DOM client function
+        const isVanilla = /\bexport\s+(function|const|let|var)\s+client\b/.test(fileContent);
+        const virtualEntryFile = path.join(tempDir, `${name}.entry.ts`);
+        if (isVanilla) {
+            // Pure Vanilla DOM Island entrypoint
+            const virtualEntryCode = `
+import { client } from ${JSON.stringify(resolvedEntry)};
+
+function init() {
+  document.querySelectorAll(${JSON.stringify(`[data-island="${name}"]`)}).forEach((el) => {
+    if (el.hasAttribute('data-hydrated')) return;
+
+    const rawProps = el.getAttribute('data-props');
+    let props = {};
+    if (rawProps) {
+      try { props = JSON.parse(rawProps); } catch (e) {}
+    }
+
+    const directive = el.getAttribute('data-client') || 'load';
+    const doMount = () => {
+      if (el.hasAttribute('data-hydrated')) return;
+      el.setAttribute('data-hydrated', 'true');
+      client(el as HTMLElement, props);
+    };
+
+    switch (directive) {
+      case 'idle': {
+        if ('requestIdleCallback' in window) {
+          (window as any).requestIdleCallback(doMount);
+        } else {
+          setTimeout(doMount, 200);
+        }
+        break;
+      }
+      case 'visible': {
+        if ('IntersectionObserver' in window) {
+          const obs = new IntersectionObserver((entries, observer) => {
+            entries.forEach((entry) => {
+              if (entry.isIntersecting) {
+                observer.disconnect();
+                doMount();
+              }
+            });
+          });
+          obs.observe(el);
+        } else {
+          doMount();
+        }
+        break;
+      }
+      case 'load':
+      default: {
+        if (document.readyState === 'loading') {
+          window.addEventListener('DOMContentLoaded', doMount, { once: true });
+        } else {
+          doMount();
+        }
+        break;
+      }
+    }
+  });
+}
+
+if (document.readyState === 'loading') {
+  window.addEventListener('DOMContentLoaded', init, { once: true });
+} else {
+  init();
+}
+`;
+            await fs.writeFile(virtualEntryFile, virtualEntryCode, 'utf8');
+            vanillaEntries[name] = virtualEntryFile;
+        }
+        else {
+            // React / Preact Island entrypoint
+            const virtualEntryCode = `
+import React from 'react';
+import { hydrateIsland } from ${JSON.stringify(hydratePath)};
+import * as Module from ${JSON.stringify(resolvedEntry)};
+
+const mod: Record<string, any> = { ...Module };
+const raw = mod.default ?? mod[${JSON.stringify(name)}] ?? mod;
+const Component = (raw && raw.__rawComponent) ? raw.__rawComponent : raw;
+
+hydrateIsland(${JSON.stringify(name)}, Component);
+`;
+            await fs.writeFile(virtualEntryFile, virtualEntryCode, 'utf8');
+            reactEntries[name] = virtualEntryFile;
+        }
+    }
+    const bundledFiles = [];
+    // 1. Bundle Vanilla Islands: completely stub React so ZERO bytes of React/VDOM are included!
+    if (Object.keys(vanillaEntries).length > 0) {
+        const vanillaResult = await esbuild.build({
+            entryPoints: vanillaEntries,
+            outdir: islandsOutputDir,
+            bundle: true,
+            format: 'esm',
+            platform: 'browser',
+            target: ['es2022'],
+            minify,
+            treeShaking: true,
+            legalComments: 'none',
+            plugins: [
+                {
+                    name: 'stub-react-for-vanilla',
+                    setup(build) {
+                        // Stub react, react/jsx-runtime and react-html
+                        build.onResolve({ filter: /^(react|react\/.*|react-html|@punkestu\/react-html)$/ }, (args) => {
+                            return { path: args.path, namespace: 'vanilla-empty-stub' };
+                        });
+                        build.onLoad({ filter: /.*/, namespace: 'vanilla-empty-stub' }, () => {
+                            return {
+                                contents: 'export default {}; export const jsx = () => {}; export const jsxs = () => {}; export const Fragment = ""; export function island(c){return c;}',
+                                loader: 'js'
+                            };
+                        });
+                    }
+                }
+            ],
+            loader: {
+                '.tsx': 'tsx',
+                '.ts': 'ts',
+                '.jsx': 'jsx',
+                '.js': 'js',
+                '.css': 'empty'
+            },
+            metafile: true
+        });
+        if (vanillaResult.metafile) {
+            for (const outPath of Object.keys(vanillaResult.metafile.outputs)) {
+                bundledFiles.push(path.resolve(process.cwd(), outPath));
+            }
+        }
+    }
+    // 2. Bundle React / Preact Islands with ESM code splitting
+    if (Object.keys(reactEntries).length > 0) {
+        const alias = {
+            'react-html': islandClientPath,
+            ...(clientRuntime === 'preact'
+                ? {
+                    react: 'preact/compat',
+                    'react-dom/client': 'preact/compat/client',
+                    'react-dom': 'preact/compat'
+                }
+                : {})
+        };
+        const reactResult = await esbuild.build({
+            entryPoints: reactEntries,
+            outdir: islandsOutputDir,
+            bundle: true,
+            format: 'esm',
+            platform: 'browser',
+            target: ['es2022'],
+            splitting: true,
+            chunkNames: 'chunks/[name]-[hash]',
+            minify,
+            treeShaking: true,
+            legalComments: 'none',
+            define: {
+                'process.env.NODE_ENV': '"production"'
+            },
+            alias,
+            plugins: [
+                {
+                    name: 'redirect-react-html-imports',
+                    setup(build) {
+                        build.onResolve({ filter: /(react-html|@punkestu\/react-html|(\/|\\)(src|dist)(\/|\\)index(\.js|\.mjs|\.ts)?)$/ }, () => {
+                            return { path: islandClientPath };
+                        });
+                    }
+                }
+            ],
+            loader: {
+                '.tsx': 'tsx',
+                '.ts': 'ts',
+                '.jsx': 'jsx',
+                '.js': 'js',
+                '.css': 'empty'
+            },
+            metafile: true
+        });
+        if (reactResult.metafile) {
+            for (const outPath of Object.keys(reactResult.metafile.outputs)) {
+                bundledFiles.push(path.resolve(process.cwd(), outPath));
+            }
+        }
+    }
+    // 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