@lark-apaas/coding-preset-vite-react 1.0.12-alpha.1 → 1.0.12

package/lib/plugins/capabilities.js

@@ -46,14 +46,17 @@ const DEFAULT_DIRS = ['shared/capabilities'];
  * `@lark-apaas/client-capability` SDK（被 client-toolkit-lite 内联使用）会
  * `import map from 'virtual:capabilities'` 取这个 map。SDK 在 dev 预览 / 沙箱
  * 加载流程中依赖这个模块存在，所以即使 capabilities 目录为空，也必须把模块
- * 注册成解析成功（空 map），否则 rolldown 在 build 时直接 fail。
+ * 注册成解析成功（空 map），否则 build 时直接 fail。
  *
- * 同时通过 `optimizeDeps.esbuildOptions.plugins` 在 depOptimizer 那条路径上
- * 也提供解析——因为 client-toolkit-lite 是 pre-bundle 进来的，pre-bundle 的
- * esbuild 不会经过 Vite 主 pipeline 的 plugin 链。
+ * 解析挂两处：
+ *  1. Vite 主 pipeline `resolveId` / `load` —— dev 运行时 + production build 都走它。
+ *  2. depOptimizer 里把 `virtual:capabilities` 标记为 external（`optimizeDeps.exclude`），
+ *     让被预打包的 client-toolkit-lite（内联了 client-capability）保留运行时
+ *     `import 'virtual:capabilities'`，交给主 pipeline 动态解析。详见下方 config() 注释。
  *
- * V1 限制：dev 期更改 capability JSON 后，pre-bundle 产物里的 map 是启动时快照，
- * 不会自动刷新；新增 / 修改 capability 后需要重启 dev server。
+ * 这样 dev 期新增 / 修改 capability JSON 后，configureServer 的
+ * invalidateModule + full-reload 能即时刷新（旧实现把 map 内联进预打包快照，
+ * watch 刷不到，需重启 dev server —— 现已修复）。
  */
 function capabilitiesBundlePlugin(options = {}) {
     let rootDir = process.cwd();
@@ -87,31 +90,26 @@ function capabilitiesBundlePlugin(options = {}) {
         configResolved(config) {
             rootDir = config.root;
         },
-        // 同时通过 depOptimizer 的 Rolldown 注入解析，让 client-toolkit-lite 这种
-        // pre-bundle 进来的依赖也能把 `import 'virtual:capabilities'` 解掉。
-        // Vite 8 用 Rolldown 替换了 esbuild 做 depOptimize，所以走 rolldownOptions.plugins。
-        config(_userConfig, _env) {
-            // `rolldownOptions` 是 Vite 8 引入的 depOptimizer 新 API，
-            // 当前 Vite 类型还没覆盖，需要 as any 绕过
+        // depOptimizer 里把 `virtual:capabilities` 标记为 external，让被预打包的依赖
+        // （client-capability，内联进 client-toolkit-lite）保留运行时
+        // `import 'virtual:capabilities'`，由下面主 pipeline 的 resolveId/load 动态解析。
+        //
+        // 为什么不在 depOptimizer 里解析 + 内联（旧实现走 rolldownOptions.plugins）：
+        // 那样 map 会被烤成 optimize 时的快照固化进预打包 chunk。dev 期新增 / 修改
+        // capability JSON 后，configureServer 的 invalidateModule + full-reload 作用在
+        // 主 pipeline 的虚拟模块上，而预打包消费者读的是 chunk 里那份内联快照 —— 两者
+        // 不是同一个模块，watch 永远刷不到（实测：inline 模式 getModuleById(RESOLVED)
+        // 返回 null，invalidate 是 no-op；首屏 optimize 时目录还空 → map 一直空，只有
+        // 重启 / re-optimize 才更新）。external 后虚拟模块进入运行时模块图，
+        // configureServer 的 invalidate + full-reload 才真正命中被读的模块、即时刷新。
+        //
+        // external 也顺带替代了"必须在 optimizer 里解析否则 build/optimize fail"的诉求：
+        // 标记 external 后 optimizer 不再尝试解析它（不会 fail）；build 不经 depOptimizer，
+        // 由主 pipeline 解析内联，产物不受影响。
+        config() {
             return {
                 optimizeDeps: {
-                    rolldownOptions: {
-                        plugins: [
-                            {
-                                name: 'miaoda-capabilities-rolldown',
-                                resolveId(source) {
-                                    if (source === VIRTUAL_ID)
-                                        return RESOLVED;
-                                    return null;
-                                },
-                                load(id) {
-                                    if (id !== RESOLVED)
-                                        return null;
-                                    return `export default ${JSON.stringify(loadMap())};`;
-                                },
-                            },
-                        ],
-                    },
+                    exclude: [VIRTUAL_ID],
                 },
             };
         },

package/lib/plugins/capabilities.js.map

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

package/lib/plugins/dev-proxy.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Dev Server Proxy（vite dev → Nest backend）for nestjs-vite-react fullstack 形态。
+ *
+ * 命名澄清：这是**构建工具层**的 vite `server.proxy` 配置（HTTP 反代），跟 client-toolkit
+ * AppContainer 内置的 `api-proxy` / `childApi`（**运行时**的 postMessage 桥，给妙搭外壳
+ * 接口测试面板用）是不同概念，请勿混淆。
+ *
+ * fullstack 应用 dev 时 Vite（8080）是**用户入口**、Nest（3000）服务后端，二者分进程。
+ * 本 plugin 同时承担两件事：
+ *
+ *  A. `config()` 注入 `server.proxy`：把 `/api`、`/openapi`、`/__innerapi__` 反代到 Nest，
+ *     且模拟沙箱网关的两件事：
+ *       1. 注入 `x-larkgw-suda-webuser` header（身份）—— 本地从 SUDA_WEBUSER env 取
+ *       2. 注入 `x-suda-csrf-token` header（csrf double-submit）—— per-request 从 cookie 抠
+ *     否则 Nest 端 ViewController 拿不到 appId（→ window.appId="" → auth-sdk URL 拼错），
+ *     csrf middleware 也会拦下请求。
+ *
+ *  B. `configureServer()` 挂 HTML 反代 middleware：用户访问 `vite-8080/<path>` 拿页面时，
+ *     vite 默认走自己的 index.html。但 fullstack 形态要 Nest 渲染 HBS（注入 appId / csrf /
+ *     platform-data 等），所以拦截所有 `accept: text/html` 请求转发到 Nest 3000。
+ *     白名单避开 vite dev-only 路径（`/@vite`、`/@fs`、`/__vite`、`/@id`、`/node_modules`、
+ *     `/dev/`、`.hot-update`）和静态资源（.js / .css / 图片 / 字体），这些应该走 vite 自身。
+ *
+ * 实现搬自 fullstack-vite-preset/src/preset.ts 的 server.proxy + HTML proxy 段，逻辑一致。
+ */
+import type { Plugin } from 'vite';
+export interface DevProxyPluginOptions {
+    /** Nest server 监听端口。默认 3000 */
+    serverPort?: number;
+    /** client base path，跟 normalizeBasePath 处理后一致（如 `/app/<id>` 或空串） */
+    clientBasePath?: string;
+    /** 从 clientBasePath 提取的 appId，用于挂老路径兼容 proxy（`/af/p/<appId>/...`） */
+    appId?: string;
+}
+/**
+ * Vite plugin: 注入 dev server proxy 配置（仅 dev，build 时不挂）。
+ * 通过 `config()` hook 返回 `server.proxy` 让 vite mergeConfig 自动合并。
+ */
+export declare function devProxyPlugin(options?: DevProxyPluginOptions): Plugin;
+export default devProxyPlugin;
+//# sourceMappingURL=dev-proxy.d.ts.map

package/lib/plugins/dev-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-proxy.d.ts","sourceRoot":"","sources":["../../src/plugins/dev-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,MAAM,CAAC;AAUjD,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAgL1E;AAED,eAAe,cAAc,CAAC"}

package/lib/plugins/dev-proxy.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * Dev Server Proxy（vite dev → Nest backend）for nestjs-vite-react fullstack 形态。
+ *
+ * 命名澄清：这是**构建工具层**的 vite `server.proxy` 配置（HTTP 反代），跟 client-toolkit
+ * AppContainer 内置的 `api-proxy` / `childApi`（**运行时**的 postMessage 桥，给妙搭外壳
+ * 接口测试面板用）是不同概念，请勿混淆。
+ *
+ * fullstack 应用 dev 时 Vite（8080）是**用户入口**、Nest（3000）服务后端，二者分进程。
+ * 本 plugin 同时承担两件事：
+ *
+ *  A. `config()` 注入 `server.proxy`：把 `/api`、`/openapi`、`/__innerapi__` 反代到 Nest，
+ *     且模拟沙箱网关的两件事：
+ *       1. 注入 `x-larkgw-suda-webuser` header（身份）—— 本地从 SUDA_WEBUSER env 取
+ *       2. 注入 `x-suda-csrf-token` header（csrf double-submit）—— per-request 从 cookie 抠
+ *     否则 Nest 端 ViewController 拿不到 appId（→ window.appId="" → auth-sdk URL 拼错），
+ *     csrf middleware 也会拦下请求。
+ *
+ *  B. `configureServer()` 挂 HTML 反代 middleware：用户访问 `vite-8080/<path>` 拿页面时，
+ *     vite 默认走自己的 index.html。但 fullstack 形态要 Nest 渲染 HBS（注入 appId / csrf /
+ *     platform-data 等），所以拦截所有 `accept: text/html` 请求转发到 Nest 3000。
+ *     白名单避开 vite dev-only 路径（`/@vite`、`/@fs`、`/__vite`、`/@id`、`/node_modules`、
+ *     `/dev/`、`.hot-update`）和静态资源（.js / .css / 图片 / 字体），这些应该走 vite 自身。
+ *
+ * 实现搬自 fullstack-vite-preset/src/preset.ts 的 server.proxy + HTML proxy 段，逻辑一致。
+ */
+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.devProxyPlugin = devProxyPlugin;
+const http = __importStar(require("node:http"));
+const local_dev_1 = require("../utils/local-dev");
+const proxy_error_1 = require("../utils/proxy-error");
+/**
+ * Vite plugin: 注入 dev server proxy 配置（仅 dev，build 时不挂）。
+ * 通过 `config()` hook 返回 `server.proxy` 让 vite mergeConfig 自动合并。
+ */
+function devProxyPlugin(options = {}) {
+    const serverPort = options.serverPort ?? 3000;
+    const clientBasePath = options.clientBasePath ?? '';
+    const appId = options.appId;
+    return {
+        name: 'nestjs-vite-react-dev-proxy',
+        apply: 'serve',
+        config() {
+            const localDev = (0, local_dev_1.isLocalDev)();
+            const sandboxBase = (0, local_dev_1.resolveSandboxOrigin)();
+            const { cookie: outboundCookie, csrfToken: outboundCsrfToken } = (0, local_dev_1.composeSandboxOutboundAuth)();
+            // 解析 SUDA_WEBUSER（沙箱注入到 .env.local，dotenv@17 转义边界容错）
+            let localDevWebUserHeader = '';
+            const parsedSudaWebUser = (0, local_dev_1.parseSudaWebUserEnv)(process.env.SUDA_WEBUSER);
+            if (parsedSudaWebUser) {
+                try {
+                    localDevWebUserHeader = encodeURIComponent(JSON.stringify(parsedSudaWebUser));
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            const proxy = {};
+            // 本地反代沙箱的平台 runtime API（条件性）
+            if (localDev && sandboxBase) {
+                proxy[`${clientBasePath}/__runtime__`] = {
+                    target: sandboxBase,
+                    changeOrigin: true,
+                    headers: {
+                        ...(outboundCookie ? { cookie: outboundCookie } : {}),
+                        ...(outboundCsrfToken ? { 'x-suda-csrf-token': outboundCsrfToken } : {}),
+                    },
+                };
+            }
+            // API proxy。本地 dev 没有 larkgw 经过这条 incoming 链路，server 端 NestJS 缺：
+            //   1. x-larkgw-suda-webuser header(身份) → ViewController 拿不到 appId
+            //   2. x-suda-csrf-token header(csrf double-submit) → csrf middleware 403
+            // 在 dev server 这层模拟 larkgw 注入这两样
+            proxy[`${clientBasePath}/api`] = {
+                target: `http://localhost:${serverPort}`,
+                changeOrigin: true,
+                ...(localDev && localDevWebUserHeader
+                    ? { headers: { 'x-larkgw-suda-webuser': localDevWebUserHeader } }
+                    : {}),
+                configure: (proxyServer) => {
+                    proxyServer.on('error', (err, req, res) => {
+                        (0, proxy_error_1.handleDevProxyError)(err, req, res, {
+                            target: `http://localhost:${serverPort}`,
+                        });
+                    });
+                    if (localDev) {
+                        proxyServer.on('proxyReq', (proxyReq, req) => {
+                            if (proxyReq.getHeader('x-suda-csrf-token'))
+                                return;
+                            const cookie = req.headers.cookie;
+                            if (!cookie)
+                                return;
+                            const m = /(?:^|;\s*)suda-csrf-token=([^;]+)/.exec(cookie);
+                            if (m)
+                                proxyReq.setHeader('x-suda-csrf-token', m[1]);
+                        });
+                    }
+                },
+            };
+            // OpenAPI proxy
+            proxy[`${clientBasePath}/openapi`] = {
+                target: `http://localhost:${serverPort}`,
+                changeOrigin: true,
+                configure: (proxyServer) => {
+                    proxyServer.on('error', (err, req, res) => {
+                        (0, proxy_error_1.handleDevProxyError)(err, req, res, {
+                            target: `http://localhost:${serverPort}`,
+                        });
+                    });
+                },
+            };
+            // Inner API proxy
+            proxy[`${clientBasePath}/__innerapi__`] = {
+                target: `http://localhost:${serverPort}`,
+                changeOrigin: true,
+                configure: (proxyServer) => {
+                    proxyServer.on('error', (err, req, res) => {
+                        (0, proxy_error_1.handleDevProxyError)(err, req, res, {
+                            target: `http://localhost:${serverPort}`,
+                        });
+                    });
+                },
+            };
+            // 旧路径（/af/p/:appId）兼容代理（仅在 appId 已知时挂）
+            if (appId) {
+                proxy[`/af/p/${appId}/api`] = {
+                    target: `http://localhost:${serverPort}`,
+                    changeOrigin: true,
+                    configure: (proxyServer) => {
+                        proxyServer.on('error', (err, req, res) => {
+                            (0, proxy_error_1.handleDevProxyError)(err, req, res, {
+                                target: `http://localhost:${serverPort}`,
+                            });
+                        });
+                    },
+                };
+                proxy[`/af/p/${appId}/__innerapi__`] = {
+                    target: `http://localhost:${serverPort}`,
+                    changeOrigin: true,
+                    configure: (proxyServer) => {
+                        proxyServer.on('error', (err, req, res) => {
+                            (0, proxy_error_1.handleDevProxyError)(err, req, res, {
+                                target: `http://localhost:${serverPort}`,
+                            });
+                        });
+                    },
+                };
+            }
+            return {
+                server: { proxy },
+            };
+        },
+        configureServer(server) {
+            // HTML 反代到 Nest：fullstack 入口是 vite (8080)，但 HTML 由 Nest hbs 渲染
+            server.middlewares.use((req, res, next) => {
+                const devServerWhiteList = [
+                    '/@vite',
+                    '/@fs',
+                    '/__vite',
+                    '/@id',
+                    '/node_modules',
+                    '/dev/',
+                    '.hot-update',
+                    '/@react-refresh',
+                    '/@ws-watchdog',
+                    '/@error-overlay',
+                ];
+                const isHtmlRequest = req.headers.accept?.includes('text/html');
+                const pathname = req.url?.split('?')[0] || '';
+                const isDevServerPath = devServerWhiteList.some((item) => pathname.includes(item));
+                const isStaticAsset = /\.(js|mjs|cjs|css|map|png|jpg|jpeg|gif|svg|ico|webp|woff|woff2|ttf|eot)$/i.test(pathname);
+                if (!isHtmlRequest || isDevServerPath || isStaticAsset) {
+                    return next();
+                }
+                const proxyReq = http.request({
+                    hostname: 'localhost',
+                    port: serverPort,
+                    path: req.url,
+                    method: req.method,
+                    headers: req.headers,
+                }, (proxyRes) => {
+                    res.writeHead(proxyRes.statusCode || 200, proxyRes.headers);
+                    proxyRes.pipe(res);
+                });
+                proxyReq.on('error', (err) => {
+                    (0, proxy_error_1.handleDevProxyError)(err, req, res, {
+                        target: `http://localhost:${serverPort}`,
+                    });
+                });
+                req.pipe(proxyReq);
+            });
+        },
+    };
+}
+exports.default = devProxyPlugin;
+//# sourceMappingURL=dev-proxy.js.map

package/lib/plugins/dev-proxy.js.map

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

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

@@ -1 +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"}
+{"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;AAsBnC,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,CA8ExF;AAED,eAAe,iBAAiB,CAAC"}

package/lib/plugins/fonts-mirror.js

@@ -9,6 +9,12 @@ exports.fontsMirrorPlugin = fontsMirrorPlugin;
  * - URL pathname 保持与 Google Fonts 一致（`/css`、`/css2?family=...&wght=...`），
  *   任意模型输出形式都能被代理；只换域名
  * - 关闭：`{ disabled: true }` 或环境变量 `MIAODA_FONTS_MIRROR_OFF=1`
+ *
+ * 兜底策略（generateBundle）：
+ *   - postcss-import / @tailwindcss/postcss 内联子 CSS 时用 fs.readFile 直接读盘，
+ *     不走 Vite plugin 流水线 → transform 钩子漏过
+ *   - 因此在 build 阶段对最终产出的 CSS asset 再扫一遍，确保替换不漏
+ *   - transform 已替换过的文件，HAS_GOOGLE_FONTS 检测自动跳过，不重复计数
  */
 const DEFAULT_MIRROR = 'https://miaoda.feishu.cn/fonts';
 const GOOGLE_FONTS_RE = /https?:\/\/fonts\.(googleapis|gstatic)\.com/g;
@@ -59,6 +65,28 @@ function fontsMirrorPlugin(options = {}) {
             }
             return { code: code.replace(GOOGLE_FONTS_RE, mirror), map: null };
         },
+        generateBundle(_options, bundle) {
+            for (const file of Object.values(bundle)) {
+                if (file.type !== 'asset')
+                    continue;
+                if (!/\.css$/.test(file.fileName))
+                    continue;
+                const src = typeof file.source === 'string'
+                    ? file.source
+                    : Buffer.from(file.source).toString('utf-8');
+                if (!HAS_GOOGLE_FONTS.test(src))
+                    continue;
+                const matches = src.match(GOOGLE_FONTS_RE);
+                if (!matches)
+                    continue;
+                file.source = src.replace(GOOGLE_FONTS_RE, mirror);
+                stats.files += 1;
+                stats.occurrences += matches.length;
+                if (warn) {
+                    console.warn(`[miaoda-fonts-mirror] rewrote ${matches.length} occurrence(s) in ${file.fileName}`);
+                }
+            }
+        },
         closeBundle() {
             if (stats.files > 0) {
                 console.log(`[miaoda-fonts-mirror] ✓ rewrote ${stats.occurrences} occurrence(s) across ${stats.files} file(s) → ${mirror}`);

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

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

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

@@ -0,0 +1,21 @@
+import type { Plugin } from 'vite';
+/**
+ * Minify HTML while preserving HBS (Handlebars) template expressions.
+ *
+ * HBS expressions like {{csrfToken}} and {{{appAvatar}}} are temporarily
+ * replaced with safe placeholders before minification, then restored after.
+ */
+export declare function minifyHtmlWithHbsProtection(html: string): Promise<string>;
+export interface HtmlOutputPluginOptions {
+    /** Whether running in development mode */
+    isDev: boolean;
+    /** Output directory for built files */
+    outDir: string;
+}
+/**
+ * Vite plugin to handle HTML output:
+ * 1. In production: fixes HTML output path (removes extra 'client' directory)
+ * 2. In development: writes transformed HTML to disk for backend to serve
+ */
+export declare function htmlOutputPlugin(options: HtmlOutputPluginOptions): Plugin;
+//# sourceMappingURL=html-output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"html-output.d.ts","sourceRoot":"","sources":["../../src/plugins/html-output.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,MAAM,CAAC;AAGlE;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B/E;AAED,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAwIzE"}

package/lib/plugins/html-output.js

@@ -0,0 +1,171 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.minifyHtmlWithHbsProtection = minifyHtmlWithHbsProtection;
+exports.htmlOutputPlugin = htmlOutputPlugin;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const html_minifier_terser_1 = require("html-minifier-terser");
+/**
+ * Minify HTML while preserving HBS (Handlebars) template expressions.
+ *
+ * HBS expressions like {{csrfToken}} and {{{appAvatar}}} are temporarily
+ * replaced with safe placeholders before minification, then restored after.
+ */
+async function minifyHtmlWithHbsProtection(html) {
+    // Replace HBS expressions with placeholders before minification
+    // to prevent html-minifier-terser from corrupting them
+    const hbsPlaceholders = [];
+    let processed = html.replace(/\{\{\{?.+?\}\}\}?/g, (match) => {
+        const index = hbsPlaceholders.length;
+        hbsPlaceholders.push(match);
+        return `__HBS_${index}__`;
+    });
+    processed = await (0, html_minifier_terser_1.minify)(processed, {
+        collapseWhitespace: true,
+        removeComments: true,
+        removeRedundantAttributes: true,
+        removeEmptyAttributes: true,
+        minifyCSS: true,
+        // Do NOT minifyJS — inline scripts may reference HBS placeholders
+        minifyJS: false,
+    });
+    // Restore HBS expressions
+    processed = processed.replace(/__HBS_(\d+)__/g, (_, index) => {
+        return hbsPlaceholders[Number(index)];
+    });
+    return processed;
+}
+/**
+ * Vite plugin to handle HTML output:
+ * 1. In production: fixes HTML output path (removes extra 'client' directory)
+ * 2. In development: writes transformed HTML to disk for backend to serve
+ */
+function htmlOutputPlugin(options) {
+    const { isDev, outDir } = options;
+    let config;
+    let server = null;
+    /**
+     * Transform and write HTML to disk for backend to serve
+     */
+    async function writeHtmlToDisk() {
+        if (!server || !config)
+            return;
+        try {
+            // Find the input HTML file from rollup options
+            const rollupInput = config.build.rollupOptions?.input;
+            let htmlPath;
+            if (typeof rollupInput === 'string') {
+                htmlPath = rollupInput;
+            }
+            else if (Array.isArray(rollupInput)) {
+                htmlPath = rollupInput.find((f) => f.endsWith('.html')) || '';
+            }
+            else if (rollupInput && typeof rollupInput === 'object') {
+                htmlPath =
+                    Object.values(rollupInput).find((f) => f.endsWith('.html')) || '';
+            }
+            else {
+                htmlPath = path_1.default.resolve(config.root, 'index.html');
+            }
+            if (!htmlPath || !fs_1.default.existsSync(htmlPath)) {
+                console.warn(`[html-output] HTML file not found: ${htmlPath}`);
+                return;
+            }
+            // Read the source HTML
+            let html = fs_1.default.readFileSync(htmlPath, 'utf-8');
+            // Apply Vite's HTML transformations (this calls all plugin's transformIndexHtml hooks)
+            const url = '/' + path_1.default.relative(config.root, htmlPath);
+            html = await server.transformIndexHtml(url, html);
+            // Write to output directory
+            const outputPath = path_1.default.resolve(outDir, 'index.html');
+            // Ensure output directory exists
+            const dir = path_1.default.dirname(outputPath);
+            if (!fs_1.default.existsSync(dir)) {
+                fs_1.default.mkdirSync(dir, { recursive: true });
+            }
+            fs_1.default.writeFileSync(outputPath, html);
+            console.log(`[html-output] Written to: ${outputPath}`);
+        }
+        catch (e) {
+            console.error(`[html-output] Failed to write HTML:`, e);
+        }
+    }
+    return {
+        name: 'vite-html-output',
+        configResolved(resolvedConfig) {
+            config = resolvedConfig;
+        },
+        configureServer(devServer) {
+            if (!isDev)
+                return;
+            server = devServer;
+            // Return a post hook to run after all plugins' configureServer and
+            // Vite's internal middlewares are set up
+            return () => {
+                writeHtmlToDisk();
+                // Watch for HTML file changes
+                const rollupInput = config.build.rollupOptions?.input;
+                let htmlPath;
+                if (typeof rollupInput === 'string' && rollupInput.endsWith('.html')) {
+                    htmlPath = rollupInput;
+                }
+                else if (rollupInput && typeof rollupInput === 'object') {
+                    const inputs = Array.isArray(rollupInput)
+                        ? rollupInput
+                        : Object.values(rollupInput);
+                    htmlPath = inputs.find((f) => f.endsWith('.html'));
+                }
+                if (htmlPath) {
+                    devServer.watcher.add(htmlPath);
+                    devServer.watcher.on('change', (file) => {
+                        if (file === htmlPath) {
+                            console.log(`[html-output] HTML changed, regenerating...`);
+                            writeHtmlToDisk();
+                        }
+                    });
+                }
+            };
+        },
+        // In production, fix the HTML output path and minify after build
+        async closeBundle() {
+            if (!isDev && config) {
+                const outDir = config.build.outDir;
+                const wrongPath = path_1.default.resolve(outDir, 'client/index.html');
+                const correctPath = path_1.default.resolve(outDir, 'index.html');
+                // Check if HTML was output to wrong location
+                if (fs_1.default.existsSync(wrongPath)) {
+                    // Move HTML to correct location
+                    fs_1.default.renameSync(wrongPath, correctPath);
+                    console.log(`[html-output] Moved: ${wrongPath} -> ${correctPath}`);
+                    // Remove empty client directory if it exists
+                    const clientDir = path_1.default.resolve(outDir, 'client');
+                    try {
+                        const files = fs_1.default.readdirSync(clientDir);
+                        if (files.length === 0) {
+                            fs_1.default.rmdirSync(clientDir);
+                        }
+                    }
+                    catch {
+                        // Directory doesn't exist or not empty, ignore
+                    }
+                }
+                // Minify HTML (protect HBS templates like {{csrfToken}}, {{{appAvatar}}})
+                if (fs_1.default.existsSync(correctPath)) {
+                    try {
+                        const html = fs_1.default.readFileSync(correctPath, 'utf-8');
+                        const minified = await minifyHtmlWithHbsProtection(html);
+                        fs_1.default.writeFileSync(correctPath, minified);
+                        console.log(`[html-output] Minified: ${correctPath}`);
+                    }
+                    catch (e) {
+                        console.warn(`[html-output] HTML minification failed, skipping:`, e);
+                    }
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=html-output.js.map