npm - @dev-to/react-plugin - Versions diffs - 0.1.0 - Mend

@dev-to/react-plugin 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (27) hide show

package/README.md +64 -0
package/dist/constants.d.ts +11 -0
package/dist/constants.d.ts.map +1 -0
package/dist/debugHtml.d.ts +20 -0
package/dist/debugHtml.d.ts.map +1 -0
package/dist/debugTools.d.ts +10 -0
package/dist/debugTools.d.ts.map +1 -0
package/dist/devComponentMap.d.ts +4 -0
package/dist/devComponentMap.d.ts.map +1 -0
package/dist/index.d.ts +4 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +1723 -0
package/dist/lan.d.ts +2 -0
package/dist/lan.d.ts.map +1 -0
package/dist/libBuildUtils.d.ts +44 -0
package/dist/libBuildUtils.d.ts.map +1 -0
package/dist/pathUtils.d.ts +7 -0
package/dist/pathUtils.d.ts.map +1 -0
package/dist/plugin.d.ts +6 -0
package/dist/plugin.d.ts.map +1 -0
package/dist/transformUtils.d.ts +27 -0
package/dist/transformUtils.d.ts.map +1 -0
package/dist/types.d.ts +74 -0
package/dist/types.d.ts.map +1 -0
package/dist/virtualModules.d.ts +5 -0
package/dist/virtualModules.d.ts.map +1 -0
package/package.json +42 -0

package/dist/index.js ADDED Viewed

@@ -0,0 +1,1723 @@
+import { DEV_TO_REACT_BASE_PATH, DEV_TO_REACT_CONTRACT_KEY, DEV_TO_REACT_CONTRACT_PATH, DEV_TO_REACT_DEBUG_HTML_PATH, DEV_TO_REACT_DEBUG_JSON_PATH, DEV_TO_REACT_DEBUG_STATE_KEY, DEV_TO_REACT_DID_OPEN_BROWSER_KEY, DEV_TO_REACT_EVENT_FULL_RELOAD, DEV_TO_REACT_EVENT_HMR_UPDATE, DEV_TO_REACT_INIT_PATH, DEV_TO_REACT_NAMESPACE, DEV_TO_REACT_ORIGIN_KEY, DEV_TO_REACT_REACT_RUNTIME_PATH, DEV_TO_REACT_RESOLVE_ASSET_KEY } from "@dev-to/react-shared";
+import node_fs from "node:fs";
+import node_path from "node:path";
+import picocolors from "picocolors";
+import { mergeConfig } from "vite";
+import { exec } from "node:child_process";
+import node_os from "node:os";
+import { pathToFileURL } from "node:url";
+import typescript from "typescript";
+const PLUGIN_NAME = DEV_TO_REACT_NAMESPACE;
+const PLUGIN_LOG_PREFIX = `[${PLUGIN_NAME}]`;
+const STABLE_BASE_PATH = DEV_TO_REACT_BASE_PATH;
+const STABLE_CONTRACT_PATH = DEV_TO_REACT_CONTRACT_PATH;
+const STABLE_INIT_PATH = DEV_TO_REACT_INIT_PATH;
+const STABLE_REACT_RUNTIME_PATH = DEV_TO_REACT_REACT_RUNTIME_PATH;
+const STABLE_DEBUG_HTML_PATH = DEV_TO_REACT_DEBUG_HTML_PATH;
+const STABLE_DEBUG_JSON_PATH = DEV_TO_REACT_DEBUG_JSON_PATH;
+const EVENT_FULL_RELOAD = DEV_TO_REACT_EVENT_FULL_RELOAD;
+const EVENT_HMR_UPDATE = DEV_TO_REACT_EVENT_HMR_UPDATE;
+function renderDebugHtml(params) {
+    const { resolvedDevComponentMap, entryPathMap = {}, audit, stats, originCandidates, actualPort, configFilePath } = params;
+    const { defaultEntryAbs, defaultEntryExists, componentMapCount } = audit;
+    const hasConfig = Object.keys(resolvedDevComponentMap).length > 0;
+    const isWildcardOnly = hasConfig && 1 === Object.keys(resolvedDevComponentMap).length && resolvedDevComponentMap['*'];
+    const projectRoot = configFilePath ? node_path.dirname(configFilePath) : process.cwd();
+    const projectRootDisplay = projectRoot.replace(/\\/g, '/');
+    const getShortPath = (absPath)=>{
+        try {
+            const rel = node_path.relative(projectRoot, absPath).replace(/\\/g, '/');
+            return rel.startsWith('.') ? rel : `./${rel}`;
+        } catch  {
+            return absPath;
+        }
+    };
+    const toVsCodeUrl = (p)=>`vscode://file/${p.replace(/\\/g, '/')}`;
+    const escapeHtml = (s)=>s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    const annotatedConfigHtml = (()=>{
+        if (!configFilePath || !node_fs.existsSync(configFilePath)) return '';
+        try {
+            const content = node_fs.readFileSync(configFilePath, 'utf-8');
+            const lines = [];
+            const dim = (s)=>`<span class="cmt-dim">${escapeHtml(s)}</span>`;
+            const map = (s)=>`<span class="cmt-mapping">${escapeHtml(s)}</span>`;
+            lines.push(dim('/**'));
+            lines.push(dim(` * 💡 ${PLUGIN_NAME} 解析结果:`));
+            lines.push(dim(` *   - 默认入口: ${getShortPath(defaultEntryAbs)} (${defaultEntryExists ? '存在' : '缺失'})`));
+            lines.push(dim(' *   - 组件映射解析 (Resolved Component Map):'));
+            Object.entries(resolvedDevComponentMap).forEach(([name, entry])=>{
+                lines.push(map(` *     - ${name} -> ${entry}`));
+            });
+            lines.push(dim(' */'));
+            return `${lines.join('\n')}\n\n${escapeHtml(content)}`;
+        } catch (e) {
+            return escapeHtml(`// ${PLUGIN_LOG_PREFIX} 无法读取配置文件: ${e}`);
+        }
+    })();
+    return `<!doctype html>
+<html lang="zh-CN">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <title>${PLUGIN_NAME} Debug</title>
+    <style>
+        :root { --p: #3b82f6; --t: #1e293b; --m: #64748b; --b: #e2e8f0; --r: 12px; }
+        * { box-sizing: border-box; }
+        body { font-family: -apple-system, system-ui, sans-serif; background: #f8fafc; color: #1a202c; margin: 0; padding: 24px; line-height: 1.6; }
+        .container { max-width: 1000px; margin: 0 auto; }
+        .header, .card { background: #fff; border-radius: var(--r); border: 1px solid var(--b); margin-bottom: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.05); }
+        .header { padding: 20px 32px; display: flex; justify-content: space-between; align-items: center; }
+        .card { padding: 24px; }
+        .header h1 { margin: 0; font-size: 24px; color: var(--t); }
+        .header p, .muted { color: var(--m); font-size: 14px; margin: 4px 0 0; }
+        .header-status { display: flex; gap: 12px; flex-wrap: wrap; }
+        .status-pill { border: 1px solid var(--b); font-weight: 500; display: flex; align-items: center; background: #f8fafc; padding: 6px 16px; border-radius: 20px; font-size: 13px; color: #475569; }
+        .status-pill b { color: var(--t); margin-left: 6px; }
+        .card h3 { margin: 0 0 20px; font-size: 16px; font-weight: 600; display: flex; align-items: center; gap: 8px; color: var(--t); }
+        .card h3::before { content: ''; width: 3px; height: 16px; background: var(--p); border-radius: 2px; }
+        .alert { padding: 12px 16px; border-radius: 8px; margin-bottom: 20px; font-size: 13px; display: flex; align-items: center; gap: 10px; border: 1px solid transparent; }
+        .alert-info { background: #f0f9ff; color: #0369a1; border-color: #e0f2fe; }
+        .alert-error { background: #fef2f2; color: #991b1b; border-color: #fee2e2; }
+        .alert-warning { background: #fffbeb; color: #92400e; border-color: #fef3c7; }
+        .setup-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(190px, 1fr)); gap: 10px; margin: 12px 0 20px; }
+        .setup-card {
+            background: #fff; border: 1.5px solid var(--b); border-radius: 8px; padding: 10px 14px;
+            transition: all .2s cubic-bezier(0.4, 0, 0.2, 1); cursor: pointer; display: flex; flex-direction: column;
+        }
+        .setup-card:hover { border-color: var(--p); background: #f8faff; transform: translateY(-2px); box-shadow: 0 4px 12px rgba(0,0,0,0.05); }
+        .setup-card.active { border-color: var(--p); background: #f0f7ff; }
+        .setup-card .type { font-size: 9px; text-transform: uppercase; color: var(--m); font-weight: 700; margin-bottom: 6px; display: inline-flex; background: #f1f5f9; padding: 1px 6px; border-radius: 4px; width: fit-content; }
+        .setup-card.active .type { background: #dbeafe; color: var(--p); }
+        .setup-card .url { font-family: SFMono-Regular, Consolas, monospace; font-size: 13px; color: var(--t); font-weight: 600; margin-bottom: 8px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; display: block; width: 100%; }
+        .setup-card .action { font-size: 11px; color: var(--m); display: flex; align-items: center; gap: 4px; margin-top: auto; }
+        .setup-card:hover .action, .setup-card.active .action { color: var(--p); }
+        .manual-box { background: #fcfdfe; border: 1px solid var(--b); border-radius: 8px; margin-top: 16px; overflow: hidden; }
+        .manual-header { padding: 10px 16px; display: flex; justify-content: space-between; align-items: center; color: var(--m); font-size: 11px; font-weight: 600; background: #f8fafc; border-bottom: 1px solid var(--b); }
+        .copy-btn-link { background: #fff; border: 1px solid var(--b); color: var(--t); padding: 3px 10px; border-radius: 4px; cursor: pointer; font-size: 11px; transition: .2s; }
+        .copy-btn-link:hover { border-color: var(--p); color: var(--p); }
+        #fullCmdPreview { margin: 0; padding: 14px 16px; border: none; background: transparent; }
+        .info-grid { display: grid; grid-template-columns: 100px 1fr; gap: 12px 16px; margin-bottom: 24px; align-items: baseline; font-size: 13px; }
+        .info-label { color: var(--m); font-weight: 500; }
+        table { width: 100%; border-collapse: collapse; margin: 16px 0; font-size: 14px; border: 1px solid #f1f5f9; border-radius: 8px; overflow: hidden; }
+        th, td { text-align: left; padding: 14px 16px; border-bottom: 1px solid #f1f5f9; }
+        th { background: #f8fafc; color: var(--m); font-weight: 600; font-size: 12px; text-transform: uppercase; letter-spacing: .05em; }
+        code, pre { font-family: SFMono-Regular, Consolas, monospace; font-size: .9em; }
+        code { background: #f1f5f9; padding: 3px 6px; border-radius: 4px; color: #475569; font-weight: 500; }
+        .code-name { color: #4f46e5; background: #eef2ff; border: 1px solid #e0e7ff; }
+        .link-code { color: #2563eb; text-decoration: none; padding: 2px 6px; border-radius: 4px; transition: .2s; display: inline-flex; align-items: center; gap: 4px; background: #f0f9ff; border: 1px solid #bae6fd; }
+        .link-code:hover { background: #e0f2fe; color: #1d4ed8; border-color: #7dd3fc; }
+        .link-code code { background: 0 0; padding: 0; color: inherit; }
+        .link-code::after { content: '↗'; font-size: 11px; opacity: .6; }
+        details { margin-top: 16px; border: 1px solid #f1f5f9; border-radius: 10px; padding: 12px 16px; background: #fafbfc; }
+        summary { cursor: pointer; color: #475569; font-size: 14px; font-weight: 600; outline: 0; }
+        summary:hover { color: var(--p); }
+        pre { background: #ebf8ff; color: #2d3748; padding: 14px 16px; border-radius: 8px; font-size: 12px; border: 1px solid var(--b); margin: 12px 0; line-height: 1.6; overflow-x: auto; }
+        .cmt { color: #718096; font-style: italic; }
+        .kw { color: #2563eb; font-weight: 600; }
+        .str { color: #059669; }
+        .val { color: #d97706; }
+        .stats-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 16px; }
+        .stat-card { background: #f8fafc; padding: 20px; border-radius: 10px; text-align: center; border: 1px solid #f1f5f9; }
+        .stat-card .value { font-size: 24px; font-weight: 700; color: var(--p); margin-bottom: 4px; }
+        .stat-card .label { font-size: 12px; color: var(--m); text-transform: uppercase; font-weight: 600; }
+        .parameter-item { margin-bottom: 20px; padding-bottom: 20px; border-bottom: 1px dashed var(--b); }
+        .parameter-item:last-child { border-bottom: none; }
+        .parameter-name { font-weight: 600; color: var(--t); margin-bottom: 6px; display: block; font-size: 14px; }
+        .info-value, .parameter-info { font-size: 13px; color: #4a5568; line-height: 1.7; }
+        .cmt-dim { opacity: 0.4; }
+        .cmt-mapping { color: var(--p); font-weight: 600; }
+        /* 响应式优化：移动端 (480px以下) */
+        @media (max-width: 480px) {
+            body { padding: 12px; }
+            .header { padding: 16px; flex-direction: column; align-items: flex-start; gap: 16px; }
+            .header-status { width: 100%; gap: 8px; }
+            .status-pill { padding: 4px 12px; font-size: 12px; }
+            .card { padding: 16px; }
+            .info-grid { grid-template-columns: 1fr; gap: 4px; }
+            .info-label { font-size: 12px; margin-bottom: 2px; }
+            .stats-grid { grid-template-columns: 1fr; }
+            .stat-card { padding: 12px; }
+            .stat-card .value { font-size: 20px; }
+            table { display: table; width: 100%; border-radius: 6px; }
+            th, td { padding: 10px 8px; font-size: 12px; white-space: normal; overflow-wrap: anywhere; word-break: normal; }
+            th br, th .muted { display: none; }
+            pre { padding: 10px; font-size: 11px; }
+            .setup-grid { grid-template-columns: 1fr 1fr; gap: 8px; }
+            .setup-card { padding: 8px 10px; }
+            .setup-card .url { font-size: 12px; margin-bottom: 4px; }
+            .setup-card .action { font-size: 10px; }
+            .build-grid { grid-template-columns: 1fr !important; }
+        }
+        .build-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; margin-top: 16px; }
+        .build-card { background:#f8fafc; padding:16px; border-radius:10px; border:1px solid #edf2f7; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <div class="header-main">
+                <h1>🚀 ${PLUGIN_NAME}</h1>
+                <p>用于 Electron 宿主接入 Vite ESM + HMR 的调试面板</p>
+            </div>
+            <div class="header-status">
+                <div class="status-pill">组件<b>${componentMapCount}</b></div>
+                <div class="status-pill">入口<b style="color: ${defaultEntryExists ? '#10b981' : '#ef4444'}">${defaultEntryExists ? '✓' : '✗'}</b></div>
+                <div class="status-pill">端口<b id="actualPortDisplay">-</b></div>
+            </div>
+        </div>
+        <div class="card">
+            <h3>🌐 环境快速设置</h3>
+            <div class="alert alert-info">
+                <span>💡</span>
+                <div>在宿主 Electron 的控制台 (DevTools Console) 执行下方卡片中的命令，即可完成环境切换。</div>
+            </div>
+            <div id="originGrid" class="setup-grid"></div>
+            <div class="manual-box">
+                <div class="manual-header">
+                    <span>手动复制完整脚本</span>
+                    <button id="copyFullCmd" class="copy-btn-link">复制原始命令</button>
+                </div>
+                <pre id="fullCmdPreview"></pre>
+            </div>
+        </div>
+        <div class="card">
+            <h3>📋 当前组件配置</h3>
+            <div class="info-grid">
+                <div class="info-label">项目目录:</div>
+                <div class="info-value">
+                    <a href="${toVsCodeUrl(projectRoot)}" class="link-code" title="点击在 IDE 中打开"><code>${escapeHtml(projectRootDisplay)}</code></a>
+                </div>
+                <div class="info-label">配置文件:</div>
+                <div class="info-value">
+                    ${configFilePath ? `
+                        <a href="${toVsCodeUrl(configFilePath)}" class="link-code" title="点击在 IDE 中打开"><code>${escapeHtml(node_path.basename(configFilePath))}</code></a>
+                        ${annotatedConfigHtml ? `
+                            <details style="margin-top: 8px; border: none; padding: 0; background: transparent; box-shadow: none;">
+                                <summary style="font-size: 12px; color: var(--p); font-weight: 500;">查看配置源码与解析结果</summary>
+                                <pre style="margin-top: 8px; max-height: 400px; overflow: auto; background: #f1f5f9; border-color: #cbd5e1; font-size: 11px; padding: 12px; border-radius: 6px;">${annotatedConfigHtml}</pre>
+                            </details>
+                        ` : ''}
+                    ` : '<span class="muted">未找到</span>'}
+                </div>
+            </div>
+            ${!hasConfig || isWildcardOnly ? `
+                <div class="alert alert-info">
+                    <span>💡</span>
+                    <div>
+                        <b>全局通配模式已启用</b>
+                        <div style="font-size: 13px; margin-top: 2px;">Map 中包含通配符 "*"。所有组件请求将默认加载入口。构建前请在 <code>vite.config.ts</code> 中显式指定组件映射。</div>
+                    </div>
+                </div>
+            ` : ''}
+            ${!defaultEntryExists ? `
+                <div class="alert alert-error">
+                    <span>⚠️</span>
+                    <div>
+                        <b>默认入口文件缺失</b>
+                        <div style="font-size: 13px; margin-top: 2px;">找不到路径：<a href="${toVsCodeUrl(defaultEntryAbs)}" class="link-code"><code>${escapeHtml(getShortPath(defaultEntryAbs))}</code></a></div>
+                    </div>
+                </div>
+            ` : ''}
+            ${hasConfig ? `
+                <table>
+                    <thead><tr><th>组件名称 <small class="muted">(Component Name)</small></th><th>映射入口 <small class="muted">(Short Path)</small></th></tr></thead>
+                    <tbody>
+                        ${Object.entries(resolvedDevComponentMap).map(([name, entry])=>{
+        const abs = entryPathMap[name];
+        const displayPath = abs ? getShortPath(abs) : entry;
+        return `<tr>
+                                <td><code class="code-name">${name}</code></td>
+                                <td>
+                                    ${abs ? `<a href="${toVsCodeUrl(abs)}" class="link-code" title="点击在 IDE 中打开"><code>${escapeHtml(displayPath)}</code></a>` : `<code>${escapeHtml(entry)}</code>`}
+                                </td>
+                            </tr>`;
+    }).join('')}
+                    </tbody>
+                </table>
+            ` : '<div class="alert alert-warning">未发现任何配置组件</div>'}
+            <details>
+                <summary>插件参数与配置说明 (Plugin API)</summary>
+                <div class="parameter-desc">
+                    <div style="margin-bottom: 24px;">
+                        <pre style="background: #ebf8ff; color: #2c5282; border-color: #bee3f8; font-size: 14px; font-weight: 600;">reactHmrHostPlugin(devComponentMap?, options?)</pre>
+                        <div class="muted" style="margin-top: 8px;">
+                            支持单组件简写、对象全量映射，以及透传 Vite 原生配置。
+                        </div>
+                    </div>
+                    <div class="parameter-item">
+                        <span class="parameter-name">1. devComponentMap (第一个参数)</span>
+                        <div class="parameter-info">
+                            定义组件名与本地入口文件的映射：
+                            <ul style="margin-top: 8px;">
+                                <li><b>单组件简写</b>：<code class="val">'Demo'</code> ➔ 自动关联 <code>{ Demo: '/' }</code>。</li>
+                                <li><b>通配符映射</b>：<code class="val">'*'</code> ➔ 匹配所有组件名。支持 <code class="val">'/'</code> (默认入口) 或具体的相对/绝对路径。</li>
+                                <li><b>多组件映射</b>：支持具体的相对/绝对路径。</li>
+                            </ul>
+                            <pre><span class="cmt">// Option 1: Shorthand (Default)</span>
+reactHmrHostPlugin(<span class="str">'Demo'</span>)
+<span class="cmt">// Option 2: Explicit Mapping with Wildcard</span>
+reactHmrHostPlugin({
+  <span class="str">'*'</span>: <span class="str">'/'</span>, <span class="cmt">// Wildcard to default entry</span>
+  <span class="str">'Card'</span>: <span class="str">'src/Card.tsx'</span> <span class="cmt">// Specific file</span>
+})</pre>
+                            <div class="muted" style="font-size: 12px; margin-top: 8px; background: #fffbeb; padding: 8px 12px; border-radius: 6px; border: 1px solid #fef3c7; color: #92400e;">
+                                💡 <b>关于默认入口 (/)</b>：表示使用工程默认入口文件。查找顺序：优先 <code>src/App.{tsx,jsx}</code>，其次 <code>src/index.{tsx,jsx}</code>。
+                            </div>
+                        </div>
+                    </div>
+                    <div class="parameter-item">
+                        <span class="parameter-name">2. options (第二个参数)</span>
+                        <div class="parameter-info">
+                            高级配置（深度合并）：
+                            <ul style="margin-top: 8px;">
+                                <li><code class="kw">css</code>:
+                                    <ul>
+                                        <li><b>默认值：</b><code>{ modules: { generateScopedName: <span class="str">'[name]__[local]___[hash:base64:5]'</span> } }</code>。</li>
+                                        <li>传 <code class="kw">false</code> 禁用配置；传对象则进行深度合并。</li>
+                                        <li>详细配置请参考 <a href="https://cn.vite.dev/config/shared-options#css-modules" target="_blank" style="color:#3b82f6;">Vite CSS 官方文档 ↗</a></li>
+                                    </ul>
+                                    <pre><span class="cmt">// Disable plugin CSS config or provide custom overrides</span>
+reactHmrHostPlugin(<span class="str">'Demo'</span>, { css: <span class="kw">false</span> })
+reactHmrHostPlugin(<span class="str">'Demo'</span>, { css: { ... } })</pre>
+                                </li>
+                                <li style="margin-top: 12px;"><code class="kw">build</code>:
+                                    <ul>
+                                        <li><b>仅在 lib 构建模式下生效</b>。内置默认值：</li>
+                                        <pre style="font-size: 11px; color: #4a5568;">formats: [<span class="str">'umd'</span>], fileName: <span class="str">'[name].js'</span>, inlineDynamicImports: <span class="kw">true</span>,
+external: [<span class="str">'react'</span>, <span class="str">'react-dom'</span>, <span class="str">'react-dom/client'</span>, <span class="str">'typescript'</span>],
+globals: { react: <span class="str">'React'</span>, <span class="str">'react-dom'</span>: <span class="str">'ReactDOM'</span>, ... }</pre>
+                                        <li>合并规则：用户配置覆盖默认项。</li>
+                                        <li>详细配置请参考 <a href="https://cn.vite.dev/config/build-options" target="_blank" style="color:#3b82f6;">Vite 构建官方文档 ↗</a></li>
+                                    </ul>
+                                    <pre><span class="cmt">// Example: Disable asset inlining during build</span>
+reactHmrHostPlugin(<span class="str">'Demo'</span>, {
+  build: { assetsInlineLimit: <span class="val">0</span> }
+})</pre>
+                                </li>
+                                <li style="margin-top: 12px;"><code class="kw">open</code>:
+                                    <ul>
+                                        <li><b>默认值：</b><code class="kw">false</code>。</li>
+                                        <li>是否在启动 Vite 开发服务器后自动在浏览器中打开此调试面板。</li>
+                                    </ul>
+                                    <pre><span class="cmt">// Enable auto-open</span>
+reactHmrHostPlugin(<span class="str">'Demo'</span>, { open: <span class="kw">true</span> })</pre>
+                                </li>
+                            </ul>
+                        </div>
+                    </div>
+                </div>
+            </details>
+        </div>
+        <div class="card">
+            <h3>📦 构建与部署</h3>
+            <p class="muted">执行 <code>vite build --mode lib</code> 将组件打包为 UMD 格式以供发布。</p>
+            <div class="build-grid">
+                <div class="build-card">
+                    <div style="font-weight:600; font-size:13px; margin-bottom:8px; color: var(--t);">输出结构 (Output)</div>
+                    <pre style="margin:0; padding:0; background:transparent; border:none; font-size:12px; color:#4a5568;">
+JS:  <span class="str">dist/&lt;name&gt;/&lt;name&gt;.js</span>
+CSS: <span class="str">dist/&lt;name&gt;/&lt;name&gt;.css</span></pre>
+                </div>
+                <div class="build-card">
+                    <div style="font-weight:600; font-size:13px; margin-bottom:8px; color: var(--t);">外部依赖 (External)</div>
+                    <pre style="margin:0; padding:0; background:transparent; border:none; font-size:12px; color:#4a5568;">
+<span class="kw">react</span>     ➔ <span class="val">React</span>
+<span class="kw">react-dom</span> ➔ <span class="val">ReactDOM</span></pre>
+                </div>
+            </div>
+            <details>
+                <summary>构建导出 (Export) 智能分析逻辑</summary>
+                <div style="margin-top: 12px; font-size: 13px;">
+                    <p class="muted">插件会使用 AST 分析入口文件，确保 UMD 包具备正确的导出：</p>
+                    <ul class="muted" style="line-height: 1.8;">
+                        <li>如果有 <code>export default</code>，直接作为组件入口。</li>
+                        <li>如果没有 Default 但只有一个命名导出，自动将其关联为 Default。</li>
+                        <li>如果有多个命名导出，必须有一个与 <code>componentName</code> 同名，否则会报错提醒。</li>
+                    </ul>
+                </div>
+            </details>
+        </div>
+        <div class="card">
+            <h3>📊 运行指标 & 参考</h3>
+            <div class="stats-grid">
+                <div class="stat-card"><div class="value">${stats.contract.count}</div><div class="label">Contract 请求</div></div>
+                <div class="stat-card"><div class="value">${stats.init.count}</div><div class="label">Init 注入</div></div>
+                <div class="stat-card"><div class="value">${stats.runtime.count}</div><div class="label">Runtime 加载</div></div>
+            </div>
+            <details>
+                <summary>技术端点与 HMR 事件 (Internal Reference)</summary>
+                <div style="margin-top: 12px;">
+                    <pre style="font-size: 12px; line-height: 1.7;">
+<span class="kw">Endpoints:</span>
+- Contract: <span class="str">${STABLE_CONTRACT_PATH}</span>
+- Init:     <span class="str">${STABLE_INIT_PATH}</span>
+- Runtime:  <span class="str">${STABLE_REACT_RUNTIME_PATH}</span>
+<span class="kw">HMR Events:</span>
+- Reload:   <span class="val">${EVENT_FULL_RELOAD}</span>
+- Update:   <span class="val">${EVENT_HMR_UPDATE}</span></pre>
+                    <p class="muted" style="font-size: 12px; margin-top: 12px; background: #fffbeb; padding: 10px 14px; border-radius: 6px; border: 1px solid #fef3c7; color: #92400e;">
+                        💡 <b>重要提示：</b>在 Electron 环境下，静态资源必须通过 <code>import</code> 引入才能被桥接插件正确拦截和路径重写。
+                    </p>
+                </div>
+            </details>
+        </div>
+        <div style="text-align: center; margin-top: 32px; padding-bottom: 24px;">
+            <a href="${STABLE_DEBUG_JSON_PATH}" target="_blank" style="font-size: 13px; color: #3b82f6; text-decoration: none; font-weight: 500;">查看原始协议 JSON 数据 ➔</a>
+        </div>
+    </div>
+    <script>
+        (function() {
+            const serverOrigins = ${JSON.stringify(originCandidates)};
+            const current = location.origin;
+            const origins = [...serverOrigins];
+            // 确保当前访问地址也在候选列表中
+            if (!origins.includes(current)) origins.unshift(current);
+            const seen = new Set();
+            const uniqueOrigins = origins.filter(o => {
+                if (seen.has(o)) return false;
+                seen.add(o);
+                return true;
+            });
+            const grid = document.getElementById('originGrid');
+            const fullCmdPreview = document.getElementById('fullCmdPreview');
+            const copyFullBtn = document.getElementById('copyFullCmd');
+            function makeCmd(origin) {
+                return "localStorage.setItem('VITE_DEV_SERVER_ORIGIN', '" + origin + "'); location.reload();";
+            }
+            function selectOrigin(origin, card) {
+                // 更新卡片激活状态
+                document.querySelectorAll('.setup-card').forEach(c => c.classList.remove('active'));
+                if (card) card.classList.add('active');
+                // 更新下方预览脚本
+                fullCmdPreview.textContent = makeCmd(origin);
+            }
+            function copy(text, successCb) {
+                const ta = document.createElement('textarea');
+                ta.value = text;
+                document.body.appendChild(ta);
+                ta.select();
+                document.execCommand('copy');
+                document.body.removeChild(ta);
+                if (successCb) successCb();
+            }
+            uniqueOrigins.forEach(origin => {
+                const isLocal = origin.includes('localhost') || origin.includes('127.0.0.1');
+                const displayUrl = origin.indexOf('://') > -1 ? origin.split('://')[1] : origin;
+                const card = document.createElement('div');
+                card.className = 'setup-card' + (origin === current ? ' active' : '');
+                card.innerHTML =
+                    '<span class="type">' + (isLocal ? '本地回路 (Local)' : '局域网 (LAN)') + '</span>' +
+                    '<span class="url">' + displayUrl + '</span>' +
+                    '<div class="action">点击复制切换命令</div>';
+                card.onclick = () => {
+                    selectOrigin(origin, card);
+                    copy(makeCmd(origin), () => {
+                        const actionEl = card.querySelector('.action');
+                        const originalAction = actionEl.innerHTML;
+                        actionEl.innerHTML = '<span>✅</span> 命令已复制成功';
+                        card.style.borderColor = '#10b981';
+                        setTimeout(() => {
+                            actionEl.innerHTML = originalAction;
+                            card.style.borderColor = '';
+                        }, 2000);
+                    });
+                };
+                grid.appendChild(card);
+            });
+            selectOrigin(current, null); // 初始化预览
+            copyFullBtn.onclick = () => copy(fullCmdPreview.textContent, () => {
+                copyFullBtn.textContent = '✓ 已成功复制';
+                setTimeout(() => { copyFullBtn.textContent = '复制原始命令'; }, 2000);
+            });
+            const serverActualPort = ${'number' == typeof actualPort ? actualPort : 'null'};
+            document.getElementById('actualPortDisplay').textContent = serverActualPort || location.port || '-';
+        })();
+    </script>
+</body>
+</html>`;
+}
+function getLanIPv4Hosts() {
+    const nets = node_os.networkInterfaces();
+    const out = new Set();
+    for (const items of Object.values(nets))if (items) {
+        for (const info of items)if ('IPv4' === info.family && !info.internal) out.add(info.address);
+    }
+    return Array.from(out);
+}
+function toFsPathFromViteEntry(entry) {
+    if (!entry.startsWith('/@fs')) return null;
+    let p = entry.slice(4);
+    if (p.startsWith('/') && /\/[A-Za-z]:\//.test(p)) p = p.slice(1);
+    return p;
+}
+function tryResolveWithExtensions(p) {
+    const exts = [
+        '.tsx',
+        '.jsx',
+        '.ts',
+        '.js'
+    ];
+    if (node_fs.existsSync(p)) return p;
+    const parsed = node_path.parse(p);
+    if (parsed.ext) for (const ext of exts){
+        const cand = node_path.join(parsed.dir, `${parsed.name}${ext}`);
+        if (node_fs.existsSync(cand)) return cand;
+    }
+    else for (const ext of exts){
+        const cand = `${p}${ext}`;
+        if (node_fs.existsSync(cand)) return cand;
+    }
+    return null;
+}
+function resolveEntryAbsPath(rootDir, entry, defaultEntryAbs, fallbackRoot) {
+    const tryResolveWithBase = (baseDir)=>{
+        if ('/' === entry) {
+            if (!defaultEntryAbs) throw new Error(`${PLUGIN_LOG_PREFIX} 使用 / 作为入口时，必须提供 defaultEntryAbs 参数`);
+            return defaultEntryAbs;
+        }
+        const fsPath = toFsPathFromViteEntry(entry);
+        if (fsPath) return tryResolveWithExtensions(fsPath);
+        if (node_path.isAbsolute(entry)) return tryResolveWithExtensions(entry);
+        if (entry.startsWith('/')) {
+            const maybe = node_path.resolve(baseDir, entry.slice(1));
+            return tryResolveWithExtensions(maybe);
+        }
+        const rel = node_path.resolve(baseDir, entry);
+        return tryResolveWithExtensions(rel);
+    };
+    const resolved = tryResolveWithBase(rootDir);
+    if (resolved) return resolved;
+    if (fallbackRoot && fallbackRoot !== rootDir) return tryResolveWithBase(fallbackRoot);
+    return resolved;
+}
+function openBrowser(url) {
+    const bridgePath = STABLE_DEBUG_HTML_PATH;
+    if ('darwin' === process.platform) {
+        const script = `
+      try
+        tell application "Google Chrome"
+          repeat with w in windows
+            repeat with t in tabs of w
+              if URL of t contains "${bridgePath}" then
+                set URL of t to "${url}"
+                set active tab index of w to (get index of t)
+                set index of w to 1
+                activate
+                return "found"
+              end if
+            end repeat
+          end repeat
+        end tell
+      end try
+      try
+        tell application "Microsoft Edge"
+          repeat with w in windows
+            repeat with t in tabs of w
+              if URL of t contains "${bridgePath}" then
+                set URL of t to "${url}"
+                set active tab index of w to (get index of t)
+                set index of w to 1
+                activate
+                return "found"
+              end if
+            end repeat
+          end repeat
+        end tell
+      end try
+      try
+        tell application "Safari"
+          repeat with w in windows
+            repeat with t in tabs of w
+              if URL of t contains "${bridgePath}" then
+                set URL of t to "${url}"
+                set current tab of w to t
+                set index of w to 1
+                activate
+                return "found"
+              end if
+            end repeat
+          end repeat
+        end tell
+      end try
+      return "not_found"
+    `.replace(/\n/g, ' ');
+        exec(`osascript -e '${script}'`, (err, stdout)=>{
+            if (err || 'found' !== stdout.trim()) exec(`open "${url}"`);
+        });
+        return;
+    }
+    if ('win32' === process.platform) return void exec(`start "" "${url}"`);
+    exec(`xdg-open "${url}"`);
+}
+const globalState = globalThis;
+let didOpenBrowser = Boolean(globalState[DEV_TO_REACT_DID_OPEN_BROWSER_KEY]);
+function installDebugTools(server, ctx, state) {
+    const printStartupDebugUrl = ()=>{
+        if (state.didPrintStartupDebugUrl) return;
+        state.didPrintStartupDebugUrl = true;
+        const isHttps = !!server.config.server.https;
+        const proto = isHttps ? 'https' : 'http';
+        const addr = server.httpServer?.address();
+        const actualPort = addr && 'object' == typeof addr ? addr.port : void 0;
+        const port = (()=>{
+            if ('number' == typeof actualPort) return actualPort;
+            if ('number' == typeof server.config.server.port) return server.config.server.port;
+            return 5173;
+        })();
+        const lanHosts = getLanIPv4Hosts();
+        const candidateHosts = [
+            'localhost',
+            '127.0.0.1',
+            ...lanHosts
+        ];
+        const urls = candidateHosts.map((h)=>`${proto}://${h}:${port}${STABLE_DEBUG_HTML_PATH}`);
+        const logger = server.config.logger;
+        const info = 'function' == typeof logger?.info ? logger.info.bind(logger) : console.log;
+        info('');
+        info(`${PLUGIN_LOG_PREFIX} Debug panel:`);
+        urls.forEach((u)=>info(`  ${u}`));
+        info(`  JSON: ${proto}://localhost:${port}${STABLE_DEBUG_JSON_PATH}`);
+        info('');
+        if (ctx.open && !didOpenBrowser) {
+            didOpenBrowser = true;
+            globalState[DEV_TO_REACT_DID_OPEN_BROWSER_KEY] = true;
+            openBrowser(urls[0]);
+        }
+    };
+    try {
+        if (server.httpServer) {
+            server.httpServer.once('listening', printStartupDebugUrl);
+            if (server.httpServer.listening) printStartupDebugUrl();
+        }
+    } catch  {}
+    server.middlewares.use((req, res, next)=>{
+        const url = req.url || '';
+        const pathname = String(url).split('?')[0];
+        const now = Date.now();
+        if (pathname === STABLE_CONTRACT_PATH) {
+            ctx.stats.contract.count += 1;
+            ctx.stats.contract.lastAt = now;
+        } else if (pathname === STABLE_INIT_PATH) {
+            ctx.stats.init.count += 1;
+            ctx.stats.init.lastAt = now;
+        } else if (pathname === STABLE_REACT_RUNTIME_PATH) {
+            ctx.stats.runtime.count += 1;
+            ctx.stats.runtime.lastAt = now;
+        }
+        if (url === STABLE_BASE_PATH || url === `${STABLE_BASE_PATH}/`) {
+            res.statusCode = 302;
+            res.setHeader('Location', STABLE_DEBUG_HTML_PATH);
+            res.end();
+            return;
+        }
+        if (url.startsWith(STABLE_DEBUG_JSON_PATH)) {
+            const isHttps = !!server.config.server.https;
+            const proto = isHttps ? 'https' : 'http';
+            const hostHeader = String(req.headers.host || '');
+            const addr = server.httpServer?.address();
+            const actualPort = addr && 'object' == typeof addr ? addr.port : void 0;
+            const lanHosts = getLanIPv4Hosts();
+            const candidateHosts = [
+                'localhost',
+                '127.0.0.1',
+                ...lanHosts
+            ];
+            const originCandidates = candidateHosts.map((h)=>`${proto}://${h}${actualPort ? `:${actualPort}` : ''}`);
+            const requestOrigin = hostHeader ? `${proto}://${hostHeader}` : originCandidates[0];
+            const componentNames = Object.keys(ctx.contract?.dev?.componentMap || {});
+            const libComponentExample = componentNames.slice(0, 2).join(',') || 'Demo';
+            res.statusCode = 200;
+            res.setHeader('Content-Type', 'application/json; charset=utf-8');
+            res.end(JSON.stringify({
+                contract: ctx.contract,
+                stats: ctx.stats,
+                audit: ctx.audit,
+                server: {
+                    protocol: proto,
+                    hostHeader,
+                    actualPort,
+                    config: {
+                        host: server.config.server.host,
+                        port: server.config.server.port,
+                        strictPort: server.config.server.strictPort,
+                        cors: server.config.server.cors,
+                        https: !!server.config.server.https
+                    }
+                },
+                originCandidates,
+                usage: {
+                    localStorageKey: 'VITE_DEV_SERVER_ORIGIN',
+                    suggested: requestOrigin,
+                    snippet: `localStorage.setItem('VITE_DEV_SERVER_ORIGIN', '${requestOrigin}'); location.reload();`,
+                    libBuild: {
+                        command: 'vite build --mode lib',
+                        env: {
+                            DEV_TO_REACT_LIB_SECTION: libComponentExample
+                        },
+                        output: {
+                            dir: 'dist/<component>/',
+                            js: '<component>.js (UMD, 尽量单文件 bundle)',
+                            css: '<component>.css (如有样式)'
+                        },
+                        externals: [
+                            'react',
+                            'react-dom',
+                            'react-dom/client'
+                        ],
+                        umdGlobals: {
+                            react: 'React',
+                            'react-dom': 'ReactDOM',
+                            'react-dom/client': 'ReactDOMClient'
+                        },
+                        jsx: 'classic (React.createElement)',
+                        customizable: 'options.css (dev/build; false disables plugin-injected CSS config; object deep-merged) and options.build (lib mode only; deep-merged with internal defaults, user wins)'
+                    }
+                },
+                tips: [
+                    '宿主侧需设置 localStorage.VITE_DEV_SERVER_ORIGIN（可从 originCandidates 里选择一个可访问的 origin）。',
+                    'devComponentMap 的 key 必须与后端返回的 componentName 完全一致（严格匹配）。',
+                    'Fast Refresh 关键：必须先 import init.js（安装 react-refresh preamble），再 import react-dom/client。',
+                    '如需产出可分发 UMD 包：使用 `vite build --mode lib`（仅构建 componentMap 指定的组件，输出到 dist/<component>/）。'
+                ]
+            }, null, 2));
+            return;
+        }
+        if (url.startsWith(STABLE_DEBUG_HTML_PATH)) {
+            const addr = server.httpServer?.address();
+            const actualPort = addr && 'object' == typeof addr ? addr.port : void 0;
+            const lanHosts = getLanIPv4Hosts();
+            const isHttps = !!server.config.server.https;
+            const proto = isHttps ? 'https' : 'http';
+            const candidateHosts = [
+                'localhost',
+                '127.0.0.1',
+                ...lanHosts
+            ];
+            const originCandidates = candidateHosts.map((h)=>`${proto}://${h}${actualPort ? `:${actualPort}` : ''}`);
+            const serverConfigLite = {
+                host: server.config.server.host,
+                port: server.config.server.port,
+                strictPort: server.config.server.strictPort,
+                cors: server.config.server.cors,
+                https: !!server.config.server.https
+            };
+            let configFilePath;
+            const rootDir = server.config.root || process.cwd();
+            configFilePath = server.config.configFile || void 0;
+            if (!configFilePath) try {
+                const files = node_fs.readdirSync(rootDir);
+                const configFile = files.find((file)=>/^vite\.config\.(ts|js|mjs|cjs|cts)$/.test(file));
+                if (configFile) configFilePath = node_path.resolve(rootDir, configFile);
+            } catch  {
+                const configFiles = [
+                    'vite.config.ts',
+                    'vite.config.js',
+                    'vite.config.mjs',
+                    'vite.config.cjs',
+                    'vite.config.cts'
+                ];
+                for (const file of configFiles){
+                    const fullPath = node_path.resolve(rootDir, file);
+                    if (node_fs.existsSync(fullPath)) {
+                        configFilePath = fullPath;
+                        break;
+                    }
+                }
+            }
+            const entryPathMap = {};
+            for (const [componentName, entry] of Object.entries(ctx.contract.dev.componentMap)){
+                if ('*' === componentName) {
+                    entryPathMap[componentName] = ctx.audit.defaultEntryAbs;
+                    continue;
+                }
+                if (entry.startsWith('/@fs')) {
+                    const fsPath = toFsPathFromViteEntry(entry);
+                    if (fsPath) entryPathMap[componentName] = fsPath;
+                } else if ('/' === entry) entryPathMap[componentName] = ctx.audit.defaultEntryAbs;
+                else if (!entry.startsWith('http://') && !entry.startsWith('https://') && !entry.startsWith('/')) entryPathMap[componentName] = node_path.resolve(rootDir, entry);
+            }
+            const html = renderDebugHtml({
+                resolvedDevComponentMap: ctx.contract.dev.componentMap,
+                entryPathMap,
+                audit: ctx.audit,
+                stats: ctx.stats,
+                serverConfigLite,
+                originCandidates,
+                actualPort: 'number' == typeof actualPort ? actualPort : void 0,
+                configFilePath
+            });
+            res.statusCode = 200;
+            res.setHeader('Content-Type', 'text/html; charset=utf-8');
+            res.end(html);
+            return;
+        }
+        next();
+    });
+}
+function toViteFsPath(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    return normalized.startsWith('/') ? `/@fs${normalized}` : `/@fs/${normalized}`;
+}
+function resolveDefaultEntryAbs(rootDir) {
+    const appCandidates = [
+        node_path.resolve(rootDir, 'src/App.tsx'),
+        node_path.resolve(rootDir, 'src/App.jsx'),
+        node_path.resolve(rootDir, 'src/App.ts'),
+        node_path.resolve(rootDir, 'src/App.js')
+    ];
+    const foundApp = appCandidates.find((p)=>node_fs.existsSync(p));
+    if (foundApp) return foundApp;
+    const indexCandidates = [
+        node_path.resolve(rootDir, 'src/index.ts'),
+        node_path.resolve(rootDir, 'src/index.tsx'),
+        node_path.resolve(rootDir, 'src/index.jsx'),
+        node_path.resolve(rootDir, 'src/index.js')
+    ];
+    const foundIndex = indexCandidates.find((p)=>node_fs.existsSync(p));
+    if (foundIndex) return foundIndex;
+    return appCandidates[0];
+}
+function buildDevComponentMapFromRecord(rootDir, input, defaultEntryAbs, convertAt = false, fallbackRoot) {
+    const out = {};
+    for (const [componentName, entry] of Object.entries(input)){
+        if (!componentName || !entry) continue;
+        if ('/' === entry) {
+            out[componentName] = convertAt ? toViteFsPath(defaultEntryAbs) : '/';
+            continue;
+        }
+        if (entry.startsWith('http://') || entry.startsWith('https://') || entry.startsWith('/')) {
+            out[componentName] = entry;
+            continue;
+        }
+        const abs = node_path.isAbsolute(entry) ? entry : node_path.resolve(rootDir, entry);
+        let resolved = tryResolveWithExtensions(abs);
+        if (!resolved && fallbackRoot && fallbackRoot !== rootDir) {
+            const fallbackAbs = node_path.isAbsolute(entry) ? entry : node_path.resolve(fallbackRoot, entry);
+            resolved = tryResolveWithExtensions(fallbackAbs);
+        }
+        resolved = resolved || abs;
+        out[componentName] = toViteFsPath(resolved);
+    }
+    return out;
+}
+function getFsPathFromViteEntry(entry) {
+    if (!entry.startsWith('/@fs')) return null;
+    let p = entry.slice(4);
+    if (p.startsWith('/') && /\/[A-Za-z]:\//.test(p)) p = p.slice(1);
+    return p;
+}
+function resolveDevComponentConfig(rootDir, devComponentMap, fallbackRoot) {
+    const defaultEntryAbs = resolveDefaultEntryAbs(rootDir);
+    const defaultEntry = toViteFsPath(defaultEntryAbs);
+    let resolvedDevComponentMap = {};
+    if ('string' == typeof devComponentMap) {
+        const name = devComponentMap.trim();
+        resolvedDevComponentMap = name ? buildDevComponentMapFromRecord(rootDir, {
+            [name]: '/'
+        }, defaultEntryAbs, false, fallbackRoot) : {
+            '*': '/'
+        };
+    } else {
+        const input = devComponentMap ?? {};
+        resolvedDevComponentMap = 0 === Object.keys(input).length ? {
+            '*': '/'
+        } : buildDevComponentMapFromRecord(rootDir, input, defaultEntryAbs, false, fallbackRoot);
+    }
+    const audit = (()=>{
+        const missing = [];
+        for (const [componentName, entry] of Object.entries(resolvedDevComponentMap)){
+            const fsPath = getFsPathFromViteEntry(entry);
+            if (fsPath) {
+                const resolved = tryResolveWithExtensions(fsPath);
+                if (!resolved || !node_fs.existsSync(resolved)) missing.push({
+                    componentName,
+                    filePath: fsPath
+                });
+            }
+        }
+        return {
+            defaultEntryAbs,
+            defaultEntryExists: node_fs.existsSync(defaultEntryAbs),
+            componentMapCount: Object.keys(resolvedDevComponentMap).length,
+            missingEntries: missing
+        };
+    })();
+    return {
+        defaultEntryAbs,
+        defaultEntry,
+        componentMap: resolvedDevComponentMap,
+        audit
+    };
+}
+function isLibBuild(env) {
+    return env?.command === 'build' && env?.mode === 'lib';
+}
+function toSafeOutDirName(componentName) {
+    return componentName.replace(/[\\/]/g, '_').replace(/\.\./g, '_');
+}
+function toSafeUmdName(componentName) {
+    let s = componentName.replace(/[^A-Za-z0-9_$]+/g, '_');
+    if (!s) s = 'ViteDevComponent';
+    if (/^\d/.test(s)) s = `_${s}`;
+    return s;
+}
+function isValidJsIdentifier(name) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name);
+}
+function analyzeExports(filePath) {
+    if (!node_fs.existsSync(filePath)) return {
+        hasDefault: false,
+        namedExports: []
+    };
+    const content = node_fs.readFileSync(filePath, 'utf-8');
+    const namedExports = [];
+    let hasDefault = false;
+    let scriptKind = typescript.ScriptKind.TS;
+    const ext = node_path.extname(filePath).toLowerCase();
+    if ('.tsx' === ext) scriptKind = typescript.ScriptKind.TSX;
+    else if ('.jsx' === ext) scriptKind = typescript.ScriptKind.JSX;
+    else if ('.js' === ext) scriptKind = typescript.ScriptKind.JS;
+    else if ('.ts' === ext) scriptKind = typescript.ScriptKind.TS;
+    let sourceFile;
+    try {
+        sourceFile = typescript.createSourceFile(filePath, content, typescript.ScriptTarget.Latest, true, scriptKind);
+    } catch (parseError) {
+        throw new Error(`${PLUGIN_LOG_PREFIX} 无法解析入口文件 "${filePath}"。\n解析错误: ${parseError instanceof Error ? parseError.message : String(parseError)}\n请确保文件是有效的 TypeScript/JavaScript 文件。`);
+    }
+    typescript.getPreEmitDiagnostics(typescript.createProgram([
+        filePath
+    ], {
+        target: typescript.ScriptTarget.Latest,
+        module: typescript.ModuleKind.ESNext,
+        jsx: scriptKind === typescript.ScriptKind.TSX || scriptKind === typescript.ScriptKind.JSX ? typescript.JsxEmit.React : void 0
+    }));
+    function visit(node) {
+        if (typescript.isExportAssignment(node)) {
+            if (true !== node.isExportEquals) hasDefault = true;
+        }
+        if (typescript.isFunctionDeclaration(node) || typescript.isClassDeclaration(node) || typescript.isVariableStatement(node) || typescript.isInterfaceDeclaration(node) || typescript.isTypeAliasDeclaration(node) || typescript.isEnumDeclaration(node)) {
+            const modifiers = typescript.getModifiers(node);
+            if (modifiers?.some((m)=>m.kind === typescript.SyntaxKind.ExportKeyword)) if (modifiers.some((m)=>m.kind === typescript.SyntaxKind.DefaultKeyword)) hasDefault = true;
+            else {
+                if (typescript.isFunctionDeclaration(node) && node.name) namedExports.push(node.name.text);
+                if (typescript.isClassDeclaration(node) && node.name) namedExports.push(node.name.text);
+                if (typescript.isVariableStatement(node)) node.declarationList.declarations.forEach((decl)=>{
+                    if (typescript.isIdentifier(decl.name)) namedExports.push(decl.name.text);
+                });
+                if (typescript.isInterfaceDeclaration(node) && node.name) namedExports.push(node.name.text);
+                if (typescript.isTypeAliasDeclaration(node) && node.name) namedExports.push(node.name.text);
+                if (typescript.isEnumDeclaration(node) && node.name) namedExports.push(node.name.text);
+            }
+        }
+        if (typescript.isExportDeclaration(node) && node.exportClause) {
+            if (typescript.isNamedExports(node.exportClause)) node.exportClause.elements.forEach((element)=>{
+                if (element.name) {
+                    const exportName = element.name.text;
+                    const { propertyName } = element;
+                    if (propertyName && 'default' === propertyName.text) namedExports.push(exportName);
+                    else if ('default' === exportName) hasDefault = true;
+                    else namedExports.push(exportName);
+                }
+            });
+            else if (typescript.isNamespaceExport(node.exportClause)) namedExports.push(node.exportClause.name.text);
+        }
+        typescript.isExportDeclaration(node) && node.exportClause;
+        typescript.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    const uniqueExports = Array.from(new Set(namedExports));
+    if (!hasDefault && 0 === uniqueExports.length) {
+        const hasDefaultRegex = /export\s+default\s+/;
+        const hasNamedRegex = /export\s+(?:const|let|var|function|class|interface|type|enum)\s+([A-Za-z_$][A-Za-z0-9_$]*)/g;
+        const regexHasDefault = hasDefaultRegex.test(content);
+        const regexNamedMatches = [];
+        let match;
+        while(null !== (match = hasNamedRegex.exec(content)))regexNamedMatches.push(match[1]);
+        if (regexHasDefault || regexNamedMatches.length > 0) {
+            console.warn(`${PLUGIN_LOG_PREFIX} 警告：AST 分析未检测到导出，但正则检测到：\n  文件: ${filePath}\n  正则检测 default: ${regexHasDefault}\n  正则检测命名导出: ${regexNamedMatches.join(', ') || '无'}\n  这可能是 AST 解析问题，将尝试继续构建。`);
+            if (regexHasDefault) hasDefault = true;
+            if (regexNamedMatches.length > 0) namedExports.push(...regexNamedMatches);
+        }
+    }
+    return {
+        hasDefault,
+        namedExports: Array.from(new Set(namedExports))
+    };
+}
+function generateLibVirtualEntryCode(params) {
+    const { defaultEntryAbs, componentName } = params;
+    if (!node_fs.existsSync(defaultEntryAbs)) throw new Error(`${PLUGIN_LOG_PREFIX} 入口文件不存在: "${defaultEntryAbs}"\n请检查文件路径是否正确。`);
+    const actualFile = tryResolveWithExtensions(defaultEntryAbs) || defaultEntryAbs;
+    if (!node_fs.existsSync(actualFile)) throw new Error(`${PLUGIN_LOG_PREFIX} 入口文件不存在: "${defaultEntryAbs}"\n尝试解析后的路径: "${actualFile}"\n请检查文件路径是否正确。`);
+    const importTarget = pathToFileURL(actualFile).href;
+    let exports;
+    try {
+        exports = analyzeExports(actualFile);
+    } catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        throw new Error(`${PLUGIN_LOG_PREFIX} 分析入口文件 "${actualFile}" 的导出时出错：\n${errorMsg}\n\n请检查文件：\n  1. 文件是否存在且可读\n  2. 文件是否有语法错误\n  3. 文件是否有导出（export default 或命名导出）\n\n原始路径: "${defaultEntryAbs}"\n实际解析路径: "${actualFile}"`);
+    }
+    let code;
+    if (exports.hasDefault || 0 !== exports.namedExports.length) if (exports.hasDefault) {
+        let prefer = '';
+        if (exports.namedExports.includes(componentName)) prefer = isValidJsIdentifier(componentName) ? `mod.${componentName}` : `mod[${JSON.stringify(componentName)}]`;
+        const pickedExpr = prefer ? `${prefer} || mod.default || mod` : 'mod.default || mod';
+        code = `/** AUTO-GENERATED by ${PLUGIN_NAME} */
+import * as mod from ${JSON.stringify(importTarget)};
+const picked = ${pickedExpr};
+const Card = picked && picked.default ? picked.default : picked;
+export default Card;
+export * from ${JSON.stringify(importTarget)};
+`;
+    } else if (1 === exports.namedExports.length) {
+        const singleExport = exports.namedExports[0];
+        const exportAccess = isValidJsIdentifier(singleExport) ? `mod.${singleExport}` : `mod[${JSON.stringify(singleExport)}]`;
+        code = `/** AUTO-GENERATED by ${PLUGIN_NAME} */
+import * as mod from ${JSON.stringify(importTarget)};
+const Card = ${exportAccess};
+export default Card;
+export * from ${JSON.stringify(importTarget)};
+`;
+    } else {
+        const hasComponentNameExport = exports.namedExports.some((exp)=>exp === componentName);
+        if (hasComponentNameExport) {
+            const exportAccess = isValidJsIdentifier(componentName) ? `mod.${componentName}` : `mod[${JSON.stringify(componentName)}]`;
+            code = `/** AUTO-GENERATED by ${PLUGIN_NAME} */
+import * as mod from ${JSON.stringify(importTarget)};
+const Card = ${exportAccess};
+export default Card;
+export * from ${JSON.stringify(importTarget)};
+`;
+        } else throw new Error(`${PLUGIN_LOG_PREFIX} Entry file "${defaultEntryAbs}" has multiple named exports (${exports.namedExports.join(', ')}), but none match componentName "${componentName}".\n\nPlease resolve this by:\n\n  1. Adding a default export (Recommended):\n     export default function ${componentName}() { ... }\n\n  2. Adding a named export called "${componentName}":\n     export function ${componentName}() { ... }\n\n  3. Keeping only one named export (it will be used automatically).\n\nCurrent componentName: "${componentName}"\nCurrent named exports: ${exports.namedExports.join(', ')}`);
+    }
+    else throw new Error(`${PLUGIN_LOG_PREFIX} Entry file "${defaultEntryAbs}" does not have any exports.\n\nPlease ensure the file has one of the following:\n\n  1. export default (Recommended):\n     export default function ${componentName}() { ... }\n     or\n     const ${componentName} = () => { ... };\n     export default ${componentName};\n\n  2. Named export matching componentName:\n     export function ${componentName}() { ... }\n     or\n     export const ${componentName} = () => { ... };\n\n  3. A single named export (any name):\n     export function MyComponent() { ... }\n     // If there is only one named export, it will be used automatically.\n\nCurrent componentName: "${componentName}"`);
+    return code;
+}
+function getLibVirtualEntryPath(componentName) {
+    return `virtual:${PLUGIN_NAME}-lib-entry:${componentName}`;
+}
+function normalizeLibCss(outDir, baseName) {
+    if (!node_fs.existsSync(outDir)) return;
+    const target = node_path.join(outDir, `${baseName}.css`);
+    if (node_fs.existsSync(target)) return;
+    const cssCandidates = [];
+    const scanDir = (dir, depth)=>{
+        if (depth < 0 || !node_fs.existsSync(dir)) return;
+        const entries = node_fs.readdirSync(dir, {
+            withFileTypes: true
+        });
+        for (const e of entries){
+            const full = node_path.join(dir, e.name);
+            if (e.isDirectory()) scanDir(full, depth - 1);
+            else if (e.isFile() && e.name.endsWith('.css')) cssCandidates.push(full);
+        }
+    };
+    scanDir(outDir, 2);
+    if (1 !== cssCandidates.length) return;
+    const from = cssCandidates[0];
+    try {
+        node_fs.renameSync(from, target);
+    } catch  {
+        try {
+            node_fs.copyFileSync(from, target);
+            node_fs.unlinkSync(from);
+        } catch  {}
+    }
+}
+function resolveBuildTargets(params) {
+    const { componentMap, requestedRaw, defaultEntryAbs } = params;
+    const componentNames = Object.keys(componentMap);
+    const requestedList = requestedRaw ? requestedRaw.split(',').map((s)=>s.trim()).filter(Boolean) : [];
+    const actualConfiguredNames = componentNames.filter((n)=>'*' !== n);
+    if (actualConfiguredNames.length > 0) {
+        if (requestedList.length > 0) {
+            const picked = requestedList.filter((n)=>actualConfiguredNames.includes(n));
+            if (0 === picked.length) throw new Error(`${PLUGIN_LOG_PREFIX} 指定的 component 不在配置列表中：${requestedRaw}`);
+            return picked;
+        }
+        return actualConfiguredNames;
+    }
+    if (requestedList.length > 0) return requestedList;
+    const fallbackName = node_path.parse(defaultEntryAbs || 'index').name || 'index';
+    return [
+        fallbackName
+    ];
+}
+function generateLibBuildNextConfig(params) {
+    const { rootDir, picked, componentMap, resolvedConfig, options, userConfig, configDir } = params;
+    const outBase = toSafeOutDirName(picked);
+    const outDir = node_path.resolve(rootDir, 'dist', outBase);
+    let resolvedEntryAbs = resolvedConfig.defaultEntryAbs;
+    const entryAbs = (()=>{
+        const entryFromMap = componentMap[picked];
+        if (entryFromMap) {
+            const abs = resolveEntryAbsPath(rootDir, entryFromMap, resolvedConfig.defaultEntryAbs, configDir);
+            if (!abs) throw new Error(`${PLUGIN_LOG_PREFIX} 无法解析入口：component="${picked}", entry="${entryFromMap}"`);
+            resolvedEntryAbs = abs;
+        }
+        return getLibVirtualEntryPath(picked);
+    })();
+    const virtualEntryCode = (()=>{
+        const entryFromMap = componentMap[picked];
+        if (entryFromMap) {
+            const abs = resolveEntryAbsPath(rootDir, entryFromMap, resolvedConfig.defaultEntryAbs, configDir);
+            if (!abs) throw new Error(`${PLUGIN_LOG_PREFIX} 无法解析入口：component="${picked}", entry="${entryFromMap}"`);
+            resolvedEntryAbs = abs;
+            return generateLibVirtualEntryCode({
+                rootDir,
+                defaultEntryAbs: abs,
+                componentName: picked
+            });
+        }
+        resolvedEntryAbs = resolvedConfig.defaultEntryAbs;
+        return generateLibVirtualEntryCode({
+            rootDir,
+            defaultEntryAbs: resolvedConfig.defaultEntryAbs,
+            componentName: picked
+        });
+    })();
+    const next = {
+        root: rootDir,
+        define: {
+            ...userConfig.define || {},
+            'process.env.NODE_ENV': JSON.stringify('production')
+        },
+        build: {
+            outDir,
+            emptyOutDir: true,
+            cssCodeSplit: false,
+            lib: {
+                entry: entryAbs,
+                name: toSafeUmdName(picked),
+                formats: [
+                    'umd'
+                ],
+                fileName: ()=>`${outBase}.js`
+            },
+            rollupOptions: {
+                external: [
+                    'react',
+                    'react-dom',
+                    'react-dom/client'
+                ],
+                output: {
+                    inlineDynamicImports: true,
+                    exports: 'named',
+                    globals: {
+                        react: 'React',
+                        'react-dom': 'ReactDOM',
+                        'react-dom/client': 'ReactDOMClient'
+                    },
+                    assetFileNames: (assetInfo)=>{
+                        const name = assetInfo?.name || '';
+                        if (name.endsWith('.css')) return `${outBase}.css`;
+                        return 'assets/[name]-[hash][extname]';
+                    }
+                }
+            }
+        }
+    };
+    if (options.build) {
+        const merged = mergeConfig({
+            build: next.build
+        }, {
+            build: options.build
+        });
+        next.build = merged.build;
+    }
+    return {
+        next,
+        outDir: next.build?.outDir || outDir,
+        outBase,
+        buildTargets: [],
+        virtualEntryCode,
+        resolvedEntryAbs
+    };
+}
+function injectReactImport(code, id) {
+    const cleanId = id.split('?')[0];
+    if (cleanId.includes('/node_modules/')) return null;
+    if (!/\.([tj])sx$/.test(cleanId)) return null;
+    const hasReactRuntimeImport = /^\s*import\s+(?!type)(?:\*\s+as\s+React|React)\b[\s\S]*?\bfrom\s*['"]react['"]\s*;?/m.test(code);
+    if (!hasReactRuntimeImport) return {
+        code: `import * as React from 'react'\n${code}`,
+        map: null
+    };
+    return null;
+}
+function transformAssetUrl(code, id) {
+    if (id.includes('?import') || /\.(svg|png|jpg|jpeg|gif|webp|ico|bmp|tiff|woff|woff2|ttf|eot|otf)$/.test(id)) {
+        const relativePathMatch = code.match(/export\s+default\s+["']([^"']+)["']/);
+        if (relativePathMatch) {
+            const relativePath = relativePathMatch[1];
+            if (relativePath.startsWith('/') && !relativePath.startsWith('http')) {
+                const transformedCode = code.replace(/export\s+default\s+["']([^"']+)["']/, `export default (() => {
+                const path = "${relativePath}";
+                if (typeof window !== 'undefined' && window[${JSON.stringify(DEV_TO_REACT_RESOLVE_ASSET_KEY)}]) {
+                  return window[${JSON.stringify(DEV_TO_REACT_RESOLVE_ASSET_KEY)}](path);
+                }
+                try {
+                  const ORIGIN = new URL(import.meta.url).origin;
+                  return path.startsWith('http') ? path : ORIGIN + path;
+                } catch (e) {
+                  console.warn('${PLUGIN_LOG_PREFIX} Failed to resolve static asset URL:', path, e);
+                  return path;
+                }
+              })()`);
+                return {
+                    code: transformedCode,
+                    map: null
+                };
+            }
+        }
+    }
+    return null;
+}
+function transformViteDevCssAssetUrls(code, id) {
+    const cleanId = id.split('?')[0];
+    if (!/\.(css|less|sass|scss|styl|stylus)$/.test(cleanId)) return null;
+    if (!code.includes('__vite__updateStyle') || !code.includes('const __vite__css')) return null;
+    if (!/url\(\s*['"]?\//.test(code)) return null;
+    if (code.includes('__dev_to_react_css')) return null;
+    const updateCallRE = /__vite__updateStyle\(\s*__vite__id\s*,\s*__vite__css\s*\)/;
+    if (!updateCallRE.test(code)) return null;
+    const injected = `
+const __dev_to_react_resolveAsset = (path) => {
+  if (!path) return path;
+  if (path.startsWith('http://') || path.startsWith('https://') || path.startsWith('data:') || path.startsWith('blob:')) {
+    return path;
+  }
+  try {
+    const g = typeof globalThis !== 'undefined' ? globalThis : window;
+    const fn = g && g[${JSON.stringify(DEV_TO_REACT_RESOLVE_ASSET_KEY)}];
+    if (typeof fn === 'function') return fn(path);
+  } catch {
+    // ignore
+  }
+  try {
+    const origin = new URL(import.meta.url).origin;
+    return path.startsWith('/') ? origin + path : origin + '/' + path;
+  } catch (e) {
+    console.warn('${PLUGIN_LOG_PREFIX} Failed to resolve CSS asset URL:', path, e);
+    return path;
+  }
+};
+const __dev_to_react_css = __vite__css.replace(/url\\(\\s*(['"]?)(\\/(?!\\/)[^'")]+)\\1\\s*\\)/g, (_m, q, p) => {
+  const next = __dev_to_react_resolveAsset(p);
+  return 'url(' + q + next + q + ')';
+});
+`;
+    const nextCode = code.replace(updateCallRE, `${injected}__vite__updateStyle(__vite__id, __dev_to_react_css)`);
+    return {
+        code: nextCode,
+        map: null
+    };
+}
+function createContractVirtualModuleCode(contract) {
+    return `
+    const CONTRACT = ${JSON.stringify(contract)};
+    const ORIGIN = new URL(import.meta.url).origin;
+    const G = typeof globalThis !== 'undefined' ? globalThis : window;
+    const DEBUG_KEY = ${JSON.stringify(DEV_TO_REACT_DEBUG_STATE_KEY)};
+    const STATE = (G[DEBUG_KEY] ||= { logged: {} });
+    if (!STATE.logged.contract) {
+      STATE.logged.contract = true;
+      console.groupCollapsed('${PLUGIN_LOG_PREFIX} contract loaded');
+      console.log('Origin:', ORIGIN);
+      console.log('Paths:', CONTRACT.paths);
+      console.log('Events:', CONTRACT.events);
+      console.log('Dev mode:', CONTRACT?.dev?.mode);
+      console.log('Default entry:', CONTRACT?.dev?.defaultEntry);
+      console.log('devComponentMap keys:', Object.keys(CONTRACT?.dev?.componentMap || {}));
+      console.log('Tip: open', ORIGIN + '${STABLE_DEBUG_HTML_PATH}');
+      console.groupEnd();
+    }
+    export const DEV_TO_REACT_CONTRACT = CONTRACT;
+    export default CONTRACT;
+  `;
+}
+function createInitVirtualModuleCode() {
+    const contractExportName = 'DEV_TO_REACT_CONTRACT';
+    const globalKey = DEV_TO_REACT_CONTRACT_KEY;
+    return `
+    import "/@vite/client";
+    import RefreshRuntime from "/@react-refresh";
+    import CONTRACT, { ${contractExportName} as CONTRACT_NAMED } from "${STABLE_CONTRACT_PATH}";
+    if (typeof window !== 'undefined' && !window.__vite_plugin_react_preamble_installed__) {
+      RefreshRuntime.injectIntoGlobalHook(window);
+      window.$RefreshReg$ = (type, id) => RefreshRuntime.register(type, id);
+      window.$RefreshSig$ = RefreshRuntime.createSignatureFunctionForTransform;
+      window.__vite_plugin_react_preamble_installed__ = true;
+      console.log('${PLUGIN_LOG_PREFIX} React Refresh preamble installed.');
+    }
+    {
+      const ORIGIN = new URL(import.meta.url).origin;
+      const G = typeof globalThis !== 'undefined' ? globalThis : window;
+      const DEBUG_KEY = ${JSON.stringify(DEV_TO_REACT_DEBUG_STATE_KEY)};
+      const STATE = (G[DEBUG_KEY] ||= { logged: {} });
+      if (!STATE.logged.init) {
+        STATE.logged.init = true;
+        console.groupCollapsed('${PLUGIN_LOG_PREFIX} init loaded (HMR enabled)');
+        console.log('Origin:', ORIGIN);
+        console.log('This module imports /@vite/client and installs react-refresh preamble.');
+        console.log('Important: init must run BEFORE importing react-dom/client in the host.');
+        console.log('Tip: open', ORIGIN + '${STABLE_DEBUG_HTML_PATH}');
+        console.groupEnd();
+      }
+      // 设置全局 Vite 服务器 origin，用于静态资源 URL 转换
+      // 在宿主页面（file:///Electron）中，静态资源的相对路径需要转换为完整 URL
+      if (typeof window !== 'undefined') {
+        window[${JSON.stringify(DEV_TO_REACT_ORIGIN_KEY)}] = ORIGIN;
+        // 添加全局辅助函数，用于将相对路径转换为完整的 Vite 服务器 URL
+        window[${JSON.stringify(DEV_TO_REACT_RESOLVE_ASSET_KEY)}] = (path) => {
+          if (!path) return path;
+          if (path.startsWith('http://') || path.startsWith('https://') || path.startsWith('data:')) {
+            return path;
+          }
+          const origin = window[${JSON.stringify(DEV_TO_REACT_ORIGIN_KEY)}] || ORIGIN;
+          return path.startsWith('/') ? origin + path : origin + '/' + path;
+        };
+      }
+    }
+    if (import.meta.hot) {
+      import.meta.hot.accept();
+      import.meta.hot.on('vite:beforeFullReload', () => {
+        window.dispatchEvent(new CustomEvent(CONTRACT.events.fullReload));
+      });
+      import.meta.hot.on('vite:afterUpdate', (payload) => {
+        payload.updates.forEach(update => {
+          window.dispatchEvent(new CustomEvent(CONTRACT.events.hmrUpdate, {
+            detail: { file: update.path, timestamp: payload.timestamp }
+          }));
+        });
+      });
+    }
+    export const ${contractExportName} = CONTRACT_NAMED || CONTRACT;
+    if (typeof window !== 'undefined') {
+      window[${JSON.stringify(globalKey)}] = CONTRACT;
+    }
+    export default CONTRACT;
+  `;
+}
+function createReactRuntimeVirtualModuleCode() {
+    return `
+    import React from "react";
+    import * as ReactDOMClient from "react-dom/client";
+    {
+      const ORIGIN = new URL(import.meta.url).origin;
+      const G = typeof globalThis !== 'undefined' ? globalThis : window;
+      const DEBUG_KEY = ${JSON.stringify(DEV_TO_REACT_DEBUG_STATE_KEY)};
+      const STATE = (G[DEBUG_KEY] ||= { logged: {} });
+      if (!STATE.logged.runtime) {
+        STATE.logged.runtime = true;
+        console.groupCollapsed('${PLUGIN_LOG_PREFIX} react-runtime loaded');
+        console.log('Origin:', ORIGIN);
+        console.log('React.version:', React?.version);
+        console.log('ReactDOMClient keys:', Object.keys(ReactDOMClient || {}));
+        console.log('Tip: open', ORIGIN + '${STABLE_DEBUG_HTML_PATH}');
+        console.groupEnd();
+      }
+    }
+    export { React, ReactDOMClient };
+    export default React;
+  `;
+}
+const devToReactPlugin = (devComponentMap = {}, options = {})=>{
+    const stats = {
+        contract: {
+            count: 0,
+            lastAt: 0
+        },
+        init: {
+            count: 0,
+            lastAt: 0
+        },
+        runtime: {
+            count: 0,
+            lastAt: 0
+        }
+    };
+    const debugState = {
+        didPrintStartupDebugUrl: false
+    };
+    let configDir = process.cwd();
+    let currentRootDir = configDir;
+    let resolvedConfig = resolveDevComponentConfig(currentRootDir, devComponentMap, configDir);
+    let version = '0.0.0';
+    try {
+        const pkgPath = node_path.join(configDir, 'package.json');
+        if (node_fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(node_fs.readFileSync(pkgPath, 'utf-8'));
+            version = pkg.version || version;
+        }
+    } catch  {}
+    const createContract = (componentMap, defaultEntryAbs, isDevMode = false)=>{
+        const processedComponentMap = {};
+        for (const [key, value] of Object.entries(componentMap))if ('/' === value && isDevMode) processedComponentMap[key] = toViteFsPath(defaultEntryAbs);
+        else processedComponentMap[key] = value;
+        return {
+            paths: {
+                contract: STABLE_CONTRACT_PATH,
+                initClient: STABLE_INIT_PATH,
+                reactRuntime: STABLE_REACT_RUNTIME_PATH
+            },
+            events: {
+                fullReload: EVENT_FULL_RELOAD,
+                hmrUpdate: EVENT_HMR_UPDATE
+            },
+            dev: {
+                componentMap: processedComponentMap
+            }
+        };
+    };
+    let contract = createContract(resolvedConfig.componentMap, resolvedConfig.defaultEntryAbs, true);
+    let viteResolved = null;
+    const libBuildState = {
+        enabled: false,
+        isChild: false,
+        currentComponent: '',
+        currentOutDir: '',
+        currentOutBase: '',
+        currentEntryAbs: '',
+        remainingComponents: [],
+        virtualEntryCode: '',
+        startAt: 0,
+        totalComponents: 0,
+        currentIndex: 1
+    };
+    const shortenPath = (p)=>{
+        if (!p) return '';
+        const normalize = (abs)=>`/${node_path.relative(configDir, abs).replace(/\\/g, '/')}`;
+        if (p.startsWith('/@fs')) return normalize(p.slice(4));
+        if (node_path.isAbsolute(p)) return normalize(p);
+        return p;
+    };
+    const stripAnsi = (input)=>{
+        let out = '';
+        for(let i = 0; i < input.length; i += 1){
+            if (27 === input.charCodeAt(i) && '[' === input[i + 1]) {
+                i += 2;
+                while(i < input.length && 'm' !== input[i])i += 1;
+                continue;
+            }
+            out += input[i];
+        }
+        return out;
+    };
+    let lastComponentPrinted = '';
+    const printLibBanner = (step, component, extra = {})=>{
+        const lines = [];
+        const push = (s)=>lines.push(s);
+        if ('spawn' === step) return;
+        {
+            const isNewComponent = lastComponentPrinted !== component;
+            if (isNewComponent) {
+                if (process.stdout.isTTY) {
+                    const progressStr = libBuildState.totalComponents > 1 ? picocolors.dim(` [${libBuildState.currentIndex}/${libBuildState.totalComponents}]`) : '';
+                    process.stdout.write(`\r  ✅  ${picocolors.dim('Prepared component:')}  ${picocolors.bold(picocolors.magenta(component))}${progressStr}      \n`);
+                }
+                if (lastComponentPrinted) push('\n\n');
+                lastComponentPrinted = component;
+                const progress = libBuildState.totalComponents > 1 ? picocolors.dim(` [${libBuildState.currentIndex}/${libBuildState.totalComponents}]`) : '';
+                const title = ` 📦 Building Component: ${component}${progress} `;
+                const border = '━'.repeat(stripAnsi(title).length);
+                push(picocolors.cyan(`┏${border}┓`));
+                push(`${picocolors.cyan('┃')}${picocolors.bold(picocolors.magenta(title))}${picocolors.cyan('┃')}`);
+                push(picocolors.cyan(`┗${border}┛`));
+            }
+            if ('prepare' === step) {
+                const root = picocolors.dim(shortenPath(extra.root));
+                const name = picocolors.bold(picocolors.cyan(component));
+                const src = picocolors.blue(shortenPath(extra.entry));
+                const out = extra.out ? picocolors.dim(' ➔ ') + picocolors.yellow(shortenPath(extra.out)) : '';
+                push(`${picocolors.cyan(PLUGIN_NAME)} ${picocolors.dim(`v${version}`)} ${picocolors.dim('building')} ${name}${picocolors.dim(':')} ${root} ${picocolors.dim('➔')} ${src}${out}`);
+            } else if ('done' === step) push('\n');
+        }
+        const msg = lines.join('\n');
+        if (msg.trim() || 'done' === step && '\n' === msg) if (viteResolved?.logger) viteResolved.logger.info(msg);
+        else console.log(msg);
+    };
+    const corePlugin = {
+        name: '@dev-to/react-plugin',
+        enforce: 'pre',
+        configureServer (server) {
+            contract = createContract(resolvedConfig.componentMap, resolvedConfig.defaultEntryAbs, true);
+            if (1 === Object.keys(resolvedConfig.componentMap).length && '/' === resolvedConfig.componentMap['*']) {
+                const warn = server.config.logger?.warn?.bind(server.config.logger) ?? console.warn;
+                warn('');
+                warn(`⚠️  ${PLUGIN_LOG_PREFIX} No componentName configured. This works in dev mode but will fail in library build (--mode lib).`);
+                warn('   Please use devToReactPlugin({ ComponentName: "src/ComponentName.tsx" }) or devToReactPlugin({ ComponentName: "/" }) to specify components.');
+                warn('   Or use wildcard: devToReactPlugin({ "*": "/" }) or devToReactPlugin("*")');
+                warn('');
+            }
+            installDebugTools(server, {
+                contract,
+                stats,
+                audit: resolvedConfig.audit,
+                open: options.open
+            }, debugState);
+        },
+        config (userConfig, env) {
+            const rootDir = configDir;
+            if (rootDir !== currentRootDir) {
+                currentRootDir = rootDir;
+                resolvedConfig = resolveDevComponentConfig(rootDir, devComponentMap, configDir);
+                const isDev = !isLibBuild(env);
+                contract = createContract(resolvedConfig.componentMap, resolvedConfig.defaultEntryAbs, isDev);
+            }
+            const next = {
+                server: {
+                    host: userConfig.server?.host ?? true,
+                    cors: userConfig.server?.cors ?? true
+                },
+                css: {
+                    modules: {
+                        generateScopedName: '[name]__[local]___[hash:base64:5]'
+                    }
+                }
+            };
+            if (false === options.css) next.css = void 0;
+            else if (options.css) next.css = mergeConfig({
+                css: next.css
+            }, {
+                css: options.css
+            }).css;
+            if (isLibBuild(env)) {
+                const actualNames = Object.keys(contract.dev.componentMap).filter((n)=>'*' !== n);
+                if (0 === actualNames.length && !process.env.DEV_TO_REACT_LIB_SECTION) throw new Error(` ${PLUGIN_LOG_PREFIX} Library build (--mode lib) requires at least one explicit componentName for identification and distribution.\nCurrent configuration is in "global fallback mode", which cannot determine build targets.\n\nPlease use one of the following to specify components:\n  - devToReactPlugin('ComponentName')\n  - devToReactPlugin({ ComponentName: '/' })\n  - devToReactPlugin({ ComponentName: 'src/ComponentName.tsx' })\n\n💡 Tip: Wildcards are convenient for development, but explicit naming is required for production builds.`);
+                const isChild = '1' === process.env.DEV_TO_REACT_LIB_CHILD;
+                const buildTargets = resolveBuildTargets({
+                    componentMap: contract.dev.componentMap,
+                    requestedRaw: process.env.DEV_TO_REACT_LIB_SECTION || '',
+                    defaultEntryAbs: resolvedConfig.defaultEntryAbs
+                });
+                const totalComponents = isChild ? parseInt(process.env.DEV_TO_REACT_LIB_TOTAL || '1', 10) : buildTargets.length;
+                const currentIndex = parseInt(process.env.DEV_TO_REACT_LIB_INDEX || '1', 10);
+                if (!isChild) {
+                    console.log(`\n${picocolors.bgCyan(picocolors.black(picocolors.bold(' 🏗️  Starting Library Build Process ')))}`);
+                    console.log(`${picocolors.cyan('┃')} Total components to build: ${picocolors.bold(picocolors.magenta(totalComponents))}`);
+                    console.log(`${picocolors.cyan('┃')} Build targets: ${picocolors.dim(buildTargets.join(', '))}\n`);
+                }
+                const picked = buildTargets[0];
+                if (process.stdout.isTTY) {
+                    const progressStr = totalComponents > 1 ? picocolors.dim(` [${currentIndex}/${totalComponents}]`) : '';
+                    process.stdout.write(`  ⌛  ${picocolors.dim('Preparing component:')}  ${picocolors.bold(picocolors.magenta(picked))}${progressStr}...`);
+                } else console.log(`  ${picocolors.yellow('⌛')} Preparing component: ${picked}...`);
+                const libCfg = generateLibBuildNextConfig({
+                    rootDir,
+                    configDir,
+                    picked,
+                    componentMap: contract.dev.componentMap,
+                    resolvedConfig,
+                    options,
+                    userConfig
+                });
+                Object.assign(libBuildState, {
+                    enabled: true,
+                    isChild,
+                    currentComponent: picked,
+                    currentOutDir: libCfg.outDir,
+                    currentOutBase: libCfg.outBase,
+                    currentEntryAbs: libCfg.resolvedEntryAbs,
+                    remainingComponents: isChild ? [] : buildTargets.slice(1),
+                    virtualEntryCode: libCfg.virtualEntryCode,
+                    startAt: Date.now(),
+                    totalComponents,
+                    currentIndex
+                });
+                printLibBanner('prepare', picked, {
+                    root: rootDir,
+                    entry: libCfg.resolvedEntryAbs,
+                    out: libCfg.outDir
+                });
+                return mergeConfig(next, libCfg.next);
+            }
+            return next;
+        },
+        configResolved (resolved) {
+            viteResolved = resolved;
+            if (resolved.configFile) {
+                const nextConfigDir = node_path.dirname(resolved.configFile);
+                if (nextConfigDir !== configDir) {
+                    configDir = nextConfigDir;
+                    currentRootDir = configDir;
+                    resolvedConfig = resolveDevComponentConfig(currentRootDir, devComponentMap, configDir);
+                    const isDev = 'serve' === resolved.command;
+                    contract = createContract(resolvedConfig.componentMap, resolvedConfig.defaultEntryAbs, isDev);
+                }
+            }
+        },
+        buildStart () {
+            if (libBuildState.enabled && !libBuildState.virtualEntryCode) throw new Error(`${PLUGIN_LOG_PREFIX} lib 构建模式已启用，但虚拟入口模块代码未生成。\n当前 component: "${libBuildState.currentComponent}"\n这可能是插件配置问题，请检查 vite.config.ts 中的配置。`);
+        },
+        async closeBundle () {
+            if (!libBuildState.enabled) return;
+            normalizeLibCss(libBuildState.currentOutDir, libBuildState.currentOutBase);
+            printLibBanner('done', libBuildState.currentComponent, {
+                outDir: libBuildState.currentOutDir,
+                file: libBuildState.currentOutBase,
+                entry: libBuildState.currentEntryAbs,
+                took: libBuildState.startAt ? `${Date.now() - libBuildState.startAt}ms` : void 0
+            });
+            if (libBuildState.isChild || 0 === libBuildState.remainingComponents.length || !viteResolved?.configFile) return;
+            const { build } = await import("vite");
+            const prevChild = process.env.DEV_TO_REACT_LIB_CHILD;
+            const prevSection = process.env.DEV_TO_REACT_LIB_SECTION;
+            const prevTotal = process.env.DEV_TO_REACT_LIB_TOTAL;
+            const prevIndex = process.env.DEV_TO_REACT_LIB_INDEX;
+            let childIdx = libBuildState.currentIndex + 1;
+            for (const componentName of libBuildState.remainingComponents){
+                process.env.DEV_TO_REACT_LIB_CHILD = '1';
+                process.env.DEV_TO_REACT_LIB_SECTION = componentName;
+                process.env.DEV_TO_REACT_LIB_TOTAL = String(libBuildState.totalComponents);
+                process.env.DEV_TO_REACT_LIB_INDEX = String(childIdx++);
+                try {
+                    printLibBanner('spawn', componentName, {
+                        cfg: viteResolved.configFile
+                    });
+                    await build({
+                        configFile: viteResolved.configFile,
+                        mode: 'lib',
+                        clearScreen: false,
+                        logLevel: viteResolved.logLevel
+                    });
+                } finally{
+                    process.env.DEV_TO_REACT_LIB_CHILD = prevChild;
+                    process.env.DEV_TO_REACT_LIB_SECTION = prevSection;
+                    process.env.DEV_TO_REACT_LIB_TOTAL = prevTotal;
+                    process.env.DEV_TO_REACT_LIB_INDEX = prevIndex;
+                }
+            }
+        },
+        resolveId (source) {
+            if (source.includes(STABLE_CONTRACT_PATH)) return `\0virtual:${PLUGIN_NAME}-contract`;
+            if (source.includes(STABLE_INIT_PATH)) return `\0virtual:${PLUGIN_NAME}-init`;
+            if (source.includes(STABLE_REACT_RUNTIME_PATH)) return `\0virtual:${PLUGIN_NAME}-react-runtime`;
+            if (source.includes(`virtual:${PLUGIN_NAME}-lib-entry:`)) {
+                const pos = source.indexOf(`virtual:${PLUGIN_NAME}-lib-entry:`);
+                const virtualSource = source.slice(pos);
+                return `\0${virtualSource}`;
+            }
+            return null;
+        },
+        load (id) {
+            if (id === `\0virtual:${PLUGIN_NAME}-contract`) return createContractVirtualModuleCode(contract);
+            if (id === `\0virtual:${PLUGIN_NAME}-init`) return createInitVirtualModuleCode();
+            if (id === `\0virtual:${PLUGIN_NAME}-react-runtime`) return createReactRuntimeVirtualModuleCode();
+            if (id.startsWith(`\0virtual:${PLUGIN_NAME}-lib-entry:`)) {
+                const componentName = id.replace(`\0virtual:${PLUGIN_NAME}-lib-entry:`, '');
+                if (libBuildState.enabled) {
+                    if (libBuildState.virtualEntryCode) return libBuildState.virtualEntryCode;
+                    throw new Error(`${PLUGIN_LOG_PREFIX} 虚拟入口模块 "${id}" (componentName: "${componentName}") 的代码未生成。\n这可能是插件配置问题，请检查 vite.config.ts 中的配置。\n当前 libBuildState: ${JSON.stringify({
+                        enabled: libBuildState.enabled,
+                        currentComponent: libBuildState.currentComponent,
+                        hasCode: !!libBuildState.virtualEntryCode
+                    })}`);
+                }
+                if (resolvedConfig && resolvedConfig.componentMap) {
+                    const entryFromMap = resolvedConfig.componentMap[componentName];
+                    if (entryFromMap) {
+                        const abs = resolveEntryAbsPath(currentRootDir, entryFromMap, resolvedConfig.defaultEntryAbs, configDir);
+                        if (abs) try {
+                            const code = generateLibVirtualEntryCode({
+                                rootDir: currentRootDir,
+                                defaultEntryAbs: abs,
+                                componentName
+                            });
+                            libBuildState.virtualEntryCode = code;
+                            libBuildState.enabled = true;
+                            libBuildState.currentComponent = componentName;
+                            return code;
+                        } catch (error) {
+                            throw new Error(`${PLUGIN_LOG_PREFIX} 无法生成虚拟入口模块代码：${error instanceof Error ? error.message : String(error)}`);
+                        }
+                    }
+                }
+                throw new Error(`${PLUGIN_LOG_PREFIX} 虚拟入口模块 "${id}" (componentName: "${componentName}") 在插件配置完成之前被请求，且无法延迟生成代码。\n这可能是 Vite/Rollup 的内部时序问题。\n请尝试重新运行构建命令，如果问题持续，请检查 vite.config.ts 中的配置。`);
+            }
+            return null;
+        },
+        transform (code, id) {
+            if (libBuildState.enabled) {
+                const injected = injectReactImport(code, id);
+                if (injected) return injected;
+            }
+            return transformAssetUrl(code, id);
+        }
+    };
+    const devCssAssetPlugin = {
+        name: '@dev-to/react-plugin:dev-css-asset-url',
+        enforce: 'post',
+        transform (code, id) {
+            return transformViteDevCssAssetUrls(code, id);
+        }
+    };
+    const libPostPlugin = {
+        name: '@dev-to/react-plugin:lib-post',
+        enforce: 'post',
+        config (_userConfig, env) {
+            if (!isLibBuild(env)) return null;
+            return {
+                esbuild: {
+                    jsx: 'transform',
+                    jsxFactory: 'React.createElement',
+                    jsxFragment: 'React.Fragment'
+                }
+            };
+        }
+    };
+    return [
+        corePlugin,
+        devCssAssetPlugin,
+        libPostPlugin
+    ];
+};
+const viteHostReactBridgePlugin = devToReactPlugin;
+export { EVENT_FULL_RELOAD, EVENT_HMR_UPDATE, PLUGIN_LOG_PREFIX, PLUGIN_NAME, STABLE_BASE_PATH, STABLE_CONTRACT_PATH, STABLE_DEBUG_HTML_PATH, STABLE_DEBUG_JSON_PATH, STABLE_INIT_PATH, STABLE_REACT_RUNTIME_PATH, devToReactPlugin, viteHostReactBridgePlugin };