@lark-apaas/coding-preset-vite-react 0.1.1-alpha.0 → 0.1.1

package/lib/plugins/error-overlay.js

@@ -0,0 +1,136 @@
+"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.errorOverlayPlugin = errorOverlayPlugin;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const OVERLAY_PATH = '/@error-overlay.js';
+/**
+ * 解析 overlay 客户端脚本路径。
+ *
+ * 包发布后目录结构：
+ *   lib/plugins/error-overlay.js   ← 该文件运行时位置
+ *   src/overlay/*.js               ← 静态资源（package.json files 字段包含）
+ *
+ * 开发时（vitest 直接跑 src）：__dirname 是 src/plugins/，跨同级 → src/overlay。
+ */
+function resolveClientScriptPath() {
+    const candidates = [
+        path.resolve(__dirname, '../../src/overlay/vite-client.js'), // lib/plugins → src/overlay
+        path.resolve(__dirname, '../overlay/vite-client.js'), // src/plugins → src/overlay
+    ];
+    return candidates.find((p) => fs.existsSync(p)) ?? null;
+}
+function processClientScript(clientBasePath) {
+    const scriptPath = resolveClientScriptPath();
+    if (!scriptPath)
+        return '// error-overlay client script not found';
+    let code = fs.readFileSync(scriptPath, 'utf-8');
+    // 客户端脚本里被替换的几个变量（与原 preset 行为对齐）
+    const env = {
+        'process.env.FORCE_FRAMEWORK_DOMAIN_MAIN': JSON.stringify(process.env.FORCE_FRAMEWORK_DOMAIN_MAIN ?? ''),
+        'process.env.CLIENT_BASE_PATH': JSON.stringify(clientBasePath),
+    };
+    for (const [k, v] of Object.entries(env)) {
+        code = code.replace(new RegExp(k.replace(/\./g, '\\.'), 'g'), v);
+    }
+    return code;
+}
+/**
+ * 自定义 HMR error overlay。
+ *
+ * - 关掉 Vite 原生 overlay（`server.hmr.overlay = false`）
+ * - dev middleware 暴露 `/@error-overlay.js`（按 clientBasePath 加前缀）
+ * - HTML head 注入 `<script type="module" src="...">`
+ *
+ * 只在 dev 期生效；build 时整个 `configureServer` / `transformIndexHtml` 分支不触发。
+ */
+function errorOverlayPlugin(options = {}) {
+    const { enabled = true, clientBasePath = '' } = options;
+    const overlayPath = clientBasePath + OVERLAY_PATH;
+    return {
+        name: 'miaoda-error-overlay',
+        enforce: 'pre',
+        // 关掉 Vite 原生 overlay
+        config(config) {
+            if (!enabled)
+                return;
+            return {
+                server: {
+                    ...config.server,
+                    hmr: config.server?.hmr === false
+                        ? false
+                        : {
+                            ...(typeof config.server?.hmr === 'object' ? config.server.hmr : {}),
+                            overlay: false,
+                        },
+                },
+            };
+        },
+        configureServer(server) {
+            if (!enabled)
+                return;
+            server.middlewares.use((req, res, next) => {
+                if (req.url !== overlayPath)
+                    return next();
+                try {
+                    const code = processClientScript(clientBasePath);
+                    res.setHeader('Content-Type', 'application/javascript');
+                    res.setHeader('Cache-Control', 'no-cache');
+                    res.end(code);
+                }
+                catch (e) {
+                    console.error('[miaoda-error-overlay] serve failed:', e);
+                    res.statusCode = 500;
+                    res.end(`// error: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            });
+        },
+        transformIndexHtml(html) {
+            if (!enabled)
+                return html;
+            const tags = [
+                {
+                    tag: 'script',
+                    attrs: { type: 'module', src: overlayPath },
+                    injectTo: 'head',
+                },
+            ];
+            return { html, tags };
+        },
+    };
+}
+exports.default = errorOverlayPlugin;
+//# sourceMappingURL=error-overlay.js.map

package/lib/plugins/error-overlay.js.map

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

package/lib/plugins/fonts-mirror.d.ts

@@ -0,0 +1,14 @@
+import type { Plugin } from 'vite';
+export interface FontsMirrorPluginOptions {
+    /** Mirror 完整基址，默认 `https://miaoda.feishu.cn/fonts` */
+    mirror?: string;
+    /** 关闭（调试时兜底） */
+    disabled?: boolean;
+    /** 命中时打 warning（便于找出源码里的旧引用） */
+    warnOnMatch?: boolean;
+    /** 排除 id 子串或正则 */
+    exclude?: (string | RegExp)[];
+}
+export declare function fontsMirrorPlugin(options?: FontsMirrorPluginOptions): Plugin | false;
+export default fontsMirrorPlugin;
+//# sourceMappingURL=fonts-mirror.d.ts.map

package/lib/plugins/fonts-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts-mirror.d.ts","sourceRoot":"","sources":["../../src/plugins/fonts-mirror.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAgBnC,MAAM,WAAW,wBAAwB;IACvC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB;IAClB,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC/B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,MAAM,GAAG,KAAK,CAwDxF;AAED,eAAe,iBAAiB,CAAC"}

package/lib/plugins/fonts-mirror.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fontsMirrorPlugin = fontsMirrorPlugin;
+/**
+ * 编译时把 `fonts.googleapis.com` / `fonts.gstatic.com` 全量改写到妙搭字体代理，
+ * 屏蔽 Google Fonts 在内网 / 部分客户端不可达导致的白屏。
+ *
+ * - 命中文件类型：html / css / scss / less / styl / js / ts / tsx / vue / svelte 等
+ * - URL pathname 保持与 Google Fonts 一致（`/css`、`/css2?family=...&wght=...`），
+ *   任意模型输出形式都能被代理；只换域名
+ * - 关闭：`{ disabled: true }` 或环境变量 `MIAODA_FONTS_MIRROR_OFF=1`
+ */
+const DEFAULT_MIRROR = 'https://miaoda.feishu.cn/fonts';
+const GOOGLE_FONTS_RE = /https?:\/\/fonts\.(googleapis|gstatic)\.com/g;
+const HAS_GOOGLE_FONTS = /fonts\.(googleapis|gstatic)\.com/;
+const TRANSFORM_EXT = /\.(html|css|scss|sass|less|styl|js|jsx|ts|tsx|mjs|cjs|vue|svelte)(\?|$)/;
+function fontsMirrorPlugin(options = {}) {
+    const envDisabled = process.env.MIAODA_FONTS_MIRROR_OFF === '1';
+    if (options.disabled || envDisabled)
+        return false;
+    const mirror = options.mirror ?? DEFAULT_MIRROR;
+    const warn = options.warnOnMatch ?? false;
+    const exclude = options.exclude ?? [];
+    const shouldExclude = (id) => exclude.some((p) => (typeof p === 'string' ? id.includes(p) : p.test(id)));
+    const stats = { files: 0, occurrences: 0 };
+    return {
+        name: 'miaoda-fonts-mirror',
+        enforce: 'pre',
+        buildStart() {
+            stats.files = 0;
+            stats.occurrences = 0;
+        },
+        transformIndexHtml(html) {
+            if (!HAS_GOOGLE_FONTS.test(html))
+                return html;
+            const matches = html.match(GOOGLE_FONTS_RE);
+            const replaced = html.replace(GOOGLE_FONTS_RE, mirror);
+            stats.files += 1;
+            stats.occurrences += matches?.length ?? 0;
+            if (warn) {
+                console.warn(`[miaoda-fonts-mirror] rewrote ${matches?.length ?? 0} occurrence(s) in index.html`);
+            }
+            return replaced;
+        },
+        transform(code, id) {
+            if (!TRANSFORM_EXT.test(id))
+                return null;
+            if (shouldExclude(id))
+                return null;
+            if (!HAS_GOOGLE_FONTS.test(code))
+                return null;
+            const matches = code.match(GOOGLE_FONTS_RE);
+            if (!matches)
+                return null;
+            stats.files += 1;
+            stats.occurrences += matches.length;
+            if (warn) {
+                console.warn(`[miaoda-fonts-mirror] rewrote ${matches.length} occurrence(s) in ${id}`);
+            }
+            return { code: code.replace(GOOGLE_FONTS_RE, mirror), map: null };
+        },
+        closeBundle() {
+            if (stats.files > 0) {
+                console.log(`[miaoda-fonts-mirror] ✓ rewrote ${stats.occurrences} occurrence(s) across ${stats.files} file(s) → ${mirror}`);
+            }
+        },
+    };
+}
+exports.default = fontsMirrorPlugin;
+//# sourceMappingURL=fonts-mirror.js.map

package/lib/plugins/fonts-mirror.js.map

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

package/lib/plugins/health.d.ts

@@ -0,0 +1,19 @@
+import type { Plugin } from 'vite';
+/**
+ * 给妙搭沙箱外壳提供统一的 health endpoint。
+ *
+ * 协议（飞书文档 - 妙搭应用 Health Check 接口规范）：
+ *   - HTTP connection refused / timeout → dev server 没起来 → 外壳重启沙箱
+ *   - 200 + { ready: true }             → 应用已就绪
+ *   - 200 + { ready: false }            → 还在启动，按 error 描述判断重试
+ *
+ * 不归本接口管：
+ *   - vite compile error / runtime error / 资源加载失败 → 浏览器侧自己上报
+ */
+export interface HealthMiddlewarePluginOptions {
+    /** Health endpoint 路径，默认 `/dev/health`。 */
+    endpoint?: string;
+}
+export declare function healthMiddlewarePlugin(options?: HealthMiddlewarePluginOptions): Plugin;
+export default healthMiddlewarePlugin;
+//# sourceMappingURL=health.d.ts.map

package/lib/plugins/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/plugins/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,6BAA6B;IAC5C,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,6BAAkC,GAAG,MAAM,CA+B1F;AAED,eAAe,sBAAsB,CAAC"}

package/lib/plugins/health.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.healthMiddlewarePlugin = healthMiddlewarePlugin;
+function healthMiddlewarePlugin(options = {}) {
+    const endpoint = options.endpoint ?? '/dev/health';
+    let viteReady = false;
+    return {
+        name: 'miaoda-health',
+        apply: 'serve',
+        configureServer(server) {
+            const httpServer = server.httpServer;
+            // 三种状态：
+            //   - middleware 模式（无 httpServer）  → 认为已就绪
+            //   - httpServer.listening 已 true     → 已就绪
+            //   - 否则注册一次 listening 回调
+            if (!httpServer || httpServer.listening) {
+                viteReady = true;
+            }
+            else {
+                httpServer.once('listening', () => {
+                    viteReady = true;
+                });
+            }
+            server.middlewares.use(endpoint, (req, res, next) => {
+                if (req.method && req.method !== 'GET')
+                    return next();
+                res.setHeader('Content-Type', 'application/json');
+                res.setHeader('Cache-Control', 'no-store');
+                res.statusCode = 200;
+                res.end(JSON.stringify({ ready: viteReady }));
+            });
+        },
+    };
+}
+exports.default = healthMiddlewarePlugin;
+//# sourceMappingURL=health.js.map

package/lib/plugins/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/plugins/health.ts"],"names":[],"mappings":";;AAkBA,wDA+BC;AA/BD,SAAgB,sBAAsB,CAAC,UAAyC,EAAE;IAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC;IACnD,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,OAAO;QAEd,eAAe,CAAC,MAAqB;YACnC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YACrC,QAAQ;YACR,2CAA2C;YAC3C,4CAA4C;YAC5C,0BAA0B;YAC1B,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;gBACxC,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;oBAChC,SAAS,GAAG,IAAI,CAAC;gBACnB,CAAC,CAAC,CAAC;YACL,CAAC;YAED,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;gBAClD,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK;oBAAE,OAAO,IAAI,EAAE,CAAC;gBACtD,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;gBAClD,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;gBAC3C,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;gBACrB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kBAAe,sBAAsB,CAAC"}

package/lib/plugins/hmr-timing.d.ts

@@ -0,0 +1,13 @@
+import type { Plugin } from 'vite';
+/**
+ * HMR 计时插件（Vite 8+）。
+ *
+ * 监听文件变更记录起始时间，在 `hotUpdate` 钩子里算出耗时 + 文件数 + 累计大小，
+ * 通过 `server.hot.send({ type: 'custom', event: 'hmr-timing' })` 广播给浏览器；
+ * 浏览器侧由 inspector / dev panel 收消息展示。
+ *
+ * dev 期专用；build 完全不挂 hook。
+ */
+export declare function hmrTimingPlugin(): Plugin;
+export default hmrTimingPlugin;
+//# sourceMappingURL=hmr-timing.d.ts.map

package/lib/plugins/hmr-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr-timing.d.ts","sourceRoot":"","sources":["../../src/plugins/hmr-timing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAmC,MAAM,MAAM,CAAC;AAIpE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,MAAM,CA+CxC;AAED,eAAe,eAAe,CAAC"}

package/lib/plugins/hmr-timing.js

@@ -0,0 +1,93 @@
+"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.hmrTimingPlugin = hmrTimingPlugin;
+const fs = __importStar(require("node:fs"));
+const VALID_EXTENSIONS = ['.js', '.jsx', '.ts', '.tsx', '.css', '.json', '.html'];
+/**
+ * HMR 计时插件（Vite 8+）。
+ *
+ * 监听文件变更记录起始时间，在 `hotUpdate` 钩子里算出耗时 + 文件数 + 累计大小，
+ * 通过 `server.hot.send({ type: 'custom', event: 'hmr-timing' })` 广播给浏览器；
+ * 浏览器侧由 inspector / dev panel 收消息展示。
+ *
+ * dev 期专用；build 完全不挂 hook。
+ */
+function hmrTimingPlugin() {
+    let startTime = 0;
+    const changedFiles = new Set();
+    let server = null;
+    return {
+        name: 'miaoda-hmr-timing',
+        configureServer(devServer) {
+            server = devServer;
+            server.watcher.on('change', (file) => {
+                startTime = Date.now();
+                changedFiles.add(file);
+            });
+        },
+        hotUpdate(_ctx) {
+            if (!server || changedFiles.size === 0)
+                return;
+            const duration = Date.now() - startTime;
+            const cwd = process.cwd();
+            const validFiles = [...changedFiles]
+                .map((f) => f.replace(cwd, '').replace(/\\/g, '/'))
+                .filter((p) => {
+                if (!p)
+                    return false;
+                if (p.includes('/node_modules/'))
+                    return false;
+                return VALID_EXTENSIONS.some((ext) => p.toLowerCase().endsWith(ext));
+            });
+            const totalSize = validFiles.reduce((sum, p) => {
+                try {
+                    return sum + fs.statSync(cwd + p).size;
+                }
+                catch {
+                    return sum;
+                }
+            }, 0);
+            server.hot.send({
+                type: 'custom',
+                event: 'hmr-timing',
+                data: { duration, fileCount: validFiles.length, fileTotalSize: totalSize },
+            });
+            changedFiles.clear();
+        },
+    };
+}
+exports.default = hmrTimingPlugin;
+//# sourceMappingURL=hmr-timing.js.map

package/lib/plugins/hmr-timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr-timing.js","sourceRoot":"","sources":["../../src/plugins/hmr-timing.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,0CA+CC;AA7DD,4CAA8B;AAG9B,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAElF;;;;;;;;GAQG;AACH,SAAgB,eAAe;IAC7B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,IAAI,MAAM,GAAyB,IAAI,CAAC;IAExC,OAAO;QACL,IAAI,EAAE,mBAAmB;QAEzB,eAAe,CAAC,SAAwB;YACtC,MAAM,GAAG,SAAS,CAAC;YACnB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;gBACnC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,SAAS,CAAC,IAAsB;YAC9B,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC;gBAAE,OAAO;YAE/C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAE1B,MAAM,UAAU,GAAG,CAAC,GAAG,YAAY,CAAC;iBACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;iBAClD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBACZ,IAAI,CAAC,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACrB,IAAI,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAC/C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YACvE,CAAC,CAAC,CAAC;YAEL,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBAC7C,IAAI,CAAC;oBACH,OAAO,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBACzC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,GAAG,CAAC;gBACb,CAAC;YACH,CAAC,EAAE,CAAC,CAAC,CAAC;YAEN,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,YAAY;gBACnB,IAAI,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE;aAC3E,CAAC,CAAC;YAEH,YAAY,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kBAAe,eAAe,CAAC"}

package/lib/plugins/html-minify.d.ts

@@ -0,0 +1,18 @@
+import type { Plugin } from 'vite';
+/**
+ * 压缩 HTML，同时保护 HBS（Handlebars）占位符。
+ *
+ * `{{csrfToken}}` / `{{{appAvatar}}}` 这类占位符是部署运行时（vefaas）替换的，
+ * 直接交给 html-minifier-terser 会被解析破坏。先把它们抽出来用 `__HBS_<i>__`
+ * 占位，压缩完再放回去。
+ */
+export declare function minifyHtmlWithHbsProtection(html: string): Promise<string>;
+/**
+ * 仅 build 期生效的 HTML 压缩插件。
+ *
+ * dev 期完全 no-op（不挂 hook、不读盘）；
+ * build 完毕时（closeBundle）读 `outDir/index.html` 压缩后写回。
+ */
+export declare function htmlMinifyPlugin(): Plugin;
+export default htmlMinifyPlugin;
+//# sourceMappingURL=html-minify.d.ts.map

package/lib/plugins/html-minify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-minify.d.ts","sourceRoot":"","sources":["../../src/plugins/html-minify.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,MAAM,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB/E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CA4BzC;AAED,eAAe,gBAAgB,CAAC"}

package/lib/plugins/html-minify.js

@@ -0,0 +1,100 @@
+"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.minifyHtmlWithHbsProtection = minifyHtmlWithHbsProtection;
+exports.htmlMinifyPlugin = htmlMinifyPlugin;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const html_minifier_terser_1 = require("html-minifier-terser");
+/**
+ * 压缩 HTML，同时保护 HBS（Handlebars）占位符。
+ *
+ * `{{csrfToken}}` / `{{{appAvatar}}}` 这类占位符是部署运行时（vefaas）替换的，
+ * 直接交给 html-minifier-terser 会被解析破坏。先把它们抽出来用 `__HBS_<i>__`
+ * 占位，压缩完再放回去。
+ */
+async function minifyHtmlWithHbsProtection(html) {
+    const placeholders = [];
+    let processed = html.replace(/\{\{\{?.+?\}\}\}?/g, (match) => {
+        const i = placeholders.length;
+        placeholders.push(match);
+        return `__HBS_${i}__`;
+    });
+    processed = await (0, html_minifier_terser_1.minify)(processed, {
+        collapseWhitespace: true,
+        removeComments: true,
+        removeRedundantAttributes: true,
+        removeEmptyAttributes: true,
+        minifyCSS: true,
+        // 不压 JS：inline script 里可能引用了 HBS 占位符
+        minifyJS: false,
+    });
+    return processed.replace(/__HBS_(\d+)__/g, (_, i) => placeholders[Number(i)]);
+}
+/**
+ * 仅 build 期生效的 HTML 压缩插件。
+ *
+ * dev 期完全 no-op（不挂 hook、不读盘）；
+ * build 完毕时（closeBundle）读 `outDir/index.html` 压缩后写回。
+ */
+function htmlMinifyPlugin() {
+    let config;
+    let isDev = false;
+    return {
+        name: 'miaoda-html-minify',
+        configResolved(resolvedConfig) {
+            config = resolvedConfig;
+            isDev = resolvedConfig.command === 'serve';
+        },
+        async closeBundle() {
+            if (isDev || !config)
+                return;
+            const htmlPath = path.resolve(config.build.outDir, 'index.html');
+            if (!fs.existsSync(htmlPath))
+                return;
+            try {
+                const source = fs.readFileSync(htmlPath, 'utf-8');
+                const minified = await minifyHtmlWithHbsProtection(source);
+                fs.writeFileSync(htmlPath, minified);
+            }
+            catch (e) {
+                // 单独捕获：minify 失败不应该把整个 build 拖崩，输出文件仍然是 Vite 写出的原版
+                console.warn(`[miaoda-html-minify] minify failed, keeping unminified HTML:`, e);
+            }
+        },
+    };
+}
+exports.default = htmlMinifyPlugin;
+//# sourceMappingURL=html-minify.js.map

package/lib/plugins/html-minify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-minify.js","sourceRoot":"","sources":["../../src/plugins/html-minify.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,kEAmBC;AAQD,4CA4BC;AAnED,4CAA8B;AAC9B,gDAAkC;AAClC,+DAA8C;AAG9C;;;;;;GAMG;AACI,KAAK,UAAU,2BAA2B,CAAC,IAAY;IAC5D,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE;QAC3D,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;QAC9B,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,SAAS,CAAC,IAAI,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,SAAS,GAAG,MAAM,IAAA,6BAAM,EAAC,SAAS,EAAE;QAClC,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,IAAI;QACpB,yBAAyB,EAAE,IAAI;QAC/B,qBAAqB,EAAE,IAAI;QAC3B,SAAS,EAAE,IAAI;QACf,qCAAqC;QACrC,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB;IAC9B,IAAI,MAAsB,CAAC;IAC3B,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,OAAO;QACL,IAAI,EAAE,oBAAoB;QAE1B,cAAc,CAAC,cAAc;YAC3B,MAAM,GAAG,cAAc,CAAC;YACxB,KAAK,GAAG,cAAc,CAAC,OAAO,KAAK,OAAO,CAAC;QAC7C,CAAC;QAED,KAAK,CAAC,WAAW;YACf,IAAI,KAAK,IAAI,CAAC,MAAM;gBAAE,OAAO;YAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YACjE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO;YAErC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAClD,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,MAAM,CAAC,CAAC;gBAC3D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,mDAAmD;gBACnD,OAAO,CAAC,IAAI,CAAC,8DAA8D,EAAE,CAAC,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kBAAe,gBAAgB,CAAC"}

package/lib/plugins/module-alias.d.ts

@@ -0,0 +1,12 @@
+import type { Plugin } from 'vite';
+/**
+ * 把业务工程里 `import 'clsx'` / `import 'echarts'` / `import 'echarts-for-react'`
+ * 这种裸 import 强制指向 preset 自带的 ESM wrapper（`src/module-alias/*.mjs`）。
+ *
+ * 解决的问题：第三方扩展（如 `echarts-wordcloud`）自带独立 echarts 副本时,
+ * 业务代码和扩展跑在两份 echarts 实例上，wordcloud 注册不到主实例 → 渲染丢失。
+ * Wrapper 强制所有 echarts 指针指向 preset 自带版本，全栈共用一份实例。
+ */
+export declare function moduleAliasPlugin(): Plugin;
+export default moduleAliasPlugin;
+//# sourceMappingURL=module-alias.d.ts.map

package/lib/plugins/module-alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-alias.d.ts","sourceRoot":"","sources":["../../src/plugins/module-alias.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA8B1C;AAED,eAAe,iBAAiB,CAAC"}

package/lib/plugins/module-alias.js

@@ -0,0 +1,78 @@
+"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.moduleAliasPlugin = moduleAliasPlugin;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * 把业务工程里 `import 'clsx'` / `import 'echarts'` / `import 'echarts-for-react'`
+ * 这种裸 import 强制指向 preset 自带的 ESM wrapper（`src/module-alias/*.mjs`）。
+ *
+ * 解决的问题：第三方扩展（如 `echarts-wordcloud`）自带独立 echarts 副本时,
+ * 业务代码和扩展跑在两份 echarts 实例上，wordcloud 注册不到主实例 → 渲染丢失。
+ * Wrapper 强制所有 echarts 指针指向 preset 自带版本，全栈共用一份实例。
+ */
+function moduleAliasPlugin() {
+    // 兼容两种运行时布局：
+    //   - 编译后：__dirname = lib/plugins/，wrapper 在 ../../src/module-alias/
+    //   - src 直跑（vitest）：__dirname = src/plugins/，wrapper 在 ../module-alias/
+    const candidates = [
+        path.resolve(__dirname, '../../src/module-alias'),
+        path.resolve(__dirname, '../module-alias'),
+    ];
+    function resolveAlias(name) {
+        for (const dir of candidates) {
+            const p = path.join(dir, `${name}.mjs`);
+            if (fs.existsSync(p))
+                return p;
+        }
+        return null;
+    }
+    return {
+        name: 'miaoda-module-alias',
+        enforce: 'pre',
+        resolveId: {
+            filter: { id: /^(clsx|echarts|echarts-for-react)$/ },
+            handler(source, importer) {
+                // 别把 wrapper 自己内部的 import 又拐回 wrapper（死循环）
+                if (importer && importer.includes('module-alias'))
+                    return null;
+                return resolveAlias(source);
+            },
+        },
+    };
+}
+exports.default = moduleAliasPlugin;
+//# sourceMappingURL=module-alias.js.map

package/lib/plugins/module-alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-alias.js","sourceRoot":"","sources":["../../src/plugins/module-alias.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,8CA8BC;AA1CD,4CAA8B;AAC9B,gDAAkC;AAGlC;;;;;;;GAOG;AACH,SAAgB,iBAAiB;IAC/B,aAAa;IACb,qEAAqE;IACrE,yEAAyE;IACzE,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,wBAAwB,CAAC;QACjD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC;KAC3C,CAAC;IAEF,SAAS,YAAY,CAAC,IAAY;QAChC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;YACxC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,KAAK;QAEd,SAAS,EAAE;YACT,MAAM,EAAE,EAAE,EAAE,EAAE,oCAAoC,EAAE;YACpD,OAAO,CAAC,MAAc,EAAE,QAA4B;gBAClD,2CAA2C;gBAC3C,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAC/D,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,kBAAe,iBAAiB,CAAC"}