@dev-to/react-plugin 0.1.1 → 0.3.0

package/dist/constants.d.ts

@@ -6,6 +6,7 @@ export declare const STABLE_INIT_PATH: "/__dev_to_react__/init.js";
 export declare const STABLE_REACT_RUNTIME_PATH: "/__dev_to_react__/react-runtime.js";
 export declare const STABLE_DEBUG_HTML_PATH: "/__dev_to_react__/debug.html";
 export declare const STABLE_DEBUG_JSON_PATH: "/__dev_to_react__/debug.json";
+export declare const STABLE_LOADER_BASE_PATH: "/__dev_to_react__/loader";
 export declare const EVENT_FULL_RELOAD: "dev_to_react:full-reload";
 export declare const EVENT_HMR_UPDATE: "dev_to_react:hmr-update";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,WAAW,gBAAyB,CAAA;AACjD,eAAO,MAAM,iBAAiB,kBAA8B,CAAA;AAE5D,eAAO,MAAM,gBAAgB,qBAAyB,CAAA;AACtD,eAAO,MAAM,oBAAoB,iCAA6B,CAAA;AAC9D,eAAO,MAAM,gBAAgB,6BAAyB,CAAA;AACtD,eAAO,MAAM,yBAAyB,sCAAkC,CAAA;AACxE,eAAO,MAAM,sBAAsB,gCAA+B,CAAA;AAClE,eAAO,MAAM,sBAAsB,gCAA+B,CAAA;AAElE,eAAO,MAAM,iBAAiB,4BAAiC,CAAA;AAC/D,eAAO,MAAM,gBAAgB,2BAAgC,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,WAAW,gBAAyB,CAAA;AACjD,eAAO,MAAM,iBAAiB,kBAA8B,CAAA;AAE5D,eAAO,MAAM,gBAAgB,qBAAyB,CAAA;AACtD,eAAO,MAAM,oBAAoB,iCAA6B,CAAA;AAC9D,eAAO,MAAM,gBAAgB,6BAAyB,CAAA;AACtD,eAAO,MAAM,yBAAyB,sCAAkC,CAAA;AACxE,eAAO,MAAM,sBAAsB,gCAA+B,CAAA;AAClE,eAAO,MAAM,sBAAsB,gCAA+B,CAAA;AAClE,eAAO,MAAM,uBAAuB,4BAAgC,CAAA;AAEpE,eAAO,MAAM,iBAAiB,4BAAiC,CAAA;AAC/D,eAAO,MAAM,gBAAgB,2BAAgC,CAAA"}

package/dist/debugTools.d.ts

@@ -1,9 +1,11 @@
 import type { ViteDevServer } from 'vite';
-import type { BridgeContract, BridgeStats, DebugStartupState, DevComponentAudit } from './types.js';
+import type { BridgeContract, BridgeStats, DebugStartupState, DevComponentAudit, ResolvedDevComponentConfig } from './types.js';
 export interface DebugToolsContext {
     contract: BridgeContract;
     stats: BridgeStats;
     audit: DevComponentAudit;
+    resolvedConfig: ResolvedDevComponentConfig;
+    configDir: string;
     open?: boolean;
 }
 export declare function installDebugTools(server: ViteDevServer, ctx: DebugToolsContext, state: DebugStartupState): void;

package/dist/debugTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debugTools.d.ts","sourceRoot":"","sources":["../src/debugTools.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,iBAAiB,CAAA;IACxB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAqFD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,QAkQxG"}
+{"version":3,"file":"debugTools.d.ts","sourceRoot":"","sources":["../src/debugTools.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAG/H,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,iBAAiB,CAAA;IACxB,cAAc,EAAE,0BAA0B,CAAA;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAqFD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,QAwUxG"}

package/dist/index.js

@@ -1,20 +1,21 @@
-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 { 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_LOADER_BASE_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 { fileURLToPath } from "node:url";
 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 constants_PLUGIN_LOG_PREFIX = `[${PLUGIN_NAME}]`;
 const STABLE_BASE_PATH = DEV_TO_REACT_BASE_PATH;
-const STABLE_CONTRACT_PATH = DEV_TO_REACT_CONTRACT_PATH;
+const constants_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 STABLE_LOADER_BASE_PATH = DEV_TO_REACT_LOADER_BASE_PATH;
 const EVENT_FULL_RELOAD = DEV_TO_REACT_EVENT_FULL_RELOAD;
 const EVENT_HMR_UPDATE = DEV_TO_REACT_EVENT_HMR_UPDATE;
 function renderDebugHtml(params) {
@@ -51,7 +52,7 @@ function renderDebugHtml(params) {
             lines.push(dim(' */'));
             return `${lines.join('\n')}\n\n${escapeHtml(content)}`;
         } catch (e) {
-            return escapeHtml(`// ${PLUGIN_LOG_PREFIX} 无法读取配置文件: ${e}`);
+            return escapeHtml(`// ${constants_PLUGIN_LOG_PREFIX} 无法读取配置文件: ${e}`);
         }
     })();
     return `<!doctype html>
@@ -374,7 +375,7 @@ CSS: <span class="str">dist/&lt;name&gt;/&lt;name&gt;.css</span></pre>
                 <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>
+- Contract: <span class="str">${constants_STABLE_CONTRACT_PATH}</span>
 - Init:     <span class="str">${STABLE_INIT_PATH}</span>
 - Runtime:  <span class="str">${STABLE_REACT_RUNTIME_PATH}</span>
 
@@ -510,7 +511,7 @@ function tryResolveWithExtensions(p) {
 function resolveEntryAbsPath(rootDir, entry, defaultEntryAbs, fallbackRoot) {
     const tryResolveWithBase = (baseDir)=>{
         if ('/' === entry) {
-            if (!defaultEntryAbs) throw new Error(`${PLUGIN_LOG_PREFIX} 使用 / 作为入口时，必须提供 defaultEntryAbs 参数`);
+            if (!defaultEntryAbs) throw new Error(`${constants_PLUGIN_LOG_PREFIX} 使用 / 作为入口时，必须提供 defaultEntryAbs 参数`);
             return defaultEntryAbs;
         }
         const fsPath = toFsPathFromViteEntry(entry);
@@ -528,6 +529,452 @@ function resolveEntryAbsPath(rootDir, entry, defaultEntryAbs, fallbackRoot) {
     if (fallbackRoot && fallbackRoot !== rootDir) return tryResolveWithBase(fallbackRoot);
     return resolved;
 }
+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(`${constants_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(`${constants_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(`${constants_PLUGIN_LOG_PREFIX} 入口文件不存在: "${defaultEntryAbs}"\n请检查文件路径是否正确。`);
+    const actualFile = tryResolveWithExtensions(defaultEntryAbs) || defaultEntryAbs;
+    if (!node_fs.existsSync(actualFile)) throw new Error(`${constants_PLUGIN_LOG_PREFIX} 入口文件不存在: "${defaultEntryAbs}"\n尝试解析后的路径: "${actualFile}"\n请检查文件路径是否正确。`);
+    const importTarget = actualFile;
+    let exports;
+    try {
+        exports = analyzeExports(actualFile);
+    } catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        throw new Error(`${constants_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(`${constants_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(`${constants_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(`${constants_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(`${constants_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(`${constants_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 createLoaderUmdWrapper(options) {
+    const { componentName, origin, contractEndpoint = constants_STABLE_CONTRACT_PATH, reactLoaderUrl = 'https://cdn.jsdelivr.net/npm/@dev-to/react-loader@latest/dist/index.umd.js' } = options;
+    const globalName = toSafeUmdName(componentName);
+    const code = `/**
+ * UMD Loader Wrapper for component: ${componentName}
+ * Global name: ${globalName}
+ * Generated by ${constants_PLUGIN_LOG_PREFIX}
+ *
+ * This wrapper uses @dev-to/react-loader to dynamically load and render the component.
+ *
+ * Usage:
+ * 1. Load React and ReactDOM:
+ *    <script crossorigin src="https://unpkg.com/react@18/umd/react.production.min.js"></script>
+ *    <script crossorigin src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>
+ *
+ * 2. Load ReactLoader:
+ *    <script src="https://cdn.jsdelivr.net/npm/@dev-to/react-loader@latest/dist/index.umd.js"></script>
+ *
+ * 3. Load this wrapper:
+ *    <script src="${origin}/__dev_to_react__/loader/${componentName}.js"></script>
+ *
+ * 4. Render the component (returns a Promise):
+ *    <div id="app"></div>
+ *    <script>
+ *      window.${globalName}.render(
+ *        document.getElementById('app'),
+ *        { prop1: 'value1', prop2: 'value2' }
+ *      ).then(function(root) {
+ *        console.log('Component rendered successfully');
+ *      }).catch(function(error) {
+ *        console.error('Failed to render component:', error);
+ *      });
+ *    </script>
+ *
+ * Note: ReactLoader will be automatically loaded from CDN if not already available.
+ */
+(function (root, factory) {
+  if (typeof exports === 'object' && typeof module !== 'undefined') {
+    // CommonJS
+    factory(exports, require('react'), require('react-dom'), require('@dev-to/react-loader'));
+  } else if (typeof define === 'function' && define.amd) {
+    // AMD
+    define(['exports', 'react', 'react-dom', '@dev-to/react-loader'], factory);
+  } else {
+    // Browser globals
+    var globalObj = typeof globalThis !== 'undefined' ? globalThis : (typeof self !== 'undefined' ? self : root);
+    factory((globalObj.${globalName} = {}), globalObj.React, globalObj.ReactDOM, globalObj.DevToReactLoader);
+  }
+})(this, function (exports, React, ReactDOM, ReactLoaderModule) {
+  'use strict';
+
+  var ReactLoader = null;
+  var loadingPromise = null;
+
+  // Helper function to load a script dynamically
+  function loadScript(src) {
+    return new Promise(function(resolve, reject) {
+      var script = document.createElement('script');
+      script.src = src;
+      script.onload = resolve;
+      script.onerror = reject;
+      document.head.appendChild(script);
+    });
+  }
+
+  // Helper function to ensure ReactLoader is loaded
+  function ensureReactLoaderLoaded() {
+    if (ReactLoader) {
+      return Promise.resolve();
+    }
+
+    if (!loadingPromise) {
+      loadingPromise = (function() {
+        // First, try to get ReactLoader from the global scope
+        if (typeof window !== 'undefined' && window.DevToReactLoader && window.DevToReactLoader.ReactLoader) {
+          ReactLoader = window.DevToReactLoader.ReactLoader;
+          return Promise.resolve();
+        }
+
+        // If not available, load it from URL
+        console.log('${constants_PLUGIN_LOG_PREFIX} Loading @dev-to/react-loader...');
+        return loadScript(${JSON.stringify(reactLoaderUrl)})
+          .then(function() {
+            if (typeof window !== 'undefined' && window.DevToReactLoader && window.DevToReactLoader.ReactLoader) {
+              ReactLoader = window.DevToReactLoader.ReactLoader;
+              console.log('${constants_PLUGIN_LOG_PREFIX} ReactLoader loaded successfully');
+            } else {
+              throw new Error('${constants_PLUGIN_LOG_PREFIX} ReactLoader not found after loading');
+            }
+          })
+          .catch(function(error) {
+            console.error('${constants_PLUGIN_LOG_PREFIX} Failed to load ReactLoader:', error);
+            throw error;
+          });
+      })();
+    }
+
+    return loadingPromise;
+  }
+
+  // Try to get ReactLoader from the module if available
+  if (ReactLoaderModule && ReactLoaderModule.ReactLoader) {
+    ReactLoader = ReactLoaderModule.ReactLoader;
+  }
+
+  // Component configuration
+  var config = {
+    origin: ${JSON.stringify(origin)},
+    name: ${JSON.stringify(componentName)},
+    contractEndpoint: ${JSON.stringify(contractEndpoint)}
+  };
+
+  /**
+   * Render the component using ReactLoader
+   */
+  function render(targetElement, componentProps) {
+    if (!targetElement) {
+      throw new Error('${constants_PLUGIN_LOG_PREFIX} Target element is required');
+    }
+
+    if (!React || !React.createElement) {
+      throw new Error('${constants_PLUGIN_LOG_PREFIX} React is not loaded');
+    }
+
+    if (!ReactDOM || !ReactDOM.createRoot) {
+      throw new Error('${constants_PLUGIN_LOG_PREFIX} ReactDOM is not loaded');
+    }
+
+    // Ensure ReactLoader is available before rendering
+    return ensureReactLoaderLoaded().then(function() {
+      if (!ReactLoader) {
+        throw new Error('${constants_PLUGIN_LOG_PREFIX} ReactLoader initialization failed');
+      }
+
+      // Create ReactLoader component props
+      var loaderProps = {
+        origin: config.origin,
+        name: config.name,
+        contractEndpoint: config.contractEndpoint,
+        componentProps: componentProps || {}
+      };
+
+      // Render using ReactLoader
+      var root = ReactDOM.createRoot(targetElement);
+      root.render(React.createElement(ReactLoader, loaderProps));
+
+      return root;
+    });
+  }
+
+  // Export the API
+  exports.render = render;
+  exports.config = config;
+  exports.default = { render: render, config: config };
+
+  // Mark as ES module
+  Object.defineProperty(exports, '__esModule', { value: true });
+});
+`;
+    return code;
+}
 function openBrowser(url) {
     const bridgePath = STABLE_DEBUG_HTML_PATH;
     if ('darwin' === process.platform) {
@@ -615,7 +1062,7 @@ function installDebugTools(server, ctx, state) {
         const logger = server.config.logger;
         const info = 'function' == typeof logger?.info ? logger.info.bind(logger) : console.log;
         info('');
-        info(`${PLUGIN_LOG_PREFIX} Debug panel:`);
+        info(`${constants_PLUGIN_LOG_PREFIX} Debug panel:`);
         urls.forEach((u)=>info(`  ${picocolors.cyan(u)}`));
         info(`  JSON: ${picocolors.cyan(`${proto}://localhost:${port}${STABLE_DEBUG_JSON_PATH}`)}`);
         info('');
@@ -635,7 +1082,7 @@ function installDebugTools(server, ctx, state) {
         const url = req.url || '';
         const pathname = String(url).split('?')[0];
         const now = Date.now();
-        if (pathname === STABLE_CONTRACT_PATH) {
+        if (pathname === constants_STABLE_CONTRACT_PATH) {
             ctx.stats.contract.count += 1;
             ctx.stats.contract.lastAt = now;
         } else if (pathname === STABLE_INIT_PATH) {
@@ -723,6 +1170,52 @@ function installDebugTools(server, ctx, state) {
             }, null, 2));
             return;
         }
+        if (pathname === `${STABLE_BASE_PATH}/react-loader.js`) try {
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = node_path.dirname(__filename);
+            const reactLoaderUmdPath = node_path.resolve(__dirname, '../../react-loader/dist/index.umd.js');
+            if (node_fs.existsSync(reactLoaderUmdPath)) {
+                const umdCode = node_fs.readFileSync(reactLoaderUmdPath, 'utf-8');
+                res.statusCode = 200;
+                res.setHeader('Content-Type', "application/javascript; charset=utf-8");
+                res.setHeader('Access-Control-Allow-Origin', '*');
+                res.setHeader('Cache-Control', 'no-cache, no-store, must-revalidate');
+                res.end(umdCode);
+                return;
+            }
+            res.statusCode = 404;
+            res.end(`react-loader UMD not found at ${reactLoaderUmdPath}. Run 'pnpm build' in react-loader package.`);
+            return;
+        } catch (error) {
+            res.statusCode = 500;
+            res.end(`Error loading react-loader UMD: ${error}`);
+            return;
+        }
+        if (pathname.startsWith(STABLE_LOADER_BASE_PATH)) {
+            const loaderPathPattern = new RegExp(`^${STABLE_LOADER_BASE_PATH}/([^/]+)\\.js$`);
+            const match = pathname.match(loaderPathPattern);
+            if (match) {
+                const componentName = match[1];
+                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 origin = hostHeader ? `${proto}://${hostHeader}` : `${proto}://localhost${actualPort ? `:${actualPort}` : ''}`;
+                const code = createLoaderUmdWrapper({
+                    componentName,
+                    origin,
+                    contractEndpoint: constants_STABLE_CONTRACT_PATH,
+                    reactLoaderUrl: `${origin}${STABLE_BASE_PATH}/react-loader.js`
+                });
+                res.statusCode = 200;
+                res.setHeader('Content-Type', "application/javascript; charset=utf-8");
+                res.setHeader('Access-Control-Allow-Origin', '*');
+                res.setHeader('Cache-Control', 'no-cache, no-store, must-revalidate');
+                res.end(code);
+                return;
+            }
+        }
         if (url.startsWith(STABLE_DEBUG_HTML_PATH)) {
             const addr = server.httpServer?.address();
             const actualPort = addr && 'object' == typeof addr ? addr.port : void 0;
@@ -792,387 +1285,102 @@ function installDebugTools(server, ctx, state) {
             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))
-    };
+        next();
+    });
 }
-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 toViteFsPath(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    return normalized.startsWith('/') ? `/@fs${normalized}` : `/@fs/${normalized}`;
 }
-function getLibVirtualEntryPath(componentName) {
-    return `virtual:${PLUGIN_NAME}-lib-entry:${componentName}`;
+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 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);
+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;
         }
-    };
-    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;
+        if (entry.startsWith('http://') || entry.startsWith('https://') || entry.startsWith('/')) {
+            out[componentName] = entry;
+            continue;
         }
-        return actualConfiguredNames;
+        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);
     }
-    if (requestedList.length > 0) return requestedList;
-    const fallbackName = node_path.parse(defaultEntryAbs || 'index').name || 'index';
-    return [
-        fallbackName
-    ];
+    return out;
 }
-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]';
-                    }
-                }
+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
+                });
             }
         }
-    };
-    if (options.build) {
-        const merged = mergeConfig({
-            build: next.build
-        }, {
-            build: options.build
-        });
-        next.build = merged.build;
-    }
+        return {
+            defaultEntryAbs,
+            defaultEntryExists: node_fs.existsSync(defaultEntryAbs),
+            componentMapCount: Object.keys(resolvedDevComponentMap).length,
+            missingEntries: missing
+        };
+    })();
     return {
-        next,
-        outDir: next.build?.outDir || outDir,
-        outBase,
-        buildTargets: [],
-        virtualEntryCode,
-        resolvedEntryAbs
+        defaultEntryAbs,
+        defaultEntry,
+        componentMap: resolvedDevComponentMap,
+        audit
     };
 }
 function injectReactImport(code, id) {
@@ -1201,7 +1409,7 @@ function transformAssetUrl(code, id) {
                   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);
+                  console.warn('${constants_PLUGIN_LOG_PREFIX} Failed to resolve static asset URL:', path, e);
                   return path;
                 }
               })()`);
@@ -1239,7 +1447,7 @@ const __dev_to_react_resolveAsset = (path) => {
     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);
+    console.warn('${constants_PLUGIN_LOG_PREFIX} Failed to resolve CSS asset URL:', path, e);
     return path;
   }
 };
@@ -1263,7 +1471,7 @@ function createContractVirtualModuleCode(contract) {
     const STATE = (G[DEBUG_KEY] ||= { logged: {} });
     if (!STATE.logged.contract) {
       STATE.logged.contract = true;
-      console.groupCollapsed('${PLUGIN_LOG_PREFIX} contract loaded');
+      console.groupCollapsed('${constants_PLUGIN_LOG_PREFIX} contract loaded');
       console.log('Origin:', ORIGIN);
       console.log('Paths:', CONTRACT.paths);
       console.log('Events:', CONTRACT.events);
@@ -1284,14 +1492,14 @@ function createInitVirtualModuleCode() {
     import "/@vite/client";
     import RefreshRuntime from "/@react-refresh";
 
-    import CONTRACT, { ${contractExportName} as CONTRACT_NAMED } from "${STABLE_CONTRACT_PATH}";
+    import CONTRACT, { ${contractExportName} as CONTRACT_NAMED } from "${constants_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.');
+      console.log('${constants_PLUGIN_LOG_PREFIX} React Refresh preamble installed.');
     }
 
     {
@@ -1301,7 +1509,7 @@ function createInitVirtualModuleCode() {
       const STATE = (G[DEBUG_KEY] ||= { logged: {} });
       if (!STATE.logged.init) {
         STATE.logged.init = true;
-        console.groupCollapsed('${PLUGIN_LOG_PREFIX} init loaded (HMR enabled)');
+        console.groupCollapsed('${constants_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.');
@@ -1357,7 +1565,7 @@ function createReactRuntimeVirtualModuleCode() {
       const STATE = (G[DEBUG_KEY] ||= { logged: {} });
       if (!STATE.logged.runtime) {
         STATE.logged.runtime = true;
-        console.groupCollapsed('${PLUGIN_LOG_PREFIX} react-runtime loaded');
+        console.groupCollapsed('${constants_PLUGIN_LOG_PREFIX} react-runtime loaded');
         console.log('Origin:', ORIGIN);
         console.log('React.version:', React?.version);
         console.log('ReactDOMClient keys:', Object.keys(ReactDOMClient || {}));
@@ -1404,7 +1612,7 @@ const devToReactPlugin = (devComponentMap = {}, options = {})=>{
         else processedComponentMap[key] = value;
         return {
             paths: {
-                contract: STABLE_CONTRACT_PATH,
+                contract: constants_STABLE_CONTRACT_PATH,
                 initClient: STABLE_INIT_PATH,
                 reactRuntime: STABLE_REACT_RUNTIME_PATH
             },
@@ -1492,7 +1700,7 @@ const devToReactPlugin = (devComponentMap = {}, options = {})=>{
             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(`⚠️  ${constants_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('');
@@ -1501,6 +1709,8 @@ const devToReactPlugin = (devComponentMap = {}, options = {})=>{
                 contract,
                 stats,
                 audit: resolvedConfig.audit,
+                resolvedConfig,
+                configDir,
                 open: options.open
             }, debugState);
         },
@@ -1531,7 +1741,7 @@ const devToReactPlugin = (devComponentMap = {}, options = {})=>{
             }).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.`);
+                if (0 === actualNames.length && !process.env.DEV_TO_REACT_LIB_SECTION) throw new Error(` ${constants_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,
@@ -1595,7 +1805,7 @@ const devToReactPlugin = (devComponentMap = {}, options = {})=>{
             }
         },
         buildStart () {
-            if (libBuildState.enabled && !libBuildState.virtualEntryCode) throw new Error(`${PLUGIN_LOG_PREFIX} lib 构建模式已启用，但虚拟入口模块代码未生成。\n当前 component: "${libBuildState.currentComponent}"\n这可能是插件配置问题，请检查 vite.config.ts 中的配置。`);
+            if (libBuildState.enabled && !libBuildState.virtualEntryCode) throw new Error(`${constants_PLUGIN_LOG_PREFIX} lib 构建模式已启用，但虚拟入口模块代码未生成。\n当前 component: "${libBuildState.currentComponent}"\n这可能是插件配置问题，请检查 vite.config.ts 中的配置。`);
         },
         async closeBundle () {
             if (!libBuildState.enabled) return;
@@ -1637,7 +1847,7 @@ const devToReactPlugin = (devComponentMap = {}, options = {})=>{
             }
         },
         resolveId (source) {
-            if (source.includes(STABLE_CONTRACT_PATH)) return `\0virtual:${PLUGIN_NAME}-contract`;
+            if (source.includes(constants_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:`)) {
@@ -1655,7 +1865,7 @@ const devToReactPlugin = (devComponentMap = {}, options = {})=>{
                 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({
+                    throw new Error(`${constants_PLUGIN_LOG_PREFIX} 虚拟入口模块 "${id}" (componentName: "${componentName}") 的代码未生成。\n这可能是插件配置问题，请检查 vite.config.ts 中的配置。\n当前 libBuildState: ${JSON.stringify({
                         enabled: libBuildState.enabled,
                         currentComponent: libBuildState.currentComponent,
                         hasCode: !!libBuildState.virtualEntryCode
@@ -1676,11 +1886,11 @@ const devToReactPlugin = (devComponentMap = {}, options = {})=>{
                             libBuildState.currentComponent = componentName;
                             return code;
                         } catch (error) {
-                            throw new Error(`${PLUGIN_LOG_PREFIX} 无法生成虚拟入口模块代码：${error instanceof Error ? error.message : String(error)}`);
+                            throw new Error(`${constants_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 中的配置。`);
+                throw new Error(`${constants_PLUGIN_LOG_PREFIX} 虚拟入口模块 "${id}" (componentName: "${componentName}") 在插件配置完成之前被请求，且无法延迟生成代码。\n这可能是 Vite/Rollup 的内部时序问题。\n请尝试重新运行构建命令，如果问题持续，请检查 vite.config.ts 中的配置。`);
             }
             return null;
         },
@@ -1720,4 +1930,4 @@ const devToReactPlugin = (devComponentMap = {}, options = {})=>{
     ];
 };
 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 };
+export { EVENT_FULL_RELOAD, EVENT_HMR_UPDATE, PLUGIN_NAME, STABLE_BASE_PATH, STABLE_DEBUG_HTML_PATH, STABLE_DEBUG_JSON_PATH, STABLE_INIT_PATH, STABLE_REACT_RUNTIME_PATH, constants_PLUGIN_LOG_PREFIX as PLUGIN_LOG_PREFIX, constants_STABLE_CONTRACT_PATH as STABLE_CONTRACT_PATH, devToReactPlugin, viteHostReactBridgePlugin };

package/dist/libBuildUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"libBuildUtils.d.ts","sourceRoot":"","sources":["../src/libBuildUtils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAKnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAErF,qBAAqB;AACrB,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,SAAS,WAEzC;AAED,kBAAkB;AAClB,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,UAErD;AAED,uBAAuB;AACvB,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,UAKlD;AAED,qBAAqB;AACrB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,WAE/C;AA8LD,6BAA6B;AAC7B,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;CACtB,GAAG,MAAM,CA+IT;AAED,kCAAkC;AAClC,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QA+B/D;AAED,kBAAkB;AAClB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;CACxB,YA8BA;AAED,iBAAiB;AACjB,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,cAAc,EAAE,0BAA0B,CAAA;IAC1C,OAAO,EAAE,uBAAuB,CAAA;IAChC,UAAU,EAAE,UAAU,CAAA;CACvB,GAAG;IACF,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAuGA"}
+{"version":3,"file":"libBuildUtils.d.ts","sourceRoot":"","sources":["../src/libBuildUtils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAKnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAErF,qBAAqB;AACrB,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,SAAS,WAEzC;AAED,kBAAkB;AAClB,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,UAErD;AAED,uBAAuB;AACvB,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,UAKlD;AAED,qBAAqB;AACrB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,WAE/C;AA8LD,6BAA6B;AAC7B,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;CACtB,GAAG,MAAM,CA+IT;AAED,kCAAkC;AAClC,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QA+B/D;AAED,kBAAkB;AAClB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;CACxB,YA8BA;AAED,iBAAiB;AACjB,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,cAAc,EAAE,0BAA0B,CAAA;IAC1C,OAAO,EAAE,uBAAuB,CAAA;IAChC,UAAU,EAAE,UAAU,CAAA;CACvB,GAAG;IACF,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAuGA"}

package/dist/loaderUmdWrapper.d.ts

@@ -0,0 +1,13 @@
+interface CreateLoaderUmdWrapperOptions {
+    componentName: string;
+    origin: string;
+    contractEndpoint?: string;
+    reactLoaderUrl?: string;
+}
+/**
+ * Generate a lightweight UMD wrapper that uses @dev-to/react-loader to load the component.
+ * This wrapper depends on react-loader UMD build being available.
+ */
+export declare function createLoaderUmdWrapper(options: CreateLoaderUmdWrapperOptions): string;
+export {};
+//# sourceMappingURL=loaderUmdWrapper.d.ts.map

package/dist/loaderUmdWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaderUmdWrapper.d.ts","sourceRoot":"","sources":["../src/loaderUmdWrapper.ts"],"names":[],"mappings":"AAGA,UAAU,6BAA6B;IACrC,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,MAAM,CAwKrF"}

package/dist/virtualModules.d.ts

@@ -2,4 +2,13 @@ import type { BridgeContract } from './types.js';
 export declare function createContractVirtualModuleCode(contract: BridgeContract): string;
 export declare function createInitVirtualModuleCode(): string;
 export declare function createReactRuntimeVirtualModuleCode(): string;
+/**
+ * Generate loader wrapper code for a specific component.
+ * This creates a pre-configured loader script that can be imported directly.
+ */
+export declare function createLoaderWrapperCode(params: {
+    componentName: string;
+    origin: string;
+    contractEndpoint?: string;
+}): string;
 //# sourceMappingURL=virtualModules.d.ts.map

package/dist/virtualModules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtualModules.d.ts","sourceRoot":"","sources":["../src/virtualModules.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,cAAc,UAuBvE;AAED,wBAAgB,2BAA2B,WAqE1C;AAED,wBAAgB,mCAAmC,WAuBlD"}
+{"version":3,"file":"virtualModules.d.ts","sourceRoot":"","sources":["../src/virtualModules.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,cAAc,UAuBvE;AAED,wBAAgB,2BAA2B,WAqE1C;AAED,wBAAgB,mCAAmC,WAuBlD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,UAgDA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev-to/react-plugin",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,7 @@
   "dependencies": {
     "picocolors": "^1.1.0",
     "typescript": "^5.4.5",
-    "@dev-to/react-shared": "0.1.0"
+    "@dev-to/react-shared": "0.1.2"
   },
   "scripts": {
     "build": "rslib build",