@lark-apaas/coding-preset-vite-react 1.0.23 → 1.0.24-alpha.20260916155508

package/lib/plugins/mcp-ui-boundary.d.ts

@@ -0,0 +1,29 @@
+import type { Plugin } from 'vite';
+/** 构建约束，不替代宿主 iframe 的权限和运行时隔离。 */
+export declare function createMcpUiDependencyCheck(rootDir: string, uiDir: string): (id: string) => void;
+export declare function mcpUiBoundary(rootDir: string, entryDir: string): {
+    plugin: Plugin<any>;
+    postcss: {
+        postcssPlugin: string;
+        Once(root: {
+            walkDecls(callback: (decl: {
+                value: string;
+                source?: {
+                    input: {
+                        file?: string;
+                    };
+                };
+            }) => void): void;
+        }): void;
+        OnceExit(_root: unknown, { result, }: {
+            result: {
+                messages: Array<{
+                    type: string;
+                    file?: unknown;
+                }>;
+            };
+        }): void;
+    };
+    check: (id: string) => void;
+};
+//# sourceMappingURL=mcp-ui-boundary.d.ts.map

package/lib/plugins/mcp-ui-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-ui-boundary.d.ts","sourceRoot":"","sources":["../../src/plugins/mcp-ui-boundary.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,mCAAmC;AACnC,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAmCtB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;;;mBAmJhD;YACT,SAAS,CACP,QAAQ,EAAE,CAAC,IAAI,EAAE;gBACf,KAAK,EAAE,MAAM,CAAC;gBACd,MAAM,CAAC,EAAE;oBAAE,KAAK,EAAE;wBAAE,IAAI,CAAC,EAAE,MAAM,CAAA;qBAAE,CAAA;iBAAE,CAAC;aACvC,KAAK,IAAI,GACT,IAAI,CAAC;SACT;wBAOQ,OAAO,eAGX;YAAE,MAAM,EAAE;gBAAE,QAAQ,EAAE,KAAK,CAAC;oBAAE,IAAI,EAAE,MAAM,CAAC;oBAAC,IAAI,CAAC,EAAE,OAAO,CAAA;iBAAE,CAAC,CAAA;aAAE,CAAA;SAAE;;gBAzMlE,MAAM,KAAK,IAAI;EAiNtB"}

package/lib/plugins/mcp-ui-boundary.js

@@ -0,0 +1,232 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpUiDependencyCheck = createMcpUiDependencyCheck;
+exports.mcpUiBoundary = mcpUiBoundary;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_module_1 = require("node:module");
+const parse5_1 = require("parse5");
+const parser_1 = require("@babel/parser");
+const traverse_1 = __importDefault(require("@babel/traverse"));
+const postcss_value_parser_1 = __importDefault(require("postcss-value-parser"));
+/** 构建约束，不替代宿主 iframe 的权限和运行时隔离。 */
+function createMcpUiDependencyCheck(rootDir, uiDir) {
+    const canonical = (file) => fs.existsSync(file) ? fs.realpathSync(file) : path.resolve(file);
+    const roots = [canonical(uiDir), canonical(path.join(rootDir, 'shared'))];
+    const builtins = new Set(node_module_1.builtinModules.flatMap(name => [name, `node:${name}`]));
+    return id => {
+        if (builtins.has(id) ||
+            id.startsWith('node:') ||
+            id.includes('__vite-browser-external')) {
+            throw new Error(`MCP UI 不能引用 Node.js 模块：${id}`);
+        }
+        const file = id.split(/[?#]/, 1)[0];
+        if (!path.isAbsolute(file))
+            return; // 构建器虚拟模块
+        const resolved = canonical(file);
+        if (resolved.split(path.sep).includes('node_modules'))
+            return;
+        if (roots.some(root => {
+            const relative = path.relative(root, resolved);
+            return (relative === '' ||
+                (relative !== '..' &&
+                    !relative.startsWith(`..${path.sep}`) &&
+                    !path.isAbsolute(relative)));
+        }))
+            return;
+        throw new Error(`MCP UI 不能引用应用或服务端代码：${path.relative(rootDir, resolved)}；请使用 server/mcp/ui 或 shared 中的独立浏览器代码。`);
+    };
+}
+function mcpUiBoundary(rootDir, entryDir) {
+    const check = createMcpUiDependencyCheck(rootDir, path.dirname(entryDir));
+    const checkUrl = (url, importer) => {
+        if (/^(?:[a-z][a-z\d+.-]*:|\/\/|#)/i.test(url))
+            return;
+        const file = decodeURIComponent(url.split(/[?#]/, 1)[0]);
+        if (!file)
+            return;
+        check(file.startsWith('@shared/')
+            ? path.resolve(rootDir, 'shared', file.slice(8))
+            : file.startsWith('/')
+                ? path.join(entryDir, file)
+                : path.resolve(path.dirname(importer), file));
+    };
+    const checkCss = (value, importer) => {
+        (0, postcss_value_parser_1.default)(value).walk(node => {
+            if (node.type !== 'function')
+                return;
+            if (['image-set', '-webkit-image-set'].includes(node.value.toLowerCase())) {
+                for (const child of node.nodes)
+                    if (child.type === 'string')
+                        checkUrl(child.value, importer);
+            }
+            if (node.value.toLowerCase() !== 'url')
+                return;
+            const raw = node.nodes.length === 1 && node.nodes[0].type === 'string'
+                ? node.nodes[0].value
+                : postcss_value_parser_1.default.stringify(node.nodes);
+            const url = raw.replace(/\\([\da-f]{1,6})\s?|\\([^\r\n])/gi, (_match, hex, char) => hex ? String.fromCodePoint(parseInt(hex, 16) || 0xfffd) : char);
+            checkUrl(url, importer);
+        });
+    };
+    const plugin = {
+        name: 'miaoda:mcp-ui-boundary',
+        enforce: 'pre',
+        async resolveId(source, importer, options) {
+            const resolved = await this.resolve(source, importer, {
+                ...options,
+                skipSelf: true,
+            });
+            if (resolved)
+                check(resolved.id); // 先应用 browser 映射，不误杀合法浏览器替代实现
+            return resolved;
+        },
+        load(id) {
+            check(id);
+            return null;
+        },
+        transformIndexHtml: {
+            order: 'pre',
+            handler(html, context) {
+                const visit = (node) => {
+                    if ('attrs' in node)
+                        for (const attr of node.attrs ?? []) {
+                            const isResource = (attr.name === 'src' &&
+                                [
+                                    'img',
+                                    'script',
+                                    'iframe',
+                                    'audio',
+                                    'video',
+                                    'source',
+                                    'track',
+                                    'embed',
+                                    'input',
+                                ].includes(node.nodeName)) ||
+                                (attr.name === 'href' &&
+                                    ['link', 'use', 'image'].includes(node.nodeName)) ||
+                                (attr.name === 'poster' && node.nodeName === 'video') ||
+                                (attr.name === 'data' && node.nodeName === 'object');
+                            if (isResource)
+                                checkUrl(attr.value, context.filename);
+                            if (attr.name === 'style')
+                                checkCss(attr.value, context.filename);
+                            if (attr.name === 'srcset' &&
+                                ['img', 'source'].includes(node.nodeName)) {
+                                // URL token 可包含 data URI 的逗号；描述符的逗号才分隔下一项。
+                                let rest = attr.value;
+                                while (rest) {
+                                    rest = rest.replace(/^[\s,]+/, '');
+                                    const match = /^([^\s]+)/.exec(rest);
+                                    if (!match)
+                                        break;
+                                    const url = match[1];
+                                    checkUrl(url.replace(/,+$/, ''), context.filename);
+                                    rest = rest.slice(url.length);
+                                    if (!url.endsWith(','))
+                                        rest = rest.replace(/^[^,]*(?:,|$)/, '');
+                                }
+                            }
+                        }
+                    if ('childNodes' in node)
+                        for (const child of node.childNodes)
+                            visit(child);
+                    if ('content' in node && node.content)
+                        visit(node.content);
+                    if (node.nodeName === 'style' && 'childNodes' in node) {
+                        for (const child of node.childNodes)
+                            if ('value' in child)
+                                checkCss(child.value, context.filename);
+                    }
+                };
+                visit((0, parse5_1.parse)(html));
+            },
+        },
+        transform(code, id) {
+            if (!/\.[cm]?[jt]sx?(?:\?|$)/.test(id) || !code.includes('import.meta'))
+                return;
+            const ast = (0, parser_1.parse)(code, {
+                sourceType: 'unambiguous',
+                plugins: /\.[cm]?ts(?:\?|$)/.test(id)
+                    ? ['typescript']
+                    : ['typescript', 'jsx'],
+            });
+            (0, traverse_1.default)(ast, {
+                NewExpression({ node }) {
+                    if (node.callee.type !== 'Identifier' || node.callee.name !== 'URL')
+                        return;
+                    const base = node.arguments[1];
+                    if (base?.type !== 'MemberExpression' ||
+                        base.object.type !== 'MetaProperty' ||
+                        base.object.meta.name !== 'import')
+                        return;
+                    const url = node.arguments[0];
+                    if (url?.type === 'StringLiteral')
+                        checkUrl(url.value, id.split('?', 1)[0]);
+                    if (url?.type === 'TemplateLiteral' && url.expressions.length === 0)
+                        checkUrl(url.quasis[0].value.cooked ?? url.quasis[0].value.raw, id.split('?', 1)[0]);
+                },
+            });
+        },
+        generateBundle(_options, bundle) {
+            for (const item of Object.values(bundle)) {
+                if (item.type !== 'asset')
+                    continue;
+                for (const source of item.originalFileNames ?? [])
+                    check(path.resolve(entryDir, source));
+            }
+        },
+    };
+    const postcss = {
+        postcssPlugin: 'miaoda-mcp-ui-css-boundary',
+        Once(root) {
+            root.walkDecls(decl => {
+                if (decl.source?.input.file)
+                    checkCss(decl.value, decl.source.input.file);
+            });
+        },
+        OnceExit(_root, { result, }) {
+            for (const message of result.messages)
+                if (message.type === 'dependency' && typeof message.file === 'string')
+                    check(message.file);
+        },
+    };
+    return { plugin, postcss, check };
+}
+//# sourceMappingURL=mcp-ui-boundary.js.map

package/lib/plugins/mcp-ui-boundary.js.map

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

package/lib/plugins/mcp-ui.d.ts

@@ -0,0 +1,70 @@
+import type { Plugin, PluginOption, InlineConfig } from 'vite';
+/**
+ * MCP Apps 界面源码目录（相对工程根）。每个子目录一个界面入口：
+ *   server/mcp/ui/<entry>/index.html
+ * 与 tools、skills 按 MCP 能力归集，但仍是独立浏览器代码。
+ * 用户工程的服务端 tsconfig 必须排除 server/mcp/ui，并用独立 UI tsconfig 检查。
+ * 构建后输出为单文件 HTML：
+ *   dist/mcp-ui/<entry>.html
+ * 服务端通过 `readMcpUiTemplate('<entry>')`（@lark-apaas/nestjs-mcp）读取并作为 `ui://` 资源下发。
+ */
+export declare const MCP_UI_SOURCE_DIR = "server/mcp/ui";
+export declare const MCP_UI_OUT_DIR = "dist/mcp-ui";
+export interface McpUiPluginOptions {
+    rootDir: string;
+    isDev: boolean;
+    /** 覆盖源码目录（相对 rootDir），默认 server/mcp/ui */
+    sourceDir?: string;
+    /** 覆盖输出目录（相对 rootDir），默认 dist/mcp-ui */
+    outDir?: string;
+    /** 注入给每个界面构建的额外插件（通常是 react()） */
+    plugins?: () => PluginOption[];
+    /** 仅供测试：替换 vite.build */
+    _build?: (config: InlineConfig) => Promise<unknown>;
+    log?: (message: string) => void;
+}
+export interface McpUiEntry {
+    /** 目录名，即入口名 */
+    name: string;
+    /** 目录绝对路径 */
+    dir: string;
+    /** index.html 绝对路径 */
+    html: string;
+}
+/**
+ * 列出所有界面入口：sourceDir 下每个含 index.html 的子目录。
+ */
+export declare function listMcpUiEntries(rootDir: string, sourceDir?: string): McpUiEntry[];
+/**
+ * 把 rollup 产出的 HTML 中引用的 JS / CSS 内联进 HTML，并删除独立文件，使产物成为单文件。
+ * MCP Apps 宿主以 iframe + srcdoc 方式渲染资源，不能再发起相对路径请求，因此必须内联。
+ */
+export declare function inlineHtmlAssets(html: string, assets: Record<string, string>): {
+    html: string;
+    consumed: string[];
+};
+/**
+ * 内联插件：在 generateBundle 阶段把 chunk / css 塞进 HTML。
+ */
+export declare function singleFilePlugin(): Plugin;
+export interface BuildMcpUiEntryOptions {
+    rootDir: string;
+    outDir: string;
+    isDev: boolean;
+    plugins: PluginOption[];
+    build: (config: InlineConfig) => Promise<unknown>;
+}
+/**
+ * 构建单个界面入口为 `<outDir>/<entry>.html`。
+ */
+export declare function buildMcpUiEntry(entry: McpUiEntry, options: BuildMcpUiEntryOptions): Promise<string>;
+/**
+ * 生成 MCP Apps 单文件界面的 Vite 插件。
+ *
+ * - 生产构建：主构建结束后（closeBundle）依次构建每个入口。
+ * - 开发模式：dev server 启动时构建一次，并监听 `server/mcp/ui/**` 变更增量重建，
+ *   服务端 `readMcpUiTemplate` 在开发态不缓存，刷新即生效。
+ * - 没有 UI 时跳过界面构建；生产仍同步固定的应用 Skill 文件。
+ */
+export declare function mcpUiPlugin(options: McpUiPluginOptions): Plugin;
+//# sourceMappingURL=mcp-ui.d.ts.map

package/lib/plugins/mcp-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-ui.d.ts","sourceRoot":"","sources":["../../src/plugins/mcp-ui.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAE/D;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AACjD,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,YAAY,EAAE,CAAC;IAC/B,yBAAyB;IACzB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAA0B,GAAG,UAAU,EAAE,CASrG;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAgCtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAkBzC;AAYD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDzG;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA8E/D"}

package/lib/plugins/mcp-ui.js

@@ -0,0 +1,292 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_UI_OUT_DIR = exports.MCP_UI_SOURCE_DIR = void 0;
+exports.listMcpUiEntries = listMcpUiEntries;
+exports.inlineHtmlAssets = inlineHtmlAssets;
+exports.singleFilePlugin = singleFilePlugin;
+exports.buildMcpUiEntry = buildMcpUiEntry;
+exports.mcpUiPlugin = mcpUiPlugin;
+const mcp_skill_1 = require("./mcp-skill");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const mcp_ui_boundary_1 = require("./mcp-ui-boundary");
+/**
+ * MCP Apps 界面源码目录（相对工程根）。每个子目录一个界面入口：
+ *   server/mcp/ui/<entry>/index.html
+ * 与 tools、skills 按 MCP 能力归集，但仍是独立浏览器代码。
+ * 用户工程的服务端 tsconfig 必须排除 server/mcp/ui，并用独立 UI tsconfig 检查。
+ * 构建后输出为单文件 HTML：
+ *   dist/mcp-ui/<entry>.html
+ * 服务端通过 `readMcpUiTemplate('<entry>')`（@lark-apaas/nestjs-mcp）读取并作为 `ui://` 资源下发。
+ */
+exports.MCP_UI_SOURCE_DIR = 'server/mcp/ui';
+exports.MCP_UI_OUT_DIR = 'dist/mcp-ui';
+/**
+ * 列出所有界面入口：sourceDir 下每个含 index.html 的子目录。
+ */
+function listMcpUiEntries(rootDir, sourceDir = exports.MCP_UI_SOURCE_DIR) {
+    const base = path.resolve(rootDir, sourceDir);
+    if (!fs.existsSync(base))
+        return [];
+    return fs
+        .readdirSync(base, { withFileTypes: true })
+        .filter((d) => d.isDirectory() && /^[A-Za-z0-9_-]+$/.test(d.name))
+        .map((d) => ({ name: d.name, dir: path.join(base, d.name), html: path.join(base, d.name, 'index.html') }))
+        .filter((e) => fs.existsSync(e.html))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+function escapeInlineScript(code) {
+    // 内联脚本里出现 </script 会提前闭合标签；<!-- 会让浏览器进入 script 转义态，两者都要转义
+    return code.replace(/<\/script/gi, '<\\/script').replace(/<!--/g, '<\\!--');
+}
+/**
+ * 把 rollup 产出的 HTML 中引用的 JS / CSS 内联进 HTML，并删除独立文件，使产物成为单文件。
+ * MCP Apps 宿主以 iframe + srcdoc 方式渲染资源，不能再发起相对路径请求，因此必须内联。
+ */
+function inlineHtmlAssets(html, assets) {
+    const consumed = [];
+    const lookup = (href) => {
+        const cleaned = href.replace(/^\.?\//, '').split(/[?#]/)[0];
+        for (const key of Object.keys(assets)) {
+            if (key === cleaned || key.endsWith(`/${cleaned}`) || cleaned.endsWith(`/${key}`)) {
+                consumed.push(key);
+                return assets[key];
+            }
+        }
+        return undefined;
+    };
+    let out = html.replace(/<script([^>]*?)\ssrc=["']([^"']+)["']([^>]*)><\/script>/gi, (match, before, src, after) => {
+        const code = lookup(src);
+        if (code === undefined)
+            return match;
+        const attrs = `${before}${after}`.replace(/\s*crossorigin(=["'][^"']*["'])?/gi, '');
+        return `<script${attrs}>${escapeInlineScript(code)}</script>`;
+    });
+    out = out.replace(/<link([^>]*?)\srel=["']stylesheet["']([^>]*?)>/gi, (match, before, after) => {
+        const hrefMatch = /href=["']([^"']+)["']/i.exec(`${before} ${after}`);
+        if (!hrefMatch)
+            return match;
+        const css = lookup(hrefMatch[1]);
+        if (css === undefined)
+            return match;
+        return `<style>${css}</style>`;
+    });
+    // modulepreload 在单文件里没有意义，顺手移除
+    out = out.replace(/\s*<link[^>]*rel=["']modulepreload["'][^>]*>/gi, '');
+    return { html: out, consumed: Array.from(new Set(consumed)) };
+}
+/**
+ * 内联插件：在 generateBundle 阶段把 chunk / css 塞进 HTML。
+ */
+function singleFilePlugin() {
+    return {
+        name: 'miaoda:mcp-ui-single-file',
+        enforce: 'post',
+        generateBundle(_options, bundle) {
+            const assets = {};
+            for (const [fileName, item] of Object.entries(bundle)) {
+                if (item.type === 'chunk')
+                    assets[fileName] = item.code;
+                else if (item.type === 'asset' && fileName.endsWith('.css'))
+                    assets[fileName] = String(item.source);
+            }
+            for (const [fileName, item] of Object.entries(bundle)) {
+                if (item.type !== 'asset' || !fileName.endsWith('.html'))
+                    continue;
+                const { html, consumed } = inlineHtmlAssets(String(item.source), assets);
+                item.source = html;
+                for (const key of consumed)
+                    delete bundle[key];
+            }
+        },
+    };
+}
+async function loadViteBuild() {
+    // 本包以 CommonJS 发布，而 Vite 6+ 为纯 ESM；用原生 dynamic import 才能在所有 Node 版本加载。
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval
+    const dynamicImport = new Function('specifier', 'return import(specifier)');
+    const vite = await dynamicImport('vite');
+    return vite.build;
+}
+/**
+ * 构建单个界面入口为 `<outDir>/<entry>.html`。
+ */
+async function buildMcpUiEntry(entry, options) {
+    const outDir = path.resolve(options.rootDir, options.outDir);
+    const tmpDir = path.join(outDir, `.${entry.name}.tmp`);
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+    const boundary = (0, mcp_ui_boundary_1.mcpUiBoundary)(options.rootDir, entry.dir);
+    let assetError;
+    await options.build({
+        configFile: false,
+        envFile: false,
+        root: fs.realpathSync(entry.dir),
+        base: './',
+        mode: options.isDev ? 'development' : 'production',
+        logLevel: 'warn',
+        clearScreen: false,
+        plugins: [boundary.plugin, ...options.plugins, singleFilePlugin()],
+        publicDir: false,
+        css: { postcss: { plugins: [boundary.postcss] } },
+        resolve: {
+            alias: {
+                '@shared': path.resolve(options.rootDir, 'shared'),
+            },
+        },
+        build: {
+            outDir: tmpDir,
+            emptyOutDir: true,
+            sourcemap: false,
+            minify: !options.isDev,
+            cssCodeSplit: false,
+            modulePreload: false,
+            assetsInlineLimit: (file) => {
+                try {
+                    boundary.check(file);
+                }
+                catch (error) {
+                    assetError = error;
+                    throw error;
+                }
+                return true;
+            },
+            // Vite 8 仍兼容此选项，同时保持仓库 Vite 7 类型检查兼容。
+            rollupOptions: { input: fs.realpathSync(entry.html), output: { inlineDynamicImports: true } },
+        },
+    });
+    // Vite 对 new URL 的资源转换会吞掉异常，构建完成后再次确认。
+    if (assetError)
+        throw assetError;
+    const produced = path.join(tmpDir, 'index.html');
+    if (!fs.existsSync(produced)) {
+        throw new Error(`MCP Apps 界面「${entry.name}」构建未产出 index.html`);
+    }
+    fs.mkdirSync(outDir, { recursive: true });
+    const target = path.join(outDir, `${entry.name}.html`);
+    fs.renameSync(produced, target);
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+    return target;
+}
+/**
+ * 生成 MCP Apps 单文件界面的 Vite 插件。
+ *
+ * - 生产构建：主构建结束后（closeBundle）依次构建每个入口。
+ * - 开发模式：dev server 启动时构建一次，并监听 `server/mcp/ui/**` 变更增量重建，
+ *   服务端 `readMcpUiTemplate` 在开发态不缓存，刷新即生效。
+ * - 没有 UI 时跳过界面构建；生产仍同步固定的应用 Skill 文件。
+ */
+function mcpUiPlugin(options) {
+    const { rootDir, isDev, sourceDir = exports.MCP_UI_SOURCE_DIR, outDir = exports.MCP_UI_OUT_DIR, plugins = () => [], log = (m) => console.log(`[mcp-ui] ${m}`), } = options;
+    const sourceRoot = path.resolve(rootDir, sourceDir);
+    let buildFn = options._build;
+    const buildAll = async (entries) => {
+        if (entries.length === 0)
+            return;
+        buildFn ?? (buildFn = await loadViteBuild());
+        for (const entry of entries) {
+            const started = Date.now();
+            const target = await buildMcpUiEntry(entry, { rootDir, outDir, isDev, plugins: plugins(), build: buildFn });
+            log(`已构建 ${path.relative(rootDir, target)}（${Date.now() - started}ms）`);
+        }
+    };
+    return {
+        name: 'miaoda:mcp-ui',
+        async closeBundle() {
+            if (isDev)
+                return;
+            (0, mcp_skill_1.syncMcpSkill)(rootDir);
+            const output = path.resolve(rootDir, outDir);
+            fs.rmSync(output, { recursive: true, force: true });
+            await buildAll(listMcpUiEntries(rootDir, sourceDir));
+            // 两种现存 NRF 发布根：dist 与 dist/server。运行时统一读取 cwd/dist/mcp-ui。
+            for (const relative of ['dist/dist/mcp-ui', 'dist/server/dist/mcp-ui']) {
+                const deployed = path.resolve(rootDir, relative);
+                fs.rmSync(deployed, { recursive: true, force: true });
+                if (fs.existsSync(output))
+                    fs.cpSync(output, deployed, { recursive: true });
+            }
+        },
+        async configureServer(server) {
+            if (!isDev)
+                return;
+            let stopped = false;
+            let timer;
+            const rebuild = async () => {
+                if (stopped)
+                    return;
+                const entries = listMcpUiEntries(rootDir, sourceDir);
+                const output = path.resolve(rootDir, outDir);
+                const names = new Set(entries.map((entry) => `${entry.name}.html`));
+                if (fs.existsSync(output)) {
+                    for (const name of fs.readdirSync(output)) {
+                        if (name.endsWith('.html') && !names.has(name))
+                            fs.rmSync(path.join(output, name));
+                    }
+                }
+                await buildAll(entries);
+            };
+            const report = (error) => log(`构建失败：${error instanceof Error ? error.message : String(error)}`);
+            let ready = rebuild().catch(report);
+            server.watcher.add([sourceRoot, path.resolve(rootDir, 'shared')]);
+            const schedule = (file) => {
+                const relevant = [sourceRoot, path.resolve(rootDir, 'shared')].some((dir) => {
+                    const relative = path.relative(dir, path.resolve(file));
+                    return !relative.startsWith('..') && !path.isAbsolute(relative);
+                });
+                if (!relevant || stopped)
+                    return;
+                if (timer)
+                    clearTimeout(timer);
+                timer = setTimeout(() => {
+                    timer = undefined;
+                    ready = ready.then(rebuild).catch(report);
+                }, 200);
+            };
+            const events = ['change', 'add', 'unlink', 'addDir', 'unlinkDir'];
+            for (const event of events)
+                server.watcher.on(event, schedule);
+            server.httpServer?.once('close', () => {
+                stopped = true;
+                if (timer)
+                    clearTimeout(timer);
+                for (const event of events)
+                    server.watcher.off(event, schedule);
+            });
+            await ready;
+        },
+    };
+}
+//# sourceMappingURL=mcp-ui.js.map