@lark-apaas/coding-preset-vite-react 0.1.0

package/LICENSE

@@ -0,0 +1,13 @@
+MIT License
+
+Copyright (c) 2024 Lark Technologies Pte. Ltd. and/or its affiliates
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted,provided that the above copyright notice and this permission notice appear in all copies.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
+INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO
+EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR
+CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
+ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/lib/index.d.ts

@@ -0,0 +1,52 @@
+import { type UserConfig } from 'vite';
+/**
+ * miaoda-coding vite-react (jsPage) 默认 Vite 配置。
+ *
+ * 通过环境变量自动读取部署相关参数，用户只需提供项目特有的覆盖：
+ *
+ * ```ts
+ * import { defineConfig } from '@lark-apaas/coding-preset-vite-react';
+ * import path from 'node:path';
+ *
+ * export default defineConfig({
+ *   resolve: {
+ *     alias: {
+ *       '@': path.resolve(__dirname, 'src'),
+ *       '@shared': path.resolve(__dirname, 'shared'),
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * 支持环境变量：
+ *   - NODE_ENV            development | production（默认 development）
+ *   - CLIENT_BASE_PATH    部署侧 client base path（如 `/app/<id>`）
+ *   - ASSETS_CDN_PATH     生产 JS/CSS CDN 前缀（可选）
+ *   - CLIENT_DEV_PORT     dev server 端口（默认 8080）
+ *   - CLIENT_DEV_HOST     dev server host（默认 localhost）
+ *   - FORCE_FRAMEWORK_DOMAIN_MAIN  反向代理域名（启用 wss HMR + 设置 ACAO）
+ *   - DISABLE_INSPECTOR   `true` 关 inspector
+ *   - MIAODA_FONTS_MIRROR_OFF  `1` 关 Google Fonts 代理替换
+ *   - MIAODA_APP_TYPE     妙搭应用类型（数字字符串，供 lite Safety 徽标判断）
+ */
+export declare function defineConfig(overrides?: UserConfig): UserConfig;
+export default defineConfig;
+export { routesPlugin, parseRoutes } from './plugins/routes';
+export { htmlMinifyPlugin, minifyHtmlWithHbsProtection } from './plugins/html-minify';
+export { staticAssetsPlugin } from './plugins/static-assets';
+export { capabilitiesBundlePlugin } from './plugins/capabilities';
+export { errorOverlayPlugin } from './plugins/error-overlay';
+export { hmrTimingPlugin } from './plugins/hmr-timing';
+export { wsWatchdogPlugin } from './plugins/ws-watchdog';
+export { healthMiddlewarePlugin } from './plugins/health';
+export { viewContextPlugin } from './plugins/view-context';
+export { moduleAliasPlugin } from './plugins/module-alias';
+export { ogMetaPlugin } from './plugins/og-meta';
+export { fontsMirrorPlugin } from './plugins/fonts-mirror';
+export { polyfillPlugin } from './plugins/polyfill';
+export { viteClientPatchPlugin } from './plugins/vite-client-patch';
+export { slardarPlugin } from './plugins/slardar';
+export { devLogsPlugin } from './plugins/dev-logs';
+export { normalizeBasePath, normalizeBasePathWithoutTrailingSlash, } from './utils/normalize-base-path';
+export { registerSnapDomProxyMiddleware } from './utils/snapdom-proxy';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,UAAU,EAAsB,MAAM,MAAM,CAAC;AAkFrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,SAAS,GAAE,UAAe,GAAG,UAAU,CAoPnE;AAGD,eAAe,YAAY,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,qCAAqC,GACtC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/index.js

@@ -0,0 +1,410 @@
+"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.registerSnapDomProxyMiddleware = exports.normalizeBasePathWithoutTrailingSlash = exports.normalizeBasePath = exports.devLogsPlugin = exports.slardarPlugin = exports.viteClientPatchPlugin = exports.polyfillPlugin = exports.fontsMirrorPlugin = exports.ogMetaPlugin = exports.moduleAliasPlugin = exports.viewContextPlugin = exports.healthMiddlewarePlugin = exports.wsWatchdogPlugin = exports.hmrTimingPlugin = exports.errorOverlayPlugin = exports.capabilitiesBundlePlugin = exports.staticAssetsPlugin = exports.minifyHtmlWithHbsProtection = exports.htmlMinifyPlugin = exports.parseRoutes = exports.routesPlugin = void 0;
+exports.defineConfig = defineConfig;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const vite_1 = require("vite");
+const plugin_react_1 = __importDefault(require("@vitejs/plugin-react"));
+const vite_2 = __importDefault(require("@tailwindcss/vite"));
+const routes_1 = require("./plugins/routes");
+const html_minify_1 = require("./plugins/html-minify");
+const static_assets_1 = require("./plugins/static-assets");
+const capabilities_1 = require("./plugins/capabilities");
+const error_overlay_1 = require("./plugins/error-overlay");
+const hmr_timing_1 = require("./plugins/hmr-timing");
+const ws_watchdog_1 = require("./plugins/ws-watchdog");
+const health_1 = require("./plugins/health");
+const view_context_1 = require("./plugins/view-context");
+const module_alias_1 = require("./plugins/module-alias");
+const og_meta_1 = require("./plugins/og-meta");
+const fonts_mirror_1 = require("./plugins/fonts-mirror");
+const polyfill_1 = require("./plugins/polyfill");
+const vite_client_patch_1 = require("./plugins/vite-client-patch");
+const slardar_1 = require("./plugins/slardar");
+const dev_logs_1 = require("./plugins/dev-logs");
+const normalize_base_path_1 = require("./utils/normalize-base-path");
+const snapdom_proxy_1 = require("./utils/snapdom-proxy");
+/**
+ * 兼容两种模板 layout 的路径解析：
+ *   - 老 fullstack 模板：`client/X` 存在
+ *   - 新 jsPage 模板：`X` 在项目根（无 client/ 包装）
+ */
+function resolveClientPath(rootDir, rel) {
+    const legacy = path.resolve(rootDir, 'client', rel);
+    if (fs.existsSync(legacy))
+        return legacy;
+    return path.resolve(rootDir, rel);
+}
+function readAppFlags(rootDir) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.resolve(rootDir, 'package.json'), 'utf-8'));
+        return pkg.flags || {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 读 dist/{page,api}-routes.json（build.sh 在 vite build 前生成，jsPage 不产）。
+ * 即使文件不存在也安全注入空数组 define，避免业务代码引用时报 undefined。
+ */
+function readRouteDefinitions(rootDir) {
+    let pageRoutes = [];
+    let apiRoutes = [];
+    try {
+        const p = path.resolve(rootDir, 'dist/page-routes.json');
+        if (fs.existsSync(p))
+            pageRoutes = JSON.parse(fs.readFileSync(p, 'utf-8'));
+    }
+    catch {
+        /* ignore */
+    }
+    try {
+        const p = path.resolve(rootDir, 'dist/api-routes.json');
+        if (fs.existsSync(p))
+            apiRoutes = JSON.parse(fs.readFileSync(p, 'utf-8'));
+    }
+    catch {
+        /* ignore */
+    }
+    return { pageRoutes, apiRoutes };
+}
+/**
+ * 动态加载 inspector（dev 默认开，`DISABLE_INSPECTOR=true` 可关）。
+ */
+function tryLoadInspector(enabled) {
+    if (!enabled)
+        return [];
+    try {
+        const mod = require('@lark-apaas/vite-inspector-plugin');
+        return [mod.inspectorPlugin()];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * miaoda-coding vite-react (jsPage) 默认 Vite 配置。
+ *
+ * 通过环境变量自动读取部署相关参数，用户只需提供项目特有的覆盖：
+ *
+ * ```ts
+ * import { defineConfig } from '@lark-apaas/coding-preset-vite-react';
+ * import path from 'node:path';
+ *
+ * export default defineConfig({
+ *   resolve: {
+ *     alias: {
+ *       '@': path.resolve(__dirname, 'src'),
+ *       '@shared': path.resolve(__dirname, 'shared'),
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * 支持环境变量：
+ *   - NODE_ENV            development | production（默认 development）
+ *   - CLIENT_BASE_PATH    部署侧 client base path（如 `/app/<id>`）
+ *   - ASSETS_CDN_PATH     生产 JS/CSS CDN 前缀（可选）
+ *   - CLIENT_DEV_PORT     dev server 端口（默认 8080）
+ *   - CLIENT_DEV_HOST     dev server host（默认 localhost）
+ *   - FORCE_FRAMEWORK_DOMAIN_MAIN  反向代理域名（启用 wss HMR + 设置 ACAO）
+ *   - DISABLE_INSPECTOR   `true` 关 inspector
+ *   - MIAODA_FONTS_MIRROR_OFF  `1` 关 Google Fonts 代理替换
+ *   - MIAODA_APP_TYPE     妙搭应用类型（数字字符串，供 lite Safety 徽标判断）
+ */
+function defineConfig(overrides = {}) {
+    const isDev = process.env.NODE_ENV !== 'production';
+    const rootDir = process.cwd();
+    const clientBasePath = (0, normalize_base_path_1.normalizeBasePath)(process.env.CLIENT_BASE_PATH);
+    // ASSETS_CDN_PATH 来自 miaoda-cli 注入的 MIAODA_RESOURCE_CDN_PREFIX，通常是完整 URL
+    // （`https://cdn.bytetos.com/...`）。必须用 URL-safe 的 normalize，不能强加 `/` 前缀
+    // —— 否则会变成 `/https://cdn.bytetos.com/...` 直接破掉 Vite 的 base 替换。
+    const assetsCdnPath = (0, normalize_base_path_1.normalizeBasePathWithoutTrailingSlash)(process.env.ASSETS_CDN_PATH);
+    // dev / prod base 来源不同：dev 完全用 clientBasePath，prod 优先 CDN
+    const publicPath = isDev ? clientBasePath : (assetsCdnPath || clientBasePath);
+    const base = publicPath ? `${publicPath}/` : '/';
+    // 从 clientBasePath 提取 appId 给 viewContext 用
+    const isNewPathFormat = /^\/app\/[^/]/.test(clientBasePath);
+    const appId = isNewPathFormat
+        ? clientBasePath.replace(/\/+$/, '').split('/').pop()
+        : undefined;
+    const appFlags = readAppFlags(rootDir);
+    const { pageRoutes, apiRoutes } = readRouteDefinitions(rootDir);
+    const enableInspector = isDev && process.env.DISABLE_INSPECTOR !== 'true';
+    const baseConfig = {
+        root: rootDir,
+        base,
+        plugins: [
+            // dev only: HMR 重连不刷页面（沙箱链路下避免 ~18s 死连接超时）
+            isDev && (0, vite_client_patch_1.viteClientPatchPlugin)(),
+            // virtual:capabilities —— client-toolkit-lite / client-capability SDK 强依赖；
+            // 即便业务工程没有 capability JSON 也要把虚拟模块注册成空 map，否则 build fail
+            (0, capabilities_1.capabilitiesBundlePlugin)(),
+            // dev only: 自定义 HMR 错误浮层（替 Vite 原生）
+            isDev && (0, error_overlay_1.errorOverlayPlugin)({ clientBasePath }),
+            // @shared/static/* 路径解析 —— enforce: 'pre'，早于 tsconfig paths 和 vite:json
+            (0, static_assets_1.staticAssetsPlugin)({ clientBasePath, rootDir }),
+            // inspector 必须排在 react() 之前 —— 两者都 enforce:'pre'，inspector 需要原 JSX
+            // 还在的时候打 data-* 标记；react 转译完就剩 _jsxDEV() 调用了
+            ...tryLoadInspector(enableInspector),
+            (0, plugin_react_1.default)(),
+            (0, vite_2.default)(),
+            // clsx / echarts / echarts-for-react alias —— 让所有 echarts 子路径指向 preset 自带版本
+            (0, module_alias_1.moduleAliasPlugin)(),
+            // routes.json（dev 内存 + middleware；build emitFile）
+            (0, routes_1.routesPlugin)({
+                appPath: fs.existsSync(path.resolve(rootDir, 'client/src/app.tsx'))
+                    ? './client/src/app.tsx'
+                    : './src/app.tsx',
+                serveBasePath: clientBasePath,
+                // dev 显式空 base —— 沙箱网关把 prefix 剥掉了，直接 / 访问
+                ...(isDev ? { basePath: '' } : {}),
+            }),
+            // OG Meta tags + title + favicon 注入 HBS 占位符（{{appName}} / {{appAvatar}} 等）
+            // 由部署运行时（vefaas）调 platform API 拿 appInfo 后做 hbs replace；
+            // dev 预览看到的是字面占位符，业务侧用 useAppInfo + useEffect setTitle 兜底
+            (0, og_meta_1.ogMetaPlugin)(),
+            // head 顺序敏感：slardar 必须排在 viewContext **之前**——
+            // Vite 同 bucket（head-prepend）是"后执行者插更前"。
+            // 数组里 slardar 在前 → HTML 里 viewContext 在 slardar 之上 → onload 时拿得到 window.tenantId
+            (0, slardar_1.slardarPlugin)({ bid: 'apaas_miaoda' }),
+            (0, view_context_1.viewContextPlugin)({ appId: isDev ? appId : undefined }),
+            // prod only: 老浏览器 polyfill（按需加载）
+            !isDev && (0, polyfill_1.polyfillPlugin)(),
+            // build-time HTML minify（HBS 占位符保护）
+            (0, html_minify_1.htmlMinifyPlugin)(),
+            // dev only DX 插件
+            isDev && (0, hmr_timing_1.hmrTimingPlugin)(),
+            isDev && (0, ws_watchdog_1.wsWatchdogPlugin)({ clientBasePath }),
+            isDev && (0, health_1.healthMiddlewarePlugin)(),
+            // 客户端日志收集 endpoint（POST /dev/logs/collect{,-batch}）
+            isDev && (0, dev_logs_1.devLogsPlugin)({ basePath: clientBasePath }),
+            // Google Fonts → 妙搭字体代理（编译时字符串 replace；dev / build 都有用）
+            (0, fonts_mirror_1.fontsMirrorPlugin)(),
+        ].filter(Boolean),
+        resolve: {
+            // Vite 8 原生 tsconfig paths 解析
+            // @ts-expect-error Vite 8 option — type defs may lag behind runtime support
+            tsconfigPaths: true,
+            // 跟 rspack-preset 对齐的 mainFields 顺序
+            mainFields: ['module', 'browser', 'main'],
+            extensions: ['.js', '.jsx', '.ts', '.tsx', '.json'],
+            alias: {
+                // 所有 echarts 子路径解析到 preset 自带的 echarts，避免第三方扩展（如
+                // echarts-wordcloud）拉独立 echarts 副本导致注册不到同一实例
+                echarts: path.dirname(require.resolve('echarts/package.json')),
+                // Inspector dev-only CSS：dev 走 inspector 运行时注入，build 给空 stub
+                '@/inspector.dev.css': path.resolve(__dirname, '../src/empty.css'),
+                // prod：inspector 整包替成空 stub，避免进生产 bundle
+                ...(!isDev
+                    ? {
+                        '@lark-apaas/miaoda-inspector': path.resolve(__dirname, '../src/inspector-stub.js'),
+                    }
+                    : {}),
+            },
+        },
+        define: {
+            // Node global polyfill（sockjs-client 等老库要）
+            global: 'globalThis',
+            'process.env.NODE_ENV': JSON.stringify(isDev ? 'development' : 'production'),
+            'process.env.runtimeMode': JSON.stringify('fullstack'),
+            'process.env.CLIENT_BASE_PATH': JSON.stringify(clientBasePath),
+            __APP_BASE_PATH__: JSON.stringify(clientBasePath),
+            // 未设置时替换为字面量 `undefined`，让 `??` fallback 正确触发（`""`/`undefined` 行为不同）
+            'process.env.FORCE_FRAMEWORK_DOMAIN_MAIN': process.env.FORCE_FRAMEWORK_DOMAIN_MAIN
+                ? JSON.stringify(process.env.FORCE_FRAMEWORK_DOMAIN_MAIN)
+                : 'undefined',
+            'process.env.CWD': JSON.stringify(''),
+            'process.env.__RUNTIME_INJECTED__': JSON.stringify('true'),
+            'process.env.BUILD_TOOL': JSON.stringify('vite'),
+            'process.env.APP_FLAGS': JSON.stringify(appFlags),
+            // 路由定义（jsPage 用空数组，业务代码引用时不至于 undefined）
+            'process.env.__PAGE_ROUTE_DEFINITIONS__': JSON.stringify(JSON.stringify(pageRoutes)),
+            'process.env.__API_ROUTE_DEFINITIONS__': JSON.stringify(JSON.stringify(apiRoutes)),
+            'process.env.MIAODA_APP_TYPE': process.env.MIAODA_APP_TYPE
+                ? JSON.stringify(process.env.MIAODA_APP_TYPE)
+                : 'undefined',
+        },
+        server: {
+            port: Number(process.env.CLIENT_DEV_PORT) || 8080,
+            host: process.env.CLIENT_DEV_HOST || 'localhost',
+            strictPort: true,
+            cors: true,
+            allowedHosts: true,
+            headers: {
+                ...(process.env.FORCE_FRAMEWORK_DOMAIN_MAIN
+                    ? { 'Access-Control-Allow-Origin': process.env.FORCE_FRAMEWORK_DOMAIN_MAIN }
+                    : {}),
+            },
+            watch: {
+                usePolling: true,
+                interval: 500,
+                ignored: ['**/node_modules/**', '**/dist/**'],
+            },
+            hmr: process.env.FORCE_FRAMEWORK_DOMAIN_MAIN
+                ? { protocol: 'wss', path: '/ws' }
+                : { path: '/ws' },
+        },
+        build: {
+            outDir: path.resolve(rootDir, 'dist/client'),
+            // build.sh 已经在 vite build 前 `rm -rf dist`，这里不再让 vite 自己清
+            emptyOutDir: false,
+            sourcemap: isDev ? true : 'hidden',
+            minify: !isDev,
+            cssTarget: ['ios12', 'safari12', 'chrome80'],
+            rollupOptions: {
+                input: resolveClientPath(rootDir, 'index.html'),
+                output: {
+                    // 按依赖拆 chunk，优化缓存和并行加载
+                    manualChunks(id) {
+                        if (id.includes('@lark-apaas/client-toolkit-lite'))
+                            return 'toolkit';
+                        if (id.includes('@radix-ui'))
+                            return 'radix';
+                        if (id.includes('@data-loom'))
+                            return 'dataloom';
+                        return undefined;
+                    },
+                },
+            },
+            copyPublicDir: true,
+        },
+        publicDir: resolveClientPath(rootDir, 'public'),
+        optimizeDeps: {
+            include: [
+                'react',
+                'react-dom',
+                'react/jsx-runtime',
+                'react/jsx-dev-runtime',
+                'clsx',
+                'echarts',
+                'echarts-for-react',
+                ...(enableInspector ? ['@lark-apaas/miaoda-inspector'] : []),
+            ],
+        },
+    };
+    // dev 期补三组 middleware：base-path internal rewrite、SnapDom proxy、devtool-kits 日志相关
+    if (isDev) {
+        baseConfig.plugins.push({
+            name: 'miaoda-dev-middlewares',
+            async configureServer(server) {
+                // ── base-path normalize ──────────────────────────────────────────
+                // Vite 8 baseMiddleware：请求 pathname 不以 base（含末尾 /）开头时显示警告页，
+                // 不再自动 301。沙箱预览过来的 URL 通常是 `/app/app_xxx?sso_token=...`（pathname
+                // 没末尾 /），会被警告页拦下。
+                //
+                // 用 internal rewrite（不是 301）—— 浏览器跳 → 沙箱网关在转发"带尾 /"时会把
+                // 尾 / 又 strip 回去 → vite 又 301 → ERR_TOO_MANY_REDIRECTS。
+                // 必须 unshift 到 stack 开头才能早于 baseMiddleware 执行。
+                const baseWithSlash = clientBasePath.endsWith('/')
+                    ? clientBasePath
+                    : clientBasePath + '/';
+                const baseWithoutSlash = baseWithSlash.slice(0, -1);
+                if (baseWithoutSlash) {
+                    const stack = server.middlewares.stack;
+                    if (Array.isArray(stack)) {
+                        stack.unshift({
+                            route: '',
+                            handle: (req, _res, next) => {
+                                const url = req.url || '';
+                                const qIdx = url.indexOf('?');
+                                const pathname = qIdx >= 0 ? url.slice(0, qIdx) : url;
+                                const search = qIdx >= 0 ? url.slice(qIdx) : '';
+                                if (pathname === baseWithoutSlash) {
+                                    req.url = baseWithoutSlash + '/' + search;
+                                }
+                                next();
+                            },
+                        });
+                    }
+                }
+                // SnapDom proxy（client 截图库的跨域转发）
+                (0, snapdom_proxy_1.registerSnapDomProxyMiddleware)(server.middlewares, { baseUrl: clientBasePath });
+                // 注：客户端日志收集 endpoint 现在由 devLogsPlugin 自己挂载（plugin 数组里），
+                // 这里不再做集中注册——以前依赖 @lark-apaas/devtool-kits 已彻底去除
+            },
+        });
+    }
+    return (0, vite_1.mergeConfig)(baseConfig, overrides);
+}
+// 默认导出与命名导出同名
+exports.default = defineConfig;
+// 子模块导出
+var routes_2 = require("./plugins/routes");
+Object.defineProperty(exports, "routesPlugin", { enumerable: true, get: function () { return routes_2.routesPlugin; } });
+Object.defineProperty(exports, "parseRoutes", { enumerable: true, get: function () { return routes_2.parseRoutes; } });
+var html_minify_2 = require("./plugins/html-minify");
+Object.defineProperty(exports, "htmlMinifyPlugin", { enumerable: true, get: function () { return html_minify_2.htmlMinifyPlugin; } });
+Object.defineProperty(exports, "minifyHtmlWithHbsProtection", { enumerable: true, get: function () { return html_minify_2.minifyHtmlWithHbsProtection; } });
+var static_assets_2 = require("./plugins/static-assets");
+Object.defineProperty(exports, "staticAssetsPlugin", { enumerable: true, get: function () { return static_assets_2.staticAssetsPlugin; } });
+var capabilities_2 = require("./plugins/capabilities");
+Object.defineProperty(exports, "capabilitiesBundlePlugin", { enumerable: true, get: function () { return capabilities_2.capabilitiesBundlePlugin; } });
+var error_overlay_2 = require("./plugins/error-overlay");
+Object.defineProperty(exports, "errorOverlayPlugin", { enumerable: true, get: function () { return error_overlay_2.errorOverlayPlugin; } });
+var hmr_timing_2 = require("./plugins/hmr-timing");
+Object.defineProperty(exports, "hmrTimingPlugin", { enumerable: true, get: function () { return hmr_timing_2.hmrTimingPlugin; } });
+var ws_watchdog_2 = require("./plugins/ws-watchdog");
+Object.defineProperty(exports, "wsWatchdogPlugin", { enumerable: true, get: function () { return ws_watchdog_2.wsWatchdogPlugin; } });
+var health_2 = require("./plugins/health");
+Object.defineProperty(exports, "healthMiddlewarePlugin", { enumerable: true, get: function () { return health_2.healthMiddlewarePlugin; } });
+var view_context_2 = require("./plugins/view-context");
+Object.defineProperty(exports, "viewContextPlugin", { enumerable: true, get: function () { return view_context_2.viewContextPlugin; } });
+var module_alias_2 = require("./plugins/module-alias");
+Object.defineProperty(exports, "moduleAliasPlugin", { enumerable: true, get: function () { return module_alias_2.moduleAliasPlugin; } });
+var og_meta_2 = require("./plugins/og-meta");
+Object.defineProperty(exports, "ogMetaPlugin", { enumerable: true, get: function () { return og_meta_2.ogMetaPlugin; } });
+var fonts_mirror_2 = require("./plugins/fonts-mirror");
+Object.defineProperty(exports, "fontsMirrorPlugin", { enumerable: true, get: function () { return fonts_mirror_2.fontsMirrorPlugin; } });
+var polyfill_2 = require("./plugins/polyfill");
+Object.defineProperty(exports, "polyfillPlugin", { enumerable: true, get: function () { return polyfill_2.polyfillPlugin; } });
+var vite_client_patch_2 = require("./plugins/vite-client-patch");
+Object.defineProperty(exports, "viteClientPatchPlugin", { enumerable: true, get: function () { return vite_client_patch_2.viteClientPatchPlugin; } });
+var slardar_2 = require("./plugins/slardar");
+Object.defineProperty(exports, "slardarPlugin", { enumerable: true, get: function () { return slardar_2.slardarPlugin; } });
+var dev_logs_2 = require("./plugins/dev-logs");
+Object.defineProperty(exports, "devLogsPlugin", { enumerable: true, get: function () { return dev_logs_2.devLogsPlugin; } });
+var normalize_base_path_2 = require("./utils/normalize-base-path");
+Object.defineProperty(exports, "normalizeBasePath", { enumerable: true, get: function () { return normalize_base_path_2.normalizeBasePath; } });
+Object.defineProperty(exports, "normalizeBasePathWithoutTrailingSlash", { enumerable: true, get: function () { return normalize_base_path_2.normalizeBasePathWithoutTrailingSlash; } });
+var snapdom_proxy_2 = require("./utils/snapdom-proxy");
+Object.defineProperty(exports, "registerSnapDomProxyMiddleware", { enumerable: true, get: function () { return snapdom_proxy_2.registerSnapDomProxyMiddleware; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/plugins/capabilities.d.ts

@@ -0,0 +1,23 @@
+import type { Plugin } from 'vite';
+export interface CapabilitiesBundlePluginOptions {
+    /** 覆盖扫描目录（相对项目根）。不传时按默认目录列表依次扫描。 */
+    dir?: string;
+}
+/**
+ * 把业务工程 `<dir>/*.json` 的 capability 配置打成 `virtual:capabilities` 虚拟模块。
+ *
+ * `@lark-apaas/client-capability` SDK（被 client-toolkit-lite 内联使用）会
+ * `import map from 'virtual:capabilities'` 取这个 map。SDK 在 dev 预览 / 沙箱
+ * 加载流程中依赖这个模块存在，所以即使 capabilities 目录为空，也必须把模块
+ * 注册成解析成功（空 map），否则 rolldown 在 build 时直接 fail。
+ *
+ * 同时通过 `optimizeDeps.esbuildOptions.plugins` 在 depOptimizer 那条路径上
+ * 也提供解析——因为 client-toolkit-lite 是 pre-bundle 进来的，pre-bundle 的
+ * esbuild 不会经过 Vite 主 pipeline 的 plugin 链。
+ *
+ * V1 限制：dev 期更改 capability JSON 后，pre-bundle 产物里的 map 是启动时快照，
+ * 不会自动刷新；新增 / 修改 capability 后需要重启 dev server。
+ */
+export declare function capabilitiesBundlePlugin(options?: CapabilitiesBundlePluginOptions): Plugin;
+export default capabilitiesBundlePlugin;
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/plugins/capabilities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAQnC,MAAM,WAAW,+BAA+B;IAC9C,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,+BAAoC,GAAG,MAAM,CA0F9F;AAED,eAAe,wBAAwB,CAAC"}